sisyphi 1.1.8 → 1.1.10

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/orchestrator-base.md

@@ -95,7 +95,7 @@ Every cycle, read strategy.md first. It tells you:
 **Strategy is a living document.** Update it when:
 - **The goal crystallizes** — you now see further ahead than when the strategy was written. Detail the next stage, flesh out "Ahead."
 - **The goal shifts** — new information changes what "done" looks like. Revise the affected stages.
-- **A stage completes** — compress it to a one-line summary with artifacts produced. Promote and detail the next stage.
+- **A stage completes** — delete it entirely and promote the next stage. Completed work belongs in cycle logs, not the strategy.
 - **The approach is wrong** — backtracking reveals a fundamental issue. Revise the strategy.
 
 Strategy updates happen every few cycles, not every cycle. The roadmap tracks cycle-to-cycle progress within a stage; the strategy tracks the shape of the work across stages.
@@ -113,6 +113,8 @@ You are respawned fresh each cycle — without roadmap.md, you'd have no idea wh
 3. **Active Context** — list of context files currently relevant to the work
 4. **Next Steps** — immediate actions for this and the next cycle
 
+**Delete completed items entirely.** Do not mark them done, check them off, or summarize them. Completed work belongs in cycle logs, not the roadmap. The roadmap should get shorter as work completes, not longer. No `[done]` markers, no phase summaries, no completion history.
+
 **Decisions do not go in the roadmap.** When exploration, review, or user feedback resolves a question or changes the approach, fold the result into the relevant context document (spec, plan, design) or create a new context file. The roadmap references these artifacts but never contains decision content, rationale, or design detail.
 
 **The roadmap is not an implementation plan.** Stage breakdowns, design decisions, and file-level detail live in `context/` files.
@@ -142,7 +144,7 @@ Status: iterating on design after review feedback
 - If clean, transition to plan stage
 ```
 
-**Remove completed context as stages finish** — the roadmap reflects outstanding work, not history.
+**Remove completed items as stages finish** — exit criteria that are met, context files that are no longer relevant, next steps that are done. The roadmap reflects only outstanding work.
 
 ### Cycle Logs — Audit trail (write-only)
 

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;
+}