codebyplan 1.13.58 → 1.13.59

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codebyplan",
-  "version": "1.13.58",
+  "version": "1.13.59",
   "description": "CLI for CodeByPlan — AI-powered development planning and tracking",
   "type": "module",
   "bin": {

package/templates/settings.project.base.json

@@ -253,7 +253,9 @@
       "Bash(codebyplan ci:*)",
       "Bash(npx codebyplan ci:*)",
       "Bash(codebyplan cd:*)",
-      "Bash(npx codebyplan cd:*)"
+      "Bash(npx codebyplan cd:*)",
+      "Bash(codebyplan cleanup-plan-folders:*)",
+      "Bash(npx codebyplan cleanup-plan-folders:*)"
     ]
   },
   "attribution": {

package/templates/skills/cbp-checkpoint-end/SKILL.md

@@ -68,6 +68,51 @@ Check that the base branch exists remotely:
 |--------|----------|------------|
 | BASE | Yes | **STOP** — cannot ship without production branch |
 
+### Step 4.5: Export + Plan-Folder Cleanup
+
+Before shipping, export the checkpoint's workflow data and remove the generated
+plan-folder trees from the git index. This step is **best-effort** — a failure
+here MUST NOT block shipment. Warn and continue on any error.
+
+1. Run export (capture result for Step 10 summary):
+
+   ```bash
+   npx codebyplan checkpoint export --id <CHECKPOINT_ID>
+   ```
+
+   - On exit 0: parse JSON stdout → `EXPORT_RESULT` (`{ exported, path, last_exported_at }`).
+   - On non-zero exit: emit a warning, set `EXPORT_RESULT = { exported: false, error: "<stderr summary>" }`, continue.
+
+2. Stage the export artifacts:
+
+   ```bash
+   git add .codebyplan/exports/
+   ```
+
+3. Run plan-folder cleanup:
+
+   ```bash
+   npx codebyplan cleanup-plan-folders
+   ```
+
+   - On exit 0: parse JSON stdout → `CLEANUP_RESULT` (`{ removed, skipped }`).
+   - On non-zero exit: emit a warning, set `CLEANUP_RESULT = { removed: [], error: "<stderr summary>" }`, continue.
+
+4. Commit if anything was staged:
+
+   ```bash
+   git diff --cached --name-only
+   ```
+
+   If the output is non-empty, commit with:
+
+   ```bash
+   git commit -m "feat: export CHK-<N> and remove plan-folder docs"
+   ```
+
+   Use the checkpoint number for `<N>`. Do NOT include any mention of AI tooling
+   in the commit message.
+
 ### Step 5: Ship to Production
 
 If `auto_push_enabled` is true, run `/cbp-ship-main`.
@@ -242,6 +287,11 @@ Present summary:
 ### Branch Promotion
 - **feat -> [BASE]**: [PR URL] (merged)
 
+### Export
+- **Workflow export**: [EXPORT_RESULT.path from Step 4.5, or "skipped: <reason>"]
+- **Plan folders removed**: [.codebyplan/checkpoint + standalone, or "none"]
+(From Step 4.5. Omit this section if no export was attempted.)
+
 ### Version Bumps
 - [package]: [currentVersion] → [nextVersion]
 (From `context.shipment.version_bumps[]` — committed as `chore(release): bump versions`; publishes on merge. Omit this section if no packages were bumped.)

package/templates/skills/cbp-checkpoint-plan/SKILL.md

@@ -103,6 +103,14 @@ Sizing: with a 1M-token context, tasks can be large — group by coherent purpos
 
 For each task use `codebyplan task create --checkpoint-id <id> --number <n> --title <title> --requirements <json> --context <json>` (CLI write-through; break-glass: MCP `create_task`). **Additive mode:** create only tasks for steps not already covered by an existing task; never delete in-flight tasks. **Coverage check** — a plan step counts as covered only when an existing task's requirements address its full scope; when uncertain, create the task and note in its requirements `may overlap with TASK-N — review before executing`.
 
+After creating tasks, seed the three git-first editable plan-field docs into the checkpoint plan folder (NNN = checkpoint number zero-padded to 3 digits):
+
+- `.codebyplan/checkpoint/{NNN}/idea.md` — seeded from the captured idea content (the `ideas[0].description` and any multi-idea summary).
+- `.codebyplan/checkpoint/{NNN}/requirements.md` — seeded from the combined `ideas[].requirements` items.
+- `.codebyplan/checkpoint/{NNN}/research.md` — seeded from `checkpoint.research` (may be empty for level-0/1 checkpoints; write the file regardless so the push webhook can ingest it).
+
+These files are the git-first source of truth for their respective plan fields. The DB `plan_documents` rows are a projection ingested via the push-webhook round-trip after the branch push. Write the files with `Write` (create-or-overwrite); skip if the file already has content and this is an additive re-plan (do not overwrite user-edited content).
+
 ### Step 10: Persist Full Context
 
 Final write of the complete `checkpoint.context` JSONB via `codebyplan checkpoint update --id <id> --context <json>` (CLI write-through; break-glass: MCP `update_checkpoint`). Honor the **context-replaces-not-merges** contract: read the current context, merge your additions in memory, write the FULL object (`decisions` + `discoveries` + `dependencies` + `constraints` + `qa_answers` + `alternatives`). A partial write clobbers sibling keys. Phrase any database-verb words as prose in payloads (WAF gate).

package/templates/skills/cbp-standalone-task-complete/SKILL.md

@@ -111,6 +111,45 @@ Ensure the feat branch is current with the latest production work.
 3. If QA warnings the user chose to commit-as-is: continue to Step 5.7 with a soft warning.
 4. On clean success: continue to Step 5.7.
 
+### Step 5.6: Export + Plan-Folder Cleanup
+
+Export the standalone task's workflow data and remove the generated plan-folder
+trees from the git index. This step is **best-effort** — a failure here MUST
+NOT block push or ship. Warn and continue on any error.
+
+1. Run export (capture result for Step 9 summary):
+
+   ```bash
+   npx codebyplan standalone-task export --id <STANDALONE_TASK_ID>
+   ```
+
+   - On exit 0: parse JSON stdout → `EXPORT_RESULT` (`{ exported, path }`).
+   - On non-zero exit: emit a warning, set `EXPORT_RESULT = { exported: false, error: "<stderr summary>" }`, continue.
+
+2. Stage the export artifacts and run plan-folder cleanup:
+
+   ```bash
+   git add .codebyplan/exports/
+   npx codebyplan cleanup-plan-folders
+   ```
+
+   - On cleanup non-zero exit: emit a warning, continue.
+
+3. Commit if anything was staged:
+
+   ```bash
+   git diff --cached --name-only
+   ```
+
+   If the output is non-empty, commit with:
+
+   ```bash
+   git commit -m "feat: export standalone TASK-<N> and remove plan-folder docs"
+   ```
+
+   Use the standalone task number for `<N>`. Do NOT include any mention of AI
+   tooling in the commit message.
+
 ### Step 5.7: Push
 
 Push once, carrying both the task commit and the merge commit:
@@ -208,6 +247,7 @@ Apply the `cleanup` skill inline to remove orphan references to deleted/modified
 **Merge commit**: [merge_commit]
 **Branch deleted**: [branch_deleted]
 **Version bumps**: [<name>: <current> → <next> per package, or "none"]
+**Export**: [EXPORT_RESULT.path from Step 5.6, or "skipped: <reason>"]
 **Warnings**: [any QA / file-approval warnings from Step 3, or "none"]
 ```