@harness-engineering/cli 1.24.1 → 1.24.3

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

@@ -5,38 +5,39 @@ import {
   handleCreateSelfReview,
   handleRequestPeerReview,
   requestPeerReviewDefinition
-} from "./chunk-BWWNQPPO.js";
+} from "./chunk-YPKKEP3O.js";
 import {
   handleRunSecurityScan,
   runSecurityScanDefinition
-} from "./chunk-HVFCCARH.js";
+} from "./chunk-UFQQBGC3.js";
 import {
   handleRunCodeReview,
-  runCodeReviewDefinition
-} from "./chunk-C5FTJ3EU.js";
+  runCodeReviewDefinition,
+  sortFindingsBySeverity
+} from "./chunk-L5UONZ53.js";
 import {
   assessProjectDefinition,
   handleAssessProject
-} from "./chunk-2DAMN7ED.js";
+} from "./chunk-FJYP32IV.js";
 import {
   handleValidateProject,
   validateToolDefinition
-} from "./chunk-JT732X6S.js";
+} from "./chunk-WEN5Z7CL.js";
 import {
   checkDependenciesDefinition,
   handleCheckDependencies
-} from "./chunk-NU3BPEDR.js";
+} from "./chunk-A737JDL4.js";
 import {
   resolveProjectConfig
 } from "./chunk-Q3XYV5UC.js";
 import {
   checkDocsDefinition,
   handleCheckDocs
-} from "./chunk-TUJAHI22.js";
+} from "./chunk-TB427QOK.js";
 import {
   detectEntropyDefinition,
   handleDetectEntropy
-} from "./chunk-JGMCHJ6B.js";
+} from "./chunk-V2FGX2KD.js";
 import {
   checkPerformanceDefinition,
   getCriticalPathsDefinition,
@@ -46,17 +47,17 @@ import {
   handleGetPerfBaselines,
   handleUpdatePerfBaselines,
   updatePerfBaselinesDefinition
-} from "./chunk-MS6KDQW7.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-AVVJ5EUU.js";
+} from "./chunk-5PMRARB5.js";
 import {
   GENERATED_HEADER_CLAUDE,
   GENERATED_HEADER_CODEX,
@@ -88,10 +89,11 @@ import {
   checkTaint,
   detectChangeType,
   estimateTokens,
+  paginate,
   scanForInjection,
   serializeEnvelope,
   writeTaint
-} from "./chunk-PCWYYFBP.js";
+} from "./chunk-H4U2QNY2.js";
 import {
   Err,
   Ok
@@ -240,21 +242,22 @@ var DEFAULT_PIPELINE = new CompactionPipeline([
   new StructuralStrategy(),
   new TruncationStrategy()
 ]);
-function buildHeader(orig, comp) {
+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: ${DEFAULT_PIPELINE.strategyNames.join("+")} | ${orig}\u2192${comp} tokens (-${pct}%) -->`;
+  return `<!-- packed: ${pipeline.strategyNames.join("+")} | ${orig}\u2192${comp} tokens (-${pct}%) -->`;
 }
-function compactText(text) {
-  return DEFAULT_PIPELINE.apply(text, DEFAULT_TOKEN_BUDGET);
+function compactText(text, pipeline, budget) {
+  return pipeline.apply(text, budget);
 }
-function compactResult(result) {
+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));
+  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(origTok, compTok));
-  const header = buildHeader(origTok, compTok + hdrTok);
+  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;
@@ -268,6 +271,32 @@ ${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") {
@@ -278,7 +307,10 @@ function wrapWithCompaction(toolName, handler) {
     }
     const result = await handler(input);
     try {
-      return compactResult(result);
+      if (LOSSLESS_ONLY_TOOLS.has(toolName)) {
+        return compactResultWith(result, LOSSLESS_PIPELINE);
+      }
+      return compactResultWith(result, DEFAULT_PIPELINE, DEFAULT_TOKEN_BUDGET);
     } catch {
       return result;
     }
@@ -651,7 +683,7 @@ ${skippedMsg}`
 async function handleInitProject(input) {
   const i = input;
   try {
-    const { TemplateEngine } = await import("./engine-CSITRE3J.js");
+    const { TemplateEngine } = await import("./engine-VUQEAJFZ.js");
     const engine = new TemplateEngine(resolveTemplatesDir());
     const safePath = sanitizePath(i.path);
     const detected = tryDetectFramework(engine, safePath, i);
@@ -672,7 +704,7 @@ var listPersonasDefinition = {
   inputSchema: { type: "object", properties: {} }
 };
 async function handleListPersonas() {
-  const { listPersonas } = await import("./loader-P2P7CV2A.js");
+  const { listPersonas } = await import("./loader-Y6A42WBD.js");
   const result = listPersonas(resolvePersonasDir());
   return resultToMcpResponse(result);
 }
@@ -696,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-P2P7CV2A.js");
-  const { generateRuntime } = await import("./runtime-VMOIIP6B.js");
-  const { generateAgentsMd } = await import("./agents-md-MMVRF77L.js");
-  const { generateCIWorkflow } = await import("./ci-workflow-HDH4LCOF.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)) {
@@ -754,7 +786,7 @@ 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-P2P7CV2A.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();
@@ -1134,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,
@@ -1518,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-TZQUURSP.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;
@@ -1545,7 +1576,7 @@ async function triggerExternalSync(projectPath, roadmapFile) {
     }
     const token = process.env.GITHUB_TOKEN;
     if (!token) return;
-    const { fullSync, GitHubIssuesSyncAdapter } = await import("./dist-TZQUURSP.js");
+    const { fullSync, GitHubIssuesSyncAdapter } = await import("./dist-7EBSGAHX.js");
     const adapter = new GitHubIssuesSyncAdapter({
       token,
       config: trackerConfig
@@ -1657,12 +1688,12 @@ var manageStateDefinition = {
   }
 };
 async function handleShow(projectPath, input) {
-  const { loadState } = await import("./dist-TZQUURSP.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-TZQUURSP.js");
+  const { appendLearning } = await import("./dist-7EBSGAHX.js");
   const result = await appendLearning(
     projectPath,
     input.learning,
@@ -1677,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-TZQUURSP.js");
+  const { appendFailure } = await import("./dist-7EBSGAHX.js");
   const result = await appendFailure(
     projectPath,
     input.description,
@@ -1690,24 +1721,24 @@ async function handleFailure(projectPath, input) {
   return resultToMcpResponse(Ok({ recorded: true }));
 }
 async function handleArchive(projectPath, input) {
-  const { archiveFailures } = await import("./dist-TZQUURSP.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-TZQUURSP.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-TZQUURSP.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-TZQUURSP.js");
+  const { saveHandoff } = await import("./dist-7EBSGAHX.js");
   const result = await saveHandoff(
     projectPath,
     input.handoff,
@@ -1719,7 +1750,7 @@ async function handleSaveHandoff(projectPath, input) {
   return resultToMcpResponse(Ok({ saved: true }));
 }
 async function handleLoadHandoff(projectPath, input) {
-  const { loadHandoff } = await import("./dist-TZQUURSP.js");
+  const { loadHandoff } = await import("./dist-7EBSGAHX.js");
   return resultToMcpResponse(await loadHandoff(projectPath, input.stream, input.session));
 }
 async function handleAppendEntry(projectPath, input) {
@@ -1727,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-TZQUURSP.js");
+  const { appendSessionEntry } = await import("./dist-7EBSGAHX.js");
   const result = await appendSessionEntry(
     projectPath,
     input.session,
@@ -1743,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-TZQUURSP.js");
+  const { updateSessionEntryStatus } = await import("./dist-7EBSGAHX.js");
   const result = await updateSessionEntryStatus(
     projectPath,
     input.session,
@@ -1756,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-TZQUURSP.js");
+  const { readSessionSection } = await import("./dist-7EBSGAHX.js");
   const result = await readSessionSection(
     projectPath,
     input.session,
@@ -1766,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-TZQUURSP.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-TZQUURSP.js");
+  const { archiveSession } = await import("./dist-7EBSGAHX.js");
   const result = await archiveSession(projectPath, input.session);
   if (!result.ok) return resultToMcpResponse(result);
   await autoSyncRoadmap(projectPath);
@@ -1836,7 +1867,7 @@ var listStreamsDefinition = {
 };
 async function handleListStreams(input) {
   try {
-    const { listStreams, loadStreamIndex } = await import("./dist-TZQUURSP.js");
+    const { listStreams, loadStreamIndex } = await import("./dist-7EBSGAHX.js");
     const projectPath = sanitizePath(input.path);
     const indexResult = await loadStreamIndex(projectPath);
     const streamsResult = await listStreams(projectPath);
@@ -1874,7 +1905,7 @@ var checkPhaseGateDefinition = {
 };
 async function handleCheckPhaseGate(input) {
   try {
-    const { runCheckPhaseGate } = await import("./check-phase-gate-YQHAH4LL.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) }] };
@@ -1930,7 +1961,7 @@ async function handleValidateCrossCheck(input) {
     };
   }
   try {
-    const { runCrossCheck } = await import("./validate-cross-check-M4NP2UF5.js");
+    const { runCrossCheck } = await import("./validate-cross-check-Y4PDR63C.js");
     const specsDir = path12.resolve(projectPath, input.specsDir ?? "docs/specs");
     if (!specsDir.startsWith(projectPath)) {
       return {
@@ -2650,7 +2681,7 @@ async function handleGenerateSlashCommands(input) {
 // src/mcp/resources/state.ts
 async function getStateResource(projectRoot) {
   try {
-    const { loadState, migrateToStreams } = await import("./dist-TZQUURSP.js");
+    const { loadState, migrateToStreams } = await import("./dist-7EBSGAHX.js");
     await migrateToStreams(projectRoot);
     const result = await loadState(projectRoot);
     if (result.ok) {
@@ -2728,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"]
@@ -2776,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: [
@@ -2956,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"]
@@ -3006,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: [
         {
@@ -3014,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
           })
         }
       ]
@@ -3269,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"]
@@ -3285,8 +3376,17 @@ async function handleDetectAnomalies(input) {
       ...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 {
@@ -3583,7 +3683,7 @@ var generateAgentDefinitionsDefinition = {
   }
 };
 async function handleGenerateAgentDefinitions(input) {
-  const { generateAgentDefinitions } = await import("./generate-agent-definitions-OLYWXTYH.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],
@@ -3910,7 +4010,7 @@ function shouldTriggerExternalSync(input, response) {
 }
 async function handleManageRoadmap(input) {
   try {
-    const { parseRoadmap, serializeRoadmap, syncRoadmap, applySyncChanges, assignFeature } = await import("./dist-TZQUURSP.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 = {
@@ -4345,7 +4445,7 @@ async function handleTransition(validInput, projectPath, id) {
   const transition = transitionResult.data;
   const prompt = renderTransition(transition);
   try {
-    const { saveHandoff } = await import("./dist-TZQUURSP.js");
+    const { saveHandoff } = await import("./dist-7EBSGAHX.js");
     await saveHandoff(
       projectPath,
       {
@@ -4413,7 +4513,7 @@ async function handleEmitInteraction(input) {
 }
 async function recordInteraction(projectPath, id, type, decision, stream) {
   try {
-    const { loadState, saveState } = await import("./dist-TZQUURSP.js");
+    const { loadState, saveState } = await import("./dist-7EBSGAHX.js");
     const stateResult = await loadState(projectPath, stream);
     if (stateResult.ok) {
       const state = stateResult.value;
@@ -4429,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.",
@@ -4477,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"]
@@ -4502,10 +4659,10 @@ async function handleGatherContext(input) {
     input.include ?? ["state", "learnings", "handoff", "graph", "validation"]
   );
   const errors = [];
-  const statePromise = includeSet.has("state") ? import("./dist-TZQUURSP.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-TZQUURSP.js").then(
+  const learningsPromise = includeSet.has("learnings") ? import("./dist-7EBSGAHX.js").then(
     (core) => core.loadBudgetedLearnings(projectPath, {
       intent: input.intent,
       tokenBudget: input.learningsBudget ?? 1e3,
@@ -4514,7 +4671,7 @@ async function handleGatherContext(input) {
       ...input.depth !== void 0 && { depth: input.depth }
     })
   ) : Promise.resolve(null);
-  const handoffPromise = includeSet.has("handoff") ? import("./dist-TZQUURSP.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 () => {
@@ -4558,11 +4715,11 @@ async function handleGatherContext(input) {
       context: contextBlocks
     };
   })() : Promise.resolve(null);
-  const sessionsPromise = includeSet.has("sessions") && input.session ? import("./dist-TZQUURSP.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-TZQUURSP.js").then(async (core) => {
+  const eventsPromise = shouldIncludeEvents ? import("./dist-7EBSGAHX.js").then(async (core) => {
     const result = await core.loadEvents(projectPath, {
       session: input.session
     });
@@ -4570,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-T7UTXLEQ.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;
@@ -4664,7 +4821,7 @@ async function handleGatherContext(input) {
   };
   if (input.session) {
     try {
-      const core = await import("./dist-TZQUURSP.js");
+      const core = await import("./dist-7EBSGAHX.js");
       core.updateSessionIndex(
         projectPath,
         input.session,
@@ -4676,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: [
       {
@@ -4708,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"]
@@ -4776,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: [
@@ -4789,12 +4970,15 @@ async function handleReviewChanges(input) {
     };
   }
 }
-async function runQuickReview(projectPath, diff, diffLines, downgraded) {
-  const { handleAnalyzeDiff: handleAnalyzeDiff2 } = await import("./feedback-RSPUJCJJ.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: [
       {
@@ -4802,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 } : {}
@@ -4820,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-RSPUJCJJ.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 })
@@ -4835,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: [
       {
@@ -4842,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),
@@ -4852,12 +5040,19 @@ async function runStandardReview(projectPath, diff, diffLines, downgraded) {
     ]
   };
 }
-async function runDeepReview(projectPath, diff, diffLines, _downgraded) {
-  const { handleRunCodeReview: handleRunCodeReview2 } = await import("./review-pipeline-XSRO7HYZ.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: [
       {
@@ -4865,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,
@@ -5139,7 +5335,7 @@ async function handleDetectStaleConstraints(input) {
         ]
       };
     }
-    const { detectStaleConstraints } = await import("./dist-TZQUURSP.js");
+    const { detectStaleConstraints } = await import("./dist-7EBSGAHX.js");
     const result = detectStaleConstraints(
       store,
       windowDays,
@@ -5256,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-7JZCVM7D.js");
-  const { handleCheckDependencies: handleCheckDependencies2 } = await import("./architecture-JAEDPYQZ.js");
-  const { handleDetectEntropy: handleDetectEntropy2 } = await import("./entropy-FZP643BK.js");
-  const { handleRunSecurityScan: handleRunSecurityScan2 } = await import("./security-4AQ46P3H.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,
@@ -5408,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,
@@ -6012,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"]
@@ -6033,7 +6238,7 @@ async function handleGetDecayTrends(input) {
     };
   }
   try {
-    const core = await import("./dist-TZQUURSP.js");
+    const core = await import("./dist-7EBSGAHX.js");
     const { TimelineManager } = core;
     const manager = new TimelineManager(projectPath);
     const timeline = manager.load();
@@ -6051,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: [
             {
@@ -6070,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
@@ -6082,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
+          )
         }
       ]
     };
@@ -6117,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"]
@@ -6138,7 +6373,7 @@ async function handleCodeOutline(input) {
     };
   }
   try {
-    const { getOutline, formatOutline, EXTENSION_MAP } = await import("./dist-TZQUURSP.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()) {
@@ -6150,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}` }],
@@ -6218,7 +6465,7 @@ async function handleCodeSearch(input) {
     };
   }
   try {
-    const { searchSymbols } = await import("./dist-TZQUURSP.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) {
@@ -6287,7 +6534,7 @@ async function handleCodeUnfold(input) {
   }
   try {
     if (input.symbol) {
-      const { unfoldSymbol } = await import("./dist-TZQUURSP.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}
@@ -6295,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-TZQUURSP.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}
 `;
@@ -6480,7 +6727,7 @@ async function handlePredictFailures(input) {
     };
   }
   try {
-    const core = await import("./dist-TZQUURSP.js");
+    const core = await import("./dist-7EBSGAHX.js");
     const { TimelineManager, PredictionEngine, SpecImpactEstimator } = core;
     const manager = new TimelineManager(projectPath);
     const includeRoadmap = input.includeRoadmap !== false;
@@ -7029,7 +7276,7 @@ async function appendUpdateNotification(result, resolvedRoot) {
       shouldRunCheck,
       readCheckState,
       spawnBackgroundCheck
-    } = await import("./dist-TZQUURSP.js");
+    } = await import("./dist-7EBSGAHX.js");
     const { CLI_VERSION } = await import("./version-KFFPOQAX.js");
     const configInterval = readConfigInterval(resolvedRoot);
     const DEFAULT_INTERVAL = 864e5;