@felixdotgo/aidlc-kit 0.1.1 → 0.3.0

package/dist/src/cli/prompt.js

@@ -0,0 +1,66 @@
+/**
+ * Interactive layer: TTY detection, dynamic @inquirer/prompts loading, and the
+ * prompting flows (loop configuration, MCP setup selections, confirmations).
+ * Parsing of argv into options happens in ./argv.ts and ./options.ts.
+ */
+import { stdin, stdout } from "node:process";
+import { LOOP_PROVIDERS } from "../model.js";
+import { validateLoopConfig } from "../profiles.js";
+import { loopSelection, mcpArgSelections, parseWorkerMapping } from "./options.js";
+export const interactive = () => Boolean(stdin.isTTY && stdout.isTTY);
+const prompts = async () => import("@inquirer/prompts");
+export const chooseLoop = async (args, upgrade) => {
+    let { mode, lead: leadArg, workers: workersArg } = loopSelection(args);
+    if (!mode && (leadArg || workersArg))
+        throw new Error("--loop-lead and --loop-workers require --loop-mode");
+    if (!mode && interactive()) {
+        const { select } = await prompts();
+        mode = await select({ message: "Loop execution mode", choices: [
+                ...(upgrade ? [{ name: "Keep existing loop configuration", value: "keep" }] : []),
+                { name: "Off", value: "off" }, { name: "Local", value: "local" }, { name: "Fleet", value: "fleet" }
+            ] });
+    }
+    if (!mode || mode === "keep")
+        return undefined;
+    if (mode === "off") {
+        if (leadArg || workersArg)
+            throw new Error("Disabled loop cannot specify agents");
+        return validateLoopConfig({ mode });
+    }
+    let lead = leadArg, rawWorkers = workersArg;
+    if (interactive() && (!lead || !rawWorkers)) {
+        const { select, input } = await prompts();
+        lead ??= await select({ message: "Lead agent", choices: LOOP_PROVIDERS.map((name) => ({ name, value: name })) });
+        rawWorkers ??= await input({ message: "Workers (id=provider, comma separated)", default: "codex-worker=codex,claude-worker=claude" });
+    }
+    if (!lead || !rawWorkers)
+        throw new Error("An enabled loop requires --loop-lead and --loop-workers");
+    return validateLoopConfig({ mode, agents: { lead, workers: parseWorkerMapping(rawWorkers) } });
+};
+export const mcpSetupSelections = async (args) => {
+    const selected = mcpArgSelections(args);
+    if ((!selected.deployment || !selected.storage || !selected.bind || !selected.workspace) && !interactive())
+        throw new Error("mcp setup outside a TTY requires --deployment, --storage, --bind and --workspace");
+    if (interactive()) {
+        const { input, select, checkbox } = await prompts();
+        selected.deployment ??= await select({ message: "State service deployment", choices: [{ name: "Docker on this machine", value: "docker" }, { name: "Remote service (configure endpoint later)", value: "remote" }] });
+        selected.storage ??= await select({ message: "Database", choices: [{ name: "SQLite (local Docker volume)", value: "sqlite" }, { name: "PostgreSQL (multi-host production)", value: "postgres" }] });
+        selected.bind ??= await select({ message: "Network binding", choices: [{ name: "localhost only", value: "localhost" }, { name: "network (requires token/TLS)", value: "network" }] });
+        selected.workspace ??= await input({ message: "Workspace ID", default: "default", required: true });
+        if (!selected.providers.length)
+            selected.providers = await checkbox({ message: "Project-management connectors to configure", choices: ["jira", "trello", "github-issues"].map((value) => ({ name: value, value })) });
+    }
+    if (!Number.isInteger(selected.pollMs) || selected.pollMs < 1_000 || selected.pollMs > 3_600_000)
+        throw new Error("--poll-ms must be an integer from 1000 to 3600000");
+    return selected;
+};
+export const confirmGeneral = async (options, operation) => {
+    if (options.dryRun)
+        return false;
+    if (options.yes)
+        return true;
+    if (!interactive())
+        return false;
+    const { confirm } = await prompts();
+    return confirm({ message: `${operation} this plan?`, default: false });
+};

