agentplane 0.2.25 → 0.3.1

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

@@ -13,51 +13,47 @@ import { collectInitConflicts, handleInitConflicts } from "./init/conflicts.js";
 import { ensureGitRoot } from "./init/git.js";
 import { maybeSyncIde } from "./init/ide-sync.js";
 import { maybeInstallBundledRecipes } from "./init/recipes.js";
+import { ensureInitWorkflow } from "./init/write-workflow.js";
 import { ensureAgentplaneDirs, writeBackendStubs, writeInitConfig } from "./init/write-config.js";
 import { ensureAgentsFiles } from "./init/write-agents.js";
 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 = {
-    developer: {
-        mode: "full",
-        description: "I am Developer (full setup questionnaire; hooks on; explicit unsafe confirmations on).",
-        defaultHooks: true,
-        defaultStrictUnsafeConfirm: true,
-        defaultRequirePlanApproval: true,
-        defaultRequireNetworkApproval: true,
-        defaultRequireVerifyApproval: true,
-        defaultExecutionProfile: "balanced",
-    },
-    vibecoder: {
+    light: {
         mode: "compact",
-        description: "I am Vibecoder (compact setup; hooks off; approvals off; aggressive execution defaults).",
+        description: "Light profile (maximum flexibility, minimal enforcement, hooks disabled).",
         defaultHooks: false,
         defaultStrictUnsafeConfirm: false,
         defaultRequirePlanApproval: false,
         defaultRequireNetworkApproval: false,
         defaultRequireVerifyApproval: false,
         defaultExecutionProfile: "aggressive",
+        defaultRecipes: [],
     },
-    manager: {
+    normal: {
         mode: "compact",
-        description: "I am Manager / Product owner (compact setup; oversight defaults with approvals on, hooks off).",
-        defaultHooks: false,
+        description: "Normal profile (balanced defaults and approvals enabled for standard team workflows; hooks enabled).",
+        defaultHooks: true,
         defaultStrictUnsafeConfirm: false,
         defaultRequirePlanApproval: true,
         defaultRequireNetworkApproval: true,
         defaultRequireVerifyApproval: true,
         defaultExecutionProfile: "balanced",
+        defaultRecipes: [],
     },
-    enterprise: {
+    "full-harness": {
         mode: "full",
-        description: "I am Enterprise / Regulated team (full setup; strict approvals, hooks on, conservative execution).",
+        description: "Full Harness profile (strict guardrails, explicit confirmations, conservative execution; hooks enabled).",
         defaultHooks: true,
         defaultStrictUnsafeConfirm: true,
         defaultRequirePlanApproval: true,
         defaultRequireNetworkApproval: true,
         defaultRequireVerifyApproval: true,
         defaultExecutionProfile: "conservative",
+        defaultRecipes: [],
     },
 };
 function parseBooleanValueForInit(flag, value) {
@@ -81,6 +77,22 @@ function parseRecipesSelectionForInit(value) {
         .map((item) => item.trim())
         .filter(Boolean);
 }
+function normalizeSetupProfile(raw) {
+    if (!raw)
+        return undefined;
+    const value = raw.trim().toLowerCase();
+    if (value === "developer")
+        return "full-harness";
+    if (value === "enterprise")
+        return "full-harness";
+    if (value === "manager")
+        return "normal";
+    if (value === "vibecoder")
+        return "light";
+    if (value === "light" || value === "normal" || value === "full-harness")
+        return value;
+    return undefined;
+}
 export const initSpec = {
     id: ["init"],
     group: "Setup",
@@ -90,9 +102,25 @@ export const initSpec = {
         {
             kind: "string",
             name: "setup-profile",
-            valueHint: "<developer|vibecoder|manager|enterprise>",
-            choices: ["developer", "vibecoder", "manager", "enterprise"],
-            description: "Persona preset for init defaults and dialog depth (compact vs full questionnaire).",
+            valueHint: "<light|normal|full-harness>",
+            choices: [
+                "light",
+                "normal",
+                "full-harness",
+                "developer",
+                "vibecoder",
+                "manager",
+                "enterprise",
+            ],
+            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",
@@ -121,7 +149,7 @@ export const initSpec = {
             kind: "string",
             name: "hooks",
             valueHint: "<true|false>",
-            description: "Install git hooks (non-interactive requires an explicit value).",
+            description: "Install managed git hooks (default by setup profile: light=false, normal/full-harness=true).",
         },
         {
             kind: "string",
@@ -182,17 +210,17 @@ 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: [
         { cmd: "agentplane init", why: "Interactive setup (prompts for missing values)." },
         {
-            cmd: "agentplane init --setup-profile vibecoder --yes",
-            why: "Non-interactive fast setup for autonomous defaults (hooks off, approvals off).",
+            cmd: "agentplane init --setup-profile light --yes",
+            why: "Non-interactive setup with flexible defaults.",
         },
         {
-            cmd: "agentplane init --workflow direct --backend local --hooks false --require-plan-approval true --require-network-approval true --require-verify-approval true --yes",
+            cmd: "agentplane init --workflow direct --backend local --hooks true --require-plan-approval true --require-network-approval true --require-verify-approval true --yes",
             why: "Non-interactive setup with explicit policy flags.",
         },
         {
@@ -220,7 +248,8 @@ export const initSpec = {
         const requireVerifyRaw = raw.opts["require-verify-approval"];
         const recipesRaw = raw.opts.recipes;
         return {
-            setupProfile: raw.opts["setup-profile"],
+            setupProfile: normalizeSetupProfile(raw.opts["setup-profile"]),
+            policyGateway: raw.opts["policy-gateway"],
             ide: raw.opts.ide,
             workflow: raw.opts.workflow,
             backend: raw.opts.backend,
@@ -259,10 +288,11 @@ export const runInit = (ctx, flags) => cmdInit({ cwd: ctx.cwd, rootOverride: ctx
 async function cmdInit(opts) {
     const flags = opts.flags;
     const defaults = {
+        policyGateway: "codex",
         ide: "codex",
         workflow: "direct",
         backend: "local",
-        hooks: false,
+        hooks: true,
         recipes: [],
         requirePlanApproval: true,
         requireNetworkApproval: true,
@@ -271,6 +301,7 @@ 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;
@@ -283,19 +314,18 @@ async function cmdInit(opts) {
     let setupProfile = flags.setupProfile
         ? setupProfilePresets[flags.setupProfile].mode
         : "compact";
-    let setupProfilePreset = flags.setupProfile ?? "manager";
+    let setupProfilePreset = flags.setupProfile ?? "normal";
     const isInteractive = process.stdin.isTTY && !flags.yes;
     if (!process.stdin.isTTY &&
         !flags.yes &&
         (!flags.workflow ||
-            flags.hooks === undefined ||
             flags.requirePlanApproval === undefined ||
             flags.requireNetworkApproval === undefined ||
             flags.requireVerifyApproval === undefined)) {
         throw usageError({
             spec: initSpec,
             command: "init",
-            message: "Non-interactive init requires --yes or explicit values for: --workflow, --hooks, --require-plan-approval, --require-network-approval, --require-verify-approval.",
+            message: "Non-interactive init requires --yes or explicit values for: --workflow, --require-plan-approval, --require-network-approval, --require-verify-approval.",
         });
     }
     if (isInteractive) {
@@ -316,19 +346,25 @@ async function cmdInit(opts) {
         };
         process.stdout.write(renderInitWelcome());
         const presetLines = Object.entries(setupProfilePresets).map(([id, preset]) => `- ${id}: ${preset.description}`);
-        process.stdout.write(renderInitSection("Who Are You?", "Pick the persona that best matches your working style. This sets defaults and controls compact vs full questionnaire."));
+        process.stdout.write(renderInitSection("Setup Profile", "Pick one of three setup profiles. This controls policy strictness and questionnaire depth."));
         process.stdout.write(`${presetLines.join("\n")}\n\n`);
         if (flags.setupProfile) {
             setupProfilePreset = flags.setupProfile;
         }
         else {
-            const selected = await askChoice("Who are you?", ["developer", "vibecoder", "manager", "enterprise"], "manager");
+            const selected = await askChoice("Setup profile", ["light", "normal", "full-harness"], "normal");
             setupProfilePreset = selected;
         }
         const selectedPreset = setupProfilePresets[setupProfilePreset];
         setupProfile = selectedPreset.mode;
-        if (flags.hooks === undefined)
-            hooks = selectedPreset.defaultHooks;
+        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;
         }
@@ -360,9 +396,9 @@ async function cmdInit(opts) {
             backend = choice === "redmine" ? "redmine" : "local";
         }
         if (setupProfile === "full") {
-            if (flags.hooks === undefined) {
-                hooks = await askYesNo("Install managed git hooks now?", hooks);
-            }
+            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));
@@ -383,18 +419,27 @@ async function cmdInit(opts) {
             process.stdout.write(renderInitSection("Recipes", "Optional: install recipe packs now (comma-separated IDs) or choose none."));
             if (!flags.recipes) {
                 process.stdout.write(`${renderBundledRecipesHint()}\n`);
-                const answer = await askInput("Install optional recipes (comma separated, or none): ");
-                recipes = answer
-                    ? answer
+                const defaultRecipesLabel = selectedPreset.defaultRecipes.length > 0
+                    ? selectedPreset.defaultRecipes.join(", ")
+                    : "none";
+                const answer = await askInput(`Install optional recipes (comma separated, or none) [default: ${defaultRecipesLabel}]: `);
+                const normalized = answer.trim().toLowerCase();
+                if (normalized === "") {
+                    recipes = [...selectedPreset.defaultRecipes];
+                }
+                else if (normalized === "none") {
+                    recipes = [];
+                }
+                else {
+                    recipes = answer
                         .split(",")
                         .map((item) => item.trim())
-                        .filter(Boolean)
-                    : [];
+                        .filter(Boolean);
+                }
             }
         }
         else {
-            hooks = flags.hooks ?? selectedPreset.defaultHooks;
-            recipes = flags.recipes ?? defaults.recipes;
+            recipes = flags.recipes ?? selectedPreset.defaultRecipes;
             requirePlanApproval = flags.requirePlanApproval ?? selectedPreset.defaultRequirePlanApproval;
             requireNetworkApproval =
                 flags.requireNetworkApproval ?? selectedPreset.defaultRequireNetworkApproval;
@@ -402,16 +447,17 @@ 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 hooks, approvals, execution profile, and recipes.`));
+            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 ?? defaults.recipes;
+        recipes = flags.recipes ?? yesPreset.defaultRecipes;
         requirePlanApproval = flags.requirePlanApproval ?? yesPreset.defaultRequirePlanApproval;
         requireNetworkApproval =
             flags.requireNetworkApproval ?? yesPreset.defaultRequireNetworkApproval;
@@ -446,6 +492,21 @@ async function cmdInit(opts) {
         ];
         const initFiles = [configPath, backendPath];
         const conflicts = await collectInitConflicts({ initDirs, initFiles });
+        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.
+            await ensureAgentplaneDirs(resolved.agentplaneDir, backend);
+            await ensureAgentsFiles({
+                gitRoot: resolved.gitRoot,
+                agentplaneDir: resolved.agentplaneDir,
+                workflow,
+                policyGateway,
+                configPathAbs: configPath,
+                backendPathAbs: backendPath,
+            });
+        }
         await handleInitConflicts({
             gitRoot: resolved.gitRoot,
             conflicts,
@@ -472,6 +533,7 @@ async function cmdInit(opts) {
             gitRoot: resolved.gitRoot,
             agentplaneDir: resolved.agentplaneDir,
             workflow,
+            policyGateway,
             configPathAbs: configPath,
             backendPathAbs: backendPath,
         });
@@ -483,6 +545,18 @@ async function cmdInit(opts) {
             includeAgentPromptFiles: flags.gitignoreAgents === true,
         });
         installPaths.push(".gitignore");
+        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));
+        }
         if (flags.gitignoreAgents) {
             await setPinnedBaseBranch({
                 cwd: resolved.gitRoot,
@@ -501,14 +575,18 @@ async function cmdInit(opts) {
             gitRoot: resolved.gitRoot,
         });
         installPaths.push(...ideRes.installPaths);
-        maybeInstallBundledRecipes(recipes);
+        await maybeInstallBundledRecipes({
+            recipes,
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride,
+        });
         if (!flags.gitignoreAgents) {
             await ensureInitCommit({
                 gitRoot: resolved.gitRoot,
                 baseBranch: initBaseBranch,
                 installPaths,
                 version: getVersion(),
-                skipHooks: hooks,
+                skipHooks: true,
             });
         }
         process.stdout.write(`${path.relative(resolved.gitRoot, resolved.agentplaneDir)}\n`);

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":"AAibA,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAiL5D"}
+{"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"}