@harness-forge/cli 0.1.0

package/dist/cli/commands/upgrade-surface.js

@@ -0,0 +1,24 @@
+import path from "node:path";
+import { createUpgradeSurfaceReport } from "../../application/maintenance/upgrade-surface.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 registerUpgradeSurfaceCommands(program) {
+    program
+        .command("upgrade-surface")
+        .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 createUpgradeSurfaceReport(workspaceRoot, PACKAGE_ROOT);
+        await appendEffectivenessSignal(workspaceRoot, {
+            signalType: "upgrade-surface-run",
+            subjectId: "upgrade-surface",
+            result: result.installedTargets.length > 0 ? "accepted" : "skipped",
+            recordedAt: new Date().toISOString(),
+            details: { installedTargets: result.installedTargets.length }
+        });
+        console.log(options.json ? toJson(result) : JSON.stringify(result, null, 2));
+    });
+}
+//# sourceMappingURL=upgrade-surface.js.map

package/dist/cli/commands/upgrade-surface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-surface.js","sourceRoot":"","sources":["../../../src/cli/commands/upgrade-surface.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,0BAA0B,EAAE,MAAM,kDAAkD,CAAC;AAC9F,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,8BAA8B,CAAC,OAAgB;IAC7D,OAAO;SACJ,OAAO,CAAC,iBAAiB,CAAC;SAC1B,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,0BAA0B,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;QAC7E,MAAM,yBAAyB,CAAC,aAAa,EAAE;YAC7C,UAAU,EAAE,qBAAqB;YACjC,SAAS,EAAE,iBAAiB;YAC5B,MAAM,EAAE,MAAM,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;YACnE,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACpC,OAAO,EAAE,EAAE,gBAAgB,EAAE,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE;SAC9D,CAAC,CAAC;QACH,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;AACP,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+import fs from "node:fs";
+import path from "node:path";
+import { Command } from "commander";
+import { registerAuditCommands } from "./commands/audit.js";
+import { registerCatalogCommands } from "./commands/catalog.js";
+import { registerCommandsCatalog } from "./commands/commands.js";
+import { registerDiffInstallCommands } from "./commands/diff-install.js";
+import { registerDoctorCommands } from "./commands/doctor.js";
+import { registerExportCommands } from "./commands/export.js";
+import { registerFlowCommands } from "./commands/flow.js";
+import { registerInitCommands } from "./commands/init.js";
+import { registerIntelligenceCommands } from "./commands/intelligence.js";
+import { registerInstallCommands } from "./commands/install.js";
+import { registerMaintenanceCommands } from "./commands/maintenance.js";
+import { registerObservabilityCommands } from "./commands/observability.js";
+import { registerParallelCommands } from "./commands/parallel.js";
+import { registerPackCommands } from "./commands/pack.js";
+import { registerPruneCommands } from "./commands/prune.js";
+import { registerRefreshCommands } from "./commands/refresh.js";
+import { registerRecursiveCommands } from "./commands/recursive.js";
+import { registerRecommendCommands } from "./commands/recommend.js";
+import { registerReviewCommands } from "./commands/review.js";
+import { registerShellCommands } from "./commands/shell.js";
+import { registerStatusCommands } from "./commands/status.js";
+import { registerSyncCommands } from "./commands/sync.js";
+import { registerTaskCommands } from "./commands/task.js";
+import { registerTemplateCommands } from "./commands/template.js";
+import { registerTargetCommands } from "./commands/target.js";
+import { registerUpgradeSurfaceCommands } from "./commands/upgrade-surface.js";
+import { formatCliError } from "../infrastructure/diagnostics/reporter.js";
+import { PACKAGE_ROOT } from "../shared/index.js";
+import { runDefaultInteractiveEntry } from "./interactive/entry-router.js";
+const program = new Command();
+const packageJson = JSON.parse(fs.readFileSync(path.join(PACKAGE_ROOT, "package.json"), "utf8"));
+program
+    .name("hforge")
+    .description(packageJson.description ?? "Harness Forge agentic AI workspace installer and catalog runtime")
+    .version(packageJson.version)
+    .showHelpAfterError()
+    .showSuggestionAfterError();
+registerInitCommands(program);
+registerInstallCommands(program);
+registerStatusCommands(program);
+registerRefreshCommands(program);
+registerTaskCommands(program);
+registerPackCommands(program);
+registerReviewCommands(program);
+registerShellCommands(program);
+registerExportCommands(program);
+registerCommandsCatalog(program);
+registerDoctorCommands(program);
+registerAuditCommands(program);
+registerFlowCommands(program);
+registerCatalogCommands(program);
+registerRecommendCommands(program);
+registerIntelligenceCommands(program);
+registerTemplateCommands(program);
+registerTargetCommands(program);
+registerMaintenanceCommands(program);
+registerObservabilityCommands(program);
+registerParallelCommands(program);
+registerRecursiveCommands(program);
+registerSyncCommands(program);
+registerDiffInstallCommands(program);
+registerUpgradeSurfaceCommands(program);
+registerPruneCommands(program);
+async function main() {
+    const args = process.argv.slice(2);
+    if (args.length === 0) {
+        const handled = await runDefaultInteractiveEntry(args, process.cwd());
+        if (handled) {
+            return;
+        }
+        program.outputHelp();
+        console.error('No interactive terminal detected. Re-run with "hforge init --root <repo> --agent codex --yes" or add "--dry-run".');
+        process.exitCode = 1;
+        return;
+    }
+    await program.parseAsync(process.argv);
+}
+main().catch((error) => {
+    console.error(formatCliError(error));
+    process.exitCode = 1;
+});
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/cli/interactive/default-recommendations.d.ts

