@harness-forge/cli 0.1.0

package/dist/application/install/shell-integration.js

@@ -0,0 +1,232 @@
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { spawnSync } from "node:child_process";
+import { exists, writeTextFile } from "../../shared/index.js";
+const START_MARKER = "# >>> Harness Forge shell integration >>>";
+const END_MARKER = "# <<< Harness Forge shell integration <<<";
+function detectHomeDir(env) {
+    return env.USERPROFILE ?? env.HOME ?? os.homedir();
+}
+function detectShell(platform, env) {
+    if (platform === "win32") {
+        return { shell: "powershell", shellLabel: "powershell" };
+    }
+    const rawShell = path.basename(env.SHELL ?? "").toLowerCase();
+    if (rawShell === "bash") {
+        return { shell: "bash", shellLabel: rawShell };
+    }
+    if (rawShell === "zsh") {
+        return { shell: "zsh", shellLabel: rawShell };
+    }
+    return { shell: "unsupported", shellLabel: rawShell || "unknown" };
+}
+function detectProfilePath(platform, shell, homeDir) {
+    if (platform === "win32") {
+        return path.join(homeDir, "Documents", "PowerShell", "Microsoft.PowerShell_profile.ps1");
+    }
+    if (shell === "bash") {
+        return path.join(homeDir, ".bashrc");
+    }
+    if (shell === "zsh") {
+        return path.join(homeDir, ".zshrc");
+    }
+    return null;
+}
+function buildShimDir(platform, homeDir) {
+    return platform === "win32" ? path.join(homeDir, ".hforge", "bin") : path.join(homeDir, ".hforge", "bin");
+}
+function buildShimPaths(platform, shimDir) {
+    if (platform === "win32") {
+        return [path.join(shimDir, "hforge.cmd"), path.join(shimDir, "hforge.ps1")];
+    }
+    return [path.join(shimDir, "hforge")];
+}
+function buildManualCommands(context) {
+    if (context.platform === "win32") {
+        return [
+            `$env:PATH = "${context.shimDir};$env:PATH"`,
+            `[Environment]::SetEnvironmentVariable("Path", "${context.shimDir};" + [Environment]::GetEnvironmentVariable("Path", "User"), "User")`
+        ];
+    }
+    return [`export PATH="${context.shimDir}:$PATH"`];
+}
+export function detectShellIntegrationContext(platform = process.platform, env = process.env) {
+    const homeDir = detectHomeDir(env);
+    const detected = detectShell(platform, env);
+    const shimDir = buildShimDir(platform, homeDir);
+    const shimPaths = buildShimPaths(platform, shimDir);
+    const context = {
+        platform,
+        homeDir,
+        shell: detected.shell,
+        shellLabel: detected.shellLabel,
+        profilePath: detectProfilePath(platform, detected.shell, homeDir),
+        shimDir,
+        shimPaths,
+        manualCommands: []
+    };
+    context.manualCommands = buildManualCommands(context);
+    return context;
+}
+function renderManagedProfileBlock(context) {
+    if (context.platform === "win32") {
+        return [
+            START_MARKER,
+            '$hforgeBin = Join-Path $HOME ".hforge\\bin"',
+            'if (-not (($env:PATH -split ";") -contains $hforgeBin)) {',
+            '  $env:PATH = "$hforgeBin;$env:PATH"',
+            "}",
+            END_MARKER
+        ].join("\n");
+    }
+    return [
+        START_MARKER,
+        'HFORGE_BIN="$HOME/.hforge/bin"',
+        'case ":$PATH:" in',
+        '  *":$HFORGE_BIN:"*) ;;',
+        '  *) export PATH="$HFORGE_BIN:$PATH" ;;',
+        "esac",
+        END_MARKER
+    ].join("\n");
+}
+function renderShimFile(filePath) {
+    if (filePath.endsWith(".cmd")) {
+        return "@echo off\nnpx @harness-forge/cli %*\n";
+    }
+    if (filePath.endsWith(".ps1")) {
+        return [
+            "param(",
+            "  [Parameter(ValueFromRemainingArguments = $true)]",
+            "  [string[]]$Args",
+            ")",
+            "",
+            "npx @harness-forge/cli @Args"
+        ].join("\n") + "\n";
+    }
+    return "#!/usr/bin/env sh\nnpx @harness-forge/cli \"$@\"\n";
+}
+async function updateManagedProfile(profilePath, managedBlock) {
+    const profileExists = await exists(profilePath);
+    const existing = profileExists ? await fs.readFile(profilePath, "utf8") : "";
+    const startIndex = existing.indexOf(START_MARKER);
+    const endIndex = existing.indexOf(END_MARKER);
+    const replacement = `${managedBlock}\n`;
+    let nextContent = existing;
+    if (startIndex >= 0 && endIndex >= startIndex) {
+        const before = existing.slice(0, startIndex).replace(/\s*$/u, "");
+        const after = existing.slice(endIndex + END_MARKER.length).replace(/^\s*/u, "");
+        nextContent = [before, replacement.trimEnd(), after].filter((entry) => entry.length > 0).join("\n\n") + "\n";
+    }
+    else if (existing.trim().length === 0) {
+        nextContent = replacement;
+    }
+    else {
+        nextContent = `${existing.replace(/\s*$/u, "")}\n\n${replacement}`;
+    }
+    if (nextContent === existing) {
+        return false;
+    }
+    await writeTextFile(profilePath, nextContent);
+    return true;
+}
+function resolveBareHforge(platform) {
+    const result = platform === "win32"
+        ? spawnSync("cmd.exe", ["/d", "/s", "/c", "where hforge"], { encoding: "utf8", stdio: "pipe" })
+        : spawnSync("sh", ["-lc", "command -v hforge"], { encoding: "utf8", stdio: "pipe" });
+    if ((result.status ?? 1) !== 0) {
+        return { bareHforgeResolvable: false, resolvedCommandPath: null };
+    }
+    const firstLine = result.stdout
+        .split(/\r?\n/u)
+        .map((entry) => entry.trim())
+        .find((entry) => entry.length > 0);
+    return {
+        bareHforgeResolvable: Boolean(firstLine),
+        resolvedCommandPath: firstLine ?? null
+    };
+}
+export async function getShellIntegrationStatus(platform = process.platform, env = process.env) {
+    const context = detectShellIntegrationContext(platform, env);
+    const profileExists = context.profilePath ? await exists(context.profilePath) : false;
+    const profileContent = profileExists && context.profilePath ? await fs.readFile(context.profilePath, "utf8") : "";
+    const existingShimPaths = [];
+    for (const shimPath of context.shimPaths) {
+        if (await exists(shimPath)) {
+            existingShimPaths.push(shimPath);
+        }
+    }
+    const resolved = resolveBareHforge(platform);
+    return {
+        platform,
+        shell: context.shell,
+        shellLabel: context.shellLabel,
+        profilePath: context.profilePath,
+        shimDir: context.shimDir,
+        shimPaths: context.shimPaths,
+        shimExists: existingShimPaths.length === context.shimPaths.length,
+        existingShimPaths,
+        profileExists,
+        profileManagedBlockPresent: profileContent.includes(START_MARKER) && profileContent.includes(END_MARKER),
+        bareHforgeResolvable: resolved.bareHforgeResolvable,
+        resolvedCommandPath: resolved.resolvedCommandPath,
+        manualCommands: context.manualCommands
+    };
+}
+export async function setupShellIntegration(applyChanges, platform = process.platform, env = process.env) {
+    const context = detectShellIntegrationContext(platform, env);
+    const statusBefore = await getShellIntegrationStatus(platform, env);
+    const changedFiles = [];
+    let profileUpdated = false;
+    let shimsWritten = false;
+    if (applyChanges) {
+        await fs.mkdir(context.shimDir, { recursive: true });
+        for (const shimPath of context.shimPaths) {
+            await writeTextFile(shimPath, renderShimFile(shimPath));
+            changedFiles.push(shimPath);
+            shimsWritten = true;
+            if (!shimPath.endsWith(".cmd") && !shimPath.endsWith(".ps1")) {
+                try {
+                    await fs.chmod(shimPath, 0o755);
+                }
+                catch {
+                    // Ignore chmod failures on filesystems that do not preserve POSIX modes.
+                }
+            }
+        }
+        if (context.profilePath && context.shell !== "unsupported") {
+            profileUpdated = await updateManagedProfile(context.profilePath, renderManagedProfileBlock(context));
+            if (profileUpdated) {
+                changedFiles.push(context.profilePath);
+            }
+        }
+    }
+    const statusAfter = await getShellIntegrationStatus(platform, env);
+    const profileBlockPreview = context.profilePath && context.shell !== "unsupported" ? renderManagedProfileBlock(context) : null;
+    const previewSummary = [
+        `Shell: ${statusAfter.shellLabel}`,
+        `Shim directory: ${statusAfter.shimDir}`,
+        `Profile target: ${statusAfter.profilePath ?? "manual setup required"}`,
+        statusAfter.shell === "unsupported"
+            ? "Shell profile updates are not supported automatically for this shell."
+            : "Harness Forge can manage PATH through an idempotent profile block."
+    ];
+    const nextSteps = statusAfter.shell === "unsupported"
+        ? [...statusAfter.manualCommands, "Restart your shell after adding the PATH entry."]
+        : [
+            "Restart your shell or reload your profile to pick up the PATH change.",
+            "Run `hforge shell status --json` to confirm bare `hforge` is now resolvable."
+        ];
+    return {
+        ...statusAfter,
+        applyRequested: applyChanges,
+        changedFiles,
+        profileUpdated,
+        shimsWritten,
+        requiresManualPathStep: statusAfter.shell === "unsupported",
+        previewSummary,
+        profileBlockPreview,
+        nextSteps: applyChanges ? nextSteps : [...statusBefore.manualCommands]
+    };
+}
+//# sourceMappingURL=shell-integration.js.map

