@hashicorp/kits 0.1.4 → 0.1.6

package/dist/{manifest → lockfile}/upgrade-check.js

@@ -5,41 +5,42 @@
  * to identify available updates.
  */
 import * as semver from "semver";
-import { readManifest } from "./read.js";
+import { readLockfile } from "./read.js";
 /**
  * Check for available upgrades for a specific installation scope.
  *
- * Convenience function that reads the manifest for the given scope
+ * Convenience function that reads the lockfile 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
+ * @returns Array of available upgrade information, empty if no lockfile exists
  */
 export async function checkForUpgradesInScope(scope, registry, projectRoot) {
-    const manifest = await readManifest(scope, projectRoot);
-    if (!manifest) {
+    const lockfile = await readLockfile(scope, projectRoot);
+    if (!lockfile) {
         return [];
     }
-    return checkForUpgrades(manifest, registry);
+    return checkForUpgrades(lockfile, registry);
 }
 /**
  * Check for available upgrades across all installed primitives.
  *
- * @param manifest - The installation manifest
+ * @param lockfile - The kits lockfile
  * @param registry - The primitives registry loader
  * @returns Array of available upgrade information
  */
-export async function checkForUpgrades(manifest, registry) {
+export async function checkForUpgrades(lockfile, registry) {
     const upgrades = [];
     // Load the registry if not already loaded
     await registry.load();
     // Iterate through all harnesses and kits
-    for (const [harnessName, harnessEntry] of Object.entries(manifest.harnesses)) {
+    for (const [harnessName, harnessEntry] of Object.entries(lockfile.harnesses)) {
         if (!harnessEntry)
             continue;
         for (const [kitName, kit] of Object.entries(harnessEntry.kits)) {
+            const canonicalName = kit.name ?? kitName;
             // Check each primitive for upgrades
             for (const primitive of kit.primitives) {
                 // Skip inline primitives - they don't come from the registry
@@ -51,6 +52,7 @@ export async function checkForUpgrades(manifest, registry) {
                 // Check for available upgrade
                 const upgrade = await checkPrimitiveUpgrade(registry, harnessName, kitName, primitive.name, primitive.type, primitive.version, primitive.versionSpec);
                 if (upgrade) {
+                    upgrade.name = canonicalName;
                     upgrades.push(upgrade);
                 }
             }

package/dist/lockfile/upgrade-check.js.map

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

package/dist/lockfile/utils.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Shared utilities for the lockfile module.
+ */
+import type { InstallationScope } from "../core/types.js";
+/**
+ * Expand ~ to home directory.
+ *
+ * @param pathStr - Path string that may contain ~
+ * @returns Expanded path string
+ */
+export declare function expandPath(pathStr: string): string;
+/**
+ * Get the lockfile path for a given scope.
+ *
+ * @param scope - Installation scope (global or project)
+ * @param projectRoot - Absolute path to project root (required for project scope)
+ * @returns Absolute path to the lockfile file
+ */
+export declare function getLockfilePath(scope: InstallationScope, projectRoot?: string): string;
+/**
+ * Get the lockfile directory path for a given scope.
+ *
+ * @param scope - Installation scope (global or project)
+ * @param projectRoot - Absolute path to project root (required for project scope)
+ * @returns Absolute path to the lockfile directory
+ */
+export declare function getLockfileDir(scope: InstallationScope, projectRoot?: string): string;
+/**
+ * Ensure the lockfile directory exists for a given scope.
+ *
+ * @param scope - Installation scope (global or project)
+ * @param projectRoot - Absolute path to project root (required for project scope)
+ */
+export declare function ensureLockfileDir(scope: InstallationScope, projectRoot?: string): Promise<void>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/lockfile/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/lockfile/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAO1D;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,iBAAiB,EACxB,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAWR;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,iBAAiB,EACxB,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAER;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,iBAAiB,EACxB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAGf"}

package/dist/lockfile/utils.js

@@ -0,0 +1,57 @@
+/**
+ * Shared utilities for the lockfile module.
+ */
+import fs from "node:fs/promises";
+import path from "node:path";
+import { GLOBAL_LOCKFILE_PATH, PROJECT_LOCKFILE_DIR, PROJECT_LOCKFILE_FILENAME, } from "./types.js";
+/**
+ * Expand ~ to home directory.
+ *
+ * @param pathStr - Path string that may contain ~
+ * @returns Expanded path string
+ */
+export function expandPath(pathStr) {
+    if (pathStr.startsWith("~")) {
+        const home = process.env["HOME"] || process.env["USERPROFILE"] || "";
+        return path.join(home, pathStr.slice(1));
+    }
+    return pathStr;
+}
+/**
+ * Get the lockfile path for a given scope.
+ *
+ * @param scope - Installation scope (global or project)
+ * @param projectRoot - Absolute path to project root (required for project scope)
+ * @returns Absolute path to the lockfile file
+ */
+export function getLockfilePath(scope, projectRoot) {
+    if (scope === "global") {
+        return expandPath(GLOBAL_LOCKFILE_PATH);
+    }
+    // Project scope
+    if (!projectRoot) {
+        throw new Error("projectRoot is required for project scope");
+    }
+    return path.join(projectRoot, PROJECT_LOCKFILE_DIR, PROJECT_LOCKFILE_FILENAME);
+}
+/**
+ * Get the lockfile directory path for a given scope.
+ *
+ * @param scope - Installation scope (global or project)
+ * @param projectRoot - Absolute path to project root (required for project scope)
+ * @returns Absolute path to the lockfile directory
+ */
+export function getLockfileDir(scope, projectRoot) {
+    return path.dirname(getLockfilePath(scope, projectRoot));
+}
+/**
+ * Ensure the lockfile directory exists for a given scope.
+ *
+ * @param scope - Installation scope (global or project)
+ * @param projectRoot - Absolute path to project root (required for project scope)
+ */
+export async function ensureLockfileDir(scope, projectRoot) {
+    const lockfileDir = getLockfileDir(scope, projectRoot);
+    await fs.mkdir(lockfileDir, { recursive: true });
+}
+//# sourceMappingURL=utils.js.map

package/dist/lockfile/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/lockfile/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AAEpB;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,OAAe;IACxC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;QACrE,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAwB,EACxB,WAAoB;IAEpB,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvB,OAAO,UAAU,CAAC,oBAAoB,CAAC,CAAC;IAC1C,CAAC;IAED,gBAAgB;IAChB,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,oBAAoB,EAAE,yBAAyB,CAAC,CAAC;AACjF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,KAAwB,EACxB,WAAoB;IAEpB,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,KAAwB,EACxB,WAAoB;IAEpB,MAAM,WAAW,GAAG,cAAc,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IACvD,MAAM,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACnD,CAAC"}

package/dist/lockfile/write.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Lockfile write operations.
+ *
+ * Provides functionality to write and update the kits lockfile.
+ */
+import type { InstallationScope } from "../core/types.js";
+import type { KitsLockfile } from "./types.js";
+/**
+ * Error thrown when lockfile write fails.
+ */
+export declare class LockfileWriteError extends Error {
+    readonly errorCause?: unknown;
+    constructor(message: string, cause?: unknown);
+}
+/**
+ * Write the kits lockfile to disk.
+ *
+ * Creates the lockfile directory if it doesn't exist.
+ * Updates the lastUpdated timestamp automatically.
+ * Ensures the scope field matches the write location.
+ *
+ * @param lockfile - The lockfile to write
+ * @param scope - Installation scope (global or project), defaults to lockfile.scope
+ * @param projectRoot - Absolute path to project root (required for project scope)
+ * @throws LockfileWriteError if writing fails
+ */
+export declare function writeLockfile(lockfile: KitsLockfile, scope?: InstallationScope, projectRoot?: string): Promise<void>;
+/**
+ * Get the expanded lockfile path for a given scope.
+ *
+ * @param scope - Installation scope (global or project), defaults to global
+ * @param projectRoot - Absolute path to project root (required for project scope)
+ * @returns The absolute path to the lockfile file
+ */
+export declare function getLockfilePathForScope(scope?: InstallationScope, projectRoot?: string): string;
+/**
+ * Get the lockfile directory path for a given scope.
+ *
+ * @param scope - Installation scope (global or project), defaults to global
+ * @param projectRoot - Absolute path to project root (required for project scope)
+ * @returns The absolute path to the lockfile directory
+ */
+export declare function getLockfileDirForScope(scope?: InstallationScope, projectRoot?: string): string;
+//# sourceMappingURL=write.d.ts.map

package/dist/lockfile/write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../src/lockfile/write.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;gBAElB,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAK7C;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,YAAY,EACtB,KAAK,CAAC,EAAE,iBAAiB,EACzB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CA+Bf;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,GAAE,iBAA4B,EACnC,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAER;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,GAAE,iBAA4B,EACnC,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAER"}

package/dist/lockfile/write.js

@@ -0,0 +1,77 @@
+/**
+ * Lockfile write operations.
+ *
+ * Provides functionality to write and update the kits lockfile.
+ */
+import fs from "node:fs/promises";
+import { getLockfilePath, getLockfileDir, ensureLockfileDir } from "./utils.js";
+/**
+ * Error thrown when lockfile write fails.
+ */
+export class LockfileWriteError extends Error {
+    errorCause;
+    constructor(message, cause) {
+        super(message);
+        this.name = "LockfileWriteError";
+        this.errorCause = cause;
+    }
+}
+/**
+ * Write the kits lockfile to disk.
+ *
+ * Creates the lockfile directory if it doesn't exist.
+ * Updates the lastUpdated timestamp automatically.
+ * Ensures the scope field matches the write location.
+ *
+ * @param lockfile - The lockfile to write
+ * @param scope - Installation scope (global or project), defaults to lockfile.scope
+ * @param projectRoot - Absolute path to project root (required for project scope)
+ * @throws LockfileWriteError if writing fails
+ */
+export async function writeLockfile(lockfile, scope, projectRoot) {
+    // Use provided scope or fall back to lockfile's scope
+    const effectiveScope = scope ?? lockfile.scope;
+    const lockfilePath = getLockfilePath(effectiveScope, projectRoot);
+    try {
+        // Ensure directory exists
+        await ensureLockfileDir(effectiveScope, projectRoot);
+        // Update timestamp
+        lockfile.lastUpdated = new Date().toISOString();
+        // Ensure scope field is set correctly
+        lockfile.scope = effectiveScope;
+        // Set or clear projectRoot based on scope
+        if (effectiveScope === "project" && projectRoot) {
+            lockfile.projectRoot = projectRoot;
+        }
+        else if (effectiveScope === "global") {
+            delete lockfile.projectRoot;
+        }
+        // Write lockfile with pretty formatting
+        const content = JSON.stringify(lockfile, null, 2);
+        await fs.writeFile(lockfilePath, content, "utf-8");
+    }
+    catch (error) {
+        throw new LockfileWriteError(`Failed to write lockfile to ${lockfilePath}`, error);
+    }
+}
+/**
+ * Get the expanded lockfile path for a given scope.
+ *
+ * @param scope - Installation scope (global or project), defaults to global
+ * @param projectRoot - Absolute path to project root (required for project scope)
+ * @returns The absolute path to the lockfile file
+ */
+export function getLockfilePathForScope(scope = "global", projectRoot) {
+    return getLockfilePath(scope, projectRoot);
+}
+/**
+ * Get the lockfile directory path for a given scope.
+ *
+ * @param scope - Installation scope (global or project), defaults to global
+ * @param projectRoot - Absolute path to project root (required for project scope)
+ * @returns The absolute path to the lockfile directory
+ */
+export function getLockfileDirForScope(scope = "global", projectRoot) {
+    return getLockfileDir(scope, projectRoot);
+}
+//# sourceMappingURL=write.js.map

package/dist/lockfile/write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.js","sourceRoot":"","sources":["../../src/lockfile/write.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAIlC,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEhF;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAClC,UAAU,CAAW;IAE9B,YAAY,OAAe,EAAE,KAAe;QAC1C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;IAC1B,CAAC;CACF;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,QAAsB,EACtB,KAAyB,EACzB,WAAoB;IAEpB,sDAAsD;IACtD,MAAM,cAAc,GAAG,KAAK,IAAI,QAAQ,CAAC,KAAK,CAAC;IAC/C,MAAM,YAAY,GAAG,eAAe,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;IAElE,IAAI,CAAC;QACH,0BAA0B;QAC1B,MAAM,iBAAiB,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;QAErD,mBAAmB;QACnB,QAAQ,CAAC,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAEhD,sCAAsC;QACtC,QAAQ,CAAC,KAAK,GAAG,cAAc,CAAC;QAEhC,0CAA0C;QAC1C,IAAI,cAAc,KAAK,SAAS,IAAI,WAAW,EAAE,CAAC;YAChD,QAAQ,CAAC,WAAW,GAAG,WAAW,CAAC;QACrC,CAAC;aAAM,IAAI,cAAc,KAAK,QAAQ,EAAE,CAAC;YACvC,OAAO,QAAQ,CAAC,WAAW,CAAC;QAC9B,CAAC;QAED,wCAAwC;QACxC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAClD,MAAM,EAAE,CAAC,SAAS,CAAC,YAAY,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,kBAAkB,CAC1B,+BAA+B,YAAY,EAAE,EAC7C,KAAK,CACN,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CACrC,QAA2B,QAAQ,EACnC,WAAoB;IAEpB,OAAO,eAAe,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;AAC7C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CACpC,QAA2B,QAAQ,EACnC,WAAoB;IAEpB,OAAO,cAAc,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;AAC5C,CAAC"}

package/dist/manifest/hash.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Canonical hashing for kits manifests.
+ */
+import type { KitsManifest } from "./types.js";
+export declare function canonicalizeManifest(manifest: KitsManifest): string;
+export declare function hashManifest(manifest: KitsManifest): string;
+//# sourceMappingURL=hash.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/manifest/hash.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAmB/C,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAGnE;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAI3D"}

package/dist/manifest/hash.js

@@ -0,0 +1,30 @@
+/**
+ * Canonical hashing for kits manifests.
+ */
+import crypto from "node:crypto";
+function sortObject(value) {
+    if (Array.isArray(value)) {
+        return value.map((item) => sortObject(item));
+    }
+    if (!value || typeof value !== "object") {
+        return value;
+    }
+    const entries = Object.entries(value)
+        .filter(([, v]) => v !== undefined)
+        .sort(([a], [b]) => a.localeCompare(b));
+    const result = {};
+    for (const [key, val] of entries) {
+        result[key] = sortObject(val);
+    }
+    return result;
+}
+export function canonicalizeManifest(manifest) {
+    const sorted = sortObject(manifest);
+    return JSON.stringify(sorted);
+}
+export function hashManifest(manifest) {
+    const canonical = canonicalizeManifest(manifest);
+    const hash = crypto.createHash("sha256").update(canonical).digest("hex");
+    return `sha256:${hash}`;
+}
+//# sourceMappingURL=hash.js.map

package/dist/manifest/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/manifest/hash.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,MAAM,MAAM,aAAa,CAAC;AAIjC,SAAS,UAAU,CAAC,KAAc;IAChC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC;SAC7D,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC;SAClC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,OAAO,EAAE,CAAC;QACjC,MAAM,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,QAAsB;IACzD,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAiB,CAAC;IACpD,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAAsB;IACjD,MAAM,SAAS,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IACjD,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACzE,OAAO,UAAU,IAAI,EAAE,CAAC;AAC1B,CAAC"}

package/dist/manifest/index.d.ts

@@ -1,79 +1,10 @@
 /**
- * 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 type { HarnessName, InstallationScope, ResolvedPrimitive, KitManifest } from "../core/types.js";
-import type { InstalledKit } from "./types.js";
-export type { InstalledPrimitive, InstalledKit, HarnessInstallation, InstallationManifest, UpgradeCheck, UpgradeSummary, } from "./types.js";
-export { MANIFEST_VERSION, GLOBAL_MANIFEST_PATH, PROJECT_MANIFEST_DIR, PROJECT_MANIFEST_FILENAME, createEmptyManifest, } from "./types.js";
-export { readManifest, getOrCreateManifest, ManifestReadError } from "./read.js";
-export { writeManifest, ManifestWriteError } from "./write.js";
-export { getManifestPathForScope, getManifestDirForScope } from "./write.js";
-export { checkForUpgrades, checkForUpgradesInScope, createUpgradeSummary, } from "./upgrade-check.js";
-export { expandPath, getManifestPath, getManifestDir, ensureManifestDir, } from "./utils.js";
-/**
- * Record a kit installation in the manifest.
- *
- * @param harness - The harness name
- * @param kit - The kit definition
- * @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 declare function recordInstallation(harness: HarnessName, kit: KitManifest, primitives: ResolvedPrimitive[], source: string, scope?: InstallationScope, projectRoot?: string): Promise<void>;
-/**
- * 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 declare function removeInstallation(harness: HarnessName, kitName: string, scope?: InstallationScope, projectRoot?: string): Promise<InstalledKit | null>;
-/**
- * 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 declare function getInstalledKits(scope?: InstallationScope, projectRoot?: string, harness?: HarnessName): Promise<Array<{
-    harness: HarnessName;
-    kitName: string;
-    kit: InstalledKit;
-}>>;
-/**
- * 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 declare function isKitInstalled(kitName: string, scope?: InstallationScope, projectRoot?: string): Promise<boolean>;
-/**
- * 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 declare function isKitInstalledInHarness(harness: HarnessName, kitName: string, scope?: InstallationScope, projectRoot?: string): Promise<boolean>;
-/**
- * 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 declare function getInstalledKit(harness: HarnessName, kitName: string, scope?: InstallationScope, projectRoot?: string): Promise<InstalledKit | null>;
+ * Kits manifest (intent) module.
+ */
+export type { KitsManifest, KitsManifestSource, ManifestCompatibility } from "./types.js";
+export { MANIFEST_SCHEMA_VERSION, GLOBAL_MANIFEST_PATH, PROJECT_MANIFEST_DIR, PROJECT_MANIFEST_FILENAME, createEmptyManifest, } from "./types.js";
+export { ManifestReadError, readManifest, readManifestFile } from "./read.js";
+export { ManifestWriteError, writeManifest, getManifestPathForScope, getManifestDirForScope } from "./write.js";
+export { expandPath, getManifestPath, getManifestDir, ensureManifestDir } from "./utils.js";
+export { canonicalizeManifest, hashManifest } from "./hash.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/manifest/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACvG,OAAO,KAAK,EAAE,YAAY,EAAsB,MAAM,YAAY,CAAC;AAKnE,YAAY,EACV,kBAAkB,EAClB,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EACZ,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAGjF,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAG/D,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAG7E,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,UAAU,EACV,eAAe,EACf,cAAc,EACd,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,WAAW,EACpB,GAAG,EAAE,WAAW,EAChB,UAAU,EAAE,iBAAiB,EAAE,EAC/B,MAAM,EAAE,MAAM,EACd,KAAK,GAAE,iBAA4B,EACnC,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CA8Cf;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,iBAA4B,EACnC,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CA0B9B;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,GAAE,iBAA4B,EACnC,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,KAAK,CAAC;IAAE,OAAO,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,YAAY,CAAA;CAAE,CAAC,CAAC,CAyB9E;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,iBAA4B,EACnC,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,OAAO,CAAC,CAalB;AAED;;;;;;;;GAQG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,iBAA4B,EACnC,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,OAAO,CAAC,CAQlB;AAED;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,iBAA4B,EACnC,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAY9B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/manifest/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAC1F,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAChH,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC5F,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC"}