@@ -0,0 +1,9 @@
+import type { OptionalModuleId, SetupProfileId } from "./setup-intent.js";
+export interface SetupRecommendations {
+    recommendedTargets: string[];
+    recommendedProfile: SetupProfileId;
+    recommendedModules: OptionalModuleId[];
+    folderMode: "current-directory" | "custom-path" | "new-folder";
+}
+export declare function recommendSetupDefaults(workspaceRoot: string): Promise<SetupRecommendations>;
+//# sourceMappingURL=default-recommendations.d.ts.map

package/dist/cli/interactive/default-recommendations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-recommendations.d.ts","sourceRoot":"","sources":["../../../src/cli/interactive/default-recommendations.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAE1E,MAAM,WAAW,oBAAoB;IACnC,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,kBAAkB,EAAE,cAAc,CAAC;IACnC,kBAAkB,EAAE,gBAAgB,EAAE,CAAC;IACvC,UAAU,EAAE,mBAAmB,GAAG,aAAa,GAAG,YAAY,CAAC;CAChE;AAED,wBAAsB,sBAAsB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAiBjG"}

package/dist/cli/interactive/default-recommendations.js

@@ -0,0 +1,19 @@
+import { discoverWorkspaceTargets } from "../../application/install/discover-workspace-targets.js";
+import { exists } from "../../shared/index.js";
+export async function recommendSetupDefaults(workspaceRoot) {
+    const discoveredTargets = await discoverWorkspaceTargets(workspaceRoot);
+    const packageJsonPresent = await exists(`${workspaceRoot}/package.json`);
+    const tsconfigPresent = await exists(`${workspaceRoot}/tsconfig.json`);
+    const recommendedTargets = discoveredTargets.length > 0 ? discoveredTargets.map((item) => item.targetId) : ["codex"];
+    const recommendedProfile = tsconfigPresent || packageJsonPresent ? "recommended" : "quick";
+    const recommendedModules = recommendedProfile === "recommended"
+        ? ["working-memory", "task-pack-support", "export-support"]
+        : ["export-support"];
+    return {
+        recommendedTargets,
+        recommendedProfile,
+        recommendedModules,
+        folderMode: "current-directory"
+    };
+}
+//# sourceMappingURL=default-recommendations.js.map

