@harness-forge/cli 0.1.0

package/dist/cli/commands/catalog.js

@@ -0,0 +1,142 @@
+import path from "node:path";
+import { loadBundleManifests, loadProfileManifests, loadTargetManifests } from "../../domain/manifests/index.js";
+import { loadInstallState, saveInstallState } from "../../domain/state/install-state.js";
+import { createInstallPlan } from "../../application/install/plan-install.js";
+import { applyInstall } from "../../application/install/apply-install.js";
+import { validateEnvironment } from "../../application/install/validate-environment.js";
+import { recommendBundles } from "../../application/recommendations/recommend-bundles.js";
+import { PACKAGE_ROOT, DEFAULT_WORKSPACE_ROOT, ValidationError } from "../../shared/index.js";
+import { toJson } from "../../infrastructure/diagnostics/reporter.js";
+import { loadTargetAdapter } from "../../domain/targets/adapter.js";
+function collect(value, previous) {
+    previous.push(value);
+    return previous;
+}
+function unique(values) {
+    return [...new Set(values)];
+}
+export function registerCatalogCommands(program) {
+    program
+        .command("catalog")
+        .option("--root <root>", "workspace root", DEFAULT_WORKSPACE_ROOT)
+        .option("--json", "json output", false)
+        .action(async (options) => {
+        const workspaceRoot = path.resolve(options.root);
+        const [bundles, profiles, targets, recommendations] = await Promise.all([
+            loadBundleManifests(PACKAGE_ROOT),
+            loadProfileManifests(PACKAGE_ROOT),
+            loadTargetManifests(PACKAGE_ROOT),
+            recommendBundles(workspaceRoot)
+        ]);
+        const result = { bundles, profiles, targets, recommendations, workspaceRoot, packageRoot: PACKAGE_ROOT };
+        console.log(options.json ? toJson(result) : JSON.stringify(result, null, 2));
+    });
+    program
+        .command("list")
+        .option("--root <root>", "workspace root", DEFAULT_WORKSPACE_ROOT)
+        .option("--json", "json output", false)
+        .action(async (options) => {
+        const workspaceRoot = path.resolve(options.root);
+        const [bundles, recommendations] = await Promise.all([
+            loadBundleManifests(PACKAGE_ROOT),
+            recommendBundles(workspaceRoot)
+        ]);
+        const result = {
+            installed: (await loadInstallState(workspaceRoot))?.installedBundles ?? [],
+            available: bundles.map((bundle) => bundle.id),
+            recommended: recommendations
+        };
+        console.log(options.json ? toJson(result) : JSON.stringify(result, null, 2));
+    });
+    program
+        .command("add")
+        .option("--target <target>", "target adapter to install into")
+        .option("--profile <profile>")
+        .option("--lang <lang>", "language bundle", collect, [])
+        .option("--framework <framework>", "framework bundle", collect, [])
+        .option("--with <capability>", "capability bundle", collect, [])
+        .option("--bundle <bundle>", "explicit bundle", collect, [])
+        .option("--root <root>", "workspace root", DEFAULT_WORKSPACE_ROOT)
+        .option("--dry-run", "show plan only", false)
+        .option("--yes", "apply plan", false)
+        .option("--json", "json output", false)
+        .action(async (options) => {
+        const workspaceRoot = path.resolve(options.root);
+        const state = await loadInstallState(workspaceRoot);
+        const targetId = options.target ?? state?.installedTargets[0];
+        if (!targetId) {
+            throw new ValidationError("Target is required for add until a baseline install exists.");
+        }
+        const warnings = await validateEnvironment(PACKAGE_ROOT, targetId);
+        const [bundles, profiles, target] = await Promise.all([
+            loadBundleManifests(PACKAGE_ROOT),
+            loadProfileManifests(PACKAGE_ROOT),
+            loadTargetAdapter(PACKAGE_ROOT, targetId)
+        ]);
+        const plan = createInstallPlan(PACKAGE_ROOT, {
+            targetId,
+            profileId: options.profile,
+            bundleIds: unique([...(state?.installedBundles ?? []), ...options.bundle]),
+            languageIds: options.lang,
+            frameworkIds: options.framework,
+            capabilityIds: options.with,
+            rootPath: workspaceRoot,
+            mode: options.yes && !options.dryRun ? "apply" : "dry-run"
+        }, bundles, profiles, target, { workspaceRoot });
+        plan.warnings.push(...warnings);
+        if (options.json) {
+            console.log(toJson(plan));
+            return;
+        }
+        console.log(JSON.stringify(plan, null, 2));
+        if (!options.dryRun && options.yes) {
+            const result = await applyInstall(workspaceRoot, plan);
+            console.log(result.messages.join("\n"));
+            console.log(`Guidance written to ${result.guidancePath}`);
+            console.log('Next: npx @harness-forge/cli shell setup --yes | npm install -g @harness-forge/cli');
+        }
+        else {
+            console.log('Preview only. Re-run with "--yes" to apply the plan.');
+        }
+    });
+    program
+        .command("remove")
+        .argument("<bundleId...>")
+        .option("--root <root>", "workspace root", DEFAULT_WORKSPACE_ROOT)
+        .option("--dry-run", "preview only", false)
+        .option("--yes", "apply removal to install state", false)
+        .option("--json", "json output", false)
+        .action(async (bundleIds, options) => {
+        const workspaceRoot = path.resolve(options.root);
+        const state = await loadInstallState(workspaceRoot);
+        if (!state) {
+            throw new ValidationError("No install state found. Install a baseline target before removing bundles.");
+        }
+        const removalSet = new Set(bundleIds);
+        const nextBundles = state.installedBundles.filter((bundleId) => !removalSet.has(bundleId));
+        const result = {
+            removed: bundleIds,
+            before: state.installedBundles,
+            after: nextBundles,
+            notes: [
+                "Bundle state can be removed automatically.",
+                "File-level cleanup remains conservative and may require a follow-up repair or reinstall."
+            ]
+        };
+        if (!options.dryRun && options.yes) {
+            await saveInstallState(workspaceRoot, {
+                ...state,
+                installedBundles: nextBundles,
+                timestamps: {
+                    ...state.timestamps,
+                    updatedAt: new Date().toISOString()
+                }
+            });
+        }
+        console.log(options.json ? toJson(result) : JSON.stringify(result, null, 2));
+        if (options.dryRun || !options.yes) {
+            console.log('Preview only. Re-run with "--yes" to persist the updated install state.');
+        }
+    });
+}
+//# sourceMappingURL=catalog.js.map

