@shrkcrft/packs 0.1.0-alpha.2 → 0.1.0-alpha.20

package/dist/discovery/discover-packs.d.ts

@@ -17,12 +17,27 @@ export interface DiscoverPacksOptions {
     verifySignatures?: boolean;
     /** Override the secret used for signature verification. */
     packSecret?: string;
+    /**
+     * Skip the process-level discovery cache. The cache is keyed by
+     * projectRoot + lockfile mtime, so installs/upgrades invalidate it
+     * automatically. Pass `noCache: true` to force a fresh scan (e.g.
+     * after editing a manifest in place during a long-running process).
+     */
+    noCache?: boolean;
 }
+/** Clear the process-level pack-discovery cache. Tests use this. */
+export declare function clearPackDiscoveryCache(): void;
 /**
  * Walk `<projectRoot>/node_modules/` (+ any extra roots) and surface every
  * package whose `package.json` declares a `sharkcraft` field. For each, load
  * the manifest and run validatePackManifest. Returns a structured discovery
  * result; never throws on individual pack failures.
+ *
+ * The result is cached at process-level keyed by projectRoot + lock-file
+ * mtime, so repeated calls within a single CLI invocation (or MCP server
+ * session) skip the node_modules walk. The cache invalidates automatically
+ * on any install/upgrade and is bypassed entirely when signature
+ * verification is requested or extra roots are supplied.
  */
 export declare function discoverPacks(options: DiscoverPacksOptions): Promise<IPackDiscoveryResult>;
 //# sourceMappingURL=discover-packs.d.ts.map

package/dist/discovery/discover-packs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"discover-packs.d.ts","sourceRoot":"","sources":["../../src/discovery/discover-packs.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAmB,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAqHxF,MAAM,WAAW,oBAAoB;IACnC,iEAAiE;IACjE,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,6EAA6E;IAC7E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAoIhG"}
+{"version":3,"file":"discover-packs.d.ts","sourceRoot":"","sources":["../../src/discovery/discover-packs.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAmB,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAuHxF,MAAM,WAAW,oBAAoB;IACnC,iEAAiE;IACjE,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,6EAA6E;IAC7E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAmDD,oEAAoE;AACpE,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAqJhG"}

package/dist/discovery/discover-packs.js

@@ -6,7 +6,7 @@ var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExte
     }
     return path;
 };
-import { existsSync, readdirSync, readFileSync, realpathSync } from 'node:fs';
+import { existsSync, readdirSync, readFileSync, realpathSync, statSync } from 'node:fs';
 import * as nodePath from 'node:path';
 import { pathToFileURL } from 'node:url';
 import { PACK_SECRET_ENV, validatePackManifest, verifyPackManifest, } from '@shrkcrft/plugin-api';
@@ -43,6 +43,7 @@ function emptyCounts() {
         constructFiles: 0,
         constructFacetFiles: 0,
         playbookFiles: 0,
+        delegateRecipeFiles: 0,
     };
 }
 function countContributions(c) {
@@ -61,6 +62,7 @@ function countContributions(c) {
     out.constructFiles = c.constructFiles?.length ?? 0;
     out.constructFacetFiles = c.constructFacetFiles?.length ?? 0;
     out.playbookFiles = c.playbookFiles?.length ?? 0;
+    out.delegateRecipeFiles = c.delegateRecipeFiles?.length ?? 0;
     return out;
 }
 /**
@@ -120,16 +122,72 @@ function* scanNodeModules(nodeModulesPath) {
         }
     }
 }
+const discoveryCache = new Map();
+function lockFingerprintFor(projectRoot) {
+    // Try each known lock file in order; first existing one wins. mtimeMs
+    // changes every install, so it's a tight invalidation signal.
+    const candidates = ['bun.lockb', 'bun.lock', 'package-lock.json', 'pnpm-lock.yaml', 'yarn.lock'];
+    for (const name of candidates) {
+        const p = nodePath.join(projectRoot, name);
+        if (existsSync(p)) {
+            try {
+                const st = statSync(p);
+                return `${name}:${st.mtimeMs}:${st.size}`;
+            }
+            catch {
+                // fall through and try the next candidate
+            }
+        }
+    }
+    // No lock file — also cache by node_modules mtime as a fallback.
+    const nm = nodePath.join(projectRoot, 'node_modules');
+    if (existsSync(nm)) {
+        try {
+            const st = statSync(nm);
+            return `node_modules:${st.mtimeMs}`;
+        }
+        catch {
+            // ignore
+        }
+    }
+    return 'none';
+}
+function cacheKeyOf(key) {
+    return `${key.projectRoot}::${key.lockFingerprint}`;
+}
+/** Clear the process-level pack-discovery cache. Tests use this. */
+export function clearPackDiscoveryCache() {
+    discoveryCache.clear();
+}
 /**
  * Walk `<projectRoot>/node_modules/` (+ any extra roots) and surface every
  * package whose `package.json` declares a `sharkcraft` field. For each, load
  * the manifest and run validatePackManifest. Returns a structured discovery
  * result; never throws on individual pack failures.
+ *
+ * The result is cached at process-level keyed by projectRoot + lock-file
+ * mtime, so repeated calls within a single CLI invocation (or MCP server
+ * session) skip the node_modules walk. The cache invalidates automatically
+ * on any install/upgrade and is bypassed entirely when signature
+ * verification is requested or extra roots are supplied.
  */
 export async function discoverPacks(options) {
     const projectRoot = nodePath.resolve(options.projectRoot);
     const nodeModulesPath = nodePath.join(projectRoot, 'node_modules');
     const nodeModulesExists = existsSync(nodeModulesPath);
+    // Cache lookup — only when the caller doesn't disable it AND when no
+    // signature-verification or extra-root option might change the answer.
+    const cacheable = !options.noCache &&
+        !options.verifySignatures &&
+        (!options.extraRoots || options.extraRoots.length === 0);
+    const cacheKey = cacheable
+        ? cacheKeyOf({ projectRoot, lockFingerprint: lockFingerprintFor(projectRoot) })
+        : null;
+    if (cacheKey) {
+        const cached = discoveryCache.get(cacheKey);
+        if (cached)
+            return cached;
+    }
     const result = {
         projectRoot,
         nodeModulesPath,
@@ -247,5 +305,8 @@ export async function discoverPacks(options) {
             }
         }
     }
+    if (cacheKey) {
+        discoveryCache.set(cacheKey, result);
+    }
     return result;
 }

