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

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

@@ -1 +1 @@
-{"version":3,"file":"languages.command.d.ts","sourceRoot":"","sources":["../../src/commands/languages.command.ts"],"names":[],"mappings":"AA4BA,OAAO,EAIL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AA8NhC,eAAO,MAAM,gBAAgB,EAAE,eA6B9B,CAAC"}
+{"version":3,"file":"languages.command.d.ts","sourceRoot":"","sources":["../../src/commands/languages.command.ts"],"names":[],"mappings":"AA4BA,OAAO,EAIL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AA+NhC,eAAO,MAAM,gBAAgB,EAAE,eAuD9B,CAAC"}

package/dist/commands/languages.command.js

@@ -2,6 +2,7 @@ import { mkdirSync, writeFileSync } from 'node:fs';
 import * as nodePath from 'node:path';
 import { buildLanguageCommandReport, buildLanguageRunPlan, buildPolyglotBoundaryReport, clearLanguageCache, computePolyglotTestImpact, defaultLanguageRunReportPath, detectLanguageProfiles, detectLanguageProfilesWithCache, getLanguageCacheStatus, LanguageId, renderLanguageCommandsMarkdown, renderLanguageCommandsText, renderLanguageProfilesMarkdown, renderLanguageProfilesText, renderLanguageRunPlanJson, renderLanguageRunPlanMarkdown, renderLanguageRunPlanText, renderPolyglotBoundaryReportJson, renderPolyglotBoundaryReportMarkdown, renderPolyglotBoundaryReportText, renderPolyglotDependenciesText, renderPolyglotTestImpactText, scanPolyglotDependencies, } from '@shrkcrft/inspector';
 import { flagBool, flagString, resolveCwd, } from "../command-registry.js";
