agentplane 0.1.8 → 0.2.0

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

@@ -0,0 +1,11 @@
+export declare function collectInitConflicts(opts: {
+    initDirs: string[];
+    initFiles: string[];
+}): Promise<string[]>;
+export declare function handleInitConflicts(opts: {
+    gitRoot: string;
+    conflicts: string[];
+    backup: boolean;
+    force: boolean;
+}): Promise<void>;
+//# sourceMappingURL=conflicts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"conflicts.d.ts","sourceRoot":"","sources":["../../../../../src/cli/run-cli/commands/init/conflicts.ts"],"names":[],"mappings":"AAMA,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAUpB;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BhB"}

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

@@ -0,0 +1,42 @@
+import { rm } from "node:fs/promises";
+import path from "node:path";
+import { backupPath, fileExists, getPathKind } from "../../../fs-utils.js";
+import { CliError } from "../../../../shared/errors.js";
+export async function collectInitConflicts(opts) {
+    const conflicts = [];
+    for (const dir of opts.initDirs) {
+        const kind = await getPathKind(dir);
+        if (kind && kind !== "dir")
+            conflicts.push(dir);
+    }
+    for (const filePath of opts.initFiles) {
+        if (await fileExists(filePath))
+            conflicts.push(filePath);
+    }
+    return conflicts;
+}
+export async function handleInitConflicts(opts) {
+    if (opts.conflicts.length === 0)
+        return;
+    if (opts.backup) {
+        for (const conflict of opts.conflicts) {
+            await backupPath(conflict);
+        }
+        return;
+    }
+    if (opts.force) {
+        for (const conflict of opts.conflicts) {
+            await rm(conflict, { recursive: true, force: true });
+        }
+        return;
+    }
+    const rendered = opts.conflicts
+        .map((conflict) => `- ${path.relative(opts.gitRoot, conflict)}`)
+        .join("\n");
+    throw new CliError({
+        exitCode: 5,
+        code: "E_IO",
+        message: `Init conflicts detected:\n${rendered}\n` +
+            "Re-run with --force to overwrite or --backup to preserve existing files.",
+    });
+}

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

@@ -0,0 +1,8 @@
+export declare function ensureGitRoot(opts: {
+    initRoot: string;
+    baseBranchFallback: string;
+}): Promise<{
+    gitRoot: string;
+    gitRootExisted: boolean;
+}>;
+//# sourceMappingURL=git.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../../../../src/cli/run-cli/commands/init/git.ts"],"names":[],"mappings":"AAIA,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;CAC5B,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,OAAO,CAAA;CAAE,CAAC,CASxD"}

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

@@ -0,0 +1,12 @@
+import { findGitRoot } from "@agentplaneorg/core";
+import { gitInitRepo } from "../../../../commands/workflow.js";
+export async function ensureGitRoot(opts) {
+    const existingGitRoot = await findGitRoot(opts.initRoot);
+    const gitRootExisted = Boolean(existingGitRoot);
+    let gitRoot = existingGitRoot;
+    if (!gitRoot) {
+        await gitInitRepo(opts.initRoot, opts.baseBranchFallback);
+        gitRoot = opts.initRoot;
+    }
+    return { gitRoot, gitRootExisted };
+}

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

@@ -0,0 +1,9 @@
+export declare function maybeSyncIde(opts: {
+    cwd: string;
+    rootOverride?: string;
+    ide: "codex" | "cursor" | "windsurf";
+    gitRoot: string;
+}): Promise<{
+    installPaths: string[];
+}>;
+//# sourceMappingURL=ide-sync.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ide-sync.d.ts","sourceRoot":"","sources":["../../../../../src/cli/run-cli/commands/init/ide-sync.ts"],"names":[],"mappings":"AAMA,wBAAsB,YAAY,CAAC,IAAI,EAAE;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC;IAAE,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAetC"}

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

@@ -0,0 +1,18 @@
+import path from "node:path";
+import { fileExists } from "../../../fs-utils.js";
+import { cmdIdeSync } from "../ide.js";
+export async function maybeSyncIde(opts) {
+    if (opts.ide === "codex")
+        return { installPaths: [] };
+    await cmdIdeSync({ cwd: opts.cwd, rootOverride: opts.rootOverride, ide: opts.ide });
+    const installPaths = [];
+    const cursorPath = path.join(opts.gitRoot, ".cursor", "rules", "agentplane.mdc");
+    const windsurfPath = path.join(opts.gitRoot, ".windsurf", "rules", "agentplane.md");
+    if (opts.ide === "cursor" && (await fileExists(cursorPath))) {
+        installPaths.push(path.relative(opts.gitRoot, cursorPath));
+    }
+    if (opts.ide === "windsurf" && (await fileExists(windsurfPath))) {
+        installPaths.push(path.relative(opts.gitRoot, windsurfPath));
+    }
+    return { installPaths };
+}

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

