@hashicorp/kits 0.1.0

package/dist/manifest/index.js

@@ -0,0 +1,200 @@
+/**
+ * Manifest module for the kit installer.
+ *
+ * This module handles reading, writing, and managing the installation manifest
+ * that tracks installed kits and primitives across harnesses.
+ */
+import { readManifest, getOrCreateManifest } from "./read.js";
+import { writeManifest } from "./write.js";
+export { MANIFEST_VERSION, GLOBAL_MANIFEST_PATH, PROJECT_MANIFEST_DIR, PROJECT_MANIFEST_FILENAME, createEmptyManifest, } from "./types.js";
+// Re-export read functions
+export { readManifest, getOrCreateManifest, ManifestReadError } from "./read.js";
+// Re-export write functions
+export { writeManifest, ManifestWriteError } from "./write.js";
+// Re-export scope-aware path functions (renamed for clarity)
+export { getManifestPathForScope, getManifestDirForScope } from "./write.js";
+// Re-export upgrade check functions
+export { checkForUpgrades, checkForUpgradesInScope, createUpgradeSummary, } from "./upgrade-check.js";
+// Re-export utils
+export { expandPath, getManifestPath, getManifestDir, ensureManifestDir, } from "./utils.js";
+/**
+ * Record a kit installation in the manifest.
+ *
+ * @param harness - The harness name
+ * @param kit - The kit manifest
+ * @param primitives - The resolved primitives that were installed
+ * @param source - The source repository
+ * @param scope - Installation scope (global or project)
+ * @param projectRoot - Absolute path to project root (required for project scope)
+ */
+export async function recordInstallation(harness, kit, primitives, source, scope = "global", projectRoot) {
+    const manifest = await getOrCreateManifest(scope, projectRoot);
+    // Ensure harness entry exists
+    if (!manifest.harnesses[harness]) {
+        manifest.harnesses[harness] = { kits: {} };
+    }
+    // Convert resolved primitives to installed primitives
+    const installedPrimitives = primitives.map((p) => {
+        const installed = {
+            name: p.name,
+            type: p.type,
+            namespacedName: `${kit.name}.${p.name}`,
+            isInline: p.isInline,
+            installedPath: p.sourcePath,
+        };
+        // Only add optional fields if they have values
+        if (p.resolvedVersion) {
+            installed.version = p.resolvedVersion;
+        }
+        const versionSpec = p.ref ? extractVersionSpec(p.ref) : undefined;
+        if (versionSpec) {
+            installed.versionSpec = versionSpec;
+        }
+        return installed;
+    });
+    // Record the kit installation
+    const harnessEntry = manifest.harnesses[harness];
+    if (harnessEntry) {
+        harnessEntry.kits[kit.name] = {
+            version: kit.version,
+            installedAt: new Date().toISOString(),
+            source,
+            primitives: installedPrimitives,
+        };
+    }
+    // Update source
+    manifest.source = source;
+    await writeManifest(manifest, scope, projectRoot);
+}
+/**
+ * Remove a kit installation from the manifest.
+ *
+ * @param harness - The harness name
+ * @param kitName - The kit name to remove
+ * @param scope - Installation scope (global or project)
+ * @param projectRoot - Absolute path to project root (required for project scope)
+ * @returns The removed kit info or null if not found
+ */
+export async function removeInstallation(harness, kitName, scope = "global", projectRoot) {
+    const manifest = await readManifest(scope, projectRoot);
+    if (!manifest) {
+        return null;
+    }
+    const harnessEntry = manifest.harnesses[harness];
+    if (!harnessEntry) {
+        return null;
+    }
+    const kit = harnessEntry.kits[kitName];
+    if (!kit) {
+        return null;
+    }
+    // Remove the kit
+    delete harnessEntry.kits[kitName];
+    // Clean up empty harness entries
+    if (Object.keys(harnessEntry.kits).length === 0) {
+        delete manifest.harnesses[harness];
+    }
+    await writeManifest(manifest, scope, projectRoot);
+    return kit;
+}
+/**
+ * Get all installed kits, optionally filtered by harness.
+ *
+ * @param scope - Installation scope (global or project)
+ * @param projectRoot - Absolute path to project root (required for project scope)
+ * @param harness - Optional harness name to filter by
+ * @returns Array of installed kit info with harness context
+ */
+export async function getInstalledKits(scope = "global", projectRoot, harness) {
+    const manifest = await readManifest(scope, projectRoot);
+    if (!manifest) {
+        return [];
+    }
+    const result = [];
+    for (const [harnessName, harnessEntry] of Object.entries(manifest.harnesses)) {
+        if (harness && harnessName !== harness) {
+            continue;
+        }
+        if (harnessEntry) {
+            for (const [kitName, kit] of Object.entries(harnessEntry.kits)) {
+                result.push({
+                    harness: harnessName,
+                    kitName,
+                    kit,
+                });
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Check if a kit is installed in any harness.
+ *
+ * @param kitName - The kit name to check
+ * @param scope - Installation scope (global or project)
+ * @param projectRoot - Absolute path to project root (required for project scope)
+ * @returns True if the kit is installed somewhere
+ */
+export async function isKitInstalled(kitName, scope = "global", projectRoot) {
+    const manifest = await readManifest(scope, projectRoot);
+    if (!manifest) {
+        return false;
+    }
+    for (const harness of Object.values(manifest.harnesses)) {
+        if (harness && kitName in harness.kits) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Check if a kit is installed in a specific harness.
+ *
+ * @param harness - The harness name
+ * @param kitName - The kit name to check
+ * @param scope - Installation scope (global or project)
+ * @param projectRoot - Absolute path to project root (required for project scope)
+ * @returns True if the kit is installed in the harness
+ */
+export async function isKitInstalledInHarness(harness, kitName, scope = "global", projectRoot) {
+    const manifest = await readManifest(scope, projectRoot);
+    if (!manifest) {
+        return false;
+    }
+    const harnessEntry = manifest.harnesses[harness];
+    return harnessEntry ? kitName in harnessEntry.kits : false;
+}
+/**
+ * Get a specific installed kit.
+ *
+ * @param harness - The harness name
+ * @param kitName - The kit name
+ * @param scope - Installation scope (global or project)
+ * @param projectRoot - Absolute path to project root (required for project scope)
+ * @returns The installed kit or null if not found
+ */
+export async function getInstalledKit(harness, kitName, scope = "global", projectRoot) {
+    const manifest = await readManifest(scope, projectRoot);
+    if (!manifest) {
+        return null;
+    }
+    const harnessEntry = manifest.harnesses[harness];
+    if (!harnessEntry) {
+        return null;
+    }
+    return harnessEntry.kits[kitName] ?? null;
+}
+/**
+ * Extract version spec from a ref string.
+ *
+ * @param ref - The ref string (e.g., "tf-plan@^1.0.0")
+ * @returns The version spec portion or undefined
+ */
+function extractVersionSpec(ref) {
+    const atIndex = ref.indexOf("@");
+    if (atIndex === -1) {
+        return undefined;
+    }
+    return ref.slice(atIndex + 1);
+}
+//# sourceMappingURL=index.js.map

package/dist/manifest/index.js.map

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

package/dist/manifest/read.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Manifest read operations.
+ *
+ * Provides functionality to read and validate the installation manifest.
+ */
+import type { InstallationScope } from "../core/types.js";
+import type { InstallationManifest } from "./types.js";
+/**
+ * Error thrown when manifest read fails.
+ */
+export declare class ManifestReadError extends Error {
+    readonly errorCause?: unknown;
+    constructor(message: string, cause?: unknown);
+}
+/**
+ * Read the installation manifest from disk.
+ *
+ * @param scope - Installation scope (global or project)
+ * @param projectRoot - Absolute path to project root (required for project scope)
+ * @returns The manifest or null if it doesn't exist
+ * @throws ManifestReadError if the file exists but cannot be read or parsed
+ */
+export declare function readManifest(scope?: InstallationScope, projectRoot?: string): Promise<InstallationManifest | null>;
+/**
+ * Get or create the installation manifest.
+ *
+ * @param scope - Installation scope (global or project)
+ * @param projectRoot - Absolute path to project root (required for project scope)
+ * @returns The existing manifest or a new empty manifest
+ */
+export declare function getOrCreateManifest(scope?: InstallationScope, projectRoot?: string): Promise<InstallationManifest>;
+//# sourceMappingURL=read.d.ts.map

package/dist/manifest/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../src/manifest/read.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAIvD;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;gBAElB,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAK7C;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,KAAK,GAAE,iBAA4B,EACnC,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAuCtC;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,GAAE,iBAA4B,EACnC,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,oBAAoB,CAAC,CAG/B"}

package/dist/manifest/read.js

@@ -0,0 +1,88 @@
+/**
+ * Manifest read operations.
+ *
+ * Provides functionality to read and validate the installation manifest.
+ */
+import fs from "node:fs/promises";
+import { MANIFEST_VERSION, createEmptyManifest } from "./types.js";
+import { getManifestPath } from "./utils.js";
+/**
+ * Error thrown when manifest read fails.
+ */
+export class ManifestReadError extends Error {
+    errorCause;
+    constructor(message, cause) {
+        super(message);
+        this.name = "ManifestReadError";
+        this.errorCause = cause;
+    }
+}
+/**
+ * Read the installation manifest from disk.
+ *
+ * @param scope - Installation scope (global or project)
+ * @param projectRoot - Absolute path to project root (required for project scope)
+ * @returns The manifest or null if it doesn't exist
+ * @throws ManifestReadError if the file exists but cannot be read or parsed
+ */
+export async function readManifest(scope = "global", projectRoot) {
+    const manifestPath = getManifestPath(scope, projectRoot);
+    try {
+        const content = await fs.readFile(manifestPath, "utf-8");
+        const manifest = JSON.parse(content);
+        // Validate manifest version
+        if (!isValidManifest(manifest)) {
+            throw new ManifestReadError(`Invalid manifest format at ${manifestPath}; expected version ${MANIFEST_VERSION}`);
+        }
+        return manifest;
+    }
+    catch (error) {
+        const nodeError = error;
+        // File doesn't exist - return null
+        if (nodeError.code === "ENOENT") {
+            return null;
+        }
+        // Re-throw ManifestReadError as-is
+        if (error instanceof ManifestReadError) {
+            throw error;
+        }
+        // JSON parse errors
+        if (error instanceof SyntaxError) {
+            throw new ManifestReadError(`Failed to parse manifest at ${manifestPath}; invalid JSON`, error);
+        }
+        // Other errors
+        throw new ManifestReadError(`Failed to read manifest at ${manifestPath}`, error);
+    }
+}
+/**
+ * Get or create the installation manifest.
+ *
+ * @param scope - Installation scope (global or project)
+ * @param projectRoot - Absolute path to project root (required for project scope)
+ * @returns The existing manifest or a new empty manifest
+ */
+export async function getOrCreateManifest(scope = "global", projectRoot) {
+    const manifest = await readManifest(scope, projectRoot);
+    return manifest ?? createEmptyManifest(scope, projectRoot);
+}
+/**
+ * Validates that a manifest has the expected structure.
+ */
+function isValidManifest(manifest) {
+    if (!manifest || typeof manifest !== "object") {
+        return false;
+    }
+    const m = manifest;
+    // Check required fields
+    if (typeof m["version"] !== "string") {
+        return false;
+    }
+    if (typeof m["lastUpdated"] !== "string") {
+        return false;
+    }
+    if (!m["harnesses"] || typeof m["harnesses"] !== "object") {
+        return false;
+    }
+    return true;
+}
+//# sourceMappingURL=read.js.map

package/dist/manifest/read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.js","sourceRoot":"","sources":["../../src/manifest/read.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAIlC,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C;;GAEG;AACH,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACjC,UAAU,CAAW;IAE9B,YAAY,OAAe,EAAE,KAAe;QAC1C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;IAC1B,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,QAA2B,QAAQ,EACnC,WAAoB;IAEpB,MAAM,YAAY,GAAG,eAAe,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IAEzD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAyB,CAAC;QAE7D,4BAA4B;QAC5B,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,iBAAiB,CACzB,8BAA8B,YAAY,sBAAsB,gBAAgB,EAAE,CACnF,CAAC;QACJ,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,SAAS,GAAG,KAA8B,CAAC;QAEjD,mCAAmC;QACnC,IAAI,SAAS,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,mCAAmC;QACnC,IAAI,KAAK,YAAY,iBAAiB,EAAE,CAAC;YACvC,MAAM,KAAK,CAAC;QACd,CAAC;QAED,oBAAoB;QACpB,IAAI,KAAK,YAAY,WAAW,EAAE,CAAC;YACjC,MAAM,IAAI,iBAAiB,CACzB,+BAA+B,YAAY,gBAAgB,EAC3D,KAAK,CACN,CAAC;QACJ,CAAC;QAED,eAAe;QACf,MAAM,IAAI,iBAAiB,CAAC,8BAA8B,YAAY,EAAE,EAAE,KAAK,CAAC,CAAC;IACnF,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,QAA2B,QAAQ,EACnC,WAAoB;IAEpB,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IACxD,OAAO,QAAQ,IAAI,mBAAmB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;AAC7D,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,QAAiB;IACxC,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC9C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,CAAC,GAAG,QAAmC,CAAC;IAE9C,wBAAwB;IACxB,IAAI,OAAO,CAAC,CAAC,SAAS,CAAC,KAAK,QAAQ,EAAE,CAAC;QACrC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,OAAO,CAAC,CAAC,aAAa,CAAC,KAAK,QAAQ,EAAE,CAAC;QACzC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC,CAAC,WAAW,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1D,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/manifest/types.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Installation manifest type definitions.
+ *
+ * The manifest tracks all installed kits and primitives across harnesses,
+ * enabling uninstallation, upgrade checking, and conflict detection.
+ */
+import type { PrimitiveType, HarnessName, InstallationScope } from "../core/types.js";
+/**
+ * Version of the manifest schema.
+ */
+export declare const MANIFEST_VERSION: "1.0";
+/**
+ * Global manifest file location.
+ * User-level installation, available in all projects.
+ */
+export declare const GLOBAL_MANIFEST_PATH = "~/.agents/manifest.json";
+/**
+ * Project manifest directory name.
+ * Repository-level installation, version-controllable.
+ */
+export declare const PROJECT_MANIFEST_DIR = ".agents";
+/**
+ * Project manifest file name within PROJECT_MANIFEST_DIR.
+ */
+export declare const PROJECT_MANIFEST_FILENAME = "manifest.json";
+/**
+ * Information about an installed primitive.
+ */
+export interface InstalledPrimitive {
+    name: string;
+    type: PrimitiveType;
+    namespacedName: string;
+    version?: string;
+    versionSpec?: string;
+    isInline: boolean;
+    installedPath: string;
+    instanceName?: string;
+    configHash?: string;
+}
+/**
+ * Information about an installed kit.
+ */
+export interface InstalledKit {
+    version: string;
+    installedAt: string;
+    source: string;
+    primitives: InstalledPrimitive[];
+}
+/**
+ * Harness installation record.
+ */
+export interface HarnessInstallation {
+    kits: Record<string, InstalledKit>;
+    mcpInstances?: Record<string, McpInstance>;
+    hookInstances?: Record<string, HookInstance>;
+}
+/**
+ * MCP server instance record.
+ */
+export interface McpInstance {
+    version: string;
+    configHash: string;
+    usedBy: string[];
+    sourcePrimitive: string;
+    installedAt: string;
+}
+/**
+ * Hook program instance record.
+ */
+export interface HookInstance {
+    version: string;
+    configHash: string;
+    usedBy: string[];
+    sourcePrimitive: string;
+    installedAt: string;
+}
+/**
+ * Installation manifest structure.
+ */
+export interface InstallationManifest {
+    version: typeof MANIFEST_VERSION;
+    scope: InstallationScope;
+    projectRoot?: string;
+    lastUpdated: string;
+    source?: string;
+    harnesses: Partial<Record<HarnessName, HarnessInstallation>>;
+}
+/**
+ * Available upgrade information.
+ */
+export interface UpgradeCheck {
+    kit: string;
+    harness: HarnessName;
+    primitive: string;
+    type: PrimitiveType;
+    currentVersion: string;
+    availableVersion: string;
+    versionSpec: string;
+    breaking: boolean;
+}
+/**
+ * Summary of available upgrades.
+ */
+export interface UpgradeSummary {
+    upgrades: UpgradeCheck[];
+    totalUpgrades: number;
+    breakingChanges: number;
+    affectedKits: number;
+    affectedHarnesses: number;
+}
+/**
+ * Creates an empty manifest for the specified scope.
+ *
+ * @param scope - Installation scope (global or project)
+ * @param projectRoot - Absolute path to project root (required for project scope)
+ * @returns Empty installation manifest
+ */
+export declare function createEmptyManifest(scope?: InstallationScope, projectRoot?: string): InstallationManifest;
+//# sourceMappingURL=types.d.ts.map

package/dist/manifest/types.d.ts.map

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

package/dist/manifest/types.js

@@ -0,0 +1,44 @@
+/**
+ * Installation manifest type definitions.
+ *
+ * The manifest tracks all installed kits and primitives across harnesses,
+ * enabling uninstallation, upgrade checking, and conflict detection.
+ */
+/**
+ * Version of the manifest schema.
+ */
+export const MANIFEST_VERSION = "1.0";
+/**
+ * Global manifest file location.
+ * User-level installation, available in all projects.
+ */
+export const GLOBAL_MANIFEST_PATH = "~/.agents/manifest.json";
+/**
+ * Project manifest directory name.
+ * Repository-level installation, version-controllable.
+ */
+export const PROJECT_MANIFEST_DIR = ".agents";
+/**
+ * Project manifest file name within PROJECT_MANIFEST_DIR.
+ */
+export const PROJECT_MANIFEST_FILENAME = "manifest.json";
+/**
+ * Creates an empty manifest for the specified scope.
+ *
+ * @param scope - Installation scope (global or project)
+ * @param projectRoot - Absolute path to project root (required for project scope)
+ * @returns Empty installation manifest
+ */
+export function createEmptyManifest(scope = "global", projectRoot) {
+    const manifest = {
+        version: MANIFEST_VERSION,
+        scope,
+        lastUpdated: new Date().toISOString(),
+        harnesses: {},
+    };
+    if (scope === "project" && projectRoot) {
+        manifest.projectRoot = projectRoot;
+    }
+    return manifest;
+}
+//# sourceMappingURL=types.js.map

package/dist/manifest/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/manifest/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAc,CAAC;AAE/C;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,yBAAyB,CAAC;AAE9D;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,SAAS,CAAC;AAE9C;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,eAAe,CAAC;AAgGzD;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAA2B,QAAQ,EACnC,WAAoB;IAEpB,MAAM,QAAQ,GAAyB;QACrC,OAAO,EAAE,gBAAgB;QACzB,KAAK;QACL,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,SAAS,EAAE,EAAE;KACd,CAAC;IAEF,IAAI,KAAK,KAAK,SAAS,IAAI,WAAW,EAAE,CAAC;QACvC,QAAQ,CAAC,WAAW,GAAG,WAAW,CAAC;IACrC,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/manifest/upgrade-check.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Upgrade checking functionality for installed primitives.
+ *
+ * Compares installed primitive versions against the primitives registry
+ * to identify available updates.
+ */
+import type { HarnessName, InstallationScope } from "../core/types.js";
+import type { PrimitivesRegistryLoader } from "../resolution/primitives-registry.js";
+import type { InstallationManifest, UpgradeCheck, UpgradeSummary } from "./types.js";
+/**
+ * Check for available upgrades for a specific installation scope.
+ *
+ * Convenience function that reads the manifest for the given scope
+ * and checks for available upgrades.
+ *
+ * @param scope - Installation scope (global or project)
+ * @param registry - The primitives registry loader
+ * @param projectRoot - Absolute path to project root (required for project scope)
+ * @returns Array of available upgrade information, empty if no manifest exists
+ */
+export declare function checkForUpgradesInScope(scope: InstallationScope, registry: PrimitivesRegistryLoader, projectRoot?: string): Promise<UpgradeCheck[]>;
+/**
+ * Check for available upgrades across all installed primitives.
+ *
+ * @param manifest - The installation manifest
+ * @param registry - The primitives registry loader
+ * @returns Array of available upgrade information
+ */
+export declare function checkForUpgrades(manifest: InstallationManifest, registry: PrimitivesRegistryLoader): Promise<UpgradeCheck[]>;
+/**
+ * Create an upgrade summary from upgrade checks.
+ *
+ * @param upgrades - Array of upgrade checks
+ * @returns Summary of available upgrades
+ */
+export declare function createUpgradeSummary(upgrades: UpgradeCheck[]): UpgradeSummary;
+/**
+ * Group upgrades by kit for display purposes.
+ *
+ * @param upgrades - Array of upgrade checks
+ * @returns Map of kit name to upgrades for that kit
+ */
+export declare function groupUpgradesByKit(upgrades: UpgradeCheck[]): Map<string, UpgradeCheck[]>;
+/**
+ * Group upgrades by harness for display purposes.
+ *
+ * @param upgrades - Array of upgrade checks
+ * @returns Map of harness name to upgrades for that harness
+ */
+export declare function groupUpgradesByHarness(upgrades: UpgradeCheck[]): Map<HarnessName, UpgradeCheck[]>;
+/**
+ * Filter upgrades to only include non-breaking changes.
+ *
+ * @param upgrades - Array of upgrade checks
+ * @returns Array of non-breaking upgrades
+ */
+export declare function filterNonBreaking(upgrades: UpgradeCheck[]): UpgradeCheck[];
+/**
+ * Filter upgrades to only include breaking changes.
+ *
+ * @param upgrades - Array of upgrade checks
+ * @returns Array of breaking upgrades
+ */
+export declare function filterBreaking(upgrades: UpgradeCheck[]): UpgradeCheck[];
+/**
+ * Format an upgrade for display.
+ *
+ * @param upgrade - The upgrade check
+ * @returns Formatted string describing the upgrade
+ */
+export declare function formatUpgrade(upgrade: UpgradeCheck): string;
+//# sourceMappingURL=upgrade-check.d.ts.map

package/dist/manifest/upgrade-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-check.d.ts","sourceRoot":"","sources":["../../src/manifest/upgrade-check.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAiB,MAAM,kBAAkB,CAAC;AACtF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AACrF,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGrF;;;;;;;;;;GAUG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,iBAAiB,EACxB,QAAQ,EAAE,wBAAwB,EAClC,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,YAAY,EAAE,CAAC,CAMzB;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,oBAAoB,EAC9B,QAAQ,EAAE,wBAAwB,GACjC,OAAO,CAAC,YAAY,EAAE,CAAC,CAsCzB;AA0ED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,cAAc,CAiB7E;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,YAAY,EAAE,GACvB,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,CAW7B;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,YAAY,EAAE,GACvB,GAAG,CAAC,WAAW,EAAE,YAAY,EAAE,CAAC,CAUlC;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CAE1E;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CAEvE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAG3D"}