package/dist/src/cli.js

@@ -1,96 +1,16 @@
 #!/usr/bin/env node
-import { stdin, stdout } from "node:process";
-import { spawnSync } from "node:child_process";
-import { resolve, join } from "node:path";
-import { fileURLToPath } from "node:url";
-import { installableAdapters } from "./adapters.js";
-import { applyPlan, detectedAgents, doctor, formatPlan, planInit, planUninstall, selectAgents, status } from "./installer.js";
-import { LOOP_PROVIDERS } from "./model.js";
-import { loadProjectConfig, resolveProfiles, validateLoopConfig } from "./profiles.js";
+import { resolvedAdapters } from "./adapters.js";
+import { assertKnownOptions, flags, INIT_FLAGS, rootArg, UNINSTALL_FLAGS, UPGRADE_FLAGS, usage } from "./cli/argv.js";
+import { runDoctor, runLoopCommand, runMcp, runProfile, runStatus, runUi } from "./cli/commands.js";
+import { recordInstallerCli } from "./cli/loop-launcher.js";
+import { initOptions } from "./cli/options.js";
+import { chooseLoop, confirmGeneral, interactive } from "./cli/prompt.js";
+import { applyPlan, detectedAgents, formatPlan, planInit, planUninstall, selectAgents } from "./installer.js";
 import { applyUpgrade, planUpgrade } from "./upgrade.js";
 import { packageVersion } from "./workflow.js";
-import { applyMcpSetup, planMcpSetup } from "./mcp-setup.js";
-const usage = `Usage:
-  npx @felixdotgo/aidlc-kit init [path] [--agent <name[,name]> | --all] [--loop-mode off|local|fleet] [--loop-lead ${LOOP_PROVIDERS.join("|")}] [--loop-workers <id=provider,...>] [--yes] [--dry-run] [--force]
-  npx @felixdotgo/aidlc-kit upgrade [path] [--loop-mode off|local|fleet] [--loop-lead ${LOOP_PROVIDERS.join("|")}] [--loop-workers <id=provider,...>] [--dry-run]
-  npx @felixdotgo/aidlc-kit uninstall [path] [--yes] [--dry-run]
-  npx @felixdotgo/aidlc-kit status [path]
-  npx @felixdotgo/aidlc-kit doctor [path] [--strict]
-  npx @felixdotgo/aidlc-kit profile validate [path]
-  npx @felixdotgo/aidlc-kit loop start|status|resume [--task-id ID] [--root PATH] [--mode local|fleet]
-  npx @felixdotgo/aidlc-kit mcp setup [path] [--dry-run] [--yes] [--storage sqlite|postgres] [--deployment docker|remote] [--bind localhost|network] [--workspace <id>] [--poll-ms <n>] [--enable]`;
-const interactive = () => Boolean(stdin.isTTY && stdout.isTTY);
+/* Kept in this file: test/unit/cli.test.ts pins these prompt sources (and the upgrade boundary strings below) to src/cli.ts; the shared interactive flows live in ./cli/prompt.ts. */
 const prompts = async () => import("@inquirer/prompts");
