agentplane 0.3.14 → 0.3.16

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

@@ -0,0 +1,212 @@
+import { usageError } from "../../../spec/errors.js";
+import { cmdInit } from "./orchestrate.js";
+import { normalizeSetupProfile } from "./presets.js";
+import { parseBooleanValueForInit, parseDirectCloseDirtyPolicyForInit, parseRecipesSelectionForInit, } from "./parsers.js";
+export const initSpec = {
+    id: ["init"],
+    group: "Setup",
+    summary: "Initialize agentplane project files under .agentplane/.",
+    description: "Creates .agentplane/ config, backend stubs, and agent templates in the target directory. If the target directory is not a git repository, it initializes one and (by default) writes an initial install commit. Use --gitignore-agents to keep agent templates local (gitignored) and skip the install commit. In interactive mode it prompts for missing inputs; use --yes for non-interactive mode.",
+    options: [
+        {
+            kind: "string",
+            name: "setup-profile",
+            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",
+            name: "ide",
+            valueHint: "<codex|cursor|windsurf>",
+            choices: ["codex", "cursor", "windsurf"],
+            coerce: (raw) => raw.trim().toLowerCase(),
+            description: "IDE rules integration target (default: codex).",
+        },
+        {
+            kind: "string",
+            name: "workflow",
+            valueHint: "<direct|branch_pr>",
+            choices: ["direct", "branch_pr"],
+            description: "Workflow mode (default: direct).",
+        },
+        {
+            kind: "string",
+            name: "direct-close-dirty-policy",
+            valueHint: "<allow-other-task-readmes|strict>",
+            choices: ["allow-other-task-readmes", "strict"],
+            description: "Direct-mode close behavior when tracked dirt exists outside the active task: allow only other active task READMEs, or block on any unrelated tracked change.",
+        },
+        {
+            kind: "string",
+            name: "backend",
+            valueHint: "<local|redmine>",
+            choices: ["local", "redmine"],
+            coerce: (raw) => raw.trim().toLowerCase(),
+            description: "Task backend (default: local).",
+        },
+        {
+            kind: "string",
+            name: "hooks",
+            valueHint: "<true|false>",
+            description: "Install managed git hooks (default by setup profile: light=false, normal/full-harness=true).",
+        },
+        {
+            kind: "string",
+            name: "require-plan-approval",
+            valueHint: "<true|false>",
+            description: "Require explicit plan approval before starting work.",
+        },
+        {
+            kind: "string",
+            name: "require-network-approval",
+            valueHint: "<true|false>",
+            description: "Require explicit approval before any network operation.",
+        },
+        {
+            kind: "string",
+            name: "require-verify-approval",
+            valueHint: "<true|false>",
+            description: "Require explicit approval before recording verification.",
+        },
+        {
+            kind: "string",
+            name: "execution-profile",
+            valueHint: "<conservative|balanced|aggressive>",
+            choices: ["conservative", "balanced", "aggressive"],
+            description: "Execution profile preset controlling autonomy, reasoning, and tool budgets.",
+        },
+        {
+            kind: "string",
+            name: "strict-unsafe-confirm",
+            valueHint: "<true|false>",
+            description: "Require strict explicit confirmations for additional unsafe actions.",
+        },
+        {
+            kind: "string",
+            name: "recipes",
+            valueHint: "<none|id1,id2,...>",
+            description: "Optional cached recipes to vendor during init (comma-separated), or 'none'.",
+        },
+        {
+            kind: "boolean",
+            name: "force",
+            default: false,
+            description: "Overwrite init conflicts by deleting existing paths.",
+        },
+        {
+            kind: "boolean",
+            name: "backup",
+            default: false,
+            description: "Backup init conflicts before overwriting.",
+        },
+        {
+            kind: "boolean",
+            name: "yes",
+            default: false,
+            description: "Non-interactive mode (do not prompt; use defaults for missing flags).",
+        },
+        {
+            kind: "boolean",
+            name: "gitignore-agents",
+            default: false,
+            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 light --yes",
+            why: "Non-interactive setup with flexible defaults.",
+        },
+        {
+            cmd: "agentplane init --workflow direct --direct-close-dirty-policy allow-other-task-readmes --backend local --hooks true --require-network-approval true --yes",
+            why: "Non-interactive setup with the tolerant direct close policy plus an explicit network-approval override.",
+        },
+        {
+            cmd: "agentplane init --workflow direct --direct-close-dirty-policy strict --yes",
+            why: "Initialize direct mode with strict close-tail blocking on any unrelated tracked dirt.",
+        },
+        {
+            cmd: "agentplane init --force --yes",
+            why: "Re-initialize, overwriting conflicts (non-interactive).",
+        },
+        {
+            cmd: "agentplane init --yes --gitignore-agents",
+            why: "Initialize without committing and keep agent prompts/templates local (gitignored).",
+        },
+    ],
+    validateRaw: (raw) => {
+        if (raw.extra.length > 0) {
+            throw usageError({
+                spec: initSpec,
+                command: "init",
+                message: `Unexpected argument: ${raw.extra[0]}`,
+            });
+        }
+    },
+    parse: (raw) => {
+        const hooksRaw = raw.opts.hooks;
+        const requirePlanRaw = raw.opts["require-plan-approval"];
+        const requireNetworkRaw = raw.opts["require-network-approval"];
+        const requireVerifyRaw = raw.opts["require-verify-approval"];
+        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,
+            directCloseDirtyPolicy: raw.opts["direct-close-dirty-policy"] === undefined
+                ? undefined
+                : parseDirectCloseDirtyPolicyForInit(initSpec, "--direct-close-dirty-policy", String(raw.opts["direct-close-dirty-policy"])),
+            backend: raw.opts.backend,
+            hooks: hooksRaw === undefined
+                ? undefined
+                : parseBooleanValueForInit(initSpec, "--hooks", hooksRaw),
+            requirePlanApproval: requirePlanRaw === undefined
+                ? undefined
+                : parseBooleanValueForInit(initSpec, "--require-plan-approval", requirePlanRaw),
+            requireNetworkApproval: requireNetworkRaw === undefined
+                ? undefined
+                : parseBooleanValueForInit(initSpec, "--require-network-approval", requireNetworkRaw),
+            requireVerifyApproval: requireVerifyRaw === undefined
+                ? undefined
+                : parseBooleanValueForInit(initSpec, "--require-verify-approval", requireVerifyRaw),
+            executionProfile: raw.opts["execution-profile"],
+            strictUnsafeConfirm: raw.opts["strict-unsafe-confirm"] === undefined
+                ? undefined
+                : parseBooleanValueForInit(initSpec, "--strict-unsafe-confirm", String(raw.opts["strict-unsafe-confirm"])),
+            recipes: recipesRaw === undefined ? undefined : parseRecipesSelectionForInit(recipesRaw),
+            force: raw.opts.force === true,
+            backup: raw.opts.backup === true,
+            yes: raw.opts.yes === true,
+            gitignoreAgents: raw.opts["gitignore-agents"] === true,
+        };
+    },
+    validate: (p) => {
+        if (p.force && p.backup) {
+            throw usageError({
+                spec: initSpec,
+                command: "init",
+                message: "Use either --force or --backup (not both).",
+            });
+        }
+    },
+};
+export const runInit = (ctx, flags) => cmdInit({ cwd: ctx.cwd, rootOverride: ctx.rootOverride, flags, spec: initSpec });

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

