@shrkcrft/inspector 0.1.0-alpha.30 → 0.1.0-alpha.31

package/dist/acceptance-replay.js

@@ -100,7 +100,7 @@ const CONDITIONAL_GATES = [
             f.path.startsWith('sharkcraft/')),
     },
     {
-        command: 'shrk product check',
+        command: 'shrk quality',
         category: 'gate',
         reason: ReplayReason.Inspector,
         trigger: (r) => r.files.some((f) => f.area === ChangeArea.Inspector),

package/dist/agent-contract-templates.js

@@ -63,7 +63,7 @@ export const PUBLIC_API_CHANGE_TEMPLATE = t({
         RULE_ERR('packages/plugin-api/**/internal/**', ContractFileRuleKind.Glob, 'Never touch internal/* from a public-API change.'),
         RULE_ERR('.git/**', ContractFileRuleKind.Glob, 'Never write to git internals.'),
     ],
-    defaultRequiredValidations: ['bun test', 'shrk doctor', 'shrk check boundaries', 'shrk api report --diff'],
+    defaultRequiredValidations: ['bun test', 'shrk doctor', 'shrk check boundaries', 'shrk api-diff .sharkcraft/api-baseline.json --fail-on-breaking'],
     defaultHumanApprovalGates: [
         'API reviewer approves the surface diff before `shrk apply`.',
         'Update CHANGELOG.md with public-API change notes.',
@@ -75,7 +75,7 @@ export const PUBLIC_API_CHANGE_TEMPLATE = t({
     ],
     defaultRollbackPlan: [
         'Revert the API change PR.',
-        'Re-run `shrk api report --diff` to confirm clean surface.',
+        'Re-run `shrk api-diff .sharkcraft/api-baseline.json --fail-on-breaking` to confirm clean surface.',
     ],
     appliesWhen: {
         taskKeywords: ['public api', 'plugin-api', 'exported', 'public surface'],
@@ -126,18 +126,18 @@ export const MIGRATION_TASK_TEMPLATE = t({
         RULE_ERR('package.json', ContractFileRuleKind.Exact, 'Do not bump dep versions mid-migration.'),
         RULE_ERR('.git/**', ContractFileRuleKind.Glob, 'Never write to git internals.'),
     ],
-    defaultRequiredValidations: ['bun test', 'shrk doctor', 'shrk migration readiness'],
+    defaultRequiredValidations: ['bun test', 'shrk doctor', 'shrk migrate plan <id>'],
     defaultHumanApprovalGates: [
-        'Migration readiness verdict must be "ready" before applying the migration plan.',
+        'The migration plan (`shrk migrate plan <id>`) must be reviewed before applying it.',
     ],
     defaultDefinitionOfDone: [
         'All migration steps reviewed.',
-        'Readiness is ready.',
+        'The migration plan was reviewed.',
         'Tests + boundary check pass after each step.',
     ],
     defaultRollbackPlan: [
         'Revert the migration commit.',
-        'Re-run `shrk migration readiness` to confirm rollback.',
+        'Re-run `shrk migrate plan <id>` to confirm the rollback state.',
     ],
     appliesWhen: {
         taskKeywords: ['migrate', 'migration', 'refactor', 'rename', 'rip out', 'retire'],

package/dist/agent-contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-contract.d.ts","sourceRoot":"","sources":["../src/agent-contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,gBAAgB,CAAC;AAKxB,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,eAAO,MAAM,qBAAqB,iCAAiC,CAAC;AAEpE,oBAAY,iBAAiB;IAC3B,YAAY,iBAAiB;IAC7B,QAAQ,aAAa;IACrB,UAAU,eAAe;CAC1B;AAED,MAAM,WAAW,0BAA0B;IACzC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,OAAO,qBAAqB,CAAC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,EAAE,eAAe,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,iBAAiB,CAAC;IACxB,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,2EAA2E;IAC3E,oBAAoB,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACpD,sBAAsB,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACtD,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC;AAqXD,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,qBAAqB,EACjC,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,cAAc,CAAC,CA0GzB;AAOD,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,cAAc,GAAG,MAAM,CA8BjE;AAOD,wBAAgB,2BAA2B,CAAC,CAAC,EAAE,cAAc,GAAG,MAAM,CA+BrE;AAWD,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,cAAc,GAAG,MAAM,CAGjE"}
+{"version":3,"file":"agent-contract.d.ts","sourceRoot":"","sources":["../src/agent-contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,gBAAgB,CAAC;AAKxB,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,eAAO,MAAM,qBAAqB,iCAAiC,CAAC;AAEpE,oBAAY,iBAAiB;IAC3B,YAAY,iBAAiB;IAC7B,QAAQ,aAAa;IACrB,UAAU,eAAe;CAC1B;AAED,MAAM,WAAW,0BAA0B;IACzC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,OAAO,qBAAqB,CAAC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,EAAE,eAAe,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,iBAAiB,CAAC;IACxB,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,2EAA2E;IAC3E,oBAAoB,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACpD,sBAAsB,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACtD,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC;AA2XD,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,qBAAqB,EACjC,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,cAAc,CAAC,CA0GzB;AAOD,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,cAAc,GAAG,MAAM,CA8BjE;AAOD,wBAAgB,2BAA2B,CAAC,CAAC,EAAE,cAAc,GAAG,MAAM,CA+BrE;AAWD,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,cAAc,GAAG,MAAM,CAGjE"}

package/dist/agent-contract.js

@@ -204,15 +204,18 @@ function buildAllowedCommands(role, intent) {
     const t = JSON.stringify(intent.task || '<task>');
     const out = [
         `shrk brief ${t}`,
-        `shrk intent ${t}`,
+        // The risk report carries the change intent; there is no separate intent verb.
         `shrk risk ${t} --include-memory`,
         `shrk impact --since main`,
         'shrk check boundaries',
     ];
     if (role === RoleId.AiAgent) {
-        out.push(`shrk handoff ${t}`);
+        // The handoff is a brief mode, not a verb of its own.
+        out.push(`shrk brief ${t} --mode handoff`);
         out.push(`shrk orchestrate ${t} --mode conservative`);
-        out.push(`shrk agent graph ${t} --role ai-agent`);
+        // There was never an agent-graph verb (the execution graph is the MCP
+        // `create_execution_graph` tool); the task packet is the CLI's answer.
+        out.push(`shrk task ${t}`);
     }
     if (role === RoleId.Reviewer || role === RoleId.Architect) {
         out.push('shrk review packet --v3 --since main');
@@ -225,6 +228,8 @@ function buildAllowedCommands(role, intent) {
     }
     return uniq(out);
 }
+/** The migration gate: the named migration's plan (there is no migration-readiness verb). */
+const MIGRATION_PLAN_COMMAND = 'shrk migrate plan <id>';
 function buildRequiredValidations(intent, risk) {
     const out = new Set();
     out.add('bun x tsc -p tsconfig.base.json --noEmit');
@@ -244,7 +249,7 @@ function buildRequiredValidations(intent, risk) {
         out.add('shrk release readiness --strict');
     }
     if (isMigrationTask(intent)) {
-        out.add('shrk migration readiness');
+        out.add(MIGRATION_PLAN_COMMAND);
     }
     return [...out];
 }
@@ -319,8 +324,8 @@ function buildDefinitionOfDone(intent, validations) {
     if (isReleaseTask(intent)) {
         out.push('CHANGELOG entry exists; preflight is green.');
     }
-    if (validations.includes('shrk migration readiness')) {
-        out.push('Migration readiness verdict is "ready".');
+    if (validations.includes(MIGRATION_PLAN_COMMAND)) {
+        out.push('The migration plan was reviewed before it was applied.');
     }
     return out;
 }
@@ -343,7 +348,7 @@ function buildSafetyNotes(role, intent, risk) {
     ];
     if (role === RoleId.AiAgent) {
         out.push('Agent contract requires explicit human approval before apply.');
-        out.push('Always run shrk handoff / shrk brief before first action.');
+        out.push('Always run shrk brief (or its handoff mode) before first action.');
     }
     if (risk.riskLevel === TaskRiskLevel.High || risk.riskLevel === TaskRiskLevel.Critical) {
         out.push(`Risk level is ${risk.riskLevel} — extra approval required.`);
@@ -356,7 +361,7 @@ function buildSafetyNotes(role, intent, risk) {
 function buildRecommendedNextCommand(role, intent) {
     const t = JSON.stringify(intent.task || '<task>');
     if (role === RoleId.AiAgent)
-        return `shrk handoff ${t}`;
+        return `shrk brief ${t} --mode handoff`;
     if (role === RoleId.ReleaseManager)
         return 'shrk release readiness --strict';
     if (role === RoleId.Security)

package/dist/agent-orchestration.js

@@ -56,7 +56,7 @@ function planPhase(intent, mode) {
         ]
         : [
             `shrk dev start "${intent.task}"`,
-            `shrk handoff "${intent.task}" --output .sharkcraft/handoff.md`,
+            `shrk brief "${intent.task}" --mode handoff --output .sharkcraft/handoff.md`,
             `shrk gen <templateId> <name> --dry-run --save-plan /tmp/plan.json`,
         ];
     return {
@@ -92,7 +92,7 @@ function reviewPhase(intent, mode) {
 function applyPhase(intent, mode) {
     const writePhase = intent.kind === ChangeIntentKind.Release ? 'release' : 'apply';
     const cmds = writePhase === 'release'
-        ? ['shrk release readiness --strict', 'shrk release smoke --scenario all', 'shrk release:preflight']
+        ? ['shrk release readiness --strict', 'shrk release smoke --scenario all', 'bun run release:preflight']
         : [
             'shrk apply /tmp/plan.json --verify-signature --validate --verification typecheck --verification unit-tests',
         ];

package/dist/agent-task-prep.d.ts

@@ -1,3 +1,5 @@
+import { type ReferenceKind } from './reference-registry.js';
+import type { ITaskRoutingRecommends } from '@shrkcrft/plugin-api';
 import type { ISharkcraftInspection } from './sharkcraft-inspector.js';
 export declare const AGENT_TASK_PREP_SCHEMA = "sharkcraft.agent-task-prep/v1";
 export interface IAgentTaskPrepReport {
@@ -19,10 +21,24 @@ export interface IAgentTaskPrepReport {
         id: string;
         title: string;
     }[];
+    /** Matched routing hints, each with the channels it recommends. */
     readonly routingHints: readonly {
         id: string;
         title: string;
         reasons: readonly string[];
+        recommends: Readonly<Partial<Record<keyof ITaskRoutingRecommends, readonly string[]>>>;
+    }[];
+    /**
+     * Every NON-command asset the matched routing hints recommend (templates,
+     * playbooks, pipelines, rules, path conventions, knowledge, policies, …) that
+     * resolves in its registry, deduped, in hint-score order. Only
+     * `recommends.commands` used to have a consumer; the other channels loaded,
+     * validated, and reached nothing.
+     */
+    readonly recommendedAssets: readonly {
+        kind: ReferenceKind;
+        id: string;
+        hintId: string;
     }[];
     readonly safetyNotes: readonly string[];
     readonly nextSafeAction: string;

package/dist/agent-task-prep.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-task-prep.d.ts","sourceRoot":"","sources":["../src/agent-task-prep.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,eAAO,MAAM,sBAAsB,kCAAkC,CAAC;AAEtE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,OAAO,sBAAsB,CAAC;IAC/C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IAC/C,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C,QAAQ,CAAC,gBAAgB,EAAE,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACpE,QAAQ,CAAC,mBAAmB,EAAE,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACvE,QAAQ,CAAC,YAAY,EAAE,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;IAC5F,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,qBAAqB,EACjC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,oBAAoB,CAAC,CAoD/B"}
+{"version":3,"file":"agent-task-prep.d.ts","sourceRoot":"","sources":["../src/agent-task-prep.ts"],"names":[],"mappings":"AAqBA,OAAO,EAA8C,KAAK,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAKzG,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,eAAO,MAAM,sBAAsB,kCAAkC,CAAC;AAEtE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,OAAO,sBAAsB,CAAC;IAC/C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IAC/C,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C,QAAQ,CAAC,gBAAgB,EAAE,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACpE,QAAQ,CAAC,mBAAmB,EAAE,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACvE,mEAAmE;IACnE,QAAQ,CAAC,YAAY,EAAE,SAAS;QAC9B,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;QAC3B,UAAU,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,sBAAsB,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;KACxF,EAAE,CAAC;IACJ;;;;;;OAMG;IACH,QAAQ,CAAC,iBAAiB,EAAE,SAAS;QAAE,IAAI,EAAE,aAAa,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC3F,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAcD,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,qBAAqB,EACjC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,oBAAoB,CAAC,CAkF/B"}

package/dist/agent-task-prep.js

@@ -16,13 +16,49 @@ import { buildTaskPacket } from "./task-packet.js";
 import { listConventions } from "./convention-registry.js";
 import { listTaskRoutingHints, explainTaskRouting } from "./task-routing-hint-registry.js";
 import { buildUncertaintySummary } from "./uncertainty.js";
+import { matchTerm, prepareTermQuery } from "./match-terms.js";
+import { classifyQueryIntent } from "./query-intent.js";
+import { QueryIntent } from "./query-intent-kind.js";
+import { referenceIdExists, warmReferenceRegistries } from "./reference-registry.js";
+import { ROUTING_RECOMMENDS_CHANNEL_KEYS, ROUTING_RECOMMENDS_CHANNELS, } from "./routing-recommends-channels.js";
 export const AGENT_TASK_PREP_SCHEMA = 'sharkcraft.agent-task-prep/v1';
+/** The channels a hint actually declares, copied — never the hint object itself. */
+function recommendsSummary(recommends) {
+    const out = {};
+    for (const channel of ROUTING_RECOMMENDS_CHANNEL_KEYS) {
+        const ids = recommends?.[channel];
+        if (Array.isArray(ids) && ids.length > 0)
+            out[channel] = [...ids];
+    }
+    return out;
+}
 export async function prepareAgentTask(inspection, task) {
     const packet = buildTaskPacket(inspection, task);
     const uncertaintyReport = buildUncertaintySummary(packet);
     const conventions = await listConventions(inspection);
     const routing = await explainTaskRouting(inspection, task);
     await listTaskRoutingHints(inspection); // warm cache
+    // THE id resolver answers "does this recommended id exist?" — the same one
+    // the self-config doctor probes these channels with.
+    await warmReferenceRegistries(inspection);
+    const recommendedAssets = [];
+    const seenAssets = new Set();
+    for (const match of routing) {
+        for (const channel of ROUTING_RECOMMENDS_CHANNEL_KEYS) {
+            const spec = ROUTING_RECOMMENDS_CHANNELS[channel];
+            if (spec.kind === 'command')
+                continue;
+            for (const id of match.hint.recommends?.[channel] ?? []) {
+                if (typeof id !== 'string' || !referenceIdExists(inspection, spec.kind, id))
+                    continue;
+                const key = `${spec.kind}:${id}`;
+                if (seenAssets.has(key))
+                    continue;
+                seenAssets.add(key);
+                recommendedAssets.push({ kind: spec.kind, id, hintId: match.hint.id });
+            }
+        }
+    }
     const inspectionCommands = [
         `shrk context --task "${task}" --commands-first`,
         `shrk task "${task}"`,
@@ -40,12 +76,17 @@ export async function prepareAgentTask(inspection, task) {
         'shrk self-config doctor',
     ];
     const primaryCommands = routing.flatMap((m) => m.hint.recommends.commands ?? []).slice(0, 5);
+    // THE query-intent classifier and THE term matcher — this used to be a
+    // fifth ad-hoc verb-regex set ("add" anywhere meant generate-code, so
+    // "fix the bug the last add introduced" was create work).
+    const queryIntent = classifyQueryIntent(task);
+    const termQuery = prepareTermQuery(task);
     const intentHints = [];
-    if (/\brename\b/i.test(task))
+    if (queryIntent.intent === QueryIntent.Refactor || matchTerm(termQuery, 'rename'))
         intentHints.push('refactor');
-    if (/\bremove\b/i.test(task))
+    if (matchTerm(termQuery, 'remove') || matchTerm(termQuery, 'delete'))
         intentHints.push('removal');
-    if (/\badd\b|\bcreate\b/i.test(task))
+    if (queryIntent.createVerb !== undefined)
         intentHints.push('generate-code');
     return {
         schema: AGENT_TASK_PREP_SCHEMA,
@@ -60,7 +101,13 @@ export async function prepareAgentTask(inspection, task) {
         validationCommands,
         relevantProfiles: [],
         relevantConventions: conventions.slice(0, 5).map((e) => ({ id: e.convention.id, title: e.convention.title })),
-        routingHints: routing.slice(0, 5).map((m) => ({ id: m.hint.id, title: m.hint.title, reasons: m.reasons })),
+        routingHints: routing.slice(0, 5).map((m) => ({
+            id: m.hint.id,
+            title: m.hint.title,
+            reasons: m.reasons,
+            recommends: recommendsSummary(m.hint.recommends),
+        })),
+        recommendedAssets,
         safetyNotes: [
             'SharkCraft engine never auto-applies plans. The human runs `shrk apply --verify-signature`.',
             'MCP tools are read-only; every write happens via the CLI.',

package/dist/ai-readiness.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-readiness.d.ts","sourceRoot":"","sources":["../src/ai-readiness.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAYvE;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,UAAU,GAAG,eAAe,CAAC;AAEvE,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,8FAA8F;IAC9F,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,OAAO,EAAE,kBAAkB,CAAC;IAC5B,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AAEvE;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,4DAA4D;IAC5D,mBAAmB,EAAE,OAAO,CAAC;IAC7B,qEAAqE;IACrE,kBAAkB,EAAE,OAAO,CAAC;IAC5B,sDAAsD;IACtD,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,cAAc,CAAC;IACtB,UAAU,EAAE,mBAAmB,EAAE,CAAC;IAClC,8EAA8E;IAC9E,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,mEAAmE;IACnE,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,wEAAwE;IACxE,cAAc,EAAE,eAAe,CAAC;CACjC;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,SAAS,EAAE,OAAO,CAAC;IACnB,oEAAoE;IACpE,SAAS,EAAE,OAAO,CAAC;IACnB,8EAA8E;IAC9E,UAAU,EAAE,OAAO,CAAC;IACpB,wHAAwH;IACxH,aAAa,EAAE,OAAO,CAAC;CACxB;AAyED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,qBAAqB,GAAG,gBAAgB,CAwV1F"}
+{"version":3,"file":"ai-readiness.d.ts","sourceRoot":"","sources":["../src/ai-readiness.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAYvE;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,UAAU,GAAG,eAAe,CAAC;AAEvE,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,8FAA8F;IAC9F,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,OAAO,EAAE,kBAAkB,CAAC;IAC5B,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AAEvE;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,4DAA4D;IAC5D,mBAAmB,EAAE,OAAO,CAAC;IAC7B,qEAAqE;IACrE,kBAAkB,EAAE,OAAO,CAAC;IAC5B,sDAAsD;IACtD,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,cAAc,CAAC;IACtB,UAAU,EAAE,mBAAmB,EAAE,CAAC;IAClC,8EAA8E;IAC9E,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,mEAAmE;IACnE,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,wEAAwE;IACxE,cAAc,EAAE,eAAe,CAAC;CACjC;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,SAAS,EAAE,OAAO,CAAC;IACnB,oEAAoE;IACpE,SAAS,EAAE,OAAO,CAAC;IACnB,8EAA8E;IAC9E,UAAU,EAAE,OAAO,CAAC;IACpB,wHAAwH;IACxH,aAAa,EAAE,OAAO,CAAC;CACxB;AAkFD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,qBAAqB,GAAG,gBAAgB,CAkW1F"}

package/dist/ai-readiness.js

@@ -85,6 +85,14 @@ function classifyShape(profiles) {
     }
     return { label, isLibrary, isService, isMonorepo, isApplication };
 }
+/**
+ * Readiness wording for a config file that EXISTS but failed to load — one
+ * string for the dimension note and the blocker. The inspection leaves
+ * `configFile` null for both "missing" and "invalid"; `configLoadError` is what
+ * tells them apart, and "create the file" is the wrong fix for a file that is
+ * there.
+ */
+const CONFIG_INVALID_NOTE = 'sharkcraft.config.ts invalid — not loaded (see config-invalid)';
 /**
  * Deterministic AI-readiness report.
  *
@@ -136,6 +144,9 @@ export function buildAiReadinessReport(inspection) {
         ? 'core'
         : 'advisory';
     // 1) Config present — always core (this is the "did you opt in?" signal).
+    // An INVALID config (the file exists but failed the schema / import) leaves
+    // `configFile` null too, so `configLoadError` is checked first: telling the
+    // user to "create" a file that exists sends them to the wrong fix.
     dims.push({
         id: 'config',
         title: 'sharkcraft.config.ts present',
@@ -143,10 +154,15 @@ export function buildAiReadinessReport(inspection) {
         score: inspection.configFile ? 10 : 0,
         note: inspection.configFile
             ? `loaded from ${inspection.configFile}`
-            : 'missing — using defaults',
+            : inspection.configLoadError
+                ? CONFIG_INVALID_NOTE
+                : 'missing — using defaults',
         applies: 'core',
     });
-    if (!inspection.configFile) {
+    if (inspection.configLoadError) {
+        recs.push(`Fix ${inspection.configLoadError.file ?? 'sharkcraft.config.ts'} — it exists but failed to load (run \`shrk doctor\`, check \`config-invalid\`).`);
+    }
+    else if (!inspection.configFile) {
         recs.push('Create sharkcraft/sharkcraft.config.ts to opt in to project-specific config.');
     }
     // 2) Knowledge entries — softcap at 15 (focused) and full at 22.
@@ -402,7 +418,9 @@ export function buildAiReadinessReport(inspection) {
     const blockers = [];
     if (!doctor.passed)
         blockers.push('doctor reports errors');
-    if (!inspection.configFile)
+    if (inspection.configLoadError)
+        blockers.push(CONFIG_INVALID_NOTE);
+    else if (!inspection.configFile)
         blockers.push('sharkcraft.config.ts missing');
     if (!hasDryRunDefault)
         blockers.push('no cli-only write policy rule');

package/dist/architecture-map.d.ts

@@ -39,6 +39,8 @@ export interface IArchitectureMap {
         warning: number;
         info: number;
     };
+    /** Why the boundary counts are not a full answer (THE boundary verdict's shortfalls), when they are not. */
+    boundaryShortfalls?: readonly string[];
     constructsByKind: readonly {
         kind: string;
         count: number;
@@ -67,6 +69,20 @@ export interface IArchitectureViolationsReport {
         count: number;
     }[];
     violations: readonly IArchitectureBoundaryViolation[];
+    /**
+     * 0 clean · 1 a violation (any severity) or a failing rule · 2 zero rules, or
+     * part of a rule's scope never examined — THE boundary verdict
+     * (`runBoundaryCheck`), with its shortfalls.
+     */
+    exitCode: number;
+    verdict: 'pass' | 'fail' | 'not-verified' | 'usage-error';
+    shortfalls: readonly string[];
+    /**
+     * THE boundary verdict's settled acceptances (`<rule>: accepted by
+     * expectEmpty: …`) — present only at exit 0 (round 13 review: a planned
+     * `from` glob settled this report 2 → 0 and the acceptance was never printed).
+     */
+    accepted?: readonly string[];
 }
 export declare function buildArchitectureViolations(inspection: ISharkcraftInspection): Promise<IArchitectureViolationsReport>;
 export type ArchitectureViolationDiffClassification = 'existing-touched' | 'new-in-changed-file' | 'resolved' | 'unknown';

package/dist/architecture-map.d.ts.map

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

package/dist/architecture-map.js

@@ -9,7 +9,7 @@
  * Read-only.
  */
 import { existsSync, readFileSync } from 'node:fs';
-import { evaluateBoundaries, loadTsconfigPaths, scanImports } from '@shrkcrft/boundaries';
+import { runBoundaryCheck } from "./run-boundary-check.js";
 import { analyzeImportGraph } from "./import-graph-analysis.js";
 import { buildRepositoryIntelligenceGraph, RepoNodeKind, } from "./repository-intelligence.js";
 import { getChangedFiles } from "./git-helpers.js";
@@ -85,13 +85,14 @@ export async function buildArchitectureMap(inspection, options = {}) {
     // Boundary violations (real signal when --signals is enabled).
     let boundaryViolations = [];
     let boundaryViolationCounts = { error: 0, warning: 0, info: 0 };
+    let boundaryShortfalls = [];
     if (signalsEnabled && include.has('boundaries') && inspection.boundaryRegistry.size() > 0) {
         try {
-            const scan = scanImports({ projectRoot: inspection.projectRoot });
-            const tsconfigPaths = loadTsconfigPaths(inspection.projectRoot);
-            const evalResult = evaluateBoundaries(scan, inspection.boundaryRegistry.list(), {
-                ...(tsconfigPaths.aliases.size > 0 ? { tsconfigPaths } : {}),
-            });
+            // THE boundary orchestrator — the counts `check boundaries` reports
+            // (round 11 review R11-GAP-3), including what it could not examine.
+            const evalResult = runBoundaryCheck(inspection);
+            if (evalResult.verdict === 'not-verified')
+                boundaryShortfalls = evalResult.shortfalls;
             boundaryViolations = evalResult.violations.slice(0, 50).map((v) => ({
                 ruleId: v.ruleId,
                 file: v.file,
@@ -136,7 +137,7 @@ export async function buildArchitectureMap(inspection, options = {}) {
         'shrk drift --json',
         'shrk coverage --json',
         'shrk impact --since main',
-        'shrk intelligence graph --json',
+        'shrk graph hubs --json',
     ];
     const risks = [];
     if (options.risk !== false) {
@@ -168,6 +169,13 @@ export async function buildArchitectureMap(inspection, options = {}) {
                 description: `${boundaryViolationCounts.warning} boundary violation(s) at warning severity.`,
             });
         }
+        if (boundaryShortfalls.length > 0) {
+            risks.push({
+                id: 'boundary-scan-not-verified',
+                severity: 'warning',
+                description: `Boundary scan NOT VERIFIED — the counts above miss what it could not examine: ${boundaryShortfalls.slice(0, 3).join('; ')}`,
+            });
+        }
         if (graph.truncation.filesCapped) {
             risks.push({
                 id: 'file-list-truncated',
@@ -185,6 +193,7 @@ export async function buildArchitectureMap(inspection, options = {}) {
         boundaryRules,
         boundaryViolations,
         boundaryViolationCounts,
+        ...(boundaryShortfalls.length > 0 ? { boundaryShortfalls } : {}),
         constructsByKind,
         packs,
         testsCoverageHint,
@@ -198,39 +207,46 @@ export async function buildArchitectureMap(inspection, options = {}) {
     };
 }
 export async function buildArchitectureViolations(inspection) {
+    // THE boundary orchestrator — the call `check boundaries` makes (round 11
+    // review R11-GAP-3). A private scan + evaluate read `total 0` (exit 0) over
+    // an unreadable governed file the gate settled 2, and over zero rules.
     const violations = [];
-    if (inspection.boundaryRegistry.size() > 0) {
-        try {
-            const scan = scanImports({ projectRoot: inspection.projectRoot });
-            const tsconfigPaths = loadTsconfigPaths(inspection.projectRoot);
-            const evalResult = evaluateBoundaries(scan, inspection.boundaryRegistry.list(), {
-                ...(tsconfigPaths.aliases.size > 0 ? { tsconfigPaths } : {}),
+    let proposed;
+    try {
+        const r = runBoundaryCheck(inspection);
+        for (const v of r.violations) {
+            violations.push({
+                ruleId: v.ruleId,
+                file: v.file,
+                importSpecifier: v.importSpecifier,
+                severity: v.severity,
+                line: v.line,
+                message: v.message,
             });
-            for (const v of evalResult.violations) {
-                violations.push({
-                    ruleId: v.ruleId,
-                    file: v.file,
-                    importSpecifier: v.importSpecifier,
-                    severity: v.severity,
-                    line: v.line,
-                    message: v.message,
-                });
-            }
-        }
-        catch {
-            /* best-effort */
         }
+        proposed = { exitCode: r.exitCode, verdict: r.verdict, shortfalls: r.shortfalls, accepted: r.accepted };
+    }
+    catch (e) {
+        // A scan that could not run proved nothing — never a clean 0.
+        proposed = { exitCode: 2, verdict: 'not-verified', shortfalls: [`the boundary check could not run: ${e.message}`] };
     }
     const byRuleMap = new Map();
     for (const v of violations)
         byRuleMap.set(v.ruleId, (byRuleMap.get(v.ruleId) ?? 0) + 1);
     const byRule = [...byRuleMap.entries()].map(([ruleId, count]) => ({ ruleId, count })).sort((a, b) => b.count - a.count);
+    // Any violation (warnings included) fails this report, as it always has.
+    const failed = violations.length > 0;
     return {
         schema: 'sharkcraft.architecture-violations/v1',
         generatedAt: new Date().toISOString(),
         total: violations.length,
         byRule,
         violations: violations.slice(0, 100),
+        exitCode: failed ? 1 : proposed.exitCode,
+        verdict: failed ? 'fail' : proposed.verdict,
+        shortfalls: proposed.shortfalls,
+        // An acceptance is printed at exit 0 only — never next to a violation.
+        accepted: failed ? [] : (proposed.accepted ?? []),
     };
 }
 function normalizeViolationKey(v) {

package/dist/area-explore.d.ts

@@ -2,8 +2,8 @@
  * Workspace-aware "explore this directory".
  *
  * Answers "explain this *specific* directory" with one deterministic
- * call. Built on top of `buildAreaMap` (whole-repo) and the registries
- * already in `ISharkcraftInspection`.
+ * call. Classifies through THE file → area classifier (`createAreaClassifier`)
+ * and reads the registries already in `ISharkcraftInspection`.
  *
  * Output:
  *   - inferred area kind + role,

package/dist/area-explore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"area-explore.d.ts","sourceRoot":"","sources":["../src/area-explore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAE,QAAQ,EAAgB,MAAM,eAAe,CAAC;AAEvD,eAAO,MAAM,mBAAmB,+BAA+B,CAAC;AAEhE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAC;CAC7E;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EACT,iBAAiB,GACjB,aAAa,GACb,cAAc,GACd,cAAc,GACd,gBAAgB,GAChB,mBAAmB,GACnB,UAAU,CAAC;IACf,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,OAAO,mBAAmB,CAAC;IAC5C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,qBAAqB,CAAC,CAAC;IACxD,QAAQ,CAAC,eAAe,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAChD,QAAQ,CAAC,eAAe,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAChD,QAAQ,CAAC,gBAAgB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACjD,QAAQ,CAAC,gBAAgB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACjD,QAAQ,CAAC,eAAe,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAChD,QAAQ,CAAC,iBAAiB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAClD,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,qBAAqB,CAAC,CAAC;IACrD,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC9C;AA6LD,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,qBAAqB,CAAC;IAClC,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,gFAAgF;IAChF,cAAc,CAAC,EAAE,aAAa,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpD,mDAAmD;IACnD,YAAY,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACrC,8CAA8C;IAC9C,eAAe,CAAC,EAAE,aAAa,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjF,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,iBAAiB,GAAG,kBAAkB,CAiJxE;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAoDxE;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAuC5E"}
+{"version":3,"file":"area-explore.d.ts","sourceRoot":"","sources":["../src/area-explore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAE,QAAQ,EAAwB,MAAM,eAAe,CAAC;AAE/D,eAAO,MAAM,mBAAmB,+BAA+B,CAAC;AAEhE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAC;CAC7E;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EACT,iBAAiB,GACjB,aAAa,GACb,cAAc,GACd,cAAc,GACd,gBAAgB,GAChB,mBAAmB,GACnB,UAAU,CAAC;IACf,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,OAAO,mBAAmB,CAAC;IAC5C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,qBAAqB,CAAC,CAAC;IACxD,QAAQ,CAAC,eAAe,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAChD,QAAQ,CAAC,eAAe,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAChD,QAAQ,CAAC,gBAAgB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACjD,QAAQ,CAAC,gBAAgB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACjD,QAAQ,CAAC,eAAe,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAChD,QAAQ,CAAC,iBAAiB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAClD,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,qBAAqB,CAAC,CAAC;IACrD,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC9C;AAuND,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,qBAAqB,CAAC;IAClC,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,gFAAgF;IAChF,cAAc,CAAC,EAAE,aAAa,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpD,mDAAmD;IACnD,YAAY,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACrC,8CAA8C;IAC9C,eAAe,CAAC,EAAE,aAAa,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjF,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,iBAAiB,GAAG,kBAAkB,CAqJxE;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAoDxE;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAuC5E"}

package/dist/area-explore.js

@@ -2,8 +2,8 @@
  * Workspace-aware "explore this directory".
  *
  * Answers "explain this *specific* directory" with one deterministic
- * call. Built on top of `buildAreaMap` (whole-repo) and the registries
- * already in `ISharkcraftInspection`.
+ * call. Classifies through THE file → area classifier (`createAreaClassifier`)
+ * and reads the registries already in `ISharkcraftInspection`.
  *
  * Output:
  *   - inferred area kind + role,
@@ -19,7 +19,7 @@
  */
 import { existsSync, readdirSync, statSync } from 'node:fs';
 import * as nodePath from 'node:path';
-import { AreaKind, buildAreaMap } from "./area-map.js";
+import { AreaKind, createAreaClassifier } from "./area-map.js";
 export const AREA_EXPLORE_SCHEMA = 'sharkcraft.area-explore/v1';
 const IGNORE_DIRS = new Set([
     'node_modules',
@@ -83,17 +83,38 @@ function walkLimited(root, base, maxFiles = 4000) {
     }
     return out;
 }
-function inferKindForPath(relPath, areaMap) {
-    for (const a of areaMap.areas) {
-        if (a.paths.some((p) => relPath === p || relPath.startsWith(p + '/')))
-            return a.kind;
-    }
-    // fallback heuristics: match against AreaPatterns through area-map
-    if (/^packages\//.test(relPath) || /^apps\//.test(relPath)) {
-        if (/\/__tests__\//.test(relPath))
-            return AreaKind.Tests;
+/**
+ * The area kind of an explored path, through THE file → area classifier
+ * (`createAreaClassifier`, the one the area map, impact and the changes
+ * summary use). This used to prefix-match the area map's `paths`, which hold
+ * only a top segment, so a config pattern for part of `libs/` gave EVERY
+ * `libs/…` path that area's kind.
+ *
+ *   - A FILE is classified directly.
+ *   - A DIRECTORY has no area of its own. Its kind is the most common kind
+ *     among the files under it (the explore walk's files), ties broken by kind
+ *     name so the answer is total. It is `unknown` only when none of them
+ *     classifies.
+ */
+function inferKindForPath(relPath, isDir, filesUnder, classify) {
+    if (!isDir)
+        return classify(relPath).kind;
+    const counts = new Map();
+    for (const f of filesUnder) {
+        const kind = classify(f).kind;
+        if (kind === AreaKind.Unknown)
+            continue;
+        counts.set(kind, (counts.get(kind) ?? 0) + 1);
+    }
+    let best = AreaKind.Unknown;
+    let bestCount = 0;
+    for (const [kind, n] of [...counts].sort(([a], [b]) => a.localeCompare(b))) {
+        if (n > bestCount) {
+            best = kind;
+            bestCount = n;
+        }
     }
-    return AreaKind.Unknown;
+    return best;
 }
 function describeRole(relPath, kind) {
     const segs = relPath.split('/');
@@ -220,7 +241,7 @@ export function exploreArea(input) {
             boundaryRuleIds: [],
             pathConventionIds: [],
             risks: [],
-            nextCommands: [`shrk map  # repo-wide map`],
+            nextCommands: [`shrk explore .  # repo-wide map`],
         };
     }
     const stat = statSync(absPath);
@@ -249,8 +270,7 @@ export function exploreArea(input) {
     // Secondary key makes the order TOTAL: same-size files near the cutoff would
     // otherwise be ranked by filesystem order (non-deterministic).
     files.sort((a, b) => b.sizeBytes - a.sizeBytes || a.relPath.localeCompare(b.relPath));
-    const areaMap = buildAreaMap(input.inspection);
-    const inferredKind = inferKindForPath(relPath, areaMap);
+    const inferredKind = inferKindForPath(relPath, isDir, files.map((f) => f.relPath), createAreaClassifier(input.inspection.config?.areaMap));
     const role = describeRole(relPath, inferredKind);
     const topFiles = input.topFiles ?? 10;
     const keyFiles = files