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

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

@@ -256,7 +256,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 +1182,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 +3349,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"}

package/dist/commands/deps-audit.command.js

@@ -0,0 +1,266 @@
+import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
+import * as nodePath from 'node:path';
+import { GraphQueryApi, GraphStore, NodeKind } from '@shrkcrft/graph';
+import { flagBool, resolveCwd, } from "../command-registry.js";
+import { asJson, header } from "../output/format-output.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 const depsAuditCommand = {
+    name: 'deps-audit',
+    description: 'Audit declared dependencies vs imports actually seen in each package source. Reports missing + unused deps. Read-only.',
+    usage: 'shrk deps-audit [--package <name>] [--json]',
+    async run(args) {
+        const cwd = resolveCwd(args);
+        const json = flagBool(args, 'json');
+        const onlyPackage = typeof args.flags.get('package') === 'string'
+            ? args.flags.get('package')
+            : null;
+        const store = new GraphStore(cwd);
+        if (!store.exists()) {
+            process.stderr.write('No SharkCraft graph found. Run `shrk graph build` first so deps-audit has import data.\n');
+            return 1;
+        }
+        const api = GraphQueryApi.fromStore(cwd);
+        const packages = listWorkspacePackages(cwd, onlyPackage);
+        if (packages.length === 0) {
+            process.stderr.write('No packages found (looked under packages/*, libs/*, apps/*).\n');
+            return 1;
+        }
+        const reports = [];
+        for (const pkg of packages) {
+            reports.push(buildPackageReport(api, cwd, pkg));
+        }
+        if (json) {
+            process.stdout.write(asJson({ packages: reports }) + '\n');
+            return 0;
+        }
+        let missingTotal = 0;
+        let unusedTotal = 0;
+        for (const r of reports) {
+            missingTotal += r.missingDeps.length;
+            unusedTotal += r.unusedDeps.length;
+        }
+        process.stdout.write(header(`deps-audit — ${reports.length} package(s), ${missingTotal} missing dep(s), ${unusedTotal} unused dep(s)`));
+        for (const r of reports) {
+            if (r.missingDeps.length === 0 && r.unusedDeps.length === 0)
+                continue;
+            process.stdout.write(`\n${r.packageName} (${r.packageDir})\n`);
+            if (r.missingDeps.length > 0) {
+                process.stdout.write('  missing (imported, not declared):\n');
+                for (const m of r.missingDeps) {
+                    process.stdout.write(`    - ${m.specifier} (imported ${m.importedFromCount}×)\n`);
+                }
+            }
+            if (r.unusedDeps.length > 0) {
+                process.stdout.write('  unused (declared, never imported):\n');
+                for (const u of r.unusedDeps) {
+                    process.stdout.write(`    - ${u.specifier}  [${u.section}]\n`);
+                }
+            }
+        }
+        if (missingTotal === 0 && unusedTotal === 0) {
+            process.stdout.write('\nAll declared deps match actual imports. ✓\n');
+        }
+        return 0;
+    },
+};
+function listWorkspacePackages(cwd, onlyName) {
+    const roots = ['packages', 'libs', 'apps'].map((r) => nodePath.join(cwd, r)).filter((d) => existsSync(d));
+    const out = [];
+    for (const root of roots) {
+        let entries;
+        try {
+            entries = readdirSync(root);
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            const dir = nodePath.join(root, entry);
+            let stat;
+            try {
+                stat = statSync(dir);
+            }
+            catch {
+                continue;
+            }
+            if (!stat.isDirectory())
+                continue;
+            const pkgJsonPath = nodePath.join(dir, 'package.json');
+            if (!existsSync(pkgJsonPath))
+                continue;
+            let pkgJson;
+            try {
+                pkgJson = JSON.parse(readFileSync(pkgJsonPath, 'utf8'));
+            }
+            catch {
+                continue;
+            }
+            if (!pkgJson.name)
+                continue;
+            if (onlyName !== null && pkgJson.name !== onlyName)
+                continue;
+            out.push({ name: pkgJson.name, dir, pkgJsonPath });
+        }
+    }
+    return out;
+}
+function buildPackageReport(api, cwd, pkg) {
+    const declared = readDeclaredDeps(pkg.pkgJsonPath);
+    const importedSpecifiers = collectImportedSpecifiersForPackage(api, cwd, pkg.dir);
+    // Count how many distinct files inside the package import each specifier.
+    const importerCounts = new Map();
+    for (const spec of importedSpecifiers) {
+        importerCounts.set(spec, (importerCounts.get(spec) ?? 0) + 1);
+    }
+    const distinctImported = new Set(importedSpecifiers);
+    const declaredAll = new Map();
+    const declaredSections = [
+        ['dependencies', declared.dependencies],
+        ['devDependencies', declared.devDependencies],
+        ['peerDependencies', declared.peerDependencies],
+        ['optionalDependencies', declared.optionalDependencies],
+    ];
+    for (const [section, map] of declaredSections) {
+        for (const k of Object.keys(map))
+            declaredAll.set(k, section);
+    }
+    const missingDeps = [];
+    for (const spec of distinctImported) {
+        if (declaredAll.has(spec))
+            continue;
+        if (spec === pkg.name)
+            continue; // self-import via package name
+        missingDeps.push({ specifier: spec, importedFromCount: importerCounts.get(spec) ?? 0 });
+    }
+    missingDeps.sort((a, b) => b.importedFromCount - a.importedFromCount);
+    const unusedDeps = [];
+    for (const [spec, section] of declaredAll.entries()) {
+        if (distinctImported.has(spec))
+            continue;
+        // devDependencies for build/test tools often don't show up in graph
+        // imports; we still report them so the user can prune if desired.
+        unusedDeps.push({ specifier: spec, section });
+    }
+    unusedDeps.sort((a, b) => a.specifier.localeCompare(b.specifier));
+    return {
+        packageName: pkg.name,
+        packageDir: nodePath.relative(cwd, pkg.dir) || '.',
+        declared,
+        importedSpecifiers: [...distinctImported],
+        missingDeps,
+        unusedDeps,
+    };
+}
+function readDeclaredDeps(pkgJsonPath) {
+    try {
+        const body = JSON.parse(readFileSync(pkgJsonPath, 'utf8'));
+        return {
+            dependencies: asStringMap(body['dependencies']),
+            devDependencies: asStringMap(body['devDependencies']),
+            peerDependencies: asStringMap(body['peerDependencies']),
+            optionalDependencies: asStringMap(body['optionalDependencies']),
+        };
+    }
+    catch {
+        return { dependencies: {}, devDependencies: {}, peerDependencies: {}, optionalDependencies: {} };
+    }
+}
+function asStringMap(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return {};
+    const out = {};
+    for (const [k, v] of Object.entries(value)) {
+        if (typeof v === 'string')
+            out[k] = v;
+    }
+    return out;
+}
+function collectImportedSpecifiersForPackage(api, cwd, packageDir) {
+    const out = [];
+    const relDir = nodePath.relative(cwd, packageDir).replace(/\\/g, '/');
+    for (const file of api.allFiles()) {
+        if (file.kind !== NodeKind.File)
+            continue;
+        const p = file.path ?? '';
+        if (!p.startsWith(relDir + '/src/') && !p.startsWith(relDir + '/'))
+            continue;
+        // Each ImportsFile edge resolves to a file node; we want the *raw*
+        // import specifier, which the graph carries on the edge's data
+        // payload. We don't have direct access here, so we approximate by
+        // reading the file contents and extracting from-clauses.
+        const abs = nodePath.isAbsolute(p) ? p : nodePath.join(cwd, p);
+        if (!existsSync(abs))
+            continue;
+        let body;
+        try {
+            body = readFileSync(abs, 'utf8');
+        }
+        catch {
+            continue;
+        }
+        for (const spec of extractRootSpecifiers(body)) {
+            if (isBuiltinModule(spec))
+                continue;
+            if (spec.startsWith('.') || spec.startsWith('/'))
+                continue; // relative
+            out.push(rootOfSpecifier(spec));
+        }
+    }
+    return out;
+}
+const IMPORT_FROM_RE = /(?:^|\n)\s*(?:import|export)\s+[^;]*?\s+from\s+['"]([^'"]+)['"]/g;
+const REQUIRE_RE = /\brequire\(\s*['"]([^'"]+)['"]\s*\)/g;
+const DYNAMIC_IMPORT_RE = /\bimport\s*\(\s*['"]([^'"]+)['"]\s*\)/g;
+function extractRootSpecifiers(body) {
+    const out = [];
+    for (const m of body.matchAll(IMPORT_FROM_RE)) {
+        if (m[1])
+            out.push(m[1]);
+    }
+    for (const m of body.matchAll(REQUIRE_RE)) {
+        if (m[1])
+            out.push(m[1]);
+    }
+    for (const m of body.matchAll(DYNAMIC_IMPORT_RE)) {
+        if (m[1])
+            out.push(m[1]);
+    }
+    return out;
+}
+function rootOfSpecifier(spec) {
+    if (spec.startsWith('@')) {
+        const parts = spec.split('/');
+        return parts.length >= 2 ? `${parts[0]}/${parts[1]}` : spec;
+    }
+    return spec.split('/')[0];
+}
+function isBuiltinModule(spec) {
+    if (spec.startsWith('node:'))
+        return true;
+    // Common bare-name builtins.
+    return new Set([
+        'fs', 'path', 'os', 'crypto', 'http', 'https', 'url', 'util', 'stream',
+        'events', 'child_process', 'process', 'buffer', 'querystring', 'zlib',
+        'tls', 'net', 'dns', 'dgram', 'cluster', 'worker_threads', 'perf_hooks',
+        'readline', 'tty', 'vm',
+    ]).has(spec);
+}

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