@@ -15,6 +15,7 @@ export declare function writeInitConfig(opts: {
     agentplaneDir: string;
     gitRoot: string;
     workflow: "direct" | "branch_pr";
+    directCloseDirtyPolicy: "allow_other_task_readmes" | "strict";
     backendConfigPathAbs: string;
     requirePlanApproval: boolean;
     requireNetworkApproval: boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"write-config.d.ts","sourceRoot":"","sources":["../../../../../src/cli/run-cli/commands/init/write-config.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,cAAc,GAAG,UAAU,GAAG,YAAY,CAAC;IACpD,gBAAgB,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC5C,WAAW,EAAE;QACX,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,yCAAyC,EAAE,MAAM,EAAE,CAAC;CACrD,CAAC;AAEF,wBAAsB,oBAAoB,CACxC,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,OAAO,GAAG,SAAS,GAC3B,OAAO,CAAC,IAAI,CAAC,CAOf;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,QAAQ,GAAG,WAAW,CAAC;IACjC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,sBAAsB,EAAE,OAAO,CAAC;IAChC,qBAAqB,EAAE,OAAO,CAAC;IAC/B,SAAS,EAAE,mBAAmB,CAAC;CAChC,GAAG,OAAO,CAAC,IAAI,CAAC,CA0BhB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBhB"}
+{"version":3,"file":"write-config.d.ts","sourceRoot":"","sources":["../../../../../src/cli/run-cli/commands/init/write-config.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,cAAc,GAAG,UAAU,GAAG,YAAY,CAAC;IACpD,gBAAgB,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC5C,WAAW,EAAE;QACX,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,yCAAyC,EAAE,MAAM,EAAE,CAAC;CACrD,CAAC;AAEF,wBAAsB,oBAAoB,CACxC,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,OAAO,GAAG,SAAS,GAC3B,OAAO,CAAC,IAAI,CAAC,CAOf;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,QAAQ,GAAG,WAAW,CAAC;IACjC,sBAAsB,EAAE,0BAA0B,GAAG,QAAQ,CAAC;IAC9D,oBAAoB,EAAE,MAAM,CAAC;IAC7B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,sBAAsB,EAAE,OAAO,CAAC;IAChC,qBAAqB,EAAE,OAAO,CAAC;IAC/B,SAAS,EAAE,mBAAmB,CAAC;CAChC,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BhB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBhB"}

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

@@ -18,6 +18,7 @@ export async function writeInitConfig(opts) {
     setByDottedKey(rawConfig, "commit_automation", "finish_only");
     // Keep status commits explicit by default in all modes to reduce commit noise.
     setByDottedKey(rawConfig, "finish_auto_status_commit", "false");
+    setByDottedKey(rawConfig, "close_commit.direct_dirty_policy", opts.directCloseDirtyPolicy);
     setByDottedKey(rawConfig, "tasks_backend.config_path", path.relative(opts.gitRoot, opts.backendConfigPathAbs));
     setByDottedKey(rawConfig, "agents.approvals.require_plan", String(opts.requirePlanApproval));
     setByDottedKey(rawConfig, "agents.approvals.require_network", String(opts.requireNetworkApproval));

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

@@ -1,6 +1,6 @@
 import path from "node:path";
 import { readFile } from "node:fs/promises";
-import { AGENT_PROMPT_GITIGNORE_LINES, RUNTIME_GITIGNORE_LINES, } from "../../../../shared/runtime-artifacts.js";
+import { AGENT_PROMPT_GITIGNORE_LINES, RUNTIME_GITIGNORE_LINES, } from "../../../../runtime/shared/runtime-artifacts.js";
 import { writeTextIfChanged } from "../../../../shared/write-if-changed.js";
 async function readTextIfExists(filePath) {
     try {

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

@@ -1,29 +1,2 @@
-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";
-    hooks?: boolean;
-    gitignoreAgents?: boolean;
-    requirePlanApproval?: boolean;
-    requireNetworkApproval?: boolean;
-    requireVerifyApproval?: boolean;
-    executionProfile?: ExecutionProfile;
-    strictUnsafeConfirm?: boolean;
-    recipes?: string[];
-    force?: boolean;
-    backup?: boolean;
-    yes: boolean;
-};
-type SetupProfilePreset = "light" | "normal" | "full-harness";
-type InitParsed = Omit<InitFlags, "yes"> & {
-    yes: boolean;
-};
-export declare const initSpec: CommandSpec<InitParsed>;
-export declare const runInit: CommandHandler<InitParsed>;
-export {};
+export { initSpec, runInit } from "./init/spec.js";
 //# sourceMappingURL=init.d.ts.map

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":"AAaA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAItE,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,qBAAqB,CAAC;AAa7B,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"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../src/cli/run-cli/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC"}