@harness-forge/cli 0.1.0

package/dist/cli/interactive/renderers/welcome-screen.js

@@ -0,0 +1,22 @@
+import { renderBulletList, renderInfoCard, renderScreen } from "./screen-layout.js";
+import { styleAccent, styleHeading, styleMuted, styleSection } from "./text-style.js";
+export function renderWelcomeScreen(capabilities) {
+    return renderScreen(styleHeading(capabilities, "Harness Forge Setup"), [
+        "Harness Forge can guide you through a clean hidden-runtime setup without requiring raw flags first.",
+        renderInfoCard("What you will do", [
+            "Pick a workspace folder",
+            "Choose one or more agent targets",
+            "Select the setup depth",
+            "Review every planned write before apply"
+        ], capabilities),
+        styleSection(capabilities, "Guided flow"),
+        renderBulletList([
+            `choose the ${styleAccent(capabilities, "project folder")} you want to modify`,
+            `select ${styleAccent(capabilities, "agent targets")} and setup depth`,
+            `review ${styleAccent(capabilities, "planned writes")} before anything changes`,
+            `finish with ${styleAccent(capabilities, "next steps")} for status, refresh, task, pack, review, and export`
+        ], capabilities),
+        styleMuted(capabilities, "Interactive mode never writes before the review step.")
+    ], capabilities);
+}
+//# sourceMappingURL=welcome-screen.js.map

package/dist/cli/interactive/renderers/welcome-screen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"welcome-screen.js","sourceRoot":"","sources":["../../../../src/cli/interactive/renderers/welcome-screen.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACpF,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEtF,MAAM,UAAU,mBAAmB,CAAC,YAAuC;IACzE,OAAO,YAAY,CACjB,YAAY,CAAC,YAAY,EAAE,qBAAqB,CAAC,EACjD;QACE,qGAAqG;QACrG,cAAc,CACZ,kBAAkB,EAClB;YACE,yBAAyB;YACzB,kCAAkC;YAClC,wBAAwB;YACxB,yCAAyC;SAC1C,EACD,YAAY,CACb;QACD,YAAY,CAAC,YAAY,EAAE,aAAa,CAAC;QACzC,gBAAgB,CACd;YACE,cAAc,WAAW,CAAC,YAAY,EAAE,gBAAgB,CAAC,qBAAqB;YAC9E,UAAU,WAAW,CAAC,YAAY,EAAE,eAAe,CAAC,kBAAkB;YACtE,UAAU,WAAW,CAAC,YAAY,EAAE,gBAAgB,CAAC,0BAA0B;YAC/E,eAAe,WAAW,CAAC,YAAY,EAAE,YAAY,CAAC,sDAAsD;SAC7G,EACD,YAAY,CACb;QACD,UAAU,CAAC,YAAY,EAAE,uDAAuD,CAAC;KAClF,EACD,YAAY,CACb,CAAC;AACJ,CAAC"}

package/dist/cli/interactive/review-plan.d.ts

@@ -0,0 +1,19 @@
+import type { ExecutionSummary } from "./session-state.js";
+import type { SetupIntent } from "./setup-intent.js";
+export interface PlannedWrite {
+    path: string;
+    kind: "runtime" | "bridge" | "state" | "generated";
+    description: string;
+}
+export interface ReviewPlanDocument {
+    workspaceRoot: string;
+    targetIds: string[];
+    setupProfile: string;
+    enabledModules: string[];
+    plannedWrites: PlannedWrite[];
+    warnings: string[];
+    directCommandPreview: string;
+}
+export declare function buildReviewPlan(intent: SetupIntent): Promise<ReviewPlanDocument>;
+export declare function applySetupIntent(intent: SetupIntent): Promise<ExecutionSummary>;
+//# sourceMappingURL=review-plan.d.ts.map

package/dist/cli/interactive/review-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-plan.d.ts","sourceRoot":"","sources":["../../../src/cli/interactive/review-plan.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,WAAW,CAAC;IACnD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAkED,wBAAsB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA2BtF;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAoErF"}

package/dist/cli/interactive/review-plan.js

