sisyphi 1.1.7 → 1.1.9

package/dist/templates/begin.md

@@ -0,0 +1,22 @@
+---
+description: Hand off a task to sisyphus multi-agent orchestration
+---
+
+!`sisyphus -h`
+
+Run `sisyphus start` with a concise task/goal and optional background context:
+
+```bash
+sisyphus start "your task description" -c "background context"
+```
+
+**Task description** — the goal. Keep it focused: what needs to be built or fixed and what done looks like. This is the persistent objective the orchestrator sees every cycle.
+
+**Context (`-c`)** — background info that informs the work but isn't the goal itself: relevant file paths, constraints, specs, adjacent concerns, prior findings. Rendered separately so the orchestrator can reference it without confusing it with the task.
+
+**Context should be factual, not diagnostic.** Point to relevant files, areas of the codebase, and constraints — don't speculate on root causes or solutions, which can bias the orchestrator down the wrong path.
+
+**Example:**
+```bash
+sisyphus start "Fix the JWT refresh bug — app shows blank screen on token expiry instead of redirecting to login" -c "Auth system lives in src/auth/. Key files: interceptor.ts (HTTP interceptor), token-store.ts (token persistence), refresh.ts (refresh flow). Tests in src/auth/__tests__/. Don't break the logout flow."
+```

package/dist/templates/nvim-tutorial.txt

@@ -0,0 +1,68 @@
+Welcome to Neovim!
+===================
+
+You're looking at this file in nvim. Right now you're in NORMAL MODE.
+That means keys are commands, not text. Let's learn the basics.
+
+
+--- MOVING AROUND (Normal Mode) ---
+
+Try these now:
+  gg        Jump to the top of this file
+  G         Jump to the bottom of this file
+  Ctrl+u    Scroll up half a page
+  Ctrl+d    Scroll down half a page
+  /Welcome  Search for "Welcome" (press Enter, then n for next match)
+
+Arrow keys work too, but h/j/k/l are the vim way:
+  h = left    j = down    k = up    l = right
+
+
+--- ENTERING INSERT MODE ---
+
+Press i right now. You should see -- INSERT -- at the bottom.
+Now you can type normally! Try typing something on the line below:
+
+> [type here]
+
+Press Esc when you're done to go back to normal mode.
+
+Other ways to enter insert mode:
+  i    Insert at cursor
+  a    Insert after cursor
+  o    Open new line below and insert
+  O    Open new line above and insert
+
+
+--- PRACTICE: EDIT THIS SECTION ---
+
+Fix the typos below (hint: navigate to the typo, press i, fix it, press Esc):
+
+  1. The quikc brown fox jumps over the lazy dog.
+  2. Sisyphus is a multi-agnet orchestrator.
+  3. Tmux lets you spilt your terminal into panes.
+
+
+--- SAVING AND QUITTING ---
+
+You're almost done! Here's how to get out:
+
+  :w  Enter     Save the file (write)
+  :q  Enter     Quit (fails if unsaved changes)
+  :wq Enter     Save and quit
+  :q! Enter     Quit WITHOUT saving
+  ZZ            Shortcut for save and quit (Shift+z twice)
+
+Try it now: type :wq and press Enter to save your changes and close nvim.
+The pane will close automatically and you'll be back in Claude.
+
+
+--- BONUS (optional) ---
+
+  u         Undo last change
+  Ctrl+r    Redo
+  dd        Delete entire line
+  yy        Copy (yank) entire line
+  p         Paste below cursor
+  :123      Jump to line 123
+  *         Search for the word under cursor

package/dist/templates/tutorial-demo/CLAUDE.md

@@ -0,0 +1,14 @@
+# Todo App
+
+A minimal Node.js todo API. No dependencies — just `node:http` and `node:test`.
+
+## Commands
+```bash
+node server.js       # Start the API on port 3456
+node --test test.js  # Run tests
+```
+
+## Structure
+- `todo.js` — In-memory todo store (add, list, get, toggle, delete)
+- `server.js` — HTTP API server
+- `test.js` — Unit tests for the store

