@harness-engineering/core 0.11.0 → 0.13.0

package/dist/index.js

@@ -106,6 +106,7 @@ __export(index_exports, {
   ViolationSchema: () => ViolationSchema,
   addProvenance: () => addProvenance,
   analyzeDiff: () => analyzeDiff,
+  analyzeLearningPatterns: () => analyzeLearningPatterns,
   appendFailure: () => appendFailure,
   appendLearning: () => appendLearning,
   applyFixes: () => applyFixes,
@@ -114,6 +115,7 @@ __export(index_exports, {
   archModule: () => archModule,
   architecture: () => architecture,
   archiveFailures: () => archiveFailures,
+  archiveLearnings: () => archiveLearnings,
   archiveStream: () => archiveStream,
   buildDependencyGraph: () => buildDependencyGraph,
   buildExclusionSet: () => buildExclusionSet,
@@ -121,6 +123,8 @@ __export(index_exports, {
   checkDocCoverage: () => checkDocCoverage,
   checkEligibility: () => checkEligibility,
   classifyFinding: () => classifyFinding,
+  clearFailuresCache: () => clearFailuresCache,
+  clearLearningsCache: () => clearLearningsCache,
   configureFeedback: () => configureFeedback,
   constraintRuleId: () => constraintRuleId,
   contextBudget: () => contextBudget,
@@ -176,16 +180,20 @@ __export(index_exports, {
   injectionRules: () => injectionRules,
   isSmallSuggestion: () => isSmallSuggestion,
   isUpdateCheckEnabled: () => isUpdateCheckEnabled,
+  listActiveSessions: () => listActiveSessions,
   listStreams: () => listStreams,
+  loadBudgetedLearnings: () => loadBudgetedLearnings,
   loadFailures: () => loadFailures,
   loadHandoff: () => loadHandoff,
   loadRelevantLearnings: () => loadRelevantLearnings,
+  loadSessionSummary: () => loadSessionSummary,
   loadState: () => loadState,
   loadStreamIndex: () => loadStreamIndex,
   logAgentAction: () => logAgentAction,
   migrateToStreams: () => migrateToStreams,
   networkRules: () => networkRules,
   nodeRules: () => nodeRules,
+  parseDateFromEntry: () => parseDateFromEntry,
   parseDiff: () => parseDiff,
   parseManifest: () => parseManifest,
   parseRoadmap: () => parseRoadmap,
@@ -193,9 +201,11 @@ __export(index_exports, {
   parseSize: () => parseSize,
   pathTraversalRules: () => pathTraversalRules,
   previewFix: () => previewFix,
+  pruneLearnings: () => pruneLearnings,
   reactRules: () => reactRules,
   readCheckState: () => readCheckState,
   readLockfile: () => readLockfile,
+  removeContributions: () => removeContributions,
   removeProvenance: () => removeProvenance,
   requestMultiplePeerReviews: () => requestMultiplePeerReviews,
   requestPeerReview: () => requestPeerReview,
@@ -203,6 +213,7 @@ __export(index_exports, {
   resolveFileToLayer: () => resolveFileToLayer,
   resolveModelTier: () => resolveModelTier,
   resolveRuleSeverity: () => resolveRuleSeverity,
+  resolveSessionDir: () => resolveSessionDir,
   resolveStreamPath: () => resolveStreamPath,
   resolveThresholds: () => resolveThresholds,
   runAll: () => runAll,
@@ -229,6 +240,7 @@ __export(index_exports, {
   syncRoadmap: () => syncRoadmap,
   touchStream: () => touchStream,
   trackAction: () => trackAction,
+  updateSessionIndex: () => updateSessionIndex,
   validateAgentsMap: () => validateAgentsMap,
   validateBoundaries: () => validateBoundaries,
   validateCommitMessage: () => validateCommitMessage,
@@ -241,6 +253,7 @@ __export(index_exports, {
   violationId: () => violationId,
   writeConfig: () => writeConfig,
   writeLockfile: () => writeLockfile,
+  writeSessionSummary: () => writeSessionSummary,
   xssRules: () => xssRules
 });
 module.exports = __toCommonJS(index_exports);
@@ -263,17 +276,17 @@ var import_util = require("util");
 var import_glob = require("glob");
 var accessAsync = (0, import_util.promisify)(import_fs.access);
 var readFileAsync = (0, import_util.promisify)(import_fs.readFile);
-async function fileExists(path13) {
+async function fileExists(path20) {
   try {
-    await accessAsync(path13, import_fs.constants.F_OK);
+    await accessAsync(path20, import_fs.constants.F_OK);
     return true;
   } catch {
     return false;
   }
 }
-async function readFileContent(path13) {
+async function readFileContent(path20) {
   try {
-    const content = await readFileAsync(path13, "utf-8");
+    const content = await readFileAsync(path20, "utf-8");
     return (0, import_types.Ok)(content);
   } catch (error) {
     return (0, import_types.Err)(error);
@@ -321,15 +334,15 @@ function validateConfig(data, schema) {
   let message = "Configuration validation failed";
   const suggestions = [];
   if (firstError) {
-    const path13 = firstError.path.join(".");
-    const pathDisplay = path13 ? ` at "${path13}"` : "";
+    const path20 = firstError.path.join(".");
+    const pathDisplay = path20 ? ` at "${path20}"` : "";
     if (firstError.code === "invalid_type") {
       const received = firstError.received;
       const expected = firstError.expected;
       if (received === "undefined") {
         code = "MISSING_FIELD";
         message = `Missing required field${pathDisplay}: ${firstError.message}`;
-        suggestions.push(`Field "${path13}" is required and must be of type "${expected}"`);
+        suggestions.push(`Field "${path20}" is required and must be of type "${expected}"`);
       } else {
         code = "INVALID_TYPE";
         message = `Invalid type${pathDisplay}: ${firstError.message}`;
@@ -542,30 +555,27 @@ function extractSections(content) {
     return result;
   });
 }
-function isExternalLink(path13) {
-  return path13.startsWith("http://") || path13.startsWith("https://") || path13.startsWith("#") || path13.startsWith("mailto:");
+function isExternalLink(path20) {
+  return path20.startsWith("http://") || path20.startsWith("https://") || path20.startsWith("#") || path20.startsWith("mailto:");
 }
 function resolveLinkPath(linkPath, baseDir) {
   return linkPath.startsWith(".") ? (0, import_path.join)(baseDir, linkPath) : linkPath;
 }
-async function validateAgentsMap(path13 = "./AGENTS.md") {
-  console.warn(
-    "[harness] validateAgentsMap() is deprecated. Use graph-based validation via Assembler.checkCoverage() from @harness-engineering/graph"
-  );
-  const contentResult = await readFileContent(path13);
+async function validateAgentsMap(path20 = "./AGENTS.md") {
+  const contentResult = await readFileContent(path20);
   if (!contentResult.ok) {
     return (0, import_types.Err)(
       createError(
         "PARSE_ERROR",
         `Failed to read AGENTS.md: ${contentResult.error.message}`,
-        { path: path13 },
+        { path: path20 },
         ["Ensure the file exists", "Check file permissions"]
       )
     );
   }
   const content = contentResult.value;
   const sections = extractSections(content);
-  const baseDir = (0, import_path.dirname)(path13);
+  const baseDir = (0, import_path.dirname)(path20);
   const sectionTitles = sections.map((s) => s.title);
   const missingSections = REQUIRED_SECTIONS.filter(
     (required) => !sectionTitles.some((title) => title.toLowerCase().includes(required.toLowerCase()))
@@ -706,8 +716,8 @@ async function checkDocCoverage(domain, options = {}) {
 
 // src/context/knowledge-map.ts
 var import_path3 = require("path");
-function suggestFix(path13, existingFiles) {
-  const targetName = (0, import_path3.basename)(path13).toLowerCase();
+function suggestFix(path20, existingFiles) {
+  const targetName = (0, import_path3.basename)(path20).toLowerCase();
   const similar = existingFiles.find((file) => {
     const fileName = (0, import_path3.basename)(file).toLowerCase();
     return fileName.includes(targetName) || targetName.includes(fileName);
@@ -715,12 +725,9 @@ function suggestFix(path13, existingFiles) {
   if (similar) {
     return `Did you mean "${similar}"?`;
   }
-  return `Create the file "${path13}" or remove the link`;
+  return `Create the file "${path20}" or remove the link`;
 }
 async function validateKnowledgeMap(rootDir = process.cwd()) {
-  console.warn(
-    "[harness] validateKnowledgeMap() is deprecated. Use graph-based validation via Assembler.checkCoverage() from @harness-engineering/graph"
-  );
   const agentsPath = (0, import_path3.join)(rootDir, "AGENTS.md");
   const agentsResult = await validateAgentsMap(agentsPath);
   if (!agentsResult.ok) {
@@ -1318,8 +1325,8 @@ function createBoundaryValidator(schema, name) {
         return (0, import_types.Ok)(result.data);
       }
       const suggestions = result.error.issues.map((issue) => {
-        const path13 = issue.path.join(".");
-        return path13 ? `${path13}: ${issue.message}` : issue.message;
+        const path20 = issue.path.join(".");
+        return path20 ? `${path20}: ${issue.message}` : issue.message;
       });
       return (0, import_types.Err)(
         createError(
@@ -1626,8 +1633,6 @@ function deepMergeConstraints(localConfig, bundleConstraints, _existingContribut
   }
   if (bundleConstraints.architecture) {
     const localArch = localConfig.architecture ?? {
-      enabled: true,
-      baselinePath: ".harness/arch/baselines.json",
       thresholds: {},
       modules: {}
     };
@@ -1750,7 +1755,7 @@ async function readLockfile(lockfilePath) {
   return { ok: true, value: result.data };
 }
 async function writeLockfile(lockfilePath, lockfile) {
-  await writeConfig(lockfilePath, lockfile);
+  return writeConfig(lockfilePath, lockfile);
 }
 function addProvenance(lockfile, packageName, entry) {
   return {
@@ -1779,6 +1784,77 @@ function isNodeError(err) {
   return err instanceof Error && "code" in err;
 }
 
+// src/constraints/sharing/remove.ts
+function removeContributions(config, contributions) {
+  const result = { ...config };
+  const layerNames = contributions.layers;
+  if (layerNames && layerNames.length > 0 && Array.isArray(result.layers)) {
+    const nameSet = new Set(layerNames);
+    result.layers = result.layers.filter((l) => !nameSet.has(l.name));
+  }
+  const fromKeys = contributions.forbiddenImports;
+  if (fromKeys && fromKeys.length > 0 && Array.isArray(result.forbiddenImports)) {
+    const fromSet = new Set(fromKeys);
+    result.forbiddenImports = result.forbiddenImports.filter(
+      (r) => !fromSet.has(r.from)
+    );
+  }
+  const boundarySchemas = contributions.boundaries;
+  if (boundarySchemas && boundarySchemas.length > 0 && result.boundaries) {
+    const boundaries = result.boundaries;
+    if (boundaries.requireSchema) {
+      const schemaSet = new Set(boundarySchemas);
+      result.boundaries = {
+        ...boundaries,
+        requireSchema: boundaries.requireSchema.filter((s) => !schemaSet.has(s))
+      };
+    }
+  }
+  const thresholdKeys = contributions["architecture.thresholds"];
+  if (thresholdKeys && thresholdKeys.length > 0 && result.architecture) {
+    const arch = { ...result.architecture };
+    const thresholds = { ...arch.thresholds };
+    for (const key of thresholdKeys) {
+      delete thresholds[key];
+    }
+    arch.thresholds = thresholds;
+    result.architecture = arch;
+  }
+  const moduleKeys = contributions["architecture.modules"];
+  if (moduleKeys && moduleKeys.length > 0 && result.architecture) {
+    const arch = { ...result.architecture };
+    const modules = { ...arch.modules };
+    for (const key of moduleKeys) {
+      const colonIdx = key.indexOf(":");
+      if (colonIdx === -1) continue;
+      const modulePath = key.substring(0, colonIdx);
+      const category = key.substring(colonIdx + 1);
+      if (modules[modulePath]) {
+        const moduleCategories = { ...modules[modulePath] };
+        delete moduleCategories[category];
+        if (Object.keys(moduleCategories).length === 0) {
+          delete modules[modulePath];
+        } else {
+          modules[modulePath] = moduleCategories;
+        }
+      }
+    }
+    arch.modules = modules;
+    result.architecture = arch;
+  }
+  const ruleIds = contributions["security.rules"];
+  if (ruleIds && ruleIds.length > 0 && result.security) {
+    const security = { ...result.security };
+    const rules = { ...security.rules };
+    for (const id of ruleIds) {
+      delete rules[id];
+    }
+    security.rules = rules;
+    result.security = security;
+  }
+  return result;
+}
+
 // src/shared/parsers/typescript.ts
 var import_typescript_estree = require("@typescript-eslint/typescript-estree");
 
@@ -1804,11 +1880,11 @@ function walk(node, visitor) {
 var TypeScriptParser = class {
   name = "typescript";
   extensions = [".ts", ".tsx", ".mts", ".cts"];
-  async parseFile(path13) {
-    const contentResult = await readFileContent(path13);
+  async parseFile(path20) {
+    const contentResult = await readFileContent(path20);
     if (!contentResult.ok) {
       return (0, import_types.Err)(
-        createParseError("NOT_FOUND", `File not found: ${path13}`, { path: path13 }, [
+        createParseError("NOT_FOUND", `File not found: ${path20}`, { path: path20 }, [
           "Check that the file exists",
           "Verify the path is correct"
         ])
@@ -1818,7 +1894,7 @@ var TypeScriptParser = class {
       const ast = (0, import_typescript_estree.parse)(contentResult.value, {
         loc: true,
         range: true,
-        jsx: path13.endsWith(".tsx"),
+        jsx: path20.endsWith(".tsx"),
         errorOnUnknownASTType: false
       });
       return (0, import_types.Ok)({
@@ -1829,7 +1905,7 @@ var TypeScriptParser = class {
     } catch (e) {
       const error = e;
       return (0, import_types.Err)(
-        createParseError("SYNTAX_ERROR", `Failed to parse ${path13}: ${error.message}`, { path: path13 }, [
+        createParseError("SYNTAX_ERROR", `Failed to parse ${path20}: ${error.message}`, { path: path20 }, [
           "Check for syntax errors in the file",
           "Ensure valid TypeScript syntax"
         ])
@@ -2113,22 +2189,22 @@ function extractInlineRefs(content) {
   }
   return refs;
 }
-async function parseDocumentationFile(path13) {
-  const contentResult = await readFileContent(path13);
+async function parseDocumentationFile(path20) {
+  const contentResult = await readFileContent(path20);
   if (!contentResult.ok) {
     return (0, import_types.Err)(
       createEntropyError(
         "PARSE_ERROR",
-        `Failed to read documentation file: ${path13}`,
-        { file: path13 },
+        `Failed to read documentation file: ${path20}`,
+        { file: path20 },
         ["Check that the file exists"]
       )
     );
   }
   const content = contentResult.value;
-  const type = path13.endsWith(".md") ? "markdown" : "text";
+  const type = path20.endsWith(".md") ? "markdown" : "text";
   return (0, import_types.Ok)({
-    path: path13,
+    path: path20,
     type,
     content,
     codeBlocks: extractCodeBlocks(content),
@@ -2939,15 +3015,34 @@ async function detectPatternViolations(snapshot, config) {
       }
     }
   }
+  if (config?.customPatterns) {
+    for (const file of snapshot.files) {
+      for (const custom of config.customPatterns) {
+        const matches = custom.check(file, snapshot);
+        for (const match of matches) {
+          violations.push({
+            pattern: custom.name,
+            file: file.path,
+            line: match.line,
+            message: match.message,
+            suggestion: match.suggestion || "Review and fix this pattern violation",
+            severity: custom.severity
+          });
+        }
+      }
+    }
+  }
   const errorCount = violations.filter((v) => v.severity === "error").length;
   const warningCount = violations.filter((v) => v.severity === "warning").length;
-  const totalChecks = snapshot.files.length * patterns.length;
-  const passRate = totalChecks > 0 ? (totalChecks - violations.length) / totalChecks : 1;
+  const customCount = config?.customPatterns?.length ?? 0;
+  const allPatternsCount = patterns.length + customCount;
+  const totalChecks = snapshot.files.length * allPatternsCount;
+  const passRate = totalChecks > 0 ? Math.max(0, (totalChecks - violations.length) / totalChecks) : 1;
   return (0, import_types.Ok)({
     violations,
     stats: {
       filesChecked: snapshot.files.length,
-      patternsApplied: patterns.length,
+      patternsApplied: allPatternsCount,
       violationCount: violations.length,
       errorCount,
       warningCount
@@ -5446,8 +5541,8 @@ var import_node_path3 = require("path");
 // src/architecture/collectors/hash.ts
 var import_node_crypto = require("crypto");
 function violationId(relativePath, category, normalizedDetail) {
-  const path13 = relativePath.replace(/\\/g, "/");
-  const input = `${path13}:${category}:${normalizedDetail}`;
+  const path20 = relativePath.replace(/\\/g, "/");
+  const input = `${path20}:${category}:${normalizedDetail}`;
   return (0, import_node_crypto.createHash)("sha256").update(input).digest("hex");
 }
 function constraintRuleId(category, scope, description) {
@@ -6625,10 +6720,13 @@ var DEFAULT_STATE = {
   progress: {}
 };
 
-// src/state/state-manager.ts
-var fs6 = __toESM(require("fs"));
-var path3 = __toESM(require("path"));
-var import_child_process2 = require("child_process");
+// src/state/state-persistence.ts
+var fs8 = __toESM(require("fs"));
+var path5 = __toESM(require("path"));
+
+// src/state/state-shared.ts
+var fs7 = __toESM(require("fs"));
+var path4 = __toESM(require("path"));
 
 // src/state/stream-resolver.ts
 var fs5 = __toESM(require("fs"));
@@ -6654,10 +6752,20 @@ var DEFAULT_STREAM_INDEX = {
   streams: {}
 };
 
-// src/state/stream-resolver.ts
+// src/state/constants.ts
 var HARNESS_DIR = ".harness";
-var STREAMS_DIR = "streams";
+var STATE_FILE = "state.json";
+var LEARNINGS_FILE = "learnings.md";
+var FAILURES_FILE = "failures.md";
+var HANDOFF_FILE = "handoff.json";
+var GATE_CONFIG_FILE = "gate.json";
 var INDEX_FILE = "index.json";
+var SESSIONS_DIR = "sessions";
+var SESSION_INDEX_FILE = "index.md";
+var SUMMARY_FILE = "summary.md";
+
+// src/state/stream-resolver.ts
+var STREAMS_DIR = "streams";
 var STREAM_NAME_REGEX = /^[a-z0-9][a-z0-9._-]*$/;
 function streamsDir(projectPath) {
   return path2.join(projectPath, HARNESS_DIR, STREAMS_DIR);
@@ -6884,26 +6992,65 @@ async function migrateToStreams(projectPath) {
   return saveStreamIndex(projectPath, index);
 }
 
-// src/state/state-manager.ts
-var HARNESS_DIR2 = ".harness";
-var STATE_FILE = "state.json";
-var LEARNINGS_FILE = "learnings.md";
-var FAILURES_FILE = "failures.md";
-var HANDOFF_FILE = "handoff.json";
-var GATE_CONFIG_FILE = "gate.json";
-var INDEX_FILE2 = "index.json";
+// src/state/session-resolver.ts
+var fs6 = __toESM(require("fs"));
+var path3 = __toESM(require("path"));
+function resolveSessionDir(projectPath, sessionSlug, options) {
+  if (!sessionSlug || sessionSlug.trim() === "") {
+    return (0, import_types.Err)(new Error("Session slug must not be empty"));
+  }
+  if (sessionSlug.includes("..") || sessionSlug.includes("/") || sessionSlug.includes("\\")) {
+    return (0, import_types.Err)(
+      new Error(`Invalid session slug '${sessionSlug}': must not contain path traversal characters`)
+    );
+  }
+  const sessionDir = path3.join(projectPath, HARNESS_DIR, SESSIONS_DIR, sessionSlug);
+  if (options?.create) {
+    fs6.mkdirSync(sessionDir, { recursive: true });
+  }
+  return (0, import_types.Ok)(sessionDir);
+}
+function updateSessionIndex(projectPath, sessionSlug, description) {
+  const sessionsDir = path3.join(projectPath, HARNESS_DIR, SESSIONS_DIR);
+  fs6.mkdirSync(sessionsDir, { recursive: true });
+  const indexPath2 = path3.join(sessionsDir, SESSION_INDEX_FILE);
+  const date = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  const newLine = `- [${sessionSlug}](${sessionSlug}/summary.md) \u2014 ${description} (${date})`;
+  if (!fs6.existsSync(indexPath2)) {
+    fs6.writeFileSync(indexPath2, `## Active Sessions
+
+${newLine}
+`);
+    return;
+  }
+  const content = fs6.readFileSync(indexPath2, "utf-8");
+  const lines = content.split("\n");
+  const slugPattern = `- [${sessionSlug}]`;
+  const existingIdx = lines.findIndex((l) => l.startsWith(slugPattern));
+  if (existingIdx >= 0) {
+    lines[existingIdx] = newLine;
+  } else {
+    const lastNonEmpty = lines.reduce((last, line, i) => line.trim() !== "" ? i : last, 0);
+    lines.splice(lastNonEmpty + 1, 0, newLine);
+  }
+  fs6.writeFileSync(indexPath2, lines.join("\n"));
+}
+
+// src/state/state-shared.ts
 var MAX_CACHE_ENTRIES = 8;
-var learningsCacheMap = /* @__PURE__ */ new Map();
-var failuresCacheMap = /* @__PURE__ */ new Map();
 function evictIfNeeded(map) {
   if (map.size > MAX_CACHE_ENTRIES) {
     const oldest = map.keys().next().value;
     if (oldest !== void 0) map.delete(oldest);
   }
 }
-async function getStateDir(projectPath, stream) {
-  const streamsIndexPath = path3.join(projectPath, HARNESS_DIR2, "streams", INDEX_FILE2);
-  const hasStreams = fs6.existsSync(streamsIndexPath);
+async function getStateDir(projectPath, stream, session) {
+  if (session) {
+    const sessionResult = resolveSessionDir(projectPath, session, { create: true });
+    return sessionResult;
+  }
+  const streamsIndexPath = path4.join(projectPath, HARNESS_DIR, "streams", INDEX_FILE);
+  const hasStreams = fs7.existsSync(streamsIndexPath);
   if (stream || hasStreams) {
     const result = await resolveStreamPath(projectPath, stream ? { stream } : void 0);
     if (result.ok) {
@@ -6913,18 +7060,20 @@ async function getStateDir(projectPath, stream) {
       return result;
     }
   }
-  return (0, import_types.Ok)(path3.join(projectPath, HARNESS_DIR2));
+  return (0, import_types.Ok)(path4.join(projectPath, HARNESS_DIR));
 }
-async function loadState(projectPath, stream) {
+
+// src/state/state-persistence.ts
+async function loadState(projectPath, stream, session) {
   try {
-    const dirResult = await getStateDir(projectPath, stream);
+    const dirResult = await getStateDir(projectPath, stream, session);
     if (!dirResult.ok) return dirResult;
     const stateDir = dirResult.value;
-    const statePath = path3.join(stateDir, STATE_FILE);
-    if (!fs6.existsSync(statePath)) {
+    const statePath = path5.join(stateDir, STATE_FILE);
+    if (!fs8.existsSync(statePath)) {
       return (0, import_types.Ok)({ ...DEFAULT_STATE });
     }
-    const raw = fs6.readFileSync(statePath, "utf-8");
+    const raw = fs8.readFileSync(statePath, "utf-8");
     const parsed = JSON.parse(raw);
     const result = HarnessStateSchema.safeParse(parsed);
     if (!result.success) {
@@ -6937,14 +7086,14 @@ async function loadState(projectPath, stream) {
     );
   }
 }
-async function saveState(projectPath, state, stream) {
+async function saveState(projectPath, state, stream, session) {
   try {
-    const dirResult = await getStateDir(projectPath, stream);
+    const dirResult = await getStateDir(projectPath, stream, session);
     if (!dirResult.ok) return dirResult;
     const stateDir = dirResult.value;
-    const statePath = path3.join(stateDir, STATE_FILE);
-    fs6.mkdirSync(stateDir, { recursive: true });
-    fs6.writeFileSync(statePath, JSON.stringify(state, null, 2));
+    const statePath = path5.join(stateDir, STATE_FILE);
+    fs8.mkdirSync(stateDir, { recursive: true });
+    fs8.writeFileSync(statePath, JSON.stringify(state, null, 2));
     return (0, import_types.Ok)(void 0);
   } catch (error) {
     return (0, import_types.Err)(
@@ -6952,13 +7101,21 @@ async function saveState(projectPath, state, stream) {
     );
   }
 }
-async function appendLearning(projectPath, learning, skillName, outcome, stream) {
+
+// src/state/learnings.ts
+var fs9 = __toESM(require("fs"));
+var path6 = __toESM(require("path"));
+var learningsCacheMap = /* @__PURE__ */ new Map();
+function clearLearningsCache() {
+  learningsCacheMap.clear();
+}
+async function appendLearning(projectPath, learning, skillName, outcome, stream, session) {
   try {
-    const dirResult = await getStateDir(projectPath, stream);
+    const dirResult = await getStateDir(projectPath, stream, session);
     if (!dirResult.ok) return dirResult;
     const stateDir = dirResult.value;
-    const learningsPath = path3.join(stateDir, LEARNINGS_FILE);
-    fs6.mkdirSync(stateDir, { recursive: true });
+    const learningsPath = path6.join(stateDir, LEARNINGS_FILE);
+    fs9.mkdirSync(stateDir, { recursive: true });
     const timestamp = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
     let entry;
     if (skillName && outcome) {
@@ -6974,11 +7131,11 @@ async function appendLearning(projectPath, learning, skillName, outcome, stream)
 - **${timestamp}:** ${learning}
 `;
     }
-    if (!fs6.existsSync(learningsPath)) {
-      fs6.writeFileSync(learningsPath, `# Learnings
+    if (!fs9.existsSync(learningsPath)) {
+      fs9.writeFileSync(learningsPath, `# Learnings
 ${entry}`);
     } else {
-      fs6.appendFileSync(learningsPath, entry);
+      fs9.appendFileSync(learningsPath, entry);
     }
     learningsCacheMap.delete(learningsPath);
     return (0, import_types.Ok)(void 0);
@@ -6990,23 +7147,92 @@ ${entry}`);
     );
   }
 }
-async function loadRelevantLearnings(projectPath, skillName, stream) {
+function estimateTokens(text) {
+  return Math.ceil(text.length / 4);
+}
+function scoreRelevance(entry, intent) {
+  if (!intent || intent.trim() === "") return 0;
+  const intentWords = intent.toLowerCase().split(/\s+/).filter((w) => w.length > 2);
+  if (intentWords.length === 0) return 0;
+  const entryLower = entry.toLowerCase();
+  const matches = intentWords.filter((word) => entryLower.includes(word));
+  return matches.length / intentWords.length;
+}
+function parseDateFromEntry(entry) {
+  const match = entry.match(/(\d{4}-\d{2}-\d{2})/);
+  return match ? match[1] ?? null : null;
+}
+function analyzeLearningPatterns(entries) {
+  const tagGroups = /* @__PURE__ */ new Map();
+  for (const entry of entries) {
+    const tagMatches = entry.matchAll(/\[(skill:[^\]]+)\]|\[(outcome:[^\]]+)\]/g);
+    for (const match of tagMatches) {
+      const tag = match[1] ?? match[2];
+      if (tag) {
+        const group = tagGroups.get(tag) ?? [];
+        group.push(entry);
+        tagGroups.set(tag, group);
+      }
+    }
+  }
+  const patterns = [];
+  for (const [tag, groupEntries] of tagGroups) {
+    if (groupEntries.length >= 3) {
+      patterns.push({ tag, count: groupEntries.length, entries: groupEntries });
+    }
+  }
+  return patterns.sort((a, b) => b.count - a.count);
+}
+async function loadBudgetedLearnings(projectPath, options) {
+  const { intent, tokenBudget = 1e3, skill, session, stream } = options;
+  const sortByRecencyAndRelevance = (entries) => {
+    return [...entries].sort((a, b) => {
+      const dateA = parseDateFromEntry(a) ?? "0000-00-00";
+      const dateB = parseDateFromEntry(b) ?? "0000-00-00";
+      const dateCompare = dateB.localeCompare(dateA);
+      if (dateCompare !== 0) return dateCompare;
+      return scoreRelevance(b, intent) - scoreRelevance(a, intent);
+    });
+  };
+  const allEntries = [];
+  if (session) {
+    const sessionResult = await loadRelevantLearnings(projectPath, skill, stream, session);
+    if (sessionResult.ok) {
+      allEntries.push(...sortByRecencyAndRelevance(sessionResult.value));
+    }
+  }
+  const globalResult = await loadRelevantLearnings(projectPath, skill, stream);
+  if (globalResult.ok) {
+    allEntries.push(...sortByRecencyAndRelevance(globalResult.value));
+  }
+  const budgeted = [];
+  let totalTokens = 0;
+  for (const entry of allEntries) {
+    const separator = budgeted.length > 0 ? "\n" : "";
+    const entryCost = estimateTokens(entry + separator);
+    if (totalTokens + entryCost > tokenBudget) break;
+    budgeted.push(entry);
+    totalTokens += entryCost;
+  }
+  return (0, import_types.Ok)(budgeted);
+}
+async function loadRelevantLearnings(projectPath, skillName, stream, session) {
   try {
-    const dirResult = await getStateDir(projectPath, stream);
+    const dirResult = await getStateDir(projectPath, stream, session);
     if (!dirResult.ok) return dirResult;
     const stateDir = dirResult.value;
-    const learningsPath = path3.join(stateDir, LEARNINGS_FILE);
-    if (!fs6.existsSync(learningsPath)) {
+    const learningsPath = path6.join(stateDir, LEARNINGS_FILE);
+    if (!fs9.existsSync(learningsPath)) {
       return (0, import_types.Ok)([]);
     }
-    const stats = fs6.statSync(learningsPath);
+    const stats = fs9.statSync(learningsPath);
     const cacheKey = learningsPath;
     const cached = learningsCacheMap.get(cacheKey);
     let entries;
     if (cached && cached.mtimeMs === stats.mtimeMs) {
       entries = cached.entries;
     } else {
-      const content = fs6.readFileSync(learningsPath, "utf-8");
+      const content = fs9.readFileSync(learningsPath, "utf-8");
       const lines = content.split("\n");
       entries = [];
       let currentBlock = [];
@@ -7042,23 +7268,110 @@ async function loadRelevantLearnings(projectPath, skillName, stream) {
     );
   }
 }
-var FAILURE_LINE_REGEX = /^- \*\*(\d{4}-\d{2}-\d{2}) \[skill:([^\]]+)\] \[type:([^\]]+)\]:\*\* (.+)$/;
-async function appendFailure(projectPath, description, skillName, type, stream) {
+async function archiveLearnings(projectPath, entries, stream) {
+  try {
+    const dirResult = await getStateDir(projectPath, stream);
+    if (!dirResult.ok) return dirResult;
+    const stateDir = dirResult.value;
+    const archiveDir = path6.join(stateDir, "learnings-archive");
+    fs9.mkdirSync(archiveDir, { recursive: true });
+    const now = /* @__PURE__ */ new Date();
+    const yearMonth = `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, "0")}`;
+    const archivePath = path6.join(archiveDir, `${yearMonth}.md`);
+    const archiveContent = entries.join("\n\n") + "\n";
+    if (fs9.existsSync(archivePath)) {
+      fs9.appendFileSync(archivePath, "\n" + archiveContent);
+    } else {
+      fs9.writeFileSync(archivePath, `# Learnings Archive
+
+${archiveContent}`);
+    }
+    return (0, import_types.Ok)(void 0);
+  } catch (error) {
+    return (0, import_types.Err)(
+      new Error(
+        `Failed to archive learnings: ${error instanceof Error ? error.message : String(error)}`
+      )
+    );
+  }
+}
+async function pruneLearnings(projectPath, stream) {
   try {
     const dirResult = await getStateDir(projectPath, stream);
     if (!dirResult.ok) return dirResult;
     const stateDir = dirResult.value;
-    const failuresPath = path3.join(stateDir, FAILURES_FILE);
-    fs6.mkdirSync(stateDir, { recursive: true });
+    const learningsPath = path6.join(stateDir, LEARNINGS_FILE);
+    if (!fs9.existsSync(learningsPath)) {
+      return (0, import_types.Ok)({ kept: 0, archived: 0, patterns: [] });
+    }
+    const loadResult = await loadRelevantLearnings(projectPath, void 0, stream);
+    if (!loadResult.ok) return loadResult;
+    const allEntries = loadResult.value;
+    if (allEntries.length <= 20) {
+      const cutoffDate = /* @__PURE__ */ new Date();
+      cutoffDate.setDate(cutoffDate.getDate() - 14);
+      const cutoffStr = cutoffDate.toISOString().split("T")[0];
+      const hasOld = allEntries.some((entry) => {
+        const date = parseDateFromEntry(entry);
+        return date !== null && date < cutoffStr;
+      });
+      if (!hasOld) {
+        return (0, import_types.Ok)({ kept: allEntries.length, archived: 0, patterns: [] });
+      }
+    }
+    const sorted = [...allEntries].sort((a, b) => {
+      const dateA = parseDateFromEntry(a) ?? "0000-00-00";
+      const dateB = parseDateFromEntry(b) ?? "0000-00-00";
+      return dateB.localeCompare(dateA);
+    });
+    const toKeep = sorted.slice(0, 20);
+    const toArchive = sorted.slice(20);
+    const patterns = analyzeLearningPatterns(allEntries);
+    if (toArchive.length > 0) {
+      const archiveResult = await archiveLearnings(projectPath, toArchive, stream);
+      if (!archiveResult.ok) return archiveResult;
+    }
+    const newContent = "# Learnings\n\n" + toKeep.join("\n\n") + "\n";
+    fs9.writeFileSync(learningsPath, newContent);
+    learningsCacheMap.delete(learningsPath);
+    return (0, import_types.Ok)({
+      kept: toKeep.length,
+      archived: toArchive.length,
+      patterns
+    });
+  } catch (error) {
+    return (0, import_types.Err)(
+      new Error(
+        `Failed to prune learnings: ${error instanceof Error ? error.message : String(error)}`
+      )
+    );
+  }
+}
+
+// src/state/failures.ts
+var fs10 = __toESM(require("fs"));
+var path7 = __toESM(require("path"));
+var failuresCacheMap = /* @__PURE__ */ new Map();
+function clearFailuresCache() {
+  failuresCacheMap.clear();
+}
+var FAILURE_LINE_REGEX = /^- \*\*(\d{4}-\d{2}-\d{2}) \[skill:([^\]]+)\] \[type:([^\]]+)\]:\*\* (.+)$/;
+async function appendFailure(projectPath, description, skillName, type, stream, session) {
+  try {
+    const dirResult = await getStateDir(projectPath, stream, session);
+    if (!dirResult.ok) return dirResult;
+    const stateDir = dirResult.value;
+    const failuresPath = path7.join(stateDir, FAILURES_FILE);
+    fs10.mkdirSync(stateDir, { recursive: true });
     const timestamp = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
     const entry = `
 - **${timestamp} [skill:${skillName}] [type:${type}]:** ${description}
 `;
-    if (!fs6.existsSync(failuresPath)) {
-      fs6.writeFileSync(failuresPath, `# Failures
+    if (!fs10.existsSync(failuresPath)) {
+      fs10.writeFileSync(failuresPath, `# Failures
 ${entry}`);
     } else {
-      fs6.appendFileSync(failuresPath, entry);
+      fs10.appendFileSync(failuresPath, entry);
     }
     failuresCacheMap.delete(failuresPath);
     return (0, import_types.Ok)(void 0);
@@ -7070,22 +7383,22 @@ ${entry}`);
     );
   }
 }
-async function loadFailures(projectPath, stream) {
+async function loadFailures(projectPath, stream, session) {
   try {
-    const dirResult = await getStateDir(projectPath, stream);
+    const dirResult = await getStateDir(projectPath, stream, session);
     if (!dirResult.ok) return dirResult;
     const stateDir = dirResult.value;
-    const failuresPath = path3.join(stateDir, FAILURES_FILE);
-    if (!fs6.existsSync(failuresPath)) {
+    const failuresPath = path7.join(stateDir, FAILURES_FILE);
+    if (!fs10.existsSync(failuresPath)) {
       return (0, import_types.Ok)([]);
     }
-    const stats = fs6.statSync(failuresPath);
+    const stats = fs10.statSync(failuresPath);
     const cacheKey = failuresPath;
     const cached = failuresCacheMap.get(cacheKey);
     if (cached && cached.mtimeMs === stats.mtimeMs) {
       return (0, import_types.Ok)(cached.entries);
     }
-    const content = fs6.readFileSync(failuresPath, "utf-8");
+    const content = fs10.readFileSync(failuresPath, "utf-8");
     const entries = [];
     for (const line of content.split("\n")) {
       const match = line.match(FAILURE_LINE_REGEX);
@@ -7109,25 +7422,25 @@ async function loadFailures(projectPath, stream) {
     );
   }
 }
-async function archiveFailures(projectPath, stream) {
+async function archiveFailures(projectPath, stream, session) {
   try {
-    const dirResult = await getStateDir(projectPath, stream);
+    const dirResult = await getStateDir(projectPath, stream, session);
     if (!dirResult.ok) return dirResult;
     const stateDir = dirResult.value;
-    const failuresPath = path3.join(stateDir, FAILURES_FILE);
-    if (!fs6.existsSync(failuresPath)) {
+    const failuresPath = path7.join(stateDir, FAILURES_FILE);
+    if (!fs10.existsSync(failuresPath)) {
       return (0, import_types.Ok)(void 0);
     }
-    const archiveDir = path3.join(stateDir, "archive");
-    fs6.mkdirSync(archiveDir, { recursive: true });
+    const archiveDir = path7.join(stateDir, "archive");
+    fs10.mkdirSync(archiveDir, { recursive: true });
     const date = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
     let archiveName = `failures-${date}.md`;
     let counter = 2;
-    while (fs6.existsSync(path3.join(archiveDir, archiveName))) {
+    while (fs10.existsSync(path7.join(archiveDir, archiveName))) {
       archiveName = `failures-${date}-${counter}.md`;
       counter++;
     }
-    fs6.renameSync(failuresPath, path3.join(archiveDir, archiveName));
+    fs10.renameSync(failuresPath, path7.join(archiveDir, archiveName));
     failuresCacheMap.delete(failuresPath);
     return (0, import_types.Ok)(void 0);
   } catch (error) {
@@ -7138,14 +7451,18 @@ async function archiveFailures(projectPath, stream) {
     );
   }
 }
-async function saveHandoff(projectPath, handoff, stream) {
+
+// src/state/handoff.ts
+var fs11 = __toESM(require("fs"));
+var path8 = __toESM(require("path"));
+async function saveHandoff(projectPath, handoff, stream, session) {
   try {
-    const dirResult = await getStateDir(projectPath, stream);
+    const dirResult = await getStateDir(projectPath, stream, session);
     if (!dirResult.ok) return dirResult;
     const stateDir = dirResult.value;
-    const handoffPath = path3.join(stateDir, HANDOFF_FILE);
-    fs6.mkdirSync(stateDir, { recursive: true });
-    fs6.writeFileSync(handoffPath, JSON.stringify(handoff, null, 2));
+    const handoffPath = path8.join(stateDir, HANDOFF_FILE);
+    fs11.mkdirSync(stateDir, { recursive: true });
+    fs11.writeFileSync(handoffPath, JSON.stringify(handoff, null, 2));
     return (0, import_types.Ok)(void 0);
   } catch (error) {
     return (0, import_types.Err)(
@@ -7153,16 +7470,16 @@ async function saveHandoff(projectPath, handoff, stream) {
     );
   }
 }
-async function loadHandoff(projectPath, stream) {
+async function loadHandoff(projectPath, stream, session) {
   try {
-    const dirResult = await getStateDir(projectPath, stream);
+    const dirResult = await getStateDir(projectPath, stream, session);
     if (!dirResult.ok) return dirResult;
     const stateDir = dirResult.value;
-    const handoffPath = path3.join(stateDir, HANDOFF_FILE);
-    if (!fs6.existsSync(handoffPath)) {
+    const handoffPath = path8.join(stateDir, HANDOFF_FILE);
+    if (!fs11.existsSync(handoffPath)) {
       return (0, import_types.Ok)(null);
     }
-    const raw = fs6.readFileSync(handoffPath, "utf-8");
+    const raw = fs11.readFileSync(handoffPath, "utf-8");
     const parsed = JSON.parse(raw);
     const result = HandoffSchema.safeParse(parsed);
     if (!result.success) {
@@ -7175,73 +7492,82 @@ async function loadHandoff(projectPath, stream) {
     );
   }
 }
+
+// src/state/mechanical-gate.ts
+var fs12 = __toESM(require("fs"));
+var path9 = __toESM(require("path"));
+var import_child_process2 = require("child_process");
+var SAFE_GATE_COMMAND = /^(?:npm|pnpm|yarn)\s+(?:test|run\s+[\w.-]+|run-script\s+[\w.-]+)$|^go\s+(?:test|build|vet|fmt)\s+[\w./ -]+$|^(?:python|python3)\s+-m\s+[\w.-]+$|^make\s+[\w.-]+$|^cargo\s+(?:test|build|check|clippy)(?:\s+[\w./ -]+)?$|^(?:gradle|mvn)\s+[\w:.-]+$/;
+function loadChecksFromConfig(gateConfigPath) {
+  if (!fs12.existsSync(gateConfigPath)) return [];
+  const raw = JSON.parse(fs12.readFileSync(gateConfigPath, "utf-8"));
+  const config = GateConfigSchema.safeParse(raw);
+  if (config.success && config.data.checks) return config.data.checks;
+  return [];
+}
+function discoverChecksFromProject(projectPath) {
+  const checks = [];
+  const packageJsonPath = path9.join(projectPath, "package.json");
+  if (fs12.existsSync(packageJsonPath)) {
+    const pkg = JSON.parse(fs12.readFileSync(packageJsonPath, "utf-8"));
+    const scripts = pkg.scripts || {};
+    if (scripts.test) checks.push({ name: "test", command: "npm test" });
+    if (scripts.lint) checks.push({ name: "lint", command: "npm run lint" });
+    if (scripts.typecheck) checks.push({ name: "typecheck", command: "npm run typecheck" });
+    if (scripts.build) checks.push({ name: "build", command: "npm run build" });
+  }
+  if (fs12.existsSync(path9.join(projectPath, "go.mod"))) {
+    checks.push({ name: "test", command: "go test ./..." });
+    checks.push({ name: "build", command: "go build ./..." });
+  }
+  if (fs12.existsSync(path9.join(projectPath, "pyproject.toml")) || fs12.existsSync(path9.join(projectPath, "setup.py"))) {
+    checks.push({ name: "test", command: "python -m pytest" });
+  }
+  return checks;
+}
+function executeCheck(check, projectPath) {
+  if (!SAFE_GATE_COMMAND.test(check.command)) {
+    return {
+      name: check.name,
+      passed: false,
+      command: check.command,
+      output: `Blocked: command does not match safe gate pattern. Allowed prefixes: npm, pnpm, yarn, go, python, python3, make, cargo, gradle, mvn`,
+      duration: 0
+    };
+  }
+  const start = Date.now();
+  try {
+    (0, import_child_process2.execSync)(check.command, {
+      cwd: projectPath,
+      stdio: "pipe",
+      timeout: 12e4
+    });
+    return {
+      name: check.name,
+      passed: true,
+      command: check.command,
+      duration: Date.now() - start
+    };
+  } catch (error) {
+    const output = error instanceof Error ? error.stderr?.toString() || error.message : String(error);
+    return {
+      name: check.name,
+      passed: false,
+      command: check.command,
+      output: output.slice(0, 2e3),
+      duration: Date.now() - start
+    };
+  }
+}
 async function runMechanicalGate(projectPath) {
-  const harnessDir = path3.join(projectPath, HARNESS_DIR2);
-  const gateConfigPath = path3.join(harnessDir, GATE_CONFIG_FILE);
+  const harnessDir = path9.join(projectPath, HARNESS_DIR);
+  const gateConfigPath = path9.join(harnessDir, GATE_CONFIG_FILE);
   try {
-    let checks = [];
-    if (fs6.existsSync(gateConfigPath)) {
-      const raw = JSON.parse(fs6.readFileSync(gateConfigPath, "utf-8"));
-      const config = GateConfigSchema.safeParse(raw);
-      if (config.success && config.data.checks) {
-        checks = config.data.checks;
-      }
-    }
+    let checks = loadChecksFromConfig(gateConfigPath);
     if (checks.length === 0) {
-      const packageJsonPath = path3.join(projectPath, "package.json");
-      if (fs6.existsSync(packageJsonPath)) {
-        const pkg = JSON.parse(fs6.readFileSync(packageJsonPath, "utf-8"));
-        const scripts = pkg.scripts || {};
-        if (scripts.test) checks.push({ name: "test", command: "npm test" });
-        if (scripts.lint) checks.push({ name: "lint", command: "npm run lint" });
-        if (scripts.typecheck) checks.push({ name: "typecheck", command: "npm run typecheck" });
-        if (scripts.build) checks.push({ name: "build", command: "npm run build" });
-      }
-      if (fs6.existsSync(path3.join(projectPath, "go.mod"))) {
-        checks.push({ name: "test", command: "go test ./..." });
-        checks.push({ name: "build", command: "go build ./..." });
-      }
-      if (fs6.existsSync(path3.join(projectPath, "pyproject.toml")) || fs6.existsSync(path3.join(projectPath, "setup.py"))) {
-        checks.push({ name: "test", command: "python -m pytest" });
-      }
-    }
-    const results = [];
-    const SAFE_GATE_COMMAND = /^(?:npm|pnpm|yarn)\s+(?:test|run\s+[\w.-]+|run-script\s+[\w.-]+)$|^go\s+(?:test|build|vet|fmt)\s+[\w./ -]+$|^(?:python|python3)\s+-m\s+[\w.-]+$|^make\s+[\w.-]+$|^cargo\s+(?:test|build|check|clippy)(?:\s+[\w./ -]+)?$|^(?:gradle|mvn)\s+[\w:.-]+$/;
-    for (const check of checks) {
-      if (!SAFE_GATE_COMMAND.test(check.command)) {
-        results.push({
-          name: check.name,
-          passed: false,
-          command: check.command,
-          output: `Blocked: command does not match safe gate pattern. Allowed prefixes: npm, npx, pnpm, yarn, go, python, python3, make, cargo, gradle, mvn`,
-          duration: 0
-        });
-        continue;
-      }
-      const start = Date.now();
-      try {
-        (0, import_child_process2.execSync)(check.command, {
-          cwd: projectPath,
-          stdio: "pipe",
-          timeout: 12e4
-        });
-        results.push({
-          name: check.name,
-          passed: true,
-          command: check.command,
-          duration: Date.now() - start
-        });
-      } catch (error) {
-        const output = error instanceof Error ? error.stderr?.toString() || error.message : String(error);
-        results.push({
-          name: check.name,
-          passed: false,
-          command: check.command,
-          output: output.slice(0, 2e3),
-          duration: Date.now() - start
-        });
-      }
+      checks = discoverChecksFromProject(projectPath);
     }
+    const results = checks.map((check) => executeCheck(check, projectPath));
     return (0, import_types.Ok)({
       passed: results.length === 0 || results.every((r) => r.passed),
       checks: results
@@ -7255,6 +7581,96 @@ async function runMechanicalGate(projectPath) {
   }
 }
 
+// src/state/session-summary.ts
+var fs13 = __toESM(require("fs"));
+var path10 = __toESM(require("path"));
+function formatSummary(data) {
+  const lines = [
+    "## Session Summary",
+    "",
+    `**Session:** ${data.session}`,
+    `**Last active:** ${data.lastActive}`,
+    `**Skill:** ${data.skill}`
+  ];
+  if (data.phase) {
+    lines.push(`**Phase:** ${data.phase}`);
+  }
+  lines.push(`**Status:** ${data.status}`);
+  if (data.spec) {
+    lines.push(`**Spec:** ${data.spec}`);
+  }
+  if (data.plan) {
+    lines.push(`**Plan:** ${data.plan}`);
+  }
+  lines.push(`**Key context:** ${data.keyContext}`);
+  lines.push(`**Next step:** ${data.nextStep}`);
+  lines.push("");
+  return lines.join("\n");
+}
+function deriveIndexDescription(data) {
+  const skillShort = data.skill.replace("harness-", "");
+  const parts = [skillShort];
+  if (data.phase) {
+    parts.push(`phase ${data.phase}`);
+  }
+  parts.push(data.status.toLowerCase());
+  return parts.join(", ");
+}
+function writeSessionSummary(projectPath, sessionSlug, data) {
+  try {
+    const dirResult = resolveSessionDir(projectPath, sessionSlug, { create: true });
+    if (!dirResult.ok) return dirResult;
+    const sessionDir = dirResult.value;
+    const summaryPath = path10.join(sessionDir, SUMMARY_FILE);
+    const content = formatSummary(data);
+    fs13.writeFileSync(summaryPath, content);
+    const description = deriveIndexDescription(data);
+    updateSessionIndex(projectPath, sessionSlug, description);
+    return (0, import_types.Ok)(void 0);
+  } catch (error) {
+    return (0, import_types.Err)(
+      new Error(
+        `Failed to write session summary: ${error instanceof Error ? error.message : String(error)}`
+      )
+    );
+  }
+}
+function loadSessionSummary(projectPath, sessionSlug) {
+  try {
+    const dirResult = resolveSessionDir(projectPath, sessionSlug);
+    if (!dirResult.ok) return dirResult;
+    const sessionDir = dirResult.value;
+    const summaryPath = path10.join(sessionDir, SUMMARY_FILE);
+    if (!fs13.existsSync(summaryPath)) {
+      return (0, import_types.Ok)(null);
+    }
+    const content = fs13.readFileSync(summaryPath, "utf-8");
+    return (0, import_types.Ok)(content);
+  } catch (error) {
+    return (0, import_types.Err)(
+      new Error(
+        `Failed to load session summary: ${error instanceof Error ? error.message : String(error)}`
+      )
+    );
+  }
+}
+function listActiveSessions(projectPath) {
+  try {
+    const indexPath2 = path10.join(projectPath, HARNESS_DIR, SESSIONS_DIR, SESSION_INDEX_FILE);
+    if (!fs13.existsSync(indexPath2)) {
+      return (0, import_types.Ok)(null);
+    }
+    const content = fs13.readFileSync(indexPath2, "utf-8");
+    return (0, import_types.Ok)(content);
+  } catch (error) {
+    return (0, import_types.Err)(
+      new Error(
+        `Failed to list active sessions: ${error instanceof Error ? error.message : String(error)}`
+      )
+    );
+  }
+}
+
 // src/workflow/runner.ts
 async function executeWorkflow(workflow, executor) {
   const stepResults = [];
@@ -7404,7 +7820,7 @@ async function runMultiTurnPipeline(initialContext, turnExecutor, options) {
 }
 
 // src/security/scanner.ts
-var fs8 = __toESM(require("fs/promises"));
+var fs15 = __toESM(require("fs/promises"));
 
 // src/security/rules/registry.ts
 var RuleRegistry = class {
@@ -7491,15 +7907,15 @@ function resolveRuleSeverity(ruleId, defaultSeverity, overrides, strict) {
 }
 
 // src/security/stack-detector.ts
-var fs7 = __toESM(require("fs"));
-var path4 = __toESM(require("path"));
+var fs14 = __toESM(require("fs"));
+var path11 = __toESM(require("path"));
 function detectStack(projectRoot) {
   const stacks = [];
-  const pkgJsonPath = path4.join(projectRoot, "package.json");
-  if (fs7.existsSync(pkgJsonPath)) {
+  const pkgJsonPath = path11.join(projectRoot, "package.json");
+  if (fs14.existsSync(pkgJsonPath)) {
     stacks.push("node");
     try {
-      const pkgJson = JSON.parse(fs7.readFileSync(pkgJsonPath, "utf-8"));
+      const pkgJson = JSON.parse(fs14.readFileSync(pkgJsonPath, "utf-8"));
       const allDeps = {
         ...pkgJson.dependencies,
         ...pkgJson.devDependencies
@@ -7514,13 +7930,13 @@ function detectStack(projectRoot) {
     } catch {
     }
   }
-  const goModPath = path4.join(projectRoot, "go.mod");
-  if (fs7.existsSync(goModPath)) {
+  const goModPath = path11.join(projectRoot, "go.mod");
+  if (fs14.existsSync(goModPath)) {
     stacks.push("go");
   }
-  const requirementsPath = path4.join(projectRoot, "requirements.txt");
-  const pyprojectPath = path4.join(projectRoot, "pyproject.toml");
-  if (fs7.existsSync(requirementsPath) || fs7.existsSync(pyprojectPath)) {
+  const requirementsPath = path11.join(projectRoot, "requirements.txt");
+  const pyprojectPath = path11.join(projectRoot, "pyproject.toml");
+  if (fs14.existsSync(requirementsPath) || fs14.existsSync(pyprojectPath)) {
     stacks.push("python");
   }
   return stacks;
@@ -7947,7 +8363,7 @@ var SecurityScanner = class {
   }
   async scanFile(filePath) {
     if (!this.config.enabled) return [];
-    const content = await fs8.readFile(filePath, "utf-8");
+    const content = await fs15.readFile(filePath, "utf-8");
     return this.scanContent(content, filePath, 1);
   }
   async scanFiles(filePaths) {
@@ -7972,7 +8388,7 @@ var SecurityScanner = class {
 };
 
 // src/ci/check-orchestrator.ts
-var path5 = __toESM(require("path"));
+var path12 = __toESM(require("path"));
 var ALL_CHECKS = [
   "validate",
   "deps",
@@ -7989,7 +8405,7 @@ async function runSingleCheck(name, projectRoot, config) {
   try {
     switch (name) {
       case "validate": {
-        const agentsPath = path5.join(projectRoot, config.agentsMapPath ?? "AGENTS.md");
+        const agentsPath = path12.join(projectRoot, config.agentsMapPath ?? "AGENTS.md");
         const result = await validateAgentsMap(agentsPath);
         if (!result.ok) {
           issues.push({ severity: "error", message: result.error.message });
@@ -8044,7 +8460,7 @@ async function runSingleCheck(name, projectRoot, config) {
         break;
       }
       case "docs": {
-        const docsDir = path5.join(projectRoot, config.docsDir ?? "docs");
+        const docsDir = path12.join(projectRoot, config.docsDir ?? "docs");
         const entropyConfig = config.entropy || {};
         const result = await checkDocCoverage("project", {
           docsDir,
@@ -8282,7 +8698,7 @@ async function runCIChecks(input) {
 }
 
 // src/review/mechanical-checks.ts
-var path6 = __toESM(require("path"));
+var path13 = __toESM(require("path"));
 async function runMechanicalChecks(options) {
   const { projectRoot, config, skip = [], changedFiles } = options;
   const findings = [];
@@ -8294,7 +8710,7 @@ async function runMechanicalChecks(options) {
   };
   if (!skip.includes("validate")) {
     try {
-      const agentsPath = path6.join(projectRoot, config.agentsMapPath ?? "AGENTS.md");
+      const agentsPath = path13.join(projectRoot, config.agentsMapPath ?? "AGENTS.md");
       const result = await validateAgentsMap(agentsPath);
       if (!result.ok) {
         statuses.validate = "fail";
@@ -8331,7 +8747,7 @@ async function runMechanicalChecks(options) {
       statuses.validate = "fail";
       findings.push({
         tool: "validate",
-        file: path6.join(projectRoot, "AGENTS.md"),
+        file: path13.join(projectRoot, "AGENTS.md"),
         message: err instanceof Error ? err.message : String(err),
         severity: "error"
       });
@@ -8395,7 +8811,7 @@ async function runMechanicalChecks(options) {
       (async () => {
         const localFindings = [];
         try {
-          const docsDir = path6.join(projectRoot, config.docsDir ?? "docs");
+          const docsDir = path13.join(projectRoot, config.docsDir ?? "docs");
           const result = await checkDocCoverage("project", { docsDir });
           if (!result.ok) {
             statuses["check-docs"] = "warn";
@@ -8422,7 +8838,7 @@ async function runMechanicalChecks(options) {
           statuses["check-docs"] = "warn";
           localFindings.push({
             tool: "check-docs",
-            file: path6.join(projectRoot, "docs"),
+            file: path13.join(projectRoot, "docs"),
             message: err instanceof Error ? err.message : String(err),
             severity: "warning"
           });
@@ -8570,7 +8986,7 @@ function detectChangeType(commitMessage, diff2) {
 }
 
 // src/review/context-scoper.ts
-var path7 = __toESM(require("path"));
+var path14 = __toESM(require("path"));
 var ALL_DOMAINS = ["compliance", "bug", "security", "architecture"];
 var SECURITY_PATTERNS = /auth|crypto|password|secret|token|session|cookie|hash|encrypt|decrypt|sql|shell|exec|eval/i;
 function computeContextBudget(diffLines) {
@@ -8578,18 +8994,18 @@ function computeContextBudget(diffLines) {
   return diffLines;
 }
 function isWithinProject(absPath, projectRoot) {
-  const resolvedRoot = path7.resolve(projectRoot) + path7.sep;
-  const resolvedPath = path7.resolve(absPath);
-  return resolvedPath.startsWith(resolvedRoot) || resolvedPath === path7.resolve(projectRoot);
+  const resolvedRoot = path14.resolve(projectRoot) + path14.sep;
+  const resolvedPath = path14.resolve(absPath);
+  return resolvedPath.startsWith(resolvedRoot) || resolvedPath === path14.resolve(projectRoot);
 }
 async function readContextFile(projectRoot, filePath, reason) {
-  const absPath = path7.isAbsolute(filePath) ? filePath : path7.join(projectRoot, filePath);
+  const absPath = path14.isAbsolute(filePath) ? filePath : path14.join(projectRoot, filePath);
   if (!isWithinProject(absPath, projectRoot)) return null;
   const result = await readFileContent(absPath);
   if (!result.ok) return null;
   const content = result.value;
   const lines = content.split("\n").length;
-  const relPath = path7.isAbsolute(filePath) ? path7.relative(projectRoot, filePath) : filePath;
+  const relPath = path14.isAbsolute(filePath) ? path14.relative(projectRoot, filePath) : filePath;
   return { path: relPath, content, reason, lines };
 }
 function extractImportSources2(content) {
@@ -8604,18 +9020,18 @@ function extractImportSources2(content) {
 }
 async function resolveImportPath2(projectRoot, fromFile, importSource) {
   if (!importSource.startsWith(".")) return null;
-  const fromDir = path7.dirname(path7.join(projectRoot, fromFile));
-  const basePath = path7.resolve(fromDir, importSource);
+  const fromDir = path14.dirname(path14.join(projectRoot, fromFile));
+  const basePath = path14.resolve(fromDir, importSource);
   if (!isWithinProject(basePath, projectRoot)) return null;
-  const relBase = path7.relative(projectRoot, basePath);
+  const relBase = path14.relative(projectRoot, basePath);
   const candidates = [
     relBase + ".ts",
     relBase + ".tsx",
     relBase + ".mts",
-    path7.join(relBase, "index.ts")
+    path14.join(relBase, "index.ts")
   ];
   for (const candidate of candidates) {
-    const absCandidate = path7.join(projectRoot, candidate);
+    const absCandidate = path14.join(projectRoot, candidate);
     if (await fileExists(absCandidate)) {
       return candidate;
     }
@@ -8623,10 +9039,10 @@ async function resolveImportPath2(projectRoot, fromFile, importSource) {
   return null;
 }
 async function findTestFiles(projectRoot, sourceFile) {
-  const baseName = path7.basename(sourceFile, path7.extname(sourceFile));
+  const baseName = path14.basename(sourceFile, path14.extname(sourceFile));
   const pattern = `**/${baseName}.{test,spec}.{ts,tsx,mts}`;
   const results = await findFiles(pattern, projectRoot);
-  return results.map((f) => path7.relative(projectRoot, f));
+  return results.map((f) => path14.relative(projectRoot, f));
 }
 async function gatherImportContext(projectRoot, changedFiles, budget) {
   const contextFiles = [];
@@ -9414,7 +9830,7 @@ async function fanOutReview(options) {
 }
 
 // src/review/validate-findings.ts
-var path8 = __toESM(require("path"));
+var path15 = __toESM(require("path"));
 var DOWNGRADE_MAP = {
   critical: "important",
   important: "suggestion",
@@ -9435,7 +9851,7 @@ function normalizePath(filePath, projectRoot) {
   let normalized = filePath;
   normalized = normalized.replace(/\\/g, "/");
   const normalizedRoot = projectRoot.replace(/\\/g, "/");
-  if (path8.isAbsolute(normalized)) {
+  if (path15.isAbsolute(normalized)) {
     const root = normalizedRoot.endsWith("/") ? normalizedRoot : normalizedRoot + "/";
     if (normalized.startsWith(root)) {
       normalized = normalized.slice(root.length);
@@ -9460,12 +9876,12 @@ function followImportChain(fromFile, fileContents, maxDepth = 2) {
     while ((match = importRegex.exec(content)) !== null) {
       const importPath = match[1];
       if (!importPath.startsWith(".")) continue;
-      const dir = path8.dirname(current.file);
-      let resolved = path8.join(dir, importPath).replace(/\\/g, "/");
+      const dir = path15.dirname(current.file);
+      let resolved = path15.join(dir, importPath).replace(/\\/g, "/");
       if (!resolved.match(/\.(ts|tsx|js|jsx)$/)) {
         resolved += ".ts";
       }
-      resolved = path8.normalize(resolved).replace(/\\/g, "/");
+      resolved = path15.normalize(resolved).replace(/\\/g, "/");
       if (!visited.has(resolved) && current.depth + 1 <= maxDepth) {
         queue.push({ file: resolved, depth: current.depth + 1 });
       }
@@ -9482,7 +9898,7 @@ async function validateFindings(options) {
     if (exclusionSet.isExcluded(normalizedFile, finding.lineRange) || exclusionSet.isExcluded(finding.file, finding.lineRange)) {
       continue;
     }
-    const absoluteFile = path8.isAbsolute(finding.file) ? finding.file : path8.join(projectRoot, finding.file).replace(/\\/g, "/");
+    const absoluteFile = path15.isAbsolute(finding.file) ? finding.file : path15.join(projectRoot, finding.file).replace(/\\/g, "/");
     if (exclusionSet.isExcluded(absoluteFile, finding.lineRange)) {
       continue;
     }
@@ -9965,7 +10381,7 @@ async function runReviewPipeline(options) {
 }
 
 // src/roadmap/parse.ts
-var import_types16 = require("@harness-engineering/types");
+var import_types18 = require("@harness-engineering/types");
 var VALID_STATUSES = /* @__PURE__ */ new Set([
   "backlog",
   "planned",
@@ -9977,14 +10393,14 @@ var EM_DASH = "\u2014";
 function parseRoadmap(markdown) {
   const fmMatch = markdown.match(/^---\n([\s\S]*?)\n---/);
   if (!fmMatch) {
-    return (0, import_types16.Err)(new Error("Missing or malformed YAML frontmatter"));
+    return (0, import_types18.Err)(new Error("Missing or malformed YAML frontmatter"));
   }
   const fmResult = parseFrontmatter(fmMatch[1]);
   if (!fmResult.ok) return fmResult;
   const body = markdown.slice(fmMatch[0].length);
   const milestonesResult = parseMilestones(body);
   if (!milestonesResult.ok) return milestonesResult;
-  return (0, import_types16.Ok)({
+  return (0, import_types18.Ok)({
     frontmatter: fmResult.value,
     milestones: milestonesResult.value
   });
@@ -10003,8 +10419,10 @@ function parseFrontmatter(raw) {
   const versionStr = map.get("version");
   const lastSynced = map.get("last_synced");
   const lastManualEdit = map.get("last_manual_edit");
+  const created = map.get("created");
+  const updated = map.get("updated");
   if (!project || !versionStr || !lastSynced || !lastManualEdit) {
-    return (0, import_types16.Err)(
+    return (0, import_types18.Err)(
       new Error(
         "Frontmatter missing required fields: project, version, last_synced, last_manual_edit"
       )
@@ -10012,9 +10430,12 @@ function parseFrontmatter(raw) {
   }
   const version = parseInt(versionStr, 10);
   if (isNaN(version)) {
-    return (0, import_types16.Err)(new Error("Frontmatter version must be a number"));
+    return (0, import_types18.Err)(new Error("Frontmatter version must be a number"));
   }
-  return (0, import_types16.Ok)({ project, version, lastSynced, lastManualEdit });
+  const fm = { project, version, lastSynced, lastManualEdit };
+  if (created) fm.created = created;
+  if (updated) fm.updated = updated;
+  return (0, import_types18.Ok)(fm);
 }
 function parseMilestones(body) {
   const milestones = [];
@@ -10022,12 +10443,12 @@ function parseMilestones(body) {
   const h2Matches = [];
   let match;
   while ((match = h2Pattern.exec(body)) !== null) {
-    h2Matches.push({ heading: match[1], startIndex: match.index });
+    h2Matches.push({ heading: match[1], startIndex: match.index, fullMatch: match[0] });
   }
   for (let i = 0; i < h2Matches.length; i++) {
     const h2 = h2Matches[i];
     const nextStart = i + 1 < h2Matches.length ? h2Matches[i + 1].startIndex : body.length;
-    const sectionBody = body.slice(h2.startIndex + h2.heading.length + 4, nextStart);
+    const sectionBody = body.slice(h2.startIndex + h2.fullMatch.length, nextStart);
     const isBacklog = h2.heading === "Backlog";
     const milestoneName = isBacklog ? "Backlog" : h2.heading.replace(/^Milestone:\s*/, "");
     const featuresResult = parseFeatures(sectionBody);
@@ -10038,28 +10459,25 @@ function parseMilestones(body) {
       features: featuresResult.value
     });
   }
-  return (0, import_types16.Ok)(milestones);
+  return (0, import_types18.Ok)(milestones);
 }
 function parseFeatures(sectionBody) {
   const features = [];
-  const h3Pattern = /^### Feature: (.+)$/gm;
+  const h3Pattern = /^### (?:Feature: )?(.+)$/gm;
   const h3Matches = [];
   let match;
   while ((match = h3Pattern.exec(sectionBody)) !== null) {
-    h3Matches.push({ name: match[1], startIndex: match.index });
+    h3Matches.push({ name: match[1], startIndex: match.index, fullMatch: match[0] });
   }
   for (let i = 0; i < h3Matches.length; i++) {
     const h3 = h3Matches[i];
     const nextStart = i + 1 < h3Matches.length ? h3Matches[i + 1].startIndex : sectionBody.length;
-    const featureBody = sectionBody.slice(
-      h3.startIndex + `### Feature: ${h3.name}`.length,
-      nextStart
-    );
+    const featureBody = sectionBody.slice(h3.startIndex + h3.fullMatch.length, nextStart);
     const featureResult = parseFeatureFields(h3.name, featureBody);
     if (!featureResult.ok) return featureResult;
     features.push(featureResult.value);
   }
-  return (0, import_types16.Ok)(features);
+  return (0, import_types18.Ok)(features);
 }
 function parseFeatureFields(name, body) {
   const fieldMap = /* @__PURE__ */ new Map();
@@ -10070,7 +10488,7 @@ function parseFeatureFields(name, body) {
   }
   const statusRaw = fieldMap.get("Status");
   if (!statusRaw || !VALID_STATUSES.has(statusRaw)) {
-    return (0, import_types16.Err)(
+    return (0, import_types18.Err)(
       new Error(
         `Feature "${name}" has invalid status: "${statusRaw ?? "(missing)"}". Valid statuses: ${[...VALID_STATUSES].join(", ")}`
       )
@@ -10079,12 +10497,12 @@ function parseFeatureFields(name, body) {
   const status = statusRaw;
   const specRaw = fieldMap.get("Spec") ?? EM_DASH;
   const spec = specRaw === EM_DASH ? null : specRaw;
-  const plansRaw = fieldMap.get("Plans") ?? EM_DASH;
-  const plans = plansRaw === EM_DASH ? [] : plansRaw.split(",").map((p) => p.trim());
-  const blockedByRaw = fieldMap.get("Blocked by") ?? EM_DASH;
-  const blockedBy = blockedByRaw === EM_DASH ? [] : blockedByRaw.split(",").map((b) => b.trim());
+  const plansRaw = fieldMap.get("Plans") ?? fieldMap.get("Plan") ?? EM_DASH;
+  const plans = plansRaw === EM_DASH || plansRaw === "none" ? [] : plansRaw.split(",").map((p) => p.trim());
+  const blockedByRaw = fieldMap.get("Blocked by") ?? fieldMap.get("Blockers") ?? EM_DASH;
+  const blockedBy = blockedByRaw === EM_DASH || blockedByRaw === "none" ? [] : blockedByRaw.split(",").map((b) => b.trim());
   const summary = fieldMap.get("Summary") ?? "";
-  return (0, import_types16.Ok)({ name, status, spec, plans, blockedBy, summary });
+  return (0, import_types18.Ok)({ name, status, spec, plans, blockedBy, summary });
 }
 
 // src/roadmap/serialize.ts
@@ -10094,11 +10512,17 @@ function serializeRoadmap(roadmap) {
   lines.push("---");
   lines.push(`project: ${roadmap.frontmatter.project}`);
   lines.push(`version: ${roadmap.frontmatter.version}`);
+  if (roadmap.frontmatter.created) {
+    lines.push(`created: ${roadmap.frontmatter.created}`);
+  }
+  if (roadmap.frontmatter.updated) {
+    lines.push(`updated: ${roadmap.frontmatter.updated}`);
+  }
   lines.push(`last_synced: ${roadmap.frontmatter.lastSynced}`);
   lines.push(`last_manual_edit: ${roadmap.frontmatter.lastManualEdit}`);
   lines.push("---");
   lines.push("");
-  lines.push("# Project Roadmap");
+  lines.push("# Roadmap");
   for (const milestone of roadmap.milestones) {
     lines.push("");
     lines.push(serializeMilestoneHeading(milestone));
@@ -10111,26 +10535,27 @@ function serializeRoadmap(roadmap) {
   return lines.join("\n");
 }
 function serializeMilestoneHeading(milestone) {
-  return milestone.isBacklog ? "## Backlog" : `## Milestone: ${milestone.name}`;
+  return milestone.isBacklog ? "## Backlog" : `## ${milestone.name}`;
 }
 function serializeFeature(feature) {
   const spec = feature.spec ?? EM_DASH2;
   const plans = feature.plans.length > 0 ? feature.plans.join(", ") : EM_DASH2;
   const blockedBy = feature.blockedBy.length > 0 ? feature.blockedBy.join(", ") : EM_DASH2;
   return [
-    `### Feature: ${feature.name}`,
+    `### ${feature.name}`,
+    "",
     `- **Status:** ${feature.status}`,
     `- **Spec:** ${spec}`,
-    `- **Plans:** ${plans}`,
-    `- **Blocked by:** ${blockedBy}`,
-    `- **Summary:** ${feature.summary}`
+    `- **Summary:** ${feature.summary}`,
+    `- **Blockers:** ${blockedBy}`,
+    `- **Plan:** ${plans}`
   ];
 }
 
 // src/roadmap/sync.ts
-var fs9 = __toESM(require("fs"));
-var path9 = __toESM(require("path"));
-var import_types17 = require("@harness-engineering/types");
+var fs16 = __toESM(require("fs"));
+var path16 = __toESM(require("path"));
+var import_types19 = require("@harness-engineering/types");
 function inferStatus(feature, projectPath, allFeatures) {
   if (feature.blockedBy.length > 0) {
     const blockerNotDone = feature.blockedBy.some((blockerName) => {
@@ -10144,10 +10569,10 @@ function inferStatus(feature, projectPath, allFeatures) {
   const featuresWithPlans = allFeatures.filter((f) => f.plans.length > 0);
   const useRootState = featuresWithPlans.length <= 1;
   if (useRootState) {
-    const rootStatePath = path9.join(projectPath, ".harness", "state.json");
-    if (fs9.existsSync(rootStatePath)) {
+    const rootStatePath = path16.join(projectPath, ".harness", "state.json");
+    if (fs16.existsSync(rootStatePath)) {
       try {
-        const raw = fs9.readFileSync(rootStatePath, "utf-8");
+        const raw = fs16.readFileSync(rootStatePath, "utf-8");
         const state = JSON.parse(raw);
         if (state.progress) {
           for (const status of Object.values(state.progress)) {
@@ -10158,16 +10583,16 @@ function inferStatus(feature, projectPath, allFeatures) {
       }
     }
   }
-  const sessionsDir = path9.join(projectPath, ".harness", "sessions");
-  if (fs9.existsSync(sessionsDir)) {
+  const sessionsDir = path16.join(projectPath, ".harness", "sessions");
+  if (fs16.existsSync(sessionsDir)) {
     try {
-      const sessionDirs = fs9.readdirSync(sessionsDir, { withFileTypes: true });
+      const sessionDirs = fs16.readdirSync(sessionsDir, { withFileTypes: true });
       for (const entry of sessionDirs) {
         if (!entry.isDirectory()) continue;
-        const autopilotPath = path9.join(sessionsDir, entry.name, "autopilot-state.json");
-        if (!fs9.existsSync(autopilotPath)) continue;
+        const autopilotPath = path16.join(sessionsDir, entry.name, "autopilot-state.json");
+        if (!fs16.existsSync(autopilotPath)) continue;
         try {
-          const raw = fs9.readFileSync(autopilotPath, "utf-8");
+          const raw = fs16.readFileSync(autopilotPath, "utf-8");
           const autopilot = JSON.parse(raw);
           if (!autopilot.phases) continue;
           const linkedPhases = autopilot.phases.filter(
@@ -10214,7 +10639,7 @@ function syncRoadmap(options) {
       to: inferred
     });
   }
-  return (0, import_types17.Ok)(changes);
+  return (0, import_types19.Ok)(changes);
 }
 
 // src/interaction/types.ts
@@ -10247,17 +10672,17 @@ var EmitInteractionInputSchema = import_zod7.z.object({
 });
 
 // src/blueprint/scanner.ts
-var fs10 = __toESM(require("fs/promises"));
-var path10 = __toESM(require("path"));
+var fs17 = __toESM(require("fs/promises"));
+var path17 = __toESM(require("path"));
 var ProjectScanner = class {
   constructor(rootDir) {
     this.rootDir = rootDir;
   }
   async scan() {
-    let projectName = path10.basename(this.rootDir);
+    let projectName = path17.basename(this.rootDir);
     try {
-      const pkgPath = path10.join(this.rootDir, "package.json");
-      const pkgRaw = await fs10.readFile(pkgPath, "utf-8");
+      const pkgPath = path17.join(this.rootDir, "package.json");
+      const pkgRaw = await fs17.readFile(pkgPath, "utf-8");
       const pkg = JSON.parse(pkgRaw);
       if (pkg.name) projectName = pkg.name;
     } catch {
@@ -10298,8 +10723,8 @@ var ProjectScanner = class {
 };
 
 // src/blueprint/generator.ts
-var fs11 = __toESM(require("fs/promises"));
-var path11 = __toESM(require("path"));
+var fs18 = __toESM(require("fs/promises"));
+var path18 = __toESM(require("path"));
 var ejs = __toESM(require("ejs"));
 
 // src/blueprint/templates.ts
@@ -10327,16 +10752,6 @@ var SHELL_TEMPLATE = `
                     <div class="content">
                         <h3>Code Translation</h3>
                         <div class="translation"><%- module.content.codeTranslation %></div>
-                        <h3>Knowledge Check</h3>
-                        <div class="quiz">
-                            <% module.content.quiz.questions.forEach((q, i) => { %>
-                                <div class="question">
-                                    <p><%= q.question %></p>
-                                    <button onclick="reveal(this)">Reveal Answer</button>
-                                    <p class="answer" style="display:none;"><%= q.answer %></p>
-                                </div>
-                            <% }) %>
-                        </div>
                     </div>
                     </article>
 
@@ -10355,10 +10770,6 @@ header { border-bottom: 2px solid #eee; margin-bottom: 20px; padding-bottom: 10p
 .module h2 { margin-top: 0; color: #0066cc; }
 `;
 var SCRIPTS = `
-function reveal(btn) {
-    btn.nextElementSibling.style.display = 'block';
-    btn.style.display = 'none';
-}
 console.log('Blueprint player initialized.');
 `;
 
@@ -10377,20 +10788,8 @@ var ContentPipeline = class {
     const translation = await llmService.generate(
       `You are a technical educator. Explain the following code clearly and concisely: ${codeContext}`
     );
-    const quizJson = await llmService.generate(
-      `Create 3 technical quiz questions for this code. Return ONLY valid JSON in this format: { "questions": [{ "question": "...", "answer": "..." }] }. Code: ${codeContext}`
-    );
-    let quiz;
-    try {
-      const cleanJson = quizJson.replace(/```json/g, "").replace(/```/g, "").trim();
-      quiz = JSON.parse(cleanJson);
-    } catch (e) {
-      console.error("Failed to parse quiz JSON", e);
-      quiz = { questions: [{ question: "Failed to generate quiz", answer: "N/A" }] };
-    }
     return {
-      codeTranslation: translation,
-      quiz
+      codeTranslation: translation
     };
   }
 };
@@ -10409,19 +10808,19 @@ var BlueprintGenerator = class {
       styles: STYLES,
       scripts: SCRIPTS
     });
-    await fs11.mkdir(options.outputDir, { recursive: true });
-    await fs11.writeFile(path11.join(options.outputDir, "index.html"), html);
+    await fs18.mkdir(options.outputDir, { recursive: true });
+    await fs18.writeFile(path18.join(options.outputDir, "index.html"), html);
   }
 };
 
 // src/update-checker.ts
-var fs12 = __toESM(require("fs"));
-var path12 = __toESM(require("path"));
+var fs19 = __toESM(require("fs"));
+var path19 = __toESM(require("path"));
 var os = __toESM(require("os"));
 var import_child_process3 = require("child_process");
 function getStatePath() {
   const home = process.env["HOME"] || os.homedir();
-  return path12.join(home, ".harness", "update-check.json");
+  return path19.join(home, ".harness", "update-check.json");
 }
 function isUpdateCheckEnabled(configInterval) {
   if (process.env["HARNESS_NO_UPDATE_CHECK"] === "1") return false;
@@ -10434,7 +10833,7 @@ function shouldRunCheck(state, intervalMs) {
 }
 function readCheckState() {
   try {
-    const raw = fs12.readFileSync(getStatePath(), "utf-8");
+    const raw = fs19.readFileSync(getStatePath(), "utf-8");
     const parsed = JSON.parse(raw);
     if (typeof parsed === "object" && parsed !== null && "lastCheckTime" in parsed && typeof parsed.lastCheckTime === "number" && "currentVersion" in parsed && typeof parsed.currentVersion === "string") {
       const state = parsed;
@@ -10451,7 +10850,7 @@ function readCheckState() {
 }
 function spawnBackgroundCheck(currentVersion) {
   const statePath = getStatePath();
-  const stateDir = path12.dirname(statePath);
+  const stateDir = path19.dirname(statePath);
   const script = `
 const { execSync } = require('child_process');
 const fs = require('fs');
@@ -10583,6 +10982,7 @@ var VERSION = "0.11.0";
   ViolationSchema,
   addProvenance,
   analyzeDiff,
+  analyzeLearningPatterns,
   appendFailure,
   appendLearning,
   applyFixes,
@@ -10591,6 +10991,7 @@ var VERSION = "0.11.0";
   archModule,
   architecture,
   archiveFailures,
+  archiveLearnings,
   archiveStream,
   buildDependencyGraph,
   buildExclusionSet,
@@ -10598,6 +10999,8 @@ var VERSION = "0.11.0";
   checkDocCoverage,
   checkEligibility,
   classifyFinding,
+  clearFailuresCache,
+  clearLearningsCache,
   configureFeedback,
   constraintRuleId,
   contextBudget,
@@ -10653,16 +11056,20 @@ var VERSION = "0.11.0";
   injectionRules,
   isSmallSuggestion,
   isUpdateCheckEnabled,
+  listActiveSessions,
   listStreams,
+  loadBudgetedLearnings,
   loadFailures,
   loadHandoff,
   loadRelevantLearnings,
+  loadSessionSummary,
   loadState,
   loadStreamIndex,
   logAgentAction,
   migrateToStreams,
   networkRules,
   nodeRules,
+  parseDateFromEntry,
   parseDiff,
   parseManifest,
   parseRoadmap,
@@ -10670,9 +11077,11 @@ var VERSION = "0.11.0";
   parseSize,
   pathTraversalRules,
   previewFix,
+  pruneLearnings,
   reactRules,
   readCheckState,
   readLockfile,
+  removeContributions,
   removeProvenance,
   requestMultiplePeerReviews,
   requestPeerReview,
@@ -10680,6 +11089,7 @@ var VERSION = "0.11.0";
   resolveFileToLayer,
   resolveModelTier,
   resolveRuleSeverity,
+  resolveSessionDir,
   resolveStreamPath,
   resolveThresholds,
   runAll,
@@ -10706,6 +11116,7 @@ var VERSION = "0.11.0";
   syncRoadmap,
   touchStream,
   trackAction,
+  updateSessionIndex,
   validateAgentsMap,
   validateBoundaries,
   validateCommitMessage,
@@ -10718,6 +11129,7 @@ var VERSION = "0.11.0";
   violationId,
   writeConfig,
   writeLockfile,
+  writeSessionSummary,
   xssRules,
   ...require("@harness-engineering/types")
 });