@@ -0,0 +1,151 @@
+import path from "node:path";
+import { applyInstall } from "../../application/install/apply-install.js";
+import { initializeWorkspace } from "../../application/install/initialize-workspace.js";
+import { createInstallPlan } from "../../application/install/plan-install.js";
+import { validateEnvironment } from "../../application/install/validate-environment.js";
+import { loadBundleManifests, loadProfileManifests } from "../../domain/manifests/index.js";
+import { loadInstallState, saveInstallState } from "../../domain/state/install-state.js";
+import { loadTargetAdapter } from "../../domain/targets/adapter.js";
+import { PACKAGE_ROOT, STATE_DIR } from "../../shared/index.js";
+import { getSetupProfileDescriptor, OPTIONAL_MODULE_LABELS } from "./setup-intent.js";
+function createInitWrites(workspaceRoot) {
+    return [
+        {
+            path: path.join(workspaceRoot, STATE_DIR, "install-state.json"),
+            kind: "state",
+            description: "Workspace install-state and runtime version tracking."
+        },
+        {
+            path: path.join(workspaceRoot, ".hforge", "runtime", "index.json"),
+            kind: "runtime",
+            description: "Shared runtime index for the workspace."
+        },
+        {
+            path: path.join(workspaceRoot, ".hforge", "runtime", "README.md"),
+            kind: "runtime",
+            description: "Human-readable runtime summary and guidance."
+        },
+        {
+            path: path.join(workspaceRoot, ".hforge", "agent-manifest.json"),
+            kind: "generated",
+            description: "Machine-readable custom-agent manifest for bridges, canonical roots, and safe command discovery."
+        },
+        {
+            path: path.join(workspaceRoot, STATE_DIR, "post-install-guidance.txt"),
+            kind: "state",
+            description: "Operator next steps and recovery guidance."
+        }
+    ];
+}
+async function createTargetPlans(intent) {
+    const [bundles, profiles] = await Promise.all([loadBundleManifests(PACKAGE_ROOT), loadProfileManifests(PACKAGE_ROOT)]);
+    const profileDescriptor = getSetupProfileDescriptor(intent.setupProfile);
+    return Promise.all(intent.targetIds.map(async (targetId) => {
+        const [warnings, target] = await Promise.all([
+            validateEnvironment(PACKAGE_ROOT, targetId),
+            loadTargetAdapter(PACKAGE_ROOT, targetId)
+        ]);
+        const plan = createInstallPlan(PACKAGE_ROOT, {
+            targetId,
+            profileId: profileDescriptor.manifestProfileId,
+            bundleIds: [],
+            languageIds: [],
+            frameworkIds: [],
+            capabilityIds: [],
+            rootPath: intent.workspaceRoot,
+            mode: intent.dryRun || !intent.applyChanges ? "dry-run" : "apply"
+        }, bundles, profiles, target, { workspaceRoot: intent.workspaceRoot });
+        plan.warnings.push(...warnings);
+        return plan;
+    }));
+}
+export async function buildReviewPlan(intent) {
+    const installPlans = await createTargetPlans(intent);
+    const plannedWrites = [...createInitWrites(intent.workspaceRoot)];
+    for (const plan of installPlans) {
+        for (const operation of plan.operations) {
+            plannedWrites.push({
+                path: operation.destinationPath,
+                kind: operation.destinationPath.includes(".hforge") ? "runtime" : "bridge",
+                description: `${plan.selection.targetId}: ${operation.reason}`
+            });
+        }
+    }
+    const warnings = installPlans.flatMap((plan) => [...plan.warnings, ...plan.conflicts]);
+    const modules = intent.enabledModules.map((moduleId) => OPTIONAL_MODULE_LABELS[moduleId]);
+    const agentFlags = intent.targetIds.map((targetId) => `--agent ${targetId}`).join(" ");
+    return {
+        workspaceRoot: intent.workspaceRoot,
+        targetIds: intent.targetIds,
+        setupProfile: intent.setupProfile,
+        enabledModules: modules,
+        plannedWrites,
+        warnings: [...new Set(warnings)],
+        directCommandPreview: `hforge init --root ${intent.workspaceRoot} ${agentFlags} --setup-profile ${intent.setupProfile}${intent.dryRun ? " --dry-run" : " --yes"}`
+    };
+}
+export async function applySetupIntent(intent) {
+    const reviewPlan = await buildReviewPlan(intent);
+    if (intent.dryRun || !intent.applyChanges) {
+        return {
+            status: "preview",
+            workspaceRoot: intent.workspaceRoot,
+            appliedTargets: intent.targetIds,
+            writtenArtifacts: reviewPlan.plannedWrites.map((item) => item.path),
+            preservedArtifacts: [],
+            nextSuggestedCommands: [reviewPlan.directCommandPreview, `hforge status --root ${intent.workspaceRoot}`, `hforge shell setup --yes`],
+            importantPaths: [
+                path.join(intent.workspaceRoot, ".hforge", "runtime", "index.json"),
+                path.join(intent.workspaceRoot, ".hforge", "state", "install-state.json")
+            ],
+            operatorMessage: "Preview only. No files were written."
+        };
+    }
+    const initializeResult = await initializeWorkspace(intent.workspaceRoot, PACKAGE_ROOT);
+    const installPlans = await createTargetPlans(intent);
+    const writtenArtifacts = [...initializeResult.changedFiles];
+    const localLauncher = process.platform === "win32"
+        ? initializeResult.launcherPaths.find((entry) => entry.endsWith("hforge.cmd")) ?? initializeResult.launcherPaths[0]
+        : initializeResult.launcherPaths.find((entry) => entry.endsWith(`${path.sep}hforge`)) ?? initializeResult.launcherPaths[0];
+    for (const plan of installPlans) {
+        await applyInstall(intent.workspaceRoot, plan);
+        writtenArtifacts.push(...plan.operations.map((operation) => operation.destinationPath));
+    }
+    const existingState = await loadInstallState(intent.workspaceRoot);
+    if (existingState) {
+        await saveInstallState(intent.workspaceRoot, {
+            ...existingState,
+            preferredTargets: intent.targetIds,
+            setupProfile: intent.setupProfile,
+            enabledModules: intent.enabledModules,
+            lastAction: intent.targetIds.length > 0 ? "install" : "init",
+            timestamps: {
+                ...existingState.timestamps,
+                updatedAt: new Date().toISOString()
+            }
+        });
+    }
+    return {
+        status: "success",
+        workspaceRoot: intent.workspaceRoot,
+        appliedTargets: intent.targetIds,
+        writtenArtifacts,
+        preservedArtifacts: [],
+        nextSuggestedCommands: [
+            `${localLauncher} status --root ${intent.workspaceRoot}`,
+            `${localLauncher} refresh --root ${intent.workspaceRoot}`,
+            `${localLauncher} review --root ${intent.workspaceRoot}`,
+            `${localLauncher} shell setup --yes`,
+            "npm install -g @harness-forge/cli"
+        ],
+        importantPaths: [
+            initializeResult.agentManifestPath,
+            initializeResult.runtimeIndexPath,
+            initializeResult.statePath,
+            ...initializeResult.launcherPaths,
+            path.join(intent.workspaceRoot, ".hforge", "generated", "agent-command-catalog.json")
+        ],
+        operatorMessage: `Initialized Harness Forge at ${intent.workspaceRoot} with ${intent.targetIds.length} target${intent.targetIds.length === 1 ? "" : "s"}. Run shell setup if you want bare hforge on PATH without a global install.`
+    };
+}
+//# sourceMappingURL=review-plan.js.map

