agentplane 0.2.26 → 0.3.1

package/dist/cli/run-cli/commands/init/ui.js

@@ -26,12 +26,11 @@ export function renderInitWelcome() {
         "░█▀█░█░█░█▀▀░█░█░░█░░▄▀░░█▀▀░█░░░█▀█░█░█░█▀▀",
         "░▀░▀░▀▀▀░▀▀▀░▀░▀░░▀░░▀░░░▀░░░▀▀▀░▀░▀░▀░▀░▀▀▀",
     ].map((line) => color(line, "36"));
-    const subtitle = color("agent/plane", "36");
     const intro = [
         color("Bootstrap an agent-first workflow in this repository.", "1"),
         "This interactive setup runs once; daily work is executed by agents.",
     ];
-    return `${logo.join("\n")}\n${subtitle}\n\n${box(intro)}\n\n`;
+    return `${logo.join("\n")}\n\n${box(intro)}\n\n`;
 }
 export function renderInitSection(title, description) {
     const header = color(`[${title}]`, "33");

package/dist/cli/run-cli/commands/init/write-agents.d.ts

@@ -1,8 +1,10 @@
 import type { WorkflowMode } from "../../../../agents/agents-template.js";
+import { type PolicyGatewayFlavor } from "../../../../shared/policy-gateway.js";
 export declare function ensureAgentsFiles(opts: {
     gitRoot: string;
     agentplaneDir: string;
     workflow: WorkflowMode;
+    policyGateway: PolicyGatewayFlavor;
     configPathAbs: string;
     backendPathAbs: string;
 }): Promise<{

package/dist/cli/run-cli/commands/init/write-agents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"write-agents.d.ts","sourceRoot":"","sources":["../../../../../src/cli/run-cli/commands/init/write-agents.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAkC1E,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,YAAY,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACxB,GAAG,OAAO,CAAC;IAAE,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAuCtC"}
+{"version":3,"file":"write-agents.d.ts","sourceRoot":"","sources":["../../../../../src/cli/run-cli/commands/init/write-agents.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAQ1E,OAAO,EAGL,KAAK,mBAAmB,EACzB,MAAM,sCAAsC,CAAC;AA6B9C,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,YAAY,CAAC;IACvB,aAAa,EAAE,mBAAmB,CAAC;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACxB,GAAG,OAAO,CAAC;IAAE,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAwDtC"}

package/dist/cli/run-cli/commands/init/write-agents.js

@@ -1,11 +1,14 @@
 import { mkdir, readFile } from "node:fs/promises";
 import path from "node:path";
 import { atomicWriteFile } from "@agentplaneorg/core";
-import { filterAgentsByWorkflow, loadAgentTemplates, loadAgentsTemplate, } from "../../../../agents/agents-template.js";
+import { filterAgentsByWorkflow, loadAgentTemplates, loadAgentsTemplate, loadPolicyTemplates, } from "../../../../agents/agents-template.js";
 import { fileExists } from "../../../fs-utils.js";
+import { policyGatewayFileName, renderPolicyGatewayTemplateText, } from "../../../../shared/policy-gateway.js";
 function toUpgradeBaselineKey(repoRelativePath) {
     if (repoRelativePath === "AGENTS.md")
         return "AGENTS.md";
+    if (repoRelativePath === "CLAUDE.md")
+        return "CLAUDE.md";
     if (repoRelativePath.startsWith(".agentplane/")) {
         return repoRelativePath.slice(".agentplane/".length);
     }
@@ -26,7 +29,9 @@ async function seedUpgradeBaselineForInstalledFiles(opts) {
     }
 }
 export async function ensureAgentsFiles(opts) {
-    const agentsPath = path.join(opts.gitRoot, "AGENTS.md");
+    const gatewayFileName = policyGatewayFileName(opts.policyGateway);
+    const renderGatewayText = (text) => renderPolicyGatewayTemplateText(text, gatewayFileName);
+    const agentsPath = path.join(opts.gitRoot, gatewayFileName);
     const installPaths = [
         path.relative(opts.gitRoot, opts.configPathAbs),
         path.relative(opts.gitRoot, opts.backendPathAbs),
@@ -38,20 +43,34 @@ export async function ensureAgentsFiles(opts) {
     }
     else {
         const template = await loadAgentsTemplate();
-        const filtered = filterAgentsByWorkflow(template, opts.workflow);
+        const filtered = filterAgentsByWorkflow(renderGatewayText(template), opts.workflow);
         await atomicWriteFile(agentsPath, filtered, "utf8");
         wroteAgents = true;
     }
     if (wroteAgents) {
         installPaths.push(path.relative(opts.gitRoot, agentsPath));
-        installedManagedPaths.push("AGENTS.md");
+        installedManagedPaths.push(gatewayFileName);
     }
     const agentTemplates = await loadAgentTemplates();
     for (const agent of agentTemplates) {
         const targetPath = path.join(opts.agentplaneDir, "agents", agent.fileName);
         if (await fileExists(targetPath))
             continue;
-        await atomicWriteFile(targetPath, agent.contents, "utf8");
+        await atomicWriteFile(targetPath, renderGatewayText(agent.contents), "utf8");
+        const relPath = path.relative(opts.gitRoot, targetPath);
+        installPaths.push(relPath);
+        installedManagedPaths.push(relPath);
+    }
+    const policyTemplates = await loadPolicyTemplates();
+    for (const policy of policyTemplates) {
+        const targetPath = path.join(opts.agentplaneDir, "policy", policy.relativePath);
+        if (await fileExists(targetPath))
+            continue;
+        const rendered = policy.relativePath.endsWith(".md")
+            ? renderGatewayText(policy.contents)
+            : policy.contents;
+        await mkdir(path.dirname(targetPath), { recursive: true });
+        await atomicWriteFile(targetPath, rendered, "utf8");
         const relPath = path.relative(opts.gitRoot, targetPath);
         installPaths.push(relPath);
         installedManagedPaths.push(relPath);

package/dist/cli/run-cli/commands/init/write-workflow.d.ts

@@ -1,6 +1,11 @@
 export declare function ensureInitWorkflow(opts: {
     gitRoot: string;
     workflowMode: "direct" | "branch_pr";
+    approvals: {
+        requirePlanApproval: boolean;
+        requireVerifyApproval: boolean;
+        requireNetworkApproval: boolean;
+    };
 }): Promise<{
     installPaths: string[];
 }>;

package/dist/cli/run-cli/commands/init/write-workflow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"write-workflow.d.ts","sourceRoot":"","sources":["../../../../../src/cli/run-cli/commands/init/write-workflow.ts"],"names":[],"mappings":"AASA,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,QAAQ,GAAG,WAAW,CAAC;CACtC,GAAG,OAAO,CAAC;IAAE,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAoDtC"}
+{"version":3,"file":"write-workflow.d.ts","sourceRoot":"","sources":["../../../../../src/cli/run-cli/commands/init/write-workflow.ts"],"names":[],"mappings":"AASA,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,QAAQ,GAAG,WAAW,CAAC;IACrC,SAAS,EAAE;QACT,mBAAmB,EAAE,OAAO,CAAC;QAC7B,qBAAqB,EAAE,OAAO,CAAC;QAC/B,sBAAsB,EAAE,OAAO,CAAC;KACjC,CAAC;CACH,GAAG,OAAO,CAAC;IAAE,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA2DtC"}

package/dist/cli/run-cli/commands/init/write-workflow.js

@@ -7,8 +7,14 @@ export async function ensureInitWorkflow(opts) {
             workflow: {
                 mode: opts.workflowMode,
                 version: 1,
+                approvals: {
+                    require_plan: opts.approvals.requirePlanApproval,
+                    require_verify: opts.approvals.requireVerifyApproval,
+                    require_network: opts.approvals.requireNetworkApproval,
+                },
             },
             runtime: {
+                repo_name: opts.gitRoot.split(/[/\\\\]/).findLast((segment) => segment.length > 0) ?? "repo",
                 repo_root: opts.gitRoot,
                 timestamp: new Date().toISOString(),
             },

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

@@ -1,7 +1,9 @@
 import type { CommandHandler, CommandSpec } from "../../spec/spec.js";
 import { type ExecutionProfile } from "@agentplaneorg/core";
+import type { PolicyGatewayFlavor } from "../../../shared/policy-gateway.js";
 type InitFlags = {
     setupProfile?: SetupProfilePreset;
+    policyGateway?: PolicyGatewayFlavor;
     ide?: "codex" | "cursor" | "windsurf";
     workflow?: "direct" | "branch_pr";
     backend?: "local" | "redmine";

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

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../src/cli/run-cli/commands/init.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAItE,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,qBAAqB,CAAC;AAe7B,KAAK,SAAS,GAAG;IACf,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,GAAG,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC;IACtC,QAAQ,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC;IAClC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,OAAO,CAAC;CACd,CAAC;AAEF,KAAK,kBAAkB,GAAG,OAAO,GAAG,QAAQ,GAAG,cAAc,CAAC;AAoF9D,KAAK,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG;IAAE,GAAG,EAAE,OAAO,CAAA;CAAE,CAAC;AAE5D,eAAO,MAAM,QAAQ,EAAE,WAAW,CAAC,UAAU,CAsM5C,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,cAAc,CAAC,UAAU,CACmB,CAAC"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../src/cli/run-cli/commands/init.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAItE,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,qBAAqB,CAAC;AAc7B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAG7E,KAAK,SAAS,GAAG;IACf,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,GAAG,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC;IACtC,QAAQ,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC;IAClC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,OAAO,CAAC;CACd,CAAC;AAEF,KAAK,kBAAkB,GAAG,OAAO,GAAG,QAAQ,GAAG,cAAc,CAAC;AAoF9D,KAAK,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG;IAAE,GAAG,EAAE,OAAO,CAAA;CAAE,CAAC;AAE5D,eAAO,MAAM,QAAQ,EAAE,WAAW,CAAC,UAAU,CAyM5C,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,cAAc,CAAC,UAAU,CACmB,CAAC"}

package/dist/cli/run-cli/commands/init.js

@@ -20,11 +20,12 @@ import { ensureInitGitignore } from "./init/write-gitignore.js";
 import { ensureInitRedmineEnvTemplate } from "./init/write-env.js";
 import { renderInitSection, renderInitWelcome } from "./init/ui.js";
 import { fileExists } from "../../fs-utils.js";
+import { policyGatewayFileName } from "../../../shared/policy-gateway.js";
 const setupProfilePresets = {
     light: {
         mode: "compact",
-        description: "Light profile (maximum flexibility, minimal enforcement, hooks still mandatory).",
-        defaultHooks: true,
+        description: "Light profile (maximum flexibility, minimal enforcement, hooks disabled).",
+        defaultHooks: false,
         defaultStrictUnsafeConfirm: false,
         defaultRequirePlanApproval: false,
         defaultRequireNetworkApproval: false,
@@ -34,7 +35,7 @@ const setupProfilePresets = {
     },
     normal: {
         mode: "compact",
-        description: "Normal profile (balanced defaults and approvals enabled for standard team workflows).",
+        description: "Normal profile (balanced defaults and approvals enabled for standard team workflows; hooks enabled).",
         defaultHooks: true,
         defaultStrictUnsafeConfirm: false,
         defaultRequirePlanApproval: true,
@@ -45,7 +46,7 @@ const setupProfilePresets = {
     },
     "full-harness": {
         mode: "full",
-        description: "Full Harness profile (strict guardrails, explicit confirmations, conservative execution).",
+        description: "Full Harness profile (strict guardrails, explicit confirmations, conservative execution; hooks enabled).",
         defaultHooks: true,
         defaultStrictUnsafeConfirm: true,
         defaultRequirePlanApproval: true,
@@ -113,6 +114,14 @@ export const initSpec = {
             ],
             description: "Setup profile preset. Preferred values: light, normal, full-harness.",
         },
+        {
+            kind: "string",
+            name: "policy-gateway",
+            valueHint: "<codex|claude>",
+            choices: ["codex", "claude"],
+            coerce: (raw) => raw.trim().toLowerCase(),
+            description: "Policy gateway file to install (codex -> AGENTS.md, claude -> CLAUDE.md).",
+        },
         {
             kind: "string",
             name: "ide",
@@ -140,7 +149,7 @@ export const initSpec = {
             kind: "string",
             name: "hooks",
             valueHint: "<true|false>",
-            description: "Hooks are mandatory; only true is accepted.",
+            description: "Install managed git hooks (default by setup profile: light=false, normal/full-harness=true).",
         },
         {
             kind: "string",
@@ -201,7 +210,7 @@ export const initSpec = {
             kind: "boolean",
             name: "gitignore-agents",
             default: false,
-            description: "Add agent files (AGENTS.md and .agentplane/agents/) to .gitignore and skip the initial install commit.",
+            description: "Add gateway/agent files (AGENTS.md or CLAUDE.md and .agentplane/agents/) to .gitignore and skip the initial install commit.",
         },
     ],
     examples: [
@@ -240,6 +249,7 @@ export const initSpec = {
         const recipesRaw = raw.opts.recipes;
         return {
             setupProfile: normalizeSetupProfile(raw.opts["setup-profile"]),
+            policyGateway: raw.opts["policy-gateway"],
             ide: raw.opts.ide,
             workflow: raw.opts.workflow,
             backend: raw.opts.backend,
@@ -272,22 +282,17 @@ export const initSpec = {
                 message: "Use either --force or --backup (not both).",
             });
         }
-        if (p.hooks === false) {
-            throw usageError({
-                spec: initSpec,
-                command: "init",
-                message: "Hooks installation is mandatory. Use --hooks true (or omit the flag).",
-            });
-        }
     },
 };
 export const runInit = (ctx, flags) => cmdInit({ cwd: ctx.cwd, rootOverride: ctx.rootOverride, flags });
 async function cmdInit(opts) {
     const flags = opts.flags;
     const defaults = {
+        policyGateway: "codex",
         ide: "codex",
         workflow: "direct",
         backend: "local",
+        hooks: true,
         recipes: [],
         requirePlanApproval: true,
         requireNetworkApproval: true,
@@ -296,8 +301,10 @@ async function cmdInit(opts) {
         strictUnsafeConfirm: false,
     };
     let ide = flags.ide ?? defaults.ide;
+    let policyGateway = flags.policyGateway ?? defaults.policyGateway;
     let workflow = flags.workflow ?? defaults.workflow;
     let backend = flags.backend ?? defaults.backend;
+    let hooks = flags.hooks ?? defaults.hooks;
     let recipes = flags.recipes ?? defaults.recipes;
     let requirePlanApproval = flags.requirePlanApproval ?? defaults.requirePlanApproval;
     let requireNetworkApproval = flags.requireNetworkApproval ?? defaults.requireNetworkApproval;
@@ -350,6 +357,14 @@ async function cmdInit(opts) {
         }
         const selectedPreset = setupProfilePresets[setupProfilePreset];
         setupProfile = selectedPreset.mode;
+        hooks = flags.hooks ?? selectedPreset.defaultHooks;
+        if (flags.policyGateway) {
+            policyGateway = flags.policyGateway;
+        }
+        else {
+            process.stdout.write(renderInitSection("Policy Gateway", "Choose which root policy gateway file to install for your primary agent runtime."));
+            policyGateway = (await askChoice("Policy gateway", ["codex", "claude"], policyGateway));
+        }
         if (flags.strictUnsafeConfirm === undefined) {
             strictUnsafeConfirm = selectedPreset.defaultStrictUnsafeConfirm;
         }
@@ -381,7 +396,9 @@ async function cmdInit(opts) {
             backend = choice === "redmine" ? "redmine" : "local";
         }
         if (setupProfile === "full") {
-            process.stdout.write(renderInitSection("Hooks", "Managed git hooks are mandatory and will be installed automatically."));
+            process.stdout.write(renderInitSection("Hooks", hooks
+                ? "Managed git hooks are enabled and will be installed automatically."
+                : "Managed git hooks are disabled by profile/flag and will not be installed."));
             process.stdout.write(renderInitSection("Execution Profile", "Set default autonomy/effort for agents. You can change this later in config."));
             if (!flags.executionProfile) {
                 executionProfile = (await askChoice("Execution profile", ["conservative", "balanced", "aggressive"], executionProfile));
@@ -430,14 +447,16 @@ async function cmdInit(opts) {
                 flags.requireVerifyApproval ?? selectedPreset.defaultRequireVerifyApproval;
             executionProfile = flags.executionProfile ?? selectedPreset.defaultExecutionProfile;
             strictUnsafeConfirm = flags.strictUnsafeConfirm ?? selectedPreset.defaultStrictUnsafeConfirm;
-            process.stdout.write(renderInitSection("Defaults Applied", `Using compact ${setupProfilePreset} defaults for approvals, execution profile, and recipes. Hooks remain mandatory.`));
+            process.stdout.write(renderInitSection("Defaults Applied", `Using compact ${setupProfilePreset} defaults for approvals, execution profile, and recipes. Hooks: ${hooks ? "enabled" : "disabled"}.`));
         }
     }
     if (flags.yes) {
         const yesPreset = setupProfilePresets[setupProfilePreset];
         ide = flags.ide ?? defaults.ide;
+        policyGateway = flags.policyGateway ?? defaults.policyGateway;
         workflow = flags.workflow ?? defaults.workflow;
         backend = flags.backend ?? defaults.backend;
+        hooks = flags.hooks ?? yesPreset.defaultHooks;
         recipes = flags.recipes ?? yesPreset.defaultRecipes;
         requirePlanApproval = flags.requirePlanApproval ?? yesPreset.defaultRequirePlanApproval;
         requireNetworkApproval =
@@ -473,8 +492,8 @@ async function cmdInit(opts) {
         ];
         const initFiles = [configPath, backendPath];
         const conflicts = await collectInitConflicts({ initDirs, initFiles });
-        const agentsPath = path.join(resolved.gitRoot, "AGENTS.md");
-        const agentsMissing = !(await fileExists(agentsPath));
+        const gatewayPath = path.join(resolved.gitRoot, policyGatewayFileName(policyGateway));
+        const agentsMissing = !(await fileExists(gatewayPath));
         if (conflicts.length > 0 && agentsMissing) {
             // Recovery path: if a repo already contains conflicting .agentplane config/backend files,
             // still materialize missing policy/agent templates before reporting conflicts.
@@ -483,6 +502,7 @@ async function cmdInit(opts) {
                 gitRoot: resolved.gitRoot,
                 agentplaneDir: resolved.agentplaneDir,
                 workflow,
+                policyGateway,
                 configPathAbs: configPath,
                 backendPathAbs: backendPath,
             });
@@ -513,6 +533,7 @@ async function cmdInit(opts) {
             gitRoot: resolved.gitRoot,
             agentplaneDir: resolved.agentplaneDir,
             workflow,
+            policyGateway,
             configPathAbs: configPath,
             backendPathAbs: backendPath,
         });
@@ -527,6 +548,11 @@ async function cmdInit(opts) {
         const workflowInit = await ensureInitWorkflow({
             gitRoot: resolved.gitRoot,
             workflowMode: workflow,
+            approvals: {
+                requirePlanApproval,
+                requireVerifyApproval,
+                requireNetworkApproval,
+            },
         });
         for (const abs of workflowInit.installPaths) {
             installPaths.push(path.relative(resolved.gitRoot, abs));
@@ -538,8 +564,10 @@ async function cmdInit(opts) {
                 value: initBaseBranch,
             });
         }
-        await cmdHooksInstall({ cwd: opts.cwd, rootOverride: opts.rootOverride, quiet: true });
-        installPaths.push(".agentplane/bin/agentplane");
+        if (hooks) {
+            await cmdHooksInstall({ cwd: opts.cwd, rootOverride: opts.rootOverride, quiet: true });
+            installPaths.push(".agentplane/bin/agentplane");
+        }
         const ideRes = await maybeSyncIde({
             cwd: opts.cwd,
             rootOverride: opts.rootOverride,

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

@@ -1 +1 @@
-{"version":3,"file":"run-cli.d.ts","sourceRoot":"","sources":["../../src/cli/run-cli.ts"],"names":[],"mappings":"AAoeA,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA4M5D"}
+{"version":3,"file":"run-cli.d.ts","sourceRoot":"","sources":["../../src/cli/run-cli.ts"],"names":[],"mappings":"AA0lBA,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA6N5D"}

package/dist/cli/run-cli.js

@@ -22,6 +22,7 @@ const GLOBAL_FLAGS = [
     { key: "noUpdateCheck", forms: ["--no-update-check"], takesValue: false, scoped: false },
     { key: "allowNetwork", forms: ["--allow-network"], takesValue: false, scoped: true },
     { key: "jsonErrors", forms: ["--json-errors"], takesValue: false, scoped: true },
+    { key: "outputMode", forms: ["--output"], takesValue: true, scoped: false },
     { key: "root", forms: ["--root"], takesValue: true, scoped: false },
 ];
 const GLOBAL_FLAG_FORMS = new Map(GLOBAL_FLAGS.flatMap((def) => def.forms.map((form) => [form, def])));
@@ -56,6 +57,7 @@ function parseGlobalArgs(argv) {
     let jsonErrors = false;
     let root;
     let allowNetwork = false;
+    let outputMode;
     const rest = [];
     for (let i = 0; i < argv.length; i++) {
         const arg = argv[i];
@@ -105,6 +107,27 @@ function parseGlobalArgs(argv) {
                 i++;
                 break;
             }
+            case "outputMode": {
+                const next = argv[i + 1];
+                if (!next) {
+                    throw new CliError({
+                        exitCode: 2,
+                        code: "E_USAGE",
+                        message: "Missing value after --output (expected text|json)",
+                    });
+                }
+                const normalized = next.trim().toLowerCase();
+                if (normalized !== "text" && normalized !== "json") {
+                    throw new CliError({
+                        exitCode: 2,
+                        code: "E_USAGE",
+                        message: `Invalid value for --output: ${next} (expected text|json)`,
+                    });
+                }
+                outputMode = normalized;
+                i++;
+                break;
+            }
             default: {
                 // Exhaustive by construction; keep a defensive fallback.
                 rest.push(arg);
@@ -112,7 +135,85 @@ function parseGlobalArgs(argv) {
             }
         }
     }
-    return { globals: { help, version, noUpdateCheck, root, jsonErrors, allowNetwork }, rest };
+    return {
+        globals: { help, version, noUpdateCheck, root, jsonErrors, allowNetwork, outputMode },
+        rest,
+    };
+}
+const OUTPUT_MODE_ENV = "AGENTPLANE_OUTPUT";
+function resolveOutputMode(modeFromFlag) {
+    if (modeFromFlag)
+        return modeFromFlag;
+    const fromEnv = process.env[OUTPUT_MODE_ENV]?.trim().toLowerCase();
+    if (!fromEnv || fromEnv === "text")
+        return "text";
+    if (fromEnv === "json")
+        return "json";
+    throw new CliError({
+        exitCode: 2,
+        code: "E_USAGE",
+        message: `Invalid ${OUTPUT_MODE_ENV}: ${fromEnv} (expected text|json)`,
+    });
+}
+function chunkToString(chunk, encoding) {
+    if (typeof chunk === "string")
+        return chunk;
+    if (chunk instanceof Uint8Array)
+        return Buffer.from(chunk).toString(encoding);
+    return String(chunk);
+}
+async function runWithOutputMode(opts) {
+    if (opts.mode === "text")
+        return await opts.run();
+    const stdoutWrite = process.stdout.write.bind(process.stdout);
+    const stderrWrite = process.stderr.write.bind(process.stderr);
+    let stdout = "";
+    let stderr = "";
+    process.stdout.write = ((chunk, ...rest) => {
+        const encoding = typeof rest[0] === "string" ? rest[0] : undefined;
+        stdout += chunkToString(chunk, encoding);
+        const callback = rest.find((item) => typeof item === "function");
+        callback?.(null);
+        return true;
+    });
+    process.stderr.write = ((chunk, ...rest) => {
+        const encoding = typeof rest[0] === "string" ? rest[0] : undefined;
+        stderr += chunkToString(chunk, encoding);
+        const callback = rest.find((item) => typeof item === "function");
+        callback?.(null);
+        return true;
+    });
+    try {
+        const exitCode = await opts.run();
+        let parsed;
+        const trimmedStdout = stdout.trim();
+        if (trimmedStdout.length > 0) {
+            try {
+                parsed = JSON.parse(trimmedStdout);
+            }
+            catch {
+                parsed = undefined;
+            }
+        }
+        const payload = {
+            schema_version: 1,
+            mode: "agent_json_v1",
+            command: opts.command,
+            ok: exitCode === 0,
+            exit_code: exitCode,
+            stdout: trimmedStdout,
+            stderr: stderr.trim(),
+        };
+        if (parsed !== undefined) {
+            payload.data = parsed;
+        }
+        stdoutWrite(`${JSON.stringify(payload, null, 2)}\n`);
+        return exitCode;
+    }
+    finally {
+        process.stdout.write = stdoutWrite;
+        process.stderr.write = stderrWrite;
+    }
 }
 function matchCommandCatalog(tokens) {
     let best = null;
@@ -406,10 +507,17 @@ export async function runCli(argv) {
     let jsonErrors = prescanJsonErrors(argv);
     try {
         const { globals, rest } = parseGlobalArgs(argv);
-        jsonErrors = globals.jsonErrors;
+        const outputMode = resolveOutputMode(globals.outputMode);
+        jsonErrors = globals.jsonErrors || outputMode === "json";
         if (globals.version) {
-            process.stdout.write(`${getVersion()}\n`);
-            return 0;
+            return await runWithOutputMode({
+                mode: outputMode,
+                command: "version",
+                run: () => {
+                    process.stdout.write(`${getVersion()}\n`);
+                    return Promise.resolve(0);
+                },
+            });
         }
         const runCli2HelpFast = async (helpArgv) => {
             const { buildRegistry } = await import("./run-cli/registry.run.js");
@@ -429,7 +537,13 @@ export async function runCli(argv) {
             }
             const tail = helpArgv.slice(match.consumed);
             const parsed = parseCommandArgv(match.spec, tail).parsed;
-            return await match.handler({ cwd: process.cwd(), rootOverride: globals.root }, parsed);
+            return await runWithOutputMode({
+                mode: outputMode,
+                command: match.spec.id.join(" "),
+                run: async () => {
+                    return await match.handler({ cwd: process.cwd(), rootOverride: globals.root }, parsed);
+                },
+            });
         };
         // `--help` is treated as an alias for `help` and supports per-command help:
         // - agentplane --help
@@ -520,7 +634,7 @@ export async function runCli(argv) {
         await maybeWarnOnUpdate({
             currentVersion: getVersion(),
             skip: globals.noUpdateCheck || skipUpdateCheckForPolicy || matched?.entry.needsConfig === false,
-            jsonErrors: globals.jsonErrors,
+            jsonErrors,
         });
         let ctxPromise = null;
         const getCtx = async (commandForErrorContext) => {
@@ -562,7 +676,11 @@ export async function runCli(argv) {
         if (match) {
             const tail = rest.slice(match.consumed);
             const parsed = parseCommandArgv(match.spec, tail).parsed;
-            return await match.handler({ cwd, rootOverride: globals.root }, parsed);
+            return await runWithOutputMode({
+                mode: outputMode,
+                command: match.spec.id.join(" "),
+                run: async () => await match.handler({ cwd, rootOverride: globals.root }, parsed),
+            });
         }
         const input = rest.join(" ");
         const fullCandidates = registry.list().map((e) => e.spec.id.join(" "));

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

@@ -1 +1 @@
-{"version":3,"file":"doctor.run.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.run.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAK1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAqUrD,eAAO,MAAM,SAAS,EAAE,cAAc,CAAC,YAAY,CAmDlD,CAAC"}
+{"version":3,"file":"doctor.run.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.run.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAM1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAyUrD,eAAO,MAAM,SAAS,EAAE,cAAc,CAAC,YAAY,CAmDlD,CAAC"}

package/dist/commands/doctor.run.js

@@ -3,6 +3,7 @@ import path from "node:path";
 import { resolveProject } from "@agentplaneorg/core";
 import { warnMessage, successMessage } from "../cli/output.js";
 import { RUNTIME_GITIGNORE_LINES } from "../shared/runtime-artifacts.js";
+import { resolvePolicyGatewayForRepo } from "../shared/policy-gateway.js";
 import { execFileAsync, gitEnv } from "./shared/git.js";
 import { loadCommandContext } from "./shared/task-backend.js";
 import { emitWorkflowEvent, isWorkflowEnforcementDisabled, resolveWorkflowPaths, safeAutofixWorkflowText, validateWorkflowAtPath, workflowEnforcementEnvHint, } from "../workflow-runtime/index.js";
@@ -58,15 +59,19 @@ async function isDirectory(absPath) {
 }
 async function checkWorkspace(repoRoot) {
     const problems = [];
-    const requiredFiles = [
-        path.join(repoRoot, "AGENTS.md"),
-        path.join(repoRoot, ".agentplane", "config.json"),
-    ];
+    const requiredFiles = [path.join(repoRoot, ".agentplane", "config.json")];
     for (const filePath of requiredFiles) {
         if (!(await pathExists(filePath))) {
             problems.push(`Missing required file: ${path.relative(repoRoot, filePath)}`);
         }
     }
+    const gateway = await resolvePolicyGatewayForRepo({
+        gitRoot: repoRoot,
+        fallbackFlavor: "codex",
+    });
+    if (!(await pathExists(gateway.absPath))) {
+        problems.push("Missing required policy gateway file: AGENTS.md or CLAUDE.md");
+    }
     const agentsDir = path.join(repoRoot, ".agentplane", "agents");
     if (!(await isDirectory(agentsDir))) {
         problems.push("Missing required directory: .agentplane/agents");
@@ -286,11 +291,11 @@ async function checkDoneTaskCommitInvariants(repoRoot) {
             continue;
         const subject = subjectByHash.get(hash) ?? "";
         if (!subject) {
-            problems.push(`DONE task references unknown commit hash: ${id} -> ${hash}`);
+            problems.push(`[WARN] DONE task references unknown commit hash: ${id} -> ${hash}`);
             continue;
         }
         if (/\bclose:/iu.test(subject)) {
-            problems.push(`DONE task implementation commit points to a close commit: ${id} -> ${hash} (${subject})`);
+            problems.push(`[WARN] DONE task implementation commit points to a close commit: ${id} -> ${hash} (${subject})`);
         }
     }
     return problems;

package/dist/commands/release/apply.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apply.command.d.ts","sourceRoot":"","sources":["../../../src/commands/release/apply.command.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAU1E,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,CAAC;AAsVnD,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,kBAAkB,CAiF5D,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,cAAc,CAAC,kBAAkB,CA+K9D,CAAC"}
+{"version":3,"file":"apply.command.d.ts","sourceRoot":"","sources":["../../../src/commands/release/apply.command.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAU1E,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,CAAC;AA4VnD,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,kBAAkB,CAiF5D,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,cAAc,CAAC,kBAAkB,CAoL9D,CAAC"}

package/dist/commands/release/apply.command.js

@@ -136,7 +136,7 @@ function cleanHookEnv() {
     delete env.AGENTPLANE_AGENT_ID;
     return env;
 }
-async function validateReleaseNotes(notesPath) {
+async function validateReleaseNotes(notesPath, minBullets) {
     const content = await readFile(notesPath, "utf8");
     if (!/release\s+notes/i.test(content)) {
         throw new CliError({
@@ -146,11 +146,11 @@ async function validateReleaseNotes(notesPath) {
         });
     }
     const bulletCount = content.split(/\r?\n/u).filter((line) => /^\s*[-*]\s+\S+/u.test(line)).length;
-    if (bulletCount < 1) {
+    if (bulletCount < minBullets) {
         throw new CliError({
             exitCode: exitCodeForError("E_VALIDATION"),
             code: "E_VALIDATION",
-            message: `Release notes must include at least one bullet point in ${notesPath}.`,
+            message: `Release notes must include at least ${minBullets} bullet points in ${notesPath}.`,
         });
     }
     if (/[\u0400-\u04FF]/u.test(content)) {
@@ -383,6 +383,11 @@ export const runReleaseApply = async (ctx, flags) => {
         });
     }
     const plan = parseVersionPlan(await readJsonFile(versionJsonPath));
+    const changesJsonPath = path.join(planDir, "changes.json");
+    const changes = (await fileExists(changesJsonPath))
+        ? await readJsonFile(changesJsonPath)
+        : [];
+    const minBullets = Math.max(1, Array.isArray(changes) ? changes.length : 0);
     if ((plan.bump === "minor" || plan.bump === "major") && flags.yes !== true) {
         throw usageError({
             spec: releaseApplySpec,
@@ -406,7 +411,7 @@ export const runReleaseApply = async (ctx, flags) => {
                 "Write this file using a DOCS agent before applying the release.",
         });
     }
-    await validateReleaseNotes(notesPath);
+    await validateReleaseNotes(notesPath, minBullets);
     const corePkgPath = path.join(gitRoot, "packages", "core", "package.json");
     const agentplanePkgPath = path.join(gitRoot, "packages", "agentplane", "package.json");
     const [coreVersion, agentplaneVersion, coreDependencyVersion] = await Promise.all([

package/dist/commands/release/plan.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plan.command.d.ts","sourceRoot":"","sources":["../../../src/commands/release/plan.command.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAM1E,KAAK,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAE5C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,gBAAgB,CAAC;AAqIjD,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,iBAAiB,CA4E1D,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,cAAc,CAAC,iBAAiB,CAoE5D,CAAC"}
+{"version":3,"file":"plan.command.d.ts","sourceRoot":"","sources":["../../../src/commands/release/plan.command.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAM1E,KAAK,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAE5C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,gBAAgB,CAAC;AA4IjD,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,iBAAiB,CA4E1D,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,cAAc,CAAC,iBAAiB,CAqE5D,CAAC"}