package/dist/cli/interactive/default-recommendations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-recommendations.js","sourceRoot":"","sources":["../../../src/cli/interactive/default-recommendations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,yDAAyD,CAAC;AACnG,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAU/C,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,aAAqB;IAChE,MAAM,iBAAiB,GAAG,MAAM,wBAAwB,CAAC,aAAa,CAAC,CAAC;IACxE,MAAM,kBAAkB,GAAG,MAAM,MAAM,CAAC,GAAG,aAAa,eAAe,CAAC,CAAC;IACzE,MAAM,eAAe,GAAG,MAAM,MAAM,CAAC,GAAG,aAAa,gBAAgB,CAAC,CAAC;IACvE,MAAM,kBAAkB,GAAG,iBAAiB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACrH,MAAM,kBAAkB,GAAmB,eAAe,IAAI,kBAAkB,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC;IAC3G,MAAM,kBAAkB,GACtB,kBAAkB,KAAK,aAAa;QAClC,CAAC,CAAC,CAAC,gBAAgB,EAAE,mBAAmB,EAAE,gBAAgB,CAAC;QAC3D,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAEzB,OAAO;QACL,kBAAkB;QAClB,kBAAkB;QAClB,kBAAkB;QAClB,UAAU,EAAE,mBAAmB;KAChC,CAAC;AACJ,CAAC"}

package/dist/cli/interactive/entry-router.d.ts

@@ -0,0 +1,5 @@
+import type { CliInvocationContext } from "./invocation-context.js";
+export type DefaultInteractiveRoute = "onboarding" | "project-hub" | "none";
+export declare function chooseDefaultInteractiveRoute(context: CliInvocationContext): Promise<DefaultInteractiveRoute>;
+export declare function runDefaultInteractiveEntry(argv: string[], cwd: string): Promise<boolean>;
+//# sourceMappingURL=entry-router.d.ts.map

package/dist/cli/interactive/entry-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-router.d.ts","sourceRoot":"","sources":["../../../src/cli/interactive/entry-router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAKpE,MAAM,MAAM,uBAAuB,GAAG,YAAY,GAAG,aAAa,GAAG,MAAM,CAAC;AAE5E,wBAAsB,6BAA6B,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAWnH;AAED,wBAAsB,0BAA0B,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAe9F"}

package/dist/cli/interactive/entry-router.js

@@ -0,0 +1,30 @@
+import { resolveInvocationContext } from "./invocation-context.js";
+import { runInteractiveOnboarding } from "./onboarding-flow.js";
+import { runProjectHub } from "./project-hub.js";
+export async function chooseDefaultInteractiveRoute(context) {
+    if (context.argv.length > 0) {
+        return "none";
+    }
+    if (!context.terminalProfile.supportsInteractiveInput && process.env.HFORGE_FORCE_TTY !== "1") {
+        return "none";
+    }
+    if (context.detectedRuntimeState === "present" || context.detectedRuntimeState === "partial") {
+        return "project-hub";
+    }
+    return "onboarding";
+}
+export async function runDefaultInteractiveEntry(argv, cwd) {
+    const context = await resolveInvocationContext(argv, cwd);
+    const route = await chooseDefaultInteractiveRoute(context);
+    if (route === "none") {
+        return false;
+    }
+    if (route === "project-hub") {
+        const result = await runProjectHub(context.detectedWorkspaceRoot);
+        console.log(result.operatorMessage);
+        return true;
+    }
+    await runInteractiveOnboarding(context.detectedWorkspaceRoot);
+    return true;
+}
+//# sourceMappingURL=entry-router.js.map

package/dist/cli/interactive/entry-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-router.js","sourceRoot":"","sources":["../../../src/cli/interactive/entry-router.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAIjD,MAAM,CAAC,KAAK,UAAU,6BAA6B,CAAC,OAA6B;IAC/E,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,wBAAwB,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,KAAK,GAAG,EAAE,CAAC;QAC9F,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,OAAO,CAAC,oBAAoB,KAAK,SAAS,IAAI,OAAO,CAAC,oBAAoB,KAAK,SAAS,EAAE,CAAC;QAC7F,OAAO,aAAa,CAAC;IACvB,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,IAAc,EAAE,GAAW;IAC1E,MAAM,OAAO,GAAG,MAAM,wBAAwB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC1D,MAAM,KAAK,GAAG,MAAM,6BAA6B,CAAC,OAAO,CAAC,CAAC;IAC3D,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QACrB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,KAAK,KAAK,aAAa,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;QAClE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,wBAAwB,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC9D,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/cli/interactive/invocation-context.d.ts