package/dist/cli/interactive/review-plan.js.map

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

package/dist/cli/interactive/review-summary.d.ts

@@ -0,0 +1,4 @@
+import type { TerminalCapabilityProfile } from "./terminal-capabilities.js";
+import type { ReviewPlanDocument } from "./review-plan.js";
+export declare function renderReviewSummary(reviewPlan: ReviewPlanDocument, capabilities: TerminalCapabilityProfile): string;
+//# sourceMappingURL=review-summary.d.ts.map

package/dist/cli/interactive/review-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-summary.d.ts","sourceRoot":"","sources":["../../../src/cli/interactive/review-summary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAC5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAI3D,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,kBAAkB,EAAE,YAAY,EAAE,yBAAyB,GAAG,MAAM,CAuBnH"}

package/dist/cli/interactive/review-summary.js

@@ -0,0 +1,20 @@
+import { renderBulletList, renderInfoCard, renderKeyValueTable, renderScreen } from "./renderers/screen-layout.js";
+import { styleHeading, stylePath, styleSection, styleWarning } from "./renderers/text-style.js";
+export function renderReviewSummary(reviewPlan, capabilities) {
+    return renderScreen(styleHeading(capabilities, "Review before write"), [
+        styleSection(capabilities, "Setup summary"),
+        renderKeyValueTable([
+            { label: "Workspace", value: reviewPlan.workspaceRoot },
+            { label: "Targets", value: reviewPlan.targetIds.join(", ") || "none" },
+            { label: "Setup profile", value: reviewPlan.setupProfile },
+            { label: "Modules", value: reviewPlan.enabledModules.join(", ") || "none" }
+        ]),
+        styleSection(capabilities, "Planned writes"),
+        renderBulletList(reviewPlan.plannedWrites.map((item) => `${stylePath(capabilities, item.path)} (${item.kind}) - ${item.description}`), capabilities),
+        reviewPlan.warnings.length > 0
+            ? `${styleWarning(capabilities, "Warnings")}\n${renderBulletList(reviewPlan.warnings, capabilities)}`
+            : renderInfoCard("Warnings", ["None"], capabilities),
+        renderInfoCard("Direct command preview", [reviewPlan.directCommandPreview], capabilities)
+    ], capabilities);
+}
+//# sourceMappingURL=review-summary.js.map

