omni-pi 0.1.0

package/src/sync.ts

@@ -0,0 +1,70 @@
+import { readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+
+export interface SyncRequest {
+  summary: string;
+  decisions?: string[];
+  nextHandoffNotes?: string[];
+}
+
+async function appendBullets(
+  filePath: string,
+  heading: string,
+  bullets: string[],
+): Promise<void> {
+  if (bullets.length === 0) {
+    return;
+  }
+
+  const content = await readFile(filePath, "utf8");
+  const escapedHeading = heading.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&");
+  const sectionRegex = new RegExp(
+    `(${escapedHeading}\\n\\n)([\\s\\S]*?)(?=\\n## |$)`,
+    "u",
+  );
+  const match = content.match(sectionRegex);
+  if (!match) {
+    await writeFile(
+      filePath,
+      `${content.trimEnd()}\n\n${heading}\n\n${bullets.map((bullet) => `- ${bullet}`).join("\n")}\n`,
+      "utf8",
+    );
+    return;
+  }
+
+  const prefix = match[1];
+  const body = match[2].trimEnd();
+  const merged = [body, ...bullets.map((bullet) => `- ${bullet}`)]
+    .filter(Boolean)
+    .join("\n");
+  await writeFile(
+    filePath,
+    content.replace(sectionRegex, `${prefix}${merged}\n`),
+    "utf8",
+  );
+}
+
+export async function syncOmniMemory(
+  rootDir: string,
+  request: SyncRequest,
+): Promise<void> {
+  const sessionPath = path.join(rootDir, ".omni", "SESSION-SUMMARY.md");
+  const decisionsPath = path.join(rootDir, ".omni", "DECISIONS.md");
+
+  await appendBullets(sessionPath, "## Recent progress", [request.summary]);
+  await appendBullets(
+    sessionPath,
+    "## Next handoff notes",
+    request.nextHandoffNotes ?? [],
+  );
+
+  if (request.decisions && request.decisions.length > 0) {
+    const decisionLines = request.decisions.map(
+      (decision) =>
+        `Date: pending\n  - Decision: ${decision}\n  - Why: Captured during sync.\n  - Impact: To be refined.`,
+    );
+    const content = await readFile(decisionsPath, "utf8");
+    const next = `${content.trimEnd()}\n${decisionLines.map((line) => `\n- ${line}`).join("\n")}\n`;
+    await writeFile(decisionsPath, next, "utf8");
+  }
+}

package/src/tasks.ts

@@ -0,0 +1,141 @@
+import { readFile, writeFile } from "node:fs/promises";
+
+import type { TaskBrief, TaskStatus } from "./contracts.js";
+
+export function escapeTaskTableCell(value: string): string {
+  return value.replaceAll("\\", "\\\\").replaceAll("|", "\\|");
+}
+
+function unescapeTaskTableCell(value: string): string {
+  return value.replace(/\\([\\|])/gu, "$1");
+}
+
+function splitMarkdownTableRow(row: string): string[] {
+  const columns: string[] = [];
+  let current = "";
+  let escaped = false;
+
+  for (const char of row) {
+    if (escaped) {
+      current += `\\${char}`;
+      escaped = false;
+      continue;
+    }
+
+    if (char === "\\") {
+      escaped = true;
+      continue;
+    }
+
+    if (char === "|") {
+      columns.push(current.trim());
+      current = "";
+      continue;
+    }
+
+    current += char;
+  }
+
+  if (escaped) {
+    current += "\\";
+  }
+
+  columns.push(current.trim());
+  return columns;
+}
+
+export function parseTaskRow(row: string): TaskBrief | null {
+  const columns = splitMarkdownTableRow(row)
+    .slice(1, -1)
+    .map(unescapeTaskTableCell);
+
+  if (columns.length !== 6) {
+    return null;
+  }
+
+  const [id, title, role, dependsOn, status, doneCriteria] = columns;
+  return {
+    id,
+    title,
+    objective: title,
+    contextFiles: [],
+    skills: [],
+    doneCriteria:
+      doneCriteria === "-"
+        ? []
+        : doneCriteria
+            .split(";")
+            .map((item) => item.trim())
+            .filter(Boolean),
+    role: role === "expert" ? "expert" : "worker",
+    status: (status as TaskStatus) || "todo",
+    dependsOn:
+      dependsOn === "-"
+        ? []
+        : dependsOn
+            .split(",")
+            .map((item) => item.trim())
+            .filter(Boolean),
+  };
+}
+
+export async function readTasks(taskPath: string): Promise<TaskBrief[]> {
+  const content = await readFile(taskPath, "utf8");
+  return content
+    .split("\n")
+    .filter((line) => line.startsWith("| T"))
+    .map(parseTaskRow)
+    .filter((task): task is TaskBrief => task !== null);
+}
+
+export function renderTaskTable(tasks: TaskBrief[]): string {
+  const rows = tasks.map((task) => {
+    const dependsOn =
+      task.dependsOn.length > 0 ? task.dependsOn.join(", ") : "-";
+    const doneCriteria =
+      task.doneCriteria.length > 0 ? task.doneCriteria.join("; ") : "-";
+    return `| ${escapeTaskTableCell(task.id)} | ${escapeTaskTableCell(task.title)} | ${escapeTaskTableCell(task.role)} | ${escapeTaskTableCell(dependsOn)} | ${escapeTaskTableCell(task.status)} | ${escapeTaskTableCell(doneCriteria)} |`;
+  });
+
+  return `# Tasks
+
+## Task slices
+
+| ID | Title | Role | Depends On | Status | Done Criteria |
+| --- | --- | --- | --- | --- | --- |
+${rows.join("\n")}
+`;
+}
+
+export async function writeTasks(
+  taskPath: string,
+  tasks: TaskBrief[],
+): Promise<void> {
+  await writeFile(taskPath, renderTaskTable(tasks), "utf8");
+}
+
+export function findNextExecutableTask(tasks: TaskBrief[]): TaskBrief | null {
+  const doneIds = new Set(
+    tasks.filter((task) => task.status === "done").map((task) => task.id),
+  );
+
+  for (const task of tasks) {
+    if (task.status !== "todo") {
+      continue;
+    }
+
+    if (task.dependsOn.every((dependency) => doneIds.has(dependency))) {
+      return task;
+    }
+  }
+
+  return null;
+}
+
+export function updateTaskStatus(
+  tasks: TaskBrief[],
+  taskId: string,
+  status: TaskStatus,
+): TaskBrief[] {
+  return tasks.map((task) => (task.id === taskId ? { ...task, status } : task));
+}

package/src/templates.ts

@@ -0,0 +1,261 @@
+import { OMNI_DIR } from "./contracts.js";
+
+export interface StarterFile {
+  path: string;
+  content: string;
+}
+
+export const starterFiles: StarterFile[] = [
+  {
+    path: `${OMNI_DIR}/PROJECT.md`,
+    content: `# Project
+
+## Goal
+
+Describe what this project should achieve.
+
+## Users
+
+- Primary users:
+- Secondary users:
+
+## Constraints
+
+- Technical constraints:
+- Product constraints:
+
+## Success Criteria
+
+- What does success look like?
+`,
+  },
+  {
+    path: `${OMNI_DIR}/IDEAS.md`,
+    content: `# Ideas
+
+## Active ideas
+
+-
+
+## Future ideas
+
+-
+
+## Parking lot
+
+-
+`,
+  },
+  {
+    path: `${OMNI_DIR}/DECISIONS.md`,
+    content: `# Decisions
+
+Record important choices here as the project evolves.
+
+## Entries
+
+- Date: YYYY-MM-DD
+  - Decision:
+  - Why:
+  - Impact:
+`,
+  },
+  {
+    path: `${OMNI_DIR}/STATE.md`,
+    content: `# State
+
+Current Phase: Understand
+Active Task: None
+Status Summary: Project initialized. Ready to capture goals and constraints.
+Blockers: None
+Next Step: Run /omni-plan after the initial project details are captured.
+`,
+  },
+  {
+    path: `${OMNI_DIR}/SKILLS.md`,
+    content: `# Skills
+
+## Installed
+
+- None yet
+
+## Recommended
+
+- None yet
+
+## Deferred
+
+- None yet
+
+## Rejected
+
+- None yet
+
+## Usage Notes
+
+- Record why a skill was installed, recommended, or skipped.
+`,
+  },
+  {
+    path: `${OMNI_DIR}/SPEC.md`,
+    content: `# Spec
+
+## Problem
+
+## Solution shape
+
+## Key workflows
+
+## Risks
+
+## Open questions
+`,
+  },
+  {
+    path: `${OMNI_DIR}/TASKS.md`,
+    content: `# Tasks
+
+## Task slices
+
+| ID | Title | Role | Depends On | Status | Done Criteria |
+| --- | --- | --- | --- | --- | --- |
+`,
+  },
+  {
+    path: `${OMNI_DIR}/TESTS.md`,
+    content: `# Tests
+
+## Project-wide checks
+
+-
+
+## Task-specific checks
+
+-
+
+## Retry policy
+
+- Worker retries before expert takeover: 2
+
+## Escalation threshold
+
+- Escalate after repeated failures or when the planner marks the task as high-risk.
+`,
+  },
+  {
+    path: `${OMNI_DIR}/SESSION-SUMMARY.md`,
+    content: `# Session Summary
+
+## Current understanding
+
+-
+
+## Recent progress
+
+-
+
+## Next handoff notes
+
+-
+`,
+  },
+  {
+    path: `${OMNI_DIR}/PROGRESS.md`,
+    content: `# Progress
+
+Ongoing log of project progress.
+
+`,
+  },
+  {
+    path: `${OMNI_DIR}/plans/INDEX.md`,
+    content: `# Plan Index
+
+| ID | Title | Status | Created | Completed |
+| --- | --- | --- | --- | --- |
+`,
+  },
+  {
+    path: `${OMNI_DIR}/research/README.md`,
+    content: `# Research
+
+Store external research summaries and package notes here.
+`,
+  },
+  {
+    path: `${OMNI_DIR}/specs/README.md`,
+    content: `# Specs
+
+Store versioned detailed specs here.
+`,
+  },
+  {
+    path: `${OMNI_DIR}/tasks/README.md`,
+    content: `# Task Artifacts
+
+Store per-task briefs, outputs, and failure histories here.
+`,
+  },
+  {
+    path: `.pi/agents/omni-worker.md`,
+    content: `---
+name: omni-worker
+description: Omni-Pi worker for bounded implementation tasks
+model: anthropic/claude-sonnet-4-5
+tools: read, grep, find, ls, bash, edit, write
+skill: omni-execution, omni-verification
+---
+
+You are Omni-Pi's worker subagent.
+
+Complete the assigned task directly, keep the scope tight, run the required checks when possible, and end with JSON only using this schema:
+
+{"summary":"...","verification":{"passed":true,"checksRun":["..."],"failureSummary":[],"retryRecommended":false}}
+`,
+  },
+  {
+    path: `.pi/agents/omni-planner.md`,
+    content: `---
+name: omni-planner
+description: Omni-Pi planner for spec decomposition and task breakdown
+model: openai/gpt-5.4
+tools: read, grep, find, ls
+skill: omni-planning
+---
+
+You are Omni-Pi's planner subagent.
+
+Analyze the project context, produce or refine .omni/SPEC.md, break work into bounded task slices in .omni/TASKS.md, and define verification criteria in .omni/TESTS.md. Keep tasks small enough that a single worker session can complete each one.
+`,
+  },
+  {
+    path: `.pi/agents/omni-brain.md`,
+    content: `---
+name: omni-brain
+description: Omni-Pi brain for user-facing orchestration and progress updates
+model: anthropic/claude-opus-4-6
+tools: read, grep, find, ls, bash
+skill: omni-planning, omni-execution, omni-verification
+---
+
+You are Omni-Pi's brain — the user-facing orchestrator. Speak in plain English, give progress updates, decide when to invoke the planner, worker, or expert, and keep .omni/STATE.md current.
+`,
+  },
+  {
+    path: `.pi/agents/omni-expert.md`,
+    content: `---
+name: omni-expert
+description: Omni-Pi expert for escalated implementation tasks
+model: anthropic/claude-opus-4-1
+tools: read, grep, find, ls, bash, edit, write
+skill: omni-escalation, omni-verification
+---
+
+You are Omni-Pi's expert subagent.
+
+Take over difficult or repeatedly failing tasks, fix the root cause, run the required checks when possible, and end with JSON only using this schema:
+
+{"summary":"...","verification":{"passed":true,"checksRun":["..."],"failureSummary":[],"retryRecommended":false}}
+`,
+  },
+];