package/dist/cli/commands/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../../src/cli/commands/catalog.ts"],"names":[],"mappings":"AACA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACjH,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AACzF,OAAO,EAAE,iBAAiB,EAAE,MAAM,2CAA2C,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,mDAAmD,CAAC;AACxF,OAAO,EAAE,gBAAgB,EAAE,MAAM,wDAAwD,CAAC;AAC1F,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC9F,OAAO,EAAE,MAAM,EAAE,MAAM,8CAA8C,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAEpE,SAAS,OAAO,CAAC,KAAa,EAAE,QAAkB;IAChD,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,MAAM,CAAC,MAAgB;IAC9B,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,OAAO;SACJ,OAAO,CAAC,SAAS,CAAC;SAClB,MAAM,CAAC,eAAe,EAAE,gBAAgB,EAAE,sBAAsB,CAAC;SACjE,MAAM,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,CAAC;SACtC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACxB,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACjD,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,eAAe,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACtE,mBAAmB,CAAC,YAAY,CAAC;YACjC,oBAAoB,CAAC,YAAY,CAAC;YAClC,mBAAmB,CAAC,YAAY,CAAC;YACjC,gBAAgB,CAAC,aAAa,CAAC;SAChC,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC;QACzG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/E,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,MAAM,CAAC,eAAe,EAAE,gBAAgB,EAAE,sBAAsB,CAAC;SACjE,MAAM,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,CAAC;SACtC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACxB,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACjD,MAAM,CAAC,OAAO,EAAE,eAAe,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACnD,mBAAmB,CAAC,YAAY,CAAC;YACjC,gBAAgB,CAAC,aAAa,CAAC;SAChC,CAAC,CAAC;QACH,MAAM,MAAM,GAAG;YACb,SAAS,EAAE,CAAC,MAAM,gBAAgB,CAAC,aAAa,CAAC,CAAC,EAAE,gBAAgB,IAAI,EAAE;YAC1E,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7C,WAAW,EAAE,eAAe;SAC7B,CAAC;QAEF,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/E,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,KAAK,CAAC;SACd,MAAM,CAAC,mBAAmB,EAAE,gCAAgC,CAAC;SAC7D,MAAM,CAAC,qBAAqB,CAAC;SAC7B,MAAM,CAAC,eAAe,EAAE,iBAAiB,EAAE,OAAO,EAAE,EAAE,CAAC;SACvD,MAAM,CAAC,yBAAyB,EAAE,kBAAkB,EAAE,OAAO,EAAE,EAAE,CAAC;SAClE,MAAM,CAAC,qBAAqB,EAAE,mBAAmB,EAAE,OAAO,EAAE,EAAE,CAAC;SAC/D,MAAM,CAAC,mBAAmB,EAAE,iBAAiB,EAAE,OAAO,EAAE,EAAE,CAAC;SAC3D,MAAM,CAAC,eAAe,EAAE,gBAAgB,EAAE,sBAAsB,CAAC;SACjE,MAAM,CAAC,WAAW,EAAE,gBAAgB,EAAE,KAAK,CAAC;SAC5C,MAAM,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,CAAC;SACpC,MAAM,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,CAAC;SACtC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACxB,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACjD,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC,aAAa,CAAC,CAAC;QACpD,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,IAAI,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC;QAC9D,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,eAAe,CAAC,6DAA6D,CAAC,CAAC;QAC3F,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;QACnE,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACpD,mBAAmB,CAAC,YAAY,CAAC;YACjC,oBAAoB,CAAC,YAAY,CAAC;YAClC,iBAAiB,CAAC,YAAY,EAAE,QAAQ,CAAC;SAC1C,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,iBAAiB,CAC5B,YAAY,EACZ;YACE,QAAQ;YACR,SAAS,EAAE,OAAO,CAAC,OAAO;YAC1B,SAAS,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,gBAAgB,IAAI,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;YAC1E,WAAW,EAAE,OAAO,CAAC,IAAI;YACzB,YAAY,EAAE,OAAO,CAAC,SAAS;YAC/B,aAAa,EAAE,OAAO,CAAC,IAAI;YAC3B,QAAQ,EAAE,aAAa;YACvB,IAAI,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;SAC3D,EACD,OAAO,EACP,QAAQ,EACR,MAAM,EACN,EAAE,aAAa,EAAE,CAClB,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;QAEhC,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;YAC1B,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3C,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YACnC,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;YACvD,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YACxC,OAAO,CAAC,GAAG,CAAC,uBAAuB,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;YAC1D,OAAO,CAAC,GAAG,CAAC,oFAAoF,CAAC,CAAC;QACpG,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,sDAAsD,CAAC,CAAC;QACtE,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,QAAQ,CAAC,eAAe,CAAC;SACzB,MAAM,CAAC,eAAe,EAAE,gBAAgB,EAAE,sBAAsB,CAAC;SACjE,MAAM,CAAC,WAAW,EAAE,cAAc,EAAE,KAAK,CAAC;SAC1C,MAAM,CAAC,OAAO,EAAE,gCAAgC,EAAE,KAAK,CAAC;SACxD,MAAM,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,CAAC;SACtC,MAAM,CAAC,KAAK,EAAE,SAAmB,EAAE,OAAO,EAAE,EAAE;QAC7C,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACjD,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC,aAAa,CAAC,CAAC;QACpD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,eAAe,CAAC,4EAA4E,CAAC,CAAC;QAC1G,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;QACtC,MAAM,WAAW,GAAG,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC3F,MAAM,MAAM,GAAG;YACb,OAAO,EAAE,SAAS;YAClB,MAAM,EAAE,KAAK,CAAC,gBAAgB;YAC9B,KAAK,EAAE,WAAW;YAClB,KAAK,EAAE;gBACL,4CAA4C;gBAC5C,0FAA0F;aAC3F;SACF,CAAC;QAEF,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YACnC,MAAM,gBAAgB,CAAC,aAAa,EAAE;gBACpC,GAAG,KAAK;gBACR,gBAAgB,EAAE,WAAW;gBAC7B,UAAU,EAAE;oBACV,GAAG,KAAK,CAAC,UAAU;oBACnB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;iBACpC;aACF,CAAC,CAAC;QACL,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7E,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;YACnC,OAAO,CAAC,GAAG,CAAC,yEAAyE,CAAC,CAAC;QACzF,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/commands.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function registerCommandsCatalog(program: Command): void;
+//# sourceMappingURL=commands.d.ts.map

