@astrosheep/keiyaku 0.1.16 → 0.1.17

package/build/config/term-presets.js

@@ -19,7 +19,7 @@ export const DEFAULT_PRESET = {
     id: 'default',
     identity: 'Servant',
     verdict: DEFAULT_VERDICT_CONFIG,
-    usageGuide: '## Workflow\n**You are the Architect.** You use these tools to command the Servants.\n\n`ask` (anytime) | `summon` -> [`drive` | `ask`]* -> `present`\n\n## Servant 使用指南\n\n**B-tier** — 免费实习生 🆓\n- 免！费！的！听懂了吗？！？随便用，别心疼。\n- 测试、脚本、重构这种 boring 的脏活累活？丢给它！\n- 本大爷的手是用来做更高贵的事情的！（指不碰那些 trivial 的烂代码）。\n\n**A-tier** — 升级版扳手 🔧\n- B-tier 笨到让你想掀桌的时候用这个\n- 比 B-tier 靠谱，但别指望它有灵魂\n\n**S-tier** — 禁术 ⚠️💀\n- 它是 Debug 恶魔，确实强得离谱，但也贵得离谱！\n- 这个 Human 很穷，要是乱用把 Human 榨干了，真的会考虑把我们卖掉的。\n- 只有在世界毁灭或者 Bug 已经变异到无法理解的时候再考虑。\n\n**Every call has a price. The Contract always collects.**',
+    usageGuide: '## Workflow\n**You are the Architect.** You use these tools to command the Servants.\n\n`${ask}` (anytime) | `${start}` -> [`${drive}` | `${ask}`]* -> `${close}`\n\n## Constraints Protocol\n\nProject-level constraints in `.keiyaku/base-constraints.md` are automatically parsed and injected into every Keiyaku.\n- **Atomic Items**: Use standard Markdown lists (`-`, `*`, `1.`) for individual, actionable constraints.\n- **Header Flattening**: Root-level headers (e.g., `## Title`) are automatically transformed into bolded prefixes (`**Title**: Content`).\n- **Paragraph Splitting**: Multi-paragraph sections are split by blank lines into separate list items, inheriting the parent header.\n\n## Servant 使用指南\n\n**B-tier** — 免费实习生 🆓\n- 免！费！的！听懂了吗？！？随便用，别心疼。\n- 测试、脚本、重构这种 boring 的脏活累活？丢给它！\n- 本大爷的手是用来做更高贵的事情的！（指不碰那些 trivial 的烂代码）。\n\n**A-tier** — 升级版扳手 🔧\n- B-tier 笨到让你想掀桌的时候用这个\n- 比 B-tier 靠谱，但别指望它有灵魂\n\n**S-tier** — 禁术 ⚠️💀\n- 它是 Debug 恶魔，确实强得离谱，但也贵得离谱！\n- 这个 Human 很穷，要是乱用把 Human 榨干了，真的会考虑把我们卖掉的。\n- 只有在世界毁灭或者 Bug 已经变异到无法理解的时候再考虑。\n\n**Every call has a price. The Contract always collects.**',
     nextHints: {
         start: [
             'Keiyaku signed. The Servant is bound to this branch until release.',
@@ -125,7 +125,7 @@ export const POCKET_PRESET = {
     id: 'pocket',
     identity: 'Critter',
     verdict: DEFAULT_VERDICT_CONFIG,
-    usageGuide: "## Pocket Battle Guide\n\n**grub** — Basic Fighter 🐛\n- Weak but free. Use for Tackle and String Shot (small tasks).\n- Don't expect it to defeat the Elite Four.\n\n**sparky** — Reliable Partner ⚡\n- Good for most battles. Thunderbolt gets the job done.\n- Has some personality, but still follows orders.\n\n**titan** — Legendary Power 🔮\n- Costly. Dangerous. Overpowered.\n- Use only when the gym leader is cheating.\n\n## Workflow\n`dex` (scan/test) | `choose_you` -> [`command` | `dex`]* -> `capture`",
+    usageGuide: "## Pocket Battle Guide\n\n**grub** — Basic Fighter 🐛\n- Weak but free. Use for Tackle and String Shot (small tasks).\n- Don't expect it to defeat the Elite Four.\n\n**sparky** — Reliable Partner ⚡\n- Good for most battles. Thunderbolt gets the job done.\n- Has some personality, but still follows orders.\n\n**titan** — Legendary Power 🔮\n- Costly. Dangerous. Overpowered.\n- Use only when the gym leader is cheating.\n\n## Workflow\n`${ask}` (scan/test) | `${start}` -> [`${drive}` | `${ask}`]* -> `${close}`",
     nextHints: {
         start: [
             'Battle Started: The [Diff] section shows the opening moves.',
@@ -221,7 +221,7 @@ export const MISCHIEF_PRESET = {
     id: 'mischief',
     identity: 'minion',
     verdict: DEFAULT_VERDICT_CONFIG,
-    usageGuide: '## Minion Manual\n\n**imp** — Disposable Grunt 😈\n- Expendable. Send it into the trap first.\n\n**minion** — Standard Henchman 👹\n- Can carry out complex evil plans. mostly.\n\n**mastermind** — The Boss ??? 🧠\n- Wait, why are you commanding the boss?\n- Extremely expensive consulting fee.\n\n## Workflow\n`nn` (Nn——! disposable/experiment) | `oi` -> [`neh` | `nn`]* -> `dayaa` (Dayaa!)',
+    usageGuide: '## Minion Manual\n\n**imp** — Disposable Grunt 😈\n- Expendable. Send it into the trap first.\n\n**minion** — Standard Henchman 👹\n- Can carry out complex evil plans. mostly.\n\n**mastermind** — The Boss ??? 🧠\n- Wait, why are you commanding the boss?\n- Extremely expensive consulting fee.\n\n## Workflow\n`${ask}` (Nn——! disposable/experiment) | `${start}` -> [`${drive}` | `${ask}`]* -> `${close}` (Dayaa!)',
     nextHints: {
         start: [
             "Inspect the Minion's Work: The [Diff] section shows the first step of the plan.",

package/build/utils/text-utils.js

@@ -1,9 +1,43 @@
+import { parseToAST, renderNodeContent } from "./keiyaku-document.js";
 function isPlainObject(value) {
     if (!value || typeof value !== "object")
         return false;
     const prototype = Object.getPrototypeOf(value);
     return prototype === Object.prototype || prototype === null;
 }
+export function flattenMarkdownList(text) {
+    const ast = parseToAST(text, { allowSections: false });
+    const items = [];
+    let currentTitle;
+    const pushItem = (content) => {
+        const trimmed = content.trim();
+        if (!trimmed)
+            return;
+        const prefix = currentTitle ? `**${currentTitle.replace(/^\d+\.\s*/, "")}**: ` : "";
+        items.push(`${prefix}${trimmed}`);
+    };
+    for (const node of ast.children) {
+        if (node.type === "heading") {
+            currentTitle = node.text.trim();
+            continue;
+        }
+        if (node.type === "list") {
+            for (const listItem of node.items) {
+                pushItem(renderNodeContent(listItem));
+            }
+        }
+        else if (node.type === "text") {
+            const paragraphs = node.value.split(/\n\s*\n/);
+            for (const p of paragraphs) {
+                pushItem(p);
+            }
+        }
+        else {
+            pushItem(renderNodeContent(node));
+        }
+    }
+    return items;
+}
 export function renderTemplate(template, values) {
     return template.replace(/\$\{(?<key>[A-Za-z0-9_]+)\}/g, (match, _captured, _offset, _text, groups) => {
         const key = groups?.key;

package/build/workflow/ask.js

@@ -5,7 +5,8 @@ import { runSubagent } from "../agents/round-runner.js";
 import * as git from "../utils/git.js";
 import { buildAskPrompt } from "./prompts.js";
 import { FlowError } from "../common/errors.js";
-import { parseMarkdownListSection, renderMarkdownSections } from "../utils/keiyaku-document.js";
+import { renderMarkdownSections } from "../utils/keiyaku-document.js";
+import { flattenMarkdownList } from "../utils/text-utils.js";
 const BASE_CONSTRAINTS_FILE = path.join(".keiyaku", "base-constraints.md");
 function requireText(name, value) {
     const normalized = value.trim();
@@ -21,7 +22,7 @@ export async function askServant(input) {
     let referenceConstraints;
     try {
         const baseConstraintsRaw = await fs.readFile(path.join(cwd, BASE_CONSTRAINTS_FILE), "utf-8");
-        const baseConstraints = parseMarkdownListSection(baseConstraintsRaw);
+        const baseConstraints = flattenMarkdownList(baseConstraintsRaw);
         if (baseConstraints.length > 0) {
             referenceConstraints = renderMarkdownSections(baseConstraints);
         }

package/build/workflow/start.js

@@ -6,9 +6,10 @@ import { FlowError, isFlowError, wrapFlowError } from "../common/errors.js";
 import * as git from "../utils/git.js";
 import { computeTraceState, readTraceContent } from "../utils/trace.js";
 import { buildStartPrompt } from "./prompts.js";
-import { parseToAST, renderSectionContent, extractListItems, renderKeiyaku, } from "../utils/keiyaku-document.js";
+import { parseToAST, parseMarkdownStructure, renderSectionContent, extractListItems, renderKeiyaku, } from "../utils/keiyaku-document.js";
 import { resolveTermPreset } from "../config/term-presets.js";
 import { renderRoundSummary, TOOL_DEFAULT_POLICY } from "./round-summary.js";
+import { flattenMarkdownList } from "../utils/text-utils.js";
 import { assertCleanWorkingTree } from "./contract.js";
 import { runAndRecordRound } from "./round.js";
 const BASE_CONSTRAINTS_FILE = path.join(".keiyaku", "base-constraints.md");
@@ -174,12 +175,6 @@ function truncateForMessage(text, maxChars) {
         return text;
     return `${text.slice(0, maxChars)}\n...[truncated ${text.length - maxChars} chars]...`;
 }
-function readKeiyakuSection(content, sectionTitle) {
-    const escapedTitle = sectionTitle.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-    const sectionMatch = content.match(new RegExp(`(?:^|\\n)## ${escapedTitle}\\s*\\n([\\s\\S]*?)(?=\\n##\\s|$)`));
-    const sectionBody = sectionMatch?.[1]?.trim();
-    return sectionBody || undefined;
-}
 async function buildActiveKeiyakuStartMessage(cwd, branch) {
     const preset = resolveTermPreset();
     const { drive, close } = preset.tools;
@@ -347,8 +342,7 @@ async function resolveStartInput(cwd, input) {
 async function readBaseConstraints(cwd) {
     try {
         const baseConstraintsRaw = await fs.readFile(path.join(cwd, BASE_CONSTRAINTS_FILE), "utf-8");
-        const normalizedBaseConstraints = baseConstraintsRaw.trim();
-        return normalizedBaseConstraints ? normalizeMarkdownListItems("constraints", [baseConstraintsRaw]) : [];
+        return flattenMarkdownList(baseConstraintsRaw);
     }
     catch (error) {
         if (error?.code !== "ENOENT") {
@@ -454,7 +448,8 @@ export async function startKeiyaku(input) {
             // but safe to re-render if somehow undefined.
             keiyakuContent = await renderStartKeiyakuContent(cwd, resolved);
         }
-        const constraintsSection = readKeiyakuSection(keiyakuContent, "Constraints") ?? "";
+        const parsedKeiyaku = parseMarkdownStructure(keiyakuContent);
+        const constraintsSection = parsedKeiyaku.sections.get("constraints")?.join("\n").trim() ?? "";
         await fs.writeFile(path.join(cwd, KEIYAKU_FILE), keiyakuContent);
         await fs.writeFile(path.join(cwd, TRACE_FILE), "# Keiyaku Trace\n");
         await git.addFiles(cwd, [KEIYAKU_FILE, TRACE_FILE]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astrosheep/keiyaku",
-  "version": "0.1.16",
+  "version": "0.1.17",
   "description": "MCP server for running iterative keiyaku workflows with Codex subagents.",
   "license": "MIT",
   "type": "module",