package/dist/application/install/shell-integration.js.map

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

package/dist/application/install/validate-environment.d.ts

@@ -0,0 +1,2 @@
+export declare function validateEnvironment(root: string, targetId: string): Promise<string[]>;
+//# sourceMappingURL=validate-environment.d.ts.map

package/dist/application/install/validate-environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-environment.d.ts","sourceRoot":"","sources":["../../../src/application/install/validate-environment.ts"],"names":[],"mappings":"AAIA,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAoB3F"}

package/dist/application/install/validate-environment.js

@@ -0,0 +1,19 @@
+import path from "node:path";
+import { exists, ValidationError } from "../../shared/index.js";
+export async function validateEnvironment(root, targetId) {
+    const warnings = [];
+    if (!(await exists(path.join(root, "manifests", "catalog", "index.json")))) {
+        throw new ValidationError("Catalog index is missing.");
+    }
+    if (!(await exists(path.join(root, "targets", targetId, "adapter.json")))) {
+        throw new ValidationError(`Unknown target adapter: ${targetId}`);
+    }
+    if (!(await exists(path.join(root, "templates")))) {
+        warnings.push("Template catalog directory is missing.");
+    }
+    if (!(await exists(path.join(root, ".specify")))) {
+        warnings.push(".specify is missing, so workflow-quality installs will be incomplete.");
+    }
+    return warnings;
+}
+//# sourceMappingURL=validate-environment.js.map