@@ -1 +1 @@
-{"version":3,"file":"doctor.command.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.command.ts"],"names":[],"mappings":"AAqBA,OAAO,EAML,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AA0JhC,eAAO,MAAM,aAAa,EAAE,eAW3B,CAAC;AA+bF,eAAO,MAAM,qBAAqB,EAAE,eAmCnC,CAAC;AAuDF,eAAO,MAAM,yBAAyB,EAAE,eAavC,CAAC;AAIF,eAAO,MAAM,wBAAwB,EAAE,eA2CtC,CAAC;AAgCF,eAAO,MAAM,6BAA6B,EAAE,eAa3C,CAAC"}
+{"version":3,"file":"doctor.command.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.command.ts"],"names":[],"mappings":"AAqBA,OAAO,EAML,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAyOhC,eAAO,MAAM,aAAa,EAAE,eAW3B,CAAC;AA+bF,eAAO,MAAM,qBAAqB,EAAE,eAmCnC,CAAC;AAuDF,eAAO,MAAM,yBAAyB,EAAE,eAavC,CAAC;AAIF,eAAO,MAAM,wBAAwB,EAAE,eA2CtC,CAAC;AAgCF,eAAO,MAAM,6BAA6B,EAAE,eAa3C,CAAC"}

package/dist/commands/doctor.command.js

