syntaur 0.6.1 → 0.7.1

package/dist/index.js

@@ -148,7 +148,7 @@ function extractFrontmatter(fileContent) {
 }
 function parseSimpleValue(raw) {
   const trimmed = raw.trim();
-  if (trimmed === "null" || trimmed === "") return null;
+  if (trimmed === "null" || trimmed === "~" || trimmed === "") return null;
   if (trimmed.startsWith('"') && trimmed.endsWith('"') || trimmed.startsWith("'") && trimmed.endsWith("'")) {
     return trimmed.slice(1, -1);
   }
@@ -199,6 +199,7 @@ function parseProject(fileContent) {
     updated: getField(fm, "updated") ?? "",
     tags: parseListField(fm, "tags"),
     workspace: getField(fm, "workspace"),
+    externalIds: parseExternalIds(fm),
     body
   };
 }
@@ -243,16 +244,14 @@ function parseExternalIds(frontmatter) {
       const colonIdx = line.indexOf(":");
       if (colonIdx < 0) continue;
       const key = line.slice(0, colonIdx).trim().replace(/^-\s+/, "");
-      const value = line.slice(colonIdx + 1).trim();
-      if (key && value) {
-        entry[key] = value;
-      }
+      if (!key) continue;
+      entry[key] = parseSimpleValue(line.slice(colonIdx + 1));
     }
-    if (entry["system"] && entry["id"] && entry["url"]) {
+    if (entry["system"] && entry["id"]) {
       results.push({
         system: entry["system"],
         id: entry["id"],
-        url: entry["url"]
+        url: entry["url"] || null
       });
     }
   }
@@ -2017,8 +2016,9 @@ ${todosSection}## Context
 - [Progress](./progress.md)
 - [Comments](./comments.md)
 - [Scratchpad](./scratchpad.md)
-- [Handoff](./handoff.md)
+- [Handoff](./handoff.md) \u2014 cross-ticket outbound
 - [Decision Record](./decision-record.md)