package/dist/cli/interactive/review-summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-summary.js","sourceRoot":"","sources":["../../../src/cli/interactive/review-summary.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACnH,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEhG,MAAM,UAAU,mBAAmB,CAAC,UAA8B,EAAE,YAAuC;IACzG,OAAO,YAAY,CACjB,YAAY,CAAC,YAAY,EAAE,qBAAqB,CAAC,EACjD;QACE,YAAY,CAAC,YAAY,EAAE,eAAe,CAAC;QAC3C,mBAAmB,CAAC;YAClB,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,CAAC,aAAa,EAAE;YACvD,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,EAAE;YACtE,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,UAAU,CAAC,YAAY,EAAE;YAC1D,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,EAAE;SAC5E,CAAC;QACF,YAAY,CAAC,YAAY,EAAE,gBAAgB,CAAC;QAC5C,gBAAgB,CACd,UAAU,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,SAAS,CAAC,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,EACpH,YAAY,CACb;QACD,UAAU,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;YAC5B,CAAC,CAAC,GAAG,YAAY,CAAC,YAAY,EAAE,UAAU,CAAC,KAAK,gBAAgB,CAAC,UAAU,CAAC,QAAQ,EAAE,YAAY,CAAC,EAAE;YACrG,CAAC,CAAC,cAAc,CAAC,UAAU,EAAE,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;QACtD,cAAc,CAAC,wBAAwB,EAAE,CAAC,UAAU,CAAC,oBAAoB,CAAC,EAAE,YAAY,CAAC;KAC1F,EACD,YAAY,CACb,CAAC;AACJ,CAAC"}

package/dist/cli/interactive/session-state.d.ts

@@ -0,0 +1,35 @@
+import type { ReviewPlanDocument } from "./review-plan.js";
+import type { SetupIntent } from "./setup-intent.js";
+export type InteractiveSessionMode = "onboarding" | "project-hub" | "guided-repair";
+export type InteractiveSessionState = "draft" | "gathering-input" | "review" | "applying" | "completed" | "cancelled" | "partial-failure";
+export interface RecoveryNotice {
+    reasonCode: string;
+    summary: string;
+    observedState: string[];
+    recommendedNextSteps: string[];
+    safeRetryCommand?: string;
+}
+export interface ExecutionSummary {
+    status: "success" | "cancelled" | "partial-failure" | "failed" | "preview";
+    workspaceRoot: string;
+    appliedTargets: string[];
+    writtenArtifacts: string[];
+    preservedArtifacts: string[];
+    nextSuggestedCommands: string[];
+    importantPaths: string[];
+    operatorMessage: string;
+}
+export interface InteractiveSession {
+    sessionId: string;
+    mode: InteractiveSessionMode;
+    state: InteractiveSessionState;
+    entryTimestamp: string;
+    activeStepId: string;
+    visitedStepIds: string[];
+    setupIntent?: SetupIntent;
+    reviewPlan?: ReviewPlanDocument;
+    recoveryNotice?: RecoveryNotice;
+    result?: ExecutionSummary;
+}
+export declare function createInteractiveSession(mode: InteractiveSessionMode): InteractiveSession;
+//# sourceMappingURL=session-state.d.ts.map

package/dist/cli/interactive/session-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-state.d.ts","sourceRoot":"","sources":["../../../src/cli/interactive/session-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,MAAM,sBAAsB,GAAG,YAAY,GAAG,aAAa,GAAG,eAAe,CAAC;AACpF,MAAM,MAAM,uBAAuB,GAC/B,OAAO,GACP,iBAAiB,GACjB,QAAQ,GACR,UAAU,GACV,WAAW,GACX,WAAW,GACX,iBAAiB,CAAC;AAEtB,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,iBAAiB,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC3E,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,sBAAsB,CAAC;IAC7B,KAAK,EAAE,uBAAuB,CAAC;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,sBAAsB,GAAG,kBAAkB,CASzF"}

package/dist/cli/interactive/session-state.js

@@ -0,0 +1,11 @@
+export function createInteractiveSession(mode) {
+    return {
+        sessionId: `IFS-${Date.now()}`,
+        mode,
+        state: "draft",
+        entryTimestamp: new Date().toISOString(),
+        activeStepId: "welcome",
+        visitedStepIds: ["welcome"]
+    };
+}
+//# sourceMappingURL=session-state.js.map

