@shrkcrft/cli 0.1.0-alpha.17 → 0.1.0-alpha.18

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

@@ -1 +1 @@
-{"version":3,"file":"graph.command.d.ts","sourceRoot":"","sources":["../../src/commands/graph.command.ts"],"names":[],"mappings":"AAUA,OAAO,EAIL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AA0BhC,eAAO,MAAM,YAAY,EAAE,eA2M1B,CAAC"}
+{"version":3,"file":"graph.command.d.ts","sourceRoot":"","sources":["../../src/commands/graph.command.ts"],"names":[],"mappings":"AAUA,OAAO,EAIL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AA4BhC,eAAO,MAAM,YAAY,EAAE,eA+M1B,CAAC"}

package/dist/commands/graph.command.js

@@ -3,7 +3,7 @@ import * as nodePath from 'node:path';
 import { analyzeImportGraph, buildKnowledgeGraph, findGraphPath, getGraphNode, inspectSharkcraft, } from '@shrkcrft/inspector';
 import { flagBool, flagString, resolveCwd, } from "../command-registry.js";
 import { asJson, header, kv } from "../output/format-output.js";
-import { runGraphCallers, runGraphContext, runGraphCycles, runGraphDeps, runGraphImpact, runGraphIndex, runGraphSearch, runGraphStatus, runGraphUnresolved, } from "./graph-code-subverbs.js";
+import { runGraphCallers, runGraphContext, runGraphCycles, runGraphDeps, runGraphHubs, runGraphImpact, runGraphIndex, runGraphPath, runGraphSearch, runGraphStatus, runGraphUnresolved, } from "./graph-code-subverbs.js";
 const KNOWN_KINDS = [
     'knowledge',
     'rule',
@@ -17,9 +17,11 @@ const KNOWN_KINDS = [
 ];
 export const graphCommand = {
     name: 'graph',
-    description: 'Show the SharkCraft knowledge graph and the code-intelligence graph surface. Use `shrk graph <id>` for asset-graph nodes and `shrk graph index|status|search|context|impact|callers|cycles|unresolved|deps|why|export` for code-graph workflows.',
+    description: 'Show the SharkCraft knowledge graph and the code-intelligence graph surface. Use `shrk graph <id>` for asset-graph nodes and `shrk graph index|status|search|context|impact|path|hubs|callers|cycles|unresolved|deps|why|export` for code-graph workflows.',
     usage: 'shrk [--cwd <dir>] graph [<id>] [--type <kind>] [--format text|json|dot|mermaid] [--output <file>] [--json]\n' +
-        'shrk graph index|status|search|context|impact|callers|cycles|unresolved|deps|why|export ...',
+        'shrk graph index|status|search|context|impact|path|hubs|callers|cycles|unresolved|deps|why|export ...\n' +
+        'shrk graph path <from> <to>   — is code A wired to code B? (shortest import/call path)\n' +
+        'shrk graph hubs [--limit N] [--path <dir>]   — most-depended-on symbols/files (load-bearing code; scope to a subsystem)',
     async run(args) {
         // Code-intelligence subverbs (R65) don't need the knowledge graph —
         // dispatch them before the expensive inspection so they stay fast.
@@ -34,6 +36,10 @@ export const graphCommand = {
             return runGraphContext(args);
         if (earlySub === 'impact')
             return runGraphImpact(args);
+        if (earlySub === 'path')
+            return runGraphPath(args);
+        if (earlySub === 'hubs')
+            return runGraphHubs(args);
         if (earlySub === 'callers')
             return runGraphCallers(args);
         if (earlySub === 'cycles')

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

@@ -48,7 +48,7 @@ export const movePlanCommand = {
         }
         const store = new GraphStore(cwd);
         if (!store.exists()) {
-            process.stderr.write('No SharkCraft graph found. Run `shrk graph build` so move-plan can trace importers.\n');
+            process.stderr.write('No SharkCraft graph found. Run `shrk graph index` so move-plan can trace importers.\n');
             return 1;
         }
         const api = GraphQueryApi.fromStore(cwd);

package/dist/commands/smart-context.command.d.ts

@@ -1,21 +1,4 @@
 import { type ICommandHandler } from '../command-registry.js';
-/**
- * Gemini-backed context enrichment.
- *
- * Sits next to `shrk ask` as an explicit, opt-in AI surface — the
- * deterministic engine (`shrk context`, `shrk brief`, MCP tools) stays
- * AI-free. See docs/smart-context.md and the
- * `.claude/skills/shrk-smart-context/` skill for the agent workflow.
- *
- * Verbs:
- *   - `smart-context "<task>"`               — single brief (default).
- *   - `smart-context "<task>" --plan`        — single structured plan.
- *   - `smart-context "<task>" --ai-plan`     — two-stage AI-assisted plan.
- *   - `smart-context "<task>" --save`        — persist under .sharkcraft/smart-context/.
- *   - `smart-context plan-ahead "t1" "t2"`   — batch-save plans for an upcoming queue.
- *   - `smart-context list`                   — list saved entries.
- *   - `smart-context show <slug>`            — print a saved entry.
- */
 export declare const smartContextCommand: ICommandHandler;
 /** `shrk smart-context plan-ahead "task1" "task2" ...` — batch-saves plans. */
 export declare const smartContextPlanAheadCommand: ICommandHandler;
@@ -55,4 +38,30 @@ export declare const smartContextAuditPipelinesCommand: ICommandHandler;
 export declare const smartContextEmbeddingsBuildCommand: ICommandHandler;
 /** `shrk smart-context embeddings-status` — freshness report (no model load). */
 export declare const smartContextEmbeddingsStatusCommand: ICommandHandler;
+interface IIndexFreshness {
+    /** Files currently in the semantic index. */
+    indexed: number;
+    /** stale + missing + untracked — how far the index is behind the working tree. */
+    behind: number;
+    stale: number;
+    missing: number;
+    untracked: number;
+    /** True when this run refreshed the index inline (--refresh or under the auto cap). */
+    refreshed: boolean;
+    /**
+     * Deleted-file suggestions DROPPED from this query's results — a stale index
+     * returned hits for files no longer on disk; they were pruned before the agent
+     * ever saw them. Present (and > 0) only when the prune actually fired.
+     */
+    prunedDeleted?: number;
+    /** Command to bring the index current, when it is still behind. */
+    nextCommand?: string;
+}
+/**
+ * Render the one-line freshness warning for a stale semantic index — including
+ * how many deleted-file suggestions were dropped from the results this query.
+ * Returns null when the index is current (no noise). Pure + testable.
+ */
+export declare function renderIndexFreshnessWarning(f: IIndexFreshness | undefined): string | null;
+export {};
 //# sourceMappingURL=smart-context.command.d.ts.map

package/dist/commands/smart-context.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"smart-context.command.d.ts","sourceRoot":"","sources":["../../src/commands/smart-context.command.ts"],"names":[],"mappings":"AAyBA,OAAO,EAML,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAyDhC;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,mBAAmB,EAAE,eA6LjC,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,4BAA4B,EAAE,eAmF1C,CAAC;AAEF,sDAAsD;AACtD,eAAO,MAAM,uBAAuB,EAAE,eAwBrC,CAAC;AAEF,8DAA8D;AAC9D,eAAO,MAAM,uBAAuB,EAAE,eAkCrC,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,iCAAiC,EAAE,eAmH/C,CAAC;AA2JF;;;;;;;GAOG;AACH,eAAO,MAAM,iCAAiC,EAAE,eAoH/C,CAAC;AA2JF;;;;;;GAMG;AACH,eAAO,MAAM,iCAAiC,EAAE,eAgG/C,CAAC;AAyPF,4EAA4E;AAC5E,eAAO,MAAM,kCAAkC,EAAE,eAuHhD,CAAC;AAMF,iFAAiF;AACjF,eAAO,MAAM,mCAAmC,EAAE,eAsCjD,CAAC"}
+{"version":3,"file":"smart-context.command.d.ts","sourceRoot":"","sources":["../../src/commands/smart-context.command.ts"],"names":[],"mappings":"AAyBA,OAAO,EAML,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAmFhC,eAAO,MAAM,mBAAmB,EAAE,eAuNjC,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,4BAA4B,EAAE,eAmF1C,CAAC;AAEF,sDAAsD;AACtD,eAAO,MAAM,uBAAuB,EAAE,eAwBrC,CAAC;AAEF,8DAA8D;AAC9D,eAAO,MAAM,uBAAuB,EAAE,eAkCrC,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,iCAAiC,EAAE,eAmH/C,CAAC;AA2JF;;;;;;;GAOG;AACH,eAAO,MAAM,iCAAiC,EAAE,eAoH/C,CAAC;AA2JF;;;;;;GAMG;AACH,eAAO,MAAM,iCAAiC,EAAE,eAgG/C,CAAC;AAyPF,4EAA4E;AAC5E,eAAO,MAAM,kCAAkC,EAAE,eAuHhD,CAAC;AAMF,iFAAiF;AACjF,eAAO,MAAM,mCAAmC,EAAE,eAsCjD,CAAC;AAqJF,UAAU,eAAe;IACvB,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,uFAAuF;IACvF,SAAS,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,CAAC,EAAE,eAAe,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAWzF"}

package/dist/commands/smart-context.command.js

@@ -7,7 +7,7 @@ import { buildContext } from '@shrkcrft/context';
 import { EdgeKind, GraphQueryApi, GraphStore, NodeKind } from '@shrkcrft/graph';
 import { buildProjectOverview, buildTaskPacket, inspectSharkcraft, renderOverviewText, } from '@shrkcrft/inspector';
 import { flagBool, flagList, flagNumber, flagString, resolveCwd, } from "../command-registry.js";
-import { DeclarationKind, PLAN_CACHE_SCHEMA, PlanCache, SemanticIndex, TaskType, buildFocusedContext, classifyTask, encodeEmbedding, getDefaultSourceRoots, listIndexableFiles, parseTaskTypeOverride, renderFocusedContextForPrompt, } from '@shrkcrft/embeddings';
+import { DeclarationKind, PLAN_CACHE_SCHEMA, PlanCache, SemanticIndex, TaskType, buildFocusedContext, classifyTask, encodeEmbedding, getDefaultSourceRoots, listIndexableFiles, parseTaskTypeOverride, pruneDeletedHits, renderFocusedContextForPrompt, } from '@shrkcrft/embeddings';
 import { SmartContextDetailedPlanSchema, SmartContextExpansionRequestSchema, } from "../schemas/json-schemas.js";
 import { asJson, header, kv } from "../output/format-output.js";
 import { printError } from "../output/print-error.js";
@@ -40,8 +40,16 @@ const SMART_CONTEXT_DIR = nodePath.join('.sharkcraft', 'smart-context');
  *   - `smart-context list`                   — list saved entries.
  *   - `smart-context show <slug>`            — print a saved entry.
  */
+const SMART_CONTEXT_BOOLEAN_FLAGS = new Set([
+    'ai-plan', 'brief', 'debug', 'dry-run', 'enhance', 'fix-plan', 'focused',
+    'json', 'log-prompt', 'no-cache', 'no-enhance', 'no-instructions',
+    'no-polish', 'no-refresh-index', 'no-stale-check', 'only-plan', 'plan',
+    'plus', 'rebuild', 'refresh', 'save', 'save-conversation', 'stream',
+    'tiny-only',
+]);
 export const smartContextCommand = {
     name: 'smart-context',
+    booleanFlags: SMART_CONTEXT_BOOLEAN_FLAGS,
     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).',
     usage: 'shrk smart-context "<task>" [--plus] [--budget <seconds>] [--plan] [--ai-plan] [--save] [--provider auto|ollama|llamacpp] [--enhance|--no-enhance] [--enhance-passes N] [--instructions <path>] [--no-instructions] [--model <id>] [--max-tokens N] [--stage1-max-tokens N] [--seed-tokens N] [--expansion-tokens N] [--expansion-limit N] [--log-prompt] [--save-conversation[=<path>]] [--dry-run] [--debug] [--json]',
     async run(args) {
@@ -173,8 +181,31 @@ export const smartContextCommand = {
             model: opts.model,
         });
         if (!aiResult.ok) {
-            printError(aiResult.error);
-            return 1;
+            // Deterministic-always contract (CLAUDE.md): a provider failure must
+            // still return the deterministic seed brief and exit 0 — not nothing on
+            // exit 1. The agent that asked for fast grounding still gets usable
+            // rules / paths / templates / candidate files. The error is advisory on
+            // stderr (never stdout, so --json stays valid).
+            process.stderr.write('[smart-context] provider unavailable — returning deterministic context only.\n');
+            const fallbackEnvelope = buildEnvelope({
+                task,
+                seed,
+                ai: {
+                    content: renderSeed(seed),
+                    model: 'deterministic',
+                    finishReason: 'deterministic-fallback',
+                    usage: null,
+                    providerId: 'deterministic',
+                },
+                mode: opts.mode,
+            });
+            if (opts.save) {
+                const saved = saveEnvelope(cwd, fallbackEnvelope);
+                writeSavedNotice(saved, opts.json, fallbackEnvelope);
+                return 0;
+            }
+            writeEnvelope(fallbackEnvelope, opts.json, opts.debug);
+            return 0;
         }
         if (opts.saveConversation) {
             const path = writeConversationFile({
@@ -1340,6 +1371,7 @@ function readCommonOptions(args) {
         ...(flagString(args, 'instructions') ? { instructionsPath: flagString(args, 'instructions') } : {}),
         noInstructions: flagBool(args, 'no-instructions'),
         noRefreshIndex: flagBool(args, 'no-refresh-index'),
+        refresh: flagBool(args, 'refresh'),
         noCache: flagBool(args, 'no-cache'),
         cacheReplayThreshold: flagNumber(args, 'cache-replay-threshold') ?? 0.95,
         cacheReferenceThreshold: flagNumber(args, 'cache-reference-threshold') ?? 0.75,
@@ -1362,6 +1394,21 @@ function readCommonOptions(args) {
             : {}),
     };
 }
+/**
+ * Render the one-line freshness warning for a stale semantic index — including
+ * how many deleted-file suggestions were dropped from the results this query.
+ * Returns null when the index is current (no noise). Pure + testable.
+ */
+export function renderIndexFreshnessWarning(f) {
+    if (!f || f.behind <= 0)
+        return null;
+    const pruned = f.prunedDeleted && f.prunedDeleted > 0
+        ? ` ${f.prunedDeleted} deleted-file suggestion(s) were dropped from the list above.`
+        : '';
+    return (`> ⚠ Semantic index is ${f.behind} file(s) behind the working tree ` +
+        `(${f.stale} changed, ${f.missing} deleted, ${f.untracked} new).${pruned} ` +
+        'Verify the file suggestions above before editing — run `shrk smart-context --refresh` to rebuild.');
+}
 async function buildSmartContextSeed(input) {
     const { cwd, task, inspection, options } = input;
     const overview = buildProjectOverview(inspection.workspace, inspection.config?.projectName);
@@ -1385,6 +1432,7 @@ async function buildSmartContextSeed(input) {
         documentationHits: collectDocumentationHits(cwd, tokenizeTask(task), 10),
         semanticCandidates: semantic.hits,
         semanticModel: semantic.model,
+        ...(semantic.freshness ? { indexFreshness: semantic.freshness } : {}),
     };
 }
 const AUTO_REFRESH_FILE_CAP = 30;
@@ -2159,22 +2207,30 @@ function collectChangedPathsWithNeighbors(cwd, gitRef) {
 }
 async function tryLoadSemanticHits(cwd, task, k, options) {
     if (isSemanticAutomationDisabled()) {
-        return { hits: [], model: null, index: null };
+        return { hits: [], model: null, index: null, freshness: null };
     }
     try {
         const index = await SemanticIndex.tryLoad(cwd);
         if (!index) {
             maybePrintMissingIndexHint(options);
-            return { hits: [], model: null, index: null };
+            return { hits: [], model: null, index: null, freshness: null };
         }
+        let freshness = null;
         if (!options.noRefreshIndex && !options.dryRun) {
-            await maybeAutoRefresh(cwd, index, options);
+            freshness = await maybeAutoRefresh(cwd, index, options);
+        }
+        // Over-fetch, then DROP hits whose file no longer exists on disk — a stale
+        // embedding index must never suggest a deleted file (the reason an agent
+        // would fall back to grep). The freshness block separately reports the drift.
+        const rawHits = await index.searchFiles(task, Math.min(Math.max(k * 2, k), 200));
+        const { hits, prunedDeleted } = pruneDeletedHits(rawHits, cwd, k);
+        if (freshness && prunedDeleted > 0) {
+            freshness = { ...freshness, prunedDeleted };
         }
-        const hits = await index.searchFiles(task, k);
-        return { hits, model: index.modelName, index };
+        return { hits, model: index.modelName, index, freshness };
     }
     catch {
-        return { hits: [], model: null, index: null };
+        return { hits: [], model: null, index: null, freshness: null };
     }
 }
 async function lookupPlanCache(cwd, task, options) {
@@ -2200,17 +2256,35 @@ async function lookupPlanCache(cwd, task, options) {
         return { replay: null, reference: null, embedding: null, index: null };
     }
 }
+function freshnessFrom(report, refreshed) {
+    const behind = report.stale + report.missing + report.untracked;
+    return {
+        indexed: report.indexed,
+        behind,
+        stale: report.stale,
+        missing: report.missing,
+        untracked: report.untracked,
+        refreshed,
+        ...(behind > 0 && !refreshed
+            ? { nextCommand: 'shrk smart-context --refresh' }
+            : {}),
+    };
+}
 async function maybeAutoRefresh(cwd, index, options) {
     const current = listIndexableFiles(cwd, 5000);
     const report = SemanticIndex.freshnessReport(cwd, current);
     const driftCount = report.stale + report.missing + report.untracked;
     if (driftCount === 0)
-        return;
-    if (driftCount > AUTO_REFRESH_FILE_CAP) {
-        if (!options.json) {
-            process.stderr.write(`[smart-context] semantic index drifted by ${driftCount} files — too many for auto-refresh. Run \`shrk smart-context embeddings-build\`.\n`);
-        }
-        return;
+        return freshnessFrom(report, false);
+    // `--refresh` forces an incremental rebuild regardless of the auto cap, so an
+    // agent can bring the index current on demand (mirrors `graph --refresh`).
+    const forced = options.refresh === true;
+    if (!forced && driftCount > AUTO_REFRESH_FILE_CAP) {
+        // Advisory on STDERR (never stdout, so --json stays valid). The honest
+        // `indexFreshness` block in the brief/envelope carries the same signal to
+        // the JSON consumer, which is exactly the agent that needs it.
+        process.stderr.write(`[smart-context] semantic index ${driftCount} files behind — too many for auto-refresh. Run \`shrk smart-context --refresh\` (or \`embeddings-build\`).\n`);
+        return freshnessFrom(report, false);
     }
     const entries = current.map((path) => ({
         path,
@@ -2219,8 +2293,11 @@ async function maybeAutoRefresh(cwd, index, options) {
     }));
     const refreshReport = await index.refresh(entries);
     if (!options.json && (refreshReport.added + refreshReport.changed + refreshReport.removed) > 0) {
-        process.stderr.write(`[smart-context] auto-refreshed semantic index: +${refreshReport.added} ~${refreshReport.changed} -${refreshReport.removed} (unchanged ${refreshReport.unchanged}).\n`);
+        process.stderr.write(`[smart-context] refreshed semantic index: +${refreshReport.added} ~${refreshReport.changed} -${refreshReport.removed} (unchanged ${refreshReport.unchanged}).\n`);
     }
+    // Recompute against the now-updated index so `indexFreshness` is accurate.
+    const after = SemanticIndex.freshnessReport(cwd, listIndexableFiles(cwd, 5000));
+    return freshnessFrom(after, true);
 }
 let missingIndexHintShown = false;
 function maybePrintMissingIndexHint(options) {
@@ -2566,6 +2643,12 @@ function renderSeed(seed) {
         }
         lines.push('');
     }
+    // Honest freshness signal: a stale embedding index returns suggestions for
+    // moved/deleted/never-indexed files. Surface it so the agent verifies (or
+    // rebuilds) instead of trusting silently-stale grounding.
+    const freshnessWarning = renderIndexFreshnessWarning(seed.indexFreshness);
+    if (freshnessWarning)
+        lines.push(freshnessWarning, '');
     lines.push('# Knowledge context (engine-ranked, token-budgeted)');
     lines.push(seed.contextBody.trim());
     return lines.join('\n');
@@ -2810,6 +2893,7 @@ function buildEnvelope(input) {
             recommendedCommands: input.seed.packet.recommendedCliCommands,
         },
         content: input.content ?? input.ai.content,
+        ...(input.seed.indexFreshness ? { indexFreshness: input.seed.indexFreshness } : {}),
         ...(input.aiPlan ? { aiPlan: input.aiPlan } : {}),
         ...(input.enhancement ? { enhancement: input.enhancement } : {}),
     };
@@ -2941,11 +3025,24 @@ function readSavedIndex(cwd) {
     for (const name of readdirSync(dir)) {
         if (!name.endsWith('.json'))
             continue;
+        // Skip sidecar files (a saved entry also writes <slug>.raw.json /
+        // .plan.json / .conversation.json) so `list` doesn't show them as rows.
+        if (/\.(raw|plan|conversation)\.json$/.test(name))
+            continue;
         const jsonPath = nodePath.join(dir, name);
         try {
             if (!statSync(jsonPath).isFile())
                 continue;
             const env = JSON.parse(readFileSync(jsonPath, 'utf8'));
+            // Shape-guard: only real smart-context envelopes — other commands dump
+            // foreign JSON (audit-/fix-/pipelines-…) into this dir that merely parses
+            // as JSON and otherwise renders as `[undefined] undefined` noise.
+            if (typeof env.task !== 'string' ||
+                typeof env.mode !== 'string' ||
+                typeof env.savedAt !== 'string' ||
+                typeof env.content !== 'string') {
+                continue;
+            }
             const slugBase = name.replace(/\.json$/, '');
             const mdPath = nodePath.join(dir, `${slugBase}.md`);
             out.push({

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

@@ -1 +1 @@
-{"version":3,"file":"tests.command.d.ts","sourceRoot":"","sources":["../../src/commands/tests.command.ts"],"names":[],"mappings":"AAQA,OAAO,EAKL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAiChC,eAAO,MAAM,kBAAkB,EAAE,eAyBhC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,eAajC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,eAgBjC,CAAC"}
+{"version":3,"file":"tests.command.d.ts","sourceRoot":"","sources":["../../src/commands/tests.command.ts"],"names":[],"mappings":"AASA,OAAO,EAKL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAwChC,eAAO,MAAM,kBAAkB,EAAE,eAyBhC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,eAajC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,eAgBjC,CAAC"}

package/dist/commands/tests.command.js

@@ -1,13 +1,24 @@
 import { existsSync, readFileSync } from 'node:fs';
 import * as nodePath from 'node:path';
-import { analyzeTestImpact, inspectSharkcraft, readFeatureBundle, suggestTestPathFor, } from '@shrkcrft/inspector';
+import { analyzeTestImpact, getChangedFiles, inspectSharkcraft, readFeatureBundle, suggestTestPathFor, } from '@shrkcrft/inspector';
 import { flagBool, flagString, flagList, resolveCwd, } from "../command-registry.js";
 import { asJson, header } from "../output/format-output.js";
 function collectFiles(cwd, args) {
     const files = flagList(args, 'files');
     const planFile = flagString(args, 'plan');
     const bundleId = flagString(args, 'bundle');
+    const since = flagString(args, 'since');
+    const staged = flagBool(args, 'staged');
     const out = [...files];
+    // `--since <ref>` / `--staged`: collect changed files straight from git so
+    // the agent's reflex `shrk tests impact --since main` works the same way as
+    // `shrk impact --since` (was --files-only, forcing a manual diff).
+    if (since)
+        for (const f of getChangedFiles(cwd, { since }))
+            out.push(f);
+    if (staged)
+        for (const f of getChangedFiles(cwd, { staged: true }))
+            out.push(f);
     if (planFile) {
         const path = nodePath.isAbsolute(planFile) ? planFile : nodePath.join(cwd, planFile);
         if (existsSync(path)) {
@@ -38,7 +49,7 @@ function collectFiles(cwd, args) {
 export const testsImpactCommand = {
     name: 'impact',
     description: 'Test impact analysis for changed files / plan / bundle.',
-    usage: 'shrk tests impact [--files a,b] [--plan <plan>] [--bundle <id>] "<task>"',
+    usage: 'shrk tests impact [--files a,b] [--since <ref>] [--staged] [--plan <plan>] [--bundle <id>] "<task>"',
     async run(args) {
         const cwd = resolveCwd(args);
         const inspection = await inspectSharkcraft({ cwd });

package/dist/dashboard/code-intelligence-data.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"code-intelligence-data.d.ts","sourceRoot":"","sources":["../../src/dashboard/code-intelligence-data.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACV,kCAAkC,EAElC,4BAA4B,EAE5B,8BAA8B,EAC9B,wBAAwB,EAEzB,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;;;GAUG;AACH,wBAAgB,8BAA8B,CAAC,WAAW,EAAE,MAAM,GAAG,kCAAkC,CAuCtG;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,wBAAwB,CAyClF;AA0ED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,4BAA4B,CAuE1F;AAaD,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,MAAM,GAAG,8BAA8B,CAgD9F"}
+{"version":3,"file":"code-intelligence-data.d.ts","sourceRoot":"","sources":["../../src/dashboard/code-intelligence-data.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACV,kCAAkC,EAGlC,4BAA4B,EAE5B,8BAA8B,EAC9B,wBAAwB,EAEzB,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;;;GAUG;AACH,wBAAgB,8BAA8B,CAAC,WAAW,EAAE,MAAM,GAAG,kCAAkC,CAuCtG;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,wBAAwB,CAyClF;AAmGD;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,4BAA4B,CAuE1F;AAaD,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,MAAM,GAAG,8BAA8B,CAgD9F"}

package/dist/dashboard/code-intelligence-data.js

@@ -2,7 +2,7 @@ import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
 import * as nodePath from 'node:path';
 import { runArchCheck } from '@shrkcrft/architecture-guard';
 import { FrameworkQueryApi } from '@shrkcrft/framework-scanners';
-import { GraphStore } from '@shrkcrft/graph';
+import { detectGraphFreshness, GraphQueryApi, GraphStore } from '@shrkcrft/graph';
 import { findResumePoint, } from '@shrkcrft/migrate';
 import { QualityGateReportStore, runQualityGates } from '@shrkcrft/quality-gates';
 import { BridgeStore } from '@shrkcrft/rule-graph';
@@ -27,7 +27,7 @@ export function buildDashboardCodeIntelligence(projectRoot) {
     // Graph.
     const graphStore = new GraphStore(projectRoot);
     const graph = graphStore.exists()
-        ? readGraphSection(graphStore)
+        ? readGraphSection(graphStore, projectRoot)
         : { available: false, hint: "run 'shrk graph index'" };
     // Bridge.
     const bridgeStore = new BridgeStore(projectRoot);
@@ -100,8 +100,23 @@ export function buildDashboardRoutes(projectRoot) {
         commandHints,
     };
 }
-function readGraphSection(store) {
+function readGraphSection(store, projectRoot) {
     const snap = store.loadSnapshot();
+    const api = new GraphQueryApi(snap);
+    const hubs = api.topHubs(8);
+    const toRow = (h) => ({
+        id: h.node.id,
+        label: h.node.label,
+        ...(h.node.path ? { path: h.node.path } : {}),
+        inDegree: h.inDegree,
+    });
+    // Freshness vs the working tree — the same signal `shrk graph status` reports.
+    // `corrupt` (store self-integrity) outranks `stale` (disk drift): a digest
+    // failure means the counts themselves can't be trusted.
+    const fresh = detectGraphFreshness(projectRoot);
+    const behind = fresh.modified.length + fresh.added.length + fresh.deleted.length;
+    const verify = store.verifyDigest();
+    const state = !verify.ok ? 'corrupt' : behind > 0 ? 'stale' : 'fresh';
     return {
         available: true,
         fileCount: snap.manifest.filesIndexed,
@@ -111,6 +126,13 @@ function readGraphSection(store) {
         lastIndexedAt: snap.manifest.lastIndexedAt,
         nodesByKind: snap.manifest.nodesByKind,
         edgesByKind: snap.manifest.edgesByKind,
+        freshness: {
+            state,
+            modified: fresh.modified.length,
+            added: fresh.added.length,
+            deleted: fresh.deleted.length,
+        },
+        hubs: { symbols: hubs.symbols.map(toRow), files: hubs.files.map(toRow) },
     };
 }
 function readBridgeSection(store) {

package/dist/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AAEA,OAAO,EACL,eAAe,EAKhB,MAAM,uBAAuB,CAAC;AAuX/B,wBAAgB,aAAa,IAAI,eAAe,CA2X/C;AAED,wBAAsB,MAAM,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA2BrE;AAoHD;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CA4CxE"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AAEA,OAAO,EACL,eAAe,EAKhB,MAAM,uBAAuB,CAAC;AAwX/B,wBAAgB,aAAa,IAAI,eAAe,CA4X/C;AAED,wBAAsB,MAAM,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA2BrE;AAsHD;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CA4CxE"}

package/dist/main.js

@@ -50,6 +50,7 @@ import { contextCommand } from "./commands/context.command.js";
 import { diffParentCommand, diffRoundsCommand, roundsCaptureCommand, roundsListCommand, roundsParentCommand, roundsShowCommand, } from "./commands/rounds.command.js";
 import { genCommand } from "./commands/gen.command.js";
 import { applyCommand } from "./commands/apply.command.js";
+import { delegateCommand } from "./commands/delegate.command.js";
 import { groundingCommand } from "./commands/grounding.command.js";
 import { planCheckCommand } from "./commands/plan-check.command.js";
 import { whyCommand } from "./commands/why.command.js";
@@ -155,6 +156,7 @@ export function buildRegistry() {
     registry.register(contextCommand);
     registry.register(genCommand);
     registry.register(applyCommand);
+    registry.register(delegateCommand);
     // `shrk grounding` thin context primer.
     registry.register(groundingCommand);
     // feedback3 — `shrk why <file>` (closes the dangling ide-suggested verb).
@@ -611,7 +613,7 @@ async function runCliInner(argv) {
             process.stderr.write(renderSurfaceNotEnabledText(err));
             return SURFACE_NOT_ENABLED_EXIT_CODE;
         }
-        return await handler.run(parseArgs(leftover, { globalCwd }));
+        return await handler.run(parseArgs(leftover, { globalCwd, booleanFlags: handler.booleanFlags }));
     }
     // No handler at the deepest match. If we landed on a group node (has
     // children), show that group's help so the user discovers the verbs.

package/dist/output/ccr-store-config.d.ts

@@ -8,7 +8,7 @@ import { TtlFileCcrStore } from '@shrkcrft/compress';
  * the cap is exceeded.
  */
 export declare const CCR_MAX_ENTRIES = 1000;
-/** Absolute path to the per-workspace CCR cache directory. */
+/** Absolute path to the per-project CCR cache directory (project-root-relative). */
 export declare function ccrDir(cwd: string): string;
 /**
  * Open the bounded, cross-process CCR store the CLI write/read paths share.

package/dist/output/ccr-store-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ccr-store-config.d.ts","sourceRoot":"","sources":["../../src/output/ccr-store-config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,OAAO,CAAC;AAEpC,8DAA8D;AAC9D,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE1C;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAEzD"}
+{"version":3,"file":"ccr-store-config.d.ts","sourceRoot":"","sources":["../../src/output/ccr-store-config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAmBrD;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,OAAO,CAAC;AAEpC,oFAAoF;AACpF,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE1C;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAEzD"}

package/dist/output/ccr-store-config.js

@@ -1,5 +1,24 @@
+import { existsSync } from 'node:fs';
 import * as nodePath from 'node:path';
 import { TtlFileCcrStore } from '@shrkcrft/compress';
+/**
+ * Walk up from `cwd` to the nearest ancestor containing a `.sharkcraft/` dir
+ * (the project root), so `compress` and `expand` share ONE cache per project —
+ * a `<<ccr:KEY>>` cached at the repo root stays recoverable from any subdir
+ * instead of being unrecoverable because `expand` looked in `<subdir>/.sharkcraft/ccr`.
+ * Falls back to `cwd` when no project root is found (a fresh repo).
+ */
+function ccrRoot(cwd) {
+    let dir = nodePath.resolve(cwd);
+    for (;;) {
+        if (existsSync(nodePath.join(dir, '.sharkcraft')))
+            return dir;
+        const parent = nodePath.dirname(dir);
+        if (parent === dir)
+            return cwd; // reached the filesystem root
+        dir = parent;
+    }
+}
 /**
  * Upper bound on cached CCR originals under `.sharkcraft/ccr/`. The store evicts
  * the oldest entries past this on every `put`, so the compress cache stays
@@ -9,9 +28,9 @@ import { TtlFileCcrStore } from '@shrkcrft/compress';
  * the cap is exceeded.
  */
 export const CCR_MAX_ENTRIES = 1000;
-/** Absolute path to the per-workspace CCR cache directory. */
+/** Absolute path to the per-project CCR cache directory (project-root-relative). */
 export function ccrDir(cwd) {
-    return nodePath.join(cwd, '.sharkcraft', 'ccr');
+    return nodePath.join(ccrRoot(cwd), '.sharkcraft', 'ccr');
 }
 /**
  * Open the bounded, cross-process CCR store the CLI write/read paths share.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shrkcrft/cli",
-  "version": "0.1.0-alpha.17",
+  "version": "0.1.0-alpha.18",
   "description": "SharkCraft CLI (`shrk`): structured project intelligence for AI coding agents.",
   "license": "MIT",
   "author": "SharkCraft contributors",
@@ -47,38 +47,38 @@
     "typecheck": "tsc --noEmit -p tsconfig.json"
   },
   "dependencies": {
-    "@shrkcrft/core": "^0.1.0-alpha.17",
-    "@shrkcrft/compress": "^0.1.0-alpha.17",
-    "@shrkcrft/config": "^0.1.0-alpha.17",
-    "@shrkcrft/workspace": "^0.1.0-alpha.17",
-    "@shrkcrft/knowledge": "^0.1.0-alpha.17",
-    "@shrkcrft/context": "^0.1.0-alpha.17",
-    "@shrkcrft/rules": "^0.1.0-alpha.17",
-    "@shrkcrft/paths": "^0.1.0-alpha.17",
-    "@shrkcrft/templates": "^0.1.0-alpha.17",
-    "@shrkcrft/plugin-api": "^0.1.0-alpha.17",
-    "@shrkcrft/dashboard": "^0.1.0-alpha.17",
-    "@shrkcrft/dashboard-api": "^0.1.0-alpha.17",
-    "@shrkcrft/pipelines": "^0.1.0-alpha.17",
-    "@shrkcrft/presets": "^0.1.0-alpha.17",
-    "@shrkcrft/boundaries": "^0.1.0-alpha.17",
-    "@shrkcrft/graph": "^0.1.0-alpha.17",
-    "@shrkcrft/rule-graph": "^0.1.0-alpha.17",
-    "@shrkcrft/structural-search": "^0.1.0-alpha.17",
-    "@shrkcrft/impact-engine": "^0.1.0-alpha.17",
-    "@shrkcrft/context-planner": "^0.1.0-alpha.17",
-    "@shrkcrft/architecture-guard": "^0.1.0-alpha.17",
-    "@shrkcrft/framework-scanners": "^0.1.0-alpha.17",
-    "@shrkcrft/api-surface-diff": "^0.1.0-alpha.17",
-    "@shrkcrft/quality-gates": "^0.1.0-alpha.17",
-    "@shrkcrft/migrate": "^0.1.0-alpha.17",
-    "@shrkcrft/generator": "^0.1.0-alpha.17",
-    "@shrkcrft/importer": "^0.1.0-alpha.17",
-    "@shrkcrft/inspector": "^0.1.0-alpha.17",
-    "@shrkcrft/ai": "^0.1.0-alpha.17",
-    "@shrkcrft/embeddings": "^0.1.0-alpha.17",
-    "@shrkcrft/shared": "^0.1.0-alpha.17",
-    "@shrkcrft/mcp-server": "^0.1.0-alpha.17",
+    "@shrkcrft/core": "^0.1.0-alpha.18",
+    "@shrkcrft/compress": "^0.1.0-alpha.18",
+    "@shrkcrft/config": "^0.1.0-alpha.18",
+    "@shrkcrft/workspace": "^0.1.0-alpha.18",
+    "@shrkcrft/knowledge": "^0.1.0-alpha.18",
+    "@shrkcrft/context": "^0.1.0-alpha.18",
+    "@shrkcrft/rules": "^0.1.0-alpha.18",
+    "@shrkcrft/paths": "^0.1.0-alpha.18",
+    "@shrkcrft/templates": "^0.1.0-alpha.18",
+    "@shrkcrft/plugin-api": "^0.1.0-alpha.18",
+    "@shrkcrft/dashboard": "^0.1.0-alpha.18",
+    "@shrkcrft/dashboard-api": "^0.1.0-alpha.18",
+    "@shrkcrft/pipelines": "^0.1.0-alpha.18",
+    "@shrkcrft/presets": "^0.1.0-alpha.18",
+    "@shrkcrft/boundaries": "^0.1.0-alpha.18",
+    "@shrkcrft/graph": "^0.1.0-alpha.18",
+    "@shrkcrft/rule-graph": "^0.1.0-alpha.18",
+    "@shrkcrft/structural-search": "^0.1.0-alpha.18",
+    "@shrkcrft/impact-engine": "^0.1.0-alpha.18",
+    "@shrkcrft/context-planner": "^0.1.0-alpha.18",
+    "@shrkcrft/architecture-guard": "^0.1.0-alpha.18",
+    "@shrkcrft/framework-scanners": "^0.1.0-alpha.18",
+    "@shrkcrft/api-surface-diff": "^0.1.0-alpha.18",
+    "@shrkcrft/quality-gates": "^0.1.0-alpha.18",
+    "@shrkcrft/migrate": "^0.1.0-alpha.18",
+    "@shrkcrft/generator": "^0.1.0-alpha.18",
+    "@shrkcrft/importer": "^0.1.0-alpha.18",
+    "@shrkcrft/inspector": "^0.1.0-alpha.18",
+    "@shrkcrft/ai": "^0.1.0-alpha.18",
+    "@shrkcrft/embeddings": "^0.1.0-alpha.18",
+    "@shrkcrft/shared": "^0.1.0-alpha.18",
+    "@shrkcrft/mcp-server": "^0.1.0-alpha.18",
     "@huggingface/transformers": "^3.7.5"
   },
   "publishConfig": {