agentplane 0.3.5 → 0.3.7

package/dist/cli/run-cli.test-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-cli.test-helpers.d.ts","sourceRoot":"","sources":["../../src/cli/run-cli.test-helpers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"run-cli.test-helpers.d.ts","sourceRoot":"","sources":["../../src/cli/run-cli.test-helpers.ts"],"names":[],"mappings":"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"}

package/dist/cli/run-cli.test-helpers.js

@@ -6,7 +6,7 @@ import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { promisify } from "node:util";
 import { gzipSync } from "node:zlib";
-import { afterAll, afterEach, beforeAll } from "vitest";
+import { afterAll, afterEach, beforeAll, beforeEach, vi } from "vitest";
 import { defaultConfig } from "@agentplaneorg/core";
 import { runCli } from "./run-cli.js";
 const execFileAsync = promisify(execFile);
@@ -98,6 +98,17 @@ export function registerAgentplaneHome() {
         }));
     });
 }
+export function installRunCliIntegrationHarness() {
+    registerAgentplaneHome();
+    let restoreStdIO = null;
+    beforeEach(() => {
+        restoreStdIO = silenceStdIO();
+    });
+    afterEach(() => {
+        restoreStdIO?.();
+        restoreStdIO = null;
+    });
+}
 export function getAgentplaneHome() {
     return agentplaneHome;
 }
@@ -150,6 +161,28 @@ export function silenceStdIO() {
         }
     };
 }