@@ -0,0 +1,2 @@
+export declare function maybeInstallBundledRecipes(recipes: string[]): void;
+//# sourceMappingURL=recipes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recipes.d.ts","sourceRoot":"","sources":["../../../../../src/cli/run-cli/commands/init/recipes.ts"],"names":[],"mappings":"AAGA,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CASlE"}

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

@@ -0,0 +1,11 @@
+import { infoMessage } from "../../../output.js";
+import { listBundledRecipes } from "../../../recipes-bundled.js";
+export function maybeInstallBundledRecipes(recipes) {
+    if (recipes.length === 0)
+        return;
+    if (listBundledRecipes().length === 0) {
+        process.stdout.write(`${infoMessage("bundled recipes are empty; nothing to install")}\n`);
+        return;
+    }
+    process.stdout.write(`${infoMessage("bundled recipe install is not implemented; skipping")}\n`);
+}

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

@@ -0,0 +1,11 @@
+import type { WorkflowMode } from "../../../../agents/agents-template.js";
+export declare function ensureAgentsFiles(opts: {
+    gitRoot: string;
+    agentplaneDir: string;
+    workflow: WorkflowMode;
+    configPathAbs: string;
+    backendPathAbs: string;
+}): Promise<{
+    installPaths: string[];
+}>;
+//# sourceMappingURL=write-agents.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"write-agents.d.ts","sourceRoot":"","sources":["../../../../../src/cli/run-cli/commands/init/write-agents.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAQ1E,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,CA2BtC"}

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

@@ -0,0 +1,30 @@
+import path from "node:path";
+import { atomicWriteFile } from "@agentplaneorg/core";
+import { filterAgentsByWorkflow, loadAgentTemplates, loadAgentsTemplate, } from "../../../../agents/agents-template.js";
+import { fileExists } from "../../../fs-utils.js";
+export async function ensureAgentsFiles(opts) {
+    const agentsPath = path.join(opts.gitRoot, "AGENTS.md");
+    const installPaths = [
+        path.relative(opts.gitRoot, opts.configPathAbs),
+        path.relative(opts.gitRoot, opts.backendPathAbs),
+    ];
+    let wroteAgents = false;
+    if (!(await fileExists(agentsPath))) {
+        const template = await loadAgentsTemplate();
+        const filtered = filterAgentsByWorkflow(template, opts.workflow);
+        await atomicWriteFile(agentsPath, filtered, "utf8");
+        wroteAgents = true;
+    }
+    if (wroteAgents) {
+        installPaths.push(path.relative(opts.gitRoot, agentsPath));
+    }
+    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");
+        installPaths.push(path.relative(opts.gitRoot, targetPath));
+    }
+    return { installPaths };
+}

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

@@ -0,0 +1,15 @@
+export declare function ensureAgentplaneDirs(agentplaneDir: string): Promise<void>;
+export declare function writeInitConfig(opts: {
+    agentplaneDir: string;
+    gitRoot: string;
+    workflow: "direct" | "branch_pr";
+    backendConfigPathAbs: string;
+    requirePlanApproval: boolean;
+    requireNetworkApproval: boolean;
+    requireVerifyApproval: boolean;
+}): Promise<void>;
+export declare function writeBackendStubs(opts: {
+    localBackendPath: string;
+    redmineBackendPath: string;
+}): Promise<void>;
+//# sourceMappingURL=write-config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"write-config.d.ts","sourceRoot":"","sources":["../../../../../src/cli/run-cli/commands/init/write-config.ts"],"names":[],"mappings":"AAOA,wBAAsB,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAO/E;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;CAChC,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBhB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;CAC5B,GAAG,OAAO,CAAC,IAAI,CAAC,CAuBhB"}

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

