@harness-engineering/cli 1.24.0 → 1.24.3

package/dist/{chunk-BH6GUAUS.js → chunk-O6UF33QH.js}

@@ -5,38 +5,39 @@ import {
   handleCreateSelfReview,
   handleRequestPeerReview,
   requestPeerReviewDefinition
-} from "./chunk-UKMWY5OJ.js";
+} from "./chunk-YPKKEP3O.js";
 import {
   handleRunSecurityScan,
   runSecurityScanDefinition
-} from "./chunk-3POJUEEZ.js";
+} from "./chunk-UFQQBGC3.js";
 import {
   handleRunCodeReview,
-  runCodeReviewDefinition
-} from "./chunk-EKYIKFOO.js";
+  runCodeReviewDefinition,
+  sortFindingsBySeverity
+} from "./chunk-L5UONZ53.js";
 import {
   assessProjectDefinition,
   handleAssessProject
-} from "./chunk-FVF66DVL.js";
+} from "./chunk-FJYP32IV.js";
 import {
   handleValidateProject,
   validateToolDefinition
-} from "./chunk-OWH5XSMD.js";
+} from "./chunk-WEN5Z7CL.js";
 import {
   checkDependenciesDefinition,
   handleCheckDependencies
-} from "./chunk-ANXOO2HR.js";
+} from "./chunk-A737JDL4.js";
 import {
   resolveProjectConfig
 } from "./chunk-Q3XYV5UC.js";
 import {
   checkDocsDefinition,
   handleCheckDocs
-} from "./chunk-R7LB3VJR.js";
+} from "./chunk-TB427QOK.js";
 import {
   detectEntropyDefinition,
   handleDetectEntropy
-} from "./chunk-44DNUOBH.js";
+} from "./chunk-V2FGX2KD.js";
 import {
   checkPerformanceDefinition,
   getCriticalPathsDefinition,
@@ -46,17 +47,17 @@ import {
   handleGetPerfBaselines,
   handleUpdatePerfBaselines,
   updatePerfBaselinesDefinition
-} from "./chunk-HP74FPUJ.js";
+} from "./chunk-3VYWO6QN.js";
 import {
   resultToMcpResponse
-} from "./chunk-IDZNPTYD.js";
+} from "./chunk-EPUKTTJZ.js";
 import {
   sanitizePath
 } from "./chunk-W6Y7ZW3Y.js";
 import {
   TrackerConfigSchema,
   resolveConfig
-} from "./chunk-ZOIGL5PP.js";
+} from "./chunk-5PMRARB5.js";
 import {
   GENERATED_HEADER_CLAUDE,
   GENERATED_HEADER_CODEX,
@@ -78,21 +79,28 @@ import {
 } from "./chunk-6B6UN6SG.js";
 import {
   loadGraphStore
-} from "./chunk-7QYO5UWW.js";
+} from "./chunk-TDLOFNNQ.js";
 import {
+  CompactionPipeline,
+  DEFAULT_TOKEN_BUDGET,
   DESTRUCTIVE_BASH,
+  StructuralStrategy,
+  TruncationStrategy,
   checkTaint,
   detectChangeType,
+  estimateTokens,
+  paginate,
   scanForInjection,
+  serializeEnvelope,
   writeTaint
-} from "./chunk-WPFFEDTO.js";
+} from "./chunk-H4U2QNY2.js";
 import {
   Err,
   Ok
 } from "./chunk-5LMZA5LZ.js";
 import {
   SkillMetadataSchema
-} from "./chunk-BKHS7RPB.js";
+} from "./chunk-ZOVATVQC.js";
 import {
   CLIError,
   ExitCode,
@@ -229,6 +237,93 @@ function applyInjectionGuard(handlers, options = {}) {
   return wrapped;
 }
 
+// src/mcp/middleware/compaction.ts
+var DEFAULT_PIPELINE = new CompactionPipeline([
+  new StructuralStrategy(),
+  new TruncationStrategy()
+]);
+var LOSSLESS_PIPELINE = new CompactionPipeline([new StructuralStrategy()]);
+function buildHeader(pipeline, orig, comp) {
+  const pct = orig > 0 ? Math.round((1 - comp / orig) * 100) : 0;
+  return `<!-- packed: ${pipeline.strategyNames.join("+")} | ${orig}\u2192${comp} tokens (-${pct}%) -->`;
+}
+function compactText(text, pipeline, budget) {
+  return pipeline.apply(text, budget);
+}
+function compactResultWith(result, pipeline, budget) {
+  const texts = result.content.filter((i) => i.type === "text");
+  const origTok = texts.reduce((s, i) => s + estimateTokens(i.text), 0);
+  const packed = /* @__PURE__ */ new Map();
+  for (const item of texts) packed.set(item, compactText(item.text, pipeline, budget));
+  const compTok = [...packed.values()].reduce((s, t) => s + estimateTokens(t), 0);
+  const hdrTok = estimateTokens(buildHeader(pipeline, origTok, compTok));
+  const header = buildHeader(pipeline, origTok, compTok + hdrTok);
+  let first = true;
+  const content = result.content.map((item) => {
+    if (item.type !== "text") return item;
+    const c = packed.get(item);
+    if (first) {
+      first = false;
+      return { ...item, text: `${header}
+${c}` };
+    }
+    return { ...item, text: c };
+  });
+  return { ...result, content };
+}
+var LOSSLESS_ONLY_TOOLS = /* @__PURE__ */ new Set([
+  "run_skill",
+  // Skill instructions the agent must follow completely
+  "emit_interaction",
+  // User decision trees — truncation breaks choice clarity
+  "manage_state",
+  // Project state JSON — truncation corrupts parsed schemas
+  "code_unfold",
+  // Complete symbol implementations by AST boundary
+  "init_project",
+  // Project scaffolding templates
+  "generate_linter",
+  // Generated ESLint rules — must be syntactically complete
+  "validate_linter_config",
+  // Linter validation — must be structurally complete
+  "generate_agent_definitions",
+  // Generated agent configs (YAML/JSON)
+  "generate_slash_commands",
+  // Generated command definitions
+  "run_persona",
+  // Persona execution results with generated artifacts
+  "generate_persona_artifacts",
+  // Generated configs, CI workflows
+  "manage_roadmap"
+  // Structured roadmap with cross-references and dependencies
+]);
+function wrapWithCompaction(toolName, handler) {
+  return async (input) => {
+    if (toolName === "compact") {
+      return handler(input);
+    }
+    if (input.compact === false || input.compact === "false") {
+      return handler(input);
+    }
+    const result = await handler(input);
+    try {
+      if (LOSSLESS_ONLY_TOOLS.has(toolName)) {
+        return compactResultWith(result, LOSSLESS_PIPELINE);
+      }
+      return compactResultWith(result, DEFAULT_PIPELINE, DEFAULT_TOKEN_BUDGET);
+    } catch {
+      return result;
+    }
+  };
+}
+function applyCompaction(handlers) {
+  const wrapped = {};
+  for (const [name, handler] of Object.entries(handlers)) {
+    wrapped[name] = wrapWithCompaction(name, handler);
+  }
+  return wrapped;
+}
+
 // src/mcp/tools/linter.ts
 var generateLinterDefinition = {
   name: "generate_linter",
@@ -456,6 +551,30 @@ function persistToolingConfig(targetDir, resolveResult, framework) {
   } catch {
   }
 }
+function ensureHarnessGitignore(targetDir) {
+  const gitignorePath = path.join(targetDir, ".harness", ".gitignore");
+  if (fs.existsSync(gitignorePath)) return;
+  const content = `# Runtime artifacts (generated, ephemeral, session-scoped)
+graph/
+debug/
+sessions/
+state.json
+state/
+handoff.json
+handoff-*.json
+autopilot-state.json
+session-taint-*.json
+dispatch-last-head.txt
+health-snapshot.json
+release-readiness.json
+skills-index.json
+stack-profile.json
+metrics/
+events.jsonl
+`;
+  fs.mkdirSync(path.dirname(gitignorePath), { recursive: true });
+  fs.writeFileSync(gitignorePath, content);
+}
 function appendFrameworkAgents(targetDir, framework, language) {
   if (!framework) return;
   const agentsPath = path.join(targetDir, "AGENTS.md");
@@ -548,6 +667,7 @@ function scaffoldMcp(engine, safePath, i, language) {
   if (writeResult.ok) {
     persistToolingConfig(safePath, resolveResult.value, i.framework);
     appendFrameworkAgents(safePath, i.framework, language);
+    ensureHarnessGitignore(safePath);
   }
   if (writeResult.ok && writeResult.value.skippedConfigs.length > 0) {
     const skippedMsg = writeResult.value.skippedConfigs.map((f) => `  - ${f}`).join("\n");
@@ -563,7 +683,7 @@ ${skippedMsg}`
 async function handleInitProject(input) {
   const i = input;
   try {
-    const { TemplateEngine } = await import("./engine-TS24YHIT.js");
+    const { TemplateEngine } = await import("./engine-VUQEAJFZ.js");
     const engine = new TemplateEngine(resolveTemplatesDir());
     const safePath = sanitizePath(i.path);
     const detected = tryDetectFramework(engine, safePath, i);
@@ -584,7 +704,7 @@ var listPersonasDefinition = {
   inputSchema: { type: "object", properties: {} }
 };
 async function handleListPersonas() {
-  const { listPersonas } = await import("./loader-HBQNUGAM.js");
+  const { listPersonas } = await import("./loader-Y6A42WBD.js");
   const result = listPersonas(resolvePersonasDir());
   return resultToMcpResponse(result);
 }
@@ -608,10 +728,10 @@ async function handleGeneratePersonaArtifacts(input) {
   if (!/^[a-z0-9][a-z0-9._-]*$/i.test(input.name)) {
     return resultToMcpResponse(Err(new Error(`Invalid persona name: ${input.name}`)));
   }
-  const { loadPersona } = await import("./loader-HBQNUGAM.js");
-  const { generateRuntime } = await import("./runtime-NQNTDQV5.js");
-  const { generateAgentsMd } = await import("./agents-md-RP63BO56.js");
-  const { generateCIWorkflow } = await import("./ci-workflow-YE7B375K.js");
+  const { loadPersona } = await import("./loader-Y6A42WBD.js");
+  const { generateRuntime } = await import("./runtime-XNJUJCSG.js");
+  const { generateAgentsMd } = await import("./agents-md-PBKKTSQY.js");
+  const { generateCIWorkflow } = await import("./ci-workflow-QZRHAIO2.js");
   const personasDir = resolvePersonasDir();
   const filePath = path3.join(personasDir, `${input.name}.yaml`);
   if (!filePath.startsWith(personasDir)) {
@@ -666,9 +786,9 @@ async function handleRunPersona(input) {
   if (!/^[a-z0-9][a-z0-9._-]*$/i.test(input.persona)) {
     return resultToMcpResponse(Err(new Error(`Invalid persona name: ${input.persona}`)));
   }
-  const { loadPersona } = await import("./loader-HBQNUGAM.js");
-  const { runPersona } = await import("./runner-YYCVNAVF.js");
-  const { executeSkill } = await import("./skill-executor-CS25H7FF.js");
+  const { loadPersona } = await import("./loader-Y6A42WBD.js");
+  const { runPersona } = await import("./runner-TY7DJGQV.js");
+  const { executeSkill } = await import("./skill-executor-GA7BDX3F.js");
   const personasDir = resolvePersonasDir();
   const filePath = path3.join(personasDir, `${input.persona}.yaml`);
   if (!filePath.startsWith(personasDir)) {
@@ -1046,7 +1166,6 @@ function parseSkillEntry(yamlPath, source, tierOverrides) {
   const meta = result.data;
   const effectiveTier = tierOverrides?.[meta.name] ?? meta.tier;
   if (meta.internal) return null;
-  if (effectiveTier !== 3 && source !== "community") return null;
   return {
     tier: effectiveTier ?? 3,
     type: meta.type,
@@ -1312,7 +1431,7 @@ var createSkillDefinition = {
 };
 async function handleCreateSkill(input) {
   try {
-    const { generateSkillFiles } = await import("./create-skill-LTLAAJPC.js");
+    const { generateSkillFiles } = await import("./create-skill-QCXINA5Q.js");
     const result = generateSkillFiles({
       name: input.name,
       description: input.description,
@@ -1430,7 +1549,7 @@ async function autoSyncRoadmap(projectPath) {
   try {
     const roadmapFile = path11.join(projectPath, "docs", "roadmap.md");
     if (!fs10.existsSync(roadmapFile)) return;
-    const { parseRoadmap, serializeRoadmap, syncRoadmap, applySyncChanges } = await import("./dist-27IJJDWG.js");
+    const { parseRoadmap, serializeRoadmap, syncRoadmap, applySyncChanges } = await import("./dist-7EBSGAHX.js");
     const raw = fs10.readFileSync(roadmapFile, "utf-8");
     const parseResult = parseRoadmap(raw);
     if (!parseResult.ok) return;
@@ -1457,7 +1576,7 @@ async function triggerExternalSync(projectPath, roadmapFile) {
     }
     const token = process.env.GITHUB_TOKEN;
     if (!token) return;
-    const { fullSync, GitHubIssuesSyncAdapter } = await import("./dist-27IJJDWG.js");
+    const { fullSync, GitHubIssuesSyncAdapter } = await import("./dist-7EBSGAHX.js");
     const adapter = new GitHubIssuesSyncAdapter({
       token,
       config: trackerConfig
@@ -1569,12 +1688,12 @@ var manageStateDefinition = {
   }
 };
 async function handleShow(projectPath, input) {
-  const { loadState } = await import("./dist-27IJJDWG.js");
+  const { loadState } = await import("./dist-7EBSGAHX.js");
   return resultToMcpResponse(await loadState(projectPath, input.stream, input.session));
 }
 async function handleLearn(projectPath, input) {
   if (!input.learning) return mcpError("Error: learning is required for learn action");
-  const { appendLearning } = await import("./dist-27IJJDWG.js");
+  const { appendLearning } = await import("./dist-7EBSGAHX.js");
   const result = await appendLearning(
     projectPath,
     input.learning,
@@ -1589,7 +1708,7 @@ async function handleLearn(projectPath, input) {
 async function handleFailure(projectPath, input) {
   if (!input.description) return mcpError("Error: description is required for failure action");
   if (!input.failureType) return mcpError("Error: failureType is required for failure action");
-  const { appendFailure } = await import("./dist-27IJJDWG.js");
+  const { appendFailure } = await import("./dist-7EBSGAHX.js");
   const result = await appendFailure(
     projectPath,
     input.description,
@@ -1602,24 +1721,24 @@ async function handleFailure(projectPath, input) {
   return resultToMcpResponse(Ok({ recorded: true }));
 }
 async function handleArchive(projectPath, input) {
-  const { archiveFailures } = await import("./dist-27IJJDWG.js");
+  const { archiveFailures } = await import("./dist-7EBSGAHX.js");
   const result = await archiveFailures(projectPath, input.stream, input.session);
   if (!result.ok) return resultToMcpResponse(result);
   return resultToMcpResponse(Ok({ archived: true }));
 }
 async function handleReset(projectPath, input) {
-  const { saveState, DEFAULT_STATE } = await import("./dist-27IJJDWG.js");
+  const { saveState, DEFAULT_STATE } = await import("./dist-7EBSGAHX.js");
   const result = await saveState(projectPath, { ...DEFAULT_STATE }, input.stream, input.session);
   if (!result.ok) return resultToMcpResponse(result);
   return resultToMcpResponse(Ok({ reset: true }));
 }
 async function handleGate(projectPath, _input) {
-  const { runMechanicalGate } = await import("./dist-27IJJDWG.js");
+  const { runMechanicalGate } = await import("./dist-7EBSGAHX.js");
   return resultToMcpResponse(await runMechanicalGate(projectPath));
 }
 async function handleSaveHandoff(projectPath, input) {
   if (!input.handoff) return mcpError("Error: handoff is required for save-handoff action");
-  const { saveHandoff } = await import("./dist-27IJJDWG.js");
+  const { saveHandoff } = await import("./dist-7EBSGAHX.js");
   const result = await saveHandoff(
     projectPath,
     input.handoff,
@@ -1631,7 +1750,7 @@ async function handleSaveHandoff(projectPath, input) {
   return resultToMcpResponse(Ok({ saved: true }));
 }
 async function handleLoadHandoff(projectPath, input) {
-  const { loadHandoff } = await import("./dist-27IJJDWG.js");
+  const { loadHandoff } = await import("./dist-7EBSGAHX.js");
   return resultToMcpResponse(await loadHandoff(projectPath, input.stream, input.session));
 }
 async function handleAppendEntry(projectPath, input) {
@@ -1639,7 +1758,7 @@ async function handleAppendEntry(projectPath, input) {
   if (!input.section) return mcpError("Error: section is required for append_entry action");
   if (!input.authorSkill) return mcpError("Error: authorSkill is required for append_entry action");
   if (!input.content) return mcpError("Error: content is required for append_entry action");
-  const { appendSessionEntry } = await import("./dist-27IJJDWG.js");
+  const { appendSessionEntry } = await import("./dist-7EBSGAHX.js");
   const result = await appendSessionEntry(
     projectPath,
     input.session,
@@ -1655,7 +1774,7 @@ async function handleUpdateEntryStatus(projectPath, input) {
   if (!input.entryId) return mcpError("Error: entryId is required for update_entry_status action");
   if (!input.newStatus)
     return mcpError("Error: newStatus is required for update_entry_status action");
-  const { updateSessionEntryStatus } = await import("./dist-27IJJDWG.js");
+  const { updateSessionEntryStatus } = await import("./dist-7EBSGAHX.js");
   const result = await updateSessionEntryStatus(
     projectPath,
     input.session,
@@ -1668,7 +1787,7 @@ async function handleUpdateEntryStatus(projectPath, input) {
 async function handleReadSection(projectPath, input) {
   if (!input.session) return mcpError("Error: session is required for read_section action");
   if (!input.section) return mcpError("Error: section is required for read_section action");
-  const { readSessionSection } = await import("./dist-27IJJDWG.js");
+  const { readSessionSection } = await import("./dist-7EBSGAHX.js");
   const result = await readSessionSection(
     projectPath,
     input.session,
@@ -1678,13 +1797,13 @@ async function handleReadSection(projectPath, input) {
 }
 async function handleReadSections(projectPath, input) {
   if (!input.session) return mcpError("Error: session is required for read_sections action");
-  const { readSessionSections } = await import("./dist-27IJJDWG.js");
+  const { readSessionSections } = await import("./dist-7EBSGAHX.js");
   const result = await readSessionSections(projectPath, input.session);
   return resultToMcpResponse(result);
 }
 async function handleArchiveSession(projectPath, input) {
   if (!input.session) return mcpError("Error: session is required for archive_session action");
-  const { archiveSession } = await import("./dist-27IJJDWG.js");
+  const { archiveSession } = await import("./dist-7EBSGAHX.js");
   const result = await archiveSession(projectPath, input.session);
   if (!result.ok) return resultToMcpResponse(result);
   await autoSyncRoadmap(projectPath);
@@ -1748,7 +1867,7 @@ var listStreamsDefinition = {
 };
 async function handleListStreams(input) {
   try {
-    const { listStreams, loadStreamIndex } = await import("./dist-27IJJDWG.js");
+    const { listStreams, loadStreamIndex } = await import("./dist-7EBSGAHX.js");
     const projectPath = sanitizePath(input.path);
     const indexResult = await loadStreamIndex(projectPath);
     const streamsResult = await listStreams(projectPath);
@@ -1786,7 +1905,7 @@ var checkPhaseGateDefinition = {
 };
 async function handleCheckPhaseGate(input) {
   try {
-    const { runCheckPhaseGate } = await import("./check-phase-gate-JXIRVHTR.js");
+    const { runCheckPhaseGate } = await import("./check-phase-gate-WY6UICCL.js");
     const result = await runCheckPhaseGate({ cwd: sanitizePath(input.path) });
     if (result.ok) {
       return { content: [{ type: "text", text: JSON.stringify(result.value) }] };
@@ -1842,7 +1961,7 @@ async function handleValidateCrossCheck(input) {
     };
   }
   try {
-    const { runCrossCheck } = await import("./validate-cross-check-WQWFMPXJ.js");
+    const { runCrossCheck } = await import("./validate-cross-check-Y4PDR63C.js");
     const specsDir = path12.resolve(projectPath, input.specsDir ?? "docs/specs");
     if (!specsDir.startsWith(projectPath)) {
       return {
@@ -1988,11 +2107,14 @@ function buildSpec(meta, normalized, entry, skillsDir, source) {
     executionContextLines.push(`@${skillMdRelative}`, `@${skillYamlRelative}`);
   }
   const commandName = meta.command_name;
-  const effectiveName = commandName ?? normalized;
-  const effectiveFullName = commandName ?? `harness:${normalized}`;
+  const commandNamespace = meta.command_namespace;
+  const effectiveNamespace = commandNamespace ?? "harness";
+  const nameForNamespace = stripNamespacePrefix(normalized, commandNamespace);
+  const effectiveName = commandName ?? nameForNamespace;
+  const effectiveFullName = commandName ?? `${effectiveNamespace}:${nameForNamespace}`;
   return {
     name: effectiveName,
-    namespace: "harness",
+    namespace: effectiveNamespace,
     fullName: effectiveFullName,
     description: meta.description,
     version: meta.version,
@@ -2004,6 +2126,7 @@ function buildSpec(meta, normalized, entry, skillsDir, source) {
     skillsBaseDir: skillsDir,
     source,
     ...commandName ? { commandName } : {},
+    ...commandNamespace ? { customNamespace: commandNamespace } : {},
     ...meta.cursor ? { cursor: meta.cursor } : {},
     prompt: {
       context: buildContextLines(meta).join("\n"),
@@ -2013,6 +2136,15 @@ function buildSpec(meta, normalized, entry, skillsDir, source) {
     }
   };
 }
+function stripNamespacePrefix(normalized, namespace) {
+  if (namespace && normalized.startsWith(`${namespace}-`)) {
+    return normalized.slice(namespace.length + 1);
+  }
+  return normalized;
+}
+function buildCollisionKey(effectiveName, namespace) {
+  return namespace ? `${namespace}:${effectiveName}` : effectiveName;
+}
 function normalizeSkills(skillSources, platforms) {
   const specs = [];
   const nameMap = /* @__PURE__ */ new Map();
@@ -2031,8 +2163,10 @@ function normalizeSkills(skillSources, platforms) {
       const meta = result.data;
       if (shouldSkipSkill(meta, platforms)) continue;
       const normalized = normalizeName(meta.name);
-      const effectiveName = meta.command_name ?? normalized;
-      if (checkNameCollision(effectiveName, meta.name, source, nameMap) === "skip") continue;
+      const nameForCollision = stripNamespacePrefix(normalized, meta.command_namespace);
+      const effectiveName = meta.command_name ?? nameForCollision;
+      const collisionKey = buildCollisionKey(effectiveName, meta.command_namespace);
+      if (checkNameCollision(collisionKey, meta.name, source, nameMap) === "skip") continue;
       specs.push(buildSpec(meta, normalized, entry, skillsDir, source));
     }
   }
@@ -2333,20 +2467,59 @@ function generateForCodex(platform, outputDir, specs, dryRun) {
 }
 function generateForPlatform(platform, outputDir, specs, opts) {
   const rendered = /* @__PURE__ */ new Map();
+  const parentRendered = /* @__PURE__ */ new Map();
+  const customNamespaceRendered = /* @__PURE__ */ new Map();
   for (const spec of specs) {
     const [filename, content] = renderSpec(platform, spec, opts.global);
-    rendered.set(filename, content);
+    if (spec.commandName && (platform === "claude-code" || platform === "gemini-cli")) {
+      parentRendered.set(filename, content);
+    } else if (spec.customNamespace && (platform === "claude-code" || platform === "gemini-cli")) {
+      let nsMap = customNamespaceRendered.get(spec.customNamespace);
+      if (!nsMap) {
+        nsMap = /* @__PURE__ */ new Map();
+        customNamespaceRendered.set(spec.customNamespace, nsMap);
+      }
+      nsMap.set(filename, content);
+    } else {
+      rendered.set(filename, content);
+    }
   }
   const plan = computeSyncPlan(outputDir, rendered);
   if (!opts.dryRun) {
     applySyncPlan(outputDir, rendered, plan, false);
   }
+  const allAdded = [...plan.added];
+  const allUpdated = [...plan.updated];
+  const allRemoved = [...plan.removed];
+  const allUnchanged = [...plan.unchanged];
+  const parentDir = path15.dirname(outputDir);
+  for (const [ns, nsRendered] of customNamespaceRendered) {
+    const nsDir = path15.join(parentDir, ns);
+    const nsPlan = computeSyncPlan(nsDir, nsRendered);
+    if (!opts.dryRun) {
+      applySyncPlan(nsDir, nsRendered, nsPlan, false);
+    }
+    allAdded.push(...nsPlan.added);
+    allUpdated.push(...nsPlan.updated);
+    allRemoved.push(...nsPlan.removed);
+    allUnchanged.push(...nsPlan.unchanged);
+  }
+  if (parentRendered.size > 0) {
+    const parentPlan = computeSyncPlan(parentDir, parentRendered);
+    if (!opts.dryRun) {
+      applySyncPlan(parentDir, parentRendered, parentPlan, false);
+    }
+    allAdded.push(...parentPlan.added);
+    allUpdated.push(...parentPlan.updated);
+    allRemoved.push(...parentPlan.removed);
+    allUnchanged.push(...parentPlan.unchanged);
+  }
   return {
     platform,
-    added: plan.added,
-    updated: plan.updated,
-    removed: plan.removed,
-    unchanged: plan.unchanged,
+    added: allAdded,
+    updated: allUpdated,
+    removed: allRemoved,
+    unchanged: allUnchanged,
     outputDir
   };
 }
@@ -2508,7 +2681,7 @@ async function handleGenerateSlashCommands(input) {
 // src/mcp/resources/state.ts
 async function getStateResource(projectRoot) {
   try {
-    const { loadState, migrateToStreams } = await import("./dist-27IJJDWG.js");
+    const { loadState, migrateToStreams } = await import("./dist-7EBSGAHX.js");
     await migrateToStreams(projectRoot);
     const result = await loadState(projectRoot);
     if (result.ok) {
@@ -2586,6 +2759,14 @@ var queryGraphDefinition = {
         type: "string",
         enum: ["summary", "detailed"],
         description: "Response density: summary returns node/edge counts by type + top 10 nodes by connectivity, detailed returns full arrays. Default: detailed"
+      },
+      offset: {
+        type: "number",
+        description: "Number of nodes to skip (pagination). Default: 0. Nodes are sorted by connectivity (edge count desc)."
+      },
+      limit: {
+        type: "number",
+        description: "Max nodes to return (pagination). Default: 50."
       }
     },
     required: ["path", "rootNodeIds"]
@@ -2615,7 +2796,7 @@ async function handleQueryGraph(input) {
     const projectPath = sanitizePath(input.path);
     const store = await loadGraphStore(projectPath);
     if (!store) return graphNotFoundError();
-    const { ContextQL } = await import("./dist-M6FBUXZD.js");
+    const { ContextQL } = await import("./dist-QW5G3GX3.js");
     const cql = new ContextQL(store);
     const result = cql.execute({
       rootNodeIds: input.rootNodeIds,
@@ -2634,8 +2815,32 @@ async function handleQueryGraph(input) {
         pruneObservability: input.pruneObservability
       }
     });
-    const text = input.mode === "summary" ? buildSummaryText(result) : JSON.stringify(result);
-    return { content: [{ type: "text", text }] };
+    if (input.mode === "summary") {
+      const text = buildSummaryText(result);
+      return { content: [{ type: "text", text }] };
+    }
+    const edgeCountByNode = /* @__PURE__ */ new Map();
+    for (const edge of result.edges) {
+      edgeCountByNode.set(edge.from, (edgeCountByNode.get(edge.from) ?? 0) + 1);
+      edgeCountByNode.set(edge.to, (edgeCountByNode.get(edge.to) ?? 0) + 1);
+    }
+    const sortedNodes = [...result.nodes].sort(
+      (a, b) => (edgeCountByNode.get(b.id) ?? 0) - (edgeCountByNode.get(a.id) ?? 0)
+    );
+    const offset = input.offset ?? 0;
+    const limit = input.limit ?? 50;
+    const paged = paginate(sortedNodes, offset, limit);
+    const pagedNodeIds = new Set(paged.items.map((n) => n.id));
+    const filteredEdges = result.edges.filter(
+      (e) => pagedNodeIds.has(e.from) || pagedNodeIds.has(e.to)
+    );
+    const response = {
+      nodes: paged.items,
+      edges: filteredEdges,
+      stats: result.stats,
+      pagination: paged.pagination
+    };
+    return { content: [{ type: "text", text: JSON.stringify(response) }] };
   } catch (error) {
     return {
       content: [
@@ -2673,7 +2878,7 @@ async function handleSearchSimilar(input) {
     const projectPath = sanitizePath(input.path);
     const store = await loadGraphStore(projectPath);
     if (!store) return graphNotFoundError();
-    const { FusionLayer } = await import("./dist-M6FBUXZD.js");
+    const { FusionLayer } = await import("./dist-QW5G3GX3.js");
     const fusion = new FusionLayer(store);
     const results = fusion.search(input.query, input.topK ?? 10);
     if (input.mode === "summary") {
@@ -2728,7 +2933,7 @@ async function handleFindContextFor(input) {
     const projectPath = sanitizePath(input.path);
     const store = await loadGraphStore(projectPath);
     if (!store) return graphNotFoundError();
-    const { FusionLayer, ContextQL } = await import("./dist-M6FBUXZD.js");
+    const { FusionLayer, ContextQL } = await import("./dist-QW5G3GX3.js");
     const fusion = new FusionLayer(store);
     const cql = new ContextQL(store);
     const tokenBudget = input.tokenBudget ?? 4e3;
@@ -2814,6 +3019,14 @@ var getRelationshipsDefinition = {
         type: "string",
         enum: ["summary", "detailed"],
         description: "Response density: summary returns neighbor counts by type + direct neighbors only, detailed returns full traversal. Default: detailed"
+      },
+      offset: {
+        type: "number",
+        description: "Number of edges to skip (pagination). Default: 0. Edges are sorted by weight (confidence desc)."
+      },
+      limit: {
+        type: "number",
+        description: "Max edges to return (pagination). Default: 50."
       }
     },
     required: ["path", "nodeId"]
@@ -2824,7 +3037,7 @@ async function handleGetRelationships(input) {
     const projectPath = sanitizePath(input.path);
     const store = await loadGraphStore(projectPath);
     if (!store) return graphNotFoundError();
-    const { ContextQL } = await import("./dist-M6FBUXZD.js");
+    const { ContextQL } = await import("./dist-QW5G3GX3.js");
     const cql = new ContextQL(store);
     const direction = input.direction ?? "both";
     const bidirectional = direction === "both" || direction === "inbound";
@@ -2864,6 +3077,12 @@ async function handleGetRelationships(input) {
         ]
       };
     }
+    const sortedEdges = [...filteredEdges].sort(
+      (a, b) => (b.confidence ?? 1) - (a.confidence ?? 1)
+    );
+    const offset = input.offset ?? 0;
+    const limit = input.limit ?? 50;
+    const paged = paginate(sortedEdges, offset, limit);
     return {
       content: [
         {
@@ -2872,9 +3091,15 @@ async function handleGetRelationships(input) {
             nodeId: input.nodeId,
             direction,
             depth: input.depth ?? 1,
-            nodes: filteredNodes,
-            edges: filteredEdges,
-            stats: result.stats
+            // Filter nodes to only those referenced by paginated edges
+            nodes: filteredNodes.filter(
+              (n) => paged.items.some(
+                (e) => e.from === n.id || e.to === n.id
+              )
+            ),
+            edges: paged.items,
+            stats: result.stats,
+            pagination: paged.pagination
           })
         }
       ]
@@ -2930,7 +3155,7 @@ async function handleGetImpact(input) {
     const projectPath = sanitizePath(input.path);
     const store = await loadGraphStore(projectPath);
     if (!store) return graphNotFoundError();
-    const { ContextQL } = await import("./dist-M6FBUXZD.js");
+    const { ContextQL } = await import("./dist-QW5G3GX3.js");
     let targetNodeId = input.nodeId;
     if (!targetNodeId && input.filePath) {
       const fileNodes = store.findNodes({ type: "file" });
@@ -3062,7 +3287,7 @@ async function handleIngestSource(input) {
   try {
     const projectPath = sanitizePath(input.path);
     const graphDir = path16.join(projectPath, ".harness", "graph");
-    const { GraphStore, CodeIngestor, TopologicalLinker, KnowledgeIngestor, GitIngestor } = await import("./dist-M6FBUXZD.js");
+    const { GraphStore, CodeIngestor, TopologicalLinker, KnowledgeIngestor, GitIngestor } = await import("./dist-QW5G3GX3.js");
     const fs17 = await import("fs/promises");
     await fs17.mkdir(graphDir, { recursive: true });
     const store = new GraphStore();
@@ -3127,6 +3352,14 @@ var detectAnomaliesDefinition = {
         type: "array",
         items: { type: "string" },
         description: "Metrics to analyze (default: cyclomaticComplexity, fanIn, fanOut, hotspotScore, transitiveDepth)"
+      },
+      offset: {
+        type: "number",
+        description: "Number of anomaly entries to skip (pagination). Default: 0. Anomalies are sorted by Z-score desc."
+      },
+      limit: {
+        type: "number",
+        description: "Max anomaly entries to return (pagination). Default: 30."
       }
     },
     required: ["path"]
@@ -3137,14 +3370,23 @@ async function handleDetectAnomalies(input) {
     const projectPath = sanitizePath(input.path);
     const store = await loadGraphStore(projectPath);
     if (!store) return graphNotFoundError();
-    const { GraphAnomalyAdapter } = await import("./dist-M6FBUXZD.js");
+    const { GraphAnomalyAdapter } = await import("./dist-QW5G3GX3.js");
     const adapter = new GraphAnomalyAdapter(store);
     const report = adapter.detect({
       ...input.threshold !== void 0 && { threshold: input.threshold },
       ...input.metrics !== void 0 && { metrics: input.metrics }
     });
+    const offset = input.offset ?? 0;
+    const limit = input.limit ?? 30;
+    const paged = paginate(report.statisticalOutliers, offset, limit);
+    const { statisticalOutliers: _fullOutliers, ...rest } = report;
+    const response = {
+      ...rest,
+      statisticalOutliers: paged.items,
+      pagination: paged.pagination
+    };
     return {
-      content: [{ type: "text", text: JSON.stringify(report) }]
+      content: [{ type: "text", text: JSON.stringify(response) }]
     };
   } catch (error) {
     return {
@@ -3177,7 +3419,7 @@ async function handleAskGraph(input) {
     const projectPath = sanitizePath(input.path);
     const store = await loadGraphStore(projectPath);
     if (!store) return graphNotFoundError();
-    const { askGraph } = await import("./dist-M6FBUXZD.js");
+    const { askGraph } = await import("./dist-QW5G3GX3.js");
     const result = await askGraph(store, input.question);
     return {
       content: [{ type: "text", text: JSON.stringify(result) }]
@@ -3241,7 +3483,7 @@ async function handleComputeBlastRadius(input) {
     const projectPath = sanitizePath(input.path);
     const store = await loadGraphStore(projectPath);
     if (!store) return graphNotFoundError();
-    const { CascadeSimulator } = await import("./dist-M6FBUXZD.js");
+    const { CascadeSimulator } = await import("./dist-QW5G3GX3.js");
     let targetNodeId = input.nodeId;
     if (!targetNodeId && input.file) {
       const fileNodes = store.findNodes({ type: "file" });
@@ -3441,7 +3683,7 @@ var generateAgentDefinitionsDefinition = {
   }
 };
 async function handleGenerateAgentDefinitions(input) {
-  const { generateAgentDefinitions } = await import("./generate-agent-definitions-PBITSP7C.js");
+  const { generateAgentDefinitions } = await import("./generate-agent-definitions-PQPG6SX5.js");
   const platforms = input.platform === "all" || !input.platform ? ["claude-code", "gemini-cli"] : [input.platform];
   const results = generateAgentDefinitions({
     platforms: [...platforms],
@@ -3768,7 +4010,7 @@ function shouldTriggerExternalSync(input, response) {
 }
 async function handleManageRoadmap(input) {
   try {
-    const { parseRoadmap, serializeRoadmap, syncRoadmap, applySyncChanges, assignFeature } = await import("./dist-27IJJDWG.js");
+    const { parseRoadmap, serializeRoadmap, syncRoadmap, applySyncChanges, assignFeature } = await import("./dist-7EBSGAHX.js");
     const { Ok: Ok2 } = await import("./dist-666AAZQ6.js");
     const projectPath = sanitizePath(input.path);
     const deps = {
@@ -4203,7 +4445,7 @@ async function handleTransition(validInput, projectPath, id) {
   const transition = transitionResult.data;
   const prompt = renderTransition(transition);
   try {
-    const { saveHandoff } = await import("./dist-27IJJDWG.js");
+    const { saveHandoff } = await import("./dist-7EBSGAHX.js");
     await saveHandoff(
       projectPath,
       {
@@ -4271,7 +4513,7 @@ async function handleEmitInteraction(input) {
 }
 async function recordInteraction(projectPath, id, type, decision, stream) {
   try {
-    const { loadState, saveState } = await import("./dist-27IJJDWG.js");
+    const { loadState, saveState } = await import("./dist-7EBSGAHX.js");
     const stateResult = await loadState(projectPath, stream);
     if (stateResult.ok) {
       const state = stateResult.value;
@@ -4287,6 +4529,50 @@ async function recordInteraction(projectPath, id, type, decision, stream) {
 }
 
 // src/mcp/tools/gather-context.ts
+function flattenSessionSections(sections) {
+  if (!sections) return [];
+  return Object.entries(sections).flatMap(
+    ([name, entries]) => Array.isArray(entries) ? entries.map((e) => ({ sectionName: name, ...e })) : []
+  );
+}
+function sectionItems(input) {
+  if (input.section === "graphContext") {
+    const blocks = input.graphContext?.context ?? [];
+    return [...blocks].sort((a, b) => b.score - a.score);
+  }
+  if (input.section === "learnings") {
+    return Array.isArray(input.learnings) ? input.learnings : [];
+  }
+  const flat = flattenSessionSections(input.sessionSections);
+  return flat.sort((a, b) => (b.timestamp ?? "").localeCompare(a.timestamp ?? ""));
+}
+function checkSectionGuards(section, mode) {
+  if (section === "graphContext" && (mode ?? "summary") === "summary") {
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify({
+            error: "section=graphContext requires mode=detailed. Summary mode aggregates graph blocks into counts \u2014 there are no paginatable items.",
+            hint: 'Pass mode="detailed" to paginate graphContext blocks.'
+          })
+        }
+      ],
+      isError: true
+    };
+  }
+  return null;
+}
+function paginateSection(input) {
+  const items = sectionItems(input);
+  const paged = paginate(items, input.offset, input.limit);
+  return {
+    section: input.section,
+    items: paged.items,
+    pagination: paged.pagination,
+    meta: input.meta
+  };
+}
 var gatherContextDefinition = {
   name: "gather_context",
   description: "Assemble all working context an agent needs in a single call: state, learnings, handoff, graph context, project validation, and session sections. Runs constituents in parallel.",
@@ -4335,6 +4621,19 @@ var gatherContextDefinition = {
         type: "string",
         enum: ["index", "summary", "full"],
         description: 'Retrieval depth for learnings. "index" returns one-line summaries, "summary" (default) returns full entries, "full" returns entries with linked context.'
+      },
+      section: {
+        type: "string",
+        enum: ["graphContext", "learnings", "sessionSections"],
+        description: "Section to paginate. When provided, offset/limit apply within this section only and the response contains only { section, items, pagination, meta }. Note: section=graphContext requires mode=detailed (summary mode has no paginatable blocks). When omitted, returns the full response."
+      },
+      offset: {
+        type: "number",
+        description: "Number of items to skip within the section (pagination). Default: 0. Requires section param."
+      },
+      limit: {
+        type: "number",
+        description: "Max items to return within the section (pagination). Default: 20. Requires section param."
       }
     },
     required: ["path", "intent"]
@@ -4360,10 +4659,10 @@ async function handleGatherContext(input) {
     input.include ?? ["state", "learnings", "handoff", "graph", "validation"]
   );
   const errors = [];
-  const statePromise = includeSet.has("state") ? import("./dist-27IJJDWG.js").then(
+  const statePromise = includeSet.has("state") ? import("./dist-7EBSGAHX.js").then(
     (core) => core.loadState(projectPath, void 0, input.session)
   ) : Promise.resolve(null);
-  const learningsPromise = includeSet.has("learnings") ? import("./dist-27IJJDWG.js").then(
+  const learningsPromise = includeSet.has("learnings") ? import("./dist-7EBSGAHX.js").then(
     (core) => core.loadBudgetedLearnings(projectPath, {
       intent: input.intent,
       tokenBudget: input.learningsBudget ?? 1e3,
@@ -4372,14 +4671,14 @@ async function handleGatherContext(input) {
       ...input.depth !== void 0 && { depth: input.depth }
     })
   ) : Promise.resolve(null);
-  const handoffPromise = includeSet.has("handoff") ? import("./dist-27IJJDWG.js").then(
+  const handoffPromise = includeSet.has("handoff") ? import("./dist-7EBSGAHX.js").then(
     (core) => core.loadHandoff(projectPath, void 0, input.session)
   ) : Promise.resolve(null);
   const graphPromise = includeSet.has("graph") ? (async () => {
-    const { loadGraphStore: loadGraphStore2 } = await import("./graph-loader-OLSOE537.js");
+    const { loadGraphStore: loadGraphStore2 } = await import("./graph-loader-M6FXJAKK.js");
     const store = await loadGraphStore2(projectPath);
     if (!store) return null;
-    const { FusionLayer, ContextQL } = await import("./dist-M6FBUXZD.js");
+    const { FusionLayer, ContextQL } = await import("./dist-QW5G3GX3.js");
     const fusion = new FusionLayer(store);
     const cql = new ContextQL(store);
     const tokenBudget = input.tokenBudget ?? 4e3;
@@ -4416,11 +4715,11 @@ async function handleGatherContext(input) {
       context: contextBlocks
     };
   })() : Promise.resolve(null);
-  const sessionsPromise = includeSet.has("sessions") && input.session ? import("./dist-27IJJDWG.js").then(
+  const sessionsPromise = includeSet.has("sessions") && input.session ? import("./dist-7EBSGAHX.js").then(
     (core) => core.readSessionSections(projectPath, input.session)
   ) : Promise.resolve(null);
   const shouldIncludeEvents = input.includeEvents !== void 0 ? input.includeEvents : includeSet.has("events") || !!input.session && !input.include;
-  const eventsPromise = shouldIncludeEvents ? import("./dist-27IJJDWG.js").then(async (core) => {
+  const eventsPromise = shouldIncludeEvents ? import("./dist-7EBSGAHX.js").then(async (core) => {
     const result = await core.loadEvents(projectPath, {
       session: input.session
     });
@@ -4428,7 +4727,7 @@ async function handleGatherContext(input) {
     return core.formatEventTimeline(result.value);
   }) : Promise.resolve(null);
   const validationPromise = includeSet.has("validation") ? (async () => {
-    const { handleValidateProject: handleValidateProject2 } = await import("./validate-QLHCVBKE.js");
+    const { handleValidateProject: handleValidateProject2 } = await import("./validate-MNE25KLZ.js");
     const result = await handleValidateProject2({ path: projectPath });
     const first = result.content[0];
     return first ? JSON.parse(first.text) : null;
@@ -4522,7 +4821,7 @@ async function handleGatherContext(input) {
   };
   if (input.session) {
     try {
-      const core = await import("./dist-27IJJDWG.js");
+      const core = await import("./dist-7EBSGAHX.js");
       core.updateSessionIndex(
         projectPath,
         input.session,
@@ -4534,6 +4833,22 @@ async function handleGatherContext(input) {
   const outputText = JSON.stringify(output);
   const tokenEstimate = Math.ceil(outputText.length / 4);
   output.meta.tokenEstimate = tokenEstimate;
+  if (input.section) {
+    const guardError = checkSectionGuards(input.section, input.mode);
+    if (guardError) return guardError;
+    const result = paginateSection({
+      section: input.section,
+      offset: input.offset ?? 0,
+      limit: input.limit ?? 20,
+      graphContext,
+      learnings: Array.isArray(outputLearnings) ? outputLearnings : [],
+      sessionSections,
+      meta: output.meta
+    });
+    return {
+      content: [{ type: "text", text: JSON.stringify(result) }]
+    };
+  }
   return {
     content: [
       {
@@ -4566,6 +4881,14 @@ var reviewChangesDefinition = {
         type: "string",
         enum: ["summary", "detailed"],
         description: "Response density. Default: summary"
+      },
+      offset: {
+        type: "number",
+        description: "Number of findings to skip (pagination). Default: 0. Findings are sorted by severity desc (error > warning > info)."
+      },
+      limit: {
+        type: "number",
+        description: "Max findings to return (pagination). Default: 20."
       }
     },
     required: ["path", "depth"]
@@ -4634,7 +4957,7 @@ async function handleReviewChanges(input) {
   }
   try {
     const reviewFn = DEPTH_HANDLERS[effectiveDepth];
-    return await reviewFn(projectPath, diff, diffLines, downgraded);
+    return await reviewFn(projectPath, diff, diffLines, downgraded, input.offset, input.limit);
   } catch (error) {
     return {
       content: [
@@ -4647,12 +4970,15 @@ async function handleReviewChanges(input) {
     };
   }
 }
-async function runQuickReview(projectPath, diff, diffLines, downgraded) {
-  const { handleAnalyzeDiff: handleAnalyzeDiff2 } = await import("./feedback-VGGBOI54.js");
+async function runQuickReview(projectPath, diff, diffLines, downgraded, offset, limit) {
+  const { handleAnalyzeDiff: handleAnalyzeDiff2 } = await import("./feedback-TMEGYMWU.js");
   const result = await handleAnalyzeDiff2({ diff, path: projectPath });
   const firstContent = result.content[0];
   if (!firstContent) throw new Error("Empty analyze_diff response");
   const parsed = JSON.parse(firstContent.text);
+  const rawFindings = parsed.findings ?? parsed.warnings ?? [];
+  const sorted = sortFindingsBySeverity(rawFindings);
+  const paged = paginate(sorted, offset ?? 0, limit ?? 20);
   return {
     content: [
       {
@@ -4660,7 +4986,8 @@ async function runQuickReview(projectPath, diff, diffLines, downgraded) {
         text: JSON.stringify({
           depth: "quick",
           downgraded,
-          findings: parsed.findings ?? parsed.warnings ?? [],
+          findings: paged.items,
+          pagination: paged.pagination,
           fileCount: parsed.summary?.filesChanged ?? parsed.files?.length ?? 0,
           lineCount: diffLines,
           ...result.isError ? { error: parsed } : {}
@@ -4678,8 +5005,8 @@ function extractFileCount(diffParsed) {
   const files = diffParsed.files;
   return files?.length ?? 0;
 }
-async function runStandardReview(projectPath, diff, diffLines, downgraded) {
-  const { handleAnalyzeDiff: handleAnalyzeDiff2, handleCreateSelfReview: handleCreateSelfReview2 } = await import("./feedback-VGGBOI54.js");
+async function runStandardReview(projectPath, diff, diffLines, downgraded, offset, limit) {
+  const { handleAnalyzeDiff: handleAnalyzeDiff2, handleCreateSelfReview: handleCreateSelfReview2 } = await import("./feedback-TMEGYMWU.js");
   const [diffResult, reviewResult] = await Promise.all([
     handleAnalyzeDiff2({ diff, path: projectPath }),
     handleCreateSelfReview2({ path: projectPath, diff })
@@ -4693,6 +5020,8 @@ async function runStandardReview(projectPath, diff, diffLines, downgraded) {
     ...extractFindings(diffParsed, "findings", "warnings"),
     ...extractFindings(reviewParsed, "findings", "items")
   ];
+  const sorted = sortFindingsBySeverity(findings);
+  const paged = paginate(sorted, offset ?? 0, limit ?? 20);
   return {
     content: [
       {
@@ -4700,7 +5029,8 @@ async function runStandardReview(projectPath, diff, diffLines, downgraded) {
         text: JSON.stringify({
           depth: "standard",
           downgraded,
-          findings,
+          findings: paged.items,
+          pagination: paged.pagination,
           diffAnalysis: diffParsed,
           selfReview: reviewParsed,
           fileCount: extractFileCount(diffParsed),
@@ -4710,12 +5040,19 @@ async function runStandardReview(projectPath, diff, diffLines, downgraded) {
     ]
   };
 }
-async function runDeepReview(projectPath, diff, diffLines, _downgraded) {
-  const { handleRunCodeReview: handleRunCodeReview2 } = await import("./review-pipeline-UAPVKI6W.js");
-  const result = await handleRunCodeReview2({ path: projectPath, diff });
+async function runDeepReview(projectPath, diff, diffLines, _downgraded, offset, limit) {
+  const { handleRunCodeReview: handleRunCodeReview2 } = await import("./review-pipeline-YXF5ITL2.js");
+  const result = await handleRunCodeReview2({
+    path: projectPath,
+    diff,
+    _skipPagination: true
+  });
   const deepContent = result.content[0];
   if (!deepContent) throw new Error("Empty code review response");
   const parsed = JSON.parse(deepContent.text);
+  const rawFindings = parsed.findings ?? [];
+  const sorted = sortFindingsBySeverity(rawFindings);
+  const paged = paginate(sorted, offset ?? 0, limit ?? 20);
   return {
     content: [
       {
@@ -4723,7 +5060,8 @@ async function runDeepReview(projectPath, diff, diffLines, _downgraded) {
         text: JSON.stringify({
           depth: "deep",
           downgraded: false,
-          findings: parsed.findings ?? [],
+          findings: paged.items,
+          pagination: paged.pagination,
           assessment: parsed.assessment,
           findingCount: parsed.findingCount,
           lineCount: diffLines,
@@ -4782,7 +5120,7 @@ async function handleCheckTaskIndependence(input) {
   try {
     const projectPath = sanitizePath(input.path);
     const store = await loadGraphStore(projectPath);
-    const { TaskIndependenceAnalyzer } = await import("./dist-M6FBUXZD.js");
+    const { TaskIndependenceAnalyzer } = await import("./dist-QW5G3GX3.js");
     const analyzer = new TaskIndependenceAnalyzer(store ?? void 0);
     const result = analyzer.analyze({
       tasks: input.tasks,
@@ -4870,7 +5208,7 @@ async function handlePredictConflicts(input) {
   try {
     const projectPath = sanitizePath(input.path);
     const store = await loadGraphStore(projectPath);
-    const { ConflictPredictor } = await import("./dist-M6FBUXZD.js");
+    const { ConflictPredictor } = await import("./dist-QW5G3GX3.js");
     const predictor = new ConflictPredictor(store ?? void 0);
     const result = predictor.predict({
       tasks: input.tasks,
@@ -4976,7 +5314,7 @@ async function handleDetectStaleConstraints(input) {
         isError: true
       };
     }
-    const { loadGraphStore: loadGraphStore2 } = await import("./graph-loader-OLSOE537.js");
+    const { loadGraphStore: loadGraphStore2 } = await import("./graph-loader-M6FXJAKK.js");
     const store = await loadGraphStore2(projectPath);
     if (!store) {
       return {
@@ -4997,7 +5335,7 @@ async function handleDetectStaleConstraints(input) {
         ]
       };
     }
-    const { detectStaleConstraints } = await import("./dist-27IJJDWG.js");
+    const { detectStaleConstraints } = await import("./dist-7EBSGAHX.js");
     const result = detectStaleConstraints(
       store,
       windowDays,
@@ -5114,10 +5452,10 @@ function countCriticalFindings(securityData) {
   return findings.filter((f) => f.severity === "error").length;
 }
 async function runHealthChecks(projectPath) {
-  const { handleAssessProject: handleAssessProject2 } = await import("./assess-project-7HE2Z5PW.js");
-  const { handleCheckDependencies: handleCheckDependencies2 } = await import("./architecture-MCCHZWOK.js");
-  const { handleDetectEntropy: handleDetectEntropy2 } = await import("./entropy-RSH5D63W.js");
-  const { handleRunSecurityScan: handleRunSecurityScan2 } = await import("./security-IP5IJTB7.js");
+  const { handleAssessProject: handleAssessProject2 } = await import("./assess-project-74UVWPMB.js");
+  const { handleCheckDependencies: handleCheckDependencies2 } = await import("./architecture-FBSLURIB.js");
+  const { handleDetectEntropy: handleDetectEntropy2 } = await import("./entropy-ZAY73R6A.js");
+  const { handleRunSecurityScan: handleRunSecurityScan2 } = await import("./security-L2YN3CTI.js");
   const [assessResult, depsResult, entropyResult, securityResult] = await Promise.all([
     handleAssessProject2({
       path: projectPath,
@@ -5172,10 +5510,10 @@ function avg(values) {
 }
 async function runGraphMetrics(projectPath) {
   try {
-    const { loadGraphStore: loadGraphStore2 } = await import("./graph-loader-OLSOE537.js");
+    const { loadGraphStore: loadGraphStore2 } = await import("./graph-loader-M6FXJAKK.js");
     const store = await loadGraphStore2(projectPath);
     if (!store) return ZERO_METRICS;
-    const { GraphCouplingAdapter, GraphComplexityAdapter, GraphAnomalyAdapter } = await import("./dist-M6FBUXZD.js");
+    const { GraphCouplingAdapter, GraphComplexityAdapter, GraphAnomalyAdapter } = await import("./dist-QW5G3GX3.js");
     const couplingAdapter = new GraphCouplingAdapter(store);
     const couplingData = couplingAdapter.computeCouplingData();
     const files = couplingData.files;
@@ -5266,10 +5604,11 @@ async function handleSearchSkills(input) {
   const snapshot = loadCachedSnapshot(projectRoot);
   const freshSnapshot = snapshot && isSnapshotFresh(snapshot, projectRoot) ? snapshot : void 0;
   const queryTerms = query.toLowerCase().split(/\s+/).filter((t) => t.length > 2);
+  const MIN_SCORE = 0.25;
   const results = [];
   for (const [name, entry] of Object.entries(index.skills)) {
     const score = scoreSkill(entry, queryTerms, profile, [], name, freshSnapshot);
-    if (score > 0 || queryTerms.length === 0) {
+    if (score >= MIN_SCORE || queryTerms.length === 0) {
       results.push({
         name,
         description: entry.description,
@@ -5870,6 +6209,14 @@ var getDecayTrendsDefinition = {
           "module-size",
           "dependency-depth"
         ]
+      },
+      offset: {
+        type: "number",
+        description: "Number of trend entries to skip (pagination). Default: 0. Trends are sorted by decay magnitude (absolute delta) desc. Ignored when category is set (category filter returns a single entry)."
+      },
+      limit: {
+        type: "number",
+        description: "Max trend entries to return (pagination). Default: 20. Ignored when category is set (category filter returns a single entry)."
       }
     },
     required: ["path"]
@@ -5891,7 +6238,7 @@ async function handleGetDecayTrends(input) {
     };
   }
   try {
-    const core = await import("./dist-27IJJDWG.js");
+    const core = await import("./dist-7EBSGAHX.js");
     const { TimelineManager } = core;
     const manager = new TimelineManager(projectPath);
     const timeline = manager.load();
@@ -5909,9 +6256,14 @@ async function handleGetDecayTrends(input) {
     if (input.last !== void 0) trendOptions.last = input.last;
     if (input.since !== void 0) trendOptions.since = input.since;
     const trends = manager.trends(trendOptions);
+    const categoryEntries = Object.entries(trends.categories).map(([name, trend]) => ({
+      category: name,
+      ...trend
+    }));
+    categoryEntries.sort((a, b) => Math.abs(b.delta) - Math.abs(a.delta));
     if (input.category) {
-      const categoryTrend = trends.categories[input.category];
-      if (!categoryTrend) {
+      const match = categoryEntries.find((e) => e.category === input.category);
+      if (!match) {
         return {
           content: [
             {
@@ -5928,7 +6280,12 @@ async function handleGetDecayTrends(input) {
             text: JSON.stringify(
               {
                 category: input.category,
-                trend: categoryTrend,
+                trend: {
+                  current: match.current,
+                  previous: match.previous,
+                  delta: match.delta,
+                  direction: match.direction
+                },
                 snapshotCount: trends.snapshotCount,
                 from: trends.from,
                 to: trends.to
@@ -5940,11 +6297,23 @@ async function handleGetDecayTrends(input) {
         ]
       };
     }
+    const paged = paginate(categoryEntries, input.offset ?? 0, input.limit ?? 20);
     return {
       content: [
         {
           type: "text",
-          text: JSON.stringify(trends, null, 2)
+          text: JSON.stringify(
+            {
+              stability: trends.stability,
+              categories: paged.items,
+              snapshotCount: trends.snapshotCount,
+              from: trends.from,
+              to: trends.to,
+              pagination: paged.pagination
+            },
+            null,
+            2
+          )
         }
       ]
     };
@@ -5975,6 +6344,14 @@ var codeOutlineDefinition = {
       glob: {
         type: "string",
         description: 'Optional glob pattern to filter files (e.g. "*.ts", "src/**/*.py"). Only used when path is a directory.'
+      },
+      offset: {
+        type: "number",
+        description: "Number of file entries to skip (pagination, directory mode only). Default: 0. Files are sorted by modification time desc."
+      },
+      limit: {
+        type: "number",
+        description: "Max file entries to return (pagination, directory mode only). Default: 30."
       }
     },
     required: ["path"]
@@ -5996,7 +6373,7 @@ async function handleCodeOutline(input) {
     };
   }
   try {
-    const { getOutline, formatOutline, EXTENSION_MAP } = await import("./dist-27IJJDWG.js");
+    const { getOutline, formatOutline, EXTENSION_MAP } = await import("./dist-7EBSGAHX.js");
     const { stat } = await import("fs/promises");
     const stats = await stat(targetPath).catch(() => null);
     if (stats?.isFile()) {
@@ -6008,19 +6385,31 @@ async function handleCodeOutline(input) {
       const exts = Object.keys(EXTENSION_MAP).map((e) => e.slice(1));
       const pattern = input.glob ?? `**/*.{${exts.join(",")}}`;
       const files = await glob(pattern, { cwd: targetPath, absolute: true });
+      const fileStats = await Promise.all(
+        files.map(async (f) => {
+          const fStat = await stat(f).catch(() => null);
+          return { path: f, mtimeMs: fStat?.mtimeMs ?? 0 };
+        })
+      );
+      fileStats.sort((a, b) => b.mtimeMs - a.mtimeMs);
+      const { paginate: paginate2 } = await import("./dist-7EBSGAHX.js");
+      const paged = paginate2(fileStats, input.offset ?? 0, input.limit ?? 30);
       const results = [];
-      const MAX_FILES = 50;
-      for (const file of files.slice(0, MAX_FILES)) {
-        const outline = await getOutline(file);
+      for (const entry of paged.items) {
+        const outline = await getOutline(entry.path);
         results.push(formatOutline(outline));
       }
-      if (files.length > MAX_FILES) {
-        results.push(
-          `
-... and ${files.length - MAX_FILES} more files (use a narrower glob to see them)`
-        );
-      }
-      return { content: [{ type: "text", text: results.join("\n\n") }] };
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify({
+              outlines: results.join("\n\n"),
+              pagination: paged.pagination
+            })
+          }
+        ]
+      };
     }
     return {
       content: [{ type: "text", text: `Error: Path not found: ${targetPath}` }],
@@ -6076,7 +6465,7 @@ async function handleCodeSearch(input) {
     };
   }
   try {
-    const { searchSymbols } = await import("./dist-27IJJDWG.js");
+    const { searchSymbols } = await import("./dist-7EBSGAHX.js");
     const result = await searchSymbols(input.query, directory, input.glob);
     const lines = [`Search: "${result.query}" \u2014 ${result.matches.length} matches`];
     for (const match of result.matches) {
@@ -6145,7 +6534,7 @@ async function handleCodeUnfold(input) {
   }
   try {
     if (input.symbol) {
-      const { unfoldSymbol } = await import("./dist-27IJJDWG.js");
+      const { unfoldSymbol } = await import("./dist-7EBSGAHX.js");
       const result = await unfoldSymbol(filePath, input.symbol);
       const header = result.warning ? `${result.file}:${result.startLine}-${result.endLine} ${result.warning}
 ` : `${result.file}:${result.startLine}-${result.endLine}
@@ -6153,7 +6542,7 @@ async function handleCodeUnfold(input) {
       return { content: [{ type: "text", text: header + result.content }] };
     }
     if (input.startLine != null && input.endLine != null) {
-      const { unfoldRange } = await import("./dist-27IJJDWG.js");
+      const { unfoldRange } = await import("./dist-7EBSGAHX.js");
       const result = await unfoldRange(filePath, input.startLine, input.endLine);
       const header = `${result.file}:${result.startLine}-${result.endLine}
 `;
@@ -6215,7 +6604,7 @@ async function handleCheckTraceability(input) {
         isError: true
       };
     }
-    const { queryTraceability } = await import("./dist-M6FBUXZD.js");
+    const { queryTraceability } = await import("./dist-QW5G3GX3.js");
     const options = {};
     if (input.spec) options.specPath = input.spec;
     if (input.feature) options.featureName = input.feature;
@@ -6338,7 +6727,7 @@ async function handlePredictFailures(input) {
     };
   }
   try {
-    const core = await import("./dist-27IJJDWG.js");
+    const core = await import("./dist-7EBSGAHX.js");
     const { TimelineManager, PredictionEngine, SpecImpactEstimator } = core;
     const manager = new TimelineManager(projectPath);
     const includeRoadmap = input.includeRoadmap !== false;
@@ -6440,6 +6829,244 @@ async function handleRecommendSkills(input) {
   };
 }
 
+// src/mcp/tools/compact.ts
+var COMPACT_TOOL_DEFAULT_BUDGET = 2e3;
+var compactToolDefinition = {
+  name: "compact",
+  description: "Compact content, resolve intents into aggregated packed responses, or re-compress prior tool output. Returns a packed envelope with source attribution and reduction metadata.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      path: { type: "string", description: "Path to project root" },
+      content: {
+        type: "string",
+        description: "Content string to compact directly (Mode A)"
+      },
+      intent: {
+        type: "string",
+        description: "Intent description \u2014 aggregates context via graph search then packs (Mode B)"
+      },
+      ref: {
+        type: "object",
+        properties: {
+          source: { type: "string", description: "Source label for attribution" },
+          content: { type: "string", description: "Content to re-compress" }
+        },
+        required: ["source", "content"],
+        description: "Re-compress prior tool output with source attribution (Mode C)"
+      },
+      strategies: {
+        type: "array",
+        items: { type: "string", enum: ["structural", "truncate", "pack", "semantic"] },
+        description: "Strategies to apply (default: structural + truncate)"
+      },
+      tokenBudget: {
+        type: "number",
+        description: "Token budget for compacted output (default: 2000)"
+      }
+    },
+    required: []
+  }
+};
+var KNOWN_STRATEGIES = /* @__PURE__ */ new Set(["structural", "truncate", "pack", "semantic"]);
+function buildPipeline(strategies) {
+  const names = strategies ?? ["structural", "truncate"];
+  const unknownStrategies = names.filter((name) => !KNOWN_STRATEGIES.has(name));
+  const instances = names.map((name) => {
+    switch (name) {
+      case "structural":
+        return new StructuralStrategy();
+      case "truncate":
+        return new TruncationStrategy();
+      case "pack":
+        return new StructuralStrategy();
+      case "semantic":
+        return new StructuralStrategy();
+      default:
+        return null;
+    }
+  }).filter(Boolean);
+  return { pipeline: new CompactionPipeline(instances), unknownStrategies };
+}
+function buildEnvelope(originalContent, compactedSections, strategyNames, cached) {
+  const originalTokens = estimateTokens(originalContent);
+  const compactedTokens = compactedSections.reduce((sum, s) => sum + estimateTokens(s.content), 0);
+  const reductionPct = originalTokens > 0 ? Math.round((1 - compactedTokens / originalTokens) * 100) : 0;
+  return {
+    meta: {
+      strategy: strategyNames,
+      originalTokenEstimate: originalTokens,
+      compactedTokenEstimate: compactedTokens,
+      reductionPct,
+      cached
+    },
+    sections: compactedSections
+  };
+}
+function handleContentMode(content, pipeline, budget, source) {
+  const compacted = pipeline.apply(content, budget);
+  const envelope = buildEnvelope(
+    content,
+    [{ source, content: compacted }],
+    pipeline.strategyNames,
+    false
+  );
+  return {
+    content: [{ type: "text", text: serializeEnvelope(envelope) }]
+  };
+}
+async function handleIntentMode(projectPath, intent, pipeline, budget, filterContent) {
+  const { loadGraphStore: loadGraphStore2 } = await import("./graph-loader-M6FXJAKK.js");
+  const store = await loadGraphStore2(projectPath);
+  if (!store) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: "No graph found. Run `harness scan` or use `ingest_source` tool first."
+        }
+      ],
+      isError: true
+    };
+  }
+  const { PackedSummaryCache, FusionLayer, ContextQL } = await import("./dist-QW5G3GX3.js");
+  const cache = new PackedSummaryCache(store);
+  const cachedEnvelope = cache.get(intent);
+  if (cachedEnvelope) {
+    return {
+      content: [
+        { type: "text", text: serializeEnvelope(cachedEnvelope) }
+      ]
+    };
+  }
+  const fusion = new FusionLayer(store);
+  const cql = new ContextQL(store);
+  const searchQuery = filterContent ? `${intent} ${filterContent}` : intent;
+  const searchResults = fusion.search(searchQuery, 10);
+  if (searchResults.length === 0) {
+    const envelope2 = {
+      meta: {
+        strategy: pipeline.strategyNames,
+        originalTokenEstimate: 0,
+        compactedTokenEstimate: 0,
+        reductionPct: 0,
+        cached: false
+      },
+      sections: [{ source: "compact", content: "No relevant context found for intent." }]
+    };
+    return {
+      content: [{ type: "text", text: serializeEnvelope(envelope2) }]
+    };
+  }
+  const totalScore = searchResults.reduce((sum, r) => sum + r.score, 0);
+  const sections = [];
+  const sourceNodeIds = [];
+  let totalOriginalChars = 0;
+  for (const result of searchResults) {
+    const resultBudget = totalScore > 0 ? Math.floor(budget * (result.score / totalScore)) : Math.floor(budget / searchResults.length);
+    const expanded = cql.execute({
+      rootNodeIds: [result.nodeId],
+      maxDepth: 2
+    });
+    const rawContent = JSON.stringify({
+      rootNode: result.nodeId,
+      score: result.score,
+      nodes: expanded.nodes,
+      edges: expanded.edges
+    });
+    totalOriginalChars += rawContent.length;
+    const compacted = pipeline.apply(rawContent, resultBudget);
+    sections.push({ source: result.nodeId, content: compacted });
+    sourceNodeIds.push(result.nodeId);
+  }
+  const originalTokens = Math.ceil(totalOriginalChars / 4);
+  const compactedTokens = sections.reduce((sum, s) => sum + estimateTokens(s.content), 0);
+  const reductionPct = originalTokens > 0 ? Math.round((1 - compactedTokens / originalTokens) * 100) : 0;
+  const envelope = {
+    meta: {
+      strategy: pipeline.strategyNames,
+      originalTokenEstimate: originalTokens,
+      compactedTokenEstimate: compactedTokens,
+      reductionPct,
+      cached: false
+    },
+    sections
+  };
+  cache.set(intent, envelope, sourceNodeIds);
+  return {
+    content: [{ type: "text", text: serializeEnvelope(envelope) }]
+  };
+}
+async function handleCompact(input) {
+  if (input.intent && !input.path) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: "Error: 'path' is required when using intent mode."
+        }
+      ],
+      isError: true
+    };
+  }
+  let safePath;
+  if (input.path) {
+    try {
+      safePath = sanitizePath(input.path);
+    } catch (error) {
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Error: ${error instanceof Error ? error.message : String(error)}`
+          }
+        ],
+        isError: true
+      };
+    }
+  }
+  if (input.content && input.ref && !input.intent) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: "Error: Cannot provide both 'content' and 'ref'. Use one or the other."
+        }
+      ],
+      isError: true
+    };
+  }
+  const budget = input.tokenBudget ?? COMPACT_TOOL_DEFAULT_BUDGET;
+  const { pipeline, unknownStrategies } = buildPipeline(input.strategies);
+  const strategyWarning = unknownStrategies.length > 0 ? `
+Warning: unknown strategies ignored: ${unknownStrategies.join(", ")}` : "";
+  if (input.content && !input.intent) {
+    const result = handleContentMode(input.content, pipeline, budget, "content");
+    if (strategyWarning && result.content?.[0]) result.content[0].text += strategyWarning;
+    return result;
+  }
+  if (input.ref) {
+    const result = handleContentMode(input.ref.content, pipeline, budget, input.ref.source);
+    if (strategyWarning && result.content?.[0]) result.content[0].text += strategyWarning;
+    return result;
+  }
+  if (input.intent) {
+    const result = await handleIntentMode(safePath, input.intent, pipeline, budget, input.content);
+    if (strategyWarning && !result.isError && result.content?.[0])
+      result.content[0].text += strategyWarning;
+    return result;
+  }
+  return {
+    content: [
+      {
+        type: "text",
+        text: "Error: must provide at least one of: content, intent, or ref"
+      }
+    ],
+    isError: true
+  };
+}
+
 // src/mcp/server.ts
 var TOOL_DEFINITIONS = [
   validateToolDefinition,
@@ -6496,7 +7123,8 @@ var TOOL_DEFINITIONS = [
   predictFailuresDefinition,
   recommendSkillsDefinition,
   computeBlastRadiusDefinition,
-  dispatchSkillsDefinition
+  dispatchSkillsDefinition,
+  compactToolDefinition
 ].map((def) => ({ ...def, trustedOutput: true }));
 var TOOL_HANDLERS = {
   validate_project: handleValidateProject,
@@ -6553,56 +7181,65 @@ var TOOL_HANDLERS = {
   predict_failures: handlePredictFailures,
   recommend_skills: handleRecommendSkills,
   compute_blast_radius: handleComputeBlastRadius,
-  dispatch_skills: handleDispatchSkills
+  dispatch_skills: handleDispatchSkills,
+  compact: handleCompact
 };
 var RESOURCE_DEFINITIONS = [
   {
     uri: "harness://skills",
     name: "Harness Skills",
     description: "Available skills with metadata (name, description, cognitive_mode, type, triggers)",
-    mimeType: "application/json"
+    mimeType: "application/json",
+    _meta: { stability: "session" }
   },
   {
     uri: "harness://rules",
     name: "Harness Rules",
     description: "Active linter rules and constraints from harness config",
-    mimeType: "application/json"
+    mimeType: "application/json",
+    _meta: { stability: "session" }
   },
   {
     uri: "harness://project",
     name: "Project Context",
     description: "Project structure and agent instructions from AGENTS.md",
-    mimeType: "text/markdown"
+    mimeType: "text/markdown",
+    _meta: { stability: "session" }
   },
   {
     uri: "harness://learnings",
     name: "Learnings",
     description: "Review learnings and anti-pattern log from .harness/",
-    mimeType: "text/markdown"
+    mimeType: "text/markdown",
+    _meta: { stability: "session" }
   },
   {
     uri: "harness://state",
     name: "Project State",
     description: "Current harness state including position, progress, decisions, and blockers",
-    mimeType: "application/json"
+    mimeType: "application/json",
+    _meta: { stability: "ephemeral" }
   },
   {
     uri: "harness://graph",
     name: "Knowledge Graph",
     description: "Graph statistics, node/edge counts by type, staleness",
-    mimeType: "application/json"
+    mimeType: "application/json",
+    _meta: { stability: "session" }
   },
   {
     uri: "harness://entities",
     name: "Graph Entities",
     description: "All entity nodes with types and metadata",
-    mimeType: "application/json"
+    mimeType: "application/json",
+    _meta: { stability: "session" }
   },
   {
     uri: "harness://relationships",
     name: "Graph Relationships",
     description: "All edges with types, confidence scores, and timestamps",
-    mimeType: "application/json"
+    mimeType: "application/json",
+    _meta: { stability: "session" }
   }
 ];
 var RESOURCE_HANDLERS = {
@@ -6639,7 +7276,7 @@ async function appendUpdateNotification(result, resolvedRoot) {
       shouldRunCheck,
       readCheckState,
       spawnBackgroundCheck
-    } = await import("./dist-27IJJDWG.js");
+    } = await import("./dist-7EBSGAHX.js");
     const { CLI_VERSION } = await import("./version-KFFPOQAX.js");
     const configInterval = readConfigInterval(resolvedRoot);
     const DEFAULT_INTERVAL = 864e5;
@@ -6699,6 +7336,7 @@ function createHarnessServer(projectRoot, toolFilter) {
     projectRoot: resolvedRoot,
     trustedOutputTools
   });
+  const compactedHandlers = applyCompaction(guardedHandlers);
   const server = new Server(
     { name: "harness-engineering", version: "0.1.0" },
     { capabilities: { tools: {}, resources: {} } }
@@ -6708,7 +7346,7 @@ function createHarnessServer(projectRoot, toolFilter) {
   server.setRequestHandler(
     CallToolRequestSchema,
     async (request) => dispatchTool(
-      guardedHandlers,
+      compactedHandlers,
       request.params.name,
       request.params.arguments,
       resolvedRoot,
@@ -6736,6 +7374,7 @@ export {
   createGenerateSlashCommandsCommand,
   handleGetImpact,
   persistToolingConfig,
+  ensureHarnessGitignore,
   appendFrameworkAgents,
   loadOrRebuildIndex,
   isSnapshotFresh,