superlab 0.1.7 → 0.1.9

package/lib/context.cjs

@@ -0,0 +1,337 @@
+const fs = require("node:fs");
+const path = require("node:path");
+
+function contextFile(targetDir, name) {
+  return path.join(targetDir, ".lab", "context", name);
+}
+
+function readFileIfExists(filePath) {
+  if (!fs.existsSync(filePath)) {
+    return "";
+  }
+  return fs.readFileSync(filePath, "utf8");
+}
+
+function readWorkflowLanguage(targetDir) {
+  const configPath = path.join(targetDir, ".lab", "config", "workflow.json");
+  if (!fs.existsSync(configPath)) {
+    return "en";
+  }
+  try {
+    const config = JSON.parse(fs.readFileSync(configPath, "utf8"));
+    return config.workflow_language === "zh" ? "zh" : "en";
+  } catch {
+    return "en";
+  }
+}
+
+function extractValue(text, labels) {
+  for (const label of labels) {
+    const escaped = label.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    const regex = new RegExp(`^\\s*(?:[-\\d.]+\\s*)?${escaped}:\\s*(.+?)\\s*$`, "im");
+    const match = text.match(regex);
+    if (match && match[1]) {
+      return match[1].trim();
+    }
+  }
+  return "";
+}
+
+function extractOpenQuestion(text) {
+  const blocks = text
+    .split(/\n(?=\d+\.\s)/)
+    .map((block) => block.trim())
+    .filter(Boolean);
+  for (const block of blocks) {
+    if (!/Status:\s*(resolved|stale)/i.test(block)) {
+      const question = extractValue(block, ["Question", "问题"]);
+      if (question) {
+        return question;
+      }
+    }
+  }
+  return "";
+}
+
+function extractClaim(text) {
+  const blocks = text
+    .split(/\n(?=\d+\.\s)/)
+    .map((block) => block.trim())
+    .filter(Boolean);
+  for (const block of blocks) {
+    const claim = extractValue(block, ["Claim"]);
+    if (claim) {
+      return claim;
+    }
+  }
+  return "";
+}
+
+function renderSummary(lang, data) {
+  if (lang === "zh") {
+    return `# 研究摘要
+
+## 当前方向
+
+- Mission: ${data.problem || "待补充"}
+- Approved direction: ${data.direction || "待补充"}
+- Active stage: ${data.stage || "待补充"}
+
+## 最强证据
+
+- Claim: ${data.claim || "待补充"}
+
+## 最大风险
+
+- Risk: ${data.risk || "待补充"}
+
+## 当前缺口
+
+- Open question: ${data.question || "待补充"}
+`;
+  }
+
+  return `# Research Summary
+
+## Current Direction
+
+- Mission: ${data.problem || "TBD"}
+- Approved direction: ${data.direction || "TBD"}
+- Active stage: ${data.stage || "TBD"}
+
+## Strongest Evidence
+
+- Claim: ${data.claim || "TBD"}
+
+## Largest Risk
+
+- Risk: ${data.risk || "TBD"}
+
+## Current Gap
+
+- Open question: ${data.question || "TBD"}
+`;
+}
+
+function renderNextAction(lang, data) {
+  if (lang === "zh") {
+    return `# 下一步动作
+
+## 当前动作
+
+- Action: ${data.immediateAction || "待补充"}
+- Success signal: ${data.nextArtifact || data.threshold || "待补充"}
+
+## 如果成功
+
+- Next action: ${data.successFollowup || "继续推进当前阶段"}
+
+## 如果失败
+
+- Fallback action: ${data.blocker ? `先处理阻塞：${data.blocker}` : "回到 review 或 iterate"}
+
+## 是否需要人工决策
+
+- Question: ${data.humanDecision || "无"}
+- 为什么会阻塞：${data.blocker || "无"}
+`;
+  }
+
+  return `# Next Action
+
+## Immediate Step
+
+- Action: ${data.immediateAction || "TBD"}
+- Success signal: ${data.nextArtifact || data.threshold || "TBD"}
+
+## If Success
+
+- Next action: ${data.successFollowup || "Continue the active stage"}
+
+## If Failure
+
+- Fallback action: ${data.blocker ? `Resolve blocker: ${data.blocker}` : "Route back to review or iterate"}
+
+## Human Decision Needed
+
+- Question: ${data.humanDecision || "none"}
+- Why it blocks progress: ${data.blocker || "none"}
+`;
+}
+
+function renderSessionBrief(lang, data) {
+  if (lang === "zh") {
+    return `# 会话简报
+
+## 当前阶段
+
+- Stage: ${data.stage || "待补充"}
+
+## 主线任务
+
+${data.problem || "待补充"}
+
+## 当前最优路径
+
+- Approved direction: ${data.direction || "待补充"}
+- Why this is the active path: ${data.why || "当前已批准方向"}
+
+## 主要风险
+
+- Risk: ${data.risk || "待补充"}
+- Evidence gap: ${data.question || "待补充"}
+
+## 先读这些文件
+
+1. \`.lab/context/mission.md\`
+2. \`.lab/context/state.md\`
+3. \`.lab/context/evidence-index.md\`
+
+## 不要静默修改
+
+- Frozen boundary: ${data.boundary || "待补充"}
+- Approval gate: ${data.direction || "变更 mission 前需确认"}
+`;
+  }
+
+  return `# Session Brief
+
+## Active Stage
+
+- Stage: ${data.stage || "TBD"}
+
+## Mission
+
+${data.problem || "TBD"}
+
+## Best Current Path
+
+- Approved direction: ${data.direction || "TBD"}
+- Why this is the active path: ${data.why || "This is the approved direction"}
+
+## Main Risk
+
+- Risk: ${data.risk || "TBD"}
+- Evidence gap: ${data.question || "TBD"}
+
+## Read First
+
+1. \`.lab/context/mission.md\`
+2. \`.lab/context/state.md\`
+3. \`.lab/context/evidence-index.md\`
+
+## Do Not Change Silently
+
+- Frozen boundary: ${data.boundary || "TBD"}
+- Approval gate: ${data.direction || "Ask before changing mission"}
+`;
+}
+
+function buildContextSnapshot(targetDir) {
+  const mission = readFileIfExists(contextFile(targetDir, "mission.md"));
+  const state = readFileIfExists(contextFile(targetDir, "state.md"));
+  const evidence = readFileIfExists(contextFile(targetDir, "evidence-index.md"));
+  const questions = readFileIfExists(contextFile(targetDir, "open-questions.md"));
+
+  return {
+    problem: extractValue(mission, ["One-sentence problem", "一句话问题"]),
+    direction: extractValue(mission, ["Approved direction", "已批准方向"]),
+    stage: extractValue(state, ["Active stage", "当前阶段", "Stage"]),
+    nextArtifact: extractValue(state, ["Next required artifact", "下一项必要输出"]),
+    immediateAction: extractValue(state, ["Immediate action", "立即要做的动作"]),
+    blocker: extractValue(state, ["Current blocker", "当前阻塞"]),
+    humanDecision: extractValue(state, ["Human decision needed", "是否需要人工决策"]),
+    threshold: extractValue(mission, ["Success threshold", "成功阈值"]),
+    boundary: extractValue(mission, ["Hard constraints", "硬约束"]),
+    claim: extractClaim(evidence),
+    question: extractOpenQuestion(questions),
+    risk: extractValue(questions, ["Why it matters", "为什么重要"]) || extractValue(state, ["Current blocker", "当前阻塞"]),
+  };
+}
+
+function writeContextFile(targetDir, name, content) {
+  const filePath = contextFile(targetDir, name);
+  fs.mkdirSync(path.dirname(filePath), { recursive: true });
+  fs.writeFileSync(filePath, content.trimEnd() + "\n");
+}
+
+function refreshContext({ targetDir }) {
+  const lang = readWorkflowLanguage(targetDir);
+  const snapshot = buildContextSnapshot(targetDir);
+  writeContextFile(targetDir, "summary.md", renderSummary(lang, snapshot));
+  writeContextFile(targetDir, "next-action.md", renderNextAction(lang, snapshot));
+  writeContextFile(targetDir, "session-brief.md", renderSessionBrief(lang, snapshot));
+  return { targetDir };
+}
+
+function pruneQuestionBlocks(text) {
+  const chunks = text.split(/\n(?=\d+\.\s)/);
+  const kept = chunks.filter((chunk) => !/Status:\s*(resolved|stale)/i.test(chunk));
+  return kept.join("\n").replace(/\n{3,}/g, "\n\n").trimEnd() + "\n";
+}
+
+function pruneGenericText(text) {
+  return text
+    .split("\n")
+    .filter((line) => !/^\s*-\s*[^:]+:\s*$/.test(line))
+    .filter((line) => !/^\s*-\s*Status:\s*stale\s*$/i.test(line))
+    .join("\n")
+    .replace(/\n{3,}/g, "\n\n")
+    .trimEnd() + "\n";
+}
+
+function pruneContext({ targetDir }) {
+  const questionPath = contextFile(targetDir, "open-questions.md");
+  const nextActionPath = contextFile(targetDir, "next-action.md");
+  const summaryPath = contextFile(targetDir, "summary.md");
+
+  if (fs.existsSync(questionPath)) {
+    fs.writeFileSync(questionPath, pruneQuestionBlocks(fs.readFileSync(questionPath, "utf8")));
+  }
+  if (fs.existsSync(nextActionPath)) {
+    fs.writeFileSync(nextActionPath, pruneGenericText(fs.readFileSync(nextActionPath, "utf8")));
+  }
+  if (fs.existsSync(summaryPath)) {
+    fs.writeFileSync(summaryPath, pruneGenericText(fs.readFileSync(summaryPath, "utf8")));
+  }
+  return { targetDir };
+}
+
+function moveChildren(sourceDir, targetDir) {
+  if (!fs.existsSync(sourceDir)) {
+    return;
+  }
+  fs.mkdirSync(targetDir, { recursive: true });
+  for (const entry of fs.readdirSync(sourceDir)) {
+    fs.renameSync(path.join(sourceDir, entry), path.join(targetDir, entry));
+  }
+}
+
+function archiveContext({ targetDir, now = new Date() }) {
+  const stamp = now.toISOString().replace(/[-:]/g, "").replace(/\..+/, "");
+  const snapshotRoot = path.join(targetDir, ".lab", "archive", stamp);
+  fs.mkdirSync(snapshotRoot, { recursive: true });
+
+  const contextDir = path.join(snapshotRoot, "context");
+  fs.mkdirSync(contextDir, { recursive: true });
+  for (const fileName of ["summary.md", "next-action.md", "session-brief.md"]) {
+    const sourcePath = contextFile(targetDir, fileName);
+    if (fs.existsSync(sourcePath)) {
+      fs.copyFileSync(sourcePath, path.join(contextDir, fileName));
+    }
+  }
+
+  moveChildren(path.join(targetDir, ".lab", "iterations"), path.join(snapshotRoot, "iterations"));
+  moveChildren(
+    path.join(targetDir, ".lab", "writing", "iterations"),
+    path.join(snapshotRoot, "writing", "iterations")
+  );
+
+  return { archivePath: snapshotRoot };
+}
+
+module.exports = {
+  archiveContext,
+  pruneContext,
+  refreshContext,
+};