@shrkcrft/cli 0.1.0-alpha.11 → 0.1.0-alpha.13

package/dist/audit/templates-fix-plan.js

@@ -0,0 +1,174 @@
+const TEMPLATES_FILE = 'sharkcraft/templates.ts';
+export function buildFixPlan(report) {
+    const fixes = [];
+    const skipped = [];
+    for (const entry of report.templates) {
+        for (const f of entry.deterministicFindings) {
+            const out = dispatchDeterministic(entry, f);
+            if (out.kind === 'fix')
+                fixes.push(out.fix);
+            else
+                skipped.push(out.skip);
+        }
+        for (const f of entry.llmFindings) {
+            fixes.push(makeLlmFix(entry, f));
+        }
+    }
+    const summary = {
+        fixCount: fixes.length,
+        highConfidence: fixes.filter((f) => f.confidence === 'high').length,
+        mediumConfidence: fixes.filter((f) => f.confidence === 'medium').length,
+        lowConfidence: fixes.filter((f) => f.confidence === 'low').length,
+        skipped: skipped.length,
+    };
+    const generatedAt = new Date().toISOString();
+    return {
+        fixPlanId: `fix-${generatedAt.replace(/[:.]/g, '-')}`,
+        generatedAt,
+        auditId: report.auditId,
+        sourceFiles: [TEMPLATES_FILE],
+        fixes,
+        skipped,
+        summary,
+    };
+}
+function dispatchDeterministic(entry, f) {
+    switch (f.category) {
+        case 'unsafe-target':
+            return {
+                kind: 'skip',
+                skip: {
+                    templateId: entry.templateId,
+                    findingCategory: f.category,
+                    finding: f.message,
+                    reason: 'security-sensitive — requires human review',
+                },
+            };
+        case 'missing-name':
+            return makeFix(entry, f, 'high', 'Add a `name` field to this template.', [
+                `Open ${TEMPLATES_FILE}. Find the template literal with id "${entry.templateId}".`,
+                `Add a \`name: '<human-readable name>'\` field next to \`id\`.`,
+                `The name should briefly describe what the template scaffolds (e.g. "CLI command (shrk subcommand)").`,
+                `Do not change other fields. Verify the file still parses.`,
+            ].join('\n'));
+        case 'missing-description':
+            return makeFix(entry, f, 'high', 'Add a `description` field to this template.', [
+                `Open ${TEMPLATES_FILE}. Find the template literal with id "${entry.templateId}".`,
+                `Add a \`description: '<one-sentence description>'\` field. The description appears in \`shrk templates list\` and should explain what the template generates.`,
+                `Do not change other fields. Verify the file still parses.`,
+            ].join('\n'));
+        case 'related-id-unresolved': {
+            const id = extractQuoted(f.message);
+            if (!id) {
+                return makeFix(entry, f, 'medium', 'Remove an unresolved related id (id could not be auto-extracted from the message).', [
+                    `Open ${TEMPLATES_FILE}. Find the template literal with id "${entry.templateId}".`,
+                    `The finding is: "${f.message}"`,
+                    `Remove the unresolved related id from the \`related\` array. Do not invent a replacement; if no real id applies, leave the array empty or omit the field.`,
+                    `Verify the file still parses.`,
+                ].join('\n'));
+            }
+            return makeFix(entry, f, 'high', `Remove "${id}" from the \`related\` array.`, [
+                `Open ${TEMPLATES_FILE}. Find the template literal with id "${entry.templateId}".`,
+                `In its \`related\` array, remove the string "${id}". Do not change any other entries.`,
+                `Verify the file still parses and that "${id}" is not referenced elsewhere in the file.`,
+            ].join('\n'));
+        }
+        case 'undocumented-var': {
+            const varName = extractQuoted(f.message);
+            const where = varName ? `the variable named "${varName}"` : 'the variable referenced in the finding';
+            return makeFix(entry, f, 'medium', varName
+                ? `Add a description to variable "${varName}".`
+                : 'Add a description to an undocumented variable.', [
+                `Open ${TEMPLATES_FILE}. Find the template literal with id "${entry.templateId}".`,
+                `Locate ${where} inside the \`variables\` array.`,
+                `Add a \`description: '<short explanation>'\` field. The description should explain what the variable controls and where its value ends up in the generated output.`,
+                `Verify the file still parses.`,
+            ].join('\n'));
+        }
+        case 'required-var-no-example': {
+            const varName = extractQuoted(f.message);
+            const where = varName ? `the variable named "${varName}"` : 'the required variable referenced in the finding';
+            return makeFix(entry, f, 'medium', varName
+                ? `Add an example value to required variable "${varName}".`
+                : 'Add an example value to a required variable that lacks one.', [
+                `Open ${TEMPLATES_FILE}. Find the template literal with id "${entry.templateId}".`,
+                `Locate ${where} inside the \`variables\` array.`,
+                `Add an \`examples: ['<sample value>']\` field. Choose a sample that's representative of real usage — readable by humans, valid against any \`pattern\` that may also be defined.`,
+                `Verify the file still parses.`,
+            ].join('\n'));
+        }
+        case 'undeclared-var': {
+            const varName = extractPlaceholder(f.message);
+            const where = varName ? `\`{{${varName}}}\`` : 'the undeclared placeholder named in the finding';
+            return makeFix(entry, f, 'medium', varName
+                ? `Resolve undeclared placeholder ${where}.`
+                : 'Resolve an undeclared placeholder in the template body.', [
+                `Open ${TEMPLATES_FILE}. Find the template literal with id "${entry.templateId}".`,
+                `The template body uses placeholder ${where} that isn't declared in \`variables[]\`.`,
+                `Pick one:`,
+                `  (a) Add a corresponding entry to \`variables[]\` (with \`name\`, \`required\`, and ideally a \`description\` + \`examples\`). This is right if the placeholder represents intended user input.`,
+                `  (b) Remove the placeholder from the template body. This is right if it was a typo or leftover.`,
+                `Choose based on what the surrounding body and template description imply. Verify the file still parses.`,
+            ].join('\n'));
+        }
+        case 'path-no-convention': {
+            const samplePath = extractQuoted(f.message);
+            return makeFix(entry, f, 'low', samplePath
+                ? `Align template targetPath with path conventions (sample: "${samplePath}").`
+                : 'Align template targetPath with path conventions.', [
+                `The sample target path${samplePath ? ` "${samplePath}"` : ''} doesn't match any entry in \`sharkcraft/paths.ts\`.`,
+                `Decide between two fixes:`,
+                `  (a) Update the template's \`targetPath\` so its rendered output matches an existing path convention. Edit ${TEMPLATES_FILE}, find template "${entry.templateId}", and adjust its \`targetPath\` function/string.`,
+                `  (b) Add a matching entry to \`sharkcraft/paths.ts\` if this template's output really does belong in a new location.`,
+                `Prefer (a) unless the template represents a genuinely new file-shape for the project. Verify both files parse.`,
+            ].join('\n'));
+        }
+        default:
+            return makeFix(entry, f, 'low', `Address finding "${f.category}".`, [
+                `Open ${TEMPLATES_FILE}. Find the template literal with id "${entry.templateId}".`,
+                `The audit reported: ${f.message}`,
+                f.suggestion ? `Suggested fix from the inspector: ${f.suggestion}` : 'No specific suggestion was supplied — use judgment.',
+                `Apply a minimal change that resolves the finding without touching unrelated fields. Verify the file still parses.`,
+            ].filter(Boolean).join('\n'));
+    }
+}
+function makeFix(entry, f, confidence, intent, agentPrompt) {
+    return {
+        kind: 'fix',
+        fix: {
+            templateId: entry.templateId,
+            findingCategory: f.category,
+            finding: f.message,
+            severity: f.severity,
+            intent,
+            agentPrompt,
+            confidence,
+            source: 'deterministic',
+        },
+    };
+}
+function makeLlmFix(entry, f) {
+    return {
+        templateId: entry.templateId,
+        findingCategory: f.category,
+        finding: f.message,
+        severity: f.severity,
+        intent: `Review the LLM-flagged "${f.category}" finding and decide whether to act.`,
+        agentPrompt: [
+            `Open ${TEMPLATES_FILE}. Find the template literal with id "${entry.templateId}".`,
+            `An LLM critique flagged (confidence ${f.confidence.toFixed(2)}): ${f.message}`,
+            `LLM findings are advisory — verify against the template body and sibling templates before acting.`,
+            `If you choose to act, keep the change minimal and scoped to the finding. If you don't, that's also a valid outcome — record the decision in your response.`,
+        ].join('\n'),
+        confidence: 'low',
+        source: 'llm',
+    };
+}
+function extractQuoted(message) {
+    const m = message.match(/"([^"]+)"/);
+    return m ? m[1] : null;
+}
+function extractPlaceholder(message) {
+    const m = message.match(/\{\{\s*([A-Za-z_$][A-Za-z0-9_$]*)\s*\}\}/);
+    return m ? m[1] : null;
+}

