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

package/dist/commands/paths.command.js

@@ -1,6 +1,6 @@
 import { inspectSharkcraft } from '@shrkcrft/inspector';
 import { formatEntryCompact, formatEntryFull } from '@shrkcrft/knowledge';
-import { flagBool, flagNumber, flagString, flagList, resolveCwd, } from "../command-registry.js";
+import { flagBool, flagNumber, flagString, flagList, requireInputSelector, resolveCwd, } from "../command-registry.js";
 import { asJson, header } from "../output/format-output.js";
 export const pathsListCommand = {
     name: 'list',
@@ -51,6 +51,14 @@ export const pathsSearchCommand = {
     description: 'Search path conventions.',
     usage: 'shrk paths search <query> [--scope x,y] [--limit 10]',
     async run(args) {
+        // No query and no scope is a usage error (3), never `Results (0)` at exit 0.
+        const noSelector = requireInputSelector(args, {
+            flags: ['scope'],
+            positional: true,
+            usage: 'shrk paths search <query> [--scope x,y] [--limit 10]',
+        });
+        if (noSelector !== null)
+            return noSelector;
         const query = args.positional.join(' ').trim();
         const scope = flagList(args, 'scope');
         const limit = flagNumber(args, 'limit') ?? 10;

package/dist/commands/pipelines.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipelines.command.d.ts","sourceRoot":"","sources":["../../src/commands/pipelines.command.ts"],"names":[],"mappings":"AAeA,OAAO,EAOL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAGhC,eAAO,MAAM,oBAAoB,EAAE,eA2BlC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,eAuBjC,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,eAuDrC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,eA+DlC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,eAoCpC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,eA6ClC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,eAiElC,CAAC"}
+{"version":3,"file":"pipelines.command.d.ts","sourceRoot":"","sources":["../../src/commands/pipelines.command.ts"],"names":[],"mappings":"AAgBA,OAAO,EAOL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAIhC,eAAO,MAAM,oBAAoB,EAAE,eAgClC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,eAuBjC,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,eAuDrC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,eA+DlC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,eAoCpC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,eA6ClC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,eAiElC,CAAC"}

package/dist/commands/pipelines.command.js

@@ -1,8 +1,9 @@
-import { inspectSharkcraft, buildProjectOverview, renderOverviewText, contextTuningBoostFor, } from '@shrkcrft/inspector';
+import { ContributionKind, inspectSharkcraft, buildProjectOverview, renderOverviewText, contextTuningBoostFor, } from '@shrkcrft/inspector';
 import { buildContext } from '@shrkcrft/context';
 import { findNextStep, formatPipelineCompact, formatPipelineFull, interpolatePipeline, renderPipelineScript, } from '@shrkcrft/pipelines';
 import { flagBool, flagNumber, flagString, flagList, flagVars, resolveCwd, } from "../command-registry.js";
 import { asJson, header, kv } from "../output/format-output.js";
+import { writeRejectedEntriesNote } from "../output/rejected-entries-note.js";
 export const pipelinesListCommand = {
     name: 'list',
     description: 'List available pipelines.',
@@ -10,6 +11,9 @@ export const pipelinesListCommand = {
     async run(args) {
         const inspection = await inspectSharkcraft({ cwd: resolveCwd(args) });
         const list = inspection.pipelineRegistry.list();
+        // A pipeline its loader refused (no `description`, a duplicate id) is named
+        // (round 12, 12.1) — it used to vanish from every surface.
+        const note = { next: 'shrk packs contributions' };
         if (flagBool(args, 'json')) {
             process.stdout.write(asJson(list.map((p) => ({
                 id: p.id,
@@ -20,11 +24,13 @@ export const pipelinesListCommand = {
                 appliesWhen: p.appliesWhen ?? [],
                 stepCount: p.steps.length,
             }))) + '\n');
+            await writeRejectedEntriesNote(inspection, [ContributionKind.Pipeline], { ...note, json: true });
             return 0;
         }
         process.stdout.write(header(`Pipelines (${list.length})`));
         for (const p of list)
             process.stdout.write(formatPipelineCompact(p) + '\n');
+        await writeRejectedEntriesNote(inspection, [ContributionKind.Pipeline], note);
         return 0;
     },
 };

package/dist/commands/plan-check.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plan-check.command.d.ts","sourceRoot":"","sources":["../../src/commands/plan-check.command.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAML,KAAK,oBAAoB,EAC1B,MAAM,qBAAqB,CAAC;AAO7B,OAAO,EAIL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAGhC,eAAO,MAAM,iBAAiB,6BAA6B,CAAC;AAE5D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,OAAO,iBAAiB,CAAC;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACjD,QAAQ,CAAC,QAAQ,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACnD,QAAQ,CAAC,EAAE,CAAC,EAAE;QACZ,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;QAC1B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QAC9C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAED,eAAO,MAAM,gBAAgB,EAAE,eAyE9B,CAAC"}
+{"version":3,"file":"plan-check.command.d.ts","sourceRoot":"","sources":["../../src/commands/plan-check.command.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAML,KAAK,oBAAoB,EAC1B,MAAM,qBAAqB,CAAC;AAO7B,OAAO,EAIL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAIhC,eAAO,MAAM,iBAAiB,6BAA6B,CAAC;AAE5D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,OAAO,iBAAiB,CAAC;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACjD,QAAQ,CAAC,QAAQ,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACnD,QAAQ,CAAC,EAAE,CAAC,EAAE;QACZ,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;QAC1B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QAC9C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAED,eAAO,MAAM,gBAAgB,EAAE,eA2E9B,CAAC"}

package/dist/commands/plan-check.command.js

@@ -12,10 +12,13 @@ import * as nodePath from 'node:path';
 import { getExtractorById, pickExtractor, } from '@shrkcrft/generator';
 import { inspectSharkcraft, loadNxProjects, mapFilesToProjects, validateExtractedPlan, } from '@shrkcrft/inspector';
 import { flagBool, flagString, resolveCwd, } from "../command-registry.js";
+import { PositionalMode } from "../dispatch/positional-mode.js";
 import { asJson, header } from "../output/format-output.js";
 export const PLAN_CHECK_SCHEMA = 'sharkcraft.plan-check/v1';
 export const planCheckCommand = {
     name: 'check',
+    // positional[0] is the plan / spec FILE; a verb-shaped non-file is refused.
+    positionals: PositionalMode.Path,
     description: 'Validate an external plan/spec file against the live workspace. Read-only — the input file is never modified. Supports two built-in extractors and an optional --field-map.',
     usage: 'shrk plan check <path> [--extractor sharkcraft.spec/v1|markdown-frontmatter-loose] [--field-map <json>] [--json] [--strict]',
     async run(args) {

package/dist/commands/plan.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plan.command.d.ts","sourceRoot":"","sources":["../../src/commands/plan.command.ts"],"names":[],"mappings":"AAQA,OAAO,EAGL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAIhC,eAAO,MAAM,iBAAiB,EAAE,eAkH/B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,eAqB/B,CAAC"}
+{"version":3,"file":"plan.command.d.ts","sourceRoot":"","sources":["../../src/commands/plan.command.ts"],"names":[],"mappings":"AAQA,OAAO,EAGL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAKhC,eAAO,MAAM,iBAAiB,EAAE,eAkH/B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,eAuB/B,CAAC"}

package/dist/commands/plan.command.js

@@ -2,6 +2,7 @@ import * as nodePath from 'node:path';
 import { buildApplyDispatchTrace, inspectSharkcraft, renderApplyDispatchTraceText, reviewSavedPlan, } from '@shrkcrft/inspector';
 import { readPlanFromFile } from '@shrkcrft/generator';
 import { flagBool, resolveCwd, } from "../command-registry.js";
+import { PositionalMode } from "../dispatch/positional-mode.js";
 import { asJson, header, kv } from "../output/format-output.js";
 import { planSimulateCommand } from "./plan-simulate.command.js";
 export const planReviewCommand = {
@@ -117,6 +118,8 @@ export const planReviewCommand = {
  */
 export const planParentCommand = {
     name: 'plan',
+    // Mixed-mode: review / simulate / check are trie children.
+    positionals: PositionalMode.None,
     description: 'Inspect generation plans. Subcommand required.',
     usage: 'shrk plan review|simulate <plan.json>',
     async run(args) {

package/dist/commands/playbooks.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"playbooks.command.d.ts","sourceRoot":"","sources":["../../src/commands/playbooks.command.ts"],"names":[],"mappings":"AAaA,OAAO,EAKL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAahC,eAAO,MAAM,oBAAoB,EAAE,eAiBlC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,eA4BjC,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,eA4BvC,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,eA6CrC,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,eA6BnC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,eAoCpC,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,eA6CrC,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,eAiCtC,CAAC"}
+{"version":3,"file":"playbooks.command.d.ts","sourceRoot":"","sources":["../../src/commands/playbooks.command.ts"],"names":[],"mappings":"AAcA,OAAO,EAKL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAchC,eAAO,MAAM,oBAAoB,EAAE,eAqBlC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,eA4BjC,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,eA4BvC,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,eA6CrC,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,eA6BnC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,eAoCpC,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,eA6CrC,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,eAiCtC,CAAC"}

package/dist/commands/playbooks.command.js

@@ -1,8 +1,9 @@
 import { mkdirSync, writeFileSync } from 'node:fs';
 import * as nodePath from 'node:path';
-import { buildAgentBrief, buildPlaybookPreview, buildPlaybookScript, buildRunbook, inspectSharkcraft, loadPlaybooks, recommendPlaybooks, validatePlaybook, } from '@shrkcrft/inspector';
+import { buildAgentBrief, buildPlaybookPreview, buildPlaybookScript, buildRunbook, ContributionKind, inspectSharkcraft, loadPlaybooks, recommendPlaybooks, validatePlaybook, } from '@shrkcrft/inspector';
 import { flagBool, flagNumber, flagString, resolveCwd, } from "../command-registry.js";
 import { asJson, header } from "../output/format-output.js";
+import { writeRejectedEntriesNote } from "../output/rejected-entries-note.js";
 async function loadAll(args) {
     const cwd = resolveCwd(args);
     const inspection = await inspectSharkcraft({ cwd });
@@ -14,9 +15,12 @@ export const playbooksListCommand = {
     description: 'List registered playbooks.',
     usage: 'shrk playbooks list [--json]',
     async run(args) {
-        const { playbooks } = await loadAll(args);
+        const { playbooks, inspection } = await loadAll(args);
+        // A playbook its loader refused (no id, no `steps`) is named (round 12, 12.1).
+        const note = { next: 'shrk packs contributions' };
         if (flagBool(args, 'json')) {
             process.stdout.write(asJson(playbooks) + '\n');
+            await writeRejectedEntriesNote(inspection, [ContributionKind.Playbook], { ...note, json: true });
             return 0;
         }
         process.stdout.write(header(`Playbooks (${playbooks.length})`));
@@ -25,6 +29,7 @@ export const playbooksListCommand = {
         for (const p of playbooks) {
             process.stdout.write(`  ${p.id.padEnd(36)} ${p.title}\n`);
         }
+        await writeRejectedEntriesNote(inspection, [ContributionKind.Playbook], note);
         return 0;
     },
 };

package/dist/commands/policy-lint.command.d.ts

@@ -1,6 +1,17 @@
-import type { IPolicyRule, PolicySurface } from '@shrkcrft/core';
-import { type IPolicyFinding, type IPolicySuppression } from '@shrkcrft/boundaries';
+import { type IPolicyRule, type IVerdictCoverage, type PolicySurface } from '@shrkcrft/core';
+import { type IPolicyFinding, type IPolicyReport, type IPolicySuppression } from '@shrkcrft/boundaries';
 import { type ICommandHandler } from '../command-registry.js';
+/**
+ * What one policy rule examined — the ENGINE's record
+ * (`IPolicyRuleResult.coverage`, @shrkcrft/boundaries), read here and never
+ * recomputed, so `policy-lint`, the aggregate (`gates check`, `quality`), `shrk
+ * gate` and `finish` all report one scope for one rule. A policy rule examines
+ * every content unit its globs matched; one that scanned nothing (or could not
+ * run) examined nothing.
+ */
+export declare function policyRuleCoverage(r: {
+    readonly coverage: IVerdictCoverage;
+}): IVerdictCoverage;
 export declare const POLICY_EXPLAIN_SCHEMA: "sharkcraft.policy-explain/v1";
 /** What ONE policy rule resolved to against the live tree. */
 export interface IPolicyExplain {
@@ -23,6 +34,12 @@ export interface IPolicyExplain {
     readonly diagnostics: readonly string[];
     /** Why the rule scanned nothing, when it did. */
     readonly skipReason?: string;
+    /**
+     * The rule's non-live `files` units as the engine settled them (round 13
+     * review) — the explain view prints a dead unit and a went-live marker
+     * through THE shared unit-state renderer, as `policy-lint` does.
+     */
+    readonly unitLiveness?: IPolicyReport['rules'][number]['unitLiveness'];
 }
 /**
  * Dry-run ONE policy rule and return everything it saw — including the hits an

package/dist/commands/policy-lint.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"policy-lint.command.d.ts","sourceRoot":"","sources":["../../src/commands/policy-lint.command.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAEL,KAAK,cAAc,EAEnB,KAAK,kBAAkB,EACxB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAIL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAQhC,eAAO,MAAM,qBAAqB,EAAG,8BAAuC,CAAC;AAE7E,8DAA8D;AAC9D,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,OAAO,qBAAqB,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,8CAA8C;IAC9C,QAAQ,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAC;IAC7C,8EAA8E;IAC9E,QAAQ,CAAC,UAAU,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACnD,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,iDAAiD;IACjD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,WAAW,EACjB,WAAW,EAAE,SAAS,MAAM,EAAE,GAC7B,cAAc,CAqBhB;AAED,qFAAqF;AACrF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,CA0CtF;AAGD,eAAO,MAAM,wBAAwB,EAAE,eA8BtC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,eAoQ/B,CAAC"}
+{"version":3,"file":"policy-lint.command.d.ts","sourceRoot":"","sources":["../../src/commands/policy-lint.command.ts"],"names":[],"mappings":"AACA,OAAO,EAAyB,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpH,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACxB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAIL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAgBhC;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE;IAAE,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAA;CAAE,GAAG,gBAAgB,CAE/F;AAGD,eAAO,MAAM,qBAAqB,EAAG,8BAAuC,CAAC;AAE7E,8DAA8D;AAC9D,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,OAAO,qBAAqB,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,8CAA8C;IAC9C,QAAQ,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAC;IAC7C,8EAA8E;IAC9E,QAAQ,CAAC,UAAU,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACnD,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,iDAAiD;IACjD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,CAAC;CACxE;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,WAAW,EACjB,WAAW,EAAE,SAAS,MAAM,EAAE,GAC7B,cAAc,CAsBhB;AAED,qFAAqF;AACrF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,CA2DtF;AAGD,eAAO,MAAM,wBAAwB,EAAE,eA6BtC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,eA6Y/B,CAAC"}

package/dist/commands/policy-lint.command.js

@@ -1,11 +1,31 @@
-import * as nodePath from 'node:path';
-import { runPolicyLint, } from '@shrkcrft/boundaries';
+import { formatEmptyRuleAdvice } from '@shrkcrft/core';
+import { planeScanExcludeDirs, runPolicyLint, } from '@shrkcrft/boundaries';
 import { classifyChangedScope, resolveChangedFiles, resolveProjectConfig } from '@shrkcrft/inspector';
 import { flagBool, flagString, resolveCwd, } from "../command-registry.js";
+import { PositionalMode } from "../dispatch/positional-mode.js";
 import { ExitCode } from "../exit-codes.js";
 import { buildGateEnvelope } from "../gates/gate-envelope.js";
+import { ALLOW_EMPTY_FLAG, allowEmptyValve } from "../gates/allow-empty.js";
+import { verdictLine } from "../gates/verdict-line.js";
+import { acceptedEmptyNote } from "../gates/accepted-empty-note.js";
+import { emptyRuleAdviceLines } from "../gates/empty-rule-advice-lines.js";
+import { qualifyCleanForUnits } from "../gates/qualify-clean-for-units.js";
+import { unitStateNotes } from "../gates/unit-state-notes.js";
+import { planeVerdictForExit } from "../gates/plane-verdict.js";
+import { seamRejectedRules } from "../gates/seam-rejected-rules.js";
 import { asJson, header, kv } from "../output/format-output.js";
 const VALID_SURFACES = new Set(['template', 'style', 'ts']);
+/**
+ * What one policy rule examined — the ENGINE's record
+ * (`IPolicyRuleResult.coverage`, @shrkcrft/boundaries), read here and never
+ * recomputed, so `policy-lint`, the aggregate (`gates check`, `quality`), `shrk
+ * gate` and `finish` all report one scope for one rule. A policy rule examines
+ * every content unit its globs matched; one that scanned nothing (or could not
+ * run) examined nothing.
+ */
+export function policyRuleCoverage(r) {
+    return r.coverage;
+}
 export const POLICY_EXPLAIN_SCHEMA = 'sharkcraft.policy-explain/v1';
 /**
  * Dry-run ONE policy rule and return everything it saw — including the hits an
@@ -35,6 +55,7 @@ export function runPolicyExplain(cwd, rule, excludeDirs) {
         ...(rule.exemptLines ? { exemptLines: rule.exemptLines } : {}),
         diagnostics: report.diagnostics,
         ...(skip ? { skipReason: skip.reason } : {}),
+        ...(result?.unitLiveness !== undefined ? { unitLiveness: result.unitLiveness } : {}),
     };
 }
 /** Render an {@link IPolicyExplain}. Always returns 0 — explain is informational. */
@@ -73,8 +94,21 @@ export function renderPolicyExplain(explain, wantJson) {
     }
     if (explain.skipReason) {
         process.stdout.write(`\n! SKIPPED — ${explain.skipReason}. A rule that scans nothing is a bug in the rule,\n` +
-            '  not a pass. Fix the glob, or set `failOnEmpty: true` to make this a hard failure.\n');
+            `  not a pass. ${formatEmptyRuleAdvice({ fails: explain.status === 'failed' })}.\n`);
     }
+    // THE shared unit-state block (round 13 review): a dead `files` glob, a
+    // LOCAL marker whose target appeared and a pack marker (INFO) — as
+    // `policy-lint` prints them; explain said `status passed` over a went-live one.
+    process.stdout.write(unitStateNotes([
+        {
+            id: explain.ruleId,
+            ...(explain.unitLiveness !== undefined ? { unitLiveness: explain.unitLiveness } : {}),
+            reportedEmpty: explain.skipReason !== undefined,
+        },
+    ], 
+    // An explain view names every unit state — the intended-empty ones too
+    // (round 13, K6), as the registry / registration explain views do.
+    { intendedEmpty: true }).text);
     for (const d of explain.diagnostics)
         process.stdout.write(`  ! ${d}\n`);
     return 0;
@@ -102,16 +136,17 @@ export const policyLintExplainCommand = {
             process.stderr.write(`No policy rule "${id}". Configured: ${rules.map((r) => r.id).join(', ') || '(none)'}\n`);
             return ExitCode.UsageError;
         }
-        const rel = nodePath.relative(cwd, loaded.value.sharkcraftDir).split(nodePath.sep).join('/');
-        const excludeDirs = rel && !rel.startsWith('..') ? [rel] : [];
+        const excludeDirs = planeScanExcludeDirs(cwd, loaded.value.sharkcraftDir);
         return renderPolicyExplain(runPolicyExplain(cwd, rule, excludeDirs), flagBool(args, 'json'));
     },
 };
 export const policyLintCommand = {
     name: 'policy-lint',
+    // Flag-driven; `explain` is a trie child. A bare token used to be ignored.
+    positionals: PositionalMode.None,
     description: 'Lint template/markup, stylesheet, and AOT-invisible TS surfaces against data-defined policyRules[] (e.g. flag raw markup when a primitive exists). Sees `.html` files AND inline `template:` strings — surfaces tsc/AOT cannot. Deterministic; no AI.',
-    usage: 'shrk [--cwd <dir>] policy-lint [--surface template|style|ts] [--changed-only] [--new-only] [--since <ref>] [--only <ids>] [--json]\n         (--changed-only SCANS just the changed files; --new-only scans the whole tree but shows only findings the change introduced, hiding pre-existing baseline debt)',
-    booleanFlags: new Set(['json', 'changed-only', 'new-only']),
+    usage: 'shrk [--cwd <dir>] policy-lint [--surface template|style|ts] [--changed-only] [--new-only] [--since <ref>] [--only <ids>] [--allow-empty] [--json]\n         (--changed-only SCANS just the changed files; --new-only scans the whole tree but shows only findings the change introduced, hiding pre-existing baseline debt)',
+    booleanFlags: new Set(['json', 'changed-only', 'new-only', ALLOW_EMPTY_FLAG]),
     async run(args) {
         const cwd = resolveCwd(args);
         const wantJson = flagBool(args, 'json');
@@ -148,26 +183,54 @@ export const policyLintCommand = {
         }
         const rules = loaded.value.config.policyRules ?? [];
         const planeDiagnostics = loaded.value.planeDiagnostics;
-        if (rules.length === 0) {
+        // A pack policy rule the merge seam rejected is a configured rule that did
+        // NOT run — an errored row, exit 1 (round 12 review, R12-X1). It used to be
+        // an advisory diagnostic under "No policy violations ✓".
+        const rejectedAll = seamRejectedRules(loaded.value, ['policy']);
+        if (rules.length === 0 && rejectedAll.length === 0) {
+            // Nothing declared is NOT a pass — the request covered zero rules, so it
+            // proved nothing: `2`, unless the caller accepts the empty set explicitly.
+            const emptyEnv = buildGateEnvelope('policy-lint', ExitCode.VerifiedPass, [], {
+                unit: 'policy rules',
+                expected: 0,
+                examined: 0,
+                reason: 'no policyRules[] declared',
+                ...allowEmptyValve(args, 0),
+            });
             if (wantJson) {
-                process.stdout.write(asJson({ schema: 'sharkcraft.policy-lint/v1', rules: [], findings: [], diagnostics: [], evaluated: 0, verdict: 'pass' }) + '\n');
-                return 0;
+                process.stdout.write(asJson({
+                    schema: 'sharkcraft.policy-lint/v1',
+                    rules: [],
+                    findings: [],
+                    diagnostics: [],
+                    evaluated: 0,
+                    verdict: emptyEnv.exit === ExitCode.VerifiedPass ? 'pass' : 'not-verified',
+                    exitCode: emptyEnv.exit,
+                    gate: emptyEnv,
+                }) + '\n');
+                return emptyEnv.exit;
             }
             process.stdout.write(header('Policy lint'));
             process.stdout.write('  No policy rules configured. Declare `policyRules[]` in sharkcraft.config.ts to lint\n' +
                 '  templates / styles / AOT-invisible TS shapes (see docs/policy-lint.md).\n');
-            return 0;
+            process.stdout.write(`\n${verdictLine(emptyEnv, 'Nothing declared — accepted.')}\n`);
+            if (emptyEnv.exit !== ExitCode.VerifiedPass) {
+                process.stdout.write(`  Pass --${ALLOW_EMPTY_FLAG} to accept an empty rule set explicitly.\n`);
+            }
+            return emptyEnv.exit;
         }
-        // A typo'd --only id must not silently select nothing and report green.
-        if (only) {
-            const requested = only.split(',').map((s) => s.trim()).filter(Boolean);
-            const known = new Set(rules.map((r) => r.id));
-            const unknown = requested.filter((id) => !known.has(id));
+        // A typo'd --only id must not silently select nothing and report green. A
+        // rejected rule's id is a declared one: `--only` selects its errored row.
+        const onlyIds = only ? only.split(',').map((s) => s.trim()).filter(Boolean) : undefined;
+        if (onlyIds) {
+            const known = new Set([...rules.map((r) => r.id), ...rejectedAll.map((r) => r.id)]);
+            const unknown = onlyIds.filter((id) => !known.has(id));
             if (unknown.length > 0) {
                 process.stderr.write(`Unknown --only rule id(s): ${unknown.join(', ')}. Configured: ${[...known].join(', ') || '(none)'}\n`);
                 return ExitCode.UsageError;
             }
         }
+        const rejected = onlyIds ? rejectedAll.filter((r) => onlyIds.includes(r.id)) : rejectedAll;
         let changedFiles;
         if (changedOnly || newOnly || since) {
             changedFiles = resolveChangedFiles({
@@ -178,8 +241,9 @@ export const policyLintCommand = {
         }
         // Don't lint SharkCraft's own asset/config dir by default (its .ts files
         // hold the rule definitions themselves, which can self-match).
-        const sharkcraftRel = nodePath.relative(cwd, loaded.value.sharkcraftDir).split(nodePath.sep).join('/');
-        const excludeDirs = sharkcraftRel && !sharkcraftRel.startsWith('..') ? [sharkcraftRel] : [];
+        // THE plane scan scope — the same authority `gates check`, `quality`,
+        // `finish` and `shrk gate` read for this rule.
+        const excludeDirs = planeScanExcludeDirs(cwd, loaded.value.sharkcraftDir);
         const reportRaw = runPolicyLint(cwd, rules, {
             ...(surfaces ? { surfaces } : {}),
             // --changed-only narrows the SCAN; --new-only scans the full tree so it can
@@ -220,58 +284,121 @@ export const policyLintCommand = {
                     : 'pass';
             report = { ...report, findings: newFindings, verdict };
         }
+        // Settle first, render second: ONE proposed exit for text and JSON (the two
+        // used to disagree when a rule skipped next to a warning finding), settled
+        // against what each rule actually scanned.
+        //
+        // An EMPTY selection (no rule's globs intersect the changeset, or --only
+        // picked nothing) proposes 0 and lets the run coverage decide: expected 0
+        // is a shortfall (2) unless --allow-empty accepted it. Proposing 2 here
+        // would make the valve unreachable on exactly the case it exists for.
+        const proposed = report.verdict === 'errors' || report.skipped.some((sk) => sk.failed) || rejected.length > 0
+            ? ExitCode.Failure
+            : (report.evaluated === 0 && report.rules.length > 0) || report.skipped.length > 0
+                ? ExitCode.NotVerified
+                : ExitCode.VerifiedPass;
+        const unexaminedRules = [
+            ...report.skipped.map((s) => s.ruleId),
+            ...report.rules.filter((r) => r.status === 'error').map((r) => r.ruleId),
+            ...rejected.map((r) => r.id),
+        ];
+        const inScope = report.rules.length + rejected.length;
+        const env = buildGateEnvelope('policy-lint', proposed, [...report.rules.map((r) => {
+                const skip = report.skipped.find((s) => s.ruleId === r.ruleId);
+                return {
+                    id: r.ruleId,
+                    type: 'policy',
+                    status: r.status,
+                    severity: r.severity,
+                    counts: {
+                        units: r.unitsScanned,
+                        findings: r.findingCount,
+                        suppressed: r.suppressedCount,
+                    },
+                    violations: report.findings
+                        .filter((f) => f.ruleId === r.ruleId)
+                        .map((f) => ({
+                        id: f.match,
+                        file: f.file,
+                        line: f.line,
+                        message: f.message,
+                        ...(f.suggest ? { hint: f.suggest } : {}),
+                    })),
+                    ...(skip ? { skipReason: skip.reason } : {}),
+                    ...(r.error ? { error: r.error } : {}),
+                    coverage: policyRuleCoverage(r),
+                    // The rule's `expectEmpty` acceptance and unit lines (round 13),
+                    // folded into the envelope's one settle — the accepted line comes from it.
+                    ...(r.unitAcceptance !== undefined ? { unitAcceptance: r.unitAcceptance } : {}),
+                    ...(r.units !== undefined ? { units: r.units } : {}),
+                };
+            }), ...rejected], {
+            unit: 'policy rules',
+            expected: inScope,
+            examined: inScope - unexaminedRules.length,
+            ...(unexaminedRules.length > 0
+                ? { unexamined: unexaminedRules, reason: 'scanned nothing or could not run' }
+                : {}),
+            ...(inScope === 0
+                ? {
+                    reason: changedOnly || since
+                        ? "no rule's globs match content in the changeset (a deleted file, or one with nothing on the rule's surface, puts nothing in scope)"
+                        : 'no rule selected',
+                }
+                : {}),
+            ...allowEmptyValve(args, inScope),
+        });
+        const exit = env.exit;
         if (wantJson) {
-            const exit = report.verdict === 'errors' || report.skipped.some((sk) => sk.failed)
-                ? ExitCode.Failure
-                : report.evaluated === 0 || report.skipped.length > 0
-                    ? ExitCode.NotVerified
-                    : ExitCode.VerifiedPass;
             process.stdout.write(asJson({
                 ...report,
+                // Pack policy rules the merge seam refused — errored rows in `gate.rules`.
+                rejected: rejected.map((r) => ({ id: r.id, error: r.error ?? null })),
                 ...(newOnly ? { newOnly: true, hiddenBaseline } : {}),
-                gate: buildGateEnvelope('policy-lint', exit, report.rules.map((r) => {
-                    const skip = report.skipped.find((s) => s.ruleId === r.ruleId);
-                    return {
-                        id: r.ruleId,
-                        type: 'policy',
-                        status: r.status,
-                        severity: r.severity,
-                        counts: {
-                            units: r.unitsScanned,
-                            findings: r.findingCount,
-                            suppressed: r.suppressedCount,
-                        },
-                        violations: report.findings
-                            .filter((f) => f.ruleId === r.ruleId)
-                            .map((f) => ({
-                            id: f.match,
-                            file: f.file,
-                            line: f.line,
-                            message: f.message,
-                            ...(f.suggest ? { hint: f.suggest } : {}),
-                        })),
-                        ...(skip ? { skipReason: skip.reason } : {}),
-                        ...(r.error ? { error: r.error } : {}),
-                    };
-                })),
+                // The plane verdict derives from the SETTLED exit — never `warnings`
+                // / `pass` next to exitCode 2.
+                verdict: planeVerdictForExit(exit, report.verdict),
+                exitCode: exit,
+                gate: env,
             }) + '\n');
             return exit;
         }
         process.stdout.write(header('Policy lint'));
+        if (rejected.length > 0) {
+            process.stdout.write(`  ✗ ${rejected.length} pack policy rule(s) failed validation at the pack-plane merge seam — NOT evaluated, FAILED:\n`);
+            for (const r of rejected)
+                process.stdout.write(`    ✗ ${r.id} — ${r.error ?? 'failed validation'}\n`);
+            process.stdout.write('    `shrk packs contributions` names every rejected entry.\n');
+        }
         // `evaluated` counts rules that actually scanned ≥1 file. When 0 rules
-        // evaluated but rules ARE configured, say so loudly — "scanned nothing" must
-        // never read as the green "no policy violations" pass.
+        // evaluated, say so loudly — "scanned nothing" must never read as the green
+        // "no policy violations" pass. `2` (or `1` when a `failOnEmpty` rule
+        // promotes it), unless --allow-empty accepted an empty scope explicitly.
         if (report.evaluated === 0) {
-            process.stdout.write(`  ! Nothing evaluated — ${report.rules.length} rule(s) configured but none matched files in scope` +
+            process.stdout.write(`  ! Nothing evaluated — ${rules.length} rule(s) configured, ${report.rules.length} in scope, none matched files` +
                 (changedOnly || since ? ' (changed-only).\n' : '.\n'));
             for (const sk of report.skipped) {
                 process.stdout.write(`    – ${sk.ruleId}: ${sk.reason}${sk.failed ? '  (failOnEmpty → FAILED)' : ''}\n`);
             }
-            // Scanning nothing is not a pass. `2` = not verified (the repo-wide
-            // contract); a `failOnEmpty` rule promotes it to a real failure.
-            return report.skipped.some((sk) => sk.failed) ? 1 : 2;
+            // THE empty-rule advice (round 13) — this branch returned before the only
+            // advice site, so a rule that matched nothing got none.
+            for (const a of emptyRuleAdviceLines(report.skipped.map((sk) => ({ fails: sk.failed === true })))) {
+                process.stdout.write(`    ${a}.\n`);
+            }
+            const line = verdictLine(env, 'Nothing in scope — accepted.');
+            if (line)
+                process.stdout.write(`\n${line}\n`);
+            if (report.rules.length === 0 && exit === ExitCode.NotVerified) {
+                process.stdout.write(`  Pass --${ALLOW_EMPTY_FLAG} to accept an empty changeset explicitly.\n`);
+            }
+            return exit;
         }
-        process.stdout.write(kv('rules evaluated', `${report.evaluated} of ${report.rules.length}`) + '\n');
+        // Round 13 (K6): a rule accepted as intended-empty examined 0 files, so the
+        // printed count leaves it out and names it apart (`IPolicyReport.evaluated`
+        // keeps counting it only so the `evaluated === 0` guard above never reads
+        // an accepted plan as "nothing ran").
+        const acceptedNote = acceptedEmptyNote(report.acceptedEmpty);
+        process.stdout.write(kv('rules evaluated', `${report.evaluated - report.acceptedEmpty} of ${inScope}${acceptedNote}`) + '\n');
         const errors = report.findings.filter((f) => f.severity === 'error').length;
         const warnings = report.findings.filter((f) => f.severity === 'warning').length;
         process.stdout.write(kv('findings', `${errors} error(s), ${warnings} warning(s)`) + '\n');
@@ -289,21 +416,43 @@ export const policyLintCommand = {
             for (const d of report.diagnostics)
                 process.stdout.write(`  ! ${d}\n`);
         }
+        // THE shared unit-state block (round 13, K2): a dead `files` glob of a
+        // rule that still matched, and a LOCAL expectEmpty marker whose target
+        // appeared, withhold the ✓ (exit unchanged); a pack marker is INFO.
+        const unitNotes = unitStateNotes(report.rules.map((r) => ({
+            id: r.ruleId,
+            ...(r.unitLiveness !== undefined ? { unitLiveness: r.unitLiveness } : {}),
+            reportedEmpty: report.skipped.some((s) => s.ruleId === r.ruleId),
+        })));
+        process.stdout.write(unitNotes.text);
+        if (report.skipped.length > 0) {
+            // THE empty-rule advice (round 13) — one sentence per REAL `fails`
+            // value, from the shared renderer: a soft skip was told nothing.
+            process.stdout.write('\nA rule that matched nothing is a bug in the rule, not a pass.\n');
+            for (const a of emptyRuleAdviceLines(report.skipped.map((sk) => ({ fails: sk.failed === true })))) {
+                process.stdout.write(`  ${a}.\n`);
+            }
+        }
         if (report.skipped.some((sk) => sk.failed)) {
-            process.stdout.write('\nA rule that matched nothing is a bug in the rule, not a pass. (`error`-severity\n' +
-                '  rules fail on empty by default — set `failOnEmpty: false` if the set may be empty.)\n');
-            return 1;
+            const line = verdictLine(env, '');
+            if (line)
+                process.stdout.write(`${line}\n`);
+            return exit;
         }
         // A non-failing skip still means "partially verified" — never a green 0.
         if (report.skipped.length > 0 && report.findings.length === 0) {
-            process.stdout.write(`\n${report.skipped.length} rule(s) scanned nothing — partially verified, not a full green.\n`);
-            return 2;
+            const line = verdictLine(env, '', `${report.skipped.length} rule(s) scanned nothing — partially verified, not a full green.`);
+            if (line)
+                process.stdout.write(`\n${line}\n`);
+            return exit;
         }
         if (report.findings.length === 0 && report.diagnostics.length === 0) {
-            process.stdout.write(newOnly
-                ? `\nNo NEW policy violations from this change${hiddenBaseline > 0 ? ` (${hiddenBaseline} pre-existing hidden)` : ''}. ✓\n`
-                : '\nNo policy violations on the scanned surfaces. ✓\n');
-            return 0;
+            const line = verdictLine(env, qualifyCleanForUnits(newOnly
+                ? `No NEW policy violations from this change${hiddenBaseline > 0 ? ` (${hiddenBaseline} pre-existing hidden)` : ''}. ✓`
+                : 'No policy violations on the scanned surfaces. ✓', unitNotes));
+            if (line)
+                process.stdout.write(`\n${line}\n`);
+            return exit;
         }
         // Group findings by rule.
         const byRule = new Map();
@@ -327,6 +476,16 @@ export const policyLintCommand = {
             if (suggest)
                 process.stdout.write(`    → ${suggest}\n`);
         }
-        return report.verdict === 'errors' ? 1 : 0;
+        // The final line and the exit come from the SETTLED verdict — the same
+        // `exit` the JSON returns. A warning finding next to a rule that scanned
+        // nothing used to exit 0 here (no verdict line) while --json said 2.
+        const tail = verdictLine(env, warnings > 0
+            ? `No blocking policy violations — ${warnings} warning(s) reported above.`
+            : 'No policy violations on the scanned surfaces (see the diagnostics above).', report.skipped.length > 0
+            ? `${report.skipped.length} rule(s) scanned nothing — partially verified, not a full green.`
+            : undefined);
+        if (tail)
+            process.stdout.write(`\n${tail}\n`);
+        return exit;
     },
 };

package/dist/commands/policy.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"policy.command.d.ts","sourceRoot":"","sources":["../../src/commands/policy.command.ts"],"names":[],"mappings":"AAoBA,OAAO,EAKL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAkBhC,eAAO,MAAM,iBAAiB,EAAE,eAwB/B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,eA6B9B,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,eAsI/B,CAAC;AAiBF,eAAO,MAAM,gBAAgB,EAAE,eA6F9B,CAAC;AAIF,eAAO,MAAM,qBAAqB,EAAE,eAsJnC,CAAC;AAGF,eAAO,MAAM,kBAAkB,EAAE,eAKhC,CAAC"}
+{"version":3,"file":"policy.command.d.ts","sourceRoot":"","sources":["../../src/commands/policy.command.ts"],"names":[],"mappings":"AAqBA,OAAO,EAKL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAmBhC,eAAO,MAAM,iBAAiB,EAAE,eA4B/B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,eA6B9B,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,eAsI/B,CAAC;AAiBF,eAAO,MAAM,gBAAgB,EAAE,eA6F9B,CAAC;AAIF,eAAO,MAAM,qBAAqB,EAAE,eAsJnC,CAAC;AAGF,eAAO,MAAM,kBAAkB,EAAE,eAKhC,CAAC"}

package/dist/commands/policy.command.js

@@ -1,8 +1,9 @@
 import { existsSync, readFileSync } from 'node:fs';
 import * as nodePath from 'node:path';
-import { appendPolicyOverrideAudit, applyPolicyOverrides, ChangedScopeMode, classifyChangedScope, evaluatePolicy, inspectSharkcraft, listPolicyOverrides, PolicySeverity, resolveChangedFiles, runPolicySnapshot, runPolicyTest, runPolicyTestsForAll, summariseChangedScope, } from '@shrkcrft/inspector';
+import { appendPolicyOverrideAudit, applyPolicyOverrides, ChangedScopeMode, classifyChangedScope, ContributionKind, evaluatePolicy, inspectSharkcraft, listPolicyOverrides, PolicySeverity, resolveChangedFiles, runPolicySnapshot, runPolicyTest, runPolicyTestsForAll, summariseChangedScope, } from '@shrkcrft/inspector';
 import { flagBool, flagString, flagList, resolveCwd, } from "../command-registry.js";
 import { asJson, header } from "../output/format-output.js";
+import { writeRejectedEntriesNote } from "../output/rejected-entries-note.js";
 function buildEvaluateInput(args) {
     const out = {};
     const plan = flagString(args, 'plan');
@@ -35,14 +36,18 @@ export const policyListCommand = {
             onlyId: '__none__', // skip predicate execution; we only want registrations
         });
         const regs = report.registrations;
+        // A policy declaration its loader refused (no id) is named (round 12, 12.1).
+        const note = { next: 'shrk packs contributions' };
         if (flagBool(args, 'json')) {
             process.stdout.write(asJson(regs) + '\n');
+            await writeRejectedEntriesNote(inspection, [ContributionKind.Policy], { ...note, json: true });
             return 0;
         }
         process.stdout.write(header(`Policy checks (${regs.length})`));
         for (const r of regs) {
             process.stdout.write(`  [${r.source}] ${r.severity.padEnd(7)} ${r.id.padEnd(40)} ${r.title}\n`);
         }
+        await writeRejectedEntriesNote(inspection, [ContributionKind.Policy], note);
         return 0;
     },
 };

package/dist/commands/pr.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pr.command.d.ts","sourceRoot":"","sources":["../../src/commands/pr.command.ts"],"names":[],"mappings":"AAgBA,OAAO,EAML,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAgGhC,eAAO,MAAM,SAAS,EAAE,eAcvB,CAAC"}
+{"version":3,"file":"pr.command.d.ts","sourceRoot":"","sources":["../../src/commands/pr.command.ts"],"names":[],"mappings":"AAgBA,OAAO,EAML,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAiGhC,eAAO,MAAM,SAAS,EAAE,eA6BvB,CAAC"}