package/dist/application/install/validate-environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-environment.js","sourceRoot":"","sources":["../../../src/application/install/validate-environment.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAEhE,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAAY,EAAE,QAAgB;IACtE,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3E,MAAM,IAAI,eAAe,CAAC,2BAA2B,CAAC,CAAC;IACzD,CAAC;IAED,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1E,MAAM,IAAI,eAAe,CAAC,2BAA2B,QAAQ,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;QAClD,QAAQ,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;IAC1D,CAAC;IAED,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,QAAQ,CAAC,IAAI,CAAC,uEAAuE,CAAC,CAAC;IACzF,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/application/install/workspace-launcher.d.ts

@@ -0,0 +1,7 @@
+export interface WorkspaceLauncherPaths {
+    shellPath: string;
+    cmdPath: string;
+    ps1Path: string;
+}
+export declare function writeWorkspaceLaunchers(workspaceRoot: string): Promise<WorkspaceLauncherPaths>;
+//# sourceMappingURL=workspace-launcher.d.ts.map

package/dist/application/install/workspace-launcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-launcher.d.ts","sourceRoot":"","sources":["../../../src/application/install/workspace-launcher.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AA2BD,wBAAsB,uBAAuB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAoBpG"}

package/dist/application/install/workspace-launcher.js

