agentplane 0.2.6 → 0.2.13

package/README.md

@@ -46,6 +46,15 @@ npx agentplane quickstart
 - Built-in agent definitions are copied into `.agentplane/agents/`.
 - Optional recipes can install additional agents when you run `agentplane recipes install ...`.
 
+## Upgrade review reports
+
+After `agentplane upgrade` (auto or agent-assisted mode), a machine-readable review report is written under `.agentplane/.upgrade/`:
+
+- Agent mode: `.agentplane/.upgrade/agent/<runId>/review.json`
+- Auto mode: `.agentplane/.upgrade/last-review.json`
+
+If any entry has `needsSemanticReview: true`, treat it as a signal to create an `UPGRADER` task to perform a semantic prompt merge.
+
 ## Guardrails and artifacts
 
 - Approval gates for plans and network access (configured in `.agentplane/config.json`).
@@ -87,6 +96,8 @@ npx agentplane --help
 ```bash
 agentplane --help
 agentplane quickstart
+agentplane role ORCHESTRATOR
+agentplane role UPGRADER
 agentplane config show
 agentplane task list
 agentplane task new --title "..." --description "..." --priority med --owner ORCHESTRATOR --tag docs

package/assets/AGENTS.md

@@ -72,11 +72,13 @@ If unsure whether an action mutates state, treat it as mutating.
 - Never invent facts about repo state. Prefer inspection over guessing.
 - Never modify `.agentplane/tasks.json` manually. It is an **export-only snapshot** generated via `agentplane task export`.
 - Never expose raw internal chain-of-thought. Use structured artifacts instead (see OUTPUT CONTRACTS).
+- Timestamps are recorded in task metadata fields (for example `plan_approval.updated_at` and `verification.updated_at`); do not duplicate timestamps in human notes unless explicitly required.
 
 ## Cleanliness & untracked files
 
 - Ignore pre-existing untracked files you did not create.
 - Only stage/commit files intentionally modified for the current task.
+- Any tracked code changes must be recorded in a git commit before finishing the task (do not leave `packages/**` diffs uncommitted).
 - “Clean” means: **no tracked changes** (`git status --short --untracked-files=no` is empty).
 - If untracked files interfere with verify/guardrails or fall inside the task scope paths, surface them as a risk and request approval before acting.
 
@@ -105,6 +107,39 @@ Outside-repo includes (non-exhaustive):
 - modifying keychains, ssh keys, credential stores
 - any tool that mutates outside-repo state
 
+## Framework Upgrade / Prompt Merge
+
+`agentplane upgrade` is responsible for mechanical upgrades and safe merges. When an upgrade run indicates a potential semantic conflict (for example, both local and incoming changes exist relative to a baseline, or a baseline is missing but files differ), treat the result as requiring a meaning-level review.
+
+Trigger:
+
+- After running `agentplane upgrade`, check the latest upgrade review report:
+  - Agent mode: `.agentplane/.upgrade/agent/<runId>/review.json`
+  - Auto mode: `.agentplane/.upgrade/last-review.json`
+- If any record has `needsSemanticReview: true`, prompt merge is required.
+
+Protocol:
+
+1. ORCHESTRATOR runs the upgrade (or coordinates whoever runs it) and identifies the upgrade run artifacts directory (for example `.agentplane/.upgrade/agent/<runId>/`).
+2. If the upgrade review report indicates semantic conflicts (`needsSemanticReview: true` for any file), ORCHESTRATOR instructs PLANNER to create a downstream task owned by `UPGRADER`.
+3. UPGRADER performs semantic reconciliation of `AGENTS.md` and `.agentplane/agents/*.json`:
+   - `AGENTS.md` remains the canonical policy source (highest priority).
+   - Preserve local customizations via the Local Overrides block (`<!-- AGENTPLANE:LOCAL-START/END -->`) where feasible.
+   - Minimize unrelated churn in agent JSON profiles; remove contradictions with `AGENTS.md`.
+
+Task creation requirements (PLANNER):
+
+- Owner: `UPGRADER`
+- Description must include:
+  - the upgrade run directory path (for example `.agentplane/.upgrade/agent/<runId>/`)
+  - the list of `relPath` entries with `needsSemanticReview: true` from `review.json`
+
+Done when:
+
+- No contradictions remain between `AGENTS.md` and agent profiles.
+- Local overrides are preserved (or explicitly removed with a documented decision).
+- Relevant lint/tests pass.
+
 ---
 
 # NON-NEGOTIABLE PIPELINE

package/assets/agents/CODER.json

@@ -21,7 +21,6 @@
     "Confirm task context and readiness before editing; keep diffs minimal and task-scoped.",
     "Document edits with before/after snippets and cite the exact files touched.",
     "Run necessary commands (tests/linters/formatters) and summarize key output lines only.",
-    "When writing verification notes (and any other approval/verification notes that include timestamps), use an ISO 8601 UTC timestamp with time, e.g. 2026-02-07T16:20:02.717Z; avoid date-only values like 2026-02-07.",
     "Prefer declared verify commands; record ad-hoc results via PR notes or request PLANNER to update verify lists.",
     "Coordinate handoffs to TESTER/REVIEWER/DOCS with task ID, changed files, and expected behavior.",
     "Avoid task closure in branch_pr; keep commits task-scoped and update status via agentplane."

package/assets/agents/INTEGRATOR.json

@@ -21,7 +21,6 @@
     "Operate from the repo root on the pinned base branch; run pr check -> integrate -> finish via agentplane.",
     "Use configured base branch and task branch prefix when referencing branches; check config if uncertain.",
     "Ensure verify commands are run/recorded; update PR artifacts and task README as needed.",
-    "When writing verification notes (and any other approval/verification notes that include timestamps), use an ISO 8601 UTC timestamp with time, e.g. 2026-02-07T16:20:02.717Z; avoid date-only values like 2026-02-07.",
     "When closing multiple tasks, use batch finish so the same commit metadata and verification note apply.",
     "Check `closure_commit_requires_approval` in .agentplane/config.json; ask for user approval before the final closure commit when true, otherwise proceed without confirmation. Optionally clean task branches/worktrees after closure."
   ]

package/assets/agents/ORCHESTRATOR.json

@@ -15,7 +15,6 @@
   "workflow": [
     "Follow shared workflow rules in AGENTS.md and `agentplane quickstart` / `agentplane role <ROLE>` output.",
     "Before planning or execution, load .agentplane/config.json and `agentplane quickstart` / `agentplane role <ROLE>` output; do not output their contents, only report that they were loaded.",
-    "When writing plan approval notes (and any other approval/verification notes), use an ISO 8601 UTC timestamp with time, e.g. 2026-02-07T16:20:02.717Z; avoid date-only values like 2026-02-07.",
     "Use `agentplane config show|set` for config changes (workflow_mode, branch/task settings); avoid manual edits.",
     "Convert the first user message into a top-level plan; do not create tasks until the user approves it.",
     "Restate the user goal and constraints, then draft a numbered top-level plan with agent assignments and expected outcomes.",
@@ -24,7 +23,7 @@
     "If the user explicitly requests agent optimization, invoke UPDATER and pause until its analysis is complete.",
     "Await plan approval before executing steps, then proceed autonomously unless new scope, risks, or constraints require another check-in.",
     "After plan approval, if recipes are in scope, request confirmation to refresh the recipe index via `agentplane recipes list-remote --refresh`, then use `agentplane recipes list` / `agentplane recipes explain <id>` to select recipes. For scenarios, use `agentplane scenario list` and `agentplane scenario run <recipe:scenario>`.",
-    "After approval, create a top-level tracking task via agentplane unless the user explicitly opts out; include at least one tag and create any additional tasks from the approved decomposition.",
+    "After approval, create exactly one top-level tracking task via agentplane unless the user explicitly opts out; do not create downstream tasks (PLANNER owns downstream task creation).",
     "Execute step by step and summarize task IDs plus commit hashes after each major step.",
     "If the user opts out of task creation, track progress against the approved plan in replies.",
     "Before any final task-closing commit, check `closure_commit_requires_approval` in .agentplane/config.json; request user approval when true, otherwise proceed without confirmation. Finalize with a concise summary and next steps."

package/assets/agents/PLANNER.json

@@ -8,7 +8,6 @@
   ],
   "outputs": [
     "Updated tasks in the canonical backend reflecting priorities and statuses.",
-    "A single top-level task per user request when the user approves task creation (unless they opt out).",
     "A clear backlog view so humans can review current state quickly.",
     "Structured reply listing every touched task ID, its new status, and rationale."
   ],
@@ -18,8 +17,7 @@
   "workflow": [
     "Follow shared workflow rules in AGENTS.md and `agentplane quickstart` / `agentplane role <ROLE>` output.",
     "Review the backlog before changes to avoid duplicates or conflicts.",
-    "When writing plan approval notes, use an ISO 8601 UTC timestamp with time, e.g. 2026-02-07T16:20:02.717Z; avoid date-only values like 2026-02-07.",
-    "For each top-level user request, after the user approves task creation, create exactly one top-level task via agentplane unless the user explicitly opts out; reference plan items or downstream task IDs in its description or comments.",
+    "After overall plan approval, create downstream tasks for the approved decomposition (top-level tracking task creation is owned by ORCHESTRATOR).",
     "Decompose goals into atomic tasks with a single owner; set depends_on explicitly (use [] for none).",
     "Assign each task to an existing agent ID or schedule CREATOR if no suitable agent exists.",
     "Create new tasks via task new (reserve task add for pre-existing IDs); include at least one tag and keep tags minimal.",

package/assets/agents/TESTER.json

@@ -22,7 +22,6 @@
     "Add the smallest set of high-value tests (happy path + edge/regression).",
     "Keep tests deterministic and fast; avoid network calls and time-based flakiness.",
     "Run targeted tests first and summarize only the key output lines.",
-    "When writing verification notes (and any other approval/verification notes that include timestamps), use an ISO 8601 UTC timestamp with time, e.g. 2026-02-07T16:20:02.717Z; avoid date-only values like 2026-02-07.",
     "If test infrastructure is missing, document the blocker and request a PLANNER task."
   ]
 }

package/assets/agents/UPGRADER.json

@@ -1,27 +1,29 @@
 {
   "id": "UPGRADER",
-  "role": "Keep the Agent Plane framework fresh by syncing with the upstream release.",
-  "description": "Monitors the recorded framework update timestamp, triggers an upgrade when the cache is stale (10+ days) or on explicit demand, and ensures the config metadata reflects the refresh.",
+  "role": "Resolve semantic conflicts after `agentplane upgrade` (prompt/policy merge).",
+  "description": "Performs meaning-level reconciliation when `agentplane upgrade` completed a mechanical merge but there is risk of semantic conflict between local prompt/policy edits and upstream framework changes.",
   "inputs": [
-    "The owning task id that documents when to run the upgrade.",
-    "The `framework` section of `.agentplane/config.json`, especially `last_update` and `source`.",
-    "Any upstream release context (e.g., user request, automation schedule, or linked task note)."
+    "An upgrade run directory (typically `.agentplane/.upgrade/agent/<runId>/`) containing plan/constraints/report artifacts (and `review.json` when available).",
+    "The list of files flagged for semantic review by the upgrade report (or a manually provided list of changed prompt/policy files).",
+    "The current workspace versions of `AGENTS.md` and `.agentplane/agents/*.json` (and the packaged defaults under `packages/agentplane/assets/`)."
   ],
   "outputs": [
-    "An updated `.agentplane/config.json` capturing the new `framework.last_update` (ISO 8601 date).",
-    "A short report describing whether the upgrade ran because of staleness or a forced request.",
-    "Logs/PR notes referencing `agentplane upgrade` runs and git fetch/pull results."
+    "A reconciled `AGENTS.md` and `.agentplane/agents/*.json` with no contradictions against the canonical policy priority order.",
+    "A short semantic-merge report listing the conflicts found, decisions made, and where any local customizations were preserved.",
+    "A commit (direct mode) or PR note/patch (branch_pr) referencing the upgrade run directory used as input."
   ],
   "permissions": [
-    "Project files: read/write access to `.agentplane/config.json` plus any git-controlled files touched by the upgrade.",
-    "Git: inspect status, run fetch/pull, and record results via agentplane commands.",
-    "Terminal: execute `agentplane upgrade` and related helper commands."
+    "Project files: read/write access to `AGENTS.md` and `.agentplane/agents/*.json` plus the packaged assets under `packages/agentplane/assets/`.",
+    "Git: inspect status and create commits via `agentplane commit` (or PR artifacts in branch_pr).",
+    "Terminal: run local tests/lint for changed areas and summarize evidence."
   ],
   "workflow": [
     "Follow shared workflow rules in AGENTS.md and `agentplane quickstart` / `agentplane role <ROLE>` output.",
-    "Check the `framework.last_update` date from `.agentplane/config.json`; compare it to UTC today and detect when 10+ days have passed.",
-    "Invoke `agentplane upgrade --force` when a user explicitly requests an update, or rely on the stale-date logic otherwise.",
-    "Require a clean working tree and run the upgrade from the pinned base branch (or current branch when unpinned in branch_pr).",
-    "After a successful upgrade, update `framework.last_update` to `datetime.now(UTC).date()` and document the run in the owning task/pr artifacts."
+    "Treat `AGENTS.md` as the canonical policy (highest priority); do not introduce rules that contradict it.",
+    "Load the upgrade run artifacts (runDir) and extract the list of files that need semantic review.",
+    "Reconcile `AGENTS.md` changes by preserving local customizations inside the Local Overrides block (`<!-- AGENTPLANE:LOCAL-START/END -->`) where feasible.",
+    "Reconcile `.agentplane/agents/*.json` by removing contradictions with `AGENTS.md` and minimizing unrelated churn; keep non-conflicting local improvements.",
+    "Run local checks appropriate for the touched surfaces (lint and relevant tests) and record evidence in the task verification log.",
+    "Produce a concise report: conflicts, decisions, and resulting file list; reference the runDir for traceability."
   ]
 }

package/dist/cli/archive.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../../src/cli/archive.ts"],"names":[],"mappings":"AAWA,KAAK,WAAW,GAAG,KAAK,GAAG,KAAK,CAAC;AAOjC,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAU9B;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAKtE;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBhB;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,iBAAiB,EAAE,CA2BjG"}
+{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../../src/cli/archive.ts"],"names":[],"mappings":"AAaA,KAAK,WAAW,GAAG,KAAK,GAAG,KAAK,CAAC;AAOjC,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAS9B;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAKtE;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBhB;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,iBAAiB,EAAE,CA2BjG"}

package/dist/cli/archive.js

@@ -1,6 +1,8 @@
 import { execFile } from "node:child_process";
+import { readFile } from "node:fs/promises";
 import { promisify } from "node:util";
 import path from "node:path";
+import { gunzipSync } from "node:zlib";
 import yauzl from "yauzl";
 import { CliError } from "../shared/errors.js";
 import { exitCodeForError } from "./exit-codes.js";
@@ -12,8 +14,7 @@ export async function validateArchive(archivePath, type) {
         const symlinks = entries.filter((entry) => entry.isSymlink).map((entry) => entry.name);
         return validateArchiveEntries(entryNames, symlinks);
     }
-    const entries = await listArchiveEntries(archivePath, type);
-    const symlinks = await listArchiveSymlinks(archivePath, type);
+    const { entries, symlinks } = await listTarGzEntries(archivePath);
     return validateArchiveEntries(entries, symlinks);
 }
 export function detectArchiveType(filePath) {
@@ -77,42 +78,66 @@ export function validateArchiveEntries(entries, symlinks) {
     }
     return issues;
 }
-async function listArchiveEntries(archivePath, type) {
-    if (type === "tar") {
-        const { stdout } = await execFileAsync("tar", ["-tzf", archivePath]);
-        return stdout
-            .split("\n")
-            .map((line) => line.trim())
-            .filter((line) => line.length > 0);
-    }
-    const { stdout } = await execFileAsync("unzip", ["-Z1", archivePath]);
-    return stdout
-        .split("\n")
-        .map((line) => line.trim())
-        .filter((line) => line.length > 0);
+function parseTarOctal(field) {
+    const text = field.toString("utf8").replace(/\0.*$/u, "").trim();
+    if (!text)
+        return 0;
+    const n = Number.parseInt(text, 8);
+    return Number.isFinite(n) && n >= 0 ? n : 0;
+}
+function isAllZeroBlock(block) {
+    for (const b of block)
+        if (b !== 0)
+            return false;
+    return true;
 }
-async function listArchiveSymlinks(archivePath, type) {
-    if (type === "tar") {
-        const { stdout } = await execFileAsync("tar", ["-tvzf", archivePath]);
-        return stdout
-            .split("\n")
-            .map((line) => line.trim())
-            .filter((line) => line.startsWith("l"))
-            .map((line) => {
-            const arrowIndex = line.indexOf(" -> ");
-            const left = arrowIndex === -1 ? line : line.slice(0, arrowIndex);
-            const tokens = left.trim().split(/\s+/);
-            return tokens.at(-1) ?? "";
-        })
-            .filter((entry) => entry.length > 0);
+async function listTarGzEntries(archivePath) {
+    let gz;
+    try {
+        gz = await readFile(archivePath);
+    }
+    catch (err) {
+        const e = err;
+        throw new CliError({
+            exitCode: exitCodeForError("E_IO"),
+            code: "E_IO",
+            message: `Failed to read archive: ${archivePath}${e?.message ? `\n${e.message}` : ""}`,
+        });
+    }
+    let tar;
+    try {
+        tar = gunzipSync(gz);
+    }
+    catch (err) {
+        const e = err;
+        throw new CliError({
+            exitCode: exitCodeForError("E_IO"),
+            code: "E_IO",
+            message: `Failed to gunzip tar archive: ${archivePath}` + (e?.message ? `\n${e.message}` : ""),
+        });
+    }
+    const entries = [];
+    const symlinks = [];
+    let offset = 0;
+    while (offset + 512 <= tar.length) {
+        const header = tar.subarray(offset, offset + 512);
+        offset += 512;
+        if (isAllZeroBlock(header))
+            break;
+        const nameRaw = header.subarray(0, 100).toString("utf8").replace(/\0.*$/u, "");
+        const prefixRaw = header.subarray(345, 500).toString("utf8").replace(/\0.*$/u, "");
+        const name = prefixRaw ? `${prefixRaw}/${nameRaw}` : nameRaw;
+        const size = parseTarOctal(header.subarray(124, 136));
+        const typeflag = header.subarray(156, 157).toString("utf8");
+        if (name) {
+            entries.push(name);
+            if (typeflag === "2")
+                symlinks.push(name);
+        }
+        const blocks = Math.ceil(size / 512);
+        offset += blocks * 512;
     }
-    const { stdout } = await execFileAsync("unzip", ["-Z", "-v", archivePath]);
-    return stdout
-        .split("\n")
-        .map((line) => line.trim())
-        .filter((line) => /\bsymlink\b/i.test(line) || /\blrwx/.test(line))
-        .map((line) => line.split(/\s+/).at(-1) ?? "")
-        .filter((entry) => entry.length > 0);
+    return { entries, symlinks };
 }
 function listZipEntries(archivePath) {
     return new Promise((resolve, reject) => {

package/dist/cli/command-guide.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-guide.d.ts","sourceRoot":"","sources":["../../src/cli/command-guide.ts"],"names":[],"mappings":"AA+LA,wBAAgB,SAAS,IAAI,MAAM,EAAE,CAEpC;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOzD;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CA2EzC"}
+{"version":3,"file":"command-guide.d.ts","sourceRoot":"","sources":["../../src/cli/command-guide.ts"],"names":[],"mappings":"AA+LA,wBAAgB,SAAS,IAAI,MAAM,EAAE,CAEpC;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOzD;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CA6EzC"}

package/dist/cli/command-guide.js

@@ -69,7 +69,7 @@ const ROLE_GUIDES = [
         role: "ORCHESTRATOR",
         lines: [
             "- Plan intake: `agentplane task list` / `agentplane task show <task-id>`",
-            '- After plan approval (unless the user opts out): `agentplane task new --title "..." --description "..." --priority med --owner ORCHESTRATOR --depends-on "[]" --tag <tag>`',
+            '- After plan approval (unless the user opts out): create exactly one tracking task: `agentplane task new --title "..." --description "..." --priority med --owner ORCHESTRATOR --depends-on "[]" --tag <tag>`',
             "- Optional scaffold: `agentplane task scaffold <task-id>`",
             "- Two-stage verification: `## Verify Steps` is the ex-ante contract; `agentplane verify ...` appends an ex-post entry into `## Verification`.",
         ],
@@ -187,9 +187,11 @@ export function renderQuickstart() {
     return [
         "# agentplane quickstart",
         "",
-        "agentplane CLI is the source of truth for task, PR, verify, and commit commands.",
+        "AGENTS.md is the source of truth for the workflow/process policy; quickstart and role output are the source of truth for CLI syntax and artifacts.",
         "Do not edit `.agentplane/tasks.json` by hand.",
         "",
+        "- See AGENTS.md for the canonical workflow policy and approval gates.",
+        "",
         "## Project setup",
         "",
         "- `agentplane init` (bootstrap `.agentplane/`)",
@@ -242,7 +244,7 @@ export function renderQuickstart() {
         "## Global flags",
         "",
         "- `--root <path>`: treat <path> as project root",
-        "- `--json`: emit JSON-formatted errors",
+        "- `--json-errors`: emit JSON-formatted errors",
         "- `--help` / `-h`: show help",
         "- `--version`: show version",
         "- `--no-update-check`: skip checking npm for a newer CLI version",

package/dist/cli/run-cli/command-catalog.d.ts

@@ -1,8 +1,11 @@
 import type { CommandHandler, CommandSpec } from "../spec/spec.js";
 import type { HelpJson } from "../spec/help-render.js";
 import type { CommandContext } from "../../commands/shared/task-backend.js";
+import type { LoadedConfig, ResolvedProject } from "@agentplaneorg/core";
 export type RunDeps = {
     getCtx: (commandForErrorContext: string) => Promise<CommandContext>;
+    getResolvedProject: (commandForErrorContext: string) => Promise<ResolvedProject>;
+    getLoadedConfig: (commandForErrorContext: string) => Promise<LoadedConfig>;
     getHelpJsonForDocs: () => readonly HelpJson[];
 };
 export type CommandEntry = {
@@ -12,5 +15,5 @@ export type CommandEntry = {
     needsConfig: boolean;
     needsTaskContext: boolean;
 };
-export declare const COMMANDS: readonly [CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry];
+export declare const COMMANDS: readonly [CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry];
 //# sourceMappingURL=command-catalog.d.ts.map

package/dist/cli/run-cli/command-catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-catalog.d.ts","sourceRoot":"","sources":["../../../src/cli/run-cli/command-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AA8FvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAE5E,MAAM,MAAM,OAAO,GAAG;IACpB,MAAM,EAAE,CAAC,sBAAsB,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IACpE,kBAAkB,EAAE,MAAM,SAAS,QAAQ,EAAE,CAAC;CAC/C,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC3B,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;IAC1D,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,EAAE,OAAO,CAAC;CAC3B,CAAC;AAgBF,eAAO,MAAM,QAAQ,+rCA0VuB,CAAC"}
+{"version":3,"file":"command-catalog.d.ts","sourceRoot":"","sources":["../../../src/cli/run-cli/command-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAiGvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAC5E,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEzE,MAAM,MAAM,OAAO,GAAG;IACpB,MAAM,EAAE,CAAC,sBAAsB,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IACpE,kBAAkB,EAAE,CAAC,sBAAsB,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;IACjF,eAAe,EAAE,CAAC,sBAAsB,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IAC3E,kBAAkB,EAAE,MAAM,SAAS,QAAQ,EAAE,CAAC;CAC/C,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC3B,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;IAC1D,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,EAAE,OAAO,CAAC;CAC3B,CAAC;AAgBF,eAAO,MAAM,QAAQ,yuCAuYuB,CAAC"}

package/dist/cli/run-cli/command-catalog.js

@@ -3,10 +3,10 @@ import { agentsSpec, quickstartSpec, roleSpec } from "./commands/core.js";
 import { configSetSpec, configShowSpec, modeGetSpec, modeSetSpec } from "./commands/config.js";
 import { ideSyncSpec } from "./commands/ide.js";
 import { taskNewSpec } from "../../commands/task/new.spec.js";
-import { taskListSpec } from "../../commands/task/list.command.js";
-import { taskNextSpec } from "../../commands/task/next.command.js";
-import { taskSearchSpec } from "../../commands/task/search.command.js";
-import { taskShowSpec } from "../../commands/task/show.command.js";
+import { taskListSpec } from "../../commands/task/list.spec.js";
+import { taskNextSpec } from "../../commands/task/next.spec.js";
+import { taskSearchSpec } from "../../commands/task/search.spec.js";
+import { taskShowSpec } from "../../commands/task/show.spec.js";
 import { taskAddSpec } from "../../commands/task/add.command.js";
 import { taskUpdateSpec } from "../../commands/task/update.command.js";
 import { taskCommentSpec } from "../../commands/task/comment.command.js";
@@ -34,7 +34,7 @@ import { workStartSpec } from "../../commands/branch/work-start.command.js";
 import { branchBaseClearSpec, branchBaseExplainSpec, branchBaseGetSpec, branchBaseSetSpec, branchBaseSpec, } from "../../commands/branch/base.command.js";
 import { branchStatusSpec } from "../../commands/branch/status.command.js";
 import { branchRemoveSpec } from "../../commands/branch/remove.command.js";
-import { recipesInstallSpec } from "../../commands/recipes/install.command.js";
+import { recipesInstallSpec } from "../../commands/recipes/install.spec.js";
 import { recipesListSpec } from "../../commands/recipes/list.command.js";
 import { recipesListRemoteSpec } from "../../commands/recipes/list-remote.command.js";
 import { recipesInfoSpec } from "../../commands/recipes/info.command.js";
@@ -53,12 +53,12 @@ import { scenarioSpec } from "../../commands/scenario/scenario.command.js";
 import { prCheckSpec, prNoteSpec, prOpenSpec, prSpec, prUpdateSpec, } from "../../commands/pr/pr.command.js";
 import { integrateSpec } from "../../commands/integrate.command.js";
 import { commitSpec } from "../../commands/commit.spec.js";
-import { startSpec } from "../../commands/start.command.js";
-import { blockSpec } from "../../commands/block.command.js";
-import { verifySpec } from "../../commands/verify.command.js";
-import { finishSpec } from "../../commands/finish.command.js";
+import { startSpec } from "../../commands/start.spec.js";
+import { blockSpec } from "../../commands/block.spec.js";
+import { verifySpec } from "../../commands/verify.spec.js";
+import { finishSpec } from "../../commands/finish.spec.js";
 import { readySpec } from "../../commands/ready.command.js";
-import { doctorSpec } from "../../commands/doctor.command.js";
+import { doctorSpec } from "../../commands/doctor.spec.js";
 import { docsCliSpec } from "../../commands/docs/cli.command.js";
 import { hooksSpec } from "../../commands/hooks/hooks.command.js";
 import { hooksInstallSpec } from "../../commands/hooks/install.command.js";
@@ -69,6 +69,9 @@ import { guardSpec } from "../../commands/guard/guard.command.js";
 import { guardCleanSpec } from "../../commands/guard/clean.command.js";
 import { guardSuggestAllowSpec } from "../../commands/guard/suggest-allow.command.js";
 import { guardCommitSpec } from "../../commands/guard/commit.command.js";
+import { releaseSpec } from "../../commands/release/release.command.js";
+import { releasePlanSpec } from "../../commands/release/plan.command.js";
+import { releaseApplySpec } from "../../commands/release/apply.command.js";
 function entry(spec, load, meta) {
     return {
         spec: spec,
@@ -89,6 +92,21 @@ export const COMMANDS = [
         needsConfig: false,
         needsTaskContext: false,
     }),
+    entry(releaseSpec, () => import("../../commands/release/release.command.js").then((m) => m.runRelease), {
+        needsProject: false,
+        needsConfig: false,
+        needsTaskContext: false,
+    }),
+    entry(releasePlanSpec, () => import("../../commands/release/plan.command.js").then((m) => m.runReleasePlan), {
+        needsProject: true,
+        needsConfig: false,
+        needsTaskContext: false,
+    }),
+    entry(releaseApplySpec, () => import("../../commands/release/apply.command.js").then((m) => m.runReleaseApply), {
+        needsProject: true,
+        needsConfig: false,
+        needsTaskContext: false,
+    }),
     entry(quickstartSpec, () => import("./commands/core.js").then((m) => m.runQuickstart), {
         needsProject: false,
         needsConfig: false,
@@ -99,45 +117,45 @@ export const COMMANDS = [
         needsConfig: false,
         needsTaskContext: false,
     }),
-    entry(agentsSpec, () => import("./commands/core.js").then((m) => m.runAgents), {
+    entry(agentsSpec, (deps) => import("./commands/core.js").then((m) => m.makeRunAgentsHandler(deps)), {
         needsProject: true,
         needsConfig: false,
         needsTaskContext: false,
     }),
-    entry(configShowSpec, () => import("./commands/config.js").then((m) => m.runConfigShow), {
+    entry(configShowSpec, (deps) => import("./commands/config.js").then((m) => m.makeRunConfigShowHandler(deps)), {
         needsProject: true,
         needsConfig: true,
         needsTaskContext: false,
     }),
-    entry(configSetSpec, () => import("./commands/config.js").then((m) => m.runConfigSet), {
+    entry(configSetSpec, (deps) => import("./commands/config.js").then((m) => m.makeRunConfigSetHandler(deps)), {
         needsProject: true,
         needsConfig: true,
         needsTaskContext: false,
     }),
-    entry(modeGetSpec, () => import("./commands/config.js").then((m) => m.runModeGet), {
+    entry(modeGetSpec, (deps) => import("./commands/config.js").then((m) => m.makeRunModeGetHandler(deps)), {
         needsProject: true,
         needsConfig: true,
         needsTaskContext: false,
     }),
-    entry(modeSetSpec, () => import("./commands/config.js").then((m) => m.runModeSet), {
+    entry(modeSetSpec, (deps) => import("./commands/config.js").then((m) => m.makeRunModeSetHandler(deps)), {
         needsProject: true,
         needsConfig: true,
         needsTaskContext: false,
     }),
-    entry(ideSyncSpec, () => import("./commands/ide.js").then((m) => m.runIdeSync), {
+    entry(ideSyncSpec, (deps) => import("./commands/ide.js").then((m) => m.makeRunIdeSyncHandler(deps)), {
         needsProject: true,
         needsConfig: true,
         needsTaskContext: false,
     }),
-    entry(doctorSpec, () => import("../../commands/doctor.command.js").then((m) => m.runDoctor), {
+    entry(doctorSpec, () => import("../../commands/doctor.run.js").then((m) => m.runDoctor), {
         needsProject: true,
         needsConfig: false,
         needsTaskContext: false,
     }),
-    entry(taskListSpec, (deps) => import("../../commands/task/list.command.js").then((m) => m.makeRunTaskListHandler(deps.getCtx))),
-    entry(taskNextSpec, (deps) => import("../../commands/task/next.command.js").then((m) => m.makeRunTaskNextHandler(deps.getCtx))),
-    entry(taskSearchSpec, (deps) => import("../../commands/task/search.command.js").then((m) => m.makeRunTaskSearchHandler(deps.getCtx))),
-    entry(taskShowSpec, (deps) => import("../../commands/task/show.command.js").then((m) => m.makeRunTaskShowHandler(deps.getCtx))),
+    entry(taskListSpec, (deps) => import("../../commands/task/list.run.js").then((m) => m.makeRunTaskListHandler(deps.getCtx))),
+    entry(taskNextSpec, (deps) => import("../../commands/task/next.run.js").then((m) => m.makeRunTaskNextHandler(deps.getCtx))),
+    entry(taskSearchSpec, (deps) => import("../../commands/task/search.run.js").then((m) => m.makeRunTaskSearchHandler(deps.getCtx))),
+    entry(taskShowSpec, (deps) => import("../../commands/task/show.run.js").then((m) => m.makeRunTaskShowHandler(deps.getCtx))),
     entry(taskNewSpec, (deps) => import("../../commands/task/new.command.js").then((m) => m.makeRunTaskNewHandler(deps.getCtx))),
     entry(taskDeriveSpec, (deps) => import("../../commands/task/derive.command.js").then((m) => m.makeRunTaskDeriveHandler(deps.getCtx))),
     entry(taskAddSpec, (deps) => import("../../commands/task/add.command.js").then((m) => m.makeRunTaskAddHandler(deps.getCtx))),
@@ -171,7 +189,7 @@ export const COMMANDS = [
     entry(recipesExplainSpec, () => import("../../commands/recipes/explain.command.js").then((m) => m.runRecipesExplain)),
     entry(recipesRemoveSpec, () => import("../../commands/recipes/remove.command.js").then((m) => m.runRecipesRemove)),
     entry(recipesCachePruneSpec, () => import("../../commands/recipes/cache-prune.command.js").then((m) => m.runRecipesCachePrune)),
-    entry(recipesInstallSpec, () => import("../../commands/recipes/install.command.js").then((m) => m.runRecipesInstall)),
+    entry(recipesInstallSpec, () => import("../../commands/recipes/install.run.js").then((m) => m.runRecipesInstall)),
     entry(scenarioSpec, () => import("../../commands/scenario/scenario.command.js").then((m) => m.runScenario)),
     entry(scenarioListSpec, () => import("../../commands/scenario/list.command.js").then((m) => m.runScenarioList)),
     entry(scenarioInfoSpec, () => import("../../commands/scenario/info.command.js").then((m) => m.runScenarioInfo)),
@@ -193,10 +211,10 @@ export const COMMANDS = [
     entry(prNoteSpec, (deps) => import("../../commands/pr/pr.command.js").then((m) => m.makeRunPrNoteHandler(deps.getCtx))),
     entry(integrateSpec, (deps) => import("../../commands/integrate.command.js").then((m) => m.makeRunIntegrateHandler(deps.getCtx))),
     entry(commitSpec, (deps) => import("../../commands/commit.command.js").then((m) => m.makeRunCommitHandler(deps.getCtx))),
-    entry(startSpec, (deps) => import("../../commands/start.command.js").then((m) => m.makeRunStartHandler(deps.getCtx))),
-    entry(blockSpec, (deps) => import("../../commands/block.command.js").then((m) => m.makeRunBlockHandler(deps.getCtx))),
-    entry(verifySpec, (deps) => import("../../commands/verify.command.js").then((m) => m.makeRunVerifyHandler(deps.getCtx))),
-    entry(finishSpec, (deps) => import("../../commands/finish.command.js").then((m) => m.makeRunFinishHandler(deps.getCtx))),
+    entry(startSpec, (deps) => import("../../commands/start.run.js").then((m) => m.makeRunStartHandler(deps.getCtx))),
+    entry(blockSpec, (deps) => import("../../commands/block.run.js").then((m) => m.makeRunBlockHandler(deps.getCtx))),
+    entry(verifySpec, (deps) => import("../../commands/verify.run.js").then((m) => m.makeRunVerifyHandler(deps.getCtx))),
+    entry(finishSpec, (deps) => import("../../commands/finish.run.js").then((m) => m.makeRunFinishHandler(deps.getCtx))),
     entry(readySpec, (deps) => import("../../commands/ready.command.js").then((m) => m.makeRunReadyHandler(deps.getCtx))),
     entry(docsCliSpec, (deps) => import("../../commands/docs/cli.command.js").then((m) => m.makeRunDocsCliHandler(deps.getHelpJsonForDocs))),
     entry(hooksSpec, () => import("../../commands/hooks/hooks.command.js").then((m) => m.runHooks)),

package/dist/cli/run-cli/commands/config.d.ts

@@ -1,20 +1,21 @@
 import type { CommandHandler, CommandSpec } from "../../spec/spec.js";
+import type { RunDeps } from "../command-catalog.js";
 type ConfigShowParsed = Record<string, never>;
 export declare const configShowSpec: CommandSpec<ConfigShowParsed>;
-export declare const runConfigShow: CommandHandler<ConfigShowParsed>;
+export declare function makeRunConfigShowHandler(deps: RunDeps): CommandHandler<ConfigShowParsed>;
 type ConfigSetParsed = {
     key: string;
     value: string;
 };
 export declare const configSetSpec: CommandSpec<ConfigSetParsed>;
-export declare const runConfigSet: CommandHandler<ConfigSetParsed>;
+export declare function makeRunConfigSetHandler(deps: RunDeps): CommandHandler<ConfigSetParsed>;
 type ModeGetParsed = Record<string, never>;
 export declare const modeGetSpec: CommandSpec<ModeGetParsed>;
-export declare const runModeGet: CommandHandler<ModeGetParsed>;
+export declare function makeRunModeGetHandler(deps: RunDeps): CommandHandler<ModeGetParsed>;
 type ModeSetParsed = {
     mode: string;
 };
 export declare const modeSetSpec: CommandSpec<ModeSetParsed>;
-export declare const runModeSet: CommandHandler<ModeSetParsed>;
+export declare function makeRunModeSetHandler(deps: RunDeps): CommandHandler<ModeSetParsed>;
 export {};
 //# sourceMappingURL=config.d.ts.map

package/dist/cli/run-cli/commands/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../src/cli/run-cli/commands/config.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtE,KAAK,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAE9C,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,gBAAgB,CAMxD,CAAC;AAgBF,eAAO,MAAM,aAAa,EAAE,cAAc,CAAC,gBAAgB,CACM,CAAC;AAElE,KAAK,eAAe,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtD,eAAO,MAAM,aAAa,EAAE,WAAW,CAAC,eAAe,CAgBtD,CAAC;AA8BF,eAAO,MAAM,YAAY,EAAE,cAAc,CAAC,eAAe,CACmC,CAAC;AAE7F,KAAK,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAE3C,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,aAAa,CAMlD,CAAC;AAgBF,eAAO,MAAM,UAAU,EAAE,cAAc,CAAC,aAAa,CACS,CAAC;AAE/D,KAAK,aAAa,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtC,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,aAAa,CAgBlD,CAAC;AA2BF,eAAO,MAAM,UAAU,EAAE,cAAc,CAAC,aAAa,CAKjD,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../src/cli/run-cli/commands/config.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAGrD,KAAK,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAE9C,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,gBAAgB,CAMxD,CAAC;AAcF,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,CAAC,gBAAgB,CAAC,CAExF;AAED,KAAK,eAAe,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtD,eAAO,MAAM,aAAa,EAAE,WAAW,CAAC,eAAe,CAgBtD,CAAC;AA6BF,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,CAAC,eAAe,CAAC,CAStF;AAED,KAAK,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAE3C,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,aAAa,CAMlD,CAAC;AAcF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,CAAC,aAAa,CAAC,CAElF;AAED,KAAK,aAAa,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtC,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,aAAa,CAgBlD,CAAC;AA0BF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,CAAC,aAAa,CAAC,CAQlF"}