@@ -0,0 +1,45 @@
+import { mkdir } from "node:fs/promises";
+import path from "node:path";
+import { defaultConfig, saveConfig, setByDottedKey } from "@agentplaneorg/core";
+import { writeJsonStableIfChanged } from "../../../../shared/write-if-changed.js";
+export async function ensureAgentplaneDirs(agentplaneDir) {
+    await mkdir(agentplaneDir, { recursive: true });
+    await mkdir(path.join(agentplaneDir, "tasks"), { recursive: true });
+    await mkdir(path.join(agentplaneDir, "agents"), { recursive: true });
+    await mkdir(path.join(agentplaneDir, "cache"), { recursive: true });
+    await mkdir(path.join(agentplaneDir, "backends", "local"), { recursive: true });
+    await mkdir(path.join(agentplaneDir, "backends", "redmine"), { recursive: true });
+}
+export async function writeInitConfig(opts) {
+    const rawConfig = defaultConfig();
+    setByDottedKey(rawConfig, "workflow_mode", opts.workflow);
+    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));
+    setByDottedKey(rawConfig, "agents.approvals.require_verify", String(opts.requireVerifyApproval));
+    await saveConfig(opts.agentplaneDir, rawConfig);
+}
+export async function writeBackendStubs(opts) {
+    const localBackendPayload = {
+        id: "local",
+        version: 1,
+        module: "backend.py",
+        class: "LocalBackend",
+        settings: { dir: ".agentplane/tasks" },
+    };
+    const redmineBackendPayload = {
+        id: "redmine",
+        version: 1,
+        module: "backend.py",
+        class: "RedmineBackend",
+        settings: {
+            url: "https://redmine.example",
+            api_key: "replace-me",
+            project_id: "replace-me",
+            owner_agent: "REDMINE",
+            custom_fields: { task_id: 1 },
+        },
+    };
+    await writeJsonStableIfChanged(opts.localBackendPath, localBackendPayload);
+    await writeJsonStableIfChanged(opts.redmineBackendPath, redmineBackendPayload);
+}

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

@@ -0,0 +1,21 @@
+import type { CommandHandler, CommandSpec } from "../../spec/spec.js";
+type InitFlags = {
+    ide?: "codex" | "cursor" | "windsurf";
+    workflow?: "direct" | "branch_pr";
+    backend?: "local" | "redmine";
+    hooks?: boolean;
+    requirePlanApproval?: boolean;
+    requireNetworkApproval?: boolean;
+    requireVerifyApproval?: boolean;
+    recipes?: string[];
+    force?: boolean;
+    backup?: boolean;
+    yes: boolean;
+};
+type InitParsed = Omit<InitFlags, "yes"> & {
+    yes: boolean;
+};
+export declare const initSpec: CommandSpec<InitParsed>;
+export declare const runInit: CommandHandler<InitParsed>;
+export {};
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +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;AAatE,KAAK,SAAS,GAAG;IACf,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,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,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;AAsBF,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,CA0I5C,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,cAAc,CAAC,UAAU,CACmB,CAAC"}

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