package/dist/commands/ai-status.command.d.ts

@@ -0,0 +1,19 @@
+import { type ICommandHandler } from '../command-registry.js';
+/**
+ * `shrk ai-status` — one-shot self-check of the LLM wiring.
+ *
+ * Designed for agents (like Claude) that want to know whether shrk's
+ * LLM enrichment is going to do anything useful, without having to
+ * run a full audit. Three pieces of information:
+ *   1. Which provider, if any, the local-first walk would pick.
+ *   2. The structured `ai` block (the same one every audit emits) so
+ *      the agent can act on the hints.
+ *   3. Optional `--ping`: a tiny live request that proves the
+ *      provider really responds (the resolver only checks env vars).
+ *
+ * The deterministic baseline contract: works without LLM. With no
+ * provider reachable, the output is still useful — it carries the
+ * setup hints.
+ */
+export declare const aiStatusCommand: ICommandHandler;
+//# sourceMappingURL=ai-status.command.d.ts.map

package/dist/commands/ai-status.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-status.command.d.ts","sourceRoot":"","sources":["../../src/commands/ai-status.command.ts"],"names":[],"mappings":"AAOA,OAAO,EAIL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAGhC;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,eAAe,EAAE,eAkD7B,CAAC"}

package/dist/commands/ai-status.command.js