+import { PositionalMode } from "../dispatch/positional-mode.js";
 import { asJson } from "../output/format-output.js";
 function writeOutOrPrint(args, cwd, body) {
     const out = flagString(args, 'output');
@@ -235,6 +236,32 @@ const languagesTestsCommand = {
 };
 export const languagesCommand = {
     name: 'languages',
+    positionals: PositionalMode.None,
+    // Each spec reuses its handler's own description / usage — one source.
+    subverbs: [
+        ...[
+            languagesDetectCommand,
+            languagesCommandsCommand,
+            languagesDepsCommand,
+            languagesTestsCommand,
+            languagesBoundariesCommand,
+            languagesRunCommand,
+            languagesCacheCommand,
+        ].map((h) => ({ name: h.name, description: h.description, usage: h.usage })),
+        {
+            name: 'runner',
+            description: 'The language runner policy.',
+            usage: 'shrk languages runner config [--json]',
+            positionals: PositionalMode.None,
+            subverbs: [
+                {
+                    name: 'config',
+                    description: 'Show the language runner policy (allowlist + denylist + built-in deny patterns). Read-only.',
+                    usage: 'shrk languages runner config [--json]',
+                },
+            ],
+        },
+    ],
     description: 'Polyglot language support: detect language profiles, infer commands, scan dependencies, predict test impact, enforce boundaries, run safe commands, manage cache. Read-only by default.',
     usage: 'shrk languages <detect|commands|deps|tests|boundaries|run|cache> [...]',
     async run(args) {

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

@@ -1 +1 @@
-{"version":3,"file":"lint.command.d.ts","sourceRoot":"","sources":["../../src/commands/lint.command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAYH,OAAO,EAKL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAmBhC,eAAO,MAAM,WAAW,EAAE,eAuHzB,CAAC"}
+{"version":3,"file":"lint.command.d.ts","sourceRoot":"","sources":["../../src/commands/lint.command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAYH,OAAO,EAKL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAmBhC,eAAO,MAAM,WAAW,EAAE,eA0HzB,CAAC"}

package/dist/commands/lint.command.js

@@ -33,6 +33,9 @@ export const lintCommand = {
     async run(args) {
         const cwd = resolveCwd(args);
         const inspection = await inspectSharkcraft({ cwd });
+        // The knowledge part resolves references — warm first, or a correct
+        // playbook / policy id reads as a stale-reference finding.
+        await (await import("../surface/cli-command-resolver.js")).warmCliReferenceRegistries(inspection);
         const kind = parseKind(flagString(args, 'kind'));
         const strict = flagBool(args, 'strict');
         const fixPreview = flagBool(args, 'fix-preview');

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

@@ -1,3 +1,21 @@
+import { type IMcpGateDecision, type IToolDefinition } from '@shrkcrft/mcp-server';
 import { type ICommandHandler } from '../command-registry.js';
 export declare const mcpCommand: ICommandHandler;
+/**
+ * Build the MCP tier-gate resolver from the surface summary.
+ * Returns a function that, given a tool, decides whether to refuse the
+ * call (when the tool's sibling CLI command is experimental and not
+ * enabled). Tools without `cliCommand` are always callable
+ * (bootstrap MCP-only tools).
+ *
+ * The same summary the CLI surface gate reads, so a tool whose sibling is a
+ * tool-maintenance command (`get_docs_check` → `docs check`) is refused
+ * outside SharkCraft's own repository, and one whose sibling a
+ * `surface.disabled` selector denies is refused too — with the CLI's reason.
+ *
+ * Failure-soft: any error building the summary returns a no-op
+ * resolver — the server stays open rather than failing closed on
+ * unrelated issues.
+ */
+export declare function buildMcpGateResolver(cwd: string): Promise<((tool: IToolDefinition) => IMcpGateDecision | null) | undefined>;
 //# sourceMappingURL=mcp.command.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"mcp.command.d.ts","sourceRoot":"","sources":["../../src/commands/mcp.command.ts"],"names":[],"mappings":"AAMA,OAAO,EAKL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAKhC,eAAO,MAAM,UAAU,EAAE,eAiCxB,CAAC"}
+{"version":3,"file":"mcp.command.d.ts","sourceRoot":"","sources":["../../src/commands/mcp.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,eAAe,EAErB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAKL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAYhC,eAAO,MAAM,UAAU,EAAE,eAyCxB,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,eAAe,KAAK,gBAAgB,GAAG,IAAI,CAAC,GAAG,SAAS,CAAC,CAa3E"}

package/dist/commands/mcp.command.js

@@ -1,10 +1,21 @@
 import { startMcpServer, } from '@shrkcrft/mcp-server';
 import { flagBool, flagNumber, flagString, resolveCwd, } from "../command-registry.js";
+import { PositionalMode } from "../dispatch/positional-mode.js";
 import { printError } from "../output/print-error.js";
 import { loadSurfaceContext } from "../surface/load-surface-context.js";
-import { buildSurfaceSummary, findCommandInSummary } from "../surface/surface-summary.js";
+import { surfaceRefusalFor } from "../surface/not-enabled-error.js";
+import { SurfaceRefusalReason } from "../surface/surface-refusal-reason.js";
+import { buildSurfaceSummary, findCommandInSummary, } from "../surface/surface-summary.js";
 export const mcpCommand = {
     name: 'mcp',
+    positionals: PositionalMode.None,
+    subverbs: [
+        {
+            name: 'serve',
+            description: 'Start the read-only MCP server (stdio, or --http).',
+            usage: 'shrk [--cwd <dir>] mcp serve [--verbose] [--watch] [--http] [--port <n>] [--host <h>]',
+        },
+    ],
     description: 'MCP server operations (subcommand required).',
     usage: 'shrk [--cwd <dir>] mcp serve [--verbose] [--watch] [--http] [--port <n>] [--host <h>]',
     async run(args) {
@@ -46,11 +57,16 @@ export const mcpCommand = {
  * enabled). Tools without `cliCommand` are always callable
  * (bootstrap MCP-only tools).
  *
+ * The same summary the CLI surface gate reads, so a tool whose sibling is a
+ * tool-maintenance command (`get_docs_check` → `docs check`) is refused
+ * outside SharkCraft's own repository, and one whose sibling a
+ * `surface.disabled` selector denies is refused too — with the CLI's reason.
+ *
  * Failure-soft: any error building the summary returns a no-op
  * resolver — the server stays open rather than failing closed on
  * unrelated issues.
  */
-async function buildMcpGateResolver(cwd) {
+export async function buildMcpGateResolver(cwd) {
     try {
         const { context } = await loadSurfaceContext({ cwd });
         const summary = buildSurfaceSummary(context);
@@ -60,15 +76,24 @@ async function buildMcpGateResolver(cwd) {
             const view = findCommandInSummary(summary, tool.cliCommand);
             if (!view || view.callable)
                 return null;
-            return {
-                command: tool.cliCommand,
-                reason: view.detail
-                    ? `Sibling CLI command \`${tool.cliCommand}\` is experimental: ${view.detail}.`
-                    : `Sibling CLI command \`${tool.cliCommand}\` is experimental and not enabled.`,
-            };
+            return { command: tool.cliCommand, reason: mcpGateReason(tool.cliCommand, view) };
         };
     }
     catch {
         return undefined;
     }
 }
+/** The refusal reason an MCP tool reports — the CLI gate's cause and remedy. */
+function mcpGateReason(cliCommand, view) {
+    const refusal = surfaceRefusalFor(view);
+    switch (refusal.reasonCode) {
+        case SurfaceRefusalReason.ToolMaintenance:
+            return `${refusal.reason} To run it anyway: ${refusal.enableCommand}`;
+        case SurfaceRefusalReason.Disabled:
+            return `${refusal.reason} To allow it again: ${refusal.enableCommand}`;
+        case SurfaceRefusalReason.Experimental:
+            return view.detail
+                ? `Sibling CLI command \`${cliCommand}\` is experimental: ${view.detail}.`
+                : `Sibling CLI command \`${cliCommand}\` is experimental and not enabled.`;
+    }
+}

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

@@ -1 +1 @@
-{"version":3,"file":"onboard.command.d.ts","sourceRoot":"","sources":["../../src/commands/onboard.command.ts"],"names":[],"mappings":"AA6CA,OAAO,EAML,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAGhC,eAAO,MAAM,cAAc,EAAE,eAwO5B,CAAC"}
+{"version":3,"file":"onboard.command.d.ts","sourceRoot":"","sources":["../../src/commands/onboard.command.ts"],"names":[],"mappings":"AA6CA,OAAO,EAML,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAIhC,eAAO,MAAM,cAAc,EAAE,eA4P5B,CAAC"}

package/dist/commands/onboard.command.js

@@ -2,9 +2,29 @@ import { existsSync, readFileSync, writeFileSync } from 'node:fs';
 import * as nodePath from 'node:path';
 import { AdoptionCategory, AdoptionCheckpointStatus, AdoptionKind, archivePreviousAdoptionOutputs, buildAdoptionCheck, buildAdoptionMergePreview, buildAdoptionReport, buildOnboardAdoptionDiff, buildOnboardingAdoptionPlan, buildOnboardingDiff, buildOnboardingPlan, computeAdoptionFreshness, evaluateAdoptionCheckpoint, hashDiffBody, importAgentRulesForOnboarding, inspectSharkcraft, readAdoptionCheckpoint, readAdoptionState, recordAdoptionCheckpoint, renderAdoptionMergePreviewHtml, renderAdoptionMergePreviewMarkdown, renderAdoptionMergePreviewText, renderAdoptionReportHtml, renderAdoptionReportJson, renderAdoptionReportMarkdown, renderAdoptionReportText, renderOnboardAdoptionDiff, renderOnboardingDiff, validatePatchTargets, writeAdoptionPatch, writeOnboardingDrafts, AdoptionCheckResult, AdoptionFreshnessStatus, } from '@shrkcrft/inspector';
 import { flagBool, flagNumber, flagString, flagList, resolveCwd, } from "../command-registry.js";
+import { PositionalMode } from "../dispatch/positional-mode.js";
 import { asJson, header, kv } from "../output/format-output.js";
 export const onboardCommand = {
     name: 'onboard',
+    positionals: PositionalMode.None,
+    subverbs: [
+        {
+            name: 'adopt',
+            description: 'Build / review / check the onboarding adoption plan (dry-run unless --write-patch).',
+            usage: 'shrk onboard adopt [status|regenerate|merge-preview|report|check|diff|review] [--confidence high|medium|low] [--include <kinds>] [--exclude <kinds>] [--dry-run|--write-patch] [--json]',
+            // An unknown token used to fall through to the adoption plan at exit 0.
+            positionals: PositionalMode.None,
+            subverbs: [
+                { name: 'status', description: 'Adoption status.', usage: 'shrk onboard adopt status [--json]' },
+                { name: 'regenerate', description: 'Regenerate the adoption drafts.', usage: 'shrk onboard adopt regenerate [options]' },
+                { name: 'merge-preview', description: 'Preview merging the drafts into the live config.', usage: 'shrk onboard adopt merge-preview [options]' },
+                { name: 'report', description: 'The adoption report.', usage: 'shrk onboard adopt report [options]' },
+                { name: 'check', description: 'Check the adoption state.', usage: 'shrk onboard adopt check [options]' },
+                { name: 'diff', description: 'Diff the adoption plan against the live config.', usage: 'shrk onboard adopt diff [options]' },
+                { name: 'review', description: 'Review the adoption plan.', usage: 'shrk onboard adopt review [--json]' },
+            ],
+        },
+    ],
     description: 'Analyze an existing repository and produce a SharkCraft onboarding plan (rules / paths / templates / boundaries / pipelines + readiness estimate). Default is dry-run; `--write-drafts` writes advisory drafts under sharkcraft/onboarding/ (never overwrites rules.ts / paths.ts / templates.ts). `--scaffold-templates` drafts runnable template bodies. `--import-agents` parses AGENTS.md / CLAUDE.md / .cursor/rules into a draft. `--diff` compares the plan against the live config.',
     usage: 'shrk [--cwd <dir>] onboard [--dry-run] [--write-drafts] [--scaffold-templates] [--import-agents] [--diff] [--preset <id>] [--json]',
     async run(args) {

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

@@ -1 +1 @@
-{"version":3,"file":"owners.command.d.ts","sourceRoot":"","sources":["../../src/commands/owners.command.ts"],"names":[],"mappings":"AASA,OAAO,EAKL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAQhC,eAAO,MAAM,iBAAiB,EAAE,eAoB/B,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,eAyBhC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,eAmDjC,CAAC"}
+{"version":3,"file":"owners.command.d.ts","sourceRoot":"","sources":["../../src/commands/owners.command.ts"],"names":[],"mappings":"AASA,OAAO,EAOL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAQhC,eAAO,MAAM,iBAAiB,EAAE,eAoB/B,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,eAyBhC,CAAC;AAIF,eAAO,MAAM,mBAAmB,EAAE,eA4DjC,CAAC"}

package/dist/commands/owners.command.js

@@ -1,7 +1,7 @@
 import { existsSync, readFileSync } from 'node:fs';
 import * as nodePath from 'node:path';
 import { impactFor, inspectSharkcraft, loadOwnershipRules, matchFile, readFeatureBundle, } from '@shrkcrft/inspector';
-import { flagBool, flagString, flagList, resolveCwd, } from "../command-registry.js";
+import { emptySelectionExit, flagBool, flagString, flagList, requireInputSelector, resolveCwd, } from "../command-registry.js";
 import { asJson, header } from "../output/format-output.js";
 function readOwnershipFiles(args) {
     const list = flagList(args, 'files');
@@ -55,11 +55,19 @@ export const ownersMatchCommand = {
         return 0;
     },
 };
+const OWNERS_IMPACT_USAGE = 'shrk owners impact --files a,b | --plan <plan.json> | --bundle <id>';
 export const ownersImpactCommand = {
     name: 'impact',
     description: 'Ownership impact for files / plan / bundle.',
-    usage: 'shrk owners impact --files a,b | --plan <plan.json> | --bundle <id>',
+    usage: OWNERS_IMPACT_USAGE,
     async run(args) {
+        // A required selector omitted is a usage error — never `(0 files)`, exit 0.
+        const noSelector = requireInputSelector(args, {
+            flags: ['files', 'plan', 'bundle'],
+            usage: OWNERS_IMPACT_USAGE,
+        });
+        if (noSelector !== null)
+            return noSelector;
         const cwd = resolveCwd(args);
         const inspection = await inspectSharkcraft({ cwd });
         const planFile = flagString(args, 'plan');
@@ -91,6 +99,10 @@ export const ownersImpactCommand = {
                         all.push(t);
             }
         }
+        // A selector that resolved to nothing (an empty plan, an unknown bundle)
+        // analysed nothing — 2, never `Ownership impact (0 files)`.
+        if (all.length === 0)
+            return emptySelectionExit(flagBool(args, 'json'));
         const cfg = inspection.config?.ownershipFiles;
         const { rules } = await loadOwnershipRules(cwd, cfg);
         const impact = impactFor([...new Set(all)], rules);

package/dist/commands/packs-new.d.ts

@@ -19,7 +19,19 @@ export interface IScaffoldPackResult {
     packageJson: Record<string, unknown>;
     packRoot: string;
 }
-/** Pure: compute the file set to write. No IO. */
+/**
+ * Pure: compute the file set to write. No IO.
+ *
+ * The scaffold is a VALID, discoverable, type-clean pack:
+ *   - `package.json` `sharkcraft.manifest` points at `src/sharkcraft.plugin.ts`
+ *     (discovery reads nothing else — without it the pack is INVALID);
+ *   - that file default-exports a real `ISharkCraftPackManifest` (`satisfies`,
+ *     with a TYPE-ONLY import, so there is no runtime plugin-api coupling);
+ *   - every asset it emits is declared in the manifest and non-empty (a file
+ *     the manifest does not list is never loaded — so none is emitted);
+ *   - every asset is annotated with `satisfies` against the SDK types, and
+ *     `tsc -p tsconfig.json` (noEmit) type-checks clean.
+ */
 export declare function planPackScaffold(input: IScaffoldPackInput): IScaffoldPackResult;
 export declare const packsNewCommand: ICommandHandler;
 export declare const packsTestCommand: ICommandHandler;

package/dist/commands/packs-new.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"packs-new.d.ts","sourceRoot":"","sources":["../../src/commands/packs-new.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAIhC,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,cAAc,GAAG,YAAY,CAAC;AAS/E,UAAU,aAAa;IACrB,0CAA0C;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,kDAAkD;AAClD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,kBAAkB,GAAG,mBAAmB,CAyG/E;AA0SD,eAAO,MAAM,eAAe,EAAE,eAoG7B,CAAC;AAUF,eAAO,MAAM,gBAAgB,EAAE,eAqI9B,CAAC"}
+{"version":3,"file":"packs-new.d.ts","sourceRoot":"","sources":["../../src/commands/packs-new.ts"],"names":[],"mappings":"AAkBA,OAAO,EAIL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAMhC,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,cAAc,GAAG,YAAY,CAAC;AAS/E,UAAU,aAAa;IACrB,0CAA0C;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAaD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,kBAAkB,GAAG,mBAAmB,CAwG/E;AAyTD,eAAO,MAAM,eAAe,EAAE,eAyG7B,CAAC;AA8CF,eAAO,MAAM,gBAAgB,EAAE,eAoP9B,CAAC"}