dreamcontext 0.7.0 → 0.7.1

package/dist/index.js

@@ -441,9 +441,9 @@ function recordFile(manifest, relPath, version, kind) {
 function recordPack(manifest, name, version) {
   manifest.packs[name] = { version };
 }
-function recordPlatform(manifest, platform) {
-  if (!manifest.platforms.includes(platform)) {
-    manifest.platforms.push(platform);
+function recordPlatform(manifest, platform2) {
+  if (!manifest.platforms.includes(platform2)) {
+    manifest.platforms.push(platform2);
   }
 }
 function diffManifests(oldM, nextM) {
@@ -570,11 +570,11 @@ import { join as join5 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 import chalk2 from "chalk";
 import { select } from "@inquirer/prompts";
-function getFenceStart(platform) {
-  return `<!-- dreamcontext:${platform}:start -->`;
+function getFenceStart(platform2) {
+  return `<!-- dreamcontext:${platform2}:start -->`;
 }
-function getFenceEnd(platform) {
-  return `<!-- dreamcontext:${platform}:end -->`;
+function getFenceEnd(platform2) {
+  return `<!-- dreamcontext:${platform2}:end -->`;
 }
 function findTemplate(filename) {
   const candidates = [
@@ -588,18 +588,18 @@ function findTemplate(filename) {
   }
   return null;
 }
-function buildBlock(platform, templateBody) {
-  return `${getFenceStart(platform)}
+function buildBlock(platform2, templateBody) {
+  return `${getFenceStart(platform2)}
 ${templateBody.trim()}
-${getFenceEnd(platform)}
+${getFenceEnd(platform2)}
 `;
 }
-function hasFence(content, platform) {
-  return content.includes(getFenceStart(platform)) && content.includes(getFenceEnd(platform));
+function hasFence(content, platform2) {
+  return content.includes(getFenceStart(platform2)) && content.includes(getFenceEnd(platform2));
 }
-function replaceFence(content, platform, block) {
-  const startFence = getFenceStart(platform);
-  const endFence = getFenceEnd(platform);
+function replaceFence(content, platform2, block) {
+  const startFence = getFenceStart(platform2);
+  const endFence = getFenceEnd(platform2);
   const startIdx = content.indexOf(startFence);
   const endIdx = content.indexOf(endFence);
   if (startIdx === -1 || endIdx === -1 || endIdx < startIdx) return content;
@@ -633,38 +633,38 @@ async function resolveMode(target, requested) {
   });
   return choice;
 }
-async function installInstructions(projectRoot, platform, requestedMode) {
-  const spec = INSTRUCTION_SPECS[platform];
+async function installInstructions(projectRoot, platform2, requestedMode) {
+  const spec = INSTRUCTION_SPECS[platform2];
   const templatePath = findTemplate(spec.templateFile);
   if (!templatePath) {
     throw new Error(`${spec.templateFile} template not found. Try reinstalling dreamcontext.`);
   }
   const templateBody = readFileSync5(templatePath, "utf-8");
-  const block = buildBlock(platform, templateBody);
+  const block = buildBlock(platform2, templateBody);
   const target = join5(projectRoot, spec.targetFile);
   if (!existsSync5(target)) {
     writeFileSync5(target, block, "utf-8");
-    return { action: "created", target, platform };
+    return { action: "created", target, platform: platform2 };
   }
   const existing = readFileSync5(target, "utf-8");
-  if (hasFence(existing, platform)) {
-    const next = replaceFence(existing, platform, block);
+  if (hasFence(existing, platform2)) {
+    const next = replaceFence(existing, platform2, block);
     writeFileSync5(target, next, "utf-8");
-    return { action: "updated", target, platform };
+    return { action: "updated", target, platform: platform2 };
   }
   const mode = await resolveMode(spec.targetFile, requestedMode);
   if (mode === "skip") {
-    return { action: "skipped", target, platform };
+    return { action: "skipped", target, platform: platform2 };
   }
   if (mode === "replace") {
     const backup = backupPath(target);
     copyFileSync(target, backup);
     writeFileSync5(target, block, "utf-8");
-    return { action: "replaced", target, platform, backup };
+    return { action: "replaced", target, platform: platform2, backup };
   }
   const sep7 = existing.endsWith("\n") ? "\n" : "\n\n";
   writeFileSync5(target, existing + sep7 + block, "utf-8");
-  return { action: "appended", target, platform };
+  return { action: "appended", target, platform: platform2 };
 }
 async function installClaudeMd(projectRoot, requestedMode) {
   return installInstructions(projectRoot, "claude", requestedMode);
@@ -727,8 +727,8 @@ function registerInstallInstructionsCommand(program) {
         return;
       }
       const platforms = parsePlatformsOption(opts.platforms);
-      for (const platform of platforms) {
-        const result = await installInstructions(projectRoot, platform, mode);
+      for (const platform2 of platforms) {
+        const result = await installInstructions(projectRoot, platform2, mode);
         printResult(result);
       }
       printDeprecationHint("install-instructions");
@@ -826,12 +826,12 @@ var init_claude_settings = __esm({
 import { existsSync as existsSync7, readFileSync as readFileSync7, readdirSync as readdirSync2 } from "fs";
 import { basename as basename2, join as join7 } from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
-function platformSkillRoot(projectRoot, platform) {
-  if (platform === "claude") return join7(projectRoot, ".claude", "skills");
+function platformSkillRoot(projectRoot, platform2) {
+  if (platform2 === "claude") return join7(projectRoot, ".claude", "skills");
   return join7(projectRoot, ".agents", "skills");
 }
-function isPackInstalledForPlatform(projectRoot, platform, name) {
-  return existsSync7(join7(platformSkillRoot(projectRoot, platform), name, "SKILL.md"));
+function isPackInstalledForPlatform(projectRoot, platform2, name) {
+  return existsSync7(join7(platformSkillRoot(projectRoot, platform2), name, "SKILL.md"));
 }
 function isSkillInstalled(projectRoot, name) {
   return SUPPORTED_PLATFORMS.some((p) => isPackInstalledForPlatform(projectRoot, p, name));
@@ -929,8 +929,8 @@ function writeCodexAgent(projectRoot, agentPath) {
   writeFileSync7(configPath2, lines.join("\n"), "utf-8");
   return `.codex/agents/${parsed.name}.toml`;
 }
-function installAgentForPlatform(platform, projectRoot, agentPath, agentName) {
-  if (platform === "claude") {
+function installAgentForPlatform(platform2, projectRoot, agentPath, agentName) {
+  if (platform2 === "claude") {
     const agentsDestDir = join8(projectRoot, ".claude", "agents");
     mkdirSync5(agentsDestDir, { recursive: true });
     const file = agentName ? `${agentName}.md` : basename3(agentPath);
@@ -944,10 +944,10 @@ function recordIfManifest(manifest, relPath, kind) {
   if (!manifest) return;
   recordFile(manifest, relPath, dreamcontextVersion(), kind);
 }
-function installPackFiles(pack, packsDir, projectRoot, catalog, platform, manifest) {
+function installPackFiles(pack, packsDir, projectRoot, catalog, platform2, manifest) {
   const installed = [];
   const packSourceDir = join8(packsDir, pack.name);
-  const skillRoot = platformSkillRoot(projectRoot, platform);
+  const skillRoot = platformSkillRoot(projectRoot, platform2);
   const skillDestDir = join8(skillRoot, pack.name);
   const skillRootRel = skillRoot.replace(projectRoot + sep, "");
   const baseSrc = join8(packSourceDir, "SKILL.md");
@@ -987,7 +987,7 @@ function installPackFiles(pack, packsDir, projectRoot, catalog, platform, manife
       if (!agentEntry) continue;
       const agentSrc = join8(packsDir, agentEntry.file);
       if (!existsSync8(agentSrc)) continue;
-      const agentRel = installAgentForPlatform(platform, projectRoot, agentSrc, agentName);
+      const agentRel = installAgentForPlatform(platform2, projectRoot, agentSrc, agentName);
       recordIfManifest(manifest, agentRel, "pack-agent");
       installed.push(agentRel);
     }
@@ -997,10 +997,10 @@ function installPackFiles(pack, packsDir, projectRoot, catalog, platform, manife
   }
   return installed;
 }
-function installStandaloneFiles(standalone, packsDir, projectRoot, platform, manifest) {
+function installStandaloneFiles(standalone, packsDir, projectRoot, platform2, manifest) {
   const src = join8(packsDir, standalone.file);
   if (!existsSync8(src)) return [];
-  const skillRoot = platformSkillRoot(projectRoot, platform);
+  const skillRoot = platformSkillRoot(projectRoot, platform2);
   const destDir = join8(skillRoot, standalone.name);
   const skillRootRel = skillRoot.replace(projectRoot + sep, "");
   mkdirSync5(destDir, { recursive: true });
@@ -1027,12 +1027,12 @@ function installPack(name, projectRoot, platforms, manifest) {
   const pack = catalog.packs.find((p) => p.name === name);
   const standalone = catalog.standalone.find((s) => s.name === name);
   if (!pack && !standalone) throw new UnknownPackError(name);
-  for (const platform of platforms) recordPlatform(manifest, platform);
+  for (const platform2 of platforms) recordPlatform(manifest, platform2);
   const installed = [];
   const warnings = [];
   if (pack) {
-    for (const platform of platforms) {
-      installed.push(...installPackFiles(pack, packsDir, projectRoot, catalog, platform, manifest));
+    for (const platform2 of platforms) {
+      installed.push(...installPackFiles(pack, packsDir, projectRoot, catalog, platform2, manifest));
     }
     if (pack.crossPackDeps?.length) {
       for (const dep of pack.crossPackDeps) {
@@ -1044,8 +1044,8 @@ function installPack(name, projectRoot, platforms, manifest) {
       }
     }
   } else if (standalone) {
-    for (const platform of platforms) {
-      installed.push(...installStandaloneFiles(standalone, packsDir, projectRoot, platform, manifest));
+    for (const platform2 of platforms) {
+      installed.push(...installStandaloneFiles(standalone, packsDir, projectRoot, platform2, manifest));
     }
   }
   return { installed, warnings };
@@ -1063,19 +1063,19 @@ function safeChildPath(baseDir, child) {
   if (target !== base && !target.startsWith(base + sep)) return null;
   return target;
 }
-function collectSkillFiles(name, projectRoot, platform, manifest, skillDirAbs) {
-  const skillRoot = platformSkillRoot(projectRoot, platform);
+function collectSkillFiles(name, projectRoot, platform2, manifest, skillDirAbs) {
+  const skillRoot = platformSkillRoot(projectRoot, platform2);
   const skillRootRel = skillRoot.replace(projectRoot + sep, "").split("\\").join("/");
   const prefix = `${skillRootRel}/${name}/`;
   const fromManifest = Object.entries(manifest.files).filter(([rel, entry]) => entry.kind === "pack-skill" && rel.startsWith(prefix)).map(([rel]) => rel);
   if (fromManifest.length > 0) return fromManifest;
-  if (!isPackInstalledForPlatform(projectRoot, platform, name)) return [];
+  if (!isPackInstalledForPlatform(projectRoot, platform2, name)) return [];
   const files = [];
   walk(skillDirAbs, "", files);
   return files.map((f) => `${skillRootRel}/${name}/${f}`);
 }
-function agentRelPaths(agentName, platform) {
-  if (platform === "claude") return [`.claude/agents/${agentName}.md`];
+function agentRelPaths(agentName, platform2) {
+  if (platform2 === "claude") return [`.claude/agents/${agentName}.md`];
   return [`.codex/agents/${agentName}.toml`];
 }
 function uninstallPack(name, projectRoot, platforms, manifest) {
@@ -1090,14 +1090,14 @@ function uninstallPack(name, projectRoot, platforms, manifest) {
   const skipped = [];
   const warnings = [];
   const candidates = /* @__PURE__ */ new Set();
-  for (const platform of platforms) {
-    const skillRoot = platformSkillRoot(projectRoot, platform);
+  for (const platform2 of platforms) {
+    const skillRoot = platformSkillRoot(projectRoot, platform2);
     const skillDirAbs = resolveSkillDirToRemove(skillRoot, name);
     if (!skillDirAbs) {
-      warnings.push(`skipped ${platform}: "${name}" is not a valid skill directory`);
+      warnings.push(`skipped ${platform2}: "${name}" is not a valid skill directory`);
       continue;
     }
-    for (const rel of collectSkillFiles(name, projectRoot, platform, manifest, skillDirAbs)) {
+    for (const rel of collectSkillFiles(name, projectRoot, platform2, manifest, skillDirAbs)) {
       candidates.add(rel);
     }
   }
@@ -1109,8 +1109,8 @@ function uninstallPack(name, projectRoot, platforms, manifest) {
       warnings.push(`kept ${agentName} \u2014 still used by ${keptBy.name}`);
       continue;
     }
-    for (const platform of platforms) {
-      for (const rel of agentRelPaths(agentName, platform)) candidates.add(rel);
+    for (const platform2 of platforms) {
+      for (const rel of agentRelPaths(agentName, platform2)) candidates.add(rel);
     }
   }
   for (const rel of candidates) {
@@ -1128,8 +1128,8 @@ function uninstallPack(name, projectRoot, platforms, manifest) {
       warnings.push(`could not delete ${rel}: ${msg}`);
     }
   }
-  for (const platform of platforms) {
-    const skillRoot = platformSkillRoot(projectRoot, platform);
+  for (const platform2 of platforms) {
+    const skillRoot = platformSkillRoot(projectRoot, platform2);
     const skillDirAbs = resolveSkillDirToRemove(skillRoot, name);
     if (skillDirAbs && existsSync8(skillDirAbs)) {
       rmSync(skillDirAbs, { recursive: true, force: true });
@@ -1252,15 +1252,15 @@ ${block}`, "utf-8");
   writeFileSync8(configPath2, merged, "utf-8");
   return { created: false, updated: true };
 }
-function platformLabel(platform) {
-  return platform === "claude" ? "Claude" : "Codex";
+function platformLabel(platform2) {
+  return platform2 === "claude" ? "Claude" : "Codex";
 }
-function platformPrefixed(platform, relPath) {
-  return `${chalk3.dim(`[${platform}]`)} ${relPath}`;
+function platformPrefixed(platform2, relPath) {
+  return `${chalk3.dim(`[${platform2}]`)} ${relPath}`;
 }
 function labelInstalledPath(relPath) {
-  const platform = relPath.startsWith(".agents/") || relPath.startsWith(".codex/") ? "codex" : "claude";
-  return platformPrefixed(platform, relPath);
+  const platform2 = relPath.startsWith(".agents/") || relPath.startsWith(".codex/") ? "codex" : "claude";
+  return platformPrefixed(platform2, relPath);
 }
 function filterBatchDepWarnings(warnings, selectedNames) {
   return warnings.filter((w) => {
@@ -1446,7 +1446,7 @@ function directPackInstall(packNames, projectRoot, platforms, manifest) {
     return;
   }
   const localManifest = manifest ?? getOrCreateManifest(projectRoot);
-  for (const platform of platforms) recordPlatform(localManifest, platform);
+  for (const platform2 of platforms) recordPlatform(localManifest, platform2);
   const { catalog } = loaded;
   const allInstalled = [];
   const warnings = [];
@@ -1483,7 +1483,7 @@ function installSingleSkill(skillName, projectRoot, platforms) {
   }
   const { catalog, packsDir } = loaded;
   const manifest = getOrCreateManifest(projectRoot);
-  for (const platform of platforms) recordPlatform(manifest, platform);
+  for (const platform2 of platforms) recordPlatform(manifest, platform2);
   for (const pack of catalog.packs) {
     const sub = pack.subSkills.find((s) => s.name === skillName);
     if (!sub) continue;
@@ -1494,8 +1494,8 @@ function installSingleSkill(skillName, projectRoot, platforms) {
       return;
     }
     const installed = [];
-    for (const platform of platforms) {
-      const skillRoot = platformSkillRoot(projectRoot, platform);
+    for (const platform2 of platforms) {
+      const skillRoot = platformSkillRoot(projectRoot, platform2);
       const skillDestDir = join9(skillRoot, pack.name);
       const subDest = join9(skillDestDir, sub.file);
       mkdirSync6(dirname6(subDest), { recursive: true });
@@ -1503,7 +1503,7 @@ function installSingleSkill(skillName, projectRoot, platforms) {
       const skillRootRel = skillRoot.replace(projectRoot + "/", "");
       const subRel = `${skillRootRel}/${pack.name}/${sub.file}`;
       recordFile(manifest, subRel, dreamcontextVersion(), "pack-skill");
-      let label = platformPrefixed(platform, subRel);
+      let label = platformPrefixed(platform2, subRel);
       if (sub.hasReferences) {
         const refSrcDir = join9(dirname6(subSrc), "references");
         if (existsSync9(refSrcDir)) {
@@ -1581,7 +1581,7 @@ function listAvailablePacks(projectRoot, platforms) {
     console.log(`  ${chalk3.dim(pack.base)}`);
     for (const sub of pack.subSkills) {
       const subInstalled = platforms.every(
-        (platform) => existsSync9(join9(platformSkillRoot(projectRoot, platform), pack.name, sub.file))
+        (platform2) => existsSync9(join9(platformSkillRoot(projectRoot, platform2), pack.name, sub.file))
       );
       const subStatus = subInstalled ? chalk3.green(" \u2713") : "";
       console.log(`    ${chalk3.dim("\u2022")} ${sub.name}${subStatus} ${chalk3.dim("- " + sub.description)}`);
@@ -1616,65 +1616,65 @@ function printInstallSummary(installed, warnings) {
   ], { color: "green" }));
   console.log();
 }
-async function installCoreForPlatform(platform, projectRoot, manifest) {
+async function installCoreForPlatform(platform2, projectRoot, manifest) {
   const installed = [];
   const notes = [];
   const skillSource = findPackageFile("skill", "SKILL.md");
   if (!skillSource) {
     throw new Error("SKILL.md not found in package. Try reinstalling dreamcontext.");
   }
-  if (manifest) recordPlatform(manifest, platform);
-  const skillRoot = platformSkillRoot(projectRoot, platform);
+  if (manifest) recordPlatform(manifest, platform2);
+  const skillRoot = platformSkillRoot(projectRoot, platform2);
   const skillDestDir = join9(skillRoot, "dreamcontext");
   const skillRootRel = skillRoot.replace(projectRoot + "/", "");
   mkdirSync6(skillDestDir, { recursive: true });
   writeFileSync8(join9(skillDestDir, "SKILL.md"), readFileSync9(skillSource, "utf-8"), "utf-8");
   const coreSkillRel = `${skillRootRel}/dreamcontext/SKILL.md`;
   recordIfManifest2(manifest, coreSkillRel, "core");
-  installed.push(platformPrefixed(platform, coreSkillRel));
+  installed.push(platformPrefixed(platform2, coreSkillRel));
   const agentsSourceDir = findPackageDir("agents");
   if (agentsSourceDir) {
     const agentFiles = readdirSync4(agentsSourceDir).filter((f) => f.endsWith(".md"));
     for (const file of agentFiles) {
       const source = join9(agentsSourceDir, file);
-      const agentRel = installAgentForPlatform(platform, projectRoot, source);
+      const agentRel = installAgentForPlatform(platform2, projectRoot, source);
       recordIfManifest2(manifest, agentRel, "agent");
-      installed.push(platformPrefixed(platform, agentRel));
+      installed.push(platformPrefixed(platform2, agentRel));
     }
   }
-  if (platform === "claude") {
+  if (platform2 === "claude") {
     const hookResult = ensureClaudeHooks(projectRoot);
     recordIfManifest2(manifest, ".claude/settings.json", "hook");
     if (hookResult.added.length > 0) {
-      installed.push(platformPrefixed(platform, `.claude/settings.json ${chalk3.dim(`(${hookResult.added.join(" + ")} hooks)`)}`));
+      installed.push(platformPrefixed(platform2, `.claude/settings.json ${chalk3.dim(`(${hookResult.added.join(" + ")} hooks)`)}`));
     }
     if (hookResult.migrated) {
-      notes.push(platformPrefixed(platform, `${chalk3.yellow("\u2191")} ${chalk3.dim("Migrated old snapshot hook -> session-start hook")}`));
+      notes.push(platformPrefixed(platform2, `${chalk3.yellow("\u2191")} ${chalk3.dim("Migrated old snapshot hook -> session-start hook")}`));
     }
     if (hookResult.added.length === 0 && !hookResult.migrated) {
-      notes.push(platformPrefixed(platform, chalk3.dim("Hooks already present \u2014 skipped")));
+      notes.push(platformPrefixed(platform2, chalk3.dim("Hooks already present \u2014 skipped")));
     }
     const disableNativeMemory = readSetupConfig(projectRoot)?.disableNativeMemory ?? true;
     const memoryChanged = applyClaudeAutoMemory(projectRoot, disableNativeMemory);
     if (memoryChanged) {
-      notes.push(platformPrefixed(platform, disableNativeMemory ? chalk3.dim("Disabled Claude native auto-memory (autoMemoryEnabled:false) \u2014 dreamcontext owns memory") : chalk3.dim("Enabled Claude native auto-memory (autoMemoryEnabled:true) per config")));
+      notes.push(platformPrefixed(platform2, disableNativeMemory ? chalk3.dim("Disabled Claude native auto-memory (autoMemoryEnabled:false) \u2014 dreamcontext owns memory") : chalk3.dim("Enabled Claude native auto-memory (autoMemoryEnabled:true) per config")));
     }
   } else {
     const codexResult = ensureCodexConfig(projectRoot);
     recordIfManifest2(manifest, ".codex/config.toml", "hook");
     if (codexResult.updated) {
-      installed.push(platformPrefixed(platform, ".codex/config.toml (managed hooks block)"));
+      installed.push(platformPrefixed(platform2, ".codex/config.toml (managed hooks block)"));
     }
     try {
       const result = await installInstructions(projectRoot, "codex", "append");
       if (result.action !== "skipped") {
-        notes.push(platformPrefixed(platform, `Root guidance synced: ${result.target}`));
+        notes.push(platformPrefixed(platform2, `Root guidance synced: ${result.target}`));
       }
     } catch (e) {
       const msg = e instanceof Error ? e.message : String(e);
-      notes.push(platformPrefixed(platform, `${chalk3.yellow("\u26A0")} AGENTS.md install skipped: ${msg}`));
+      notes.push(platformPrefixed(platform2, `${chalk3.yellow("\u26A0")} AGENTS.md install skipped: ${msg}`));
     }
-    notes.push(platformPrefixed(platform, chalk3.dim("Codex gap: SubagentStart + PreCompact hooks are Claude-only.")));
+    notes.push(platformPrefixed(platform2, chalk3.dim("Codex gap: SubagentStart + PreCompact hooks are Claude-only.")));
   }
   return { installed, notes };
 }
@@ -1715,8 +1715,8 @@ function registerInstallSkillCommand(program) {
       const manifest = getOrCreateManifest(projectRoot);
       const installed = [];
       const notes = [];
-      for (const platform of platforms) {
-        const result = await installCoreForPlatform(platform, projectRoot, manifest);
+      for (const platform2 of platforms) {
+        const result = await installCoreForPlatform(platform2, projectRoot, manifest);
         installed.push(...result.installed);
         notes.push(...result.notes);
       }
@@ -1843,8 +1843,8 @@ async function installPlatformIntegration(projectRoot, opts) {
   for (const p of platforms) recordPlatform(manifest, p);
   const installed = [];
   const notes = [];
-  for (const platform of platforms) {
-    const result = await installCoreForPlatform(platform, projectRoot, manifest);
+  for (const platform2 of platforms) {
+    const result = await installCoreForPlatform(platform2, projectRoot, manifest);
     installed.push(...result.installed);
     notes.push(...result.notes);
   }
@@ -1853,12 +1853,12 @@ async function installPlatformIntegration(projectRoot, opts) {
     directPackInstall(packs, projectRoot, platforms, manifest);
   }
   info("Installing root instruction file(s)...");
-  for (const platform of platforms) {
+  for (const platform2 of platforms) {
     try {
-      await installInstructions(projectRoot, platform, "append");
+      await installInstructions(projectRoot, platform2, "append");
     } catch (e) {
       const msg = e instanceof Error ? e.message : String(e);
-      info(`${platform} root instructions skipped: ${msg}`);
+      info(`${platform2} root instructions skipped: ${msg}`);
     }
   }
   writeManifest(projectRoot, manifest);
@@ -2804,30 +2804,30 @@ function registerCoreCommand(program) {
   releases.command("show").argument("<version>", "Release version to show").description("Show details of a specific release").action((version) => {
     const root = ensureContextRoot();
     const allReleases = getExistingReleases(root);
-    const release = allReleases.find((r) => r.version === version);
-    if (!release) {
+    const release2 = allReleases.find((r) => r.version === version);
+    if (!release2) {
       error(`Release not found: ${version}`);
       return;
     }
-    console.log(header(`Release ${release.version}`));
-    console.log(`  Date:     ${release.date}`);
-    console.log(`  Summary:  ${release.summary}`);
-    console.log(`  Breaking: ${release.breaking ? "Yes" : "No"}`);
-    console.log(`  ID:       ${release.id}`);
-    if (release.tasks.length > 0) {
+    console.log(header(`Release ${release2.version}`));
+    console.log(`  Date:     ${release2.date}`);
+    console.log(`  Summary:  ${release2.summary}`);
+    console.log(`  Breaking: ${release2.breaking ? "Yes" : "No"}`);
+    console.log(`  ID:       ${release2.id}`);
+    if (release2.tasks.length > 0) {
       console.log(`
-  Tasks (${release.tasks.length}):`);
-      for (const id of release.tasks) console.log(`    - ${id}`);
+  Tasks (${release2.tasks.length}):`);
+      for (const id of release2.tasks) console.log(`    - ${id}`);
     }
-    if (release.features.length > 0) {
+    if (release2.features.length > 0) {
       console.log(`
-  Features (${release.features.length}):`);
-      for (const id of release.features) console.log(`    - ${id}`);
+  Features (${release2.features.length}):`);
+      for (const id of release2.features) console.log(`    - ${id}`);
     }
-    if (release.changelog.length > 0) {
+    if (release2.changelog.length > 0) {
       console.log(`
-  Changelog (${release.changelog.length}):`);
-      for (const e of release.changelog) {
+  Changelog (${release2.changelog.length}):`);
+      for (const e of release2.changelog) {
         console.log(`    - ${e.date} [${e.type}] ${e.scope}: ${e.description.slice(0, 80)}`);
       }
     }
@@ -2885,10 +2885,10 @@ function readSection(filePath, sectionName) {
   const raw = readFileSync12(filePath, "utf-8");
   const parsed = matter3(raw);
   const sections = parseSections(parsed.content);
-  const section = findSection(sections, sectionName);
-  if (!section) return null;
+  const section2 = findSection(sections, sectionName);
+  if (!section2) return null;
   const lines = parsed.content.split("\n");
-  const bodyLines = lines.slice(section.startLine + 1, section.endLine + 1);
+  const bodyLines = lines.slice(section2.startLine + 1, section2.endLine + 1);
   return bodyLines.join("\n").trim();
 }
 function isPlaceholderLine(line) {
@@ -2907,9 +2907,9 @@ function formatListItems(content, checkbox6) {
     return checkbox6 ? `- [ ] ${t}` : `- ${t}`;
   }).join("\n");
 }
-function stripPlaceholderBody(lines, section) {
-  const start = section.startLine + 1;
-  const end = section.endLine;
+function stripPlaceholderBody(lines, section2) {
+  const start = section2.startLine + 1;
+  const end = section2.endLine;
   const meaningful = [];
   for (let i = start; i <= end; i++) {
     const t = lines[i]?.trim() ?? "";
@@ -2941,29 +2941,29 @@ function insertToSection(filePath, sectionName, newContent, position = "top", cr
   const raw = readFileSync12(filePath, "utf-8");
   const parsed = matter3(raw);
   let lines = parsed.content.split("\n");
-  let section = findSection(parseSections(lines.join("\n")), sectionName);
-  if (!section) {
+  let section2 = findSection(parseSections(lines.join("\n")), sectionName);
+  if (!section2) {
     if (createIfMissing) {
       lines.push("", `## ${sectionName}`);
-      section = findSection(parseSections(lines.join("\n")), sectionName);
+      section2 = findSection(parseSections(lines.join("\n")), sectionName);
     } else {
       throw new Error(`Section "${sectionName}" not found in ${filePath}`);
     }
   }
-  if (replacePlaceholders && section && stripPlaceholderBody(lines, section) > 0) {
-    section = findSection(parseSections(lines.join("\n")), sectionName);
+  if (replacePlaceholders && section2 && stripPlaceholderBody(lines, section2) > 0) {
+    section2 = findSection(parseSections(lines.join("\n")), sectionName);
   }
-  if (!section) throw new Error(`Section "${sectionName}" not found in ${filePath}`);
+  if (!section2) throw new Error(`Section "${sectionName}" not found in ${filePath}`);
   const contentLines = newContent.split("\n");
   if (position === "top") {
-    let insertAt = section.startLine + 1;
-    while (insertAt <= section.endLine && (lines[insertAt]?.trim().startsWith("<!--") || lines[insertAt]?.trim() === "")) {
+    let insertAt = section2.startLine + 1;
+    while (insertAt <= section2.endLine && (lines[insertAt]?.trim().startsWith("<!--") || lines[insertAt]?.trim() === "")) {
       insertAt++;
     }
     lines.splice(insertAt, 0, "", ...contentLines);
   } else {
-    let last = section.endLine;
-    while (last > section.startLine && (lines[last]?.trim() ?? "") === "") last--;
+    let last = section2.endLine;
+    while (last > section2.startLine && (lines[last]?.trim() ?? "") === "") last--;
     const insertAt = last + 1;
     const block = ["", ...contentLines];
     if (lines[insertAt] !== void 0 && lines[insertAt].trim() !== "") block.push("");
@@ -3311,15 +3311,15 @@ function registerFeaturesCommand(program) {
   features.command("insert").argument("<name>").argument(
     "<section>",
     "Section: changelog, notes, technical_details, constraints, user_stories, acceptance_criteria"
-  ).argument("[content...]", "Content to insert").description("Insert content into a feature section").action(async (name, section, contentParts) => {
+  ).argument("[content...]", "Content to insert").description("Insert content into a feature section").action(async (name, section2, contentParts) => {
     const file = findFeatureFile(name);
     if (!file) {
       error(`Feature not found: ${name}`);
       return;
     }
-    const sectionKey = section.toLowerCase();
+    const sectionKey = section2.toLowerCase();
     if (!SECTION_MAP[sectionKey]) {
-      error(`Unknown section: "${section}". Valid sections: ${Object.keys(SECTION_MAP).join(", ")}`);
+      error(`Unknown section: "${section2}". Valid sections: ${Object.keys(SECTION_MAP).join(", ")}`);
       return;
     }
     const rawContent = contentParts.length > 0 ? contentParts.join(" ") : await promptInput({ message: `Content for ${SECTION_MAP[sectionKey]}:` });
@@ -4526,15 +4526,15 @@ function registerTasksCommand(program) {
   tasks.command("insert").argument("<name>").argument(
     "<section>",
     "Section: why, user_stories, acceptance_criteria, constraints, technical_details, notes, changelog"
-  ).argument("[content...]", "Content to insert").description("Insert content into a task section").action(async (name, section, contentParts) => {
+  ).argument("[content...]", "Content to insert").description("Insert content into a task section").action(async (name, section2, contentParts) => {
     const file = findTaskFile(name);
     if (!file) {
       error(`Task not found: ${name}`);
       return;
     }
-    const sectionKey = section.toLowerCase();
+    const sectionKey = section2.toLowerCase();
     if (!SECTION_MAP[sectionKey]) {
-      error(`Unknown section: "${section}". Valid sections: ${Object.keys(SECTION_MAP).join(", ")}`);
+      error(`Unknown section: "${section2}". Valid sections: ${Object.keys(SECTION_MAP).join(", ")}`);
       return;
     }
     const rawContent = contentParts.length > 0 ? contentParts.join(" ") : await promptInput({ message: `Content for ${SECTION_MAP[sectionKey]}:` });
@@ -4736,8 +4736,8 @@ function detectInstalledPacks(projectRoot, platforms) {
     ...loaded.catalog.standalone.map((s) => s.name)
   ]);
   const found = /* @__PURE__ */ new Set();
-  for (const platform of platforms) {
-    const root = platformSkillRoot(projectRoot, platform);
+  for (const platform2 of platforms) {
+    const root = platformSkillRoot(projectRoot, platform2);
     if (!existsSync21(root)) continue;
     for (const name of readdirSync6(root)) {
       if (name === "dreamcontext") continue;
@@ -4844,8 +4844,8 @@ function registerUpdateCommand(program) {
       const installed = [];
       const notes = [];
       if (!opts.packsOnly) {
-        for (const platform of platforms) {
-          const result = await installCoreForPlatform(platform, projectRoot, newManifest);
+        for (const platform2 of platforms) {
+          const result = await installCoreForPlatform(platform2, projectRoot, newManifest);
           installed.push(...result.installed);
           notes.push(...result.notes);
         }
@@ -5131,7 +5131,7 @@ function acquireLock() {
   } finally {
     closeSync(fd);
   }
-  return function release() {
+  return function release2() {
     try {
       const heldRaw = readFileSync15(lockPath, "utf8").trim();
       if (Number.parseInt(heldRaw, 10) === process.pid) {
@@ -5142,8 +5142,8 @@ function acquireLock() {
   };
 }
 function withLock(fn) {
-  const release = acquireLock();
-  return Promise.resolve().then(() => fn()).finally(() => release());
+  const release2 = acquireLock();
+  return Promise.resolve().then(() => fn()).finally(() => release2());
 }
 function isoTs() {
   return (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
@@ -5709,6 +5709,110 @@ var init_version_check = __esm({
   }
 });
 
+// src/lib/snapshot-budget.ts
+function estimateTokens(s) {
+  return Math.ceil(s.length / 4);
+}
+function resolveBudget(env) {
+  if (env === void 0 || env.trim() === "") return DEFAULT_SNAPSHOT_BUDGET_TOKENS;
+  const v = env.trim().toLowerCase();
+  if (v === "0" || v === "off" || v === "false") return null;
+  const n = Number.parseInt(v, 10);
+  if (Number.isNaN(n)) return DEFAULT_SNAPSHOT_BUDGET_TOKENS;
+  return Math.max(2e3, n);
+}
+function applyBudget(sections, budgetTokens) {
+  const render = (levels2) => sections.map((s) => {
+    const lvl = levels2.get(s.id) ?? 0;
+    const text2 = lvl === 0 ? s.text : s.demotions[lvl - 1];
+    return text2;
+  }).filter((t) => t.trim() !== "").join("\n");
+  const levels = /* @__PURE__ */ new Map();
+  let text = render(levels);
+  if (budgetTokens === null || estimateTokens(text) <= budgetTokens) {
+    return { text, demoted: [], estimatedTokens: estimateTokens(text), overBudget: false };
+  }
+  const maxLevels = Math.max(0, ...sections.map((s) => s.demotions?.length ?? 0));
+  outer:
+    for (let level = 1; level <= maxLevels; level++) {
+      for (const s of sections) {
+        if (s.neverEvict) continue;
+        if (!s.demotions || s.demotions.length < level) continue;
+        levels.set(s.id, level);
+        text = render(levels);
+        if (estimateTokens(text) <= budgetTokens) break outer;
+      }
+    }
+  const demoted = [...levels.entries()].map(([id, level]) => ({ id, level }));
+  if (demoted.length > 0) {
+    const ids = demoted.map((d) => d.id).join(", ");
+    text += [
+      "\n\n---",
+      `_Budget note: sections demoted to fit the snapshot budget (${ids}).`,
+      "Nothing is lost \u2014 every demoted item keeps its file path above, and",
+      '`dreamcontext memory recall "<keywords>"` surfaces the full content on demand._'
+    ].join("\n");
+  }
+  const finalTokens = estimateTokens(text);
+  return {
+    text,
+    demoted,
+    estimatedTokens: finalTokens,
+    overBudget: finalTokens > budgetTokens
+  };
+}
+function demoteMemoryBlock(block, keep) {
+  const marker = /^## Technical Decisions\s*$/m;
+  const m = marker.exec(block);
+  if (!m) return block;
+  const start = m.index + m[0].length;
+  const nextH2 = block.slice(start).search(/^## /m);
+  const end = nextH2 === -1 ? block.length : start + nextH2;
+  const section2 = block.slice(start, end);
+  const lines = section2.split("\n");
+  const preamble = [];
+  const bullets = [];
+  for (const line of lines) {
+    if (/^- /.test(line)) bullets.push([line]);
+    else if (bullets.length === 0) preamble.push(line);
+    else bullets[bullets.length - 1].push(line);
+  }
+  if (bullets.length <= keep) return block;
+  const kept = bullets.slice(0, keep).map((b) => b.join("\n"));
+  const titleOf = (b) => {
+    const head = b[0];
+    const bold = /^- \*\*(.+?)\*\*/.exec(head);
+    if (bold) return bold[1];
+    const plain = head.replace(/^- /, "");
+    return plain.length > 90 ? plain.slice(0, 87) + "..." : plain;
+  };
+  const titles = bullets.slice(keep).map((b) => `- ${titleOf(b)}`);
+  const rebuilt = [
+    ...preamble,
+    ...kept,
+    "",
+    `### Older decisions (${titles.length} \u2014 titles only, \`dreamcontext memory recall\` for detail):`,
+    ...titles,
+    ""
+  ].join("\n");
+  return block.slice(0, start) + "\n" + rebuilt.replace(/^\n+/, "") + block.slice(end);
+}
+function demoteTaskList(entries, keep) {
+  if (entries.length <= keep) return entries;
+  const rest = entries.length - keep;
+  return [
+    ...entries.slice(0, keep),
+    `- (+${rest} more active task(s) \u2014 \`dreamcontext tasks list\` or memory recall)`
+  ];
+}
+var DEFAULT_SNAPSHOT_BUDGET_TOKENS;
+var init_snapshot_budget = __esm({
+  "src/lib/snapshot-budget.ts"() {
+    "use strict";
+    DEFAULT_SNAPSHOT_BUDGET_TOKENS = 1e4;
+  }
+});
+
 // src/cli/commands/snapshot.ts
 import { readFileSync as readFileSync20, existsSync as existsSync28, statSync as statSync3 } from "fs";
 import { join as join27, basename as basename9, dirname as dirname11 } from "path";
@@ -5740,11 +5844,16 @@ function extractFirstParagraph(content) {
   const result = paragraphLines.join(" ");
   return result.length > 300 ? result.slice(0, 297) + "..." : result;
 }
-function getActiveTaskLines(root) {
+function sortTaskEntriesByActivity(entries) {
+  const statusRank = (s) => s === "in_progress" ? 0 : s === "blocked" ? 1 : 2;
+  const prioRank = (p) => p === "critical" ? 0 : p === "high" ? 1 : p === "medium" ? 2 : 3;
+  return [...entries].sort((a, b) => statusRank(a.status) - statusRank(b.status) || prioRank(a.priority) - prioRank(b.priority) || b.updated.localeCompare(a.updated));
+}
+function getActiveTaskEntries(root) {
   const stateDir = join27(root, "state");
   if (!existsSync28(stateDir)) return [];
   const taskFiles = fg8.sync("*.md", { cwd: stateDir, absolute: true });
-  const lines = [];
+  const entries = [];
   for (const file of taskFiles) {
     try {
       const { data } = readFrontmatter(file);
@@ -5767,11 +5876,11 @@ function getActiveTaskLines(root) {
         }
       } catch {
       }
-      lines.push(line);
+      entries.push({ text: line, status, priority, updated });
     } catch {
     }
   }
-  return lines;
+  return entries;
 }
 function resolveActiveTaskPath(root) {
   const stateDir = join27(root, "state");
@@ -5879,7 +5988,14 @@ function getVersionNudge(root) {
 function generateSnapshot() {
   const root = resolveContextRoot();
   if (!root) return "";
-  const parts = ["# Agent Context \u2014 Auto-loaded\n"];
+  const sections = [];
+  let parts = ["# Agent Context \u2014 Auto-loaded\n"];
+  const flush = (id, opts = {}) => {
+    if (parts.length > 0) {
+      sections.push({ id, text: parts.join("\n"), ...opts });
+      parts = [];
+    }
+  };
   const soulPath = join27(root, "core", "0.soul.md");
   if (existsSync28(soulPath)) {
     const content = readFileSync20(soulPath, "utf-8").trim();
@@ -5894,6 +6010,7 @@ function generateSnapshot() {
     parts.push(content);
     parts.push("");
   }
+  flush("identity", { neverEvict: true });
   const memoryPath = join27(root, "core", "2.memory.md");
   if (existsSync28(memoryPath)) {
     const content = readFileSync20(memoryPath, "utf-8").trim();
@@ -5901,6 +6018,8 @@ function generateSnapshot() {
       parts.push("## Memory (Technical Decisions, Known Issues, Session Log)\n");
       parts.push(content);
       parts.push("");
+      const full = parts.join("\n");
+      flush("memory", { demotions: [demoteMemoryBlock(full, 8), demoteMemoryBlock(full, 4)] });
     }
   }
   const coreExtras = buildCoreIndex(root);
@@ -5915,11 +6034,15 @@ function generateSnapshot() {
     }
     parts.push("");
   }
-  const activeTasks = getActiveTaskLines(root);
+  flush("extended-core", { neverEvict: true });
+  const activeTasks = getActiveTaskEntries(root);
   if (activeTasks.length > 0) {
     parts.push("## Active Tasks\n");
-    parts.push(activeTasks.join("\n"));
+    parts.push(activeTasks.map((t) => t.text).join("\n"));
     parts.push("");
+    const sortedTexts = sortTaskEntriesByActivity(activeTasks).map((t) => t.text);
+    const renderTasks = (keep) => ["## Active Tasks\n", demoteTaskList(sortedTexts, keep).join("\n"), ""].join("\n");
+    flush("tasks", { demotions: [renderTasks(12), renderTasks(8)] });
   }
   const productKnowledge = getActiveProductKnowledge(root);
   if (productKnowledge.length > 0) {
@@ -5930,6 +6053,7 @@ function generateSnapshot() {
     parts.push(versionNudge);
     parts.push("");
   }
+  flush("product-and-nudge", { neverEvict: true });
   const sleepState = readSleepState(root);
   if (sleepState.bookmarks.length > 0) {
     const sorted = [...sleepState.bookmarks].sort((a, b) => b.salience - a.salience);
@@ -5976,6 +6100,7 @@ function generateSnapshot() {
       writeSleepState(root, sleepState);
     }
   }
+  flush("awareness", { neverEvict: true });
   const CHANGELOG_TIER1 = 3;
   const CHANGELOG_TIER2 = 10;
   const TIER1_BODY_CHARS = 300;
@@ -5992,36 +6117,53 @@ function generateSnapshot() {
       const entries = readJsonArray(changelogPath);
       const tier1 = entries.slice(0, CHANGELOG_TIER1);
       const tier2 = entries.slice(CHANGELOG_TIER1, CHANGELOG_TIER1 + CHANGELOG_TIER2);
-      if (tier1.length > 0) {
-        parts.push("## Recent Changelog\n");
+      const headlineOf = (e) => {
+        const date = String(e.date ?? "");
+        const type = String(e.type ?? "");
+        const scope = String(e.scope ?? "");
+        const summary = typeof e.summary === "string" ? e.summary : "";
+        const desc = String(e.description ?? "");
+        const headline = summary || (desc.length > 200 ? desc.slice(0, 197) + "..." : desc);
+        return `- ${date} [${type}] ${scope}: ${headline}${authorSuffix(e)}`;
+      };
+      const tier2LineOf = (e) => {
+        const date = String(e.date ?? "");
+        const type = String(e.type ?? "");
+        const scope = String(e.scope ?? "");
+        const summary = typeof e.summary === "string" ? e.summary : "";
+        const desc = String(e.description ?? "");
+        const raw = summary || desc;
+        const line = raw.length > TIER2_LINE_CHARS ? raw.slice(0, TIER2_LINE_CHARS - 3) + "..." : raw;
+        return `- ${date} [${type}] ${scope}: ${line}${authorSuffix(e)}`;
+      };
+      const renderChangelog = (withBodies, tier2Count) => {
+        const out = ["## Recent Changelog\n"];
         for (const e of tier1) {
-          const date = String(e.date ?? "");
-          const type = String(e.type ?? "");
-          const scope = String(e.scope ?? "");
+          out.push(headlineOf(e));
           const summary = typeof e.summary === "string" ? e.summary : "";
           const desc = String(e.description ?? "");
-          const headline = summary || (desc.length > 200 ? desc.slice(0, 197) + "..." : desc);
-          parts.push(`- ${date} [${type}] ${scope}: ${headline}${authorSuffix(e)}`);
-          if (summary && desc && desc !== summary) {
+          if (withBodies && summary && desc && desc !== summary) {
             const body = desc.length > TIER1_BODY_CHARS ? desc.slice(0, TIER1_BODY_CHARS - 3) + "..." : desc;
-            parts.push(`    ${body}`);
+            out.push(`    ${body}`);
           }
         }
-        if (tier2.length > 0) {
-          parts.push("");
-          parts.push("### Older (titles only \u2014 use `dreamcontext memory recall --types changelog` for detail):");
-          for (const e of tier2) {
-            const date = String(e.date ?? "");
-            const type = String(e.type ?? "");
-            const scope = String(e.scope ?? "");
-            const summary = typeof e.summary === "string" ? e.summary : "";
-            const desc = String(e.description ?? "");
-            const raw = summary || desc;
-            const line = raw.length > TIER2_LINE_CHARS ? raw.slice(0, TIER2_LINE_CHARS - 3) + "..." : raw;
-            parts.push(`- ${date} [${type}] ${scope}: ${line}${authorSuffix(e)}`);
-          }
+        const t2 = tier2.slice(0, tier2Count);
+        if (t2.length > 0) {
+          out.push("");
+          out.push("### Older (titles only \u2014 use `dreamcontext memory recall --types changelog` for detail):");
+          for (const e of t2) out.push(tier2LineOf(e));
         }
-        parts.push("");
+        out.push("");
+        return out;
+      };
+      if (tier1.length > 0) {
+        parts.push(...renderChangelog(true, CHANGELOG_TIER2));
+        flush("changelog", {
+          demotions: [
+            renderChangelog(false, 5).join("\n"),
+            renderChangelog(false, 0).join("\n")
+          ]
+        });
       }
     } catch {
     }
@@ -6062,10 +6204,12 @@ function generateSnapshot() {
     } catch {
     }
   }
+  flush("releases", { neverEvict: true });
   const featuresDir = join27(root, "core", "features");
   if (existsSync28(featuresDir)) {
     const featureFiles = fg8.sync("*.md", { cwd: featuresDir, absolute: true });
     const features = [];
+    const featureMeta = [];
     for (const file of featureFiles) {
       try {
         const { data } = readFrontmatter(file);
@@ -6119,6 +6263,12 @@ function generateSnapshot() {
           featureLine += "\n" + details.join("\n");
         }
         features.push(featureLine);
+        featureMeta.push({
+          detail: featureLine,
+          nameLine: `- **${name}** (status: ${status}) -> _dream_context/core/features/${name}.md`,
+          status,
+          updated: String(data.updated ?? data.created ?? "")
+        });
       } catch {
       }
     }
@@ -6126,11 +6276,21 @@ function generateSnapshot() {
       parts.push("## Features\n");
       parts.push(features.join("\n"));
       parts.push("");
+      const activeFirst = [...featureMeta].sort((a, b) => {
+        const rank = (s) => s === "in_progress" || s === "active" ? 0 : s === "planned" || s === "todo" ? 1 : 2;
+        return rank(a.status) - rank(b.status) || b.updated.localeCompare(a.updated);
+      });
+      const renderFeatures = (detailCount) => {
+        const lines = activeFirst.map((f, i) => i < detailCount ? f.detail : f.nameLine);
+        return ["## Features\n", lines.join("\n"), ""].join("\n");
+      };
+      flush("features", { demotions: [renderFeatures(8), renderFeatures(0)] });
     }
   }
   const knowledgeEntries = buildKnowledgeIndex(root);
   if (knowledgeEntries.length > 0) {
     const indexLines = [];
+    const compactLines = [];
     const pinnedEntries = [];
     const warmEntries = [];
     const activeTaskTags = [];
@@ -6164,6 +6324,7 @@ function generateSnapshot() {
         }
       }
       indexLines.push(`- **${entry.slug}** (_dream_context/knowledge/${entry.slug}.md): ${entry.description}${tagsStr}${stalenessNote}`);
+      compactLines.push(`- **${entry.slug}**${tagsStr}${stalenessNote ? " (stale)" : ""}`);
       if (entry.pinned) {
         pinnedEntries.push(entry);
       } else if (!stalenessNote) {
@@ -6190,17 +6351,48 @@ function generateSnapshot() {
       parts.push(nonPinnedLines.join("\n"));
     }
     parts.push("");
-    if (warmEntries.length > 0) {
-      parts.push("## Warm Knowledge (Recently Relevant)\n");
-      for (const entry of warmEntries) {
-        parts.push(`### ${entry.name}`);
-        const firstParagraph = extractFirstParagraph(entry.content);
-        if (firstParagraph) {
-          parts.push(firstParagraph);
+    {
+      const compactNonPinned = compactLines.filter((_, i) => !pinnedSlugs.has(knowledgeEntries[i]?.slug));
+      const compact = ["## Knowledge Index\n"];
+      if (pinnedEntries.length > 0) {
+        compact.push("> !!! \xC7OK \xD6NEML\u0130 !!! Kullan\u0131c\u0131 bu bilgiyi pinlemi\u015F \u2014 yapaca\u011F\u0131n bir i\u015Fle ili\u015Fkisi varsa MUTLAKA OKU!\n");
+        for (const entry of pinnedEntries) {
+          const tagsStr = entry.tags.length > 0 ? ` [${entry.tags.join(", ")}]` : "";
+          compact.push(`- \u{1F4CC} **${entry.slug}** (_dream_context/knowledge/${entry.slug}.md): ${entry.description}${tagsStr}`);
         }
-        parts.push(`-> Read full: _dream_context/knowledge/${entry.slug}.md`);
-        parts.push("");
+        compact.push("");
+        compact.push("### Other knowledge:\n");
       }
+      compact.push("(slugs only \u2014 files at _dream_context/knowledge/<slug>.md; descriptions via `dreamcontext knowledge index` or memory recall)");
+      compact.push(compactNonPinned.join("\n"));
+      compact.push("");
+      flush("knowledge-index", { demotions: [compact.join("\n")] });
+    }
+    if (warmEntries.length > 0) {
+      const renderWarm = (cap) => {
+        const out = ["## Warm Knowledge (Recently Relevant)\n"];
+        for (const entry of warmEntries.slice(0, cap)) {
+          out.push(`### ${entry.name}`);
+          const firstParagraph = extractFirstParagraph(entry.content);
+          if (firstParagraph) {
+            out.push(firstParagraph);
+          }
+          out.push(`-> Read full: _dream_context/knowledge/${entry.slug}.md`);
+          out.push("");
+        }
+        if (warmEntries.length > cap) {
+          out.push(`(+${warmEntries.length - cap} more warm file(s) \u2014 listed in the Knowledge Index above)`);
+          out.push("");
+        }
+        return out;
+      };
+      parts.push(...renderWarm(warmEntries.length));
+      flush("warm-knowledge", {
+        demotions: [
+          renderWarm(4).join("\n"),
+          "(Warm knowledge omitted for budget \u2014 the Knowledge Index above lists every file; recall surfaces them on demand.)\n"
+        ]
+      });
     }
   }
   try {
@@ -6211,7 +6403,9 @@ function generateSnapshot() {
     }
   } catch {
   }
-  return parts.join("\n").trim();
+  flush("marketing", { neverEvict: true });
+  const budget = resolveBudget(process.env.DREAMCONTEXT_SNAPSHOT_BUDGET);
+  return applyBudget(sections, budget).text.trim();
 }
 function generateSubagentBriefing() {
   const root = resolveContextRoot();
@@ -6339,10 +6533,10 @@ function generateSubagentBriefing() {
       parts.push("");
     }
   }
-  const activeTasks = getActiveTaskLines(root);
+  const activeTasks = sortTaskEntriesByActivity(getActiveTaskEntries(root)).map((t) => t.text);
   if (activeTasks.length > 0) {
     parts.push("## Active Tasks\n");
-    parts.push(activeTasks.join("\n"));
+    parts.push(demoteTaskList(activeTasks, 12).join("\n"));
     parts.push("");
   }
   parts.push("## Task Awareness\n");
@@ -6389,6 +6583,7 @@ var init_snapshot2 = __esm({
     init_version_check();
     init_manifest();
     init_feature_freshness();
+    init_snapshot_budget();
   }
 });
 
@@ -6648,9 +6843,20 @@ function expandQueryTerms(queryTerms, stem) {
       }
     }
   }
+  for (const [surfaceKey, targets] of Object.entries(DIRECTED_BRIDGES)) {
+    const stemmedKey = stem(surfaceKey);
+    if (!primary.has(stemmedKey)) continue;
+    for (const target of targets) {
+      const stemmedTarget = stem(target);
+      if (primary.has(stemmedTarget)) continue;
+      if (!expansions.has(stemmedTarget)) {
+        expansions.set(stemmedTarget, SYNONYM_WEIGHT);
+      }
+    }
+  }
   return expansions;
 }
-var SYNONYM_GROUPS, SYNONYMS, SYNONYM_WEIGHT;
+var SYNONYM_GROUPS, DIRECTED_BRIDGES, SYNONYMS, SYNONYM_WEIGHT;
 var init_recall_synonyms = __esm({
   "src/lib/recall-synonyms.ts"() {
     "use strict";
@@ -6669,6 +6875,9 @@ var init_recall_synonyms = __esm({
       ["hook", "hooks"],
       // Memory / remember (core project concept) + TR (hafıza / bellek / beyin)
       ["memory", "remember", "recollection", "haf\u0131za", "bellek", "beyin", "beynini"],
+      // Context (the product's core noun) + TR (bağlam). Bridges natural-TR queries
+      // ("bağlama enjekte eden şey") to the `context-*` doc family.
+      ["context", "ba\u011Flam", "ba\u011Flama", "ba\u011Flam\u0131"],
       // Vector / embeddings / semantic (the path NOT taken — mem0 decision)
       ["vector", "embedding", "embeddings", "semantic"],
       // Keyword / bm25 (the path taken)
@@ -6694,6 +6903,32 @@ var init_recall_synonyms = __esm({
       // Debt / borç (sleep debt)
       ["debt", "bor\xE7"]
     ];
+    DIRECTED_BRIDGES = {
+      // This corpus's own verbs for consolidation ("folds what changed back",
+      // "promotes learnings") — paraphrase queries use them, docs say "consolidate".
+      // All three consolidat* inflection stems listed so the bridge reaches every
+      // form the docs use (consolidation / consolidate / consolidating→consolidat).
+      fold: ["consolidation", "consolidate", "consolidating", "sleep"],
+      promote: ["consolidation", "consolidate", "consolidating", "sleep"],
+      // Brain-as-memory phrasing ("the project's brain") → the memory doc family.
+      brain: ["memory"],
+      // "project folder" / TR klasör/dizin → the vault/registry concept.
+      // `dizini` (accusative) is listed as its own surface form — the conservative
+      // stemmer deliberately does not strip bare-n-buffer accusatives.
+      folder: ["vault", "registry", "multivault"],
+      klas\u00F6r: ["vault", "registry", "multivault"],
+      dizin: ["vault", "registry", "multivault"],
+      dizini: ["vault", "registry", "multivault"],
+      // TR release/publish vocabulary → the npm-shipping doc family.
+      s\u00FCr\u00FCm: ["release", "version", "publish"],
+      yay\u0131n: ["publish", "release"],
+      ad\u0131m: ["step"],
+      // TR sleep-debt phrasing: seviye(level) / eşik(threshold).
+      seviye: ["level"],
+      e\u015Fik: ["threshold"],
+      // TR "oturum başında" (at session start) — `baş` (start/head) → start.
+      ba\u015F: ["start"]
+    };
     SYNONYMS = (() => {
       const map = /* @__PURE__ */ new Map();
       for (const group of SYNONYM_GROUPS) {
@@ -6722,11 +6957,12 @@ function stemEn(token) {
   if (token.length <= 4) return token;
   if (token.endsWith("ing") && token.length > 5) return token.slice(0, -3);
   if (token.endsWith("ed") && token.length > 4) return token.slice(0, -2);
-  if (token.endsWith("es") && token.length > 4) return token.slice(0, -2);
-  if (token.endsWith("s") && !token.endsWith("ss") && token.length > 4) return token.slice(0, -1);
-  return token;
+  let t = token;
+  if (t.endsWith("s") && !t.endsWith("ss") && t.length > 4) t = t.slice(0, -1);
+  if (t.endsWith("e") && t.length > 5) t = t.slice(0, -1);
+  return t;
 }
-function stemTr(token) {
+function stemTrOnce(token) {
   if (token.length <= 4) return token;
   for (const suf of TR_SUFFIXES) {
     if (token.length - suf.length > 2 && token.endsWith(suf)) {
@@ -6735,8 +6971,15 @@ function stemTr(token) {
   }
   return token;
 }
+function stemTr(token) {
+  const once = stemTrOnce(token);
+  if (once === token) return token;
+  return stemTrOnce(once);
+}
 function stemToken(token) {
-  return stemTr(stemEn(token));
+  const t = stemTr(stemEn(token));
+  if (t !== token && t.endsWith("e") && t.length > 5) return t.slice(0, -1);
+  return t;
 }
 function tokenize(text) {
   return text.toLowerCase().replace(/[^a-z0-9çğıöşü_\-\s]/g, " ").split(/[\s_\-]+/).filter((t) => t.length > 1 && !STOPWORDS.has(t)).map(stemToken).filter((t) => t.length > 1 && !STOPWORDS.has(t));
@@ -7098,7 +7341,7 @@ function bm25Search(query, corpus, topK = 5, opts = {}) {
     const identityBoost = IDENTITY_BOOST * qCoverage * qCoverage * Math.max(rawScore, 1);
     const rankBase = rawScore + fieldBonus + synonymContrib + identityBoost;
     if (rankBase <= 0) continue;
-    const rankScore = rankBase * statusMultiplier(doc.status) * recencyMultiplier(doc.updatedAt, now) * (doc.capture ? CAPTURE_RANK_PENALTY : 1);
+    const rankScore = rankBase * statusMultiplier(doc.status) * recencyMultiplier(doc.updatedAt, now) * (doc.capture ? CAPTURE_RANK_PENALTY : 1) * (doc.type === "changelog" ? CHANGELOG_RANK_FACTOR : 1);
     scored.push({
       hit: { doc, score: rawScore, rankScore, snippet: extractSnippet(doc, queryTerms) },
       rawRank: rankBase
@@ -7119,7 +7362,7 @@ function bm25Search(query, corpus, topK = 5, opts = {}) {
         }
       }
       if (boost > 0) {
-        s.hit.rankScore += boost * statusMultiplier(s.hit.doc.status) * recencyMultiplier(s.hit.doc.updatedAt, now) * (s.hit.doc.capture ? CAPTURE_RANK_PENALTY : 1);
+        s.hit.rankScore += boost * statusMultiplier(s.hit.doc.status) * recencyMultiplier(s.hit.doc.updatedAt, now) * (s.hit.doc.capture ? CAPTURE_RANK_PENALTY : 1) * (s.hit.doc.type === "changelog" ? CHANGELOG_RANK_FACTOR : 1);
       }
     }
   }
@@ -7147,7 +7390,7 @@ function extractSnippet(doc, queryTerms) {
   const end = Math.min(lines.length, bestIdx + 2);
   return lines.slice(start, end).join("\n").trim();
 }
-var STOPWORDS, TR_SUFFIXES, FIELD_WEIGHTS, WIKILINK_RE, K1, B, FIELD_WEIGHT_BONUS, IDENTITY_BOOST, CAPTURE_RANK_PENALTY, STATUS_PENALTY, LINK_DECAY;
+var STOPWORDS, TR_SUFFIXES, FIELD_WEIGHTS, WIKILINK_RE, K1, B, FIELD_WEIGHT_BONUS, IDENTITY_BOOST, CAPTURE_RANK_PENALTY, STATUS_PENALTY, CHANGELOG_RANK_FACTOR, LINK_DECAY;
 var init_recall = __esm({
   "src/lib/recall.ts"() {
     "use strict";
@@ -7243,30 +7486,104 @@ var init_recall = __esm({
       "sen",
       "biz",
       "siz",
-      "onlar"
+      "onlar",
+      // Turkish question/filler words — carry no content signal but inflect freely,
+      // so they survive suffix folding as noise terms in natural TR queries
+      // ("güvenlik açıkları NELERDİ", "NASIL hesaplanıyor"). Filtering them keeps
+      // TR query vectors as clean as their EN equivalents (where "what/how" are
+      // already stopwords).
+      "nas\u0131l",
+      "neden",
+      "niye",
+      "nedir",
+      "neler",
+      "nelerdi",
+      "nelerdir",
+      "hangi",
+      "hangisi",
+      "nerede",
+      "nereye",
+      "nereden",
+      "\u015Fey",
+      "\u015Feyi",
+      "eden",
+      "olan",
+      "olarak",
+      "bunu",
+      "bunun",
+      "\u015Funu",
+      "onun",
+      "yapan",
+      "midir",
+      "m\u0131d\u0131r"
     ]);
     TR_SUFFIXES = [
       "lerinden",
       "lar\u0131ndan",
+      "lerinde",
+      "lar\u0131nda",
       "lerine",
       "lar\u0131na",
       "leri",
       "lar\u0131",
       "ler",
       "lar",
+      // locative (+possessive buffer): oturumda / başında / içinde / sunucusunda
+      "\u0131nda",
+      "inde",
+      "unda",
+      "\xFCnde",
+      "nda",
+      "nde",
+      "de",
+      "da",
+      // ablative: sunucudan / sistemden (+ voiceless variants)
       "den",
       "dan",
+      "ten",
+      "tan",
+      // genitive: projenin / sunucunun
       "nin",
       "n\u0131n",
       "nun",
       "n\xFCn",
-      "de",
-      "da",
+      // 3sg possessive after vowel: sunucusu / kutusu / seviyesi
+      "s\u0131",
+      "si",
+      "su",
+      "s\xFC",
+      // possessive+locative / +genitive / +accusative compounds: sunucusunda /
+      // kutusunun / seviyesini. Listed as compounds because the bare locative
+      // ('unda') would otherwise eat into the possessive and strand an orphan 's'.
+      "s\u0131nda",
+      "sinde",
+      "sunda",
+      "s\xFCnde",
+      "s\u0131n\u0131n",
+      "sinin",
+      "sunun",
+      "s\xFCn\xFCn",
+      "s\u0131n\u0131",
+      "sini",
+      "sunu",
+      "s\xFCn\xFC",
+      // accusative after vowel (y buffer): makaleyi / kapıyı. (Bare-n buffer
+      // variants 'nı/ni/nu/nü' were tried and removed: they mis-segment
+      // consonant-final loanwords — `konsolidasyonu` → `konsolidasyo` — and their
+      // only wins are already covered by synonym surface forms.)
       "yi",
       "y\u0131",
       "yu",
-      "y\xFC"
-    ];
+      "y\xFC",
+      // relative -ki on locative: oturumdaki / eldeki
+      "daki",
+      "deki",
+      "taki",
+      "teki",
+      // instrumental: hook'la → hookla / sunucuyla
+      "yla",
+      "yle"
+    ].sort((a, b) => b.length - a.length);
     FIELD_WEIGHTS = { title: 3, tags: 2, description: 2, body: 1 };
     WIKILINK_RE = /\[\[([^\]]+)\]\]/g;
     K1 = 1.5;
@@ -7275,6 +7592,7 @@ var init_recall = __esm({
     IDENTITY_BOOST = 1.5;
     CAPTURE_RANK_PENALTY = 0.5;
     STATUS_PENALTY = { completed: 0.85 };
+    CHANGELOG_RANK_FACTOR = 0.85;
     LINK_DECAY = 0.3;
   }
 });
@@ -7349,7 +7667,17 @@ function digestPath(root, sessionId) {
 function digestExists(root, sessionId) {
   return existsSync31(digestPath(root, sessionId));
 }
-function writeDigest(root, sessionId, md) {
+function digestIsPartial(root, sessionId) {
+  const file = digestPath(root, sessionId);
+  if (!existsSync31(file)) return false;
+  try {
+    const { data } = readFrontmatter(file);
+    return data.partial === true;
+  } catch {
+    return false;
+  }
+}
+function writeDigest(root, sessionId, md, opts = {}) {
   const dir = digestsDir(root);
   mkdirSync12(dir, { recursive: true });
   const file = digestPath(root, sessionId);
@@ -7359,6 +7687,7 @@ function writeDigest(root, sessionId, md) {
     "type: session-digest",
     `session_id: ${safeId}`,
     `created_at: ${(/* @__PURE__ */ new Date()).toISOString()}`,
+    ...opts.partial ? ["partial: true"] : [],
     "---",
     ""
   ].join("\n");
@@ -7998,7 +8327,7 @@ function registerHookCommand(program) {
     }
     for (const session of state.sessions) {
       if (!session.transcript_path) continue;
-      if (digestExists(root, session.session_id)) continue;
+      if (digestExists(root, session.session_id) && !digestIsPartial(root, session.session_id)) continue;
       try {
         const distilled = distillTranscript(session.transcript_path);
         const md = buildDigest(distilled);
@@ -8267,6 +8596,15 @@ function registerHookCommand(program) {
       state.compaction_log = state.compaction_log.slice(0, 20);
     }
     writeSleepState(root, state);
+    try {
+      const sessionId = input8 && typeof input8.session_id === "string" ? input8.session_id : "";
+      const transcriptPath = input8 && typeof input8.transcript_path === "string" ? input8.transcript_path : "";
+      if (sessionId && transcriptPath && existsSync33(transcriptPath)) {
+        const distilled = distillTranscript(transcriptPath);
+        writeDigest(root, sessionId, buildDigest(distilled), { partial: true });
+      }
+    } catch {
+    }
   });
   hook.command("ensure-dashboard").description("Open the web dashboard if it is not already running (called by Claude Code SessionStart hook)").action(async () => {
     readStdin();
@@ -9263,9 +9601,9 @@ async function handleTasksInsert(req, res, params, contextRoot) {
     sendError(res, 400, "invalid_body", "Request body must be JSON.");
     return;
   }
-  const section = body.section;
+  const section2 = body.section;
   let content = body.content;
-  if (!section || typeof section !== "string") {
+  if (!section2 || typeof section2 !== "string") {
     sendError(res, 400, "missing_section", "Section name is required.");
     return;
   }
@@ -9282,9 +9620,9 @@ async function handleTasksInsert(req, res, params, contextRoot) {
     acceptance_criteria: "Acceptance Criteria",
     why: "Why"
   };
-  const sectionKey = section.toLowerCase();
+  const sectionKey = section2.toLowerCase();
   if (!sectionMap[sectionKey]) {
-    sendError(res, 400, "invalid_section", `Unknown section: "${section}". Valid: ${Object.keys(sectionMap).join(", ")}`);
+    sendError(res, 400, "invalid_section", `Unknown section: "${section2}". Valid: ${Object.keys(sectionMap).join(", ")}`);
     return;
   }
   const sectionName = sectionMap[sectionKey];
@@ -9427,10 +9765,10 @@ async function handleCoreGet(_req, res, params, contextRoot) {
     } catch {
     }
     const sectionContents = {};
-    for (const section of sections) {
+    for (const section2 of sections) {
       try {
-        const sectionContent = readSection(filePath, section);
-        if (sectionContent) sectionContents[section] = sectionContent;
+        const sectionContent = readSection(filePath, section2);
+        if (sectionContent) sectionContents[section2] = sectionContent;
       } catch {
       }
     }
@@ -9666,10 +10004,10 @@ async function handleFeaturesGet(_req, res, params, contextRoot) {
   } catch {
   }
   const sectionContents = {};
-  for (const section of sections) {
+  for (const section2 of sections) {
     try {
-      const sectionContent = readSection(filePath, section);
-      if (sectionContent) sectionContents[section] = sectionContent;
+      const sectionContent = readSection(filePath, section2);
+      if (sectionContent) sectionContents[section2] = sectionContent;
     } catch {
     }
   }
@@ -9731,12 +10069,12 @@ async function handleUnreleasedGet(_req, res, _params, contextRoot) {
 }
 async function handleReleaseGet(_req, res, params, contextRoot) {
   const entries = getExistingReleases(contextRoot);
-  const release = entries.find((r) => r.version === params.version);
-  if (!release) {
+  const release2 = entries.find((r) => r.version === params.version);
+  if (!release2) {
     sendError(res, 404, "not_found", `Release not found: ${params.version}`);
     return;
   }
-  sendJson(res, 200, { release });
+  sendJson(res, 200, { release: release2 });
 }
 async function handleReleasesCreate(req, res, _params, contextRoot) {
   const body = await parseJsonBody(req);
@@ -9755,7 +10093,7 @@ async function handleReleasesCreate(req, res, _params, contextRoot) {
     return;
   }
   const status = body.status === "planning" ? "planning" : "released";
-  const release = {
+  const release2 = {
     id: generateId("rel"),
     version: version.trim(),
     date: status === "planning" ? "" : today(),
@@ -9767,17 +10105,17 @@ async function handleReleasesCreate(req, res, _params, contextRoot) {
     changelog: Array.isArray(body.changelog) ? body.changelog : []
   };
   const filePath = join38(contextRoot, "core", "RELEASES.json");
-  insertToJsonArray(filePath, release);
-  if (release.features.length > 0) {
-    backPopulateFeatures(contextRoot, release.features, release.version);
+  insertToJsonArray(filePath, release2);
+  if (release2.features.length > 0) {
+    backPopulateFeatures(contextRoot, release2.features, release2.version);
   }
   recordDashboardChange(contextRoot, {
     entity: "core",
     action: "create",
     target: "core/RELEASES.json",
-    summary: `Created release ${release.version}`
+    summary: `Created release ${release2.version}`
   });
-  sendJson(res, 201, { release });
+  sendJson(res, 201, { release: release2 });
 }
 async function handleReleasesUpdate(req, res, params, contextRoot) {
   const body = await parseJsonBody(req);
@@ -9799,33 +10137,33 @@ async function handleReleasesUpdate(req, res, params, contextRoot) {
     sendError(res, 404, "not_found", `Release not found: ${params.version}`);
     return;
   }
-  const release = entries[idx];
+  const release2 = entries[idx];
   if (body.status !== void 0) {
     const s = body.status;
     if (s !== "planning" && s !== "released") {
       sendError(res, 400, "invalid_status", 'Status must be "planning" or "released".');
       return;
     }
-    release.status = s;
-    if (s === "released" && !release.date) {
-      release.date = today();
+    release2.status = s;
+    if (s === "released" && !release2.date) {
+      release2.date = today();
     }
   }
   if (typeof body.summary === "string") {
-    release.summary = body.summary.trim();
+    release2.summary = body.summary.trim();
   }
   if (typeof body.date === "string") {
-    release.date = body.date.trim();
+    release2.date = body.date.trim();
   }
   const { writeJsonArray: writeJsonArray2 } = await Promise.resolve().then(() => (init_json_file(), json_file_exports));
   writeJsonArray2(filePath, entries);
   recordDashboardChange(contextRoot, {
     entity: "core",
     action: "update",
-    target: `core/RELEASES.json#${release.version}`,
-    summary: `Updated release ${release.version}`
+    target: `core/RELEASES.json#${release2.version}`,
+    summary: `Updated release ${release2.version}`
   });
-  sendJson(res, 200, { release });
+  sendJson(res, 200, { release: release2 });
 }
 var init_changelog = __esm({
   "src/server/routes/changelog.ts"() {
@@ -17620,28 +17958,331 @@ var init_config4 = __esm({
   }
 });
 
+// src/lib/feedback.ts
+import { execFileSync as execFileSync8 } from "child_process";
+import { platform, release, arch } from "os";
+function isFeedbackCategory(value) {
+  return Object.prototype.hasOwnProperty.call(CATEGORY_META, value);
+}
+function parseGhAccount(authOutput) {
+  const match = authOutput.match(/account\s+([^\s(]+)/i);
+  return match ? match[1] : void 0;
+}
+function detectGitHubCli(run = defaultRunner) {
+  const version = run("gh", ["--version"]);
+  if (!version.ok) return { installed: false, authenticated: false };
+  const auth = run("gh", ["auth", "status"]);
+  const combined = `${auth.stdout}
+${auth.stderr}`;
+  const authenticated = auth.ok || /Logged in to/i.test(combined);
+  return {
+    installed: true,
+    authenticated,
+    account: authenticated ? parseGhAccount(combined) : void 0
+  };
+}
+function collectEnvironment() {
+  return {
+    dreamcontextVersion: dreamcontextVersion(),
+    node: process.version,
+    os: `${platform()} ${release()} (${arch()})`
+  };
+}
+function section(heading, body, fallback) {
+  const value = body && body.trim().length > 0 ? body.trim() : fallback;
+  return `### ${heading}
+
+${value}`;
+}
+function buildIssueBody(input8, env) {
+  const todo = "_(not provided)_";
+  const parts = [
+    section("Scenario \u2014 what the agent was doing", input8.scenario, todo),
+    section("Expected \u2014 what dreamcontext should have done", input8.expected, todo),
+    section("Gap \u2014 what was missing, broken, or surprising", input8.gap, todo),
+    section("Reproduction / commands", input8.repro, todo),
+    section("Proposed improvement", input8.proposal, todo),
+    [
+      "### Environment",
+      "",
+      `- dreamcontext: \`${env.dreamcontextVersion}\``,
+      `- node: \`${env.node}\``,
+      `- os: \`${env.os}\``,
+      `- category: \`${input8.category}\` (${CATEGORY_META[input8.category].title})`
+    ].join("\n"),
+    FEEDBACK_MARKER
+  ];
+  return parts.join("\n\n");
+}
+function labelsFor(category) {
+  const gh = CATEGORY_META[category].ghLabel;
+  return gh ? [FEEDBACK_LABEL, gh] : [FEEDBACK_LABEL];
+}
+function normalizeTitle(title) {
+  return title.toLowerCase().replace(/^(feat|fix|bug|docs|chore)(\([^)]*\))?:\s*/i, "").replace(/[^a-z0-9 ]+/g, " ").replace(/\s+/g, " ").trim();
+}
+function titleSimilarity(a, b) {
+  const ta = new Set(normalizeTitle(a).split(" ").filter(Boolean));
+  const tb = new Set(normalizeTitle(b).split(" ").filter(Boolean));
+  if (ta.size === 0 || tb.size === 0) return 0;
+  let inter = 0;
+  for (const t of ta) if (tb.has(t)) inter++;
+  return inter / (ta.size + tb.size - inter);
+}
+function findDuplicate(candidateTitle, existing, threshold = 0.6) {
+  let best;
+  for (const ref of existing) {
+    const score = titleSimilarity(candidateTitle, ref.title);
+    if (score >= threshold && (!best || score > best.score)) best = { ref, score };
+  }
+  return best?.ref;
+}
+function listFeedbackIssues(run = defaultRunner) {
+  const res = run("gh", [
+    "issue",
+    "list",
+    "--repo",
+    UPSTREAM_REPO,
+    "--state",
+    "open",
+    "--limit",
+    "100",
+    "--json",
+    "number,title,url"
+  ]);
+  if (!res.ok || !res.stdout.trim()) return [];
+  try {
+    const parsed = JSON.parse(res.stdout);
+    return Array.isArray(parsed) ? parsed : [];
+  } catch {
+    return [];
+  }
+}
+function ensureFeedbackLabel(run = defaultRunner) {
+  run("gh", [
+    "label",
+    "create",
+    FEEDBACK_LABEL,
+    "--repo",
+    UPSTREAM_REPO,
+    "--color",
+    "5319e7",
+    "--description",
+    "Filed by a dreamcontext agent via the feedback loop",
+    "--force"
+  ]);
+}
+function createIssue(input8, body, run = defaultRunner) {
+  const labels = labelsFor(input8.category);
+  const args = [
+    "issue",
+    "create",
+    "--repo",
+    UPSTREAM_REPO,
+    "--title",
+    input8.title,
+    "--body",
+    body
+  ];
+  for (const l of labels) args.push("--label", l);
+  const res = run("gh", args);
+  if (res.ok) {
+    const url = res.stdout.trim().split("\n").filter(Boolean).pop();
+    return { ok: true, url };
+  }
+  const retry = run("gh", ["issue", "create", "--repo", UPSTREAM_REPO, "--title", input8.title, "--body", body]);
+  if (retry.ok) {
+    const url = retry.stdout.trim().split("\n").filter(Boolean).pop();
+    return { ok: true, url };
+  }
+  return { ok: false, error: (res.stderr || retry.stderr || "gh issue create failed").trim() };
+}
+var UPSTREAM_REPO, FEEDBACK_LABEL, FEEDBACK_MARKER, CATEGORY_META, FEEDBACK_CATEGORIES, defaultRunner;
+var init_feedback = __esm({
+  "src/lib/feedback.ts"() {
+    "use strict";
+    init_manifest();
+    UPSTREAM_REPO = "meanllbrl/dreamcontext";
+    FEEDBACK_LABEL = "agent-feedback";
+    FEEDBACK_MARKER = "<!-- filed via `dreamcontext feedback` (agent feedback loop) -->";
+    CATEGORY_META = {
+      bug: { title: "Bug", ghLabel: "bug" },
+      "missing-cli": { title: "Missing CLI command", ghLabel: "enhancement" },
+      "unseen-memory": { title: "Memory not surfaced", ghLabel: "bug" },
+      feature: { title: "Feature request", ghLabel: "enhancement" },
+      docs: { title: "Docs gap", ghLabel: "documentation" },
+      other: { title: "Feedback" }
+    };
+    FEEDBACK_CATEGORIES = Object.keys(CATEGORY_META);
+    defaultRunner = (cmd, args) => {
+      try {
+        const stdout = execFileSync8(cmd, args, { encoding: "utf-8", stdio: ["ignore", "pipe", "pipe"] });
+        return { ok: true, stdout, stderr: "" };
+      } catch (err) {
+        const e = err;
+        return {
+          ok: false,
+          stdout: e.stdout ? e.stdout.toString() : "",
+          stderr: e.stderr ? e.stderr.toString() : ""
+        };
+      }
+    };
+  }
+});
+
+// src/cli/commands/feedback.ts
+import chalk41 from "chalk";
+import { confirm as confirm6 } from "@inquirer/prompts";
+function printAccessGuidance(installed) {
+  console.log(header("GitHub access required to file feedback"));
+  console.log();
+  if (!installed) {
+    console.log("The GitHub CLI (" + chalk41.cyan("gh") + ") is not installed. To file feedback to " + chalk41.cyan(UPSTREAM_REPO) + ":");
+    console.log();
+    console.log("  1. Install gh:   " + chalk41.dim("https://cli.github.com  (brew install gh)"));
+    console.log("  2. Sign in:      " + chalk41.cyan("gh auth login"));
+  } else {
+    console.log(chalk41.cyan("gh") + " is installed but you are not signed in.");
+    console.log();
+    console.log("  \u2022 Sign in:       " + chalk41.cyan("gh auth login"));
+  }
+  console.log();
+  console.log(chalk41.bold("No GitHub account yet?"));
+  console.log("  dreamcontext files feedback as GitHub issues, so you need a (free) account.");
+  console.log("  Create one at " + chalk41.cyan("https://github.com/signup") + ", then run " + chalk41.cyan("gh auth login") + ".");
+  console.log();
+  info("Re-run " + chalk41.cyan("dreamcontext feedback") + " once you are signed in.");
+}
+function renderPreview(input8, body) {
+  console.log(header("Feedback issue preview"));
+  console.log();
+  console.log(miniBox([
+    `repo:     ${UPSTREAM_REPO}`,
+    `title:    ${input8.title}`,
+    `labels:   ${labelsFor(input8.category).join(", ")}`
+  ], { color: "magenta" }));
+  console.log();
+  console.log(chalk41.dim("\u2500\u2500\u2500 body \u2500\u2500\u2500"));
+  console.log(body);
+  console.log(chalk41.dim("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+  console.log();
+}
+function registerFeedbackCommand(program) {
+  program.command("feedback").description(`File a structured feedback issue to ${UPSTREAM_REPO}`).option("-c, --category <category>", `Category: ${FEEDBACK_CATEGORIES.join(" | ")}`).option("-t, --title <title>", "Issue title (concise, specific)").option("-s, --scenario <text>", "What the agent was doing when it hit the gap").option("-e, --expected <text>", "What dreamcontext should have done").option("-g, --gap <text>", "What was missing, broken, or surprising").option("-r, --repro <text>", "Reproduction steps or exact commands").option("-p, --proposal <text>", "Proposed improvement (command, behavior, doc, fix)").option("--dry-run", "Render the issue without filing it (use this to show the user a draft)").option("-y, --yes", "Skip the interactive confirmation and file immediately").option("--no-dedup", "Skip the duplicate-issue check").addHelpText("after", `
+Examples:
+  ${chalk41.dim("# Render a draft to show the user (no network write):")}
+  dreamcontext feedback --dry-run -c missing-cli -t "Add \`tasks reopen\`" \\
+    -s "User asked to reopen a completed task; no CLI path exists." \\
+    -p "Add a 'tasks reopen <id>' command that flips status back to todo."
+
+  ${chalk41.dim("# File after the user approved the draft:")}
+  dreamcontext feedback --yes -c missing-cli -t "Add \`tasks reopen\`" -s "..." -p "..."
+`).action(async (opts) => {
+    const category = (opts.category ?? "other").trim();
+    if (!isFeedbackCategory(category)) {
+      error(`Unknown category: ${category}`, `Valid: ${FEEDBACK_CATEGORIES.join(", ")}`);
+      process.exitCode = 1;
+      return;
+    }
+    if (!opts.title || !opts.title.trim()) {
+      error("A --title is required.", 'Keep it concise and specific, e.g. "Add `tasks reopen` command".');
+      process.exitCode = 1;
+      return;
+    }
+    if (!opts.scenario || !opts.scenario.trim()) {
+      error("A --scenario is required.", "Describe what the agent was doing when it hit the gap.");
+      process.exitCode = 1;
+      return;
+    }
+    const input8 = {
+      category,
+      title: opts.title.trim(),
+      scenario: opts.scenario,
+      expected: opts.expected,
+      gap: opts.gap,
+      repro: opts.repro,
+      proposal: opts.proposal
+    };
+    const body = buildIssueBody(input8, collectEnvironment());
+    if (opts.dryRun) {
+      renderPreview(input8, body);
+      info("Dry run \u2014 nothing was filed. Re-run with " + chalk41.cyan("--yes") + " to file after the user approves.");
+      return;
+    }
+    const gh = detectGitHubCli();
+    if (!gh.installed || !gh.authenticated) {
+      printAccessGuidance(gh.installed);
+      process.exitCode = 1;
+      return;
+    }
+    renderPreview(input8, body);
+    if (gh.account) info(`Filing as GitHub user ${chalk41.cyan(gh.account)} \u2192 ${chalk41.cyan(UPSTREAM_REPO)}`);
+    if (opts.dedup !== false) {
+      const existing = listFeedbackIssues();
+      const dup = findDuplicate(input8.title, existing);
+      if (dup) {
+        warn(`A similar open issue already exists: #${dup.number} \u2014 ${dup.title}`);
+        console.log("  " + chalk41.cyan(dup.url));
+        if (!opts.yes) {
+          const proceed = await confirm6({ message: "File anyway?", default: false }).catch(() => false);
+          if (!proceed) {
+            info("Skipped \u2014 consider commenting on the existing issue instead.");
+            return;
+          }
+        }
+      }
+    }
+    if (!opts.yes) {
+      const proceed = await confirm6({
+        message: `File this issue to ${UPSTREAM_REPO}?`,
+        default: true
+      }).catch(() => false);
+      if (!proceed) {
+        info("Cancelled \u2014 nothing was filed.");
+        return;
+      }
+    }
+    ensureFeedbackLabel();
+    const result = createIssue(input8, body);
+    if (result.ok) {
+      success("Feedback filed.");
+      if (result.url) console.log("  " + chalk41.cyan(result.url));
+    } else {
+      error("Failed to file feedback.", result.error);
+      process.exitCode = 1;
+    }
+  });
+}
+var init_feedback2 = __esm({
+  "src/cli/commands/feedback.ts"() {
+    "use strict";
+    init_feedback();
+    init_format();
+  }
+});
+
 // src/cli/interactive.ts
 import { select as select3, input as input7, checkbox as checkbox5 } from "@inquirer/prompts";
-import chalk41 from "chalk";
+import chalk42 from "chalk";
 function outlinedRow(emoji, label, colorFn) {
   const contentWidth = 2 + 2 + 2 + label.length;
   const pad = Math.max(1, BW - contentWidth);
-  return `${chalk41.dim("\u2502")}  ${emoji}  ${colorFn(label)}${" ".repeat(pad)}${chalk41.dim("\u2502")}`;
+  return `${chalk42.dim("\u2502")}  ${emoji}  ${colorFn(label)}${" ".repeat(pad)}${chalk42.dim("\u2502")}`;
 }
 function solidRow(emoji, label) {
   const contentWidth = 2 + 2 + 2 + label.length;
   const pad = Math.max(1, BW - contentWidth);
-  return `${chalk41.magentaBright("\u2503")}  ${emoji}  ${chalk41.white.bold(label)}${" ".repeat(pad)}${chalk41.magentaBright("\u2503")}`;
+  return `${chalk42.magentaBright("\u2503")}  ${emoji}  ${chalk42.white.bold(label)}${" ".repeat(pad)}${chalk42.magentaBright("\u2503")}`;
 }
 function outlinedBackRow() {
   const contentWidth = 2 + 1 + 3 + 4;
   const pad = Math.max(1, BW - contentWidth);
-  return `${chalk41.dim("\u2502")}  \u2190   ${chalk41.dim("Back")}${" ".repeat(pad)}${chalk41.dim("\u2502")}`;
+  return `${chalk42.dim("\u2502")}  \u2190   ${chalk42.dim("Back")}${" ".repeat(pad)}${chalk42.dim("\u2502")}`;
 }
 function solidBackRow() {
   const contentWidth = 2 + 1 + 3 + 4;
   const pad = Math.max(1, BW - contentWidth);
-  return `${chalk41.magentaBright("\u2503")}  ${chalk41.white("\u2190")}   ${chalk41.white.bold("Back")}${" ".repeat(pad)}${chalk41.magentaBright("\u2503")}`;
+  return `${chalk42.magentaBright("\u2503")}  ${chalk42.white("\u2190")}   ${chalk42.white.bold("Back")}${" ".repeat(pad)}${chalk42.magentaBright("\u2503")}`;
 }
 function buildTopLevelMenu() {
   const solidMap = /* @__PURE__ */ new Map();
@@ -17657,7 +18298,7 @@ function buildTopLevelMenu() {
       description: cat.description
     });
   }
-  const exitOutlined = outlinedRow("\u{1F6AA}", "Exit", chalk41.dim);
+  const exitOutlined = outlinedRow("\u{1F6AA}", "Exit", chalk42.dim);
   const exitSolid = solidRow("\u{1F6AA}", "Exit");
   solidMap.set(exitOutlined, exitSolid);
   choices.push({
@@ -17695,16 +18336,16 @@ function buildSubmenuMenu(cat) {
 }
 function makeTheme(solidMap) {
   return {
-    prefix: { idle: chalk41.magentaBright("\u25C6"), done: chalk41.green("\u2714") },
+    prefix: { idle: chalk42.magentaBright("\u25C6"), done: chalk42.green("\u2714") },
     icon: { cursor: " " },
     style: {
       highlight: (text) => {
         const name = text.slice(2);
         const solid = solidMap.get(name);
-        if (solid) return chalk41.bgHex("#581C87")("  " + solid);
-        return chalk41.bgHex("#581C87")(text);
+        if (solid) return chalk42.bgHex("#581C87")("  " + solid);
+        return chalk42.bgHex("#581C87")(text);
       },
-      description: (text) => chalk41.dim(text)
+      description: (text) => chalk42.dim(text)
     }
   };
 }
@@ -17754,12 +18395,12 @@ async function executeCommand(command) {
     try {
       const result = await collectArgs(command.args);
       if (result === null) {
-        console.log(chalk41.dim("  Cancelled.\n"));
+        console.log(chalk42.dim("  Cancelled.\n"));
         return;
       }
       collectedArgs = result;
     } catch {
-      console.log(chalk41.dim("  Cancelled.\n"));
+      console.log(chalk42.dim("  Cancelled.\n"));
       return;
     }
   }
@@ -17780,14 +18421,14 @@ async function executeCommand(command) {
   } catch (err) {
     if (err.code === "commander.helpDisplayed" || err.code === "commander.version") {
     } else {
-      console.error(chalk41.red(`  \u2717 ${err.message}`));
+      console.error(chalk42.red(`  \u2717 ${err.message}`));
     }
   }
 }
 async function startInteractive(_program) {
   const totalCommands = CATEGORIES.reduce((sum, cat) => sum + cat.commands.length, 0);
-  console.log(chalk41.dim(`  v0.1.0 \xB7 ${totalCommands} commands in ${CATEGORIES.length} categories`));
-  console.log(chalk41.dim(`  Use \u2191\u2193 to navigate, Enter to select.
+  console.log(chalk42.dim(`  v0.1.0 \xB7 ${totalCommands} commands in ${CATEGORIES.length} categories`));
+  console.log(chalk42.dim(`  Use \u2191\u2193 to navigate, Enter to select.
 `));
   const { choices: topChoices, solidMap: topSolid } = buildTopLevelMenu();
   while (true) {
@@ -17801,11 +18442,11 @@ async function startInteractive(_program) {
         theme: makeTheme(topSolid)
       });
     } catch {
-      console.log(chalk41.dim("\n  Until next session.\n"));
+      console.log(chalk42.dim("\n  Until next session.\n"));
       process.exit(0);
     }
     if (categoryId === EXIT_SENTINEL) {
-      console.log(chalk41.dim("\n  Until next session.\n"));
+      console.log(chalk42.dim("\n  Until next session.\n"));
       process.exit(0);
     }
     const category = CATEGORIES.find((c) => c.id === categoryId);
@@ -17865,8 +18506,8 @@ var init_interactive = __esm({
         emoji: "\u{1F680}",
         label: "Setup",
         description: "Initialize project and install skills",
-        color: chalk41.cyan,
-        colorBright: chalk41.cyanBright,
+        color: chalk42.cyan,
+        colorBright: chalk42.cyanBright,
         commands: [
           {
             emoji: "\u{1F680}",
@@ -17964,8 +18605,8 @@ var init_interactive = __esm({
         emoji: "\u{1F4CB}",
         label: "Tasks",
         description: "Create tasks, log progress, mark complete",
-        color: chalk41.green,
-        colorBright: chalk41.greenBright,
+        color: chalk42.green,
+        colorBright: chalk42.greenBright,
         commands: [
           {
             emoji: "\u2795",
@@ -17995,8 +18636,8 @@ var init_interactive = __esm({
         emoji: "\u{1F9E9}",
         label: "Features",
         description: "Create features and add content to sections",
-        color: chalk41.yellow,
-        colorBright: chalk41.yellowBright,
+        color: chalk42.yellow,
+        colorBright: chalk42.yellowBright,
         commands: [
           {
             emoji: "\u2728",
@@ -18022,8 +18663,8 @@ var init_interactive = __esm({
         emoji: "\u{1F4DA}",
         label: "Knowledge",
         description: "Create and browse knowledge documents",
-        color: chalk41.blue,
-        colorBright: chalk41.blueBright,
+        color: chalk42.blue,
+        colorBright: chalk42.blueBright,
         commands: [
           {
             emoji: "\u{1F4C4}",
@@ -18051,8 +18692,8 @@ var init_interactive = __esm({
         emoji: "\u{1F4DD}",
         label: "Changelog",
         description: "Record changelog entries and releases",
-        color: chalk41.magenta,
-        colorBright: chalk41.magentaBright,
+        color: chalk42.magenta,
+        colorBright: chalk42.magentaBright,
         commands: [
           {
             emoji: "\u{1F4AC}",
@@ -18079,8 +18720,8 @@ var init_interactive = __esm({
         emoji: "\u{1F527}",
         label: "System",
         description: "Sleep tracking, diagnostics, snapshots",
-        color: chalk41.whiteBright,
-        colorBright: (s) => chalk41.whiteBright.bold(s),
+        color: chalk42.whiteBright,
+        colorBright: (s) => chalk42.whiteBright.bold(s),
         commands: [
           {
             emoji: "\u{1F4CA}",
@@ -18163,8 +18804,8 @@ var init_interactive = __esm({
         emoji: "\u{1F5A5}\uFE0F",
         label: "Dashboard",
         description: "Open the web dashboard in your browser",
-        color: chalk41.magentaBright,
-        colorBright: (s) => chalk41.magentaBright.bold(s),
+        color: chalk42.magentaBright,
+        colorBright: (s) => chalk42.magentaBright.bold(s),
         commands: [
           {
             emoji: "\u{1F310}",
@@ -18180,7 +18821,7 @@ var init_interactive = __esm({
 });
 
 // src/lib/pixel-banner.ts
-import chalk42 from "chalk";
+import chalk43 from "chalk";
 function decodeIdx(c) {
   return c === "." ? -1 : IDX[c];
 }
@@ -18197,17 +18838,17 @@ function renderBanner() {
         line += " ";
       } else if (ti >= 0 && bi === -1) {
         const [r, g, b] = P[ti];
-        line += chalk42.rgb(r, g, b)("\u2580");
+        line += chalk43.rgb(r, g, b)("\u2580");
       } else if (ti === -1 && bi >= 0) {
         const [r, g, b] = P[bi];
-        line += chalk42.rgb(r, g, b)("\u2584");
+        line += chalk43.rgb(r, g, b)("\u2584");
       } else {
         const [tr, tg, tb] = P[ti];
         const [br, bg, bb] = P[bi];
         if (tr === br && tg === bg && tb === bb) {
-          line += chalk42.rgb(tr, tg, tb)("\u2588");
+          line += chalk43.rgb(tr, tg, tb)("\u2588");
         } else {
-          line += chalk42.rgb(tr, tg, tb).bgRgb(br, bg, bb)("\u2580");
+          line += chalk43.rgb(tr, tg, tb).bgRgb(br, bg, bb)("\u2580");
         }
       }
     }
@@ -18273,12 +18914,12 @@ __export(index_exports, {
   createProgram: () => createProgram
 });
 import { Command as Command2 } from "commander";
-import chalk43 from "chalk";
+import chalk44 from "chalk";
 function getBanner() {
   const logo = renderBanner();
-  const title = `${chalk43.bold.cyan("D R E A M")}${chalk43.bold.cyanBright("   C O N T E X T")}`;
-  const sep7 = chalk43.dim("\u2501".repeat(25));
-  const tagline = chalk43.dim("persistent memory for AI agents");
+  const title = `${chalk44.bold.cyan("D R E A M")}${chalk44.bold.cyanBright("   C O N T E X T")}`;
+  const sep7 = chalk44.dim("\u2501".repeat(25));
+  const tagline = chalk44.dim("persistent memory for AI agents");
   const text = [
     "",
     `       ${title}`,
@@ -18318,6 +18959,7 @@ function createProgram() {
   registerMemoryCommand(program);
   registerVaultsCommand(program);
   registerConfigCommand(program);
+  registerFeedbackCommand(program);
   return program;
 }
 async function main() {
@@ -18361,46 +19003,48 @@ var init_index = __esm({
     init_upgrade();
     init_vaults2();
     init_config4();
+    init_feedback2();
     init_interactive();
     init_pixel_banner();
     init_manifest();
     HELP_GROUPS = `
-${chalk43.bold("Setup")}
-  ${chalk43.magentaBright("setup")}             One-shot: init + install-skill + install-instructions
-  ${chalk43.magentaBright("init")}              ${chalk43.dim("(deprecated)")} Initialize _dream_context/ in your project
-  ${chalk43.magentaBright("install-skill")}     ${chalk43.dim("(deprecated)")} Install skill + agents + optional packs
-  ${chalk43.magentaBright("install-instructions")} ${chalk43.dim("(deprecated)")} Install managed root instruction files
-  ${chalk43.magentaBright("install-claude-md")} ${chalk43.dim("(deprecated)")} Legacy alias for CLAUDE.md install
-  ${chalk43.magentaBright("update")}            Refresh installed skill, agents, hooks, packs, and root instructions
-  ${chalk43.magentaBright("upgrade")}           Upgrade the dreamcontext CLI itself to the latest version
+${chalk44.bold("Setup")}
+  ${chalk44.magentaBright("setup")}             One-shot: init + install-skill + install-instructions
+  ${chalk44.magentaBright("init")}              ${chalk44.dim("(deprecated)")} Initialize _dream_context/ in your project
+  ${chalk44.magentaBright("install-skill")}     ${chalk44.dim("(deprecated)")} Install skill + agents + optional packs
+  ${chalk44.magentaBright("install-instructions")} ${chalk44.dim("(deprecated)")} Install managed root instruction files
+  ${chalk44.magentaBright("install-claude-md")} ${chalk44.dim("(deprecated)")} Legacy alias for CLAUDE.md install
+  ${chalk44.magentaBright("update")}            Refresh installed skill, agents, hooks, packs, and root instructions
+  ${chalk44.magentaBright("upgrade")}           Upgrade the dreamcontext CLI itself to the latest version
 
-${chalk43.bold("Content")}
-  ${chalk43.magentaBright("core")}              Add changelog and release entries
-  ${chalk43.magentaBright("features")}          Create features and insert into sections
-  ${chalk43.magentaBright("knowledge")}         Create and index knowledge files
-  ${chalk43.magentaBright("memory")}            Recall facts via BM25 search over the project corpus
-  ${chalk43.magentaBright("tasks")}             Create tasks, log progress, and mark complete
-  ${chalk43.magentaBright("bookmark")}          Tag important moments for consolidation
-  ${chalk43.magentaBright("trigger")}           Manage contextual reminders (prospective memory)
-  ${chalk43.magentaBright("council")}           Run structured multi-agent debates on decisions
+${chalk44.bold("Content")}
+  ${chalk44.magentaBright("core")}              Add changelog and release entries
+  ${chalk44.magentaBright("features")}          Create features and insert into sections
+  ${chalk44.magentaBright("knowledge")}         Create and index knowledge files
+  ${chalk44.magentaBright("memory")}            Recall facts via BM25 search over the project corpus
+  ${chalk44.magentaBright("tasks")}             Create tasks, log progress, and mark complete
+  ${chalk44.magentaBright("bookmark")}          Tag important moments for consolidation
+  ${chalk44.magentaBright("trigger")}           Manage contextual reminders (prospective memory)
+  ${chalk44.magentaBright("council")}           Run structured multi-agent debates on decisions
 
-${chalk43.bold("System")}
-  ${chalk43.magentaBright("snapshot")}          Output context snapshot (used by SessionStart hook)
-  ${chalk43.magentaBright("sleep")}             Track sleep debt and consolidation state
-  ${chalk43.magentaBright("hook")}              Hook handlers used by platform integrations
-  ${chalk43.magentaBright("transcript")}        Process session transcripts
-  ${chalk43.magentaBright("doctor")}            Validate _dream_context/ structure and report issues
+${chalk44.bold("System")}
+  ${chalk44.magentaBright("snapshot")}          Output context snapshot (used by SessionStart hook)
+  ${chalk44.magentaBright("sleep")}             Track sleep debt and consolidation state
+  ${chalk44.magentaBright("hook")}              Hook handlers used by platform integrations
+  ${chalk44.magentaBright("transcript")}        Process session transcripts
+  ${chalk44.magentaBright("doctor")}            Validate _dream_context/ structure and report issues
+  ${chalk44.magentaBright("feedback")}          File a gap/bug as a GitHub issue to the dreamcontext project
 
-${chalk43.bold("Dashboard")}
-  ${chalk43.magentaBright("dashboard")}         Open the web dashboard in your browser
+${chalk44.bold("Dashboard")}
+  ${chalk44.magentaBright("dashboard")}         Open the web dashboard in your browser
 
-${chalk43.bold("Vaults")}
-  ${chalk43.magentaBright("vaults")}            Manage the global vault registry (multi-project)
+${chalk44.bold("Vaults")}
+  ${chalk44.magentaBright("vaults")}            Manage the global vault registry (multi-project)
 
-${chalk43.dim("Run")} dreamcontext ${chalk43.dim("<command> --help")} ${chalk43.dim("for details on a specific command.")}
+${chalk44.dim("Run")} dreamcontext ${chalk44.dim("<command> --help")} ${chalk44.dim("for details on a specific command.")}
 `;
     main().catch((err) => {
-      console.error(chalk43.red("\u2717") + " " + err.message);
+      console.error(chalk44.red("\u2717") + " " + err.message);
       process.exit(1);
     });
   }