@@ -0,0 +1,45 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { GENERATED_DIR, ensureDir, writeTextFile } from "../../shared/index.js";
+function shellLauncherContents() {
+    return [
+        "#!/usr/bin/env sh",
+        "npx @harness-forge/cli \"$@\""
+    ].join("\n") + "\n";
+}
+function cmdLauncherContents() {
+    return [
+        "@echo off",
+        "npx @harness-forge/cli %*"
+    ].join("\n") + "\n";
+}
+function powershellLauncherContents() {
+    return [
+        "param(",
+        "  [Parameter(ValueFromRemainingArguments = $true)]",
+        "  [string[]]$Args",
+        ")",
+        "",
+        "npx @harness-forge/cli @Args"
+    ].join("\n") + "\n";
+}
+export async function writeWorkspaceLaunchers(workspaceRoot) {
+    const binDir = path.join(workspaceRoot, GENERATED_DIR, "bin");
+    const shellPath = path.join(binDir, "hforge");
+    const cmdPath = path.join(binDir, "hforge.cmd");
+    const ps1Path = path.join(binDir, "hforge.ps1");
+    await ensureDir(binDir);
+    await Promise.all([
+        writeTextFile(shellPath, shellLauncherContents()),
+        writeTextFile(cmdPath, cmdLauncherContents()),
+        writeTextFile(ps1Path, powershellLauncherContents())
+    ]);
+    try {
+        await fs.chmod(shellPath, 0o755);
+    }
+    catch {
+        // Ignore chmod failures on filesystems that do not preserve POSIX modes.
+    }
+    return { shellPath, cmdPath, ps1Path };
+}
+//# sourceMappingURL=workspace-launcher.js.map

package/dist/application/install/workspace-launcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-launcher.js","sourceRoot":"","sources":["../../../src/application/install/workspace-launcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAQhF,SAAS,qBAAqB;IAC5B,OAAO;QACL,mBAAmB;QACnB,+BAA+B;KAChC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AACtB,CAAC;AAED,SAAS,mBAAmB;IAC1B,OAAO;QACL,WAAW;QACX,2BAA2B;KAC5B,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AACtB,CAAC;AAED,SAAS,0BAA0B;IACjC,OAAO;QACL,QAAQ;QACR,oDAAoD;QACpD,mBAAmB;QACnB,GAAG;QACH,EAAE;QACF,8BAA8B;KAC/B,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AACtB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,aAAqB;IACjE,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,aAAa,EAAE,KAAK,CAAC,CAAC;IAC9D,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAEhD,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC;IACxB,MAAM,OAAO,CAAC,GAAG,CAAC;QAChB,aAAa,CAAC,SAAS,EAAE,qBAAqB,EAAE,CAAC;QACjD,aAAa,CAAC,OAAO,EAAE,mBAAmB,EAAE,CAAC;QAC7C,aAAa,CAAC,OAAO,EAAE,0BAA0B,EAAE,CAAC;KACrD,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,yEAAyE;IAC3E,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AACzC,CAAC"}

package/dist/application/maintenance/audit-install.d.ts

@@ -0,0 +1,17 @@
+export interface AuditReport {
+    workspaceRoot: string;
+    packageVersion: string;
+    installedTargets: string[];
+    installedBundles: string[];
+    missingManagedPaths: string[];
+    missingBundles: string[];
+    packageSurfaceMissingPaths: string[];
+    staleTaskArtifacts: Array<{
+        path: string;
+        taskId: string;
+        artifactType: "file-interest" | "impact-analysis" | "task-pack";
+        reasons: string[];
+    }>;
+}
+export declare function createAuditReport(workspaceRoot: string, packageRoot: string): Promise<AuditReport>;
+//# sourceMappingURL=audit-install.d.ts.map

