@shrkcrft/context-planner 0.1.0-alpha.19 → 0.1.0-alpha.21

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export * from './schema/context-pack.js';
+export * from './schema/pack-coverage.js';
 export * from './intent/classify-intent.js';
 export * from './intent/benchmark.js';
 export * from './intent/starter-benchmark.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC"}

package/dist/index.js

@@ -1,4 +1,5 @@
 export * from "./schema/context-pack.js";
+export * from "./schema/pack-coverage.js";
 export * from "./intent/classify-intent.js";
 export * from "./intent/benchmark.js";
 export * from "./intent/starter-benchmark.js";

package/dist/planner/plan-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plan-context.d.ts","sourceRoot":"","sources":["../../src/planner/plan-context.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,YAAY,EAMlB,MAAM,2BAA2B,CAAC;AAInC,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,+DAA+D;IAC/D,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CAwGtE"}
+{"version":3,"file":"plan-context.d.ts","sourceRoot":"","sources":["../../src/planner/plan-context.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,YAAY,EAMlB,MAAM,2BAA2B,CAAC;AAInC,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,+DAA+D;IAC/D,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CA6GtE"}

package/dist/planner/plan-context.js

@@ -55,6 +55,7 @@ export function planContext(options) {
     let paths = [];
     let templates = [];
     const bridgeStore = new BridgeStore(options.projectRoot);
+    const rulesComputed = bridgeStore.exists();
     if (bridgeStore.exists()) {
         const bridgeApi = RuleGraphQueryApi.fromStores(options.projectRoot);
         const seenRule = new Set();
@@ -111,6 +112,10 @@ export function planContext(options) {
         tests,
         risks,
         doNotTouch,
+        // risks/doNotTouch are graph-derived; once past the graph-missing early
+        // return they are always computed. rules/paths/templates depend on the
+        // rule-graph bridge.
+        coverage: { rulesComputed, risksComputed: true, doNotTouchComputed: true },
         budget: { requested: budgetTokens, used, truncated },
         diagnostics,
     };
@@ -213,6 +218,8 @@ function emptyPack(task, budget, diagnostics) {
         tests: [],
         risks: [],
         doNotTouch: [],
+        // Graph store was missing — nothing was computed.
+        coverage: { rulesComputed: false, risksComputed: false, doNotTouchComputed: false },
         budget: { requested: budget, used: 0, truncated: false },
         diagnostics,
     };

package/dist/schema/context-pack.d.ts

@@ -6,6 +6,7 @@
  *
  * Schema: sharkcraft.context-pack/v1.
  */
+import type { IPackCoverage } from './pack-coverage.js';
 export declare const CONTEXT_PACK_SCHEMA: "sharkcraft.context-pack/v1";
 export type TaskIntent = 'feature' | 'bug-fix' | 'refactor' | 'docs' | 'release' | 'migration' | 'unknown';
 export interface IRankedFile {
@@ -61,6 +62,12 @@ export interface IContextPack {
      * vendored code, lock files, dist/build outputs.
      */
     doNotTouch: readonly string[];
+    /**
+     * Per-field provenance: which sections were actually computed vs. omitted
+     * for lack of a prerequisite index. Lets a consumer tell "empty because
+     * none apply" from "empty because not computed".
+     */
+    coverage: IPackCoverage;
     /** Token budget summary. */
     budget: {
         requested: number;

package/dist/schema/context-pack.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context-pack.d.ts","sourceRoot":"","sources":["../../src/schema/context-pack.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,EAAG,4BAAqC,CAAC;AAEzE,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,SAAS,GACT,UAAU,GACV,MAAM,GACN,SAAS,GACT,WAAW,GACX,SAAS,CAAC;AAEd,MAAM,WAAW,WAAW;IAC1B,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,eAAe,EAAE,MAAM,CAAC;IACxB,yCAAyC;IACzC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,QAAQ;IACvB,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,OAAO,mBAAmB,CAAC;IACnC,MAAM,EAAE,UAAU,CAAC;IACnB,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;IAC9B,kDAAkD;IAClD,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC3B,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC3B,SAAS,EAAE,SAAS,YAAY,EAAE,CAAC;IACnC,qCAAqC;IACrC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,uDAAuD;IACvD,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC3B;;;OAGG;IACH,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,4BAA4B;IAC5B,MAAM,EAAE;QACN,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,oDAAoD;QACpD,SAAS,EAAE,OAAO,CAAC;KACpB,CAAC;IACF,6BAA6B;IAC7B,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC"}
+{"version":3,"file":"context-pack.d.ts","sourceRoot":"","sources":["../../src/schema/context-pack.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,eAAO,MAAM,mBAAmB,EAAG,4BAAqC,CAAC;AAEzE,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,SAAS,GACT,UAAU,GACV,MAAM,GACN,SAAS,GACT,WAAW,GACX,SAAS,CAAC;AAEd,MAAM,WAAW,WAAW;IAC1B,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,eAAe,EAAE,MAAM,CAAC;IACxB,yCAAyC;IACzC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,QAAQ;IACvB,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,OAAO,mBAAmB,CAAC;IACnC,MAAM,EAAE,UAAU,CAAC;IACnB,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;IAC9B,kDAAkD;IAClD,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC3B,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC3B,SAAS,EAAE,SAAS,YAAY,EAAE,CAAC;IACnC,qCAAqC;IACrC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,uDAAuD;IACvD,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC3B;;;OAGG;IACH,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B;;;;OAIG;IACH,QAAQ,EAAE,aAAa,CAAC;IACxB,4BAA4B;IAC5B,MAAM,EAAE;QACN,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,oDAAoD;QACpD,SAAS,EAAE,OAAO,CAAC;KACpB,CAAC;IACF,6BAA6B;IAC7B,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC"}

package/dist/schema/context-pack.js

@@ -1,9 +1 @@
-/**
- * Compact, deterministic context pack consumable by AI coding agents.
- *
- * Output of `@shrkcrft/context-planner`. Stable JSON shape so an agent
- * can persist node ids across turns and verify what was cut.
- *
- * Schema: sharkcraft.context-pack/v1.
- */
 export const CONTEXT_PACK_SCHEMA = 'sharkcraft.context-pack/v1';

package/dist/schema/pack-coverage.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Per-field coverage markers for an `IContextPack`.
+ *
+ * Distinguishes "computed and genuinely empty" from "not computed" so a
+ * consumer reading e.g. `rules: []` can tell whether no rules apply versus the
+ * prerequisite index was never built. Without this, an empty array reads as
+ * "no risks" rather than "risk analysis was skipped".
+ *
+ * Part of `sharkcraft.context-pack/v1`.
+ */
+export interface IPackCoverage {
+    /**
+     * True when the rule-graph bridge was present, so `rules` / `paths` /
+     * `templates` were actually computed. False means they were OMITTED (run
+     * `shrk rule-graph index`) — not that none apply.
+     */
+    rulesComputed: boolean;
+    /**
+     * True when risk analysis ran over the selected file set (requires the code
+     * graph). False only when the graph store was missing and an empty pack was
+     * returned.
+     */
+    risksComputed: boolean;
+    /**
+     * True when do-not-touch detection ran over the selected file set. Same
+     * precondition as `risksComputed`.
+     */
+    doNotTouchComputed: boolean;
+}
+//# sourceMappingURL=pack-coverage.d.ts.map

package/dist/schema/pack-coverage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-coverage.d.ts","sourceRoot":"","sources":["../../src/schema/pack-coverage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,aAAa,EAAE,OAAO,CAAC;IACvB;;;;OAIG;IACH,aAAa,EAAE,OAAO,CAAC;IACvB;;;OAGG;IACH,kBAAkB,EAAE,OAAO,CAAC;CAC7B"}

package/dist/schema/pack-coverage.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@shrkcrft/context-planner",
-  "version": "0.1.0-alpha.19",
+  "version": "0.1.0-alpha.21",
   "description": "SharkCraft context planner: deterministic, token-budgeted context packs for AI coding agents. Combines code graph, rule-graph, and intent classification to pick the minimal relevant file set for a task.",
   "license": "MIT",
   "author": "SharkCraft contributors",
   "type": "module",
   "main": "./dist/index.js",
-  "types": "./dist/index.d.d.ts",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -43,9 +43,9 @@
     "typecheck": "tsc --noEmit -p tsconfig.json"
   },
   "dependencies": {
-    "@shrkcrft/core": "^0.1.0-alpha.19",
-    "@shrkcrft/graph": "^0.1.0-alpha.19",
-    "@shrkcrft/rule-graph": "^0.1.0-alpha.19"
+    "@shrkcrft/core": "^0.1.0-alpha.21",
+    "@shrkcrft/graph": "^0.1.0-alpha.21",
+    "@shrkcrft/rule-graph": "^0.1.0-alpha.21"
   },
   "publishConfig": {
     "access": "public"