+export function stubTaskBackend(overrides = {}) {
+    return {
+        id: "local",
+        capabilities: {
+            canonical_source: "local",
+            projection: "canonical",
+            reads_from_projection_by_default: false,
+            writes_task_readmes: true,
+            supports_task_revisions: true,
+            supports_revision_guarded_writes: true,
+            may_access_network_on_read: false,
+            may_access_network_on_write: false,
+            supports_projection_refresh: false,
+            supports_push_sync: false,
+            supports_snapshot_export: false,
+        },
+        listTasks: vi.fn().mockResolvedValue([]),
+        getTask: vi.fn().mockResolvedValue(null),
+        writeTask: vi.fn().mockImplementation(() => Promise.resolve()),
+        ...overrides,
+    };
+}
 export async function runCliSilent(args) {
     const io = captureStdIO();
     try {
@@ -215,11 +248,60 @@ export async function createRecipeArchive(opts) {
         name: opts?.name ?? "Viewer",
         summary: opts?.summary ?? "Preview task artifacts",
         description: opts?.description ?? "Provides a local viewer for task artifacts.",
-        agents: [{ id: "RECIPE_AGENT", summary: "Recipe agent", file: "agents/recipe.json" }],
+        compatibility: {
+            min_agentplane_version: "0.3.5",
+            manifest_api_version: "1",
+            scenario_api_version: "1",
+            runtime_api_version: "1",
+            platforms: ["darwin", "linux"],
+            repo_types: ["generic"],
+        },
+        skills: [
+            {
+                id: "RECIPE_SKILL",
+                summary: "Recipe analysis skill",
+                kind: "agent-skill",
+                file: "skills/analysis.json",
+            },
+        ],
+        agents: [
+            {
+                id: "RECIPE_AGENT",
+                display_name: "Recipe Agent",
+                role: "executor",
+                summary: "Recipe agent",
+                skills: ["RECIPE_SKILL"],
+                tools: ["RECIPE_TOOL"],
+                file: "agents/recipe.json",
+            },
+        ],
         tools: [
             { id: "RECIPE_TOOL", summary: "Recipe tool", runtime: "node", entrypoint: "tools/run.js" },
         ],
-        scenarios: [{ id: "RECIPE_SCENARIO", summary: "Recipe scenario" }],
+        scenarios: [
+            {
+                id: "RECIPE_SCENARIO",
+                name: "Recipe Scenario",
+                summary: "Recipe scenario",
+                use_when: ["Task artifacts need local preview"],
+                required_inputs: ["task_id"],
+                outputs: ["report"],
+                permissions: ["filesystem-write"],
+                artifacts: ["artifact.txt"],
+                agents_involved: ["RECIPE_AGENT"],
+                skills_used: ["RECIPE_SKILL"],
+                tools_used: ["RECIPE_TOOL"],
+                run_profile: {
+                    mode: "analysis",
+                    sandbox: "workspace-write",
+                    network: false,
+                    requires_human_approval: false,
+                    writes_artifacts_to: ["logs/", "reports/"],
+                    expected_exit_contract: "report",
+                },
+                file: "scenarios/recipe-scenario.json",
+            },
+        ],
     };
     if (normalizedTags) {
         manifest.tags = normalizedTags;
@@ -232,6 +314,13 @@ export async function createRecipeArchive(opts) {
         role: "Recipe agent",
         description: "Example agent installed from a recipe.",
     }, null, 2), "utf8");
+    const skillsDir = path.join(recipeDir, "skills");
+    await mkdir(skillsDir, { recursive: true });
+    await writeFile(path.join(skillsDir, "analysis.json"), JSON.stringify({
+        id: "RECIPE_SKILL",
+        summary: "Recipe analysis skill",
+        kind: "agent-skill",
+    }, null, 2), "utf8");
     const toolsDir = path.join(recipeDir, "tools");
     await mkdir(toolsDir, { recursive: true });
     await writeFile(path.join(toolsDir, "run.js"), [
@@ -302,22 +391,67 @@ export async function createUnsafeRecipeArchive(opts) {
         name: "Unsafe",
         summary: "Unsafe recipe",
         description: "Used for archive validation tests.",
-        agents: [{ id: "RECIPE_AGENT", summary: "Recipe agent", file: "agents/recipe.json" }],
+        skills: [
+            {
+                id: "RECIPE_SKILL",
+                summary: "Recipe skill",
+                kind: "agent-skill",
+                file: "skills/recipe.json",
+            },
+        ],
+        agents: [
+            {
+                id: "RECIPE_AGENT",
+                display_name: "Recipe Agent",
+                role: "executor",
+                summary: "Recipe agent",
+                skills: ["RECIPE_SKILL"],
+                tools: ["RECIPE_TOOL"],
+                file: "agents/recipe.json",
+            },
+        ],
         tools: [
             { id: "RECIPE_TOOL", summary: "Recipe tool", runtime: "bash", entrypoint: "tools/run.sh" },
         ],
-        scenarios: [{ id: "RECIPE_SCENARIO", summary: "Recipe scenario" }],
+        scenarios: [
+            {
+                id: "RECIPE_SCENARIO",
+                name: "Recipe Scenario",
+                summary: "Recipe scenario",
+                use_when: ["Unsafe validation fixture"],
+                required_inputs: [],
+                outputs: [],
+                permissions: [],
+                artifacts: [],
+                agents_involved: ["RECIPE_AGENT"],
+                skills_used: ["RECIPE_SKILL"],
+                tools_used: ["RECIPE_TOOL"],
+                run_profile: { mode: "analysis" },
+                file: "scenarios/recipe-scenario.json",
+            },
+        ],
     };
     await writeFile(path.join(recipeDir, "manifest.json"), JSON.stringify(manifest, null, 2), "utf8");
     const agentsDir = path.join(recipeDir, "agents");
     await mkdir(agentsDir, { recursive: true });
     await writeFile(path.join(agentsDir, "recipe.json"), JSON.stringify({ id: "RECIPE_AGENT", role: "Recipe agent" }, null, 2), "utf8");
+    const skillsDir = path.join(recipeDir, "skills");
+    await mkdir(skillsDir, { recursive: true });
+    await writeFile(path.join(skillsDir, "recipe.json"), JSON.stringify({ id: "RECIPE_SKILL" }), "utf8");
     const toolsDir = path.join(recipeDir, "tools");
     await mkdir(toolsDir, { recursive: true });
     await writeFile(path.join(toolsDir, "run.sh"), "#!/usr/bin/env bash\n", "utf8");
     const scenariosDir = path.join(recipeDir, "scenarios");
     await mkdir(scenariosDir, { recursive: true });
-    await writeFile(path.join(scenariosDir, "recipe-scenario.json"), JSON.stringify({ schema_version: "1", id: "RECIPE_SCENARIO", summary: "Recipe scenario" }, null, 2), "utf8");
+    await writeFile(path.join(scenariosDir, "recipe-scenario.json"), JSON.stringify({
+        schema_version: "1",
+        id: "RECIPE_SCENARIO",
+        summary: "Recipe scenario",
+        goal: "Exercise unsafe archive validation.",
+        inputs: [],
+        outputs: [],
+        steps: [{ tool: "RECIPE_TOOL" }],
+    }, null, 2), "utf8");
     const entryPath = opts.entryPath ?? "../evil.txt";
     await writeFile(path.join(baseDir, "evil.txt"), "evil", "utf8");
     const archivePath = opts.format === "zip" ? path.join(baseDir, "unsafe.zip") : path.join(baseDir, "unsafe.tar.gz");

package/dist/commands/backend/sync.command.d.ts

@@ -1,13 +1,17 @@
 import type { CommandCtx, CommandSpec } from "../../cli/spec/spec.js";
 import type { CommandContext } from "../shared/task-backend.js";
-import { type BackendSyncParsed } from "../backend.js";
+import { type BackendInspectParsed, type BackendMigrateCanonicalStateParsed, type BackendSyncParsed } from "../backend.js";
 type BackendRootParsed = {
     cmd: string[];
 };
 export declare const backendSpec: CommandSpec<BackendRootParsed>;
 export declare const backendSyncSpec: CommandSpec<BackendSyncParsed>;
+export declare const backendMigrateCanonicalStateSpec: CommandSpec<BackendMigrateCanonicalStateParsed>;
+export declare const backendInspectSpec: CommandSpec<BackendInspectParsed>;
 declare function runBackendRootGroup(_ctx: CommandCtx, p: BackendRootParsed): Promise<number>;
 export declare function makeRunBackendHandler(_getCtx: (cmd: string) => Promise<CommandContext>): typeof runBackendRootGroup;
 export declare function makeRunBackendSyncHandler(getCtx: (cmd: string) => Promise<CommandContext>): (ctx: CommandCtx, p: BackendSyncParsed) => Promise<number>;
+export declare function makeRunBackendInspectHandler(getCtx: (cmd: string) => Promise<CommandContext>): (ctx: CommandCtx, p: BackendInspectParsed) => Promise<number>;
+export declare function makeRunBackendMigrateCanonicalStateHandler(getCtx: (cmd: string) => Promise<CommandContext>): (ctx: CommandCtx, p: BackendMigrateCanonicalStateParsed) => Promise<number>;
 export {};
 //# sourceMappingURL=sync.command.d.ts.map

package/dist/commands/backend/sync.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sync.command.d.ts","sourceRoot":"","sources":["../../../src/commands/backend/sync.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAItE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAwB,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAE7E,KAAK,iBAAiB,GAAG;IAAE,GAAG,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAE3C,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,iBAAiB,CAQtD,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,iBAAiB,CAuC1D,CAAC;AAEF,iBAAS,mBAAmB,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAUpF;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,8BAEtF;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IAC1E,KAAK,UAAU,EAAE,GAAG,iBAAiB,KAAG,OAAO,CAAC,MAAM,CAAC,CAStE"}
+{"version":3,"file":"sync.command.d.ts","sourceRoot":"","sources":["../../../src/commands/backend/sync.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAItE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAIL,KAAK,oBAAoB,EACzB,KAAK,kCAAkC,EACvC,KAAK,iBAAiB,EACvB,MAAM,eAAe,CAAC;AAEvB,KAAK,iBAAiB,GAAG;IAAE,GAAG,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAE3C,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,iBAAiB,CAStD,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,iBAAiB,CAuC1D,CAAC;AAEF,eAAO,MAAM,gCAAgC,EAAE,WAAW,CAAC,kCAAkC,CAoB5F,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,oBAAoB,CAoBhE,CAAC;AAEF,iBAAS,mBAAmB,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAUpF;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,8BAEtF;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IAC1E,KAAK,UAAU,EAAE,GAAG,iBAAiB,KAAG,OAAO,CAAC,MAAM,CAAC,CAStE;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IAC7E,KAAK,UAAU,EAAE,GAAG,oBAAoB,KAAG,OAAO,CAAC,MAAM,CAAC,CASzE;AAED,wBAAgB,0CAA0C,CACxD,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IAElC,KAAK,UAAU,EAAE,GAAG,kCAAkC,KAAG,OAAO,CAAC,MAAM,CAAC,CASvF"}

package/dist/commands/backend/sync.command.js

@@ -1,12 +1,12 @@
 import { COMMAND_SNIPPETS } from "../../cli/command-snippets.js";
 import { usageError } from "../../cli/spec/errors.js";
 import { suggestOne } from "../../cli/spec/suggest.js";
-import { cmdBackendSyncParsed } from "../backend.js";
+import { cmdBackendInspectParsed, cmdBackendMigrateCanonicalStateParsed, cmdBackendSyncParsed, } from "../backend.js";
 export const backendSpec = {
     id: ["backend"],
     group: "Backend",
     summary: "Backend-related operations.",
-    description: "This is a command group. Use a subcommand such as `agentplane backend sync ...`.",
+    description: "This is a command group. Use a subcommand such as `agentplane backend sync ...`, `agentplane backend inspect ...`, or `agentplane backend migrate-canonical-state ...`.",
     args: [{ name: "cmd", required: false, variadic: true, valueHint: "<cmd>" }],
     examples: [{ cmd: COMMAND_SNIPPETS.backendSync.pullLocal, why: "Sync the backend." }],
     parse: (raw) => ({ cmd: (raw.args.cmd ?? []) }),
@@ -51,9 +51,51 @@ export const backendSyncSpec = {
         quiet: raw.opts.quiet === true,
     }),
 };
+export const backendMigrateCanonicalStateSpec = {
+    id: ["backend", "migrate-canonical-state"],
+    group: "Backend",
+    summary: "Backfill canonical_state for issues in the configured backend.",
+    args: [{ name: "id", required: true, valueHint: "<id>", description: "Configured backend id." }],
+    options: [
+        { kind: "boolean", name: "yes", default: false, description: "Auto-approve network access." },
+        { kind: "boolean", name: "quiet", default: false, description: "Reduce output noise." },
+    ],
+    examples: [
+        {
+            cmd: "agentplane backend migrate-canonical-state redmine --yes",
+            why: "Backfill structured canonical_state into legacy Redmine issues.",
+        },
+    ],
+    parse: (raw) => ({
+        backendId: String(raw.args.id),
+        yes: raw.opts.yes === true,
+        quiet: raw.opts.quiet === true,
+    }),
+};
+export const backendInspectSpec = {
+    id: ["backend", "inspect"],
+    group: "Backend",
+    summary: "Inspect visible backend readiness facts without mutating remote state.",
+    args: [{ name: "id", required: true, valueHint: "<id>", description: "Configured backend id." }],
+    options: [
+        { kind: "boolean", name: "yes", default: false, description: "Auto-approve network access." },
+        { kind: "boolean", name: "quiet", default: false, description: "Reduce output noise." },
+    ],
+    examples: [
+        {
+            cmd: "agentplane backend inspect redmine --yes",
+            why: "Inspect visible Redmine custom fields and canonical_state readiness without remote writes.",
+        },
+    ],
+    parse: (raw) => ({
+        backendId: String(raw.args.id),
+        yes: raw.opts.yes === true,
+        quiet: raw.opts.quiet === true,
+    }),
+};
 function runBackendRootGroup(_ctx, p) {
     const input = p.cmd.join(" ");
-    const suggestion = suggestOne(input, ["sync"]);
+    const suggestion = suggestOne(input, ["sync", "inspect", "migrate-canonical-state"]);
     const suffix = suggestion ? ` Did you mean: ${suggestion}?` : "";
     const msg = p.cmd.length === 0 ? "Missing subcommand." : `Unknown subcommand: ${p.cmd[0]}.`;
     throw usageError({
@@ -76,3 +118,25 @@ export function makeRunBackendSyncHandler(getCtx) {
         });
     };
 }
+export function makeRunBackendInspectHandler(getCtx) {
+    return async (ctx, p) => {
+        const commandCtx = await getCtx("backend inspect");
+        return await cmdBackendInspectParsed({
+            ctx: commandCtx,
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride,
+            flags: p,
+        });
+    };
+}
+export function makeRunBackendMigrateCanonicalStateHandler(getCtx) {
+    return async (ctx, p) => {
+        const commandCtx = await getCtx("backend migrate-canonical-state");
+        return await cmdBackendMigrateCanonicalStateParsed({
+            ctx: commandCtx,
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride,
+            flags: p,
+        });
+    };
+}

package/dist/commands/backend.d.ts

@@ -13,6 +13,16 @@ export type SyncParsed = {
     yes: boolean;
     quiet: boolean;
 };
+export type BackendMigrateCanonicalStateParsed = {
+    backendId: string;
+    yes: boolean;
+    quiet: boolean;
+};
+export type BackendInspectParsed = {
+    backendId: string;
+    yes: boolean;
+    quiet: boolean;
+};
 export declare function cmdBackendSyncParsed(opts: {
     ctx?: CommandContext;
     cwd: string;
@@ -25,4 +35,16 @@ export declare function cmdSyncParsed(opts: {
     rootOverride?: string;
     flags: SyncParsed;
 }): Promise<number>;
+export declare function cmdBackendMigrateCanonicalStateParsed(opts: {
+    ctx?: CommandContext;
+    cwd: string;
+    rootOverride?: string;
+    flags: BackendMigrateCanonicalStateParsed;
+}): Promise<number>;
+export declare function cmdBackendInspectParsed(opts: {
+    ctx?: CommandContext;
+    cwd: string;
+    rootOverride?: string;
+    flags: BackendInspectParsed;
+}): Promise<number>;
 //# sourceMappingURL=backend.d.ts.map

package/dist/commands/backend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../src/commands/backend.ts"],"names":[],"mappings":"AAGA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAGnF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,eAAe,GAAG,MAAM,CAAC;IAC7D,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,eAAe,GAAG,MAAM,CAAC;IAC7D,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,iBAAiB,CAAC;CAC1B,GAAG,OAAO,CAAC,MAAM,CAAC,CAyClB;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,UAAU,CAAC;CACnB,GAAG,OAAO,CAAC,MAAM,CAAC,CAyClB"}
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../src/commands/backend.ts"],"names":[],"mappings":"AAGA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAGnF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,eAAe,GAAG,MAAM,CAAC;IAC7D,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,eAAe,GAAG,MAAM,CAAC;IAC7D,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,kCAAkC,GAAG;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,iBAAiB,CAAC;CAC1B,GAAG,OAAO,CAAC,MAAM,CAAC,CAyClB;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,UAAU,CAAC;CACnB,GAAG,OAAO,CAAC,MAAM,CAAC,CAyClB;AAED,wBAAsB,qCAAqC,CAAC,IAAI,EAAE;IAChE,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,kCAAkC,CAAC;CAC3C,GAAG,OAAO,CAAC,MAAM,CAAC,CA2DlB;AAED,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IAClD,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,oBAAoB,CAAC;CAC7B,GAAG,OAAO,CAAC,MAAM,CAAC,CAkElB"}

package/dist/commands/backend.js

@@ -1,4 +1,4 @@
-import { backendNotSupportedMessage } from "../cli/output.js";
+import { backendNotSupportedMessage, successMessage, warnMessage } from "../cli/output.js";
 import { mapBackendError } from "../cli/error-map.js";
 import { CliError } from "../shared/errors.js";
 import { loadCommandContext } from "./shared/task-backend.js";
@@ -89,3 +89,112 @@ export async function cmdSyncParsed(opts) {
         throw mapBackendError(err, { command: "sync", root: opts.rootOverride ?? null });
     }
 }
+export async function cmdBackendMigrateCanonicalStateParsed(opts) {
+    try {
+        const ctx = opts.ctx ??
+            (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
+        const backend = ctx.taskBackend;
+        const backendId = ctx.backendId;
+        const config = ctx.config;
+        if (opts.flags.backendId && backendId && opts.flags.backendId !== backendId) {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: `Configured backend is "${backendId}", not "${opts.flags.backendId}"`,
+                context: {
+                    command: "backend migrate-canonical-state",
+                    reason_code: "sync_backend_mismatch",
+                },
+            });
+        }
+        if (!backend.migrateCanonicalState) {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: backendNotSupportedMessage("migrateCanonicalState()"),
+            });
+        }
+        if (backendId !== "local") {
+            await ensureNetworkApproved({
+                config,
+                yes: opts.flags.yes,
+                reason: `backend migrate-canonical-state may access the network (backend: ${backendId})`,
+            });
+        }
+        const result = await backend.migrateCanonicalState();
+        if (!opts.flags.quiet) {
+            process.stdout.write(`${successMessage("backend migrate-canonical-state", undefined, `scanned=${result.scanned} migrated=${result.migrated.length} skipped-structured=${result.skippedStructured.length} skipped-no-doc=${result.skippedNoDoc.length} failed=${result.failed.length}`)}\n`);
+        }
+        if (result.failed.length > 0) {
+            for (const failure of result.failed.slice(0, 20)) {
+                process.stderr.write(`${warnMessage(`backend migrate-canonical-state failed for ${failure.taskId}: ${failure.reason}`)}\n`);
+            }
+            return 1;
+        }
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw mapBackendError(err, {
+            command: "backend migrate-canonical-state",
+            root: opts.rootOverride ?? null,
+        });
+    }
+}
+export async function cmdBackendInspectParsed(opts) {
+    try {
+        const ctx = opts.ctx ??
+            (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
+        const backend = ctx.taskBackend;
+        const backendId = ctx.backendId;
+        const config = ctx.config;
+        if (opts.flags.backendId && backendId && opts.flags.backendId !== backendId) {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: `Configured backend is "${backendId}", not "${opts.flags.backendId}"`,
+                context: {
+                    command: "backend inspect",
+                    reason_code: "inspect_backend_mismatch",
+                },
+            });
+        }
+        if (!backend.inspectConfiguration) {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: backendNotSupportedMessage("inspectConfiguration()"),
+            });
+        }
+        if (backendId !== "local") {
+            await ensureNetworkApproved({
+                config,
+                yes: opts.flags.yes,
+                reason: `backend inspect may access the network (backend: ${backendId})`,
+            });
+        }
+        const result = await backend.inspectConfiguration();
+        if (opts.flags.quiet)
+            return 0;
+        const canonicalStateSummary = result.canonicalState.configuredFieldId === null
+            ? result.canonicalState.visibleFieldId === null
+                ? "missing"
+                : `visible-unconfigured:${result.canonicalState.visibleFieldId}`
+            : `configured:${result.canonicalState.configuredFieldId}`;
+        process.stdout.write(`${successMessage("backend inspect", undefined, `visible-fields=${result.visibleCustomFields.length} canonical-state=${canonicalStateSummary} drift=${result.configuredFieldNameDrift.length}`)}\n`);
+        process.stdout.write(`canonical_state configured=${result.canonicalState.configuredFieldId ?? "unset"} visible=${result.canonicalState.visibleFieldId ?? "absent"}\n`);
+        for (const drift of result.configuredFieldNameDrift) {
+            process.stdout.write(`drift key=${drift.key} configured-id=${drift.configuredId} visible-name=${JSON.stringify(drift.visibleName)}\n`);
+        }
+        for (const field of result.visibleCustomFields) {
+            process.stdout.write(`field id=${field.id} name=${JSON.stringify(field.name)} non-empty=${field.nonEmptyCount}\n`);
+        }
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw mapBackendError(err, { command: "backend inspect", root: opts.rootOverride ?? null });
+    }
+}