package/dist/cli/interactive/session-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-state.js","sourceRoot":"","sources":["../../../src/cli/interactive/session-state.ts"],"names":[],"mappings":"AA6CA,MAAM,UAAU,wBAAwB,CAAC,IAA4B;IACnE,OAAO;QACL,SAAS,EAAE,OAAO,IAAI,CAAC,GAAG,EAAE,EAAE;QAC9B,IAAI;QACJ,KAAK,EAAE,OAAO;QACd,cAAc,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACxC,YAAY,EAAE,SAAS;QACvB,cAAc,EAAE,CAAC,SAAS,CAAC;KAC5B,CAAC;AACJ,CAAC"}

package/dist/cli/interactive/setup-intent.d.ts

@@ -0,0 +1,32 @@
+export type FolderSelectionMode = "current-directory" | "custom-path" | "new-folder";
+export type SetupProfileId = "quick" | "recommended" | "advanced";
+export type OptionalModuleId = "working-memory" | "task-pack-support" | "decision-templates" | "export-support" | "recursive-runtime";
+export interface FolderSelection {
+    selectionMode: FolderSelectionMode;
+    requestedPath: string;
+    resolvedPath: string;
+}
+export interface SetupIntent {
+    workspaceRoot: string;
+    folderSelection: FolderSelection;
+    targetIds: string[];
+    setupProfile: SetupProfileId;
+    enabledModules: OptionalModuleId[];
+    recommendedTargetIds: string[];
+    dryRun: boolean;
+    applyChanges: boolean;
+    source: "interactive" | "direct";
+}
+export interface SetupProfileDescriptor {
+    id: SetupProfileId;
+    displayName: string;
+    description: string;
+    manifestProfileId: string;
+    defaultModules: OptionalModuleId[];
+}
+export declare const OPTIONAL_MODULE_LABELS: Record<OptionalModuleId, string>;
+export declare const OPTIONAL_MODULE_DESCRIPTIONS: Record<OptionalModuleId, string>;
+export declare const SETUP_PROFILES: SetupProfileDescriptor[];
+export declare function getSetupProfileDescriptor(profileId: SetupProfileId): SetupProfileDescriptor;
+export declare function normalizeFolderSelection(baseRoot: string, mode: FolderSelectionMode, requestedPath: string): FolderSelection;
+//# sourceMappingURL=setup-intent.d.ts.map

package/dist/cli/interactive/setup-intent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-intent.d.ts","sourceRoot":"","sources":["../../../src/cli/interactive/setup-intent.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,mBAAmB,GAAG,mBAAmB,GAAG,aAAa,GAAG,YAAY,CAAC;AACrF,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,aAAa,GAAG,UAAU,CAAC;AAClE,MAAM,MAAM,gBAAgB,GACxB,gBAAgB,GAChB,mBAAmB,GACnB,oBAAoB,GACpB,gBAAgB,GAChB,mBAAmB,CAAC;AAExB,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,mBAAmB,CAAC;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,eAAe,CAAC;IACjC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,EAAE,cAAc,CAAC;IAC7B,cAAc,EAAE,gBAAgB,EAAE,CAAC;IACnC,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,aAAa,GAAG,QAAQ,CAAC;CAClC;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,cAAc,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,gBAAgB,EAAE,CAAC;CACpC;AAED,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAMnE,CAAC;AAEF,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAMzE,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,sBAAsB,EAsBlD,CAAC;AAEF,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,cAAc,GAAG,sBAAsB,CAM3F;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,GAAG,eAAe,CAS5H"}

package/dist/cli/interactive/setup-intent.js