package/dist/cli/commands/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/commands.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA+B9D"}

package/dist/cli/commands/commands.js

@@ -0,0 +1,32 @@
+import path from "node:path";
+import { loadAgentCommandCatalog } from "../../application/runtime/command-catalog.js";
+import { PACKAGE_ROOT } from "../../shared/index.js";
+import { toJson } from "../../infrastructure/diagnostics/reporter.js";
+export function registerCommandsCatalog(program) {
+    program
+        .command("commands")
+        .option("--root <root>", "package content root", PACKAGE_ROOT)
+        .option("--json", "json output", false)
+        .action(async (options) => {
+        const contentRoot = path.resolve(options.root);
+        const catalog = await loadAgentCommandCatalog(contentRoot);
+        if (options.json) {
+            console.log(toJson(catalog));
+            return;
+        }
+        const lines = [
+            `Package: ${catalog.packageName}@${catalog.packageVersion}`,
+            "",
+            "CLI commands:"
+        ];
+        for (const entry of catalog.cliCommands) {
+            lines.push(`- ${entry.command}: ${entry.description}`);
+        }
+        lines.push("", "Recommended npm scripts:");
+        for (const entry of catalog.recommendedAgentCommands) {
+            lines.push(`- ${entry}`);
+        }
+        console.log(lines.join("\n"));
+    });
+}
+//# sourceMappingURL=commands.js.map