+- [Sessions](./sessions/) \u2014 per-session continuity summaries (one \`<session-id>/summary.md\` per session)
 `;
 }
 var init_assignment = __esm({
@@ -2072,6 +2072,13 @@ var init_handoff = __esm({
   }
 });
 
+// src/templates/session-summary.ts
+var init_session_summary = __esm({
+  "src/templates/session-summary.ts"() {
+    "use strict";
+  }
+});
+
 // src/templates/progress.ts
 function renderProgress(params2) {
   return `---
@@ -2322,8 +2329,11 @@ You are working within the Syntaur protocol for multi-agent project coordination
           progress.md        # Agent-writable, append-only: timestamped progress log
           comments.md        # CLI-mediated: threaded questions/notes/feedback (via \`syntaur comment\`)
           scratchpad.md      # Agent-writable: working notes
-          handoff.md         # Agent-writable: append-only handoff log
+          handoff.md         # Agent-writable: append-only cross-ticket outbound at completion
           decision-record.md # Agent-writable: append-only decision log
+          sessions/
+            <session-id>/
+              summary.md     # Agent-writable: per-session continuity (single doc, overwritten)
       resources/
         _index.md            # Derived (read-only)
         <resource-slug>.md   # Shared-writable
@@ -2339,13 +2349,15 @@ You are working within the Syntaur protocol for multi-agent project coordination
       scratchpad.md
       handoff.md
       decision-record.md
+      sessions/<session-id>/summary.md  # Per-session continuity (same as project-nested)
 \`\`\`
 
 ## Write Boundary Rules (CRITICAL)
 
 ### Files you may WRITE:
 1. **Your assignment folder** -- only the assignment you are currently working on:
-   - \`assignment.md\`, \`plan*.md\` (0 or more versioned plan files), \`progress.md\`, \`scratchpad.md\`, \`handoff.md\`, \`decision-record.md\`
+   - \`assignment.md\`, \`plan*.md\` (0 or more versioned plan files), \`progress.md\`, \`scratchpad.md\`, \`handoff.md\` (cross-ticket outbound at completion), \`decision-record.md\`
+   - \`sessions/<session-id>/summary.md\` -- per-session continuity (single doc per session id, overwritten on save). Distinct from \`handoff.md\`.
    - Path (project-nested): \`~/.syntaur/projects/<project>/assignments/<your-assignment>/\`
    - Path (standalone): \`~/.syntaur/assignments/<your-assignment-uuid>/\`
 2. **Shared resources and memories** at the project level:
@@ -2449,7 +2461,8 @@ Before starting work, read these files in order:
 3. any \`${params2.assignmentDir}/plan*.md\` files linked from active todos in the \`## Todos\` section (may be 0, 1, or many)
 4. \`${params2.assignmentDir}/progress.md\` -- reverse-chron progress log (if present)
 5. \`${params2.assignmentDir}/comments.md\` -- threaded questions/notes/feedback (if present)
-6. \`${params2.assignmentDir}/handoff.md\` -- previous session handoff notes
+6. \`${params2.assignmentDir}/handoff.md\` -- cross-ticket outbound history (entries from prior agents/humans handing this assignment off)
+7. The latest \`${params2.assignmentDir}/sessions/<sid>/summary.md\` if present -- previous-session continuity (selected by \`summary.md\` file mtime; read it for "what was done / what's next" before resuming work in flight)
 
 ## Your Writable Files
 
@@ -2460,6 +2473,7 @@ You may write directly to these files inside your assignment folder:
 - \`${params2.assignmentDir}/scratchpad.md\`
 - \`${params2.assignmentDir}/handoff.md\`
 - \`${params2.assignmentDir}/decision-record.md\`
+- \`${params2.assignmentDir}/sessions/<session-id>/summary.md\` (per-session continuity)
 
 Do NOT edit \`${params2.assignmentDir}/comments.md\` directly \u2014 use \`syntaur comment\`. Do NOT edit other assignments' files \u2014 use \`syntaur request\` for cross-assignment todos.
 
@@ -2495,7 +2509,8 @@ If the global Syntaur Codex plugin is installed, prefer these workflows instead
 - \`create-assignment\` -- create a new assignment (use \`--type <bug|feature|chore|...>\` to classify; use \`--one-off\` to create a standalone assignment at \`~/.syntaur/assignments/<uuid>/\` with no parent project)
 - \`grab-assignment\` -- claim work, create \`.syntaur/context.json\`, and register a session
 - \`plan-assignment\` -- write a versioned plan file (\`plan.md\`, \`plan-v2.md\`, ...) and link it from the \`## Todos\` section of \`assignment.md\`
-- \`complete-assignment\` -- append the handoff, append a final entry to \`progress.md\`, close the session, and transition state
+- \`complete-assignment\` -- write the cross-ticket \`handoff.md\` entry, append a final entry to \`progress.md\`, close the session, and transition state
+- \`save-session-summary\` -- write per-session continuity at \`<assignmentDir>/sessions/<sessionId>/summary.md\` for resume across sessions of the same agent. Codex has no \`PreCompact\` hook event \u2014 invoke this manually before compaction or session end.
 - \`track-session\` -- manage tracked tmux sessions for the dashboard
 
 If the plugin is unavailable, follow the same workflow manually with the \`syntaur\` CLI and keep the protocol files current yourself.
@@ -2509,7 +2524,8 @@ Before starting work, read these files in order:
 4. any \`${params2.assignmentDir}/plan*.md\` files linked from active todos in the \`## Todos\` section (may be 0, 1, or many)
 5. \`${params2.assignmentDir}/progress.md\` -- reverse-chron progress log (if present)
 6. \`${params2.assignmentDir}/comments.md\` -- threaded questions/notes/feedback (if present)
-7. \`${params2.assignmentDir}/handoff.md\` -- previous session handoff notes
+7. \`${params2.assignmentDir}/handoff.md\` -- cross-ticket outbound history (entries from prior agents/humans handing this assignment off)
+8. The latest \`${params2.assignmentDir}/sessions/<sid>/summary.md\` if present -- previous-session continuity (read it for "what was done / what's next" before resuming work in flight)
 
 ## Context File
 
@@ -2537,8 +2553,11 @@ Before starting work, read these files in order:
           progress.md        # Agent-writable, append-only: timestamped progress log
           comments.md        # CLI-mediated: threaded questions/notes/feedback (via \`syntaur comment\`)
           scratchpad.md      # Agent-writable: working notes
-          handoff.md         # Agent-writable: append-only handoff log
+          handoff.md         # Agent-writable: append-only cross-ticket outbound at completion
           decision-record.md # Agent-writable: append-only decision log
+          sessions/
+            <session-id>/
+              summary.md     # Agent-writable: per-session continuity (single doc, overwritten)
       resources/
         _index.md            # Derived (read-only)
         <resource-slug>.md   # Shared-writable
@@ -2554,13 +2573,15 @@ Before starting work, read these files in order:
       scratchpad.md
       handoff.md
       decision-record.md
+      sessions/<session-id>/summary.md  # Per-session continuity (same as project-nested)
 \`\`\`
 
 ## Write Boundary Rules (CRITICAL)
 
 ### Files you may WRITE:
 1. **Your assignment folder** -- only the assignment you are currently working on:
-   - \`assignment.md\`, \`plan*.md\` (0 or more versioned plan files), \`progress.md\`, \`scratchpad.md\`, \`handoff.md\`, \`decision-record.md\`
+   - \`assignment.md\`, \`plan*.md\` (0 or more versioned plan files), \`progress.md\`, \`scratchpad.md\`, \`handoff.md\` (cross-ticket outbound at completion), \`decision-record.md\`
+   - \`sessions/<session-id>/summary.md\` -- per-session continuity (single doc per session id, overwritten on save). Distinct from \`handoff.md\`.
    - Path: \`${params2.assignmentDir}/\`
 2. **Shared resources and memories** at the project level:
    - \`${params2.projectDir}/resources/<slug>.md\`
@@ -2639,7 +2660,7 @@ Read each linked playbook and follow the rules in its body section. The \`when_t
 - Slugs are lowercase, hyphen-separated. For standalone assignments, \`slug\` is display-only; the folder is named by the UUID.
 - Always read \`project.md\` at the project level (when project-nested) before starting work.
 - Keep \`assignment.md\` acceptance criteria and \`## Todos\` updated as work lands; append timestamped entries to \`progress.md\` (never to \`assignment.md\`).
-- Keep active plan file(s) current after planning changes and \`handoff.md\` current before leaving the task.
+- Keep active plan file(s) current after planning changes. Write \`handoff.md\` (via \`complete-assignment\`) at the cross-ticket boundary; write \`sessions/<sid>/summary.md\` (via \`/save-session-summary\`) before compaction or before ending a session mid-assignment so a future session can resume cleanly.
 - When requirements shift, supersede the prior plan todo (\`- [x] ~~...~~ (superseded by plan-v<N>)\`) and write a new plan file instead of rewriting the old one.
 - Record questions, notes, and feedback via \`syntaur comment\`. Never edit \`comments.md\` directly. Resolve questions via the dashboard UI (toggle on the question entry).
 - To route work to another assignment, use \`syntaur request\`.
@@ -2683,6 +2704,7 @@ var init_templates = __esm({
     init_plan();
     init_scratchpad();
     init_handoff();
+    init_session_summary();
     init_progress();
     init_comments();
     init_decision_record();
@@ -2998,7 +3020,7 @@ function extractFrontmatter2(fileContent) {
 }
 function parseSimpleValue2(raw) {
   const trimmed = raw.trim();
-  if (trimmed === "null") return null;
+  if (trimmed === "null" || trimmed === "~" || trimmed === "") return null;
   if (trimmed.startsWith('"') && trimmed.endsWith('"') || trimmed.startsWith("'") && trimmed.endsWith("'")) {
     return trimmed.slice(1, -1);
   }
@@ -3046,16 +3068,14 @@ function parseExternalIds2(frontmatter) {
       const colonIdx = line.indexOf(":");
       if (colonIdx < 0) continue;
       const key = line.slice(0, colonIdx).trim().replace(/^-\s+/, "");
-      const value = line.slice(colonIdx + 1).trim();
-      if (key && value) {
-        entry[key] = value;
-      }
+      if (!key) continue;
+      entry[key] = parseSimpleValue2(line.slice(colonIdx + 1));
     }
-    if (entry["system"] && entry["id"] && entry["url"]) {
+    if (entry["system"] && entry["id"]) {
       results.push({
         system: entry["system"],
         id: entry["id"],
-        url: entry["url"]
+        url: entry["url"] || null
       });
     }
   }
@@ -4799,6 +4819,7 @@ async function getProjectDetail(projectsDir2, slug) {
     created: project.created,
     updated,
     tags: project.tags,
+    externalIds: project.externalIds,
     body: project.body,
     progress: rollup.progress,
     needsAttention: rollup.needsAttention,
@@ -13258,12 +13279,18 @@ var REQUIRED_SKILLS = [
   "plan-assignment",
   "complete-assignment",
   "create-assignment",
-  "create-project"
+  "create-project",
+  "save-session-summary"
 ];
 function getVendoredSkillsDir() {
   const here = dirname9(fileURLToPath4(import.meta.url));
   return resolve26(here, "..", "vendor", "syntaur-skills", "skills");
 }
+function getPlatformSkillsDir(target) {
+  const here = dirname9(fileURLToPath4(import.meta.url));
+  const kind = target === "claude" ? "claude-code" : "codex";
+  return resolve26(here, "..", "platforms", kind, "skills");
+}
 function defaultSkillTargetDir(target) {
   if (target === "claude") return resolve26(homedir3(), ".claude", "skills");
   return resolve26(homedir3(), ".codex", "skills");
@@ -13318,8 +13345,24 @@ async function skillMatches(srcDir, destDir) {
   if (destFiles.length !== srcFiles.length) return false;
   return true;
 }
+async function installSkillDir(srcDir, destDir, skillName, source, force) {
+  if (!await fileExists(destDir)) {
+    await copyDir(srcDir, destDir);
+    return { skill: skillName, status: "installed", targetPath: destDir, source };
+  }
+  if (await skillMatches(srcDir, destDir)) {
+    return { skill: skillName, status: "already-current", targetPath: destDir, source };
+  }
+  if (force) {
+    await rm4(destDir, { recursive: true, force: true });
+    await copyDir(srcDir, destDir);
+    return { skill: skillName, status: "overwritten", targetPath: destDir, source };
+  }
+  return { skill: skillName, status: "differs-preserved", targetPath: destDir, source };
+}
 async function installSkills(options) {
   const source = options.sourceDir ?? getVendoredSkillsDir();
+  const platformSource = options.platformSkillsDir ?? getPlatformSkillsDir(options.target);
   const targetRoot = options.targetDir ?? defaultSkillTargetDir(options.target);
   const force = options.force ?? false;
   if (!await fileExists(source)) {
@@ -13331,39 +13374,19 @@ async function installSkills(options) {
   await mkdir4(targetRoot, { recursive: true });
   for (const skill of REQUIRED_SKILLS) {
     const srcDir = join3(source, skill);
-    const destDir = join3(targetRoot, skill);
     if (!await fileExists(srcDir)) continue;
-    if (!await fileExists(destDir)) {
-      await copyDir(srcDir, destDir);
-      results.push({
-        skill,
-        status: "installed",
-        targetPath: destDir
-      });
-      continue;
-    }
-    if (await skillMatches(srcDir, destDir)) {
-      results.push({
-        skill,
-        status: "already-current",
-        targetPath: destDir
-      });
-      continue;
-    }
-    if (force) {
-      await rm4(destDir, { recursive: true, force: true });
-      await copyDir(srcDir, destDir);
-      results.push({
-        skill,
-        status: "overwritten",
-        targetPath: destDir
-      });
-    } else {
-      results.push({
-        skill,
-        status: "differs-preserved",
-        targetPath: destDir
-      });
+    const destDir = join3(targetRoot, skill);
+    results.push(await installSkillDir(srcDir, destDir, skill, "shared", force));
+  }
+  if (options.target === "claude" && await fileExists(platformSource)) {
+    const entries = await readdir11(platformSource, { withFileTypes: true });
+    for (const entry of entries) {
+      if (!entry.isDirectory()) continue;
+      const skill = entry.name;
+      if (REQUIRED_SKILLS.includes(skill)) continue;
+      const srcDir = join3(platformSource, skill);
+      const destDir = join3(targetRoot, skill);
+      results.push(await installSkillDir(srcDir, destDir, skill, "platform", force));
     }
   }
   return results;
@@ -13371,8 +13394,16 @@ async function installSkills(options) {
 async function uninstallSkills(options) {
   const targetRoot = options.targetDir ?? defaultSkillTargetDir(options.target);
   if (!await fileExists(targetRoot)) return [];
+  const known = new Set(REQUIRED_SKILLS);
+  const platformSource = options.platformSkillsDir ?? getPlatformSkillsDir(options.target);
+  if (options.target === "claude" && await fileExists(platformSource)) {
+    const entries = await readdir11(platformSource, { withFileTypes: true });
+    for (const entry of entries) {
+      if (entry.isDirectory()) known.add(entry.name);
+    }
+  }
   const removed = [];
-  for (const skill of REQUIRED_SKILLS) {
+  for (const skill of known) {
     const destDir = join3(targetRoot, skill);
     if (!await fileExists(destDir)) continue;
     const skillMd = join3(destDir, "SKILL.md");
@@ -13506,9 +13537,10 @@ async function installPluginCommand(options) {
     }
   }
   console.log("\nThe plugin is now available in Claude Code.");
-  console.log("  Slash commands: /grab-assignment, /plan-assignment, /complete-assignment, /create-assignment, /create-project");
+  console.log("  Slash commands: /grab-assignment, /plan-assignment, /complete-assignment, /create-assignment, /create-project, /track-session, /save-session-summary");
   console.log("  Background: syntaur-protocol skill (auto-invoked)");
-  console.log("  Hook: write boundary enforcement (PreToolUse) + SessionStart/End");
+  console.log("  Claude-specific skill: track-session (agent session registration)");
+  console.log("  Hook: write boundary enforcement (PreToolUse) + SessionStart/End + PreCompact (prompts /save-session-summary)");
 }
 
 // src/commands/install-statusline.ts
@@ -14058,9 +14090,10 @@ async function installCodexPluginCommand(options) {
   }
   console.log("\nThe plugin is now available to Codex.");
   console.log(
-    "  Protocol skills: syntaur-protocol, create-project, create-assignment, grab-assignment, plan-assignment, complete-assignment"
+    "  Protocol skills: syntaur-protocol, create-project, create-assignment, grab-assignment, plan-assignment, complete-assignment, save-session-summary"
   );
   console.log("  Codex-specific: track-session skill (rollout path aware)");
+  console.log("  Slash commands: /track-session, /save-session-summary (no PreCompact hook on Codex \u2014 invoke manually before compaction)");
   console.log("  Hooks: write boundary enforcement, session cleanup");
 }