@harness-engineering/cli 1.12.0 → 1.13.0

package/dist/{chunk-AE2OWWDH.js → chunk-KELT6K6M.js}

@@ -106,8 +106,8 @@ var ConstraintRuleSchema = z.object({
   // forward-compat for governs edges
 });
 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 createHash("sha256").update(input).digest("hex");
 }
 function constraintRuleId(category, scope, description) {
@@ -139,17 +139,17 @@ function resolveFileToLayer(file, layers) {
 }
 var accessAsync = promisify(access);
 var readFileAsync = promisify(readFile);
-async function fileExists(path13) {
+async function fileExists(path20) {
   try {
-    await accessAsync(path13, constants.F_OK);
+    await accessAsync(path20, 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 Ok(content);
   } catch (error) {
     return Err(error);
@@ -1770,31 +1770,45 @@ import * as path from "path";
 import { appendFileSync, writeFileSync as writeFileSync22, existsSync as existsSync22, mkdirSync as mkdirSync22 } from "fs";
 import { dirname as dirname7 } from "path";
 import { z as z3 } from "zod";
-import * as fs6 from "fs";
-import * as path3 from "path";
-import { execSync as execSync2 } from "child_process";
+import * as fs8 from "fs";
+import * as path5 from "path";
+import * as fs7 from "fs";
+import * as path4 from "path";
 import * as fs5 from "fs";
 import * as path2 from "path";
 import { execSync } from "child_process";
 import { z as z4 } from "zod";
-import * as fs8 from "fs/promises";
-import { z as z5 } from "zod";
-import * as fs7 from "fs";
-import * as path4 from "path";
-import * as path5 from "path";
+import * as fs6 from "fs";
+import * as path3 from "path";
+import * as fs9 from "fs";
 import * as path6 from "path";
+import * as fs10 from "fs";
 import * as path7 from "path";
+import * as fs11 from "fs";
 import * as path8 from "path";
-import * as fs9 from "fs";
+import * as fs12 from "fs";
 import * as path9 from "path";
-import { z as z6 } from "zod";
-import * as fs10 from "fs/promises";
+import { execSync as execSync2 } from "child_process";
+import * as fs13 from "fs";
 import * as path10 from "path";
-import * as fs11 from "fs/promises";
+import * as fs15 from "fs/promises";
+import { z as z5 } from "zod";
+import * as fs14 from "fs";
 import * as path11 from "path";
-import * as ejs from "ejs";
-import * as fs12 from "fs";
 import * as path12 from "path";
+import * as path13 from "path";
+import * as path14 from "path";
+import * as path15 from "path";
+import * as fs16 from "fs";
+import * as path16 from "path";
+import { z as z6 } from "zod";
+import * as fs17 from "fs/promises";
+import * as path17 from "path";
+import * as fs18 from "fs/promises";
+import * as path18 from "path";
+import * as ejs from "ejs";
+import * as fs19 from "fs";
+import * as path19 from "path";
 import * as os from "os";
 import { spawn } from "child_process";
 async function validateFileStructure(projectPath, conventions) {
@@ -1832,15 +1846,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}`;
@@ -2046,30 +2060,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(".") ? join4(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 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 = dirname4(path13);
+  const baseDir = dirname4(path20);
   const sectionTitles = sections.map((s) => s.title);
   const missingSections = REQUIRED_SECTIONS.filter(
     (required) => !sectionTitles.some((title) => title.toLowerCase().includes(required.toLowerCase()))
@@ -2203,8 +2214,8 @@ async function checkDocCoverage(domain, options = {}) {
     );
   }
 }
-function suggestFix(path13, existingFiles) {
-  const targetName = basename2(path13).toLowerCase();
+function suggestFix(path20, existingFiles) {
+  const targetName = basename2(path20).toLowerCase();
   const similar = existingFiles.find((file) => {
     const fileName = basename2(file).toLowerCase();
     return fileName.includes(targetName) || targetName.includes(fileName);
@@ -2212,12 +2223,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 = join22(rootDir, "AGENTS.md");
   const agentsResult = await validateAgentsMap(agentsPath);
   if (!agentsResult.ok) {
@@ -2558,8 +2566,8 @@ function createBoundaryValidator(schema, name) {
         return 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 Err(
         createError(
@@ -3089,11 +3097,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 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"
         ])
@@ -3103,7 +3111,7 @@ var TypeScriptParser = class {
       const ast = parse(contentResult.value, {
         loc: true,
         range: true,
-        jsx: path13.endsWith(".tsx"),
+        jsx: path20.endsWith(".tsx"),
         errorOnUnknownASTType: false
       });
       return Ok({
@@ -3114,7 +3122,7 @@ var TypeScriptParser = class {
     } catch (e) {
       const error = e;
       return 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"
         ])
@@ -3394,22 +3402,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 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 Ok({
-    path: path13,
+    path: path20,
     type,
     content,
     codeBlocks: extractCodeBlocks(content),
@@ -4210,15 +4218,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 Ok({
     violations,
     stats: {
       filesChecked: snapshot.files.length,
-      patternsApplied: patterns.length,
+      patternsApplied: allPatternsCount,
       violationCount: violations.length,
       errorCount,
       warningCount
@@ -6349,8 +6376,16 @@ var DEFAULT_STREAM_INDEX = {
   streams: {}
 };
 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";
+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);
@@ -6576,25 +6611,60 @@ async function migrateToStreams(projectPath) {
   };
   return saveStreamIndex(projectPath, index);
 }
-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";
+function resolveSessionDir(projectPath, sessionSlug, options) {
+  if (!sessionSlug || sessionSlug.trim() === "") {
+    return Err(new Error("Session slug must not be empty"));
+  }
+  if (sessionSlug.includes("..") || sessionSlug.includes("/") || sessionSlug.includes("\\")) {
+    return 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 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"));
+}
 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) {
@@ -6604,18 +6674,18 @@ async function getStateDir(projectPath, stream) {
       return result;
     }
   }
-  return Ok(path3.join(projectPath, HARNESS_DIR2));
+  return Ok(path4.join(projectPath, HARNESS_DIR));
 }
-async function loadState(projectPath, stream) {
+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 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) {
@@ -6628,14 +6698,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 Ok(void 0);
   } catch (error) {
     return Err(
@@ -6643,13 +6713,17 @@ async function saveState(projectPath, state, stream) {
     );
   }
 }
-async function appendLearning(projectPath, learning, skillName, outcome, stream) {
+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) {
@@ -6665,11 +6739,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 Ok(void 0);
@@ -6681,23 +6755,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 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 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 = [];
@@ -6733,23 +6876,106 @@ 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 failuresPath = path3.join(stateDir, FAILURES_FILE);
-    fs6.mkdirSync(stateDir, { recursive: true });
+    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 Ok(void 0);
+  } catch (error) {
+    return 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 learningsPath = path6.join(stateDir, LEARNINGS_FILE);
+    if (!fs9.existsSync(learningsPath)) {
+      return 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 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 Ok({
+      kept: toKeep.length,
+      archived: toArchive.length,
+      patterns
+    });
+  } catch (error) {
+    return Err(
+      new Error(
+        `Failed to prune learnings: ${error instanceof Error ? error.message : String(error)}`
+      )
+    );
+  }
+}
+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 Ok(void 0);
@@ -6761,22 +6987,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 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 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);
@@ -6800,25 +7026,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 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 Ok(void 0);
   } catch (error) {
@@ -6829,14 +7055,14 @@ async function archiveFailures(projectPath, stream) {
     );
   }
 }
-async function saveHandoff(projectPath, handoff, stream) {
+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 Ok(void 0);
   } catch (error) {
     return Err(
@@ -6844,16 +7070,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 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) {
@@ -6866,73 +7092,77 @@ async function loadHandoff(projectPath, stream) {
     );
   }
 }
+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 {
+    execSync2(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 {
-        execSync2(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 Ok({
       passed: results.length === 0 || results.every((r) => r.passed),
       checks: results
@@ -6945,6 +7175,92 @@ async function runMechanicalGate(projectPath) {
     );
   }
 }
+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 Ok(void 0);
+  } catch (error) {
+    return 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 Ok(null);
+    }
+    const content = fs13.readFileSync(summaryPath, "utf-8");
+    return Ok(content);
+  } catch (error) {
+    return 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 Ok(null);
+    }
+    const content = fs13.readFileSync(indexPath2, "utf-8");
+    return Ok(content);
+  } catch (error) {
+    return Err(
+      new Error(
+        `Failed to list active sessions: ${error instanceof Error ? error.message : String(error)}`
+      )
+    );
+  }
+}
 async function executeWorkflow(workflow, executor) {
   const stepResults = [];
   const startTime = Date.now();
@@ -7166,11 +7482,11 @@ function resolveRuleSeverity(ruleId, defaultSeverity, overrides, strict) {
 }
 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
@@ -7185,13 +7501,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;
@@ -7594,7 +7910,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) {
@@ -7633,7 +7949,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 });
@@ -7688,7 +8004,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,
@@ -7935,7 +8251,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";
@@ -7972,7 +8288,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"
       });
@@ -8036,7 +8352,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";
@@ -8063,7 +8379,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"
           });
@@ -8212,18 +8528,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) {
@@ -8238,18 +8554,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;
     }
@@ -8257,10 +8573,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 = [];
@@ -9052,7 +9368,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);
@@ -9077,12 +9393,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 });
       }
@@ -9099,7 +9415,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;
     }
@@ -9603,6 +9919,8 @@ 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 Err(
       new Error(
@@ -9614,7 +9932,10 @@ function parseFrontmatter(raw) {
   if (isNaN(version)) {
     return Err(new Error("Frontmatter version must be a number"));
   }
-  return Ok({ project, version, lastSynced, lastManualEdit });
+  const fm = { project, version, lastSynced, lastManualEdit };
+  if (created) fm.created = created;
+  if (updated) fm.updated = updated;
+  return Ok(fm);
 }
 function parseMilestones(body) {
   const milestones = [];
@@ -9622,12 +9943,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);
@@ -9642,19 +9963,16 @@ function parseMilestones(body) {
 }
 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);
@@ -9679,10 +9997,10 @@ 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 Ok({ name, status, spec, plans, blockedBy, summary });
 }
@@ -9692,11 +10010,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));
@@ -9709,19 +10033,20 @@ 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}`
   ];
 }
 function inferStatus(feature, projectPath, allFeatures) {
@@ -9737,10 +10062,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)) {
@@ -9751,16 +10076,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(
@@ -9840,10 +10165,10 @@ var ProjectScanner = class {
     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 {
@@ -9956,13 +10281,13 @@ 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);
   }
 };
 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;
@@ -9975,7 +10300,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;
@@ -9992,7 +10317,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');
@@ -10182,16 +10507,28 @@ export {
   archiveStream,
   getStreamForBranch,
   migrateToStreams,
+  resolveSessionDir,
+  updateSessionIndex,
   loadState,
   saveState,
+  clearLearningsCache,
   appendLearning,
+  parseDateFromEntry,
+  analyzeLearningPatterns,
+  loadBudgetedLearnings,
   loadRelevantLearnings,
+  archiveLearnings,
+  pruneLearnings,
+  clearFailuresCache,
   appendFailure,
   loadFailures,
   archiveFailures,
   saveHandoff,
   loadHandoff,
   runMechanicalGate,
+  writeSessionSummary,
+  loadSessionSummary,
+  listActiveSessions,
   executeWorkflow,
   runPipeline,
   runMultiTurnPipeline,