@@ -0,0 +1,54 @@
+import path from "node:path";
+export const OPTIONAL_MODULE_LABELS = {
+    "working-memory": "Working memory",
+    "task-pack-support": "Task-pack support",
+    "decision-templates": "Decision templates",
+    "export-support": "Export support",
+    "recursive-runtime": "Recursive runtime"
+};
+export const OPTIONAL_MODULE_DESCRIPTIONS = {
+    "working-memory": "Keeps compact cached task context under the hidden runtime.",
+    "task-pack-support": "Prepares task-oriented runtime artifacts and pack inspection flows.",
+    "decision-templates": "Keeps governance and decision-record surfaces visible for architecture-significant work.",
+    "export-support": "Keeps review and export handoff flows easy to reach after setup.",
+    "recursive-runtime": "Leaves recursive session support available for difficult investigations."
+};
+export const SETUP_PROFILES = [
+    {
+        id: "quick",
+        displayName: "Quick",
+        description: "Minimal prompts with sensible defaults and a mandatory review before writes.",
+        manifestProfileId: "core",
+        defaultModules: ["export-support"]
+    },
+    {
+        id: "recommended",
+        displayName: "Recommended",
+        description: "Best default for most repos, balancing guidance, intelligence, and maintenance.",
+        manifestProfileId: "developer",
+        defaultModules: ["working-memory", "task-pack-support", "export-support"]
+    },
+    {
+        id: "advanced",
+        displayName: "Advanced",
+        description: "Full decision surface with optional modules and deeper runtime features.",
+        manifestProfileId: "ai-runtime",
+        defaultModules: ["working-memory", "task-pack-support", "decision-templates", "export-support", "recursive-runtime"]
+    }
+];
+export function getSetupProfileDescriptor(profileId) {
+    const profile = SETUP_PROFILES.find((candidate) => candidate.id === profileId);
+    if (!profile) {
+        throw new Error(`Unknown setup profile: ${profileId}`);
+    }
+    return profile;
+}
+export function normalizeFolderSelection(baseRoot, mode, requestedPath) {
+    const resolvedPath = mode === "current-directory" ? path.resolve(baseRoot) : path.resolve(baseRoot, requestedPath || ".");
+    return {
+        selectionMode: mode,
+        requestedPath: requestedPath || ".",
+        resolvedPath
+    };
+}
+//# sourceMappingURL=setup-intent.js.map

package/dist/cli/interactive/setup-intent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-intent.js","sourceRoot":"","sources":["../../../src/cli/interactive/setup-intent.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAqC7B,MAAM,CAAC,MAAM,sBAAsB,GAAqC;IACtE,gBAAgB,EAAE,gBAAgB;IAClC,mBAAmB,EAAE,mBAAmB;IACxC,oBAAoB,EAAE,oBAAoB;IAC1C,gBAAgB,EAAE,gBAAgB;IAClC,mBAAmB,EAAE,mBAAmB;CACzC,CAAC;AAEF,MAAM,CAAC,MAAM,4BAA4B,GAAqC;IAC5E,gBAAgB,EAAE,6DAA6D;IAC/E,mBAAmB,EAAE,qEAAqE;IAC1F,oBAAoB,EAAE,0FAA0F;IAChH,gBAAgB,EAAE,kEAAkE;IACpF,mBAAmB,EAAE,0EAA0E;CAChG,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAA6B;IACtD;QACE,EAAE,EAAE,OAAO;QACX,WAAW,EAAE,OAAO;QACpB,WAAW,EAAE,8EAA8E;QAC3F,iBAAiB,EAAE,MAAM;QACzB,cAAc,EAAE,CAAC,gBAAgB,CAAC;KACnC;IACD;QACE,EAAE,EAAE,aAAa;QACjB,WAAW,EAAE,aAAa;QAC1B,WAAW,EAAE,iFAAiF;QAC9F,iBAAiB,EAAE,WAAW;QAC9B,cAAc,EAAE,CAAC,gBAAgB,EAAE,mBAAmB,EAAE,gBAAgB,CAAC;KAC1E;IACD;QACE,EAAE,EAAE,UAAU;QACd,WAAW,EAAE,UAAU;QACvB,WAAW,EAAE,0EAA0E;QACvF,iBAAiB,EAAE,YAAY;QAC/B,cAAc,EAAE,CAAC,gBAAgB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,mBAAmB,CAAC;KACrH;CACF,CAAC;AAEF,MAAM,UAAU,yBAAyB,CAAC,SAAyB;IACjE,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC;IAC/E,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,0BAA0B,SAAS,EAAE,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,QAAgB,EAAE,IAAyB,EAAE,aAAqB;IACzG,MAAM,YAAY,GAChB,IAAI,KAAK,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,aAAa,IAAI,GAAG,CAAC,CAAC;IAEvG,OAAO;QACL,aAAa,EAAE,IAAI;QACnB,aAAa,EAAE,aAAa,IAAI,GAAG;QACnC,YAAY;KACb,CAAC;AACJ,CAAC"}

package/dist/cli/interactive/terminal-capabilities.d.ts

@@ -0,0 +1,20 @@
+export type InteractiveColorLevel = "full" | "reduced" | "none";
+export type InteractivePresentationTier = "rich" | "compact" | "minimal" | "non-interactive";
+export interface TerminalCapabilityProfile {
+    supportsInteractiveInput: boolean;
+    colorLevel: InteractiveColorLevel;
+    terminalWidth: number;
+    prefersAsciiSafeOutput: boolean;
+    screenReaderSafeMode: boolean;
+    isWindowsLike: boolean;
+    presentationTier: InteractivePresentationTier;
+}
+export interface DetectTerminalCapabilitiesOptions {
+    env?: NodeJS.ProcessEnv;
+    stdinIsTTY?: boolean;
+    stdoutIsTTY?: boolean;
+    columns?: number;
+    platform?: NodeJS.Platform;
+}
+export declare function detectTerminalCapabilities(options?: DetectTerminalCapabilitiesOptions): TerminalCapabilityProfile;
+//# sourceMappingURL=terminal-capabilities.d.ts.map