package/dist/templates/tutorial-demo/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "sisyphus-todo-demo",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "A minimal todo app — sisyphus tutorial demo",
+  "scripts": {
+    "start": "node server.js",
+    "test": "node --test test.js"
+  }
+}

package/dist/templates/tutorial-demo/server.js

@@ -0,0 +1,76 @@
+import { createServer } from 'node:http';
+import { addTodo, listTodos, getTodo, toggleTodo, deleteTodo } from './todo.js';
+
+const PORT = 3456;
+
+function parseBody(req) {
+  return new Promise((resolve) => {
+    let body = '';
+    req.on('data', (chunk) => (body += chunk));
+    req.on('end', () => {
+      try { resolve(JSON.parse(body)); }
+      catch { resolve({}); }
+    });
+  });
+}
+
+function json(res, status, data) {
+  res.writeHead(status, { 'Content-Type': 'application/json' });
+  res.end(JSON.stringify(data, null, 2));
+}
+
+const server = createServer(async (req, res) => {
+  const url = new URL(req.url, `http://localhost:${PORT}`);
+  const path = url.pathname;
+
+  // GET /todos
+  if (req.method === 'GET' && path === '/todos') {
+    return json(res, 200, listTodos());
+  }
+
+  // POST /todos
+  if (req.method === 'POST' && path === '/todos') {
+    const { title } = await parseBody(req);
+    if (!title) return json(res, 400, { error: 'title is required' });
+    return json(res, 201, addTodo(title));
+  }
+
+  // GET /todos/:id
+  const match = path.match(/^\/todos\/(\d+)$/);
+  if (match) {
+    const id = parseInt(match[1]);
+    if (req.method === 'GET') {
+      const todo = getTodo(id);
+      return todo ? json(res, 200, todo) : json(res, 404, { error: 'not found' });
+    }
+    // PATCH /todos/:id/toggle
+    if (req.method === 'PATCH' && path.endsWith('/toggle')) {
+      // BUG: this never matches because the regex above doesn't include /toggle
+    }
+    // DELETE /todos/:id
+    if (req.method === 'DELETE') {
+      return deleteTodo(id) ? json(res, 200, { deleted: true }) : json(res, 404, { error: 'not found' });
+    }
+  }
+
+  // PATCH /todos/:id/toggle
+  const toggleMatch = path.match(/^\/todos\/(\d+)\/toggle$/);
+  if (req.method === 'PATCH' && toggleMatch) {
+    const id = parseInt(toggleMatch[1]);
+    const todo = toggleTodo(id);
+    return todo ? json(res, 200, todo) : json(res, 404, { error: 'not found' });
+  }
+
+  json(res, 404, { error: 'not found' });
+});
+
+server.listen(PORT, () => {
+  console.log(`Todo API running at http://localhost:${PORT}`);
+  console.log('');
+  console.log('Endpoints:');
+  console.log('  GET    /todos          List all todos');
+  console.log('  POST   /todos          Create a todo (body: {"title": "..."})');
+  console.log('  GET    /todos/:id      Get a todo');
+  console.log('  PATCH  /todos/:id/toggle  Toggle done');
+  console.log('  DELETE /todos/:id      Delete a todo');
+});

package/dist/templates/tutorial-demo/test.js

