@atolis-hq/wake 0.1.21 → 0.1.23

package/README.md

@@ -1,4 +1,48 @@
-# Wake
+<div align="center">
+
+
+  <img src="https://raw.githubusercontent.com/atolis-hq/wake/refs/heads/main/assets/wake-logo.svg" alt="logo" width="200" height="auto" />
+  <h1>Wake</h1>
+  
+  <p>
+    Autonomous software engineering control plane
+  </p>
+  
+  
+<!-- Badges -->
+<p>
+  <a href="https://github.com/atolis-hq/wake/commits/main">
+    <img src="https://img.shields.io/github/last-commit/atolis-hq/wake" alt="last update" />
+  </a>
+  <a href="https://github.com/atolis-hq/wake/actions/workflows/ci-cd.yml">
+    <img src="https://github.com/atolis-hq/wake/actions/workflows/ci-cd.yml/badge.svg" alt="CI/CD status" />
+  </a>
+  <!-- <a href="https://github.com/atolis-hq/wake/network/members">
+    <img src="https://img.shields.io/github/forks/atolis-hq/wake" alt="forks" />
+  </a>
+  <a href="https://github.com/atolis-hq/wake/stargazers">
+    <img src="https://img.shields.io/github/stars/atolis-hq/wake" alt="stars" />
+  </a> -->
+  <a href="https://github.com/atolis-hq/wake/issues/">
+    <img src="https://img.shields.io/github/issues/atolis-hq/wake" alt="open issues" />
+  </a>
+  <a href="https://github.com/atolis-hq/wake/blob/main/LICENSE">
+    <img src="https://img.shields.io/github/license/atolis-hq/wake.svg" alt="license" />
+  </a>
+  <a href="https://github.com/atolis-hq/wake/tags">
+    <img src="https://img.shields.io/github/v/tag/atolis-hq/wake" alt="latest tag" />
+  </a>
+  <a href="https://www.npmjs.com/package/@atolis-hq/wake">
+    <img src="https://img.shields.io/npm/v/%40atolis-hq%2Fwake" alt="npm version" />
+  </a>
+  <a href="docker/Dockerfile">
+    <img src="https://img.shields.io/badge/sandbox-docker-2496ED?logo=docker&logoColor=white" alt="runs in docker" />
+  </a>
+</p>
+</div>
+
+<br />
+
 
 Wake is a control plane for autonomous software engineering. It watches the
 channels your team already uses, coordinates agent activity and involves humans
@@ -10,7 +54,20 @@ asks for input when human judgment matters, proposes a plan, launches local
 coding-agent CLIs to implement changes, opens pull requests, and carries the
 conversation forward wherever the work is already happening.
 