@@ -0,0 +1,16 @@
+import type { TerminalCapabilityProfile } from "./terminal-capabilities.js";
+export type RuntimePresenceState = "absent" | "present" | "partial";
+export interface CliInvocationContext {
+    argv: string[];
+    cwd: string;
+    explicitCommand: string | null;
+    providedFlags: string[];
+    isTty: boolean;
+    isCi: boolean;
+    detectedWorkspaceRoot: string;
+    detectedRuntimeState: RuntimePresenceState;
+    terminalProfile: TerminalCapabilityProfile;
+}
+export declare function detectRuntimePresenceState(workspaceRoot: string): Promise<RuntimePresenceState>;
+export declare function resolveInvocationContext(argv: string[], cwd: string): Promise<CliInvocationContext>;
+//# sourceMappingURL=invocation-context.d.ts.map

package/dist/cli/interactive/invocation-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invocation-context.d.ts","sourceRoot":"","sources":["../../../src/cli/interactive/invocation-context.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAG5E,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;AAEpE,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,qBAAqB,EAAE,MAAM,CAAC;IAC9B,oBAAoB,EAAE,oBAAoB,CAAC;IAC3C,eAAe,EAAE,yBAAyB,CAAC;CAC5C;AAED,wBAAsB,0BAA0B,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAUrG;AAED,wBAAsB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAkBzG"}

package/dist/cli/interactive/invocation-context.js

@@ -0,0 +1,33 @@
+import path from "node:path";
+import { RUNTIME_DIR, RUNTIME_INDEX_FILE, exists } from "../../shared/index.js";
+import { detectTerminalCapabilities } from "./terminal-capabilities.js";
+export async function detectRuntimePresenceState(workspaceRoot) {
+    const runtimeDir = path.join(workspaceRoot, RUNTIME_DIR);
+    const runtimeIndexPath = path.join(runtimeDir, RUNTIME_INDEX_FILE);
+    if (await exists(runtimeIndexPath)) {
+        return "present";
+    }
+    if (await exists(runtimeDir)) {
+        return "partial";
+    }
+    return "absent";
+}
+export async function resolveInvocationContext(argv, cwd) {
+    const explicitCommand = argv.find((value) => !value.startsWith("-")) ?? null;
+    const providedFlags = argv.filter((value) => value.startsWith("-"));
+    const terminalProfile = detectTerminalCapabilities();
+    const detectedWorkspaceRoot = path.resolve(cwd);
+    const detectedRuntimeState = await detectRuntimePresenceState(detectedWorkspaceRoot);
+    return {
+        argv,
+        cwd: detectedWorkspaceRoot,
+        explicitCommand,
+        providedFlags,
+        isTty: terminalProfile.supportsInteractiveInput,
+        isCi: process.env.CI === "true",
+        detectedWorkspaceRoot,
+        detectedRuntimeState,
+        terminalProfile
+    };
+}
+//# sourceMappingURL=invocation-context.js.map

package/dist/cli/interactive/invocation-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invocation-context.js","sourceRoot":"","sources":["../../../src/cli/interactive/invocation-context.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEhF,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAgBxE,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,aAAqB;IACpE,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;IACzD,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC;IACnE,IAAI,MAAM,MAAM,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACnC,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,MAAM,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7B,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,IAAc,EAAE,GAAW;IACxE,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC;IAC7E,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IACpE,MAAM,eAAe,GAAG,0BAA0B,EAAE,CAAC;IACrD,MAAM,qBAAqB,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAChD,MAAM,oBAAoB,GAAG,MAAM,0BAA0B,CAAC,qBAAqB,CAAC,CAAC;IAErF,OAAO;QACL,IAAI;QACJ,GAAG,EAAE,qBAAqB;QAC1B,eAAe;QACf,aAAa;QACb,KAAK,EAAE,eAAe,CAAC,wBAAwB;QAC/C,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,KAAK,MAAM;QAC/B,qBAAqB;QACrB,oBAAoB;QACpB,eAAe;KAChB,CAAC;AACJ,CAAC"}

