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

package/dist/commands/dev.command.js

@@ -672,7 +672,11 @@ async function validateSession(args) {
     const allVerifications = flagBool(args, 'all-verifications');
     const allowPackCommands = flagBool(args, 'allow-pack-commands');
     const wantStrict = flagBool(args, 'strict');
-    const wantReport = flagBool(args, 'report') !== false; // default: write report
+    // flagBool is two-valued (absent → false), so `flagBool(...) !== false` is
+    // false when the flag is absent — the opposite of the intended default. Read
+    // the raw value: write the report by default, opt out only via --report=false.
+    const reportFlag = args.flags.get('report');
+    const wantReport = reportFlag !== false && reportFlag !== 'false';
     const wantJson = flagBool(args, 'json');
     const startedAt = new Date().toISOString();
     const reportFileName = `validate-${startedAt.replace(/[:.]/g, '-')}.json`;

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;AA8OhC,eAAO,MAAM,aAAa,EAAE,eAW3B,CAAC;AA4eF,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;AA6PhC,eAAO,MAAM,aAAa,EAAE,eAW3B,CAAC;AAwfF,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

@@ -179,7 +179,6 @@ function renderSemanticIndexCheck(report) {
         };
     }
     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',
@@ -189,12 +188,26 @@ function renderSemanticIndexCheck(report) {
             category: 'semantic-index',
         };
     }
-    const severity = driftPct >= 10 ? DoctorSeverity.Warning : DoctorSeverity.Info;
+    // Severity is driven only by *rot* — indexed entries that changed (stale)
+    // or were deleted (missing), as a fraction of the indexed set. Newly added
+    // files (`untracked`) are benign growth, not drift: they aren't in the
+    // index yet so they can't return wrong hits, and they don't belong in a
+    // ratio whose denominator is the indexed set. The old fused "% drift"
+    // (stale+missing+untracked over indexed) tripped a yellow WARN purely on
+    // repo growth — exactly the "scary number" noise. The index is a derived
+    // cache, so this is always `advisory` (folds into the calm "N advisory"
+    // line and nudges a refresh) rather than a code-health defect; a deleted
+    // file can no longer reach a caller either, because searchFiles prunes
+    // on-disk-missing paths at query time.
+    const rotPct = report.indexed > 0 ? ((report.stale + report.missing) * 100) / report.indexed : 0;
+    const severity = rotPct >= 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).`,
+        advisory: true,
+        message: `Index drifted from disk — ${report.untracked} new, ${report.missing} deleted, ${report.stale} changed ` +
+            `(${report.indexed} indexed; ${Math.round(rotPct)}% stale/deleted).`,
         fix: 'shrk smart-context embeddings-build',
         category: 'semantic-index',
     };
@@ -478,6 +491,11 @@ async function doctorCommandImpl(args) {
             process.stdout.write('\n' + summary);
     }
     process.stdout.write('\n');
+    // How many of the warnings are routine index/cache maintenance (advisory
+    // staleness) rather than code-health defects. Surfaced as an additive
+    // sub-line so the headline count isn't misread as N real problems —
+    // these fold out under --show-advisory.
+    const maintenanceWarnings = visibleChecks.filter((c) => c.severity === DoctorSeverity.Warning && c.advisory).length;
     if (filtered) {
         const s = filtered.summary;
         process.stdout.write(`Summary: ${s.ok} ok, ${s.info} info, ${s.warnings} active warnings, ${s.errors} errors\n`);
@@ -491,6 +509,9 @@ async function doctorCommandImpl(args) {
     else {
         process.stdout.write(`Summary: ${result.summary.ok} ok, ${result.summary.info} info, ${result.summary.warnings} warnings, ${result.summary.errors} errors\n`);
     }
+    if (maintenanceWarnings > 0) {
+        process.stdout.write(`  (${maintenanceWarnings} ${maintenanceWarnings === 1 ? 'warning is' : 'warnings are'} routine index/cache maintenance, not code-health defects — fold-out via --show-advisory)\n`);
+    }
     void buildSuppressionEntry;
     void doctorSuppressionsFile;
     void saveDoctorSuppressions;

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

@@ -7,5 +7,27 @@ export declare function runGraphStatus(args: ParsedArgs): Promise<number>;
 export declare function runGraphSearch(args: ParsedArgs): Promise<number>;
 export declare function runGraphContext(args: ParsedArgs): Promise<number>;
 export declare function runGraphImpact(args: ParsedArgs): Promise<number>;
+/**
+ * `shrk graph hubs` — the most-depended-on code: symbols ranked by how many
+ * DISTINCT files reference them, files by how many import them. The
+ * "load-bearing code" an agent should change most carefully and a human should
+ * understand first — the natural companion to `graph impact` (impact = blast
+ * radius of ONE node; hubs = the nodes with the biggest blast radius).
+ */
+export declare function runGraphHubs(args: ParsedArgs): Promise<number>;
 export declare function runGraphCallers(args: ParsedArgs): Promise<number>;
+/**
+ * `shrk graph path <from> <to>` — does code A actually reach code B?
+ *
+ * The question the original feedback fell back to grep for ("is billing
+ * actually WIRED to checkout?"). `callers` = direct callers, `impact` =
+ * reverse closure, `graph why` = the KNOWLEDGE graph — none answers the
+ * forward CODE path between two symbols/files. This BFS does, over the
+ * import/call/reference/declare/re-export/extends/implements edges, and
+ * prints each hop with its edge kind (and call-site line) so the answer
+ * shows HOW they are wired, not just that they are. When A→B has no path it
+ * also checks B→A so "the dependency runs the other way" is reported instead
+ * of a bare "no".
+ */
+export declare function runGraphPath(args: ParsedArgs): Promise<number>;
 //# sourceMappingURL=graph-code-subverbs.d.ts.map

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,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"}
+{"version":3,"file":"graph-code-subverbs.d.ts","sourceRoot":"","sources":["../../src/commands/graph-code-subverbs.ts"],"names":[],"mappings":"AA0BA,OAAO,EAAoC,KAAK,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAkH3F,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,CA8EpE;AAID,wBAAsB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAmFtE;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,CAgMvE;AAID,wBAAsB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAuHtE;AAID;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CA+CpE;AAID,wBAAsB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAoEvE;AAyBD;;;;;;;;;;;;GAYG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAgHpE"}