@@ -5,6 +5,7 @@ import { buildSurfaceSummary } from "../surface/surface-summary.js";
 import { renderShapeLine } from "../surface/shape-defaults.js";
 import { existsSync } from 'node:fs';
 import { flagBool, flagNumber, flagString, flagList, resolveCwd, } from "../command-registry.js";
+import { SemanticIndex, listIndexableFiles } from '@shrkcrft/embeddings';
 import { asJson, header, kv } from "../output/format-output.js";
 import { maybeRunInWatchMode } from "../output/watch-loop.js";
 import { doctorHints, renderFailureHints } from "../output/failure-hints.js";
@@ -139,6 +140,64 @@ function isBlockerCheck(check) {
 async function runDoctorOnce(args) {
     return doctorCommandImpl(args);
 }
+function augmentWithSemanticIndexCheck(result, cwd) {
+    const current = listIndexableFiles(cwd, 5000);
+    const report = SemanticIndex.freshnessReport(cwd, current);
+    const check = renderSemanticIndexCheck(report);
+    const checks = [...result.checks, check];
+    const summary = { ...result.summary };
+    if (check.severity === DoctorSeverity.Ok)
+        summary.ok = (summary.ok ?? 0) + 1;
+    else if (check.severity === DoctorSeverity.Info)
+        summary.info = (summary.info ?? 0) + 1;
+    else if (check.severity === DoctorSeverity.Warning)
+        summary.warnings = (summary.warnings ?? 0) + 1;
+    else if (check.severity === DoctorSeverity.Error)
+        summary.errors = (summary.errors ?? 0) + 1;
+    return { ...result, checks, summary };
+}
+function renderSemanticIndexCheck(report) {
+    if (!report.hasIndex) {
+        return {
+            id: 'semantic-index-missing',
+            title: 'Semantic embedding index',
+            severity: DoctorSeverity.Info,
+            message: `No semantic index found — ${report.untracked} indexable files on disk. ` +
+                'Run `shrk smart-context embeddings-build` to enable embedding-backed retrieval in smart-context.',
+            category: 'semantic-index',
+        };
+    }
+    if (report.corrupt) {
+        return {
+            id: 'semantic-index-corrupt',
+            title: 'Semantic embedding index',
+            severity: DoctorSeverity.Error,
+            message: 'Semantic index meta is corrupt.',
+            fix: 'shrk smart-context embeddings-build --rebuild',
+            category: 'semantic-index',
+        };
+    }
+    const driftCount = report.stale + report.missing + report.untracked;
+    const driftPct = report.indexed > 0 ? (driftCount * 100) / report.indexed : 0;
+    if (driftCount === 0) {
+        return {
+            id: 'semantic-index-fresh',
+            title: 'Semantic embedding index',
+            severity: DoctorSeverity.Ok,
+            message: `Index fresh — ${report.indexed} files (model ${report.model}).`,
+            category: 'semantic-index',
+        };
+    }
+    const severity = driftPct >= 10 ? DoctorSeverity.Warning : DoctorSeverity.Info;
+    return {
+        id: 'semantic-index-stale',
+        title: 'Semantic embedding index',
+        severity,
+        message: `${report.indexed} indexed; ${report.stale} stale, ${report.missing} deleted, ${report.untracked} new on disk (≈ ${Math.round(driftPct)}% drift).`,
+        fix: 'shrk smart-context embeddings-build',
+        category: 'semantic-index',
+    };
+}
 export const doctorCommand = {
     name: 'doctor',
     description: 'Validate the local SharkCraft setup (config, knowledge, templates, project). `--focus errors|warnings-new|info`, `--hide <category,...>`, `--quiet-known` filter the headline view using `sharkcraft/doctor.suppressions.json`. `--watch`/`--once`/`--debounce` for live mode. `--explain-quality` shows the per-warning "why this matters" line so warnings stop being permanent yellow noise. `--blockers` shows only must-fix findings (errors + warning-category in {config-invalid, pack-signature-invalid, plan-signature-divergent, asset-load-failed}); exit code is non-zero iff a blocker remains. Subcommands: `suppress`, `suppressions list|check`, `watch`.',
@@ -163,7 +222,7 @@ async function doctorCommandImpl(args) {
         inspectOpts.loaderTimeoutMs = loaderTimeout;
     }
     const inspection = await inspectSharkcraft(inspectOpts);
-    const result = runDoctor(inspection);
+    const result = augmentWithSemanticIndexCheck(runDoctor(inspection), cwd);
     const report = buildAiReadinessReport(inspection);
     if (debug) {
         process.stderr.write(`[debug] inspection elapsed ${inspection.inspectionElapsedMs}ms cache=${inspection.cacheEnabled ? 'on' : 'off'} loaders=${inspection.loaderDiagnostics.length}\n`);

package/dist/commands/graph-code-subverbs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph-code-subverbs.d.ts","sourceRoot":"","sources":["../../src/commands/graph-code-subverbs.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAoC,KAAK,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAQ3F,wBAAsB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAgBrE;AA4FD,wBAAsB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CA+DtE;AAiBD,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAwF1E;AAID,wBAAsB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAmEpE;AAID,wBAAsB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CA+DtE;AAID,wBAAsB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAkCtE;AAID,wBAAsB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CA6HvE;AAID,wBAAsB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAwFtE;AAID,wBAAsB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAuCvE"}
+{"version":3,"file":"graph-code-subverbs.d.ts","sourceRoot":"","sources":["../../src/commands/graph-code-subverbs.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAoC,KAAK,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAQ3F,wBAAsB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAgBrE;AA4FD,wBAAsB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CA+DtE;AAiBD,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAwF1E;AAID,wBAAsB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAmEpE;AAID,wBAAsB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAiEtE;AAID,wBAAsB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAgDtE;AAID,wBAAsB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAsJvE;AAID,wBAAsB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAwFtE;AAID,wBAAsB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAuCvE"}