@skill-map/cli 0.40.0 → 0.41.0

package/dist/kernel/index.d.ts

@@ -1021,6 +1021,20 @@ interface ScanResult {
     providers: string[];
     /** Implementation metadata. Populated by `runScan` for self-describing output. */
     scannedBy?: ScanScannedBy;
+    /**
+     * Effective recommended cap on the number of files the walker accepted
+     * during this scan (`scan.maxNodes` from settings, default 256). The UI
+     * raises the "oversized graph" banner when
+     * `stats.filesWalked >= recommendedNodeLimit`. Absent on synthetic fixtures
+     * that bypass the walker.
+     */
+    recommendedNodeLimit?: number;
+    /**
+     * Override applied via `--max-nodes <N>` on the verb that ran the scan, or
+     * `null` when no override was passed (the value above came from the
+     * setting). Bidirectional: can raise OR lower the recommended limit.
+     */
+    overrideMaxNodes?: number | null;
     nodes: Node[];
     links: Link[];
     issues: Issue[];
@@ -3330,6 +3344,22 @@ interface RunScanOptions {
      *     pass `string | null` explicitly, never `undefined`.
      */
     activeProvider?: string | null;
+    /**
+     * Recommended cap on the number of nodes the walker classifies
+     * (mirror of `scan.maxNodes` in settings, default 256). Threaded
+     * through to `walkAndExtract` so the cap can fire and so
+     * `ScanResult.recommendedNodeLimit` is populated. Absent → the
+     * orchestrator falls back to 256 (the design default), keeping
+     * out-of-band callers and synthetic fixtures safe.
+     */
+    recommendedNodeLimit?: number;
+    /**
+     * Per-invocation override of the recommended cap (when `--max-nodes
+     * <N>` was passed). `null` (or absent) means no override; the
+     * recommended limit applies. Bidirectional: any positive integer
+     * replaces the recommended limit for the duration of this scan.
+     */
+    overrideMaxNodes?: number | null;
 }
 /**
  * Same as `runScan` but also returns the rename heuristic's `RenameOp[]`

package/dist/kernel/index.js

@@ -101,7 +101,7 @@ import cl100k_base from "js-tiktoken/ranks/cl100k_base";
 // package.json
 var package_default = {
   name: "@skill-map/cli",
-  version: "0.40.0",
+  version: "0.41.0",
   description: "skill-map reference implementation \u2014 kernel + CLI + adapters.",
   license: "MIT",
   type: "module",
@@ -775,6 +775,7 @@ var defaults_default = {
     strict: false,
     followSymlinks: false,
     maxFileSizeBytes: 1048576,
+    maxNodes: 256,
     watch: {
       debounceMs: 300
     },
@@ -2855,17 +2856,26 @@ async function walkAndExtract(opts) {
   const walkOptions = opts.ignoreFilter ? { ignoreFilter: opts.ignoreFilter } : {};
   let filesWalked = 0;
   let index = 0;
+  const effectiveMaxNodes = opts.overrideMaxNodes ?? opts.recommendedNodeLimit;
+  let capReached = false;
   const activeProviders = opts.providers.filter((provider) => {
     if (!provider.gatedByActiveLens) return true;
     if (opts.activeProvider === null) return true;
     return provider.id === opts.activeProvider;
   });
-  for (const provider of activeProviders) {
+  const advance = async (raw, provider) => {
+    const advanced = await processRawNode(raw, provider, wctx, accum, claimedPaths, index + 1);
+    if (advanced) index += 1;
+  };
+  outer: for (const provider of activeProviders) {
     for await (const raw of resolveProviderWalk(provider)(opts.roots, walkOptions)) {
       filesWalked += 1;
       if (claimedPaths.has(raw.path)) continue;
-      const advanced = await processRawNode(raw, provider, wctx, accum, claimedPaths, index + 1);
-      if (advanced) index += 1;
+      if (accum.nodes.length >= effectiveMaxNodes) {
+        capReached = true;
+        break outer;
+      }
+      await advance(raw, provider);
     }
   }
   const orphanSidecars = discoverOrphanSidecars(opts.roots);
@@ -2876,6 +2886,9 @@ async function walkAndExtract(opts) {
     cachedPaths: accum.cachedPaths,
     frontmatterIssues: accum.frontmatterIssues,
     filesWalked,
+    recommendedNodeLimit: opts.recommendedNodeLimit,
+    overrideMaxNodes: opts.overrideMaxNodes,
+    capReached,
     enrichments: [...accum.enrichmentBuffer.values()],
     extractorRuns: accum.extractorRuns,
     contributions: accum.contributionsBuffer,
@@ -3154,7 +3167,9 @@ async function runScanInternal(_kernel, options) {
     priorExtractorRuns: setup.priorExtractorRuns,
     providerFrontmatter: setup.providerFrontmatter,
     pluginStores: options.pluginStores,
-    activeProvider: activeProviderId
+    activeProvider: activeProviderId,
+    recommendedNodeLimit: options.recommendedNodeLimit ?? 256,
+    overrideMaxNodes: options.overrideMaxNodes ?? null
   });
   const activeProvider = activeProviderId ? exts.providers.find((p) => p.id === activeProviderId) ?? null : null;
   const resolved = resolveSignals({
@@ -3322,6 +3337,8 @@ function buildScanReturn(walked, issues, renameOps, stats, options, setup) {
       roots: options.roots,
       providers: setup.exts.providers.map((a) => a.id),
       scannedBy: SCANNED_BY,
+      recommendedNodeLimit: walked.recommendedNodeLimit,
+      overrideMaxNodes: walked.overrideMaxNodes,
       nodes: walked.nodes,
       links: walked.internalLinks,
       issues,