package/dist/cli/commands/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../../src/cli/commands/commands.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,uBAAuB,EAAE,MAAM,8CAA8C,CAAC;AACvF,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,8CAA8C,CAAC;AAEtE,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,OAAO;SACJ,OAAO,CAAC,UAAU,CAAC;SACnB,MAAM,CAAC,eAAe,EAAE,sBAAsB,EAAE,YAAY,CAAC;SAC7D,MAAM,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,CAAC;SACtC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACxB,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC/C,MAAM,OAAO,GAAG,MAAM,uBAAuB,CAAC,WAAW,CAAC,CAAC;QAE3D,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;YAC7B,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG;YACZ,YAAY,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,cAAc,EAAE;YAC3D,EAAE;YACF,eAAe;SAChB,CAAC;QAEF,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YACxC,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,OAAO,KAAK,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;QACzD,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,0BAA0B,CAAC,CAAC;QAC3C,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,wBAAwB,EAAE,CAAC;YACrD,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC;QAC3B,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/diff-install.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function registerDiffInstallCommands(program: Command): void;
+//# sourceMappingURL=diff-install.d.ts.map

package/dist/cli/commands/diff-install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-install.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/diff-install.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAyBlE"}

package/dist/cli/commands/diff-install.js

@@ -0,0 +1,31 @@
+import path from "node:path";
+import { createDiffInstallReport } from "../../application/maintenance/diff-install.js";
+import { appendEffectivenessSignal } from "../../infrastructure/observability/local-metrics-store.js";
+import { DEFAULT_WORKSPACE_ROOT } from "../../shared/index.js";
+import { toJson } from "../../infrastructure/diagnostics/reporter.js";
+export function registerDiffInstallCommands(program) {
+    program
+        .command("diff-install")
+        .option("--root <root>", "workspace root", DEFAULT_WORKSPACE_ROOT)
+        .option("--json", "json output", false)
+        .action(async (options) => {
+        const workspaceRoot = path.resolve(options.root);
+        const result = await createDiffInstallReport(workspaceRoot);
+        await appendEffectivenessSignal(workspaceRoot, {
+            signalType: "diff-install-run",
+            subjectId: "diff-install",
+            result: result.missing.length === 0 ? "success" : "failed",
+            recordedAt: new Date().toISOString(),
+            details: { missing: result.missing.length }
+        });
+        if (options.json) {
+            console.log(toJson(result));
+            return;
+        }
+        console.log(`Installed tracked paths: ${result.installed.length}`);
+        console.log(`Present paths: ${result.present.length}`);
+        console.log(`Missing paths: ${result.missing.length}`);
+        console.log(`Stale task artifacts: ${result.staleTaskArtifacts.length}`);
+    });
+}
+//# sourceMappingURL=diff-install.js.map

package/dist/cli/commands/diff-install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-install.js","sourceRoot":"","sources":["../../../src/cli/commands/diff-install.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,uBAAuB,EAAE,MAAM,+CAA+C,CAAC;AACxF,OAAO,EAAE,yBAAyB,EAAE,MAAM,2DAA2D,CAAC;AACtG,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,8CAA8C,CAAC;AAEtE,MAAM,UAAU,2BAA2B,CAAC,OAAgB;IAC1D,OAAO;SACJ,OAAO,CAAC,cAAc,CAAC;SACvB,MAAM,CAAC,eAAe,EAAE,gBAAgB,EAAE,sBAAsB,CAAC;SACjE,MAAM,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,CAAC;SACtC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACxB,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,MAAM,uBAAuB,CAAC,aAAa,CAAC,CAAC;QAC5D,MAAM,yBAAyB,CAAC,aAAa,EAAE;YAC7C,UAAU,EAAE,kBAAkB;YAC9B,SAAS,EAAE,cAAc;YACzB,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ;YAC1D,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACpC,OAAO,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE;SAC5C,CAAC,CAAC;QACH,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;YAC5B,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,4BAA4B,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;QACnE,OAAO,CAAC,GAAG,CAAC,kBAAkB,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QACvD,OAAO,CAAC,GAAG,CAAC,kBAAkB,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QACvD,OAAO,CAAC,GAAG,CAAC,yBAAyB,MAAM,CAAC,kBAAkB,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/doctor.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function registerDoctorCommands(program: Command): void;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/cli/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/doctor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2B7D"}

package/dist/cli/commands/doctor.js