package/dist/application/maintenance/audit-install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-install.d.ts","sourceRoot":"","sources":["../../../src/application/maintenance/audit-install.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,0BAA0B,EAAE,MAAM,EAAE,CAAC;IACrC,kBAAkB,EAAE,KAAK,CAAC;QACxB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,eAAe,GAAG,iBAAiB,GAAG,WAAW,CAAC;QAChE,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC,CAAC;CACJ;AAED,wBAAsB,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CA2BxG"}

package/dist/application/maintenance/audit-install.js

@@ -0,0 +1,31 @@
+import path from "node:path";
+import { loadBundleManifests } from "../../domain/manifests/index.js";
+import { loadInstallState } from "../../domain/state/install-state.js";
+import { reconcileState } from "../install/reconcile-state.js";
+import { readJsonFile } from "../../shared/index.js";
+import { listStaleTaskAnalysisArtifacts } from "../runtime/task-runtime-store.js";
+export async function createAuditReport(workspaceRoot, packageRoot) {
+    const state = await loadInstallState(workspaceRoot);
+    const [reconcile, bundles, packageJson, packageSurface] = await Promise.all([
+        reconcileState(workspaceRoot),
+        loadBundleManifests(packageRoot),
+        readJsonFile(path.join(packageRoot, "package.json")),
+        readJsonFile(path.join(packageRoot, "manifests", "catalog", "package-surface.json"))
+    ]);
+    const knownBundleIds = new Set(bundles.map((bundle) => bundle.id));
+    const missingBundles = (state?.installedBundles ?? []).filter((bundleId) => !knownBundleIds.has(bundleId));
+    return {
+        workspaceRoot,
+        packageVersion: packageJson.version,
+        installedTargets: state?.installedTargets ?? [],
+        installedBundles: state?.installedBundles ?? [],
+        missingManagedPaths: reconcile.missing,
+        missingBundles,
+        packageSurfaceMissingPaths: await Promise.all(packageSurface.requiredPaths.map(async (relativePath) => ({
+            relativePath,
+            exists: await import("../../shared/index.js").then(({ exists }) => exists(path.join(packageRoot, relativePath)))
+        }))).then((values) => values.filter((value) => !value.exists).map((value) => value.relativePath)),
+        staleTaskArtifacts: await listStaleTaskAnalysisArtifacts(workspaceRoot)
+    };
+}
+//# sourceMappingURL=audit-install.js.map

package/dist/application/maintenance/audit-install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-install.js","sourceRoot":"","sources":["../../../src/application/maintenance/audit-install.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAC;AAsBlF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,aAAqB,EAAE,WAAmB;IAChF,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC,aAAa,CAAC,CAAC;IACpD,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,cAAc,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC1E,cAAc,CAAC,aAAa,CAAC;QAC7B,mBAAmB,CAAC,WAAW,CAAC;QAChC,YAAY,CAAsB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;QACzE,YAAY,CAAyB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,sBAAsB,CAAC,CAAC;KAC7G,CAAC,CAAC;IAEH,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IACnE,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,gBAAgB,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;IAE3G,OAAO;QACL,aAAa;QACb,cAAc,EAAE,WAAW,CAAC,OAAO;QACnC,gBAAgB,EAAE,KAAK,EAAE,gBAAgB,IAAI,EAAE;QAC/C,gBAAgB,EAAE,KAAK,EAAE,gBAAgB,IAAI,EAAE;QAC/C,mBAAmB,EAAE,SAAS,CAAC,OAAO;QACtC,cAAc;QACd,0BAA0B,EAAE,MAAM,OAAO,CAAC,GAAG,CAC3C,cAAc,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE,CAAC,CAAC;YACxD,YAAY;YACZ,MAAM,EAAE,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC,CAAC;SACjH,CAAC,CAAC,CACJ,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAC9F,kBAAkB,EAAE,MAAM,8BAA8B,CAAC,aAAa,CAAC;KACxE,CAAC;AACJ,CAAC"}

package/dist/application/maintenance/diff-install.d.ts

@@ -0,0 +1,7 @@
+export declare function createDiffInstallReport(workspaceRoot: string): Promise<{
+    installed: string[];
+    present: string[];
+    missing: string[];
+    staleTaskArtifacts: string[];
+}>;
+//# sourceMappingURL=diff-install.d.ts.map