package/dist/model/pack-discovery.d.ts

@@ -23,6 +23,7 @@ export interface IDiscoveredPack {
         constructFiles: number;
         constructFacetFiles: number;
         playbookFiles: number;
+        delegateRecipeFiles: number;
     };
     /**
      * Number of **resolved objects** loaded from this pack's contributions, after

package/dist/model/pack-discovery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pack-discovery.d.ts","sourceRoot":"","sources":["../../src/model/pack-discovery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAEpE,MAAM,WAAW,eAAe;IAC9B,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,0DAA0D;IAC1D,YAAY,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,uBAAuB,CAAC;IACnC,2EAA2E;IAC3E,kBAAkB,EAAE;QAClB,cAAc,EAAE,MAAM,CAAC;QACvB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,MAAM,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,gBAAgB,EAAE,MAAM,CAAC;QACzB,cAAc,EAAE,MAAM,CAAC;QACvB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IACF;;;;;OAKG;IACH,cAAc,CAAC,EAAE;QACf,gBAAgB,EAAE,MAAM,CAAC;QACzB,KAAK,EAAE,MAAM,CAAC;QACd,eAAe,EAAE,MAAM,CAAC;QACxB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,gBAAgB,EAAE,MAAM,CAAC;QACzB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,mDAAmD;IACnD,gBAAgB,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5D,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,KAAK,EAAE,OAAO,CAAC;IACf,sDAAsD;IACtD,eAAe,CAAC,EACZ,UAAU,GACV,mBAAmB,GACnB,mBAAmB,GACnB,gBAAgB,GAChB,aAAa,CAAC;IAClB,2DAA2D;IAC3D,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,uDAAuD;IACvD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,uDAAuD;IACvD,eAAe,EAAE,eAAe,EAAE,CAAC;IACnC,2BAA2B;IAC3B,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,YAAY,EAAE,eAAe,EAAE,CAAC;IAChC,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB"}
+{"version":3,"file":"pack-discovery.d.ts","sourceRoot":"","sources":["../../src/model/pack-discovery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAEpE,MAAM,WAAW,eAAe;IAC9B,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,0DAA0D;IAC1D,YAAY,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,uBAAuB,CAAC;IACnC,2EAA2E;IAC3E,kBAAkB,EAAE;QAClB,cAAc,EAAE,MAAM,CAAC;QACvB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,MAAM,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,gBAAgB,EAAE,MAAM,CAAC;QACzB,cAAc,EAAE,MAAM,CAAC;QACvB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,aAAa,EAAE,MAAM,CAAC;QACtB,mBAAmB,EAAE,MAAM,CAAC;KAC7B,CAAC;IACF;;;;;OAKG;IACH,cAAc,CAAC,EAAE;QACf,gBAAgB,EAAE,MAAM,CAAC;QACzB,KAAK,EAAE,MAAM,CAAC;QACd,eAAe,EAAE,MAAM,CAAC;QACxB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,gBAAgB,EAAE,MAAM,CAAC;QACzB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,mDAAmD;IACnD,gBAAgB,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5D,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,KAAK,EAAE,OAAO,CAAC;IACf,sDAAsD;IACtD,eAAe,CAAC,EACZ,UAAU,GACV,mBAAmB,GACnB,mBAAmB,GACnB,gBAAgB,GAChB,aAAa,CAAC;IAClB,2DAA2D;IAC3D,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,uDAAuD;IACvD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,uDAAuD;IACvD,eAAe,EAAE,eAAe,EAAE,CAAC;IACnC,2BAA2B;IAC3B,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,YAAY,EAAE,eAAe,EAAE,CAAC;IAChC,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB"}

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@shrkcrft/packs",
-  "version": "0.1.0-alpha.2",
+  "version": "0.1.0-alpha.20",
   "description": "SharkCraft pack discovery + loading: scan node_modules for sharkcraft manifests and surface contributions.",
   "license": "MIT",
   "author": "SharkCraft contributors",
   "type": "module",
   "main": "./dist/index.js",
-  "types": "./dist/index.d.d.ts",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -42,8 +42,8 @@
     "typecheck": "tsc --noEmit -p tsconfig.json"
   },
   "dependencies": {
-    "@shrkcrft/core": "^0.1.0-alpha.2",
-    "@shrkcrft/plugin-api": "^0.1.0-alpha.2"
+    "@shrkcrft/core": "^0.1.0-alpha.20",
+    "@shrkcrft/plugin-api": "^0.1.0-alpha.20"
   },
   "publishConfig": {
     "access": "public"