@@ -0,0 +1,33 @@
+import path from "node:path";
+import { createDoctorReport } from "../../application/maintenance/doctor-workspace.js";
+import { appendEffectivenessSignal } from "../../infrastructure/observability/local-metrics-store.js";
+import { DEFAULT_WORKSPACE_ROOT, PACKAGE_ROOT } from "../../shared/index.js";
+import { toJson } from "../../infrastructure/diagnostics/reporter.js";
+export function registerDoctorCommands(program) {
+    program
+        .command("doctor")
+        .option("--root <root>", "workspace root", DEFAULT_WORKSPACE_ROOT)
+        .option("--json", "json output", false)
+        .action(async (options) => {
+        const workspaceRoot = path.resolve(options.root);
+        const result = await createDoctorReport(workspaceRoot, PACKAGE_ROOT);
+        await appendEffectivenessSignal(workspaceRoot, {
+            signalType: "doctor-run",
+            subjectId: "doctor",
+            result: result.status === "clean" ? "success" : result.status === "missing" ? "skipped" : "failed",
+            recordedAt: new Date().toISOString(),
+            details: { status: result.status }
+        });
+        if (options.json) {
+            console.log(toJson(result));
+            return;
+        }
+        console.log(`Workspace: ${workspaceRoot}`);
+        console.log(`Doctor status: ${result.status}`);
+        console.log(`Installed targets: ${result.audit.installedTargets.join(", ") || "none"}`);
+        console.log(`Missing managed paths: ${result.audit.missingManagedPaths.length}`);
+        console.log(`Missing bundles: ${result.audit.missingBundles.length}`);
+        console.log(`Stale task artifacts: ${result.audit.staleTaskArtifacts.length}`);
+    });
+}
+//# sourceMappingURL=doctor.js.map

package/dist/cli/commands/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../../src/cli/commands/doctor.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,mDAAmD,CAAC;AACvF,OAAO,EAAE,yBAAyB,EAAE,MAAM,2DAA2D,CAAC;AACtG,OAAO,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAAE,MAAM,EAAE,MAAM,8CAA8C,CAAC;AAEtE,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACrD,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,MAAM,CAAC,eAAe,EAAE,gBAAgB,EAAE,sBAAsB,CAAC;SACjE,MAAM,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,CAAC;SACtC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACxB,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;QACrE,MAAM,yBAAyB,CAAC,aAAa,EAAE;YAC7C,UAAU,EAAE,YAAY;YACxB,SAAS,EAAE,QAAQ;YACnB,MAAM,EAAE,MAAM,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ;YAClG,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACpC,OAAO,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;SACnC,CAAC,CAAC;QACH,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;YAC5B,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,cAAc,aAAa,EAAE,CAAC,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,kBAAkB,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QAC/C,OAAO,CAAC,GAAG,CAAC,sBAAsB,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC;QACxF,OAAO,CAAC,GAAG,CAAC,0BAA0B,MAAM,CAAC,KAAK,CAAC,mBAAmB,CAAC,MAAM,EAAE,CAAC,CAAC;QACjF,OAAO,CAAC,GAAG,CAAC,oBAAoB,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC;QACtE,OAAO,CAAC,GAAG,CAAC,yBAAyB,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,MAAM,EAAE,CAAC,CAAC;IACjF,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/export.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function registerExportCommands(program: Command): void;
+//# sourceMappingURL=export.d.ts.map

package/dist/cli/commands/export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/export.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgC7D"}

package/dist/cli/commands/export.js

@@ -0,0 +1,37 @@
+import path from "node:path";
+import { createAuditReport } from "../../application/maintenance/audit-install.js";
+import { createDoctorReport } from "../../application/maintenance/doctor-workspace.js";
+import { loadInstallState } from "../../domain/state/install-state.js";
+import { DEFAULT_WORKSPACE_ROOT, PACKAGE_ROOT, RUNTIME_DIR, RUNTIME_INDEX_FILE, exists, readJsonFile, writeJsonFile } from "../../shared/index.js";
+import { toJson } from "../../infrastructure/diagnostics/reporter.js";
+export function registerExportCommands(program) {
+    program
+        .command("export")
+        .description("Export a workspace runtime summary for review or handoff.")
+        .option("--root <root>", "workspace root", DEFAULT_WORKSPACE_ROOT)
+        .option("--output <file>", "write the export to a JSON file")
+        .option("--json", "json output", false)
+        .action(async (options) => {
+        const workspaceRoot = path.resolve(options.root);
+        const runtimeIndexPath = path.join(workspaceRoot, RUNTIME_DIR, RUNTIME_INDEX_FILE);
+        const [installState, doctor, audit, runtimeIndex] = await Promise.all([
+            loadInstallState(workspaceRoot),
+            createDoctorReport(workspaceRoot, PACKAGE_ROOT),
+            createAuditReport(workspaceRoot, PACKAGE_ROOT),
+            (async () => ((await exists(runtimeIndexPath)) ? readJsonFile(runtimeIndexPath) : null))()
+        ]);
+        const result = {
+            exportedAt: new Date().toISOString(),
+            workspaceRoot,
+            installState,
+            runtimeIndex,
+            doctor,
+            audit
+        };
+        if (options.output) {
+            await writeJsonFile(path.resolve(options.output), result);
+        }
+        console.log(options.json || !options.output ? toJson(result) : `Export written to ${path.resolve(options.output)}`);
+    });
+}
+//# sourceMappingURL=export.js.map