package/dist/commands/commit.spec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commit.spec.d.ts","sourceRoot":"","sources":["../../src/commands/commit.spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAOvD,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;IACf,kBAAkB,EAAE,OAAO,CAAC;IAC5B,cAAc,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,WAAW,CAAC,YAAY,CA8JhD,CAAC"}
+{"version":3,"file":"commit.spec.d.ts","sourceRoot":"","sources":["../../src/commands/commit.spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAOvD,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;IACf,kBAAkB,EAAE,OAAO,CAAC;IAC5B,cAAc,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,WAAW,CAAC,YAAY,CAwLhD,CAAC"}

package/dist/commands/commit.spec.js

@@ -3,7 +3,7 @@ import { findRepoWideAllowPrefixes, repoWideAllowPrefixMessage, } from "../share
 export const commitSpec = {
     id: ["commit"],
     group: "Guard",
-    summary: "Create a git commit after validating policy and allowlist against staged changes.",
+    summary: "Create a git commit after validating policy and allowlist; if the index is empty, stage matching allowlist paths first.",
     args: [{ name: "task-id", required: true, valueHint: "<task-id>" }],
     options: [
         {
@@ -49,23 +49,38 @@ export const commitSpec = {
             kind: "boolean",
             name: "allow-tasks",
             default: false,
-            description: "Allow task workflow artifacts (tasks/ and .agentplane/tasks/).",
+            description: "Allow the tasks export snapshot plus artifacts under the active task subtree; standalone path scope.",
         },
         {
             kind: "boolean",
             name: "allow-base",
             default: false,
-            description: "Allow base branch edits.",
+            description: "Allow base branch edits; branch override only, not a path allowlist.",
         },
         {
             kind: "boolean",
             name: "allow-policy",
             default: false,
-            description: "Allow policy edits (e.g. AGENTS.md).",
+            description: "Allow policy edits (e.g. AGENTS.md); standalone path scope.",
+        },
+        {
+            kind: "boolean",
+            name: "allow-config",
+            default: false,
+            description: "Allow config edits; standalone path scope.",
+        },
+        {
+            kind: "boolean",
+            name: "allow-hooks",
+            default: false,
+            description: "Allow hooks edits; standalone path scope.",
+        },
+        {
+            kind: "boolean",
+            name: "allow-ci",
+            default: false,
+            description: "Allow CI workflow edits; standalone path scope.",
         },
-        { kind: "boolean", name: "allow-config", default: false, description: "Allow config edits." },
-        { kind: "boolean", name: "allow-hooks", default: false, description: "Allow hooks edits." },
-        { kind: "boolean", name: "allow-ci", default: false, description: "Allow CI workflow edits." },
         {
             kind: "boolean",
             name: "require-clean",
@@ -79,11 +94,20 @@ export const commitSpec = {
             cmd: 'agentplane commit 202602030608-F1Q8AB -m "✨ F1Q8AB task: implement allowlist guard" --allow packages/agentplane',
             why: "Create a commit after validating allowlist and subject policy.",
         },
+        {
+            cmd: 'agentplane commit 202602030608-F1Q8AB -m "✨ F1Q8AB task: update publish workflow" --allow-ci',
+            why: "Commit CI-only changes without a redundant explicit workflow path prefix.",
+        },
         {
             cmd: "agentplane commit 202602030608-F1Q8AB --close",
             why: "Create a close commit for the task README using a deterministic message builder.",
         },
     ],
+    notes: [
+        "Protected path-scoped overrides can stand alone without a duplicate explicit prefix: `--allow-tasks`, `--allow-policy`, `--allow-config`, `--allow-hooks`, and `--allow-ci` each admit their own path family.",
+        "Top-level `agentplane commit` can auto-stage those protected path scopes when the git index starts empty.",
+        "`--allow-base` is different: it only overrides base-branch protection and never selects file paths by itself.",
+    ],
     validateRaw: (raw) => {
         const close = raw.opts.close === true;
         const msg = typeof raw.opts.message === "string" ? raw.opts.message.trim() : "";

package/dist/commands/doctor/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/commands/doctor/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAyB5D,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,gBAAgB,GAAG,MAAM,EAAE,CA+BxF;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAM1E"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/commands/doctor/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAsB5D,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,gBAAgB,GAAG,MAAM,EAAE,CA+BxF;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAM1E"}

package/dist/commands/doctor/runtime.js

@@ -10,10 +10,7 @@ function renderCliVersionFacts(expectation) {
             ...(expectation.recovery ? [`[WARN] Recovery: ${expectation.recovery}`] : []),
         ];
     }
-    return [
-        `[INFO] Repository expected agentplane CLI: ${expectation.expectedVersion}`,
-        ...(expectation.summary ? [`[INFO] ${expectation.summary}`] : []),
-    ];
+    return [];
 }
 export function checkRuntimeSourceFacts(cwd, config) {
     const report = resolveRuntimeSourceInfo({ cwd, entryModuleUrl: import.meta.url });
@@ -25,9 +22,9 @@ export function checkRuntimeSourceFacts(cwd, config) {
     }
     const warning = report.mode === "global-in-framework"
         ? "[WARN] Framework checkout detected but the active runtime is still a global installed binary. " +
-            "Update or reinstall agentplane to pick up repo-local handoff, or run the repo-local binary directly."
+            "Run scripts/reinstall-global-agentplane.sh to refresh the wrapper, or run the repo-local binary directly."
         : report.mode === "global-forced-in-framework"
-            ? "[WARN] Framework checkout is forcing the global installed binary via AGENTPLANE_USE_GLOBAL_IN_FRAMEWORK=1."
+            ? "[WARN] Framework checkout is forcing the global installed binary via AGENTPLANE_USE_GLOBAL_IN_FRAMEWORK=1. Unset it unless that override is intentional."
             : null;
     return [
         ...(warning ? [warning] : []),

package/dist/commands/doctor/workspace.d.ts

@@ -1,5 +1,13 @@
 import { type CommandContext } from "../shared/task-backend.js";
+type TaskDocSnapshot = {
+    id?: unknown;
+    status?: unknown;
+    doc_version?: unknown;
+};
+export declare function buildTaskReadmeMigrationFindings(tasks: TaskDocSnapshot[]): string[];
+export declare function checkTaskReadmeMigrationState(repoRoot: string, ctx?: CommandContext): Promise<string[]>;
 export declare function checkWorkspace(repoRoot: string, opts?: {
     ctx?: CommandContext;
 }): Promise<string[]>;
+export {};
 //# sourceMappingURL=workspace.d.ts.map

package/dist/commands/doctor/workspace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../../src/commands/doctor/workspace.ts"],"names":[],"mappings":"AAQA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AA6NpF,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,cAAc,CAAA;CAAE,GAC9B,OAAO,CAAC,MAAM,EAAE,CAAC,CAyDnB"}
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../../src/commands/doctor/workspace.ts"],"names":[],"mappings":"AAUA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEpF,KAAK,eAAe,GAAG;IACrB,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAuFF,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,MAAM,EAAE,CAyDnF;AAED,wBAAsB,6BAA6B,CACjD,QAAQ,EAAE,MAAM,EAChB,GAAG,CAAC,EAAE,cAAc,GACnB,OAAO,CAAC,MAAM,EAAE,CAAC,CAOnB;AAuMD,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,cAAc,CAAA;CAAE,GAC9B,OAAO,CAAC,MAAM,EAAE,CAAC,CA2DnB"}