-Wake owns coordination. Coding agents execute the work.
+
+## Table of Contents
+
+- [The Problem](#the-problem)
+- [Vision](#vision)
+- [Feature Overview](#feature-overview)
+- [Where the Work Happens](#where-the-work-happens)
+- [Supported Agent CLIs](#supported-agent-clis)
+- [Getting Started](#getting-started)
+- [Development](#development)
+- [Documentation](#documentation)
+- [Issues & Feature Requests](#issues--feature-requests)
+- [License](#license)
+
 
 ## The Problem
 
@@ -75,6 +132,34 @@ For more detail, see [docs/vision.md](docs/vision.md) and
 Current runner capability differences are documented in
 [docs/runner-comparison.md](docs/runner-comparison.md).
 
+## Where the Work Happens
+
+Wake has no chat UI you need to check for status. Your ticketing system is the
+interface: Wake posts progress updates, asks clarifying questions, and reports
+results as comments on the ticket, and reflects stage and status as labels on
+it. When it's ready, it opens a pull request against your repo the normal way.
+Reviewing, approving, and merging happen exactly where they already do today —
+nothing new to learn, no separate dashboard to babysit.
+
+A local control-plane UI exists for operators who want to watch runs, inspect
+events, or resume a session directly, but it's a window into the same state —
+not a required part of the workflow.
+
+## Supported Agent CLIs
+
+Wake wraps existing coding-agent CLIs rather than replacing them. Runner
+adapters currently exist for:
+
+- **[Claude Code](https://claude.com/claude-code)**
+- **[Codex](https://openai.com/codex/)**
+- **[Cursor](https://cursor.com/cli)**
+
+Each runner sits behind the same `AgentRunner` contract, so Wake's routing,
+lifecycle, and sandbox behavior stay the same regardless of which CLI executes
+a given step. A fake runner adapter also exists for zero-token testing of the
+control plane itself. See [docs/runner-comparison.md](docs/runner-comparison.md)
+for capability differences between runners.
+
 ## Getting Started
 
 Wake is distributed as the `@atolis-hq/wake` npm package. You can run the CLI
@@ -143,3 +228,23 @@ Recommended local practices:
 
 Local setup, commands, sandbox operation, auth setup, UI notes, and GitHub
 polling details are documented in [docs/development.md](docs/development.md).
+
+## Documentation
+
+- [docs/vision.md](docs/vision.md) — the rationale and long-term direction for Wake.
+- [docs/architecture.md](docs/architecture.md) — module boundaries and the event-sourced core.
+- [docs/implementation.md](docs/implementation.md) — the accepted implementation plan.
+- [docs/workflows.md](docs/workflows.md) — how stages, prompts, and runner routes are configured.
+- [docs/prompts.md](docs/prompts.md) — how prompt templates map to workflow stages.
+- [docs/configuration.md](docs/configuration.md) — `config.json` options and the operator correlation escape hatch.
+- [docs/development.md](docs/development.md) — local setup and sandbox development workflow.
+- [docs/runner-comparison.md](docs/runner-comparison.md) — capability differences between supported runners.
+
+## Issues & Feature Requests
+
+Found a bug or have an idea for Wake? [Open an issue](https://github.com/atolis-hq/wake/issues/new) —
+bug reports and feature requests are both welcome.
+
+## License
+
+Wake is licensed under the [Apache License 2.0](LICENSE).

package/dist/src/adapters/http/ui-assets.js

@@ -35,6 +35,9 @@ export const indexHtml = `<!DOCTYPE html>
   .topbar .version { color: rgba(255, 255, 255, 0.7); font-size: 0.78rem; }
   .statusbar { display: flex; align-items: center; gap: 1rem; padding: 0.45rem 1rem; background: var(--brand-dark); border-top: 1px solid rgba(0, 0, 0, 0.18); flex-wrap: wrap; font-size: 0.8rem; }
   .statusbar .meta { color: rgba(255, 255, 255, 0.72); }
+  .statusbar button { background: rgba(255, 255, 255, 0.08); border: 1px solid rgba(255, 255, 255, 0.18); color: #fff; border-radius: 6px; padding: 0.22rem 0.55rem; cursor: pointer; font-size: 0.78rem; }
+  .statusbar button:hover:not(:disabled) { border-color: var(--accent-light); background: rgba(45, 212, 191, 0.16); }
+  .statusbar button:disabled { cursor: wait; opacity: 0.62; }
   .pill { padding: 0.15rem 0.5rem; border-radius: 999px; font-size: 0.75rem; font-weight: 600; }
   .pill-idle { background: #1f3d2c; color: #7fe3a3; }
   .pill-polling { background: #1f3350; color: #7fb3ff; }
@@ -80,6 +83,7 @@ export const indexHtml = `<!DOCTYPE html>
 </header>
 <div class="statusbar">
   <span id="loop-pill" class="pill">…</span>
+  <button id="force-tick" type="button">Tick now</button>
   <span id="status-summary" class="meta"></span>
 </div>
 <nav>
@@ -102,6 +106,12 @@ async function getJson(path) {
   return res.json();
 }
 
+async function postJson(path) {
+  const res = await fetch(API + path, { method: 'POST' });
+  if (!res.ok) throw new Error(path + ' -> ' + res.status);
+  return res.json();
+}
+
 function fmtMs(ms) {
   if (ms === undefined || ms === null) return '—';
   const s = Math.floor(ms / 1000);
@@ -142,6 +152,24 @@ async function renderStatusBar() {
   }
 }
 
+async function forceTickNow() {
+  const button = document.getElementById('force-tick');
+  button.disabled = true;
+  const original = button.textContent;
+  button.textContent = 'Requested';
+  try {
+    await postJson('/tick');
+    await renderStatusBar();
+  } catch (err) {
+    document.getElementById('status-summary').textContent = 'tick request failed: ' + err.message;
+  } finally {
+    setTimeout(() => {
+      button.disabled = false;
+      button.textContent = original;
+    }, 900);
+  }
+}
+
 async function renderBoard() {
   const board = await getJson('/board');
   const main = document.getElementById('main');
@@ -320,6 +348,7 @@ for (const btn of document.querySelectorAll('nav button')) {
 document.getElementById('drawer-close').addEventListener('click', () => {
   document.getElementById('drawer').classList.remove('open');
 });
+document.getElementById('force-tick').addEventListener('click', forceTickNow);
 
 renderStatusBar();
 switchView('board');

package/dist/src/adapters/http/ui-server.js

@@ -1,5 +1,7 @@
 import { createServer } from 'node:http';
+import { randomUUID } from 'node:crypto';
 import { configuredTicketSource } from '../../domain/sources.js';
+import { writeJsonFile } from '../../lib/json-file.js';
 import { indexHtml } from './ui-assets.js';
 import { buildBoard, buildConfigView, buildEventsFeed, buildHealth, buildItemDetail, buildRuns, buildStatus, buildWorkspaces, } from './ui-data.js';
 function sendJson(res, status, body) {
@@ -77,12 +79,6 @@ async function handleRequest(req, res, options, now) {
         res.writeHead(404).end('not found');
         return;
     }
-    if (req.method !== 'GET') {
-        sendJson(res, 405, {
-            error: 'this build only serves read endpoints; mutations are not implemented',
-        });
-        return;
-    }
     const { stateStore, resourceIndex, config } = options;
     const segments = url.pathname
         .slice('/api/v1/'.length)
@@ -90,6 +86,20 @@ async function handleRequest(req, res, options, now) {
         .filter((part) => part.length > 0)
         .map((s) => decodeURIComponent(s));
     const resource = segments[0];
+    if (req.method === 'POST' && resource === 'tick' && segments.length === 1) {
+        const request = {
+            requestId: randomUUID(),
+            requestedAt: now().toISOString(),
+            requestedBy: 'ui',
+        };
+        await writeJsonFile(stateStore.paths.tickRequestFile, request);
+        sendJson(res, 202, request);
+        return;
+    }
+    if (req.method !== 'GET') {
+        sendJson(res, 405, { error: `method not allowed for ${url.pathname}` });
+        return;
+    }
     if (resource === 'status' && segments.length === 1) {
         sendJson(res, 200, await buildStatus({ stateStore, config, now: now() }));
         return;

package/dist/src/core/control-plane.js

@@ -6,11 +6,43 @@ export function createControlPlane(deps) {
     let consecutiveIdleTicks = 0;
     let consecutiveIntakeIdleTicks = 0;
     let consecutiveRunnerIdleTicks = 0;
+    let lastSingleTickRequest;
+    let lastIntakeTickRequest;
+    let lastRunnerTickRequest;
     const maxIntervalMs = deps.maxIntervalMs ?? deps.intervalMs * 16;
     function nextSleepMs(consecutiveTicks) {
         const backoffMs = deps.intervalMs * 2 ** Math.min(consecutiveTicks, 20);
         return Math.min(backoffMs, maxIntervalMs);
     }
+    async function tickRequestPending(input) {
+        const request = (await deps.readTickRequest?.()) ?? null;
+        if (request === null || request === input.getLastRequest()) {
+            return false;
+        }
+        input.setLastRequest(request);
+        return true;
+    }
+    async function sleepUntilNextTick(ms, requestState) {
+        if (deps.readTickRequest === undefined || ms <= 0) {
+            await deps.sleep(ms);
+            return { forced: false };
+        }
+        if (await tickRequestPending(requestState)) {
+            return { forced: true };
+        }
+        const deadline = Date.now() + ms;
+        while (running) {
+            const remainingMs = deadline - Date.now();
+            if (remainingMs <= 0) {
+                return { forced: false };
+            }
+            await deps.sleep(Math.min(remainingMs, 250));
+            if (await tickRequestPending(requestState)) {
+                return { forced: true };
+            }
+        }
+        return { forced: false };
+    }
     async function isPaused() {
         return Boolean(await deps.isPaused());
     }
@@ -58,8 +90,13 @@ export function createControlPlane(deps) {
                 input.setIdleTicks(0);
             }
             else {
-                await deps.sleep(nextSleepMs(input.getIdleTicks()));
-                input.setIdleTicks(input.getIdleTicks() + 1);
+                const wait = await sleepUntilNextTick(nextSleepMs(input.getIdleTicks()), {
+                    getLastRequest: input.getLastRequest,
+                    setLastRequest: input.setLastRequest,
+                });
+                if (!wait.forced) {
+                    input.setIdleTicks(input.getIdleTicks() + 1);
+                }
             }
         }
     }
@@ -94,6 +131,10 @@ export function createControlPlane(deps) {
                         setIdleTicks: (value) => {
                             consecutiveIntakeIdleTicks = value;
                         },
+                        getLastRequest: () => lastIntakeTickRequest,
+                        setLastRequest: (value) => {
+                            lastIntakeTickRequest = value;
+                        },
                     }),
                     startLoop({
                         run: deps.tickRunner.runRunnerTick,
@@ -102,6 +143,10 @@ export function createControlPlane(deps) {
                         setIdleTicks: (value) => {
                             consecutiveRunnerIdleTicks = value;
                         },
+                        getLastRequest: () => lastRunnerTickRequest,
+                        setLastRequest: (value) => {
+                            lastRunnerTickRequest = value;
+                        },
                     }),
                 ]);
                 return;
@@ -122,8 +167,15 @@ export function createControlPlane(deps) {
                     consecutiveIdleTicks = 0;
                 }
                 else {
-                    await deps.sleep(nextSleepMs(consecutiveIdleTicks));
-                    consecutiveIdleTicks += 1;
+                    const wait = await sleepUntilNextTick(nextSleepMs(consecutiveIdleTicks), {
+                        getLastRequest: () => lastSingleTickRequest,
+                        setLastRequest: (value) => {
+                            lastSingleTickRequest = value;
+                        },
+                    });
+                    if (!wait.forced) {
+                        consecutiveIdleTicks += 1;
+                    }
                 }
             }
         },

package/dist/src/lib/paths.js

@@ -12,6 +12,7 @@ export function createWakePaths(wakeRoot) {
         configFile: join(wakeRoot, 'config.json'),
         ledgerFile: join(wakeRoot, 'ledger.json'),
         pauseFile: join(wakeRoot, 'PAUSE'),
+        tickRequestFile: join(wakeRoot, 'control', 'tick-request.json'),
         tickLockFile: join(wakeRoot, 'locks', 'tick.lock'),
         runnerLockFile: join(wakeRoot, 'locks', 'runner.lock'),
         issueFixtureFile: join(wakeRoot, 'fixtures', 'issues.json'),

package/dist/src/main.js

@@ -26,6 +26,7 @@ import { createControlPlane } from './core/control-plane.js';
 import { createOutboundSinkRouter, createWorkSourceFanIn } from './core/sink-router.js';
 import { createTickRunner } from './core/tick-runner.js';
 import { systemClock } from './lib/clock.js';
+import { readJsonFile } from './lib/json-file.js';
 import { configuredTicketSource } from './domain/sources.js';
 import { wakeVersion } from './version.js';
 function commandArgsBeforeTerminator(args) {
@@ -135,6 +136,17 @@ async function runCommandCapture(command, args) {
         });
     });
 }
+async function readTickRequestId(path) {
+    try {
+        const request = await readJsonFile(path);
+        return typeof request.requestId === 'string' && request.requestId.length > 0
+            ? request.requestId
+            : null;
+    }
+    catch {
+        return null;
+    }
+}
 async function inspectDockerImage(image) {
     return await new Promise((resolveInspect, reject) => {
         const child = spawn('docker', ['image', 'inspect', image], {
@@ -318,6 +330,9 @@ async function runStart(args) {
                 setTimeout(resolveSleep, ms);
             });
         },
+        readTickRequest() {
+            return readTickRequestId(runtime.stateStore.paths.tickRequestFile);
+        },
     });
     const stop = () => controlPlane.stop();
     process.on('SIGINT', stop);

package/dist/src/version.js

@@ -1 +1 @@
-export const wakeVersion = "0.1.21+g5f671ca";
+export const wakeVersion = "0.1.23+ge21a0d4";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atolis-hq/wake",
-  "version": "0.1.21",
+  "version": "0.1.23",
   "description": "Local autonomous agent control plane for software development",
   "license": "Apache-2.0",
   "repository": {