-/* --- Argv helpers --------------------------------------------------------- */
-const value = (args, name) => {
-    const index = args.indexOf(name);
-    return index < 0 ? undefined : args[index + 1];
-};
-const flags = (args) => new Set(args.filter((item) => item.startsWith("--")));
-const valueFlags = new Set(["--agent", "--storage", "--deployment", "--bind", "--workspace", "--poll-ms", "--token-env", "--providers", "--loop-mode", "--loop-lead", "--loop-workers"]);
-const COMMAND_KEYWORDS = ["init", "upgrade", "uninstall", "status", "doctor", "validate", "run", "list"];
-const positional = (args) => {
-    const result = [];
-    for (let index = 0; index < args.length; index += 1) {
-        if (valueFlags.has(args[index])) {
-            index += 1;
-            continue;
-        }
-        if (!args[index].startsWith("--"))
-            result.push(args[index]);
-    }
-    return result;
-};
-const rootArg = (args, fallback = ".") => positional(args).find((item) => !COMMAND_KEYWORDS.includes(item)) ?? fallback;
-/* --- Loop configuration --------------------------------------------------- */
-const parseWorkerMapping = (rawWorkers) => {
-    const workers = Object.create(null);
-    for (const entry of rawWorkers.split(",")) {
-        const parts = entry.split("=");
-        if (parts.length !== 2 || !parts[0] || !parts[1] || Object.hasOwn(workers, parts[0]))
-            throw new Error("Invalid or duplicate loop worker mapping");
-        workers[parts[0]] = parts[1];
-    }
-    return workers;
-};
-const chooseLoop = async (args, upgrade) => {
-    let mode = value(args, "--loop-mode");
-    const leadArg = value(args, "--loop-lead"), workersArg = value(args, "--loop-workers");
-    if (!mode && (leadArg || workersArg))
-        throw new Error("--loop-lead and --loop-workers require --loop-mode");
-    if (!mode && interactive()) {
-        const { select } = await prompts();
-        mode = await select({ message: "Loop execution mode", choices: [
-                ...(upgrade ? [{ name: "Keep existing loop configuration", value: "keep" }] : []),
-                { name: "Off", value: "off" }, { name: "Local", value: "local" }, { name: "Fleet", value: "fleet" }
-            ] });
-    }
-    if (!mode || mode === "keep")
-        return undefined;
-    if (mode === "off") {
-        if (leadArg || workersArg)
-            throw new Error("Disabled loop cannot specify agents");
-        return validateLoopConfig({ mode });
-    }
-    let lead = leadArg, rawWorkers = workersArg;
-    if (interactive() && (!lead || !rawWorkers)) {
-        const { select, input } = await prompts();
-        lead ??= await select({ message: "Lead agent", choices: LOOP_PROVIDERS.map((name) => ({ name, value: name })) });
-        rawWorkers ??= await input({ message: "Workers (id=provider, comma separated)", default: "codex-worker=codex,claude-worker=claude" });
-    }
-    if (!lead || !rawWorkers)
-        throw new Error("An enabled loop requires --loop-lead and --loop-workers");
-    return validateLoopConfig({ mode, agents: { lead, workers: parseWorkerMapping(rawWorkers) } });
-};
-/* --- Option builders and shared flows -------------------------------------- */
-const initOptions = (args) => ({
-    root: rootArg(args),
-    agents: (value(args, "--agent") ?? "").split(",").filter(Boolean),
-    all: flags(args).has("--all"),
-    dryRun: flags(args).has("--dry-run"),
-    yes: flags(args).has("--yes"),
-    force: flags(args).has("--force")
-});
+/* --- Agent selection and plan preview -------------------------------------- */
 const chooseAgents = async (options) => {
     const selected = selectAgents(options);
     if (selected.length)
@@ -101,7 +21,7 @@ const chooseAgents = async (options) => {
     if (!interactive())
         throw new Error(`Unable to select an agent automatically. Use --agent <name> or --all. Detected: ${detected.join(", ") || "none"}`);
     const { checkbox } = await prompts();
-    const choices = installableAdapters();
+    const choices = resolvedAdapters();
     const agents = await checkbox({
         message: "Select one or more agents",
         choices: choices.map((adapter) => ({
@@ -116,67 +36,9 @@ const preview = (operation, plan) => {
     console.log(`◆ ${operation} preview — changes have NOT been applied`);
     console.log(formatPlan(plan));
 };
-const confirmGeneral = async (options, operation) => {
-    if (options.dryRun)
-        return false;
-    if (options.yes)
-        return true;
-    if (!interactive())
-        return false;
-    const { confirm } = await prompts();
-    return confirm({ message: `${operation} this plan?`, default: false });
-};
-/* --- MCP setup options ----------------------------------------------------- */
-const mcpSetupSelections = async (args) => {
-    const selected = {
-        deployment: value(args, "--deployment"),
-        storage: value(args, "--storage"),
-        bind: value(args, "--bind"),
-        workspace: value(args, "--workspace"),
-        pollMs: Number(value(args, "--poll-ms") ?? 30_000),
-        tokenEnv: value(args, "--token-env") ?? "AIDLC_MCP_TOKEN",
-        providers: (value(args, "--providers") ?? "").split(",").filter(Boolean)
-    };
-    if ((!selected.deployment || !selected.storage || !selected.bind || !selected.workspace) && !interactive())
-        throw new Error("mcp setup outside a TTY requires --deployment, --storage, --bind and --workspace");
-    if (interactive()) {
-        const { input, select, checkbox } = await prompts();
-        selected.deployment ??= await select({ message: "State service deployment", choices: [{ name: "Docker on this machine", value: "docker" }, { name: "Remote service (configure endpoint later)", value: "remote" }] });
-        selected.storage ??= await select({ message: "Database", choices: [{ name: "SQLite (local Docker volume)", value: "sqlite" }, { name: "PostgreSQL (multi-host production)", value: "postgres" }] });
-        selected.bind ??= await select({ message: "Network binding", choices: [{ name: "localhost only", value: "localhost" }, { name: "network (requires token/TLS)", value: "network" }] });
-        selected.workspace ??= await input({ message: "Workspace ID", default: "default", required: true });
-        if (!selected.providers.length)
-            selected.providers = await checkbox({ message: "Project-management connectors to configure", choices: ["jira", "trello", "github-issues"].map((value) => ({ name: value, value })) });
-    }
-    if (!Number.isInteger(selected.pollMs) || selected.pollMs < 1_000 || selected.pollMs > 3_600_000)
-        throw new Error("--poll-ms must be an integer from 1000 to 3600000");
-    return selected;
-};
-const mcpSetupOptions = async (args) => {
-    const selected = await mcpSetupSelections(args);
-    return { root: rootArg(args), template: join(fileURLToPath(new URL("../services/aidlc-coordination", import.meta.url))), dryRun: flags(args).has("--dry-run"), deployment: selected.deployment, storage: selected.storage, bind: selected.bind, workspace: selected.workspace, pollMs: selected.pollMs, tokenEnv: selected.tokenEnv, providers: selected.providers, enable: flags(args).has("--enable") };
-};
-/* --- Command handlers ------------------------------------------------------ */
-const runLoopCommand = (args) => {
-    const action = args[0];
-    if (!["start", "status", "resume"].includes(action))
-        throw new Error("Expected loop start, status, or resume");
-    const parsed = new Map();
-    for (let index = 1; index < args.length; index += 2) {
-        const key = args[index], entry = args[index + 1];
-        if (!["--task-id", "--root", "--mode"].includes(key) || !entry || entry.startsWith("--") || parsed.has(key))
-            throw new Error("Invalid or duplicate loop option");
-        parsed.set(key, entry);
-    }
-    const root = resolve(parsed.get("--root") ?? ".");
-    const script = join(root, ".agents", "aidlc", "scripts", "loop-entry.mjs");
-    const child = spawnSync(process.execPath, [script, action, parsed.get("--task-id") ?? "", root, parsed.get("--mode") ?? ""], { stdio: "inherit" });
-    if (child.error)
-        throw child.error;
-    if (child.status !== 0)
-        process.exitCode = child.status ?? 1;
-};
+/* --- Command handlers that consume the pinned prompts above ----------------- */
 const runInit = async (args) => {
+    assertKnownOptions(args, INIT_FLAGS);
     const options = { ...await chooseAgents(initOptions(args)), loop: await chooseLoop(args, false) };
     const plan = planInit(options);
     preview("INIT", plan);
@@ -192,8 +54,10 @@ const runInit = async (args) => {
         applyPlan(options.root, plan);
         console.log("Installed local AI-DLC workflow assets.");
     }
+    recordInstallerCli(options.root);
 };
 const runUninstall = async (args) => {
+    assertKnownOptions(args, UNINSTALL_FLAGS);
     const options = initOptions(args);
     const plan = planUninstall(options.root);
     preview("UNINSTALL", plan);
@@ -203,6 +67,7 @@ const runUninstall = async (args) => {
     console.log("Removed eligible managed assets; project config and state were preserved.");
 };
 const runUpgrade = async (args) => {
+    assertKnownOptions(args, UPGRADE_FLAGS);
     if (flags(args).has("--yes") || flags(args).has("--force"))
         throw new Error("upgrade does not support --yes or --force; apply requires a human interactive TTY confirmation");
     const root = rootArg(args);
@@ -220,49 +85,21 @@ const runUpgrade = async (args) => {
         throw new Error("Upgrade confirmation did not match the target version");
     const result = applyUpgrade(root, plan);
     console.log(`Upgrade complete. Backup: ${result.backup}; changed: ${result.changed}`);
+    recordInstallerCli(root);
 };
-const runMcpSetup = async (args) => {
-    const options = await mcpSetupOptions(args.slice(1));
-    const plan = planMcpSetup(options);
-    console.log(`◆ MCP SETUP preview — ${options.dryRun ? "no files will be written" : "review before applying"}`);
-    console.log(JSON.stringify(plan, null, 2));
-    if (options.dryRun)
-        return;
-    if (!await confirmGeneral({ ...initOptions(args), root: options.root }, "Apply MCP setup"))
-        return;
-    applyMcpSetup(options);
-    console.log(`MCP setup written to ${plan.target}. MCP remains ${options.enable ? "enabled" : "disabled"}; start Docker explicitly with docker compose --env-file .env -f ${join(plan.target, "compose.yaml")} up -d.`);
-};
+const runHelp = () => console.log(usage);
+const runVersion = () => console.log(packageVersion());
+const REGISTRY = { init: runInit, upgrade: runUpgrade, uninstall: runUninstall, status: runStatus, doctor: runDoctor, loop: runLoopCommand, ui: runUi, mcp: runMcp, profile: runProfile, version: runVersion, help: runHelp };
 const main = async () => {
-    const [command = "help", ...args] = process.argv.slice(2);
-    if (command === "help" || command === "--help")
+    const argv = process.argv.slice(2);
+    if (argv.includes("--version") || argv.includes("-v"))
+        return void console.log(packageVersion());
+    if (argv.includes("--help"))
         return void console.log(usage);
-    if (command === "loop")
-        return void runLoopCommand(args);
-    if (command === "status")
-        return void console.log(status(rootArg(args)));
-    if (command === "doctor") {
-        const result = doctor(rootArg(args), flags(args).has("--strict"));
-        console.log(result);
-        if (result.startsWith("ERROR:"))
-            process.exitCode = 1;
-        return;
-    }
-    if (command === "init")
-        return void await runInit(args);
-    if (command === "uninstall")
-        return void await runUninstall(args);
-    if (command === "upgrade")
-        return void await runUpgrade(args);
-    if (command === "mcp" && args[0] === "setup")
-        return void await runMcpSetup(args);
-    if (command === "profile" && args[0] === "validate") {
-        const root = rootArg(args.slice(1));
-        const config = loadProjectConfig(root);
-        const profiles = resolveProfiles(root, config.extends);
-        console.log(`OK: ${profiles.map((item) => item.id).join(" → ")}`);
-        return;
-    }
-    throw new Error(`Unknown command: ${command}`);
+    const [command = "help", ...args] = argv;
+    const handler = Object.hasOwn(REGISTRY, command) ? REGISTRY[command] : undefined;
+    if (!handler)
+        throw new Error(`Unknown command: ${command}`);
+    return void await handler(args);
 };
 main().catch((error) => { console.error(`aidlc-kit: ${error instanceof Error ? error.message : String(error)}`); process.exitCode = 1; });

package/dist/src/gate.js

@@ -1,6 +1,6 @@
 import { existsSync, readFileSync } from "node:fs";
 import { resolveProjectPathWithoutSymlinks } from "./project-path.js";
-import { hasAreaVerification, hasReview, isLegacyG2Wait, nextAction, repairBounds, transitionDiagnostics, transitionTask } from "./state.js";
+import { hasAreaVerification, hasReview, isLegacyG2Wait, loopPartitionStrict, nextAction, partitionDiagnostics, repairBounds, transitionDiagnostics, transitionTask } from "./state.js";
 const safeArtifactTarget = (root, path) => resolveProjectPathWithoutSymlinks(root, path, "Unsafe artifact path", "Artifact path crosses a symlink");
 const artifactContent = (root, path) => {
     if (!path)
@@ -40,6 +40,7 @@ const reviewGateDiagnostics = (root, task) => {
     if (content !== undefined)
         for (const heading of missingHeadings(content, ["## 🧩 Solution per affected area", "## 📌 Spec traceability", "## 🔗 Cross-service contracts", "## ⚠️ Risks / edge cases"]))
             diagnostics.push({ level: "ERROR", code: "DESIGN_HEADING", message: `Design is missing ${heading}` });
+    diagnostics.push(...partitionDiagnostics(task, { strict: loopPartitionStrict(root) }));
     return diagnostics;
 };
 const codeReviewGateDiagnostics = (root, task) => {
@@ -82,7 +83,7 @@ export const checkGate = (root, state, taskId, gate) => {
         diagnostics.push(...reviewGateDiagnostics(root, task));
     if (gate === "G2_codereview")
         diagnostics.push(...codeReviewGateDiagnostics(root, task));
-    if (!diagnostics.length)
+    if (!diagnostics.some((item) => item.level === "ERROR"))
         diagnostics.push({ level: "INFO", code: "GATE_OK", message: `${gate} checks passed for ${taskId}` });
     return diagnostics;
 };

package/dist/src/installer.d.ts

@@ -1,12 +1,8 @@
-import type { AgentId, FileSpec, InitOptions, LoopConfig, ManifestInventoryItem, PlannedWrite, WorkflowManifest } from "./model.js";
-/** Managed prompt blocks share a path across owners, so inventory keys carry the owner. */
-export declare const installedHashFor: (files: Record<string, ManifestInventoryItem> | undefined, spec: Pick<FileSpec, "path" | "owner" | "strategy">) => string | undefined;
-export declare const managedContentHash: (spec: Pick<FileSpec, "owner" | "strategy">, content: string) => string | undefined;
-export declare const readManifest: (root: string) => WorkflowManifest | undefined;
+import type { AgentId, InitOptions, PlannedWrite } from "./model.js";
+/** Manifest reading lives in the managed-planning core; this export path stays stable for existing importers. */
+export { readManifest } from "./managed-planning.js";
 export declare const detectedAgents: (root: string) => AgentId[];
 export declare const selectAgents: (options: Pick<InitOptions, "root" | "agents" | "all">) => AgentId[];
-/** Include an explicitly selected loop config in the same preview/transaction as setup. */
-export declare const planLoopSelection: (plan: PlannedWrite[], selection?: LoopConfig) => void;
 /** Plans an init transaction: managed workflow files, manifest, and project-owned files. */
 export declare const planInit: (options: InitOptions) => PlannedWrite[];
 /** Applies a planned init/uninstall transaction to disk. */
@@ -14,7 +10,18 @@ export declare const applyPlan: (root: string, plan: PlannedWrite[]) => void;
 export declare const formatPlan: (plan: PlannedWrite[]) => string;
 /** Plans an uninstall transaction that removes only unchanged managed assets. */
 export declare const planUninstall: (root: string) => PlannedWrite[];
+export declare const statusData: (root: string) => {
+    workflow: string;
+    installedVersion: string;
+    schema: string;
+    detectedAgents: string[];
+};
 /** Reports installed workflow version, schema, and detected agents. */
 export declare const status: (root: string) => string;
 /** Validates the installed workflow manifest and local config/state. */
 export declare const doctor: (root: string, strict?: boolean) => string;
+export declare const doctorData: (root: string, strict?: boolean) => {
+    level: "ok" | "warn" | "error";
+    message: string;
+    strict: boolean;
+};