Add project operating workflow and continuity docs

2026-02-15 09:21:52 +00:00
parent 6e680d34cf
commit 4bd1d314d6
4 changed files with 104 additions and 0 deletions
@@ -0,0 +1,19 @@
+# DECISIONS
+
+## 2026-02-15 — Profile-first RunPod build flow
+- We use profile files as inputs and generate lock files as build/runtime truth.
+- Profile inputs:
+  - `Runpod_Comfy/profiles/runpod.<id>.yaml`
+  - `Runpod_Comfy/profiles/nodes.<id>.yaml`
+  - `Runpod_Comfy/profiles/models.<id>.yaml`
+  - Optional `Runpod_Comfy/profiles/urls.<id>.txt`
+- Compiler output:
+  - `Runpod_Comfy/config/comfyui.lock`
+  - `Runpod_Comfy/config/custom_nodes.lock.json`
+  - `Runpod_Comfy/config/models.json`
+- Docker base image is taken from generated `comfyui.lock` (`BASE_IMAGE` build arg).
+
+## 2026-02-15 — Work continuity model
+- Planning/serious execution in OpenClaw web dashboard.
+- Telegram for quick pings.
+- Repo files (`TODO/WORKLOG/DECISIONS/WORKFLOW`) are continuity anchor across devices.
@@ -0,0 +1,20 @@
+# TODO
+
+## NOW
+- [ ] Fill real values for RunPod profile files (`Runpod_Comfy/profiles/*.example.yaml` copies)
+- [ ] Compile selected profile and verify generated lock files
+- [ ] Build and push first RunPod image
+
+## NEXT
+- [ ] Deploy image on RunPod and run smoke test workflow
+- [ ] Add helper script: `Runpod_Comfy/tools/build_from_lock.sh`
+- [ ] Add profile validation checks (schema-lite)
+
+## BLOCKED
+- [ ] Final production model URLs and checksums (waiting on selection)
+
+## DONE
+- [x] Add profile compiler scaffold (`compile_profile.sh`)
+- [x] Add example profile files (runpod/nodes/models + urls format)
+- [x] Wire Dockerfile to configurable base image via build-arg
+- [x] Generate lock files from sample profile and sanity-check JSON
@@ -0,0 +1,41 @@
+# Workflow (Cristian + kflame)
+
+This is the operating flow for this repo.
+
+## 1) Where planning happens
+- Primary workspace: OpenClaw web dashboard session.
+- Telegram: quick pings only.
+
+## 2) Source of truth
+- Tasks: `TODO.md`
+- Progress/handoff: `WORKLOG.md`
+- Decisions: `DECISIONS.md`
+- Code/config truth: repo files + commits
+
+## 3) Start of each work block
+1. Read `TODO.md`
+2. Read latest entry in `WORKLOG.md`
+3. Read `DECISIONS.md`
+4. Pick one task and execute
+
+## 4) End of each work block
+1. Update `WORKLOG.md` (done/next/blockers)
+2. Update `TODO.md` statuses
+3. If a meaningful choice was made, update `DECISIONS.md`
+4. Commit changes with clear message
+
+## 5) Task status model
+- `NOW`: actively working
+- `NEXT`: queued next
+- `BLOCKED`: waiting on external dependency
+- `DONE`: complete
+
+## 6) Resume from any device
+Use this order:
+1. `WORKLOG.md` latest entry
+2. `TODO.md` NOW/NEXT items
+3. `DECISIONS.md`
+4. Git history (`git log --oneline -n 10`)
+
+## 7) Rule of thumb
+If it matters later, write it to file now.
@@ -0,0 +1,24 @@
+# WORKLOG
+
+## 2026-02-15
+### Done
+- Implemented profile-driven scaffold for RunPod Comfy builds.
+- Added:
+  - `Runpod_Comfy/profiles/runpod.example.yaml`
+  - `Runpod_Comfy/profiles/nodes.example.yaml`
+  - `Runpod_Comfy/profiles/models.example.yaml`
+  - `Runpod_Comfy/profiles/urls.txt`
+  - `Runpod_Comfy/tools/compile_profile.sh`
+- Updated `Runpod_Comfy/docker/Dockerfile` to use `ARG BASE_IMAGE` + `FROM ${BASE_IMAGE}`.
+- Updated `Runpod_Comfy/README.md` with compile/build flow.
+- Ran sample compile: `Runpod_Comfy/tools/compile_profile.sh example`.
+- Validated generated JSON structure via Python loader.
+- Commit: `af028bf`.
+
+### Next (top 3)
+1. Create real profile files for Cristian's RunPod target.
+2. Compile and inspect generated lock files.
+3. Build + push image, deploy pod, smoke test.
+
+### Blockers
+- Real model URLs/checksums not finalized.