@hashicorp/kits 0.1.4 → 0.1.5

package/dist/manifest/read.js

@@ -1,14 +1,9 @@
 /**
- * Manifest read operations.
- *
- * Provides functionality to read and validate the installation manifest.
+ * Kits manifest (intent) read operations.
  */
 import fs from "node:fs/promises";
-import { MANIFEST_VERSION, createEmptyManifest } from "./types.js";
+import { MANIFEST_SCHEMA_VERSION } from "./types.js";
 import { getManifestPath } from "./utils.js";
-/**
- * Error thrown when manifest read fails.
- */
 export class ManifestReadError extends Error {
     errorCause;
     constructor(message, cause) {
@@ -17,70 +12,51 @@ export class ManifestReadError extends Error {
         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);
+export async function readManifestFile(manifestPath) {
     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}`);
+            throw new ManifestReadError(`Invalid kits manifest format at ${manifestPath}; expected schemaVersion ${MANIFEST_SCHEMA_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);
+            throw new ManifestReadError(`Failed to parse kits manifest at ${manifestPath}; invalid JSON`, error);
         }
-        // Other errors
-        throw new ManifestReadError(`Failed to read manifest at ${manifestPath}`, error);
+        throw new ManifestReadError(`Failed to read kits 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);
+export async function readManifest(scope = "global", projectRoot) {
+    const manifestPath = getManifestPath(scope, projectRoot);
+    try {
+        return await readManifestFile(manifestPath);
+    }
+    catch (error) {
+        const cause = error instanceof ManifestReadError && error.errorCause ? error.errorCause : error;
+        const nodeError = cause;
+        if (nodeError?.code === "ENOENT") {
+            return null;
+        }
+        throw error;
+    }
 }
-/**
- * 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") {
+    if (typeof m["schemaVersion"] !== "string") {
         return false;
     }
-    if (typeof m["lastUpdated"] !== "string") {
+    if (typeof m["scope"] !== "string") {
         return false;
     }
-    if (!m["harnesses"] || typeof m["harnesses"] !== "object") {
+    if (!Array.isArray(m["sources"])) {
         return false;
     }
     return true;

package/dist/manifest/read.js.map

@@ -1 +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"}
+{"version":3,"file":"read.js","sourceRoot":"","sources":["../../src/manifest/read.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAIlC,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,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,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,YAAoB;IACzD,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,CAAiB,CAAC;QAErD,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,iBAAiB,CACzB,mCAAmC,YAAY,4BAA4B,uBAAuB,EAAE,CACrG,CAAC;QACJ,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,iBAAiB,EAAE,CAAC;YACvC,MAAM,KAAK,CAAC;QACd,CAAC;QAED,IAAI,KAAK,YAAY,WAAW,EAAE,CAAC;YACjC,MAAM,IAAI,iBAAiB,CACzB,oCAAoC,YAAY,gBAAgB,EAChE,KAAK,CACN,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,iBAAiB,CAAC,mCAAmC,YAAY,EAAE,EAAE,KAAK,CAAC,CAAC;IACxF,CAAC;AACH,CAAC;AAED,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,OAAO,MAAM,gBAAgB,CAAC,YAAY,CAAC,CAAC;IAC9C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,KAAK,GACT,KAAK,YAAY,iBAAiB,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC;QACpF,MAAM,SAAS,GAAG,KAA8B,CAAC;QACjD,IAAI,SAAS,EAAE,IAAI,KAAK,QAAQ,EAAE,CAAC;YACjC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,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;IAC9C,IAAI,OAAO,CAAC,CAAC,eAAe,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC3C,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QACnC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;QACjC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/manifest/types.d.ts

@@ -1,119 +1,27 @@
 /**
- * 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.
+ * Kits manifest (intent) type definitions.
  */
+import type { HarnessName, InstallationScope } from "../core/types.js";
+export declare const MANIFEST_SCHEMA_VERSION: "1.0.0";
+export declare const GLOBAL_MANIFEST_PATH = "~/.agents/kits.json";
 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 {
+export declare const PROJECT_MANIFEST_FILENAME = "kits.json";
+export type ManifestCompatibility = "strict" | "compatible-only";
+export interface KitsManifestKit {
     name: string;
-    type: PrimitiveType;
-    namespacedName: string;
-    version?: string;
-    versionSpec?: string;
-    isInline: boolean;
-    installedPath: string;
-    instanceName?: string;
-    configHash?: string;
+    installAs?: string;
 }
-/**
- * Information about an installed kit.
- */
-export interface InstalledKit {
-    version: string;
-    installedAt: string;
+export interface KitsManifestSource {
     source: string;
-    primitives: InstalledPrimitive[];
+    kits?: Array<string | KitsManifestKit>;
 }
-/**
- * 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;
+export interface KitsManifest {
+    schemaVersion: string;
     scope: InstallationScope;
-    projectRoot?: string;
-    lastUpdated: string;
-    source?: string;
-    harnesses: Partial<Record<HarnessName, HarnessInstallation>>;
+    sources: KitsManifestSource[];
+    harnesses?: HarnessName[];
+    compatibility?: ManifestCompatibility;
+    mcpInstanceOverrides?: Record<string, Record<string, string>>;
 }
-/**
- * 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;
+export declare function createEmptyManifest(scope?: InstallationScope): KitsManifest;
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/manifest/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/manifest/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAEvE,eAAO,MAAM,uBAAuB,EAAG,OAAgB,CAAC;AAExD,eAAO,MAAM,oBAAoB,wBAAwB,CAAC;AAC1D,eAAO,MAAM,oBAAoB,YAAY,CAAC;AAC9C,eAAO,MAAM,yBAAyB,cAAc,CAAC;AAErD,MAAM,MAAM,qBAAqB,GAAG,QAAQ,GAAG,iBAAiB,CAAC;AAEjE,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,eAAe,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,iBAAiB,CAAC;IACzB,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;IAC1B,aAAa,CAAC,EAAE,qBAAqB,CAAC;IACtC,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC/D;AAED,wBAAgB,mBAAmB,CAAC,KAAK,GAAE,iBAA4B,GAAG,YAAY,CAMrF"}

package/dist/manifest/types.js

@@ -1,44 +1,15 @@
 /**
- * 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.
+ * Kits manifest (intent) type definitions.
  */
+export const MANIFEST_SCHEMA_VERSION = "1.0.0";
+export const GLOBAL_MANIFEST_PATH = "~/.agents/kits.json";
 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,
+export const PROJECT_MANIFEST_FILENAME = "kits.json";
+export function createEmptyManifest(scope = "global") {
+    return {
+        schemaVersion: MANIFEST_SCHEMA_VERSION,
         scope,
-        lastUpdated: new Date().toISOString(),
-        harnesses: {},
+        sources: [],
     };
-    if (scope === "project" && projectRoot) {
-        manifest.projectRoot = projectRoot;
-    }
-    return manifest;
 }
 //# sourceMappingURL=types.js.map

package/dist/manifest/types.js.map

@@ -1 +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"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/manifest/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,CAAC,MAAM,uBAAuB,GAAG,OAAgB,CAAC;AAExD,MAAM,CAAC,MAAM,oBAAoB,GAAG,qBAAqB,CAAC;AAC1D,MAAM,CAAC,MAAM,oBAAoB,GAAG,SAAS,CAAC;AAC9C,MAAM,CAAC,MAAM,yBAAyB,GAAG,WAAW,CAAC;AAuBrD,MAAM,UAAU,mBAAmB,CAAC,QAA2B,QAAQ;IACrE,OAAO;QACL,aAAa,EAAE,uBAAuB;QACtC,KAAK;QACL,OAAO,EAAE,EAAE;KACZ,CAAC;AACJ,CAAC"}

package/dist/manifest/utils.d.ts

@@ -1,35 +1,9 @@
 /**
- * Shared utilities for the manifest module.
+ * Shared utilities for the kits manifest 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 manifest file 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 manifest file
- */
 export declare function getManifestPath(scope: InstallationScope, projectRoot?: string): string;
-/**
- * Get the manifest 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 manifest directory
- */
 export declare function getManifestDir(scope: InstallationScope, projectRoot?: string): string;
-/**
- * Ensure the manifest 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 ensureManifestDir(scope: InstallationScope, projectRoot?: string): Promise<void>;
 //# sourceMappingURL=utils.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/manifest/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"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/manifest/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAO1D,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,iBAAiB,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAUtF;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,iBAAiB,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAErF;AAED,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGrG"}

package/dist/manifest/utils.js

@@ -1,15 +1,9 @@
 /**
- * Shared utilities for the manifest module.
+ * Shared utilities for the kits manifest module.
  */
 import fs from "node:fs/promises";
 import path from "node:path";
 import { GLOBAL_MANIFEST_PATH, PROJECT_MANIFEST_DIR, PROJECT_MANIFEST_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"] || "";
@@ -17,39 +11,18 @@ export function expandPath(pathStr) {
     }
     return pathStr;
 }
-/**
- * Get the manifest file 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 manifest file
- */
 export function getManifestPath(scope, projectRoot) {
     if (scope === "global") {
         return expandPath(GLOBAL_MANIFEST_PATH);
     }
-    // Project scope
     if (!projectRoot) {
         throw new Error("projectRoot is required for project scope");
     }
     return path.join(projectRoot, PROJECT_MANIFEST_DIR, PROJECT_MANIFEST_FILENAME);
 }
-/**
- * Get the manifest 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 manifest directory
- */
 export function getManifestDir(scope, projectRoot) {
     return path.dirname(getManifestPath(scope, projectRoot));
 }
-/**
- * Ensure the manifest 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 ensureManifestDir(scope, projectRoot) {
     const manifestDir = getManifestDir(scope, projectRoot);
     await fs.mkdir(manifestDir, { recursive: true });

package/dist/manifest/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/manifest/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"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/manifest/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,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,MAAM,UAAU,eAAe,CAAC,KAAwB,EAAE,WAAoB;IAC5E,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvB,OAAO,UAAU,CAAC,oBAAoB,CAAC,CAAC;IAC1C,CAAC;IAED,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,MAAM,UAAU,cAAc,CAAC,KAAwB,EAAE,WAAoB;IAC3E,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,KAAwB,EAAE,WAAoB;IACpF,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/manifest/write.d.ts

@@ -1,44 +1,13 @@
 /**
- * Manifest write operations.
- *
- * Provides functionality to write and update the installation manifest.
+ * Kits manifest (intent) write operations.
  */
 import type { InstallationScope } from "../core/types.js";
-import type { InstallationManifest } from "./types.js";
-/**
- * Error thrown when manifest write fails.
- */
+import type { KitsManifest } from "./types.js";
 export declare class ManifestWriteError extends Error {
     readonly errorCause?: unknown;
     constructor(message: string, cause?: unknown);
 }
-/**
- * Write the installation manifest to disk.
- *
- * Creates the manifest directory if it doesn't exist.
- * Updates the lastUpdated timestamp automatically.
- * Ensures the scope field matches the write location.
- *
- * @param manifest - The manifest to write
- * @param scope - Installation scope (global or project), defaults to manifest.scope
- * @param projectRoot - Absolute path to project root (required for project scope)
- * @throws ManifestWriteError if writing fails
- */
-export declare function writeManifest(manifest: InstallationManifest, scope?: InstallationScope, projectRoot?: string): Promise<void>;
-/**
- * Get the expanded manifest 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 manifest file
- */
+export declare function writeManifest(manifest: KitsManifest, scope?: InstallationScope, projectRoot?: string): Promise<void>;
 export declare function getManifestPathForScope(scope?: InstallationScope, projectRoot?: string): string;
-/**
- * Get the manifest 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 manifest directory
- */
 export declare function getManifestDirForScope(scope?: InstallationScope, projectRoot?: string): string;
 //# sourceMappingURL=write.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../src/manifest/write.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAGvD;;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,oBAAoB,EAC9B,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"}
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../src/manifest/write.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI/C,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;gBAElB,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAK7C;AAED,wBAAsB,aAAa,CACjC,QAAQ,EAAE,YAAY,EACtB,KAAK,CAAC,EAAE,iBAAiB,EACzB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAef;AAED,wBAAgB,uBAAuB,CACrC,KAAK,GAAE,iBAA4B,EACnC,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAER;AAED,wBAAgB,sBAAsB,CACpC,KAAK,GAAE,iBAA4B,EACnC,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAER"}

package/dist/manifest/write.js

@@ -1,13 +1,9 @@
 /**
- * Manifest write operations.
- *
- * Provides functionality to write and update the installation manifest.
+ * Kits manifest (intent) write operations.
  */
 import fs from "node:fs/promises";
+import { MANIFEST_SCHEMA_VERSION } from "./types.js";
 import { getManifestPath, getManifestDir, ensureManifestDir } from "./utils.js";
-/**
- * Error thrown when manifest write fails.
- */
 export class ManifestWriteError extends Error {
     errorCause;
     constructor(message, cause) {
@@ -16,61 +12,25 @@ export class ManifestWriteError extends Error {
         this.errorCause = cause;
     }
 }
-/**
- * Write the installation manifest to disk.
- *
- * Creates the manifest directory if it doesn't exist.
- * Updates the lastUpdated timestamp automatically.
- * Ensures the scope field matches the write location.
- *
- * @param manifest - The manifest to write
- * @param scope - Installation scope (global or project), defaults to manifest.scope
- * @param projectRoot - Absolute path to project root (required for project scope)
- * @throws ManifestWriteError if writing fails
- */
 export async function writeManifest(manifest, scope, projectRoot) {
-    // Use provided scope or fall back to manifest's scope
     const effectiveScope = scope ?? manifest.scope;
     const manifestPath = getManifestPath(effectiveScope, projectRoot);
     try {
-        // Ensure directory exists
         await ensureManifestDir(effectiveScope, projectRoot);
-        // Update timestamp
-        manifest.lastUpdated = new Date().toISOString();
-        // Ensure scope field is set correctly
         manifest.scope = effectiveScope;
-        // Set or clear projectRoot based on scope
-        if (effectiveScope === "project" && projectRoot) {
-            manifest.projectRoot = projectRoot;
-        }
-        else if (effectiveScope === "global") {
-            delete manifest.projectRoot;
+        if (!manifest.schemaVersion) {
+            manifest.schemaVersion = MANIFEST_SCHEMA_VERSION;
         }
-        // Write manifest with pretty formatting
         const content = JSON.stringify(manifest, null, 2);
         await fs.writeFile(manifestPath, content, "utf-8");
     }
     catch (error) {
-        throw new ManifestWriteError(`Failed to write manifest to ${manifestPath}`, error);
+        throw new ManifestWriteError(`Failed to write kits manifest to ${manifestPath}`, error);
     }
 }
-/**
- * Get the expanded manifest 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 manifest file
- */
 export function getManifestPathForScope(scope = "global", projectRoot) {
     return getManifestPath(scope, projectRoot);
 }
-/**
- * Get the manifest 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 manifest directory
- */
 export function getManifestDirForScope(scope = "global", projectRoot) {
     return getManifestDir(scope, projectRoot);
 }

package/dist/manifest/write.js.map

@@ -1 +1 @@
-{"version":3,"file":"write.js","sourceRoot":"","sources":["../../src/manifest/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,QAA8B,EAC9B,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"}
+{"version":3,"file":"write.js","sourceRoot":"","sources":["../../src/manifest/write.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAIlC,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEhF,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,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,QAAsB,EACtB,KAAyB,EACzB,WAAoB;IAEpB,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,MAAM,iBAAiB,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;QACrD,QAAQ,CAAC,KAAK,GAAG,cAAc,CAAC;QAChC,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;YAC5B,QAAQ,CAAC,aAAa,GAAG,uBAAuB,CAAC;QACnD,CAAC;QACD,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,CAAC,oCAAoC,YAAY,EAAE,EAAE,KAAK,CAAC,CAAC;IAC1F,CAAC;AACH,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,QAA2B,QAAQ,EACnC,WAAoB;IAEpB,OAAO,eAAe,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,QAA2B,QAAQ,EACnC,WAAoB;IAEpB,OAAO,cAAc,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;AAC5C,CAAC"}

package/dist/resolution/index.d.ts

@@ -1,7 +1,7 @@
 /**
  * Primitive resolution module.
  *
- * Provides functionality to resolve primitive references from kit definitions
+ * Provides functionality to resolve primitive references from kit manifests
  * to concrete versions in the shared primitives library.
  */
 import type { KitManifest } from "../core/types.js";
@@ -16,29 +16,29 @@ export { resolveMultipleKits, deduplicatePrimitives } from "./multi-kit-resolver
 export type { CliEnvFlags } from "./env-resolver.js";
 export { extractEnvDefsFromConfig, extractHeaderDefsFromConfig, resolveEnvVars, resolveHeaders, validateCliEnvFlags, resolveEnvVarsFromConfig, mergeEnvDefs, } from "./env-resolver.js";
 /**
- * Resolves all primitive references in a kit definition.
+ * Resolves all primitive references in a kit manifest.
  *
  * This function processes both referenced primitives (with `ref` syntax)
  * and inline primitives (with `entrypoint` syntax), resolving references
  * to concrete versions from the primitives registry.
  *
- * @param kit - The kit definition
+ * @param kit - The kit manifest
  * @param registry - The primitives registry loader
  * @param kitBasePath - Base path to the kit directory
  * @returns Resolution result with resolved primitives and any errors
  */
-export declare function resolvePrimitiveReferences(kit: KitManifest, registry: PrimitivesRegistryLoader, kitBasePath: string): Promise<KitResolutionResult>;
+export declare function resolvePrimitiveReferences(kit: KitManifest, registry: PrimitivesRegistryLoader, kitBasePath: string, lockedVersions?: Map<string, string>, kitInstanceName?: string): Promise<KitResolutionResult>;
 /**
  * Checks if a kit has any referenced primitives (requiring resolution).
  *
- * @param kit - The kit definition
+ * @param kit - The kit manifest
  * @returns True if the kit has referenced primitives
  */
 export declare function hasReferencedPrimitives(kit: KitManifest): boolean;
 /**
  * Counts primitives by resolution type.
  *
- * @param kit - The kit definition
+ * @param kit - The kit manifest
  * @returns Object with referenced and inline counts
  */
 export declare function countPrimitivesByType(kit: KitManifest): {
@@ -48,7 +48,7 @@ export declare function countPrimitivesByType(kit: KitManifest): {
 /**
  * Extracts all primitive references from a kit.
  *
- * @param kit - The kit definition
+ * @param kit - The kit manifest
  * @returns Array of reference strings
  */
 export declare function extractReferences(kit: KitManifest): string[];

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resolution/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EACV,WAAW,EAOZ,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,mBAAmB,EAAmB,MAAM,YAAY,CAAC;AAEvE,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAMpE,YAAY,EACV,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,EACvB,eAAe,EACf,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGhD,OAAO,EACL,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,WAAW,EACX,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,SAAS,EACT,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAGrF,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,wBAAwB,EACxB,YAAY,GACb,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;;;;GAWG;AACH,wBAAsB,0BAA0B,CAC9C,GAAG,EAAE,WAAW,EAChB,QAAQ,EAAE,wBAAwB,EAClC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,mBAAmB,CAAC,CAkC9B;AAiWD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAQjE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,WAAW,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAkB9F;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,EAAE,CAe5D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resolution/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EACV,WAAW,EAOZ,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,mBAAmB,EAAmB,MAAM,YAAY,CAAC;AAEvE,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAMpE,YAAY,EACV,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,EACvB,eAAe,EACf,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGhD,OAAO,EACL,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,WAAW,EACX,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,SAAS,EACT,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAGrF,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,wBAAwB,EACxB,YAAY,GACb,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;;;;GAWG;AACH,wBAAsB,0BAA0B,CAC9C,GAAG,EAAE,WAAW,EAChB,QAAQ,EAAE,wBAAwB,EAClC,WAAW,EAAE,MAAM,EACnB,cAAc,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACpC,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,mBAAmB,CAAC,CAoC9B;AA6WD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAQjE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,WAAW,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAkB9F;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,EAAE,CAe5D"}