package/dist/application/maintenance/diff-install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-install.d.ts","sourceRoot":"","sources":["../../../src/application/maintenance/diff-install.ts"],"names":[],"mappings":"AAIA,wBAAsB,uBAAuB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5E,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B,CAAC,CAiBD"}

package/dist/application/maintenance/diff-install.js

@@ -0,0 +1,20 @@
+import { loadInstallState } from "../../domain/state/install-state.js";
+import { exists } from "../../shared/index.js";
+import { listStaleTaskAnalysisArtifacts } from "../runtime/task-runtime-store.js";
+export async function createDiffInstallReport(workspaceRoot) {
+    const state = await loadInstallState(workspaceRoot);
+    const installed = state?.fileWrites ?? [];
+    const present = [];
+    const missing = [];
+    for (const filePath of installed) {
+        if (await exists(filePath)) {
+            present.push(filePath);
+        }
+        else {
+            missing.push(filePath);
+        }
+    }
+    const staleTaskArtifacts = (await listStaleTaskAnalysisArtifacts(workspaceRoot)).map((artifact) => artifact.path);
+    return { installed, present, missing, staleTaskArtifacts };
+}
+//# sourceMappingURL=diff-install.js.map

package/dist/application/maintenance/diff-install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-install.js","sourceRoot":"","sources":["../../../src/application/maintenance/diff-install.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AACvE,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAC;AAElF,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,aAAqB;IAMjE,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC,aAAa,CAAC,CAAC;IACpD,MAAM,SAAS,GAAG,KAAK,EAAE,UAAU,IAAI,EAAE,CAAC;IAC1C,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,MAAM,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzB,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,MAAM,kBAAkB,GAAG,CAAC,MAAM,8BAA8B,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAElH,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAC7D,CAAC"}

package/dist/application/maintenance/doctor-workspace.d.ts

@@ -0,0 +1,6 @@
+import { createAuditReport } from "./audit-install.js";
+export declare function createDoctorReport(workspaceRoot: string, packageRoot: string): Promise<{
+    status: "clean" | "warning" | "missing";
+    audit: Awaited<ReturnType<typeof createAuditReport>>;
+}>;
+//# sourceMappingURL=doctor-workspace.d.ts.map

package/dist/application/maintenance/doctor-workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-workspace.d.ts","sourceRoot":"","sources":["../../../src/application/maintenance/doctor-workspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,wBAAsB,kBAAkB,CAAC,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5F,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IACxC,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC,CAAC;CACtD,CAAC,CAWD"}

package/dist/application/maintenance/doctor-workspace.js

@@ -0,0 +1,12 @@
+import { createAuditReport } from "./audit-install.js";
+export async function createDoctorReport(workspaceRoot, packageRoot) {
+    const audit = await createAuditReport(workspaceRoot, packageRoot);
+    const hasIssues = audit.missingManagedPaths.length > 0 ||
+        audit.missingBundles.length > 0 ||
+        audit.packageSurfaceMissingPaths.length > 0;
+    return {
+        status: audit.installedTargets.length === 0 ? "missing" : hasIssues ? "warning" : "clean",
+        audit
+    };
+}
+//# sourceMappingURL=doctor-workspace.js.map

package/dist/application/maintenance/doctor-workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-workspace.js","sourceRoot":"","sources":["../../../src/application/maintenance/doctor-workspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,aAAqB,EAAE,WAAmB;IAIjF,MAAM,KAAK,GAAG,MAAM,iBAAiB,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;IAClE,MAAM,SAAS,GACb,KAAK,CAAC,mBAAmB,CAAC,MAAM,GAAG,CAAC;QACpC,KAAK,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC;QAC/B,KAAK,CAAC,0BAA0B,CAAC,MAAM,GAAG,CAAC,CAAC;IAE9C,OAAO;QACL,MAAM,EAAE,KAAK,CAAC,gBAAgB,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO;QACzF,KAAK;KACN,CAAC;AACJ,CAAC"}

package/dist/application/maintenance/prune-install.d.ts

@@ -0,0 +1,5 @@
+export declare function createPrunePlan(workspaceRoot: string, apply?: boolean): Promise<{
+    removed: string[];
+    remaining: string[];
+}>;
+//# sourceMappingURL=prune-install.d.ts.map