@@ -0,0 +1,332 @@
+import path from "node:path";
+import { resolveProject } from "@agentplaneorg/core";
+import { mapCoreError } from "../../error-map.js";
+import { promptChoice, promptInput, promptYesNo } from "../../prompts.js";
+import { invalidValueForFlag } from "../../output.js";
+import { renderBundledRecipesHint, validateBundledRecipesSelection, } from "../../recipes-bundled.js";
+import { usageError } from "../../spec/errors.js";
+import { CliError } from "../../../shared/errors.js";
+import { getVersion } from "../../../meta/version.js";
+import { cmdHooksInstall, ensureInitCommit } from "../../../commands/workflow.js";
+import { resolveInitBaseBranchForInit } from "./init/base-branch.js";
+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 { ensureAgentplaneDirs, writeBackendStubs, writeInitConfig } from "./init/write-config.js";
+import { ensureAgentsFiles } from "./init/write-agents.js";
+function parseBooleanValueForInit(flag, value) {
+    const normalized = value.trim().toLowerCase();
+    if (["1", "true", "yes", "y", "on"].includes(normalized))
+        return true;
+    if (["0", "false", "no", "n", "off"].includes(normalized))
+        return false;
+    throw usageError({
+        spec: initSpec,
+        command: "init",
+        message: invalidValueForFlag(flag, value, "true|false"),
+    });
+}
+function parseRecipesSelectionForInit(value) {
+    const normalized = value.trim().toLowerCase();
+    if (normalized === "none" || normalized === "")
+        return [];
+    return value
+        .split(",")
+        .map((item) => item.trim())
+        .filter(Boolean);
+}
+export const initSpec = {
+    id: ["init"],
+    group: "Setup",
+    summary: "Initialize agentplane project files under .agentplane/.",
+    description: "Creates .agentplane/ config, backend stubs, and agent templates. In interactive mode it prompts for missing inputs; use --yes for non-interactive mode.",
+    options: [
+        {
+            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: "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 git hooks (non-interactive requires an explicit value).",
+        },
+        {
+            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: "recipes",
+            valueHint: "<none|id1,id2,...>",
+            description: "Optional bundled recipes selection (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).",
+        },
+    ],
+    examples: [
+        { cmd: "agentplane init", why: "Interactive setup (prompts for missing values)." },
+        {
+            cmd: "agentplane init --workflow direct --backend local --hooks false --require-plan-approval true --require-network-approval true --require-verify-approval true --yes",
+            why: "Non-interactive setup with explicit policy flags.",
+        },
+        {
+            cmd: "agentplane init --force --yes",
+            why: "Re-initialize, overwriting conflicts (non-interactive).",
+        },
+    ],
+    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 {
+            ide: raw.opts.ide,
+            workflow: raw.opts.workflow,
+            backend: raw.opts.backend,
+            hooks: hooksRaw === undefined ? undefined : parseBooleanValueForInit("--hooks", hooksRaw),
+            requirePlanApproval: requirePlanRaw === undefined
+                ? undefined
+                : parseBooleanValueForInit("--require-plan-approval", requirePlanRaw),
+            requireNetworkApproval: requireNetworkRaw === undefined
+                ? undefined
+                : parseBooleanValueForInit("--require-network-approval", requireNetworkRaw),
+            requireVerifyApproval: requireVerifyRaw === undefined
+                ? undefined
+                : parseBooleanValueForInit("--require-verify-approval", requireVerifyRaw),
+            recipes: recipesRaw === undefined ? undefined : parseRecipesSelectionForInit(recipesRaw),
+            force: raw.opts.force === true,
+            backup: raw.opts.backup === true,
+            yes: raw.opts.yes === 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 });
+async function cmdInit(opts) {
+    const flags = opts.flags;
+    const defaults = {
+        ide: "codex",
+        workflow: "direct",
+        backend: "local",
+        hooks: false,
+        recipes: [],
+        requirePlanApproval: true,
+        requireNetworkApproval: true,
+        requireVerifyApproval: true,
+    };
+    let ide = flags.ide ?? defaults.ide;
+    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;
+    let requireVerifyApproval = flags.requireVerifyApproval ?? defaults.requireVerifyApproval;
+    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.",
+        });
+    }
+    if (isInteractive) {
+        ide = flags.ide ?? defaults.ide;
+        if (!flags.workflow) {
+            const choice = await promptChoice("Select workflow mode", ["direct", "branch_pr"], workflow);
+            workflow = choice === "branch_pr" ? "branch_pr" : "direct";
+        }
+        if (!flags.backend) {
+            const choice = await promptChoice("Select task backend", ["local", "redmine"], backend);
+            backend = choice === "redmine" ? "redmine" : "local";
+        }
+        if (flags.hooks === undefined) {
+            hooks = await promptYesNo("Install git hooks?", hooks);
+        }
+        if (flags.requirePlanApproval === undefined) {
+            requirePlanApproval = await promptYesNo("Require plan approval?", requirePlanApproval);
+        }
+        if (flags.requireNetworkApproval === undefined) {
+            requireNetworkApproval = await promptYesNo("Require explicit approval for network access?", requireNetworkApproval);
+        }
+        if (flags.requireVerifyApproval === undefined) {
+            requireVerifyApproval = await promptYesNo("Require explicit approval for verification?", requireVerifyApproval);
+        }
+        if (!flags.recipes) {
+            process.stdout.write(`${renderBundledRecipesHint()}\n`);
+            const answer = await promptInput("Install optional recipes (comma separated, or none): ");
+            recipes = answer
+                ? answer
+                    .split(",")
+                    .map((item) => item.trim())
+                    .filter(Boolean)
+                : [];
+        }
+    }
+    if (flags.yes) {
+        ide = flags.ide ?? defaults.ide;
+        workflow = flags.workflow ?? defaults.workflow;
+        backend = flags.backend ?? defaults.backend;
+        hooks = flags.hooks ?? defaults.hooks;
+        recipes = flags.recipes ?? defaults.recipes;
+        requirePlanApproval = flags.requirePlanApproval ?? defaults.requirePlanApproval;
+        requireNetworkApproval = flags.requireNetworkApproval ?? defaults.requireNetworkApproval;
+        requireVerifyApproval = flags.requireVerifyApproval ?? defaults.requireVerifyApproval;
+    }
+    validateBundledRecipesSelection(recipes);
+    try {
+        const initRoot = path.resolve(opts.rootOverride ?? opts.cwd);
+        const baseBranchFallback = "main";
+        const { gitRoot, gitRootExisted } = await ensureGitRoot({ initRoot, baseBranchFallback });
+        const resolved = await resolveProject({
+            cwd: gitRoot,
+            rootOverride: gitRoot,
+        });
+        const initBaseBranch = await resolveInitBaseBranchForInit({
+            gitRoot: resolved.gitRoot,
+            baseBranchFallback,
+            isInteractive,
+            workflow,
+            gitRootExisted,
+        });
+        const configPath = path.join(resolved.agentplaneDir, "config.json");
+        const localBackendPath = path.join(resolved.agentplaneDir, "backends", "local", "backend.json");
+        const redmineBackendPath = path.join(resolved.agentplaneDir, "backends", "redmine", "backend.json");
+        const backendPath = backend === "redmine" ? redmineBackendPath : localBackendPath;
+        const initDirs = [
+            resolved.agentplaneDir,
+            path.join(resolved.agentplaneDir, "tasks"),
+            path.join(resolved.agentplaneDir, "agents"),
+            path.join(resolved.agentplaneDir, "cache"),
+            path.join(resolved.agentplaneDir, "backends"),
+            path.join(resolved.agentplaneDir, "backends", "local"),
+            path.join(resolved.agentplaneDir, "backends", "redmine"),
+        ];
+        const initFiles = [configPath, localBackendPath, redmineBackendPath];
+        const conflicts = await collectInitConflicts({ initDirs, initFiles });
+        await handleInitConflicts({
+            gitRoot: resolved.gitRoot,
+            conflicts,
+            backup: flags.backup === true,
+            force: flags.force === true,
+        });
+        await ensureAgentplaneDirs(resolved.agentplaneDir);
+        await writeInitConfig({
+            agentplaneDir: resolved.agentplaneDir,
+            gitRoot: resolved.gitRoot,
+            workflow,
+            backendConfigPathAbs: backendPath,
+            requirePlanApproval,
+            requireNetworkApproval,
+            requireVerifyApproval,
+        });
+        await writeBackendStubs({ localBackendPath, redmineBackendPath });
+        const { installPaths } = await ensureAgentsFiles({
+            gitRoot: resolved.gitRoot,
+            agentplaneDir: resolved.agentplaneDir,
+            workflow,
+            configPathAbs: configPath,
+            backendPathAbs: backendPath,
+        });
+        if (hooks) {
+            await cmdHooksInstall({ cwd: opts.cwd, rootOverride: opts.rootOverride, quiet: true });
+        }
+        const ideRes = await maybeSyncIde({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride,
+            ide,
+            gitRoot: resolved.gitRoot,
+        });
+        installPaths.push(...ideRes.installPaths);
+        maybeInstallBundledRecipes(recipes);
+        await ensureInitCommit({
+            gitRoot: resolved.gitRoot,
+            baseBranch: initBaseBranch,
+            installPaths,
+            version: getVersion(),
+            skipHooks: hooks,
+        });
+        process.stdout.write(`${path.relative(resolved.gitRoot, resolved.agentplaneDir)}\n`);
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw mapCoreError(err, { command: "init", root: opts.rootOverride ?? null });
+    }
+}

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

