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

package/dist/commands/ingest.command.d.ts

@@ -13,5 +13,4 @@ export declare const generatedProtectCommand: ICommandHandler;
  * half proves it has not drifted.
  */
 export declare const generatedCommand: ICommandHandler;
-export declare const stabilityCommand: ICommandHandler;
 //# sourceMappingURL=ingest.command.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ingest.command.d.ts","sourceRoot":"","sources":["../../src/commands/ingest.command.ts"],"names":[],"mappings":"AA0CA,OAAO,EAKL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAOhC,eAAO,MAAM,aAAa,EAAE,eA4B3B,CAAC;AAmZF,eAAO,MAAM,qBAAqB,EAAE,eAkBnC,CAAC;AAEF,kFAAkF;AAClF,eAAO,MAAM,sBAAsB,EAAE,eAcpC,CAAC;AAEF,kEAAkE;AAClE,eAAO,MAAM,uBAAuB,EAAE,eAsBrC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,EAAE,eAY9B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,eAkC9B,CAAC"}
+{"version":3,"file":"ingest.command.d.ts","sourceRoot":"","sources":["../../src/commands/ingest.command.ts"],"names":[],"mappings":"AAsCA,OAAO,EAKL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAQhC,eAAO,MAAM,aAAa,EAAE,eA4C3B,CAAC;AAmZF,eAAO,MAAM,qBAAqB,EAAE,eAkBnC,CAAC;AAEF,kFAAkF;AAClF,eAAO,MAAM,sBAAsB,EAAE,eAcpC,CAAC;AAEF,kEAAkE;AAClE,eAAO,MAAM,uBAAuB,EAAE,eAsBrC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,EAAE,eAgB9B,CAAC"}

package/dist/commands/ingest.command.js

@@ -1,12 +1,29 @@
 import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from 'node:fs';
 import * as nodePath from 'node:path';
 import { cliCommandNameSet } from "./command-catalog.js";
-import { applyIngestPlan, buildContradictionReport, buildGeneratedCodeReport, buildIngestAdoptionPlan, buildIngestApplyPlan, buildRepositoryKnowledgeModel, buildStabilityMap, inspectSharkcraft, IngestAdoptionStatus, IngestDepth, IngestSection, loadIngestApplyPlan, renderContradictionReportHtml, renderContradictionReportJson, renderContradictionReportMarkdown, renderContradictionReportText, renderGeneratedCodeReportJson, renderGeneratedCodeReportMarkdown, renderGeneratedCodeReportText, renderIngestAdoptionPatch, renderIngestAdoptionPlanMarkdown, renderIngestApplyReviewMarkdown, renderRepositoryKnowledgeModelHtml, renderRepositoryKnowledgeModelJson, renderRepositoryKnowledgeModelMarkdown, renderRepositoryKnowledgeModelText, renderStabilityMapJson, renderStabilityMapMarkdown, renderStabilityMapText, saveIngestApplyPlan, signIngestApplyPlan, writeIngestAdoption, writeIngestDrafts, } from '@shrkcrft/inspector';
+import { applyIngestPlan, buildContradictionReport, buildGeneratedCodeReport, buildIngestAdoptionPlan, buildIngestApplyPlan, buildRepositoryKnowledgeModel, inspectSharkcraft, IngestAdoptionStatus, IngestDepth, IngestSection, loadIngestApplyPlan, renderContradictionReportHtml, renderContradictionReportJson, renderContradictionReportMarkdown, renderContradictionReportText, renderGeneratedCodeReportJson, renderGeneratedCodeReportMarkdown, renderGeneratedCodeReportText, renderIngestAdoptionPatch, renderIngestAdoptionPlanMarkdown, renderIngestApplyReviewMarkdown, renderRepositoryKnowledgeModelHtml, renderRepositoryKnowledgeModelJson, renderRepositoryKnowledgeModelMarkdown, renderRepositoryKnowledgeModelText, saveIngestApplyPlan, signIngestApplyPlan, writeIngestAdoption, writeIngestDrafts, } from '@shrkcrft/inspector';
 import { flagBool, flagString, flagList, resolveCwd, } from "../command-registry.js";