@@ -0,0 +1,94 @@
+import { AiMessageRole, buildAiBlock, renderAiBlockMarkdown, selectAiProvider, } from '@shrkcrft/ai';
+import { flagBool, flagNumber, flagString, } from "../command-registry.js";
+import { asJson, header, kv } from "../output/format-output.js";
+/**
+ * `shrk ai-status` — one-shot self-check of the LLM wiring.
+ *
+ * Designed for agents (like Claude) that want to know whether shrk's
+ * LLM enrichment is going to do anything useful, without having to
+ * run a full audit. Three pieces of information:
+ *   1. Which provider, if any, the local-first walk would pick.
+ *   2. The structured `ai` block (the same one every audit emits) so
+ *      the agent can act on the hints.
+ *   3. Optional `--ping`: a tiny live request that proves the
+ *      provider really responds (the resolver only checks env vars).
+ *
+ * The deterministic baseline contract: works without LLM. With no
+ * provider reachable, the output is still useful — it carries the
+ * setup hints.
+ */
+export const aiStatusCommand = {
+    name: 'ai-status',
+    description: 'Report which AI provider shrk would use right now, with setup or upgrade hints. `--ping` verifies the provider actually responds. Read-only.',
+    usage: 'shrk ai-status [--provider auto|ollama|llamacpp|claude|gemini] [--ping] [--ping-timeout <ms>] [--json]',
+    async run(args) {
+        const providerKind = flagString(args, 'provider');
+        const json = flagBool(args, 'json');
+        const wantPing = flagBool(args, 'ping');
+        const pingTimeoutMs = flagNumber(args, 'ping-timeout') ?? 8000;
+        const selection = selectAiProvider(providerKind);
+        const ai = buildAiBlock({ selection, userOptedOut: false });
+        let ping = null;
+        if (wantPing) {
+            ping = selection.provider
+                ? await pingProvider(selection.provider, pingTimeoutMs)
+                : { ok: false, reason: 'no provider reachable — nothing to ping', elapsedMs: 0 };
+        }
+        if (json) {
+            process.stdout.write(asJson({
+                ai,
+                ...(ping ? { ping } : {}),
+            }) + '\n');
+            return ai.reachable && (!ping || ping.ok) ? 0 : 1;
+        }
+        process.stdout.write(header('AI status'));
+        process.stdout.write(kv('reachable', ai.reachable ? 'yes' : 'no') + '\n');
+        process.stdout.write(kv('requested provider', ai.requestedProvider) + '\n');
+        process.stdout.write(kv('resolved provider', ai.providerId ?? '(none)') + '\n');
+        if (ping) {
+            process.stdout.write(kv('ping', ping.ok
+                ? `ok in ${ping.elapsedMs}ms` + (ping.model ? ` (model: ${ping.model})` : '')
+                : `failed: ${ping.reason}`) + '\n');
+        }
+        process.stdout.write('\n');
+        process.stdout.write(renderAiBlockMarkdown(ai));
+        return ai.reachable && (!ping || ping.ok) ? 0 : 1;
+    },
+};
+async function pingProvider(provider, timeoutMs) {
+    const start = Date.now();
+    // Tiny prompt with bounded output — we just want to prove the round-trip works.
+    const requestPromise = provider.send({
+        messages: [
+            { role: AiMessageRole.System, content: 'Respond with the single word: ok' },
+            { role: AiMessageRole.User, content: 'ping' },
+        ],
+        maxTokens: 8,
+    });
+    const timeoutPromise = new Promise((resolve) => {
+        setTimeout(() => resolve({ ok: false, error: new Error(`timed out after ${timeoutMs}ms`) }), timeoutMs);
+    });
+    try {
+        const res = (await Promise.race([requestPromise, timeoutPromise]));
+        const elapsedMs = Date.now() - start;
+        if (!('value' in res) || !res.ok) {
+            const reason = 'error' in res
+                ? res.error.message ?? String(res.error)
+                : 'no response';
+            return { ok: false, reason, elapsedMs };
+        }
+        const value = res.value;
+        return {
+            ok: true,
+            elapsedMs,
+            ...(value.model ? { model: value.model } : {}),
+        };
+    }
+    catch (e) {
+        return {
+            ok: false,
+            reason: e.message,
+            elapsedMs: Date.now() - start,
+        };
+    }
+}

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