@@ -0,0 +1,48 @@
+import { describe, it, beforeEach } from 'node:test';
+import assert from 'node:assert';
+import { addTodo, listTodos, getTodo, toggleTodo, deleteTodo, clearAll } from './todo.js';
+
+describe('todo store', () => {
+  beforeEach(() => clearAll());
+
+  it('adds a todo', () => {
+    const todo = addTodo('Buy milk');
+    assert.strictEqual(todo.title, 'Buy milk');
+    assert.strictEqual(todo.done, false);
+    assert.ok(todo.id);
+  });
+
+  it('lists todos', () => {
+    addTodo('First');
+    addTodo('Second');
+    assert.strictEqual(listTodos().length, 2);
+  });
+
+  it('gets a todo by id', () => {
+    const todo = addTodo('Find me');
+    assert.deepStrictEqual(getTodo(todo.id), todo);
+  });
+
+  it('returns null for missing todo', () => {
+    assert.strictEqual(getTodo(999), null);
+  });
+
+  it('toggles done status', () => {
+    const todo = addTodo('Toggle me');
+    assert.strictEqual(todo.done, false);
+    toggleTodo(todo.id);
+    assert.strictEqual(todo.done, true);
+    toggleTodo(todo.id);
+    assert.strictEqual(todo.done, false);
+  });
+
+  it('deletes a todo', () => {
+    const todo = addTodo('Delete me');
+    assert.strictEqual(deleteTodo(todo.id), true);
+    assert.strictEqual(listTodos().length, 0);
+  });
+
+  it('returns false when deleting nonexistent', () => {
+    assert.strictEqual(deleteTodo(999), false);
+  });
+});

package/dist/templates/tutorial-demo/todo.js