package/dist/application/maintenance/prune-install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prune-install.d.ts","sourceRoot":"","sources":["../../../src/application/maintenance/prune-install.ts"],"names":[],"mappings":"AAEA,wBAAsB,eAAe,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,UAAQ,GAAG,OAAO,CAAC;IACnF,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB,CAAC,CA+BD"}

package/dist/application/maintenance/prune-install.js

@@ -0,0 +1,30 @@
+import { loadInstallState, saveInstallState } from "../../domain/state/install-state.js";
+export async function createPrunePlan(workspaceRoot, apply = false) {
+    const state = await loadInstallState(workspaceRoot);
+    if (!state) {
+        return { removed: [], remaining: [] };
+    }
+    const seen = new Set();
+    const removed = [];
+    const remaining = [];
+    for (const filePath of state.fileWrites) {
+        if (seen.has(filePath)) {
+            removed.push(filePath);
+            continue;
+        }
+        seen.add(filePath);
+        remaining.push(filePath);
+    }
+    if (apply && removed.length > 0) {
+        await saveInstallState(workspaceRoot, {
+            ...state,
+            fileWrites: remaining,
+            timestamps: {
+                ...state.timestamps,
+                updatedAt: new Date().toISOString()
+            }
+        });
+    }
+    return { removed, remaining };
+}
+//# sourceMappingURL=prune-install.js.map

package/dist/application/maintenance/prune-install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prune-install.js","sourceRoot":"","sources":["../../../src/application/maintenance/prune-install.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAEzF,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,aAAqB,EAAE,KAAK,GAAG,KAAK;IAIxE,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC,aAAa,CAAC,CAAC;IACpD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IACxC,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,SAAS,GAAa,EAAE,CAAC;IAE/B,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACxC,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACvB,SAAS;QACX,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACnB,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC3B,CAAC;IAED,IAAI,KAAK,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,MAAM,gBAAgB,CAAC,aAAa,EAAE;YACpC,GAAG,KAAK;YACR,UAAU,EAAE,SAAS;YACrB,UAAU,EAAE;gBACV,GAAG,KAAK,CAAC,UAAU;gBACnB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;SACF,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AAChC,CAAC"}

package/dist/application/maintenance/sync-install.d.ts

@@ -0,0 +1,6 @@
+export declare function syncInstallState(workspaceRoot: string, apply?: boolean): Promise<{
+    changed: boolean;
+    installedBundles: string[];
+    installedTargets: string[];
+}>;
+//# sourceMappingURL=sync-install.d.ts.map

package/dist/application/maintenance/sync-install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-install.d.ts","sourceRoot":"","sources":["../../../src/application/maintenance/sync-install.ts"],"names":[],"mappings":"AAEA,wBAAsB,gBAAgB,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,UAAQ,GAAG,OAAO,CAAC;IACpF,OAAO,EAAE,OAAO,CAAC;IACjB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B,CAAC,CAyBD"}

package/dist/application/maintenance/sync-install.js

@@ -0,0 +1,24 @@
+import { loadInstallState, saveInstallState } from "../../domain/state/install-state.js";
+export async function syncInstallState(workspaceRoot, apply = false) {
+    const state = await loadInstallState(workspaceRoot);
+    if (!state) {
+        return { changed: false, installedBundles: [], installedTargets: [] };
+    }
+    const installedBundles = [...new Set(state.installedBundles)];
+    const installedTargets = [...new Set(state.installedTargets)];
+    const changed = installedBundles.length !== state.installedBundles.length ||
+        installedTargets.length !== state.installedTargets.length;
+    if (apply && changed) {
+        await saveInstallState(workspaceRoot, {
+            ...state,
+            installedBundles,
+            installedTargets,
+            timestamps: {
+                ...state.timestamps,
+                updatedAt: new Date().toISOString()
+            }
+        });
+    }
+    return { changed, installedBundles, installedTargets };
+}
+//# sourceMappingURL=sync-install.js.map