@@ -1 +1 @@
-{"version":3,"file":"ask.command.d.ts","sourceRoot":"","sources":["../../src/commands/ask.command.ts"],"names":[],"mappings":"AAGA,OAAO,EAKL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAIhC,eAAO,MAAM,UAAU,EAAE,eA2DxB,CAAC"}
+{"version":3,"file":"ask.command.d.ts","sourceRoot":"","sources":["../../src/commands/ask.command.ts"],"names":[],"mappings":"AAOA,OAAO,EAKL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAIhC,eAAO,MAAM,UAAU,EAAE,eA6DxB,CAAC"}

package/dist/commands/ask.command.js

@@ -1,13 +1,13 @@
 import { inspectSharkcraft, buildProjectOverview, renderOverviewText } from '@shrkcrft/inspector';
 import { buildContext } from '@shrkcrft/context';
-import { ClaudeProvider, AiMessageRole, buildPromptMessages } from '@shrkcrft/ai';
+import { AiMessageRole, buildPromptMessages, selectAiProvider, } from '@shrkcrft/ai';
 import { flagBool, flagNumber, flagString, resolveCwd, } from "../command-registry.js";
 import { header } from "../output/format-output.js";
 import { printError } from "../output/print-error.js";
 export const askCommand = {
     name: 'ask',
-    description: 'Ask a question. Builds repository context, sends prompt to Claude (requires ANTHROPIC_API_KEY).',
-    usage: 'shrk ask "<question>" [--max-tokens 3000] [--model claude-sonnet-4-6] [--dry-run]',
+    description: 'Ask a question. Builds repository context, sends prompt to the local LLM (Ollama / llama.cpp).',
+    usage: 'shrk ask "<question>" [--max-tokens 3000] [--provider auto|ollama|llamacpp] [--model <id>] [--dry-run]',
     async run(args) {
         const question = args.positional.join(' ').trim();
         if (!question) {
@@ -16,6 +16,7 @@ export const askCommand = {
         }
         const maxTokens = flagNumber(args, 'max-tokens') ?? 3000;
         const model = flagString(args, 'model');
+        const providerKind = flagString(args, 'provider');
         const dryRun = flagBool(args, 'dry-run');
         const inspection = await inspectSharkcraft({ cwd: resolveCwd(args) });
         const overview = buildProjectOverview(inspection.workspace, inspection.config?.projectName);
@@ -36,14 +37,14 @@ export const askCommand = {
             }
             return 0;
         }
-        const provider = new ClaudeProvider();
-        if (model)
-            provider.configure({ model });
-        if (!provider.isReady()) {
-            process.stderr.write('ANTHROPIC_API_KEY is not set. Use --dry-run to print the prompt instead.\n');
+        const selection = selectAiProvider(providerKind);
+        if (!selection.provider) {
+            process.stderr.write('No local LLM is ready. Start Ollama (`ollama serve`) or set LLAMACPP_MODEL_PATH=/path/to/model.gguf in .env. Use --dry-run to print the prompt instead.\n');
             return 1;
         }
-        const res = await provider.send({
+        if (model)
+            selection.provider.configure({ model });
+        const res = await selection.provider.send({
             messages: [...messages, { role: AiMessageRole.User, content: question }],
             maxTokens: 1024,
             model,

package/dist/commands/command-catalog.d.ts.map

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

package/dist/commands/command-catalog.js

@@ -115,6 +115,16 @@ export const COMMAND_CATALOG = Object.freeze([
         intendedAudience: [CommandAudience.Human, CommandAudience.Agent, CommandAudience.Ci],
         taskRole: CommandTaskRole.Diagnose,
     }),
+    entry({
+        command: 'ai-status',
+        description: 'Report which AI provider shrk would use right now, with setup or upgrade hints. `--ping` verifies the provider actually responds.',
+        category: 'core',
+        safetyLevel: SafetyLevel.ReadOnly,
+        mcpAvailable: false,
+        surface: CommandSurface.Common,
+        intendedAudience: [CommandAudience.Human, CommandAudience.Agent],
+        taskRole: CommandTaskRole.Diagnose,
+    }),
     entry({
         command: 'context',
         description: 'Focused context for a task (rules / paths / templates). For "what should I do?" prefer `shrk recommend "<task>"`.',
@@ -256,7 +266,7 @@ export const COMMAND_CATALOG = Object.freeze([
     }),
     entry({
         command: 'graph',
-        description: 'Knowledge graph — nodes, edges, and shortest-path explanations.',
+        description: 'Knowledge graph plus code-intelligence subverbs (`index`, `status`, `search`, `context`, `impact`, `callers`, `cycles`, `unresolved`, `deps`, `why`, `export`).',
         category: 'core',
         safetyLevel: SafetyLevel.ReadOnly,
         mcpAvailable: true,
@@ -1182,6 +1192,104 @@ export const COMMAND_CATALOG = Object.freeze([
         category: 'core',
         safetyLevel: SafetyLevel.ReadOnly,
     }),
+    entry({
+        command: 'smart-context',
+        description: 'Build deterministic context and ask an AI provider to synthesise an enriched brief (default), structured plan (--plan), or two-stage development plan (--ai-plan). Opt-in; defaults to Gemini. CLAUDE.md is auto-included in the seed.',
+        category: 'core',
+        safetyLevel: SafetyLevel.ReadOnly,
+        taskRole: CommandTaskRole.Context,
+    }),
+    entry({
+        command: 'smart-context plan-ahead',
+        description: 'Batch-generate AI-backed plans for a queue of upcoming tasks and save each under .sharkcraft/smart-context/.',
+        category: 'core',
+        safetyLevel: SafetyLevel.ReadOnly,
+        taskRole: CommandTaskRole.Context,
+    }),
+    entry({
+        command: 'smart-context list',
+        description: 'List saved smart-context entries under .sharkcraft/smart-context/.',
+        category: 'core',
+        safetyLevel: SafetyLevel.ReadOnly,
+        taskRole: CommandTaskRole.Inspect,
+    }),
+    entry({
+        command: 'smart-context show',
+        description: 'Print a saved smart-context entry by slug.',
+        category: 'core',
+        safetyLevel: SafetyLevel.ReadOnly,
+        taskRole: CommandTaskRole.Inspect,
+    }),
+    entry({
+        command: 'smart-context embeddings-build',
+        description: 'Build or incrementally refresh the semantic file index used by smart-context. Downloads the embedding model on first run.',
+        category: 'core',
+        safetyLevel: SafetyLevel.WritesSessionOnly,
+        taskRole: CommandTaskRole.Context,
+    }),
+    entry({
+        command: 'smart-context embeddings-status',
+        description: 'Report semantic index freshness without loading the embedding model.',
+        category: 'core',
+        safetyLevel: SafetyLevel.ReadOnly,
+        taskRole: CommandTaskRole.Inspect,
+    }),
+    entry({
+        command: 'spike',
+        description: 'Scaffold starter files for a saved smart-context plan\'s recommended MVP. Reads .sharkcraft/smart-context/<slug>.plan.json.',
+        category: 'core',
+        safetyLevel: SafetyLevel.WritesSource,
+        taskRole: CommandTaskRole.Generate,
+    }),
+    entry({
+        command: 'deps-audit',
+        description: 'Compare declared package dependencies (package.json) with actually imported specifiers (graph). Reports missing + unused deps. Read-only.',
+        category: 'core',
+        safetyLevel: SafetyLevel.ReadOnly,
+        taskRole: CommandTaskRole.Inspect,
+    }),
+    entry({
+        command: 'scaffold-validate',
+        description: 'Validate that the files in a saved generation plan exist on disk and look intact (size envelope + type match). Read-only.',
+        category: 'core',
+        safetyLevel: SafetyLevel.ReadOnly,
+        taskRole: CommandTaskRole.Validate,
+    }),
+    entry({
+        command: 'move-plan',
+        description: 'Plan a file move: graph-traced importer rewrites, export touch-ups, cross-package warnings, rollback steps. Read-only.',
+        category: 'core',
+        safetyLevel: SafetyLevel.ReadOnly,
+        taskRole: CommandTaskRole.Generate,
+    }),
+    entry({
+        command: 'watch',
+        description: 'Emit a focused-context packet on stdout JSONL each time the workspace changes. Designed to feed a parallel Claude agent.',
+        category: 'core',
+        safetyLevel: SafetyLevel.WritesSessionOnly,
+        taskRole: CommandTaskRole.Context,
+    }),
+    entry({
+        command: 'watch list',
+        description: 'List active shrk-watch daemons (one per task slug).',
+        category: 'core',
+        safetyLevel: SafetyLevel.ReadOnly,
+        taskRole: CommandTaskRole.Inspect,
+    }),
+    entry({
+        command: 'watch stop',
+        description: 'Stop a running shrk-watch daemon by slug.',
+        category: 'core',
+        safetyLevel: SafetyLevel.WritesSessionOnly,
+        taskRole: CommandTaskRole.Config,
+    }),
+    entry({
+        command: 'watch prune',
+        description: 'Remove stale shrk-watch manifests whose owning processes are no longer alive.',
+        category: 'core',
+        safetyLevel: SafetyLevel.WritesSessionOnly,
+        taskRole: CommandTaskRole.Config,
+    }),
     entry({
         command: 'safety audit',
         description: 'Audit the SharkCraft safety model (commands, MCP, packs, plan signing).',
@@ -3251,6 +3359,7 @@ const PRIMARY_VERBS_ALLOWLIST = new Set([
     'search',
     'impact',
     'graph',
+    'code-intel',
     // Generate code safely
     'gen',
     'apply',

package/dist/commands/deps-audit.command.d.ts

@@ -0,0 +1,23 @@
+import { type ICommandHandler } from '../command-registry.js';
+/**
+ * `shrk deps-audit` — for each workspace package, compare the
+ * `package.json` `dependencies` / `devDependencies` / `peerDependencies`
+ * against the *specifiers actually imported* from source under
+ * `<pkg>/src/` (per the SharkCraft graph).
+ *
+ * Reports:
+ *   - missing deps: imported but not declared (likely build failure
+ *     in the wild — the package depends on its host's resolution)
+ *   - unused deps: declared but never imported (lint waste)
+ *
+ * Read-only. JSON output via `--json`. Optionally restricted to one
+ * package via `--package <name>`.
+ *
+ * Known limitations:
+ *   - Type-only imports (`import type x from 'y'`) still count; the
+ *     graph can't tell them apart in v3.
+ *   - Subpath imports (`pkg/sub`) are reduced to their root specifier.
+ *   - Built-in node modules (`node:fs`, `fs`, …) are ignored.
+ */
+export declare const depsAuditCommand: ICommandHandler;
+//# sourceMappingURL=deps-audit.command.d.ts.map

package/dist/commands/deps-audit.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deps-audit.command.d.ts","sourceRoot":"","sources":["../../src/commands/deps-audit.command.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAmBhC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,gBAAgB,EAAE,eAmE9B,CAAC"}