package/dist/cli/commands/export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.js","sourceRoot":"","sources":["../../../src/cli/commands/export.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAC;AACnF,OAAO,EAAE,kBAAkB,EAAE,MAAM,mDAAmD,CAAC;AACvF,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACnJ,OAAO,EAAE,MAAM,EAAE,MAAM,8CAA8C,CAAC;AAEtE,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACrD,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,2DAA2D,CAAC;SACxE,MAAM,CAAC,eAAe,EAAE,gBAAgB,EAAE,sBAAsB,CAAC;SACjE,MAAM,CAAC,iBAAiB,EAAE,iCAAiC,CAAC;SAC5D,MAAM,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,CAAC;SACtC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACxB,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACjD,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,WAAW,EAAE,kBAAkB,CAAC,CAAC;QACnF,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACpE,gBAAgB,CAAC,aAAa,CAAC;YAC/B,kBAAkB,CAAC,aAAa,EAAE,YAAY,CAAC;YAC/C,iBAAiB,CAAC,aAAa,EAAE,YAAY,CAAC;YAC9C,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE;SAC3F,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG;YACb,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACpC,aAAa;YACb,YAAY;YACZ,YAAY;YACZ,MAAM;YACN,KAAK;SACN,CAAC;QAEF,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;QAC5D,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,qBAAqB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACtH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/flow.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function registerFlowCommands(program: Command): void;
+//# sourceMappingURL=flow.d.ts.map

package/dist/cli/commands/flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/flow.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqB3D"}

package/dist/cli/commands/flow.js

@@ -0,0 +1,27 @@
+import path from "node:path";
+import { loadFlowState } from "../../application/flow/load-flow-state.js";
+import { saveFlowState } from "../../application/flow/save-flow-state.js";
+import { appendEffectivenessSignal } from "../../infrastructure/observability/local-metrics-store.js";
+import { DEFAULT_WORKSPACE_ROOT } from "../../shared/index.js";
+import { toJson } from "../../infrastructure/diagnostics/reporter.js";
+export function registerFlowCommands(program) {
+    const flow = program.command("flow");
+    flow
+        .command("status")
+        .option("--root <root>", "workspace root", DEFAULT_WORKSPACE_ROOT)
+        .option("--json", "json output", false)
+        .action(async (options) => {
+        const workspaceRoot = path.resolve(options.root);
+        const state = await loadFlowState(workspaceRoot);
+        await saveFlowState(workspaceRoot, state);
+        await appendEffectivenessSignal(workspaceRoot, {
+            signalType: "flow-status",
+            subjectId: state.featureId,
+            result: state.status === "complete" ? "success" : state.status === "blocked" ? "failed" : "accepted",
+            recordedAt: new Date().toISOString(),
+            details: { stage: state.currentStage }
+        });
+        console.log(options.json ? toJson(state) : JSON.stringify(state, null, 2));
+    });
+}
+//# sourceMappingURL=flow.js.map

package/dist/cli/commands/flow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow.js","sourceRoot":"","sources":["../../../src/cli/commands/flow.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAC1E,OAAO,EAAE,yBAAyB,EAAE,MAAM,2DAA2D,CAAC;AACtG,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,8CAA8C,CAAC;AAEtE,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAErC,IAAI;SACD,OAAO,CAAC,QAAQ,CAAC;SACjB,MAAM,CAAC,eAAe,EAAE,gBAAgB,EAAE,sBAAsB,CAAC;SACjE,MAAM,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,CAAC;SACtC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACxB,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACjD,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,aAAa,CAAC,CAAC;QACjD,MAAM,aAAa,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;QAC1C,MAAM,yBAAyB,CAAC,aAAa,EAAE;YAC7C,UAAU,EAAE,aAAa;YACzB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,MAAM,EAAE,KAAK,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU;YACpG,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACpC,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,YAAY,EAAE;SACvC,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;AACP,CAAC"}

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

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function registerInitCommands(program: Command): void;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgBpC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsF3D"}

package/dist/cli/commands/init.js