package/dist/cli/interactive/terminal-capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-capabilities.d.ts","sourceRoot":"","sources":["../../../src/cli/interactive/terminal-capabilities.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AAChE,MAAM,MAAM,2BAA2B,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,iBAAiB,CAAC;AAE7F,MAAM,WAAW,yBAAyB;IACxC,wBAAwB,EAAE,OAAO,CAAC;IAClC,UAAU,EAAE,qBAAqB,CAAC;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,sBAAsB,EAAE,OAAO,CAAC;IAChC,oBAAoB,EAAE,OAAO,CAAC;IAC9B,aAAa,EAAE,OAAO,CAAC;IACvB,gBAAgB,EAAE,2BAA2B,CAAC;CAC/C;AAED,MAAM,WAAW,iCAAiC;IAChD,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;CAC5B;AAoCD,wBAAgB,0BAA0B,CACxC,OAAO,GAAE,iCAAsC,GAC9C,yBAAyB,CAqC3B"}

package/dist/cli/interactive/terminal-capabilities.js

@@ -0,0 +1,69 @@
+import os from "node:os";
+function parseForcedTty(value) {
+    if (!value) {
+        return null;
+    }
+    const normalized = value.trim().toLowerCase();
+    if (["1", "true", "yes", "on"].includes(normalized)) {
+        return true;
+    }
+    if (["0", "false", "no", "off"].includes(normalized)) {
+        return false;
+    }
+    return null;
+}
+function detectColorLevel(env, stdoutIsTTY) {
+    if (env.NO_COLOR || !stdoutIsTTY) {
+        return "none";
+    }
+    const forceColor = env.FORCE_COLOR?.trim();
+    if (forceColor === "0") {
+        return "none";
+    }
+    if (forceColor === "1") {
+        return "reduced";
+    }
+    if (forceColor === "2" || forceColor === "3") {
+        return "full";
+    }
+    return stdoutIsTTY ? "full" : "none";
+}
+export function detectTerminalCapabilities(options = {}) {
+    const env = options.env ?? process.env;
+    const forcedTty = parseForcedTty(env.HFORGE_FORCE_TTY);
+    const stdinIsTTY = forcedTty ?? options.stdinIsTTY ?? process.stdin.isTTY ?? false;
+    const stdoutIsTTY = forcedTty ?? options.stdoutIsTTY ?? process.stdout.isTTY ?? false;
+    const supportsInteractiveInput = stdinIsTTY && stdoutIsTTY && env.CI !== "true";
+    const terminalWidth = Number.parseInt(env.HFORGE_TERM_WIDTH ?? `${options.columns ?? process.stdout.columns ?? 80}`, 10);
+    const colorLevel = detectColorLevel(env, stdoutIsTTY);
+    const platform = options.platform ?? process.platform;
+    const screenReaderSafeMode = env.HFORGE_SCREEN_READER === "1";
+    const prefersAsciiSafeOutput = env.HFORGE_ASCII === "1" ||
+        colorLevel === "none" ||
+        screenReaderSafeMode ||
+        env.TERM === "dumb";
+    const width = Number.isFinite(terminalWidth) && terminalWidth > 0 ? terminalWidth : 80;
+    let presentationTier;
+    if (!supportsInteractiveInput) {
+        presentationTier = "non-interactive";
+    }
+    else if (width < 52) {
+        presentationTier = "minimal";
+    }
+    else if (width < 80 || colorLevel === "none") {
+        presentationTier = "compact";
+    }
+    else {
+        presentationTier = "rich";
+    }
+    return {
+        supportsInteractiveInput,
+        colorLevel,
+        terminalWidth: width,
+        prefersAsciiSafeOutput,
+        screenReaderSafeMode,
+        isWindowsLike: platform === "win32" || os.platform() === "win32",
+        presentationTier
+    };
+}
+//# sourceMappingURL=terminal-capabilities.js.map

package/dist/cli/interactive/terminal-capabilities.js.map

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

package/dist/domain/capabilities/capability-record.d.ts