package/dist/application/maintenance/sync-install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-install.js","sourceRoot":"","sources":["../../../src/application/maintenance/sync-install.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAEzF,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,aAAqB,EAAE,KAAK,GAAG,KAAK;IAKzE,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC,aAAa,CAAC,CAAC;IACpD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,EAAE,EAAE,gBAAgB,EAAE,EAAE,EAAE,CAAC;IACxE,CAAC;IAED,MAAM,gBAAgB,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAC9D,MAAM,gBAAgB,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAC9D,MAAM,OAAO,GACX,gBAAgB,CAAC,MAAM,KAAK,KAAK,CAAC,gBAAgB,CAAC,MAAM;QACzD,gBAAgB,CAAC,MAAM,KAAK,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC;IAE5D,IAAI,KAAK,IAAI,OAAO,EAAE,CAAC;QACrB,MAAM,gBAAgB,CAAC,aAAa,EAAE;YACpC,GAAG,KAAK;YACR,gBAAgB;YAChB,gBAAgB;YAChB,UAAU,EAAE;gBACV,GAAG,KAAK,CAAC,UAAU;gBACnB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;SACF,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,CAAC;AACzD,CAAC"}

package/dist/application/maintenance/upgrade-surface.d.ts

@@ -0,0 +1,7 @@
+export declare function createUpgradeSurfaceReport(workspaceRoot: string, packageRoot: string): Promise<{
+    packageVersion: string;
+    installedTargets: string[];
+    installedBundles: string[];
+    recommendation: string;
+}>;
+//# sourceMappingURL=upgrade-surface.d.ts.map

package/dist/application/maintenance/upgrade-surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-surface.d.ts","sourceRoot":"","sources":["../../../src/application/maintenance/upgrade-surface.ts"],"names":[],"mappings":"AAKA,wBAAsB,0BAA0B,CAAC,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IACpG,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC,CAcD"}

package/dist/application/maintenance/upgrade-surface.js

@@ -0,0 +1,18 @@
+import path from "node:path";
+import { loadInstallState } from "../../domain/state/install-state.js";
+import { readJsonFile } from "../../shared/index.js";
+export async function createUpgradeSurfaceReport(workspaceRoot, packageRoot) {
+    const [state, packageJson] = await Promise.all([
+        loadInstallState(workspaceRoot),
+        readJsonFile(path.join(packageRoot, "package.json"))
+    ]);
+    return {
+        packageVersion: packageJson.version,
+        installedTargets: state?.installedTargets ?? [],
+        installedBundles: state?.installedBundles ?? [],
+        recommendation: state
+            ? "Run install again with the current target and bundle set, then re-run doctor and release validation."
+            : "No install state found. Initialize and install a target surface first."
+    };
+}
+//# sourceMappingURL=upgrade-surface.js.map

package/dist/application/maintenance/upgrade-surface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-surface.js","sourceRoot":"","sources":["../../../src/application/maintenance/upgrade-surface.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,aAAqB,EAAE,WAAmB;IAMzF,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC7C,gBAAgB,CAAC,aAAa,CAAC;QAC/B,YAAY,CAAsB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;KAC1E,CAAC,CAAC;IAEH,OAAO;QACL,cAAc,EAAE,WAAW,CAAC,OAAO;QACnC,gBAAgB,EAAE,KAAK,EAAE,gBAAgB,IAAI,EAAE;QAC/C,gBAAgB,EAAE,KAAK,EAAE,gBAAgB,IAAI,EAAE;QAC/C,cAAc,EAAE,KAAK;YACnB,CAAC,CAAC,sGAAsG;YACxG,CAAC,CAAC,wEAAwE;KAC7E,CAAC;AACJ,CAAC"}

package/dist/application/migration/scan-reference-install.d.ts

@@ -0,0 +1,9 @@
+export interface MigrationMapping {
+    sourceComponentId: string;
+    detectedPaths: string[];
+    suggestedBundleIds: string[];
+    warnings: string[];
+    manualFollowUps: string[];
+}
+export declare function scanReferenceInstall(root: string): Promise<MigrationMapping[]>;
+//# sourceMappingURL=scan-reference-install.d.ts.map

package/dist/application/migration/scan-reference-install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan-reference-install.d.ts","sourceRoot":"","sources":["../../../src/application/migration/scan-reference-install.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAC/B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAgBpF"}