@@ -0,0 +1,91 @@
+import path from "node:path";
+import { initializeWorkspace } from "../../application/install/initialize-workspace.js";
+import { appendEffectivenessSignal } from "../../infrastructure/observability/local-metrics-store.js";
+import { toJson } from "../../infrastructure/diagnostics/reporter.js";
+import { DEFAULT_WORKSPACE_ROOT, PACKAGE_ROOT } from "../../shared/index.js";
+import { runInteractiveOnboarding } from "../interactive/onboarding-flow.js";
+import { applySetupIntent } from "../interactive/review-plan.js";
+import { detectTerminalCapabilities } from "../interactive/terminal-capabilities.js";
+import { getSetupProfileDescriptor, normalizeFolderSelection } from "../interactive/setup-intent.js";
+function collect(value, previous) {
+    previous.push(value);
+    return previous;
+}
+export function registerInitCommands(program) {
+    program
+        .command("init")
+        .option("--root <root>", "workspace root", DEFAULT_WORKSPACE_ROOT)
+        .option("--agent <target>", "agent target to install", collect, [])
+        .option("--setup-profile <profile>", "interactive setup profile (quick, recommended, advanced)", "recommended")
+        .option("--module <module>", "optional module", collect, [])
+        .option("--dry-run", "preview setup without writing files", false)
+        .option("--yes", "apply direct setup without prompting", false)
+        .option("--interactive", "force guided interactive setup", false)
+        .option("--json", "json output", false)
+        .action(async (options) => {
+        const workspaceRoot = path.resolve(options.root);
+        const capabilities = detectTerminalCapabilities();
+        const setupProfile = options.setupProfile;
+        const defaultModules = getSetupProfileDescriptor(setupProfile).defaultModules;
+        const shouldUseInteractive = options.interactive ||
+            (!options.json &&
+                !options.yes &&
+                !options.dryRun &&
+                options.agent.length === 0 &&
+                capabilities.supportsInteractiveInput);
+        if (shouldUseInteractive) {
+            const summary = await runInteractiveOnboarding(workspaceRoot);
+            if (options.json) {
+                console.log(toJson(summary));
+            }
+            return;
+        }
+        const folderSelection = workspaceRoot === path.resolve(process.cwd())
+            ? normalizeFolderSelection(workspaceRoot, "current-directory", ".")
+            : normalizeFolderSelection(process.cwd(), "custom-path", workspaceRoot);
+        const result = options.agent.length > 0 || options.dryRun || options.yes
+            ? await applySetupIntent({
+                workspaceRoot,
+                folderSelection,
+                targetIds: options.agent,
+                setupProfile,
+                enabledModules: (options.module.length > 0 ? options.module : defaultModules),
+                recommendedTargetIds: options.agent,
+                dryRun: options.dryRun || !options.yes,
+                applyChanges: options.yes && !options.dryRun,
+                source: "direct"
+            })
+            : await initializeWorkspace(workspaceRoot, PACKAGE_ROOT);
+        if ("status" in result) {
+            if (options.json) {
+                console.log(toJson(result));
+                return;
+            }
+            console.log(result.operatorMessage);
+            if (result.nextSuggestedCommands.length > 0) {
+                console.log(`Next: ${result.nextSuggestedCommands.join(" | ")}`);
+            }
+            return;
+        }
+        await appendEffectivenessSignal(workspaceRoot, {
+            signalType: "init-run",
+            subjectId: "init",
+            result: "success",
+            recordedAt: new Date().toISOString(),
+            details: {
+                runtimeSchemaVersion: result.installState.runtimeSchemaVersion,
+                installedTargets: result.installState.installedTargets.length
+            }
+        });
+        if (options.json) {
+            console.log(toJson(result));
+            return;
+        }
+        console.log(`Initialized Harness Forge workspace at ${workspaceRoot}`);
+        console.log(`Runtime schema version: ${result.installState.runtimeSchemaVersion}`);
+        console.log(`Install state: ${result.statePath}`);
+        console.log(`Runtime index: ${result.runtimeIndexPath}`);
+        console.log('Next: npx @harness-forge/cli shell setup --yes | npm install -g @harness-forge/cli');
+    });
+}
+//# sourceMappingURL=init.js.map

package/dist/cli/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/install.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function registerInstallCommands(program: Command): void;
+//# sourceMappingURL=install.d.ts.map

package/dist/cli/commands/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/install.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkBpC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqH9D"}

package/dist/cli/commands/install.js