@@ -0,0 +1,25 @@
+export type CapabilitySupportLevel = "full" | "partial" | "emulated" | "unsupported";
+export type CapabilitySupportMode = "native" | "translated" | "emulated" | "documentation-only" | "unsupported";
+export interface CapabilityRecord {
+    capabilityId: string;
+    supportLevel: CapabilitySupportLevel;
+    supportMode: CapabilitySupportMode;
+    evidenceSource: string[];
+    lastValidatedAt: string;
+    validationMethod: string;
+    confidence: number;
+    notes?: string;
+    fallbackBehavior?: string;
+}
+export interface CapabilityTargetRecord {
+    targetId: string;
+    displayName: string;
+    supportLevel: CapabilitySupportLevel;
+    capabilities: CapabilityRecord[];
+}
+export interface HarnessCapabilityMatrixDocument {
+    version: number;
+    generatedAt: string;
+    targets: CapabilityTargetRecord[];
+}
+//# sourceMappingURL=capability-record.d.ts.map

package/dist/domain/capabilities/capability-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-record.d.ts","sourceRoot":"","sources":["../../../src/domain/capabilities/capability-record.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,aAAa,CAAC;AACrF,MAAM,MAAM,qBAAqB,GAC7B,QAAQ,GACR,YAAY,GACZ,UAAU,GACV,oBAAoB,GACpB,aAAa,CAAC;AAElB,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,sBAAsB,CAAC;IACrC,WAAW,EAAE,qBAAqB,CAAC;IACnC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,sBAAsB,CAAC;IACrC,YAAY,EAAE,gBAAgB,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,+BAA+B;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,sBAAsB,EAAE,CAAC;CACnC"}

package/dist/domain/capabilities/capability-record.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=capability-record.js.map

package/dist/domain/capabilities/capability-record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-record.js","sourceRoot":"","sources":["../../../src/domain/capabilities/capability-record.ts"],"names":[],"mappings":""}

package/dist/domain/capabilities/capability-taxonomy.d.ts

@@ -0,0 +1,11 @@
+export interface CapabilityTaxonomyEntry {
+    id: string;
+    family: string;
+    displayName: string;
+    description: string;
+}
+export interface CapabilityTaxonomyDocument {
+    version: number;
+    capabilities: CapabilityTaxonomyEntry[];
+}
+//# sourceMappingURL=capability-taxonomy.d.ts.map

package/dist/domain/capabilities/capability-taxonomy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-taxonomy.d.ts","sourceRoot":"","sources":["../../../src/domain/capabilities/capability-taxonomy.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,uBAAuB,EAAE,CAAC;CACzC"}

package/dist/domain/capabilities/capability-taxonomy.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=capability-taxonomy.js.map

package/dist/domain/capabilities/capability-taxonomy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-taxonomy.js","sourceRoot":"","sources":["../../../src/domain/capabilities/capability-taxonomy.ts"],"names":[],"mappings":""}

package/dist/domain/intelligence/instruction-plan.d.ts

@@ -0,0 +1,26 @@
+export interface InstructionRecommendation {
+    path: string;
+    surfaceType: string;
+    reason: string;
+    confidence: number;
+    evidence: string[];
+    writeMode: "recommend-only" | "diff" | "write";
+}
+export interface InstructionPlan {
+    workspaceId: string;
+    targetId: string;
+    scopeStrategy: "root-only" | "mixed-scope" | "scoped-heavy";
+    generatedAt?: string;
+    sharedRuntimeRoot?: string;
+    sharedRuntimeBridges?: string[];
+    sharedRuntimeArtifacts?: string[];
+    authoritativeAiLayerRoot?: string;
+    authoritativeHiddenSurfaces?: string[];
+    visibleBridgePaths?: string[];
+    recommendations: InstructionRecommendation[];
+    recommendedProfiles: string[];
+    recommendedSkills: string[];
+    generatedArtifacts: string[];
+    riskNotes: string[];
+}
+//# sourceMappingURL=instruction-plan.d.ts.map

package/dist/domain/intelligence/instruction-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instruction-plan.d.ts","sourceRoot":"","sources":["../../../src/domain/intelligence/instruction-plan.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,gBAAgB,GAAG,MAAM,GAAG,OAAO,CAAC;CAChD;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,WAAW,GAAG,aAAa,GAAG,cAAc,CAAC;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;IAClC,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,2BAA2B,CAAC,EAAE,MAAM,EAAE,CAAC;IACvC,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,eAAe,EAAE,yBAAyB,EAAE,CAAC;IAC7C,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB"}

package/dist/domain/intelligence/instruction-plan.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=instruction-plan.js.map

package/dist/domain/intelligence/instruction-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instruction-plan.js","sourceRoot":"","sources":["../../../src/domain/intelligence/instruction-plan.ts"],"names":[],"mappings":""}