@shrkcrft/inspector 0.1.0-alpha.25 → 0.1.0-alpha.26

package/dist/changes-summary.d.ts

@@ -23,6 +23,14 @@ export declare enum ChangeArea {
     Tests = "tests",
     Examples = "examples",
     Scripts = "scripts",
+    /**
+     * Build / CI / tooling directories (`.github/`, `.husky/`, `ci/`, `tooling/`,
+     * `build/`). A generic, project-agnostic bucket so tooling paths stop
+     * falling through to {@link ChangeArea.Unknown}. Distinct from
+     * {@link ChangeArea.Config} (which is for manifest/config *files*) and from
+     * {@link ChangeArea.Scripts} (the dedicated `scripts/` area).
+     */
+    Tooling = "tooling",
     E2E = "e2e",
     Sharkcraft = "sharkcraft-self-config",
     Reports = "reports",

package/dist/changes-summary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"changes-summary.d.ts","sourceRoot":"","sources":["../src/changes-summary.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"changes-summary.d.ts","sourceRoot":"","sources":["../src/changes-summary.ts"],"names":[],"mappings":"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"}

package/dist/changes-summary.js

@@ -39,6 +39,14 @@ export var ChangeArea;
     ChangeArea["Tests"] = "tests";
     ChangeArea["Examples"] = "examples";
     ChangeArea["Scripts"] = "scripts";
+    /**
+     * Build / CI / tooling directories (`.github/`, `.husky/`, `ci/`, `tooling/`,
+     * `build/`). A generic, project-agnostic bucket so tooling paths stop
+     * falling through to {@link ChangeArea.Unknown}. Distinct from
+     * {@link ChangeArea.Config} (which is for manifest/config *files*) and from
+     * {@link ChangeArea.Scripts} (the dedicated `scripts/` area).
+     */
+    ChangeArea["Tooling"] = "tooling";
     ChangeArea["E2E"] = "e2e";
     ChangeArea["Sharkcraft"] = "sharkcraft-self-config";
     ChangeArea["Reports"] = "reports";
@@ -97,8 +105,59 @@ function classifyArea(file) {
     // doc as `unknown`.
     if (/\.mdx?$/i.test(file))
         return ChangeArea.Docs;
+    // NOTE: generic config / tooling / manifest paths are NOT resolved here. They
+    // are a FALLBACK layer applied by `buildAreaResolver` *after* the declared
+    // taxonomy (see `classifyConfigTooling`), so a project's own area declaration
+    // still wins for config paths it explicitly claims.
     return ChangeArea.Unknown;
 }
+/**
+ * Built-in, project-AGNOSTIC config / tooling / manifest classifier.
+ *
+ * This is a FALLBACK layer: `buildAreaResolver` consults it only *after* the
+ * declared taxonomy (boundary `from` globs + monorepo package roots), so a
+ * project that explicitly claims a config path keeps its own area. It exists so
+ * the large slice of a typical changeset that is build / CI / tooling /
+ * manifest / config stops falling through to {@link ChangeArea.Unknown} — which
+ * (with its loud `unknown = taxonomy gap` diagnostic) is now reserved for
+ * *genuinely* unclassifiable paths.
+ *
+ * Ordering is deterministic and most-specific-wins: a recognized manifest /
+ * config *filename* (→ {@link ChangeArea.Config}) is matched before a generic
+ * tooling *directory* (→ {@link ChangeArea.Tooling}). Returns `undefined` when
+ * nothing matches so the caller can fall through to `unknown`.
+ */
+function classifyConfigTooling(file) {
+    const base = file.slice(file.lastIndexOf('/') + 1).toLowerCase();
+    // Manifests / config files (matched by basename, at repo root or anywhere) →
+    // config. Covers: package.json, tsconfig*.json, *.config.{ts,js,mjs,cjs,json},
+    // nx.json, biome.json, .eslintrc*, .prettierrc*, bunfig.toml, lockfiles,
+    // .npmrc, .editorconfig.
+    if (base === 'package.json' ||
+        base === 'nx.json' ||
+        base === 'biome.json' ||
+        base === 'bunfig.toml' ||
+        base === '.npmrc' ||
+        base === '.editorconfig' ||
+        base === 'package-lock.json' ||
+        /^tsconfig(?:\..+)?\.json$/.test(base) ||
+        /\.config\.(?:ts|js|mjs|cjs|json)$/.test(base) ||
+        /^\.eslintrc(?:\..+)?$/.test(base) ||
+        /^\.prettierrc(?:\..+)?$/.test(base) ||
+        // Lockfiles: yarn.lock, pnpm-lock.yaml, bun.lock(b), *.lock / *.lockb.
+        base === 'pnpm-lock.yaml' ||
+        /\.lockb?$/.test(base)) {
+        return ChangeArea.Config;
+    }
+    // CI / build / tooling directories → tooling. (`scripts/` is intentionally
+    // handled earlier by `classifyArea` as its own dedicated area.) `build/` is
+    // treated as build *scripts*; genuine build *output* dirs (e.g. `dist/`) are
+    // not claimed here.
+    if (/(?:^|\/)(?:\.github|\.husky|ci|tooling|build)\//.test(file)) {
+        return ChangeArea.Tooling;
+    }
+    return undefined;
+}
 /** Generic monorepo package/app root → area name. */
 const PACKAGE_ROOT_RE = /^(?:packages|apps|libs|modules|services)\/([^/]+)\//;
 /**
@@ -107,7 +166,11 @@ const PACKAGE_ROOT_RE = /^(?:packages|apps|libs|modules|services)\/([^/]+)\//;
  *   1. the built-in {@link classifyArea} slugs (nice names for this repo);
  *   2. the boundary gate's own `from` globs — the declared layer/area taxonomy;
  *   3. a generic monorepo package/app root (`packages/<name>/…` → `<name>`), so
- *      a foreign monorepo's packages resolve instead of bucketing to `unknown`.
+ *      a foreign monorepo's packages resolve instead of bucketing to `unknown`;
+ *   4. built-in, project-agnostic config / tooling / manifest patterns
+ *      ({@link classifyConfigTooling}) — the FALLBACK layer that runs after the
+ *      declared taxonomy so config paths (manifests, lockfiles, CI/build dirs)
+ *      resolve to `config` / `tooling` instead of `unknown`.
  * A file only stays `unknown` when NONE of these match — and a high unknown rate
  * is surfaced as a self-diagnostic (`unknownRate`), not a low-risk diff.
  */
@@ -138,6 +201,11 @@ function buildAreaResolver(inspection) {
         const pkg = PACKAGE_ROOT_RE.exec(file);
         if (pkg?.[1])
             return pkg[1];
+        // Built-in config / tooling fallback — runs last, before `unknown`, so the
+        // declared taxonomy (steps 2–3) still wins where it applies.
+        const configTooling = classifyConfigTooling(file);
+        if (configTooling)
+            return configTooling;
         return ChangeArea.Unknown;
     };
 }

package/dist/registry-lifecycle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry-lifecycle.d.ts","sourceRoot":"","sources":["../src/registry-lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,uBAAuB;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,kCAAkC,CAAC;IAC3C,YAAY,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,UAAU,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,SAAS,EAAE,OAAO,CAAC;IACnB,gFAAgF;IAChF,QAAQ,EAAE,OAAO,CAAC;IAClB,gFAAgF;IAChF,WAAW,EAAE,OAAO,CAAC;IACrB,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;IAC3C,eAAe,EAAE,aAAa,CAAC,uBAAuB,CAAC,CAAC;IACxD;;;;OAIG;IACH,gBAAgB,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAClD,OAAO,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;IACzC,eAAe,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACxC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,oCAAoC,EAAE,SAAS,MAAM,EAiBhE,CAAC;AA2NH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9B,GAAG,wBAAwB,CAyH3B;AAED,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,wBAAwB,GAAG,MAAM,CAiD1F"}
+{"version":3,"file":"registry-lifecycle.d.ts","sourceRoot":"","sources":["../src/registry-lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,uBAAuB;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,kCAAkC,CAAC;IAC3C,YAAY,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,UAAU,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,SAAS,EAAE,OAAO,CAAC;IACnB,gFAAgF;IAChF,QAAQ,EAAE,OAAO,CAAC;IAClB,gFAAgF;IAChF,WAAW,EAAE,OAAO,CAAC;IACrB,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;IAC3C,eAAe,EAAE,aAAa,CAAC,uBAAuB,CAAC,CAAC;IACxD;;;;OAIG;IACH,gBAAgB,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAClD,OAAO,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;IACzC,eAAe,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACxC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,oCAAoC,EAAE,SAAS,MAAM,EAiBhE,CAAC;AAuOH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9B,GAAG,wBAAwB,CA6H3B;AAED,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,wBAAwB,GAAG,MAAM,CAwD1F"}

package/dist/registry-lifecycle.js

@@ -50,7 +50,13 @@ function isGeneratedFile(file, content) {
         return true;
     return false;
 }
-function walk(dir, projectRoot, out, skipDirs) {
+function walk(dir, projectRoot, out, skipDirs, deadline) {
+    // The wall-clock budget must bound the TREE WALK too, not only the per-file
+    // scan loop — a pathological tree could otherwise eat the whole budget before
+    // the loop's deadline check ever runs (a25 §2.5). Bail the walk on expiry;
+    // partial candidates flow through and the caller flags timedOut.
+    if (deadline !== undefined && Date.now() > deadline)
+        return;
     let entries;
     try {
         entries = readdirSync(dir, { withFileTypes: true });
@@ -59,6 +65,8 @@ function walk(dir, projectRoot, out, skipDirs) {
         return;
     }
     for (const e of entries) {
+        if (deadline !== undefined && Date.now() > deadline)
+            return;
         if (skipDirs.has(e.name))
             continue;
         if (e.name.startsWith('.') && e.name !== '.sharkcraft') {
@@ -68,7 +76,7 @@ function walk(dir, projectRoot, out, skipDirs) {
         }
         const abs = join(dir, e.name);
         if (e.isDirectory()) {
-            walk(abs, projectRoot, out, skipDirs);
+            walk(abs, projectRoot, out, skipDirs, deadline);
         }
         else if (e.isFile() && SCAN_EXTENSIONS.has(extname(e.name))) {
             out.push(abs);
@@ -295,7 +303,7 @@ export function buildRegistryLifecycleReport(input) {
     else {
         const walkRoot = scope ? join(projectRoot, scope) : projectRoot;
         files = [];
-        walk(walkRoot, projectRoot, files, skipDirs);
+        walk(walkRoot, projectRoot, files, skipDirs, deadline);
     }
     const scanFiles = files.slice(0, limit);
     const matchedPairs = [];
@@ -303,7 +311,11 @@ export function buildRegistryLifecycleReport(input) {
     const oneShotBootstrap = [];
     const ignored = [];
     let registersFound = 0;
-    let timedOut = false;
+    // The tree walk itself is now deadline-bounded (a25 §2.5), so an exhausted
+    // budget can leave `scanFiles` empty and the per-file loop below would never
+    // run to set the flag. Seed it from the deadline so a walk-level timeout is
+    // reported (NOT-verified `2`) rather than read as a clean zero-registration pass.
+    let timedOut = Date.now() > deadline;
     let filesScanned = 0;
     for (const file of scanFiles) {
         // Hard wall-clock budget checked between files — the scan is synchronous, so
@@ -427,6 +439,13 @@ export function renderRegistryLifecycleReportText(report) {
     lines.push(`  missing removers  ${report.missingRemovers.length}`);
     lines.push(`  one-shot bootstrap ${report.oneShotBootstrap.length}`);
     lines.push(`  ignored           ${report.ignored.length}`);
+    // Zero registrations in scope means nothing was actually checked — say so
+    // loudly so it never reads as the green "all removers present" pass (the exit
+    // code is NOT-verified `2` to match; a25 §1 / §2.5).
+    if (report.registersFound === 0 && !report.timedOut) {
+        lines.push('');
+        lines.push('  ! 0 registrations found in scope — lifecycle NOT verified (this is not a pass).');
+    }
     lines.push('');
     if (report.missingRemovers.length > 0) {
         lines.push('Missing removers:');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shrkcrft/inspector",
-  "version": "0.1.0-alpha.25",
+  "version": "0.1.0-alpha.26",
   "description": "SharkCraft inspector: project overview, doctor checks, AI-agent instructions.",
   "license": "MIT",
   "author": "SharkCraft contributors",
@@ -42,22 +42,22 @@
     "typecheck": "tsc --noEmit -p tsconfig.json"
   },
   "dependencies": {
-    "@shrkcrft/core": "^0.1.0-alpha.25",
-    "@shrkcrft/config": "^0.1.0-alpha.25",
-    "@shrkcrft/workspace": "^0.1.0-alpha.25",
-    "@shrkcrft/knowledge": "^0.1.0-alpha.25",
-    "@shrkcrft/rules": "^0.1.0-alpha.25",
-    "@shrkcrft/paths": "^0.1.0-alpha.25",
-    "@shrkcrft/templates": "^0.1.0-alpha.25",
-    "@shrkcrft/context": "^0.1.0-alpha.25",
-    "@shrkcrft/pipelines": "^0.1.0-alpha.25",
-    "@shrkcrft/packs": "^0.1.0-alpha.25",
-    "@shrkcrft/presets": "^0.1.0-alpha.25",
-    "@shrkcrft/boundaries": "^0.1.0-alpha.25",
-    "@shrkcrft/generator": "^0.1.0-alpha.25",
-    "@shrkcrft/importer": "^0.1.0-alpha.25",
-    "@shrkcrft/plugin-api": "^0.1.0-alpha.25",
-    "@shrkcrft/dashboard-api": "^0.1.0-alpha.25",
+    "@shrkcrft/core": "^0.1.0-alpha.26",
+    "@shrkcrft/config": "^0.1.0-alpha.26",
+    "@shrkcrft/workspace": "^0.1.0-alpha.26",
+    "@shrkcrft/knowledge": "^0.1.0-alpha.26",
+    "@shrkcrft/rules": "^0.1.0-alpha.26",
+    "@shrkcrft/paths": "^0.1.0-alpha.26",
+    "@shrkcrft/templates": "^0.1.0-alpha.26",
+    "@shrkcrft/context": "^0.1.0-alpha.26",
+    "@shrkcrft/pipelines": "^0.1.0-alpha.26",
+    "@shrkcrft/packs": "^0.1.0-alpha.26",
+    "@shrkcrft/presets": "^0.1.0-alpha.26",
+    "@shrkcrft/boundaries": "^0.1.0-alpha.26",
+    "@shrkcrft/generator": "^0.1.0-alpha.26",
+    "@shrkcrft/importer": "^0.1.0-alpha.26",
+    "@shrkcrft/plugin-api": "^0.1.0-alpha.26",
+    "@shrkcrft/dashboard-api": "^0.1.0-alpha.26",
     "typescript": "^5.6.0"
   },
   "publishConfig": {