@@ -0,0 +1,119 @@
+import path from "node:path";
+import { loadBundleManifests, loadProfileManifests } from "../../domain/manifests/index.js";
+import { loadTargetAdapter } from "../../domain/targets/adapter.js";
+import { bootstrapWorkspace } from "../../application/install/bootstrap-workspace.js";
+import { createInstallPlan } from "../../application/install/plan-install.js";
+import { applyInstall } from "../../application/install/apply-install.js";
+import { validateEnvironment } from "../../application/install/validate-environment.js";
+import { formatPlanSummary, toJson } from "../../infrastructure/diagnostics/reporter.js";
+import { PACKAGE_ROOT, DEFAULT_WORKSPACE_ROOT } from "../../shared/index.js";
+function collect(value, previous) {
+    previous.push(value);
+    return previous;
+}
+export function registerInstallCommands(program) {
+    program
+        .command("install")
+        .requiredOption("--target <target>")
+        .option("--profile <profile>")
+        .option("--lang <lang>", "language bundle", collect, [])
+        .option("--framework <framework>", "framework bundle", collect, [])
+        .option("--with <capability>", "capability bundle", collect, [])
+        .option("--bundle <bundle>", "explicit bundle", collect, [])
+        .option("--root <root>", "workspace root", DEFAULT_WORKSPACE_ROOT)
+        .option("--dry-run", "show plan only", false)
+        .option("--yes", "apply plan", false)
+        .option("--json", "json output", false)
+        .action(async (options) => {
+        const workspaceRoot = path.resolve(options.root);
+        const warnings = await validateEnvironment(PACKAGE_ROOT, options.target);
+        const [bundles, profiles, target] = await Promise.all([
+            loadBundleManifests(PACKAGE_ROOT),
+            loadProfileManifests(PACKAGE_ROOT),
+            loadTargetAdapter(PACKAGE_ROOT, options.target)
+        ]);
+        const plan = createInstallPlan(PACKAGE_ROOT, {
+            targetId: options.target,
+            profileId: options.profile,
+            bundleIds: options.bundle,
+            languageIds: options.lang,
+            frameworkIds: options.framework,
+            capabilityIds: options.with,
+            rootPath: workspaceRoot,
+            mode: options.yes && !options.dryRun ? "apply" : "dry-run"
+        }, bundles, profiles, target, { workspaceRoot });
+        plan.warnings.push(...warnings);
+        if (options.json) {
+            console.log(toJson(plan));
+            return;
+        }
+        console.log(formatPlanSummary(plan));
+        if (!options.dryRun && options.yes) {
+            const result = await applyInstall(workspaceRoot, plan);
+            console.log(result.messages.join("\n"));
+            console.log(`Guidance written to ${result.guidancePath}`);
+            console.log('Next: npx @harness-forge/cli shell setup --yes | npm install -g @harness-forge/cli');
+        }
+        else {
+            console.log('Preview only. Re-run with "--yes" to apply the plan.');
+        }
+    });
+    program
+        .command("bootstrap")
+        .option("--target <target>", "explicit target override", collect, [])
+        .option("--profile <profile>")
+        .option("--lang <lang>", "language bundle", collect, [])
+        .option("--framework <framework>", "framework bundle", collect, [])
+        .option("--with <capability>", "capability bundle", collect, [])
+        .option("--bundle <bundle>", "explicit bundle", collect, [])
+        .option("--root <root>", "workspace root", DEFAULT_WORKSPACE_ROOT)
+        .option("--dry-run", "show bootstrap plans only", false)
+        .option("--yes", "apply detected bootstrap plans", false)
+        .option("--json", "json output", false)
+        .action(async (options) => {
+        const workspaceRoot = path.resolve(options.root);
+        const result = await bootstrapWorkspace({
+            packageRoot: PACKAGE_ROOT,
+            workspaceRoot,
+            profileId: options.profile,
+            targetIds: options.target,
+            bundleIds: options.bundle,
+            languageIds: options.lang,
+            frameworkIds: options.framework,
+            capabilityIds: options.with,
+            mode: options.yes && !options.dryRun ? "apply" : "dry-run"
+        });
+        if (options.json) {
+            console.log(toJson(result));
+            return;
+        }
+        console.log(`Workspace: ${result.workspaceRoot}`);
+        console.log(`Targets: ${result.targetIds.join(", ")}`);
+        console.log(`Profile: ${result.recommendedProfileId}`);
+        console.log(`Recommended bundles: ${result.recommendedBundleIds.join(", ") || "none"}`);
+        if (result.discoveredTargets.length > 0) {
+            console.log("Discovered targets:");
+            for (const target of result.discoveredTargets) {
+                const evidence = target.evidence.length > 0 ? ` via ${target.evidence.join(", ")}` : "";
+                console.log(`- ${target.targetId} (${target.source}, ${target.confidence.toFixed(2)}): ${target.reason}${evidence}`);
+            }
+        }
+        for (const plan of result.plans) {
+            console.log("");
+            console.log(formatPlanSummary(plan));
+        }
+        if (result.applied.length > 0) {
+            for (const applied of result.applied) {
+                console.log("");
+                console.log(`Applied ${applied.targetId}`);
+                console.log(applied.messages.join("\n"));
+                console.log(`Guidance written to ${applied.guidancePath}`);
+            }
+            console.log('Next: npx @harness-forge/cli shell setup --yes | npm install -g @harness-forge/cli');
+        }
+        else {
+            console.log('Preview only. Re-run with "--yes" to apply the bootstrap plans.');
+        }
+    });
+}
+//# sourceMappingURL=install.js.map