@@ -0,0 +1,35 @@
+// In-memory todo store
+const todos = [];
+let nextId = 1;
+
+export function addTodo(title) {
+  const todo = { id: nextId++, title, done: false, createdAt: new Date().toISOString() };
+  todos.push(todo);
+  return todo;
+}
+
+export function listTodos() {
+  return [...todos];
+}
+
+export function getTodo(id) {
+  return todos.find((t) => t.id === id) || null;
+}
+
+export function toggleTodo(id) {
+  const todo = getTodo(id);
+  if (todo) todo.done = !todo.done;
+  return todo;
+}
+
+export function deleteTodo(id) {
+  const idx = todos.findIndex((t) => t.id === id);
+  if (idx === -1) return false;
+  todos.splice(idx, 1);
+  return true;
+}
+
+export function clearAll() {
+  todos.length = 0;
+  nextId = 1;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sisyphi",
-  "version": "1.1.7",
+  "version": "1.1.9",
   "description": "tmux-integrated orchestration daemon for Claude Code multi-agent workflows",
   "license": "MIT",
   "repository": {

package/templates/begin.md

@@ -0,0 +1,22 @@
+---
+description: Hand off a task to sisyphus multi-agent orchestration
+---
+
+!`sisyphus -h`
+
+Run `sisyphus start` with a concise task/goal and optional background context:
+
+```bash
+sisyphus start "your task description" -c "background context"
+```
+
+**Task description** — the goal. Keep it focused: what needs to be built or fixed and what done looks like. This is the persistent objective the orchestrator sees every cycle.
+
+**Context (`-c`)** — background info that informs the work but isn't the goal itself: relevant file paths, constraints, specs, adjacent concerns, prior findings. Rendered separately so the orchestrator can reference it without confusing it with the task.
+
+**Context should be factual, not diagnostic.** Point to relevant files, areas of the codebase, and constraints — don't speculate on root causes or solutions, which can bias the orchestrator down the wrong path.
+
+**Example:**
+```bash
+sisyphus start "Fix the JWT refresh bug — app shows blank screen on token expiry instead of redirecting to login" -c "Auth system lives in src/auth/. Key files: interceptor.ts (HTTP interceptor), token-store.ts (token persistence), refresh.ts (refresh flow). Tests in src/auth/__tests__/. Don't break the logout flow."
+```

package/templates/nvim-tutorial.txt

@@ -0,0 +1,68 @@
+Welcome to Neovim!
+===================
+
+You're looking at this file in nvim. Right now you're in NORMAL MODE.
+That means keys are commands, not text. Let's learn the basics.
+
+
+--- MOVING AROUND (Normal Mode) ---
+
+Try these now:
+  gg        Jump to the top of this file
+  G         Jump to the bottom of this file
+  Ctrl+u    Scroll up half a page
+  Ctrl+d    Scroll down half a page
+  /Welcome  Search for "Welcome" (press Enter, then n for next match)
+
+Arrow keys work too, but h/j/k/l are the vim way:
+  h = left    j = down    k = up    l = right
+
+
+--- ENTERING INSERT MODE ---
+
+Press i right now. You should see -- INSERT -- at the bottom.
+Now you can type normally! Try typing something on the line below:
+
+> [type here]
+
+Press Esc when you're done to go back to normal mode.
+
+Other ways to enter insert mode:
+  i    Insert at cursor
+  a    Insert after cursor
+  o    Open new line below and insert
+  O    Open new line above and insert
+
+
+--- PRACTICE: EDIT THIS SECTION ---
+
+Fix the typos below (hint: navigate to the typo, press i, fix it, press Esc):
+
+  1. The quikc brown fox jumps over the lazy dog.
+  2. Sisyphus is a multi-agnet orchestrator.
+  3. Tmux lets you spilt your terminal into panes.
+
+
+--- SAVING AND QUITTING ---
+
+You're almost done! Here's how to get out:
+
+  :w  Enter     Save the file (write)
+  :q  Enter     Quit (fails if unsaved changes)
+  :wq Enter     Save and quit
+  :q! Enter     Quit WITHOUT saving
+  ZZ            Shortcut for save and quit (Shift+z twice)
+
+Try it now: type :wq and press Enter to save your changes and close nvim.
+The pane will close automatically and you'll be back in Claude.
+
+
+--- BONUS (optional) ---
+
+  u         Undo last change
+  Ctrl+r    Redo
+  dd        Delete entire line
+  yy        Copy (yank) entire line
+  p         Paste below cursor
+  :123      Jump to line 123
+  *         Search for the word under cursor

package/templates/tutorial-demo/CLAUDE.md

@@ -0,0 +1,14 @@
+# Todo App
+
+A minimal Node.js todo API. No dependencies — just `node:http` and `node:test`.
+
+## Commands
+```bash
+node server.js       # Start the API on port 3456
+node --test test.js  # Run tests
+```
+
+## Structure
+- `todo.js` — In-memory todo store (add, list, get, toggle, delete)
+- `server.js` — HTTP API server
+- `test.js` — Unit tests for the store

package/templates/tutorial-demo/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "sisyphus-todo-demo",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "A minimal todo app — sisyphus tutorial demo",
+  "scripts": {
+    "start": "node server.js",
+    "test": "node --test test.js"
+  }
+}

package/templates/tutorial-demo/server.js

@@ -0,0 +1,76 @@
+import { createServer } from 'node:http';
+import { addTodo, listTodos, getTodo, toggleTodo, deleteTodo } from './todo.js';
+
+const PORT = 3456;
+
+function parseBody(req) {
+  return new Promise((resolve) => {
+    let body = '';
+    req.on('data', (chunk) => (body += chunk));
+    req.on('end', () => {
+      try { resolve(JSON.parse(body)); }
+      catch { resolve({}); }
+    });
+  });
+}
+
+function json(res, status, data) {
+  res.writeHead(status, { 'Content-Type': 'application/json' });
+  res.end(JSON.stringify(data, null, 2));
+}
+
+const server = createServer(async (req, res) => {
+  const url = new URL(req.url, `http://localhost:${PORT}`);
+  const path = url.pathname;
+
+  // GET /todos
+  if (req.method === 'GET' && path === '/todos') {
+    return json(res, 200, listTodos());
+  }
+
+  // POST /todos
+  if (req.method === 'POST' && path === '/todos') {
+    const { title } = await parseBody(req);
+    if (!title) return json(res, 400, { error: 'title is required' });
+    return json(res, 201, addTodo(title));
+  }
+
+  // GET /todos/:id
+  const match = path.match(/^\/todos\/(\d+)$/);
+  if (match) {
+    const id = parseInt(match[1]);
+    if (req.method === 'GET') {
+      const todo = getTodo(id);
+      return todo ? json(res, 200, todo) : json(res, 404, { error: 'not found' });
+    }
+    // PATCH /todos/:id/toggle
+    if (req.method === 'PATCH' && path.endsWith('/toggle')) {
+      // BUG: this never matches because the regex above doesn't include /toggle
+    }
+    // DELETE /todos/:id
+    if (req.method === 'DELETE') {
+      return deleteTodo(id) ? json(res, 200, { deleted: true }) : json(res, 404, { error: 'not found' });
+    }
+  }
+
+  // PATCH /todos/:id/toggle
+  const toggleMatch = path.match(/^\/todos\/(\d+)\/toggle$/);
+  if (req.method === 'PATCH' && toggleMatch) {
+    const id = parseInt(toggleMatch[1]);
+    const todo = toggleTodo(id);
+    return todo ? json(res, 200, todo) : json(res, 404, { error: 'not found' });
+  }
+
+  json(res, 404, { error: 'not found' });
+});
+
+server.listen(PORT, () => {
+  console.log(`Todo API running at http://localhost:${PORT}`);
+  console.log('');
+  console.log('Endpoints:');
+  console.log('  GET    /todos          List all todos');
+  console.log('  POST   /todos          Create a todo (body: {"title": "..."})');
+  console.log('  GET    /todos/:id      Get a todo');
+  console.log('  PATCH  /todos/:id/toggle  Toggle done');
+  console.log('  DELETE /todos/:id      Delete a todo');
+});

package/templates/tutorial-demo/test.js

@@ -0,0 +1,48 @@
+import { describe, it, beforeEach } from 'node:test';
+import assert from 'node:assert';
+import { addTodo, listTodos, getTodo, toggleTodo, deleteTodo, clearAll } from './todo.js';
+
+describe('todo store', () => {
+  beforeEach(() => clearAll());
+
+  it('adds a todo', () => {
+    const todo = addTodo('Buy milk');
+    assert.strictEqual(todo.title, 'Buy milk');
+    assert.strictEqual(todo.done, false);
+    assert.ok(todo.id);
+  });
+
+  it('lists todos', () => {
+    addTodo('First');
+    addTodo('Second');
+    assert.strictEqual(listTodos().length, 2);
+  });
+
+  it('gets a todo by id', () => {
+    const todo = addTodo('Find me');
+    assert.deepStrictEqual(getTodo(todo.id), todo);
+  });
+
+  it('returns null for missing todo', () => {
+    assert.strictEqual(getTodo(999), null);
+  });
+
+  it('toggles done status', () => {
+    const todo = addTodo('Toggle me');
+    assert.strictEqual(todo.done, false);
+    toggleTodo(todo.id);
+    assert.strictEqual(todo.done, true);
+    toggleTodo(todo.id);
+    assert.strictEqual(todo.done, false);
+  });
+
+  it('deletes a todo', () => {
+    const todo = addTodo('Delete me');
+    assert.strictEqual(deleteTodo(todo.id), true);
+    assert.strictEqual(listTodos().length, 0);
+  });
+
+  it('returns false when deleting nonexistent', () => {
+    assert.strictEqual(deleteTodo(999), false);
+  });
+});

package/templates/tutorial-demo/todo.js

@@ -0,0 +1,35 @@
+// In-memory todo store
+const todos = [];
+let nextId = 1;
+
+export function addTodo(title) {
+  const todo = { id: nextId++, title, done: false, createdAt: new Date().toISOString() };
+  todos.push(todo);
+  return todo;
+}
+
+export function listTodos() {
+  return [...todos];
+}
+
+export function getTodo(id) {
+  return todos.find((t) => t.id === id) || null;
+}
+
+export function toggleTodo(id) {
+  const todo = getTodo(id);
+  if (todo) todo.done = !todo.done;
+  return todo;
+}
+
+export function deleteTodo(id) {
+  const idx = todos.findIndex((t) => t.id === id);
+  if (idx === -1) return false;
+  todos.splice(idx, 1);
+  return true;
+}
+
+export function clearAll() {
+  todos.length = 0;
+  nextId = 1;
+}