agentplane 0.2.14 → 0.2.17

package/dist/backends/task-backend/redmine-backend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"redmine-backend.d.ts","sourceRoot":"","sources":["../../../src/backends/task-backend/redmine-backend.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"redmine-backend.d.ts","sourceRoot":"","sources":["../../../src/backends/task-backend/redmine-backend.ts"],"names":[],"mappings":"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"}

package/dist/backends/task-backend/redmine-backend.js

@@ -37,8 +37,15 @@ export class RedmineBackend {
         this.batchPause = typeof settings.batch_pause === "number" ? settings.batch_pause : 0.5;
         this.ownerAgent = firstNonEmptyString(envOwner, settings.owner_agent, "REDMINE");
         this.cache = opts.cache ?? null;
-        if (!this.baseUrl || !this.apiKey || !this.projectId) {
-            throw new BackendError(redmineConfigMissingMessage("url, api_key, project_id"), "E_BACKEND");
+        const missingEnvKeys = [];
+        if (!this.baseUrl)
+            missingEnvKeys.push("AGENTPLANE_REDMINE_URL");
+        if (!this.apiKey)
+            missingEnvKeys.push("AGENTPLANE_REDMINE_API_KEY");
+        if (!this.projectId)
+            missingEnvKeys.push("AGENTPLANE_REDMINE_PROJECT_ID");
+        if (missingEnvKeys.length > 0) {
+            throw new BackendError(redmineConfigMissingMessage(missingEnvKeys.join(", ")), "E_BACKEND");
         }
         if (!this.customFields?.task_id) {
             throw new BackendError(redmineConfigMissingMessage("custom_fields.task_id"), "E_BACKEND");

package/dist/backends/task-backend/shared/errors.js

@@ -11,7 +11,7 @@ export class RedmineUnavailable extends BackendError {
     }
 }
 export function redmineConfigMissingMessage(detail) {
-    return `Missing required Redmine config: ${detail}`;
+    return `Missing required Redmine configuration. Set ${detail} in environment variables (for example via .env).`;
 }
 export function redmineIssueIdMissingMessage() {
     return "Missing Redmine issue id for task";

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

@@ -1 +1 @@
-{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../../../../src/cli/run-cli/commands/init/ui.ts"],"names":[],"mappings":"AAsBA,wBAAgB,iBAAiB,IAAI,MAAM,CAa1C;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAG5E"}
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../../../../src/cli/run-cli/commands/init/ui.ts"],"names":[],"mappings":"AAsBA,wBAAgB,iBAAiB,IAAI,MAAM,CAY1C;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAG5E"}

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

@@ -20,19 +20,18 @@ function box(lines) {
 }
 export function renderInitWelcome() {
     const logo = [
-        "   ___   ____ ____ _   _ _____ ",
-        "  / _ | / __// __// | / / ___/ ",
-        " / __ |/ _/ / _/ /  |/ / /__   ",
-        String.raw `/_/ |_|\__/ /___//_/|_/\___/   `,
-        "          agent/plane          ",
+        "░█▀█░█▀▀░█▀▀░█▀█░▀█▀░░░█░█▀█░█░░░█▀█░█▀█░█▀▀",
+        "░█▀█░█░█░█▀▀░█░█░░█░░▄▀░░█▀▀░█░░░█▀█░█░█░█▀▀",
+        "░▀░▀░▀▀▀░▀▀▀░▀░▀░░▀░░▀░░░▀░░░▀▀▀░▀░▀░▀░▀░▀▀▀",
     ].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\n${box(intro)}\n`;
+    return `${logo.join("\n")}\n${subtitle}\n\n${box(intro)}\n\n`;
 }
 export function renderInitSection(title, description) {
     const header = color(`[${title}]`, "33");
-    return `${header}\n${description}\n`;
+    return `${header}\n${description}\n\n`;
 }

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

@@ -10,7 +10,7 @@ export type InitExecutionConfig = {
     handoff_conditions: string[];
     unsafe_actions_requiring_explicit_user_ok: string[];
 };
-export declare function ensureAgentplaneDirs(agentplaneDir: string): Promise<void>;
+export declare function ensureAgentplaneDirs(agentplaneDir: string, backend: "local" | "redmine"): Promise<void>;
 export declare function writeInitConfig(opts: {
     agentplaneDir: string;
     gitRoot: string;
@@ -22,7 +22,7 @@ export declare function writeInitConfig(opts: {
     execution: InitExecutionConfig;
 }): Promise<void>;
 export declare function writeBackendStubs(opts: {
-    localBackendPath: string;
-    redmineBackendPath: string;
+    backend: "local" | "redmine";
+    backendPath: string;
 }): Promise<void>;
 //# sourceMappingURL=write-config.d.ts.map

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":"AAOA,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,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;IAC/B,SAAS,EAAE,mBAAmB,CAAC;CAChC,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBhB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;CAC5B,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBhB"}
+{"version":3,"file":"write-config.d.ts","sourceRoot":"","sources":["../../../../../src/cli/run-cli/commands/init/write-config.ts"],"names":[],"mappings":"AAOA,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,CAiBhB;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

@@ -2,13 +2,13 @@ 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) {
+export async function ensureAgentplaneDirs(agentplaneDir, backend) {
     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 });
+    await mkdir(path.join(agentplaneDir, "backends"), { recursive: true });
+    await mkdir(path.join(agentplaneDir, "backends", backend), { recursive: true });
 }
 export async function writeInitConfig(opts) {
     const rawConfig = defaultConfig();
@@ -30,13 +30,10 @@ export async function writeBackendStubs(opts) {
         id: "redmine",
         version: 1,
         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);
+    const payload = opts.backend === "redmine" ? redmineBackendPayload : localBackendPayload;
+    await writeJsonStableIfChanged(opts.backendPath, payload);
 }

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

@@ -0,0 +1,4 @@
+export declare function ensureInitRedmineEnvTemplate(opts: {
+    gitRoot: string;
+}): Promise<void>;
+//# sourceMappingURL=write-env.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"write-env.d.ts","sourceRoot":"","sources":["../../../../../src/cli/run-cli/commands/init/write-env.ts"],"names":[],"mappings":"AAkEA,wBAAsB,4BAA4B,CAAC,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAkC3F"}

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

@@ -0,0 +1,89 @@
+import path from "node:path";
+import { readFile } from "node:fs/promises";
+import { writeTextIfChanged } from "../../../../shared/write-if-changed.js";
+const REDMINE_ENV_TEMPLATE = [
+    {
+        key: "AGENTPLANE_REDMINE_URL",
+        value: "https://redmine.example",
+        comment: "Redmine base URL.",
+        required: true,
+    },
+    {
+        key: "AGENTPLANE_REDMINE_API_KEY",
+        value: "replace-me",
+        comment: "Redmine API key.",
+        required: true,
+    },
+    {
+        key: "AGENTPLANE_REDMINE_PROJECT_ID",
+        value: "replace-me",
+        comment: "Project identifier (numeric ID or project slug).",
+        required: true,
+    },
+    {
+        key: "AGENTPLANE_REDMINE_OWNER_AGENT",
+        value: "REDMINE",
+        comment: "Optional default owner agent.",
+        required: false,
+    },
+    {
+        key: "AGENTPLANE_REDMINE_ASSIGNEE_ID",
+        value: "",
+        comment: "Optional assignee numeric ID.",
+        required: false,
+    },
+];
+async function readTextIfExists(filePath) {
+    try {
+        return await readFile(filePath, "utf8");
+    }
+    catch (err) {
+        const code = err?.code;
+        if (code === "ENOENT")
+            return null;
+        throw err;
+    }
+}
+function collectDefinedEnvKeys(dotEnvText) {
+    const keys = new Set();
+    for (const line of dotEnvText.split(/\r?\n/u)) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#"))
+            continue;
+        const match = /^([A-Za-z_][A-Za-z0-9_]*)\s*=/u.exec(trimmed);
+        if (match?.[1])
+            keys.add(match[1]);
+    }
+    return keys;
+}
+export async function ensureInitRedmineEnvTemplate(opts) {
+    const dotEnvPath = path.join(opts.gitRoot, ".env");
+    const existing = (await readTextIfExists(dotEnvPath)) ?? "";
+    const definedKeys = collectDefinedEnvKeys(existing);
+    const missing = REDMINE_ENV_TEMPLATE.filter((entry) => !definedKeys.has(entry.key));
+    if (missing.length === 0)
+        return;
+    const required = missing.filter((item) => item.required);
+    const optional = missing.filter((item) => !item.required);
+    const requiredLines = required.flatMap((entry) => [
+        `# ${entry.comment}`,
+        `${entry.key}=${entry.value}`,
+    ]);
+    const optionalLines = optional.length === 0
+        ? []
+        : [
+            "",
+            "# Optional values:",
+            ...optional.flatMap((entry) => [`# ${entry.comment}`, `${entry.key}=${entry.value}`]),
+        ];
+    const lines = [
+        "# agentplane: redmine backend configuration",
+        "# Required values:",
+        ...requiredLines,
+        ...optionalLines,
+    ];
+    const block = `${lines.join("\n")}\n`;
+    const prefix = existing.length > 0 && !existing.endsWith("\n") ? "\n\n" : existing.length > 0 ? "\n" : "";
+    const next = `${existing}${prefix}${block}`;
+    await writeTextIfChanged(dotEnvPath, next);
+}

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

@@ -1 +1 @@
-{"version":3,"file":"write-gitignore.d.ts","sourceRoot":"","sources":["../../../../../src/cli/run-cli/commands/init/write-gitignore.ts"],"names":[],"mappings":"AAgCA,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,uBAAuB,EAAE,OAAO,CAAC;CAClC,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBhB"}
+{"version":3,"file":"write-gitignore.d.ts","sourceRoot":"","sources":["../../../../../src/cli/run-cli/commands/init/write-gitignore.ts"],"names":[],"mappings":"AAiCA,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,uBAAuB,EAAE,OAAO,CAAC;CAClC,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBhB"}

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

@@ -14,6 +14,7 @@ async function readTextIfExists(filePath) {
 }
 const RUNTIME_IGNORE_LINES = [
     "# agentplane: ignore runtime/transient workspace artifacts",
+    ".env",
     ".agentplane/worktrees",
     ".agentplane/cache",
     ".agentplane/recipes-cache",

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;AAqBtE,KAAK,gBAAgB,GAAG,cAAc,GAAG,UAAU,GAAG,YAAY,CAAC;AAuEnE,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,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;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,CA2K5C,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;AAsBtE,KAAK,gBAAgB,GAAG,cAAc,GAAG,UAAU,GAAG,YAAY,CAAC;AAuEnE,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,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;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,CA2K5C,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,cAAc,CAAC,UAAU,CACmB,CAAC"}

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

@@ -16,6 +16,7 @@ import { maybeInstallBundledRecipes } from "./init/recipes.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";
 function buildInitExecutionProfile(profile, opts) {
     const shared = {
@@ -305,41 +306,56 @@ async function cmdInit(opts) {
         });
     }
     if (isInteractive) {
+        const askChoice = async (label, choices, defaultValue) => {
+            const result = await promptChoice(`\n${label}`, choices, defaultValue);
+            process.stdout.write("\n");
+            return result;
+        };
+        const askYesNo = async (label, defaultValue) => {
+            const result = await promptYesNo(`\n${label}`, defaultValue);
+            process.stdout.write("\n");
+            return result;
+        };
+        const askInput = async (label) => {
+            const result = await promptInput(`\n${label}`);
+            process.stdout.write("\n");
+            return result;
+        };
         process.stdout.write(renderInitWelcome());
         process.stdout.write(renderInitSection("Workflow", "Choose how branches/backends/approvals should be initialized for this repository."));
         ide = flags.ide ?? defaults.ide;
         if (!flags.workflow) {
-            const choice = await promptChoice("Workflow mode", ["direct", "branch_pr"], workflow);
+            const choice = await askChoice("Workflow mode", ["direct", "branch_pr"], workflow);
             workflow = choice === "branch_pr" ? "branch_pr" : "direct";
         }
         if (!flags.backend) {
-            const choice = await promptChoice("Task backend", ["local", "redmine"], backend);
+            const choice = await askChoice("Task backend", ["local", "redmine"], backend);
             backend = choice === "redmine" ? "redmine" : "local";
         }
         if (flags.hooks === undefined) {
-            hooks = await promptYesNo("Install managed git hooks now?", hooks);
+            hooks = await askYesNo("Install managed git hooks now?", hooks);
         }
         process.stdout.write(renderInitSection("Execution Profile", "Set default autonomy/effort for agents. You can change this later in config."));
         if (!flags.executionProfile) {
-            executionProfile = (await promptChoice("Execution profile", ["conservative", "balanced", "aggressive"], executionProfile));
+            executionProfile = (await askChoice("Execution profile", ["conservative", "balanced", "aggressive"], executionProfile));
         }
         if (flags.strictUnsafeConfirm === undefined) {
-            strictUnsafeConfirm = await promptYesNo("Require strict explicit confirmation for extra unsafe actions?", strictUnsafeConfirm);
+            strictUnsafeConfirm = await askYesNo("Require strict explicit confirmation for extra unsafe actions?", strictUnsafeConfirm);
         }
         process.stdout.write(renderInitSection("Approvals", "Control whether plan/network/verification actions require explicit approval by default."));
         if (flags.requirePlanApproval === undefined) {
-            requirePlanApproval = await promptYesNo("Require plan approval before work starts?", requirePlanApproval);
+            requirePlanApproval = await askYesNo("Require plan approval before work starts?", requirePlanApproval);
         }
         if (flags.requireNetworkApproval === undefined) {
-            requireNetworkApproval = await promptYesNo("Require explicit approval for network actions?", requireNetworkApproval);
+            requireNetworkApproval = await askYesNo("Require explicit approval for network actions?", requireNetworkApproval);
         }
         if (flags.requireVerifyApproval === undefined) {
-            requireVerifyApproval = await promptYesNo("Require explicit approval before recording verification?", requireVerifyApproval);
+            requireVerifyApproval = await askYesNo("Require explicit approval before recording verification?", requireVerifyApproval);
         }
         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 promptInput("Install optional recipes (comma separated, or none): ");
+            const answer = await askInput("Install optional recipes (comma separated, or none): ");
             recipes = answer
                 ? answer
                     .split(",")
@@ -383,10 +399,9 @@ async function cmdInit(opts) {
             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"),
+            path.join(resolved.agentplaneDir, "backends", backend),
         ];
-        const initFiles = [configPath, localBackendPath, redmineBackendPath];
+        const initFiles = [configPath, backendPath];
         const conflicts = await collectInitConflicts({ initDirs, initFiles });
         await handleInitConflicts({
             gitRoot: resolved.gitRoot,
@@ -394,7 +409,7 @@ async function cmdInit(opts) {
             backup: flags.backup === true,
             force: flags.force === true,
         });
-        await ensureAgentplaneDirs(resolved.agentplaneDir);
+        await ensureAgentplaneDirs(resolved.agentplaneDir, backend);
         const execution = buildInitExecutionProfile(executionProfile, { strictUnsafeConfirm });
         await writeInitConfig({
             agentplaneDir: resolved.agentplaneDir,
@@ -406,7 +421,10 @@ async function cmdInit(opts) {
             requireVerifyApproval,
             execution,
         });
-        await writeBackendStubs({ localBackendPath, redmineBackendPath });
+        await writeBackendStubs({ backend, backendPath });
+        if (backend === "redmine") {
+            await ensureInitRedmineEnvTemplate({ gitRoot: resolved.gitRoot });
+        }
         const { installPaths } = await ensureAgentsFiles({
             gitRoot: resolved.gitRoot,
             agentplaneDir: resolved.agentplaneDir,
@@ -418,6 +436,7 @@ async function cmdInit(opts) {
             gitRoot: resolved.gitRoot,
             includeAgentPromptFiles: flags.gitignoreAgents === true,
         });
+        installPaths.push(".gitignore");
         if (flags.gitignoreAgents) {
             await setPinnedBaseBranch({
                 cwd: resolved.gitRoot,
@@ -427,6 +446,7 @@ async function cmdInit(opts) {
         }
         if (hooks) {
             await cmdHooksInstall({ cwd: opts.cwd, rootOverride: opts.rootOverride, quiet: true });
+            installPaths.push(".agentplane/bin/agentplane");
         }
         const ideRes = await maybeSyncIde({
             cwd: opts.cwd,

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;AAS1E,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;AA0KnD,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,kBAAkB,CAwE5D,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,cAAc,CAAC,kBAAkB,CA+H9D,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;AAuOnD,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,kBAAkB,CAwE5D,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,cAAc,CAAC,kBAAkB,CA6H9D,CAAC"}

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

@@ -1,11 +1,12 @@
 import { readFile, writeFile, readdir } from "node:fs/promises";
 import path from "node:path";
-import { resolveProject } from "@agentplaneorg/core";
+import { resolveProject, loadConfig } from "@agentplaneorg/core";
 import { usageError } from "../../cli/spec/errors.js";
 import { exitCodeForError } from "../../cli/exit-codes.js";
 import { CliError } from "../../shared/errors.js";
 import { execFileAsync, gitEnv } from "../shared/git.js";
 import { GitContext } from "../shared/git-context.js";
+import { ensureNetworkApproved } from "../shared/network-approval.js";
 async function fileExists(p) {
     try {
         await readFile(p, "utf8");
@@ -154,6 +155,63 @@ async function maybeUpdateBunLockfile(gitRoot) {
         });
     }
 }
+async function ensureCleanTrackedTree(gitRoot) {
+    const { stdout } = await execFileAsync("git", ["status", "--short", "--untracked-files=no"], {
+        cwd: gitRoot,
+        env: gitEnv(),
+        maxBuffer: 10 * 1024 * 1024,
+    });
+    const dirty = String(stdout ?? "")
+        .split(/\r?\n/u)
+        .map((line) => line.trimEnd())
+        .filter((line) => line.length > 0);
+    if (dirty.length === 0)
+        return;
+    throw new CliError({
+        exitCode: exitCodeForError("E_GIT"),
+        code: "E_GIT",
+        message: "Release apply requires a clean tracked working tree.\n" +
+            `Found tracked changes:\n${dirty.map((line) => `  ${line}`).join("\n")}`,
+    });
+}
+async function ensureTagDoesNotExist(gitRoot, tag) {
+    try {
+        await execFileAsync("git", ["rev-parse", "-q", "--verify", `refs/tags/${tag}`], {
+            cwd: gitRoot,
+            env: gitEnv(),
+        });
+        throw new CliError({
+            exitCode: exitCodeForError("E_GIT"),
+            code: "E_GIT",
+            message: `Tag already exists: ${tag}`,
+        });
+    }
+    catch (err) {
+        const code = err?.code;
+        if (code !== 1)
+            throw err;
+    }
+}
+async function ensureNpmVersionsAvailable(gitRoot, version) {
+    const scriptPath = path.join(gitRoot, "scripts", "check-npm-version-availability.mjs");
+    try {
+        await execFileAsync("node", [scriptPath, "--version", version], {
+            cwd: gitRoot,
+            env: process.env,
+            maxBuffer: 10 * 1024 * 1024,
+        });
+    }
+    catch (err) {
+        const details = String(err?.stderr ?? "").trim();
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: `Pre-publish npm check failed for version ${version}. ` +
+                "Ensure this version is not already published for @agentplaneorg/core and agentplane." +
+                (details ? `\n\n${details}` : ""),
+        });
+    }
+}
 export const releaseApplySpec = {
     id: ["release", "apply"],
     group: "Release",
@@ -276,6 +334,18 @@ export const runReleaseApply = async (ctx, flags) => {
         });
     }
     const git = new GitContext({ gitRoot });
+    await ensureCleanTrackedTree(gitRoot);
+    await ensureTagDoesNotExist(gitRoot, plan.nextTag);
+    if (flags.push) {
+        const loaded = await loadConfig(resolved.agentplaneDir);
+        await ensureNetworkApproved({
+            config: loaded.config,
+            yes: flags.yes,
+            reason: "release apply --push validates npm version availability and pushes over network",
+            interactive: Boolean(process.stdin.isTTY),
+        });
+        await ensureNpmVersionsAvailable(gitRoot, plan.nextVersion);
+    }
     if (coreVersion === plan.prevVersion) {
         await Promise.all([
             replacePackageVersionInFile(corePkgPath, plan.nextVersion),
@@ -309,23 +379,6 @@ export const runReleaseApply = async (ctx, flags) => {
         const subject = `✨ release: ${plan.nextTag}`;
         await git.commit({ message: subject, env: cleanHookEnv() });
     }
-    // Create tag (idempotency: refuse to overwrite).
-    try {
-        await execFileAsync("git", ["rev-parse", "-q", "--verify", `refs/tags/${plan.nextTag}`], {
-            cwd: gitRoot,
-            env: gitEnv(),
-        });
-        throw new CliError({
-            exitCode: exitCodeForError("E_GIT"),
-            code: "E_GIT",
-            message: `Tag already exists: ${plan.nextTag}`,
-        });
-    }
-    catch (err) {
-        const code = err?.code;
-        if (code !== 1)
-            throw err;
-    }
     await execFileAsync("git", ["tag", plan.nextTag], { cwd: gitRoot, env: gitEnv() });
     process.stdout.write(`Release tag created: ${plan.nextTag}\n`);
     if (flags.push) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentplane",
-  "version": "0.2.14",
+  "version": "0.2.17",
   "description": "Agent Plane CLI for task workflows, recipes, and project automation.",
   "keywords": [
     "agentplane",