@shrkcrft/packs 0.1.0-alpha.1 → 0.1.0-alpha.11

package/README.md

@@ -2,7 +2,7 @@
 
 SharkCraft pack discovery + loading: scan node_modules for sharkcraft manifests and surface contributions.
 
-Part of [SharkCraft](https://github.com/sharkcraft/sharkcraft) — a deterministic, local-first toolkit that gives AI coding agents durable project context. See the main repo for documentation, examples, and the `shrk` CLI.
+Part of [SharkCraft](https://github.com/shrkcrft/sharkcraft) — a deterministic, local-first toolkit that gives AI coding agents durable project context. See the main repo for documentation, examples, and the `shrk` CLI.
 
 ## Install
 

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;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;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';
@@ -120,16 +120,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 +303,8 @@ export async function discoverPacks(options) {
             }
         }
     }
+    if (cacheKey) {
+        discoveryCache.set(cacheKey, result);
+    }
     return result;
 }

package/package.json

@@ -1,15 +1,16 @@
 {
   "name": "@shrkcrft/packs",
-  "version": "0.1.0-alpha.1",
+  "version": "0.1.0-alpha.11",
   "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.ts",
+  "types": "./dist/index.d.d.ts",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
+      "bun": "./src/index.ts",
       "import": "./dist/index.js",
       "default": "./dist/index.js"
     }
@@ -21,12 +22,12 @@
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/sharkcraft/sharkcraft.git",
+    "url": "git+https://github.com/shrkcrft/sharkcraft.git",
     "directory": "packages/packs"
   },
-  "homepage": "https://github.com/sharkcraft/sharkcraft",
+  "homepage": "https://github.com/shrkcrft/sharkcraft",
   "bugs": {
-    "url": "https://github.com/sharkcraft/sharkcraft/issues"
+    "url": "https://github.com/shrkcrft/sharkcraft/issues"
   },
   "keywords": [
     "sharkcraft",
@@ -41,8 +42,8 @@
     "typecheck": "tsc --noEmit -p tsconfig.json"
   },
   "dependencies": {
-    "@shrkcrft/core": "^0.1.0-alpha.1",
-    "@shrkcrft/plugin-api": "^0.1.0-alpha.1"
+    "@shrkcrft/core": "^0.1.0-alpha.11",
+    "@shrkcrft/plugin-api": "^0.1.0-alpha.11"
   },
   "publishConfig": {
     "access": "public"