+import { PositionalMode } from "../dispatch/positional-mode.js";
 import { asJson, header, kv } from "../output/format-output.js";
 const INGEST_BASE = nodePath.join('sharkcraft', 'ingestion');
 export const ingestCommand = {
     name: 'ingest',
+    // An unknown token used to fall through to `repository` and run it.
+    positionals: PositionalMode.None,
+    subverbs: [
+        { name: 'repository', description: 'Build the repository knowledge model (the default).', usage: 'shrk ingest repository [options]' },
+        { name: 'refresh', description: 'Refresh the ingested model.', usage: 'shrk ingest refresh [options]' },
+        { name: 'status', description: 'The ingestion status.', usage: 'shrk ingest status [options]' },
+        { name: 'report', description: 'Render the ingestion report.', usage: 'shrk ingest report [--format text|markdown|html|json]' },
+        {
+            name: 'adopt',
+            description: 'Plan / review / apply the adoption of the ingested drafts.',
+            usage: 'shrk ingest adopt [plan|review|apply] [<plan.json>] [options]',
+            positionals: PositionalMode.Free,
+        },
+        { name: 'diff', description: 'Diff the ingested model against the live config.', usage: 'shrk ingest diff [options]' },
+        { name: 'clean', description: 'Remove the ingestion drafts.', usage: 'shrk ingest clean [options]' },
+    ],
     description: 'Deeply ingest a repository into a SharkCraft repository knowledge model. Dry-run by default; writes drafts under sharkcraft/ingestion/. `repository` (default sub-verb) builds the knowledge model; `status` / `report` / `diff` / `adopt` / `clean` / `refresh` manage the lifecycle.',
     usage: 'shrk [--cwd <dir>] ingest [repository|refresh|status|report|adopt|diff|clean] [options]',
     async run(args) {
@@ -510,6 +527,10 @@ export const generatedProtectCommand = {
  */
 export const generatedCommand = {
     name: 'generated',
+    // Mixed-mode: its verbs (report / protect / list / check / update / explain)
+    // are trie children, so a bare token reaching this handler names none of
+    // them — it used to run the classifier report at exit 0.
+    positionals: PositionalMode.None,
     description: 'Generated-code classifier (`report` default, `protect --write-drafts`) + the generated-artifact drift GATE (`list | check | update | explain`, see docs/generated-drift.md). Read-only by default.',
     usage: 'shrk [--cwd <dir>] generated [report|protect] [--format text|markdown|json] [--write-drafts]\n         (drift gate: shrk generated list | check [--headers-only] | update | explain --id <id>)',
     booleanFlags: new Set(['write-drafts']),
@@ -519,44 +540,7 @@ export const generatedCommand = {
         return generatedReportCommand.run({ ...args, positional: [] });
     },
 };
-export const stabilityCommand = {
-    name: 'stability',
-    description: 'Stability classification (stable/experimental/deprecated/legacy/generated/internal/public-api/high-risk). Read-only.',
-    usage: 'shrk [--cwd <dir>] stability [map|area <id>] [--format text|markdown|json]',
-    async run(args) {
-        const sub = args.positional[0];
-        const cwd = resolveCwd(args);
-        const format = parseFormat(flagString(args, 'format'));
-        const inspection = await inspectSharkcraft({ cwd });
-        const generated = buildGeneratedCodeReport({ inspection });
-        const map = buildStabilityMap({
-            inspection,
-            generatedRoots: generated.generatedRoots.map((r) => r.path),
-        });
-        if (sub === 'area') {
-            const id = args.positional[1];
-            if (!id) {
-                process.stderr.write('Usage: shrk stability area <id>\n');
-                return 1;
-            }
-            const area = map.areas.find((a) => a.id === id || a.path === id);
-            if (!area) {
-                process.stderr.write(`No stability area found for "${id}".\n`);
-                return 1;
-            }
-            if (format === 'json')
-                process.stdout.write(asJson(area) + '\n');
-            else
-                process.stdout.write(`${area.kind} (${area.confidence})\n  path: ${area.path}\n  signals: ${area.signals.join(', ')}\n` + (area.note ? `  note: ${area.note}\n` : ''));
-            return 0;
-        }
-        if (format === 'json')
-            process.stdout.write(renderStabilityMapJson(map) + '\n');
-        else if (format === 'markdown')
-            process.stdout.write(renderStabilityMapMarkdown(map) + '\n');
-        else
-            process.stdout.write(renderStabilityMapText(map) + '\n');
-        return 0;
-    },
-};
+// The unregistered `stabilityCommand` (`shrk stability map|area`) was deleted in
+// round 11 review: nothing registered it, so its usage text named a command that
+// was never callable (`shrk stability area x` → "looks like a task").
 void parseFormat;

package/dist/commands/knowledge-author.command.d.ts

@@ -5,8 +5,6 @@
  *   - `shrk knowledge update <id>` — preview an incremental change.
  *   - `shrk knowledge remove <id>` — preview a removal (refuses if
  *     reverse references exist unless --force-preview).
- *   - `shrk knowledge author preview` — alias that classifies the
- *     operation by which flags were passed.
  *   - `shrk knowledge lint [--fix-preview]` — classify findings.
  *
  * All commands default to preview-only. Files land under
@@ -18,5 +16,4 @@ export declare const knowledgeAddCommand: ICommandHandler;
 export declare const knowledgeUpdateCommand: ICommandHandler;
 export declare const knowledgeRemoveCommand: ICommandHandler;
 export declare const knowledgeLintCommand: ICommandHandler;
-export declare const knowledgeAuthorPreviewCommand: ICommandHandler;
 //# sourceMappingURL=knowledge-author.command.d.ts.map

package/dist/commands/knowledge-author.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"knowledge-author.command.d.ts","sourceRoot":"","sources":["../../src/commands/knowledge-author.command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAoBH,OAAO,EAKL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAwChC,eAAO,MAAM,mBAAmB,EAAE,eAgEjC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,eA0GpC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,eAoEpC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,eAsElC,CAAC;AAEF,eAAO,MAAM,6BAA6B,EAAE,eAmB3C,CAAC"}
+{"version":3,"file":"knowledge-author.command.d.ts","sourceRoot":"","sources":["../../src/commands/knowledge-author.command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAsBH,OAAO,EAKL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAwChC,eAAO,MAAM,mBAAmB,EAAE,eAgEjC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,eA0GpC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,eAyEpC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,eAyElC,CAAC"}

package/dist/commands/knowledge-author.command.js

@@ -5,8 +5,6 @@
  *   - `shrk knowledge update <id>` — preview an incremental change.
  *   - `shrk knowledge remove <id>` — preview a removal (refuses if
  *     reverse references exist unless --force-preview).
- *   - `shrk knowledge author preview` — alias that classifies the
- *     operation by which flags were passed.
  *   - `shrk knowledge lint [--fix-preview]` — classify findings.
  *
  * All commands default to preview-only. Files land under
@@ -15,7 +13,7 @@
  */
 import { mkdirSync, writeFileSync } from 'node:fs';
 import * as nodePath from 'node:path';
-import { buildKnowledgeAuthoringPreview, buildKnowledgeLintFixPreview, buildKnowledgeStaleReport, inspectSharkcraft, KnowledgeAuthoringOperation, KnowledgeLintCategory, lintKnowledge, recordProvenance, renderKnowledgeLintFixPreviewMarkdown, renderKnowledgeLintMarkdown, ReferenceCheckOutcome, AssetKind, AssetProvenanceOperation, } from '@shrkcrft/inspector';
+import { buildDeclaredXrefReport, buildKnowledgeAuthoringPreview, buildKnowledgeLintFixPreview, reverseReferenceLabel, buildKnowledgeStaleReport, inspectSharkcraft, KnowledgeAuthoringOperation, KnowledgeLintCategory, lintKnowledge, recordProvenance, renderKnowledgeLintFixPreviewMarkdown, renderKnowledgeLintMarkdown, ReferenceCheckOutcome, AssetKind, AssetProvenanceOperation, } from '@shrkcrft/inspector';
 import { flagBool, flagString, flagList, resolveCwd, } from "../command-registry.js";
 import { asJson, header } from "../output/format-output.js";
 import { detectAuthoringSource, multiFlagValues as multiValues, parseReferenceSpec as parseReference, writeAuthoringDrafts, } from "../authoring/authoring-kit.js";
@@ -243,8 +241,13 @@ export const knowledgeRemoveCommand = {
             forcePreview: flagBool(args, 'force-preview'),
             ...(flagString(args, 'reason') ? { reason: flagString(args, 'reason') ?? undefined } : {}),
         };
+        // Every declared cross-reference in the workspace — so an entry a construct,
+        // boundary rule or template points at is refused like one another entry
+        // points at (the collector warms the registries it resolves against).
+        const declaredXrefs = await buildDeclaredXrefReport(inspection);
         const result = buildKnowledgeAuthoringPreview(input, {
             entries: inspection.knowledgeEntries,
+            declaredXrefs,
         });
         if (flagBool(args, 'json')) {
             process.stdout.write(asJson(result) + '\n');
@@ -257,7 +260,7 @@ export const knowledgeRemoveCommand = {
             if (result.reverseReferences && result.reverseReferences.length > 0) {
                 process.stdout.write(`\n  reverse references (${result.reverseReferences.length}):\n`);
                 for (const r of result.reverseReferences) {
-                    process.stdout.write(`    - ${r.fromEntryId} (${r.field})${r.note ? ` — ${r.note}` : ''}\n`);
+                    process.stdout.write(`    - ${reverseReferenceLabel(r)} (${r.field})${r.note ? ` — ${r.note}` : ''}\n`);
                 }
             }
             if (result.suggestedDeprecationInstead) {
@@ -311,6 +314,9 @@ export const knowledgeLintCommand = {
         }
         const entryIds = flagList(args, 'id');
         const includeAdvisory = !flagBool(args, 'no-advisory');
+        // Warm before resolving, so a correct playbook / policy id is not linted
+        // as a stale reference.
+        await (await import("../surface/cli-command-resolver.js")).warmCliReferenceRegistries(inspection);
         const stale = buildKnowledgeStaleReport(inspection);
         const staleIds = new Set();
         for (const c of stale.referenceChecks) {
@@ -354,22 +360,3 @@ export const knowledgeLintCommand = {
         return warning ? 1 : 0;
     },
 };
-export const knowledgeAuthorPreviewCommand = {
-    name: 'author',
-    description: 'Knowledge authoring preview entry-point. Dispatches to add/update/remove based on flags.',
-    usage: 'shrk knowledge author [preview] --id <id> [--operation add|update|remove] [common knowledge add/update/remove flags] [--write-preview] [--json]',
-    async run(args) {
-        // The first positional may be "preview" (the verb) — strip it.
-        if (args.positional[0] === 'preview')
-            args.positional.shift();
-        const operation = (flagString(args, 'operation') ?? 'add');
-        switch (operation) {
-            case 'add':
-                return knowledgeAddCommand.run(args);
-            case 'update':
-                return knowledgeUpdateCommand.run(args);
-            case 'remove':
-                return knowledgeRemoveCommand.run(args);
-        }
-    },
-};

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

@@ -1 +1 @@
-{"version":3,"file":"knowledge.command.d.ts","sourceRoot":"","sources":["../../src/commands/knowledge.command.ts"],"names":[],"mappings":"AAoBA,OAAO,EAML,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAoGhC,eAAO,MAAM,oBAAoB,EAAE,eAgDlC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,eAuBjC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,eAuCpC,CAAC;AAoBF,eAAO,MAAM,0BAA0B,EAAE,eAWxC,CAAC;AA8NF,eAAO,MAAM,sBAAsB,EAAE,eAQpC,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,eA8CxC,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,eAuBrC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,EAAE,eA8B1C,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,eA8BxC,CAAC;AAEF,eAAO,MAAM,4BAA4B,EAAE,eAkC1C,CAAC"}
+{"version":3,"file":"knowledge.command.d.ts","sourceRoot":"","sources":["../../src/commands/knowledge.command.ts"],"names":[],"mappings":"AA0CA,OAAO,EAOL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAuOhC,eAAO,MAAM,oBAAoB,EAAE,eAwElC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,eAsCjC,CAAC;AAqCF,eAAO,MAAM,sBAAsB,EAAE,eA+CpC,CAAC;AAqCF,eAAO,MAAM,0BAA0B,EAAE,eASxC,CAAC;AAmWF,eAAO,MAAM,sBAAsB,EAAE,eASpC,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,eAgDxC,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,eAuBrC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,EAAE,eA8B1C,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,eA8BxC,CAAC;AAEF,eAAO,MAAM,4BAA4B,EAAE,eAkC1C,CAAC"}