@mstar-harness/engine 3.6.0-alpha.3 → 3.6.0-alpha.4

package/dist/engine.js

@@ -5905,6 +5905,9 @@ function prReviewSeatPrompt(opts) {
   if (!isAbsolute9(worktreePath)) {
     throw new TypeError(`prReviewSeatPrompt: worktreePath must be an absolute path - got ${JSON.stringify(opts.worktreePath)}`);
   }
+  if (opts.diffFile !== undefined && opts.diffFile !== "" && !isAbsolute9(opts.diffFile)) {
+    throw new TypeError(`prReviewSeatPrompt: diffFile must be an absolute path - got ${JSON.stringify(opts.diffFile)}`);
+  }
   const slug = `${domain}-${seat}`;
   const lines = [];
   lines.push(`# PR review audit seat — Stage ${opts.stage}${opts.securitySeat === true ? " (security)" : ""}`);
@@ -5930,6 +5933,9 @@ function prReviewSeatPrompt(opts) {
   const sections = opts.stage === 1 ? tier === "quick" ? "Scoping, Evidence rules" : "Review pipeline, Worktree isolation, Scoping, Evidence rules" : "Merge class, Attack and vet, Evidence rules, Sizing & change shape";
   lines.push(`1. \`${prReviewRef}\` — read at least these sections: ${sections}.`);
   lines.push(`2. The review worktree: \`${worktreePath}\` — your ONLY working directory this session; read-only (no edits, no fixes, no stash, no commits, no posts).`);
+  if (opts.diffFile) {
+    lines.push(`- Read the pinned diff snapshot FIRST: \`${opts.diffFile}\` — it is the review's diff basis (already computed at setup); read it before opening files.`);
+  }
   if (opts.stage === 2) {
     lines.push(`3. \`${join15(skillRoot, "references", "finding-format.md")}\` — the template every finding follows.`);
     if (opts.securitySeat === true) {
@@ -6264,6 +6270,7 @@ export {
   KNOWLEDGE_KNOWLEDGE_PROBLEM_TYPES,
   KNOWLEDGE_CATEGORY_MAP,
   KNOWLEDGE_BUG_PROBLEM_TYPES,
+  GIT_CAPTURE_MAX_BYTES,
   FIVE_QUESTION_SECTIONS,
   DEV_TRACK_PARAMS,
   AUDIT_RISKS,

package/dist/index.d.ts

@@ -40,7 +40,7 @@ export { antiRecursionPrecheck, assertDefaultBranchProtected, assertTriIdentity,
 export type { BranchProbeOptions, L1PreDispatchInput, L2PreDispatchInput, QcAlignmentAssignment, QcSnapshotAssignment, WorktreeTrack, } from "./worktree.js";
 export { assertBranchAlignment, assertControlVsFeaturePath, assertQcAlignment, l1PreDispatchCheck, l2PreDispatchCheck, singleReviewSnapshot, } from "./worktree.js";
 export type { ImplementerSessionLedger, ReviewPackageOptions, SddWorkspaceOptions, StickyRulesInput, StickyRulesResult, TaskBriefOptions, } from "./sdd.js";
-export { SddScriptError, assertBaseSha, implementerSessionStickyRules, readProgressLedger, reviewPackage, sddWorkspace, taskBrief, taskReportExists, } from "./sdd.js";
+export { GIT_CAPTURE_MAX_BYTES, SddScriptError, assertBaseSha, implementerSessionStickyRules, readProgressLedger, reviewPackage, sddWorkspace, taskBrief, taskReportExists, } from "./sdd.js";
 export type { CompassDoc, PhaseGateOptions, PhaseGateResult, PhaseTransition, } from "./iteration.js";
 export { assertIndexRowObligations, evaluatePhaseGate, parseCompassFrontmatter, parseCompassFrontmatterText, pushCadenceProbe, validateCompassFrontmatter, } from "./iteration.js";
 export type { AppendProjectRegisterEntriesOpts, CloseProjectRegisterEntryOpts, FindingsCleanupMode, ProjectRegisterDoc, ProjectRegisterEntry, RoadmapFrontmatter, RoadmapStatus, RoadmapValidation, TechDebtCheck, TechDebtRollup, TechDebtSummary, } from "./project.js";

package/dist/prreview.d.ts

@@ -314,6 +314,10 @@ export type PrReviewSeatPromptOptions = {
     decidedTradeoffs?: readonly string[];
     securitySeat?: boolean;
     tier?: PrReviewTier;
+    /** Absolute path to the pinned diff snapshot written by `worktree-setup`
+     * (review artifact beside the sidecar). Non-empty → the prompt gains a
+     * read-first ingredient line pointing at it. */
+    diffFile?: string;
 };
 /**
  * Generate the read-only audit-seat prompt for one Stage 1 collect or

package/dist/sdd.d.ts

@@ -27,6 +27,13 @@ export type ReviewPackageOptions = {
     sddDir?: string;
     cwd?: string;
 };
+/**
+ * Git capture ceiling for `gitOut` / `reviewPackage` (qc3 W-2): Node's
+ * default 1 MiB `maxBuffer` ENOBUFS'd on large review ranges. 64 MiB keeps
+ * realistic iteration-close ranges working while bounding memory; captures
+ * beyond that fail as SddScriptError via the CLI.
+ */
+export declare const GIT_CAPTURE_MAX_BYTES: number;
 /**
  * Resolve and ensure `{SDD_DIR}` = `{HARNESS_DIR}/sdd/<plan-id>/` (prints
  * the absolute path). Resolution order:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mstar-harness/engine",
-  "version": "3.6.0-alpha.3",
+  "version": "3.6.0-alpha.4",
   "description": "Morning Star Harness Workflow Engine — deterministic workflow enforcement library (path, status, lease, dispatch, sdd, iteration, lint gates).",
   "license": "MIT",
   "repository": {