package/dist/cli/interactive/onboarding-flow.d.ts

@@ -0,0 +1,3 @@
+import type { ExecutionSummary } from "./session-state.js";
+export declare function runInteractiveOnboarding(startRoot: string): Promise<ExecutionSummary>;
+//# sourceMappingURL=onboarding-flow.d.ts.map

package/dist/cli/interactive/onboarding-flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding-flow.d.ts","sourceRoot":"","sources":["../../../src/cli/interactive/onboarding-flow.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAO3D,wBAAsB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAsG3F"}

package/dist/cli/interactive/onboarding-flow.js

@@ -0,0 +1,81 @@
+import path from "node:path";
+import { createRecoveryNotice } from "./recovery-notices.js";
+import { applySetupIntent, buildReviewPlan } from "./review-plan.js";
+import { createPromptSession } from "./prompt-io.js";
+import { renderChoiceList } from "./renderers/choice-list.js";
+import { renderCompletionScreen } from "./renderers/completion-screen.js";
+import { renderStepFrame } from "./renderers/step-frame.js";
+import { renderWelcomeScreen } from "./renderers/welcome-screen.js";
+import { promptForFolderSelection } from "./prompts/folder-selection.js";
+import { promptForModules } from "./prompts/module-selection.js";
+import { promptForSetupProfile } from "./prompts/setup-profile.js";
+import { promptForTargetSelection } from "./prompts/target-selection.js";
+import { detectTerminalCapabilities } from "./terminal-capabilities.js";
+import { recommendSetupDefaults } from "./default-recommendations.js";
+import { OPTIONAL_MODULE_LABELS } from "./setup-intent.js";
+import { renderReviewSummary } from "./review-summary.js";
+export async function runInteractiveOnboarding(startRoot) {
+    const capabilities = detectTerminalCapabilities();
+    const promptSession = createPromptSession(capabilities);
+    const defaults = await recommendSetupDefaults(startRoot);
+    console.log(renderWelcomeScreen(capabilities));
+    let completed = false;
+    let summary = null;
+    while (!completed) {
+        const folderSelection = await promptForFolderSelection(promptSession, startRoot);
+        const setupRoot = folderSelection.selectionMode === "current-directory" ? startRoot : path.resolve(folderSelection.resolvedPath);
+        const targetIds = await promptForTargetSelection(promptSession, defaults.recommendedTargets);
+        const setupProfile = await promptForSetupProfile(promptSession, defaults.recommendedProfile);
+        const enabledModules = await promptForModules(promptSession, setupProfile);
+        const dryRun = await promptSession.askConfirm("dryRun", "Preview only without writing files", false);
+        console.log(renderStepFrame(capabilities, "Folder selection", 1, 4, `Workspace root: ${setupRoot}\nMode: ${folderSelection.selectionMode}`));
+        console.log(renderStepFrame(capabilities, "Target selection", 2, 4, renderChoiceList(["codex", "claude-code", "cursor", "opencode"], targetIds)));
+        console.log(renderStepFrame(capabilities, "Setup profile", 3, 4, `Profile: ${setupProfile}\nModules: ${enabledModules.map((item) => OPTIONAL_MODULE_LABELS[item]).join(", ") || "none"}`));
+        const reviewPlan = await buildReviewPlan({
+            workspaceRoot: setupRoot,
+            folderSelection,
+            targetIds,
+            setupProfile,
+            enabledModules: enabledModules,
+            recommendedTargetIds: defaults.recommendedTargets,
+            dryRun,
+            applyChanges: !dryRun,
+            source: "interactive"
+        });
+        console.log(renderReviewSummary(reviewPlan, capabilities));
+        const confirmAction = await promptSession.askChoice("confirmAction", "Confirm setup", ["confirm", "back", "cancel"], "confirm");
+        if (confirmAction === "back") {
+            continue;
+        }
+        if (confirmAction === "cancel") {
+            return {
+                status: "cancelled",
+                workspaceRoot: setupRoot,
+                appliedTargets: [],
+                writtenArtifacts: [],
+                preservedArtifacts: [],
+                nextSuggestedCommands: [],
+                importantPaths: [],
+                operatorMessage: createRecoveryNotice("cancelled", "Setup cancelled before apply.", setupRoot).summary
+            };
+        }
+        summary = await applySetupIntent({
+            workspaceRoot: setupRoot,
+            folderSelection,
+            targetIds,
+            setupProfile,
+            enabledModules: enabledModules,
+            recommendedTargetIds: defaults.recommendedTargets,
+            dryRun,
+            applyChanges: !dryRun,
+            source: "interactive"
+        });
+        completed = true;
+    }
+    if (!summary) {
+        throw new Error("Interactive onboarding did not produce a summary.");
+    }
+    console.log(renderCompletionScreen(summary, capabilities));
+    return summary;
+}
+//# sourceMappingURL=onboarding-flow.js.map