@@ -0,0 +1,4 @@
+import { CommandRegistry } from "../spec/registry.js";
+import type { CommandContext } from "../../commands/shared/task-backend.js";
+export declare function buildRegistry(getCtx: (commandForErrorContext: string) => Promise<CommandContext>): CommandRegistry;
+//# sourceMappingURL=registry.run.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.run.d.ts","sourceRoot":"","sources":["../../../src/cli/run-cli/registry.run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAMtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAE5E,wBAAgB,aAAa,CAC3B,MAAM,EAAE,CAAC,sBAAsB,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,GAClE,eAAe,CAcjB"}

package/dist/cli/run-cli/registry.run.js

@@ -0,0 +1,19 @@
+import { CommandRegistry } from "../spec/registry.js";
+import { helpSpec, makeHelpHandler } from "../spec/help.js";
+import { makeHelpJsonFromSpecs } from "../../commands/docs/cli.command.js";
+import { COMMANDS } from "./command-catalog.js";
+export function buildRegistry(getCtx) {
+    const registry = new CommandRegistry();
+    const getHelpJsonForDocs = () => makeHelpJsonFromSpecs(registry.list().map((e) => e.spec));
+    const deps = { getCtx, getHelpJsonForDocs };
+    for (const entry of COMMANDS) {
+        let loaded = null;
+        registry.register(entry.spec, async (ctx, parsed) => {
+            loaded ??= entry.load(deps);
+            const handler = await loaded;
+            return await handler(ctx, parsed);
+        });
+    }
+    registry.register(helpSpec, makeHelpHandler(registry));
+    return registry;
+}

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":"AAmjCA,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAw0D5D"}
+{"version":3,"file":"run-cli.d.ts","sourceRoot":"","sources":["../../src/cli/run-cli.ts"],"names":[],"mappings":"AAiVA,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA4H5D"}