package/dist/cli/interactive/onboarding-flow.js.map

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

package/dist/cli/interactive/project-hub.d.ts

@@ -0,0 +1,3 @@
+import type { ExecutionSummary } from "./session-state.js";
+export declare function runProjectHub(workspaceRoot: string): Promise<ExecutionSummary>;
+//# sourceMappingURL=project-hub.d.ts.map

package/dist/cli/interactive/project-hub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-hub.d.ts","sourceRoot":"","sources":["../../../src/cli/interactive/project-hub.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAc3D,wBAAsB,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAgJpF"}

package/dist/cli/interactive/project-hub.js

@@ -0,0 +1,159 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { refreshWorkspaceRuntime } from "../../application/install/refresh-workspace-runtime.js";
+import { createAuditReport } from "../../application/maintenance/audit-install.js";
+import { createDoctorReport } from "../../application/maintenance/doctor-workspace.js";
+import { loadDecisionIndex } from "../../application/runtime/decision-runtime-store.js";
+import { listStaleTaskAnalysisArtifacts, resolveTaskArtifactPaths } from "../../application/runtime/task-runtime-store.js";
+import { loadInstallState } from "../../domain/state/install-state.js";
+import { PACKAGE_ROOT, RUNTIME_DIR, RUNTIME_INDEX_FILE, RUNTIME_TASKS_DIR, exists, readJsonFile } from "../../shared/index.js";
+import { createPromptSession, readScriptLabel } from "./prompt-io.js";
+import { detectTerminalCapabilities } from "./terminal-capabilities.js";
+import { renderHubScreen } from "./renderers/hub-screen.js";
+async function listTaskIds(workspaceRoot) {
+    const tasksRoot = path.join(workspaceRoot, RUNTIME_DIR, RUNTIME_TASKS_DIR);
+    if (!(await exists(tasksRoot))) {
+        return [];
+    }
+    const entries = await fs.readdir(tasksRoot, { withFileTypes: true });
+    return entries.filter((entry) => entry.isDirectory()).map((entry) => entry.name).sort();
+}
+export async function runProjectHub(workspaceRoot) {
+    const capabilities = detectTerminalCapabilities();
+    const promptSession = createPromptSession(capabilities);
+    const installState = await loadInstallState(workspaceRoot);
+    const doctor = await createDoctorReport(workspaceRoot, PACKAGE_ROOT);
+    const actions = [
+        "status",
+        "refresh",
+        "task",
+        "pack",
+        "review",
+        "export",
+        "settings",
+        "exit"
+    ];
+    console.log(renderHubScreen(workspaceRoot, actions, capabilities, `Runtime health: ${doctor.status}`));
+    const action = await promptSession.askChoice("hubAction", "Choose a project-hub action", [
+        { value: "status", label: "Status", description: "Summarize install state and current runtime basics." },
+        { value: "refresh", label: "Refresh", description: "Regenerate the shared runtime summary for the repo." },
+        { value: "task", label: "Task", description: "Inspect task-runtime folders currently present under .hforge/runtime/tasks/." },
+        { value: "pack", label: "Pack", description: "Inspect the canonical task pack for a task id." },
+        { value: "review", label: "Review", description: "Check doctor status, stale artifacts, and decision coverage." },
+        { value: "export", label: "Export", description: "Prepare a runtime handoff summary for review or sharing." },
+        { value: "settings", label: "Settings", description: "Show current runtime visibility and setup profile details." },
+        { value: "exit", label: "Exit", description: "Leave the interactive hub without changes." }
+    ], doctor.status === "warning" ? "review" : "status");
+    switch (action) {
+        case "refresh": {
+            const result = await refreshWorkspaceRuntime(workspaceRoot);
+            return {
+                status: "success",
+                workspaceRoot,
+                appliedTargets: result.targetIds,
+                writtenArtifacts: [result.runtimeIndexPath],
+                preservedArtifacts: [],
+                nextSuggestedCommands: [`hforge review --root ${workspaceRoot}`],
+                importantPaths: [result.runtimeIndexPath],
+                operatorMessage: `Refreshed shared runtime for ${workspaceRoot}.`
+            };
+        }
+        case "task": {
+            const taskIds = await listTaskIds(workspaceRoot);
+            return {
+                status: "success",
+                workspaceRoot,
+                appliedTargets: installState?.installedTargets ?? [],
+                writtenArtifacts: [],
+                preservedArtifacts: [],
+                nextSuggestedCommands: [`hforge task list --root ${workspaceRoot} --json`],
+                importantPaths: [path.join(workspaceRoot, RUNTIME_DIR, RUNTIME_TASKS_DIR)],
+                operatorMessage: `Task runtime folders: ${taskIds.join(", ") || "none"}.`
+            };
+        }
+        case "pack": {
+            const fallbackTaskId = (await listTaskIds(workspaceRoot))[0] ?? "TASK-001";
+            const taskId = readScriptLabel("hubTaskId", fallbackTaskId);
+            const taskPackPath = resolveTaskArtifactPaths(workspaceRoot, taskId).taskPackPath;
+            const existsTaskPack = await exists(taskPackPath);
+            return {
+                status: existsTaskPack ? "success" : "failed",
+                workspaceRoot,
+                appliedTargets: installState?.installedTargets ?? [],
+                writtenArtifacts: [],
+                preservedArtifacts: [],
+                nextSuggestedCommands: [`hforge pack inspect ${taskId} --root ${workspaceRoot} --json`],
+                importantPaths: [taskPackPath],
+                operatorMessage: existsTaskPack ? `Task pack is available for ${taskId}.` : `Task pack not found for ${taskId}.`
+            };
+        }
+        case "review": {
+            const [decisionIndex, staleArtifacts] = await Promise.all([
+                loadDecisionIndex(workspaceRoot),
+                listStaleTaskAnalysisArtifacts(workspaceRoot)
+            ]);
+            return {
+                status: "success",
+                workspaceRoot,
+                appliedTargets: installState?.installedTargets ?? [],
+                writtenArtifacts: [],
+                preservedArtifacts: [],
+                nextSuggestedCommands: [`hforge export --root ${workspaceRoot} --json`],
+                importantPaths: [path.join(workspaceRoot, RUNTIME_DIR, RUNTIME_INDEX_FILE)],
+                operatorMessage: `Doctor status: ${doctor.status}. Decision records: ${decisionIndex.entries.length}. Stale task artifacts: ${staleArtifacts.length}.`
+            };
+        }
+        case "export": {
+            const [audit, runtimeIndex] = await Promise.all([
+                createAuditReport(workspaceRoot, PACKAGE_ROOT),
+                readJsonFile(path.join(workspaceRoot, RUNTIME_DIR, RUNTIME_INDEX_FILE)).catch(() => null)
+            ]);
+            return {
+                status: "success",
+                workspaceRoot,
+                appliedTargets: installState?.installedTargets ?? [],
+                writtenArtifacts: [],
+                preservedArtifacts: [],
+                nextSuggestedCommands: [`hforge export --root ${workspaceRoot} --json`],
+                importantPaths: [path.join(workspaceRoot, RUNTIME_DIR, RUNTIME_INDEX_FILE)],
+                operatorMessage: `Export-ready summary: ${audit.installedTargets.length} targets, ${audit.staleTaskArtifacts.length} stale task artifacts, runtime index ${runtimeIndex ? "present" : "missing"}.`
+            };
+        }
+        case "settings": {
+            return {
+                status: "success",
+                workspaceRoot,
+                appliedTargets: installState?.installedTargets ?? [],
+                writtenArtifacts: [],
+                preservedArtifacts: [],
+                nextSuggestedCommands: [`hforge status --root ${workspaceRoot}`],
+                importantPaths: [path.join(workspaceRoot, ".hforge", "state", "install-state.json")],
+                operatorMessage: `Visibility mode: ${installState?.visibilityMode ?? "unknown"}. Setup profile: ${installState?.setupProfile ?? "unknown"}.`
+            };
+        }
+        case "exit":
+            return {
+                status: "cancelled",
+                workspaceRoot,
+                appliedTargets: installState?.installedTargets ?? [],
+                writtenArtifacts: [],
+                preservedArtifacts: [],
+                nextSuggestedCommands: [],
+                importantPaths: [],
+                operatorMessage: "Exited the project hub without changes."
+            };
+        case "status":
+        default:
+            return {
+                status: "success",
+                workspaceRoot,
+                appliedTargets: installState?.installedTargets ?? [],
+                writtenArtifacts: [],
+                preservedArtifacts: [],
+                nextSuggestedCommands: [`hforge refresh --root ${workspaceRoot}`],
+                importantPaths: [path.join(workspaceRoot, ".hforge", "state", "install-state.json")],
+                operatorMessage: `Installed targets: ${(installState?.installedTargets ?? []).join(", ") || "none"}. Last action: ${installState?.lastAction ?? "unknown"}.`
+            };
+    }
+}
+//# sourceMappingURL=project-hub.js.map

package/dist/cli/interactive/project-hub.js.map

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

package/dist/cli/interactive/prompt-io.d.ts

@@ -0,0 +1,23 @@
+import type { TerminalCapabilityProfile } from "./terminal-capabilities.js";
+export type PromptScriptValue = string | string[] | boolean | null;
+interface PromptScript {
+    [key: string]: PromptScriptValue;
+}
+export interface PromptChoiceOption {
+    value: string;
+    label: string;
+    description?: string;
+}
+type PromptChoiceInput = string | PromptChoiceOption;
+export interface PromptSession {
+    script: PromptScript;
+    capabilities: TerminalCapabilityProfile;
+    askText(stepId: string, prompt: string, fallback?: string): Promise<string>;
+    askChoice(stepId: string, prompt: string, choices: readonly PromptChoiceInput[], fallback: string): Promise<string>;
+    askMultiChoice(stepId: string, prompt: string, choices: readonly PromptChoiceInput[], fallback: string[]): Promise<string[]>;
+    askConfirm(stepId: string, prompt: string, fallback?: boolean): Promise<boolean>;
+}
+export declare function createPromptSession(capabilities: TerminalCapabilityProfile): PromptSession;
+export declare function readScriptLabel(stepId: string, fallback: string): string;
+export {};
+//# sourceMappingURL=prompt-io.d.ts.map

package/dist/cli/interactive/prompt-io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-io.d.ts","sourceRoot":"","sources":["../../../src/cli/interactive/prompt-io.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAE5E,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,GAAG,IAAI,CAAC;AAEnE,UAAU,YAAY;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAAC;CAClC;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,KAAK,iBAAiB,GAAG,MAAM,GAAG,kBAAkB,CAAC;AAErD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,YAAY,CAAC;IACrB,YAAY,EAAE,yBAAyB,CAAC;IACxC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5E,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,iBAAiB,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACpH,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,iBAAiB,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7H,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAClF;AAqED,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,yBAAyB,GAAG,aAAa,CA+E1F;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGxE"}