@atolis-hq/wake 0.2.97 → 0.3.1

package/dist/src/lib/paths.js

@@ -1,52 +0,0 @@
-import { join } from 'node:path';
-export function sanitizeRepo(repo) {
-    return repo.replace(/[\\/]/g, '__');
-}
-export function sanitizePathKey(value) {
-    return value.replace(/[^A-Za-z0-9._-]/g, '__');
-}
-export function createWakePaths(wakeRoot) {
-    const dataRoot = join(wakeRoot, '.wake');
-    return {
-        wakeRoot,
-        dataRoot,
-        containerHomeRoot: join(dataRoot, 'container-home'),
-        configFile: join(wakeRoot, 'config.yaml'),
-        workflowsConfigFile: join(wakeRoot, 'config.workflows.yaml'),
-        ledgerFile: join(dataRoot, 'ledger.json'),
-        pauseFile: join(dataRoot, 'PAUSE'),
-        tickRequestFile: join(dataRoot, 'control', 'tick-request.json'),
-        tickLockFile: join(dataRoot, 'locks', 'tick.lock'),
-        runnerLockFile: join(dataRoot, 'locks', 'runner.lock'),
-        issueFixtureFile: join(dataRoot, 'fixtures', 'issues.json'),
-        workspaceRoot: join(wakeRoot, 'workspaces'),
-        transcriptsRoot: join(dataRoot, 'transcripts'),
-        reposRoot: join(dataRoot, 'repos'),
-        repoRoot: (repo) => join(dataRoot, 'repos', sanitizeRepo(repo)),
-        sourceStateRoot: join(dataRoot, 'sources'),
-        // Keyed on the minted work id, which is filename-safe by construction
-        // (src/lib/work-id.ts) — hence no sanitizePathKey here. No durable path
-        // embeds a provider, repo, or issue segment (spec §3).
-        workItemStateFile: (workId) => join(dataRoot, 'state', `${workId}.json`),
-        archivedWorkItemStateFile: (workId) => join(dataRoot, 'state', 'archive', `${workId}.json`),
-        sourceStateFile: (source, key) => join(dataRoot, 'sources', sanitizePathKey(source), `${sanitizePathKey(key)}.json`),
-        runFile: (runId) => join(dataRoot, 'runs', `${runId}.json`),
-        runDateFile: (date, runId) => join(dataRoot, 'runs', 'by-date', date, `${runId}.json`),
-        runInputSnapshotFile: (snapshotId) => join(dataRoot, 'runs', 'input-snapshots', `${sanitizePathKey(snapshotId)}.json`),
-        runDateIndexFile: (date) => join(dataRoot, 'runs', 'by-date', date, 'index.json'),
-        runDateIndexLockFile: (date) => join(dataRoot, 'locks', `run-index-${date}.lock`),
-        eventFile: (date) => join(dataRoot, 'events', `${date}.jsonl`),
-        eventEnvelopeFile: (eventId) => join(dataRoot, 'events-by-id', `${sanitizePathKey(eventId)}.json`),
-        logFile: (date) => join(dataRoot, 'logs', `${date}.log`),
-        // Workspaces and transcripts are ephemeral scratch rather than durable
-        // state, but they re-key to the work id anyway: they are 1:1 with a work
-        // item, not a ticket, and a ticket-shaped path here would preserve the
-        // second ticket-shaped identity this change exists to remove (spec §3).
-        workspaceDir: (workId) => join(wakeRoot, 'workspaces', workId),
-        transcriptWorkDir: (workId) => join(dataRoot, 'transcripts', workId),
-        transcriptSessionDir: (workId, sessionKey) => join(dataRoot, 'transcripts', workId, sanitizePathKey(sessionKey)),
-        resourceIndexRoot: join(dataRoot, 'state', 'index'),
-        resourceIndexShardFile: (shard) => join(dataRoot, 'state', 'index', `${shard}.json`),
-        controlPlaneUiUrlFile: join(dataRoot, 'control-plane-ui-url'),
-    };
-}

package/dist/src/lib/process-identity.js

@@ -1,54 +0,0 @@
-import { readFileSync } from 'node:fs';
-const currentProcessStartedAt = new Date(Date.now() - process.uptime() * 1000).toISOString();
-function readLinuxProcessStartTicks(pid) {
-    try {
-        const stat = readFileSync(`/proc/${pid}/stat`, 'utf8');
-        const endCommand = stat.lastIndexOf(')');
-        if (endCommand === -1) {
-            return undefined;
-        }
-        const fields = stat
-            .slice(endCommand + 2)
-            .trim()
-            .split(/\s+/);
-        const startTicks = fields[19];
-        return startTicks === undefined ? undefined : `linux-start-ticks:${startTicks}`;
-    }
-    catch {
-        return undefined;
-    }
-}
-export function readProcessIdentity(pid) {
-    if (!Number.isInteger(pid) || pid <= 0) {
-        return null;
-    }
-    try {
-        process.kill(pid, 0);
-    }
-    catch (error) {
-        if (error.code === 'ESRCH') {
-            return null;
-        }
-    }
-    const linuxStartedAt = readLinuxProcessStartTicks(pid);
-    if (linuxStartedAt !== undefined) {
-        return { pid, processStartedAt: linuxStartedAt };
-    }
-    if (pid === process.pid) {
-        return { pid, processStartedAt: currentProcessStartedAt };
-    }
-    return null;
-}
-export function currentProcessIdentity() {
-    return (readProcessIdentity(process.pid) ?? {
-        pid: process.pid,
-        processStartedAt: currentProcessStartedAt,
-    });
-}
-export function processIdentityMatches(input) {
-    if (input.pid === undefined || input.processStartedAt === undefined) {
-        return false;
-    }
-    const current = readProcessIdentity(input.pid);
-    return current?.processStartedAt === input.processStartedAt;
-}

package/dist/src/lib/state-health.js

@@ -1,30 +0,0 @@
-export class StateHealthError extends Error {
-    issues;
-    constructor(issues) {
-        super(formatStateHealthErrorMessage(issues));
-        this.name = 'StateHealthError';
-        this.issues = issues;
-    }
-}
-export function isNodeErrnoException(error) {
-    return error instanceof Error && 'code' in error;
-}
-export function isMissingPathError(error) {
-    return isNodeErrnoException(error) && error.code === 'ENOENT';
-}
-export function stateHealthIssue(input) {
-    return input;
-}
-export function throwIfUnhealthy(issues) {
-    if (issues.length > 0) {
-        throw new StateHealthError(issues);
-    }
-}
-export function formatStateHealthErrorMessage(issues) {
-    if (issues.length === 0) {
-        return 'Wake control-plane state is healthy';
-    }
-    const first = issues[0];
-    const suffix = issues.length === 1 ? '' : ` and ${issues.length - 1} more issue(s)`;
-    return `Wake control-plane state is unhealthy: ${first.surface} ${first.kind} at ${first.path}: ${first.message}${suffix}`;
-}

package/dist/src/lib/work-id.js

@@ -1,19 +0,0 @@
-import { ulid } from 'ulid';
-/** Crockford base32 alphabet, as used by ULID: no I, L, O, or U. */
-const WORK_ID_PATTERN = /^work-[0-9A-HJKMNP-TV-Z]{26}$/;
-/**
- * Mints a provider-independent work item identifier.
- *
- * Work ids name the work, never any surface that represents it: a ticket key
- * is not a stable name for work (issue transfer renumbers it, and work can
- * split or merge). See docs/superpowers/specs/2026-07-16-work-identity-correlation-design.md (D3).
- *
- * ULIDs sort chronologically as strings, so state/ listings are naturally
- * ordered by mint time, and are filename-safe with no escaping.
- */
-export function createWorkId() {
-    return `work-${ulid()}`;
-}
-export function isWorkId(value) {
-    return WORK_ID_PATTERN.test(value);
-}

package/dist/src/lib/yaml-file.js

@@ -1,20 +0,0 @@
-import { mkdir, readFile, rename, rm, writeFile } from 'node:fs/promises';
-import { randomUUID } from 'node:crypto';
-import { dirname } from 'node:path';
-import { parse, stringify } from 'yaml';
-export async function writeYamlFile(path, value) {
-    await mkdir(dirname(path), { recursive: true });
-    const tempPath = `${path}.${randomUUID()}.tmp`;
-    try {
-        await writeFile(tempPath, stringify(value), 'utf8');
-        await rename(tempPath, path);
-    }
-    catch (error) {
-        await rm(tempPath, { force: true }).catch(() => { });
-        throw error;
-    }
-}
-export async function readYamlFile(path) {
-    const raw = await readFile(path, 'utf8');
-    return parse(raw);
-}

package/templates/SETUP.md

@@ -1,115 +0,0 @@
-# Wake Setup Guide (for the assisting agent)
-
-You are reading this because a human just ran `wake init` and asked you to
-help finish configuring this Wake home. This file is written as instructions
-to you, the assisting agent — not as prose for a human to read top to bottom.
-
-Read `config.yaml` and `config.workflows.yaml` in this directory now — both
-already exist with working defaults from `wake init`. Everything below tells
-you which fields in those two files to change. Edit them directly; don't
-create a new `config.<label>.yaml` split unless the user asks for one.
-
-Work through the three sections below in order, asking the user only what's
-asked in each section. Each section links the relevant part of the hosted
-`docs/configuration.md` for full field-by-field reference beyond what's
-summarized here.
-
-## 1. GitHub source
-
-Ask the user:
-
-- Which GitHub repo(s) should Wake monitor for issues? (`owner/repo` format)
-- Should polling start immediately, or stay off until they're ready?
-
-Edit in `config.yaml`:
-
-```yaml
-sources:
-  github:
-    enabled: true # or leave false to configure now, enable later
-    repos: [owner/repo] # one or more, owner/repo format
-```
-
-Tell the user: once enabled, Wake adds/removes a
-`wake:status.pending|working|failed|completed` label on issues it works, and
-preserves any other labels already on the issue.
-
-Full reference:
-https://github.com/atolis-hq/wake/blob/main/docs/configuration.md#sourcesgithub
-
-## 2. Runner and tier
-
-Ask the user which agent CLI(s) they have authenticated on this host:
-Claude, Codex, and/or Cursor.
-
-`config.workflows.yaml` already has example `runners` entries for
-`claude-haiku`, `claude-opus`, `codex-mini`, `codex-flagship`, and
-`cursor-composer`, but every tier (`light`/`standard`/`deep`, with
-`defaultTier: standard`) still points at the placeholder `fake` runner — none
-of them route to a real runner yet. Don't rewrite this from scratch — pick
-which runner(s) the user actually has access to, and either:
-
-- repoint `tiers` so each tier lists the real named runner(s) the user can
-  actually use instead of `fake`, or
-- if the user has a runner not already listed (a different model, a
-  different CLI), add a new named entry under `runners` following the
-  existing pattern, then reference it from `tiers`.
-- remove entries which are not needed.
-
-Full reference:
-https://github.com/atolis-hq/wake/blob/main/docs/configuration.md#runners
-and
-https://github.com/atolis-hq/wake/blob/main/docs/configuration.md#tiers
-
-## 3. Credential mounts (check before asking)
-
-Do not start by asking the user where their credentials are. First check the
-host filesystem yourself for the files below, matching whichever runner(s)
-were chosen in step 2:
-
-- Claude: `~/.claude/.credentials.json` and `~/.claude/settings.json`
-- Codex: `~/.codex/config.toml` and `~/.codex/auth.json`
-- Cursor: `~/.config/cursor/auth.json`
-
-For each file that exists, propose adding it to `sandbox.extraMounts` in
-`config.yaml`, for example:
-
-```yaml
-sandbox:
-  extraMounts:
-    - source: /home/alice/.claude/.credentials.json
-      target: /home/wake/.claude/.credentials.json
-      readOnly: true
-    - source: /home/alice/.claude/settings.json
-      target: /home/wake/.claude/settings.json
-      readOnly: false
-```
-
-`.credentials.json`/`auth.json` should be `readOnly: true` unless the user
-wants the sandbox able to refresh tokens on the host's behalf. `settings.json`
-must stay `readOnly: false` — Claude plugin commands write to it. Use the
-actual host home directory path (resolve `~` yourself; don't write a literal
-tilde into YAML).
-
-Never mount the whole `~/.claude`, `~/.codex`, or `~/.cursor` directory —
-only the specific files listed above. Mounting the whole directory leaks
-OS-specific absolute paths (e.g. Windows plugin cache paths) into the Linux
-sandbox and can cause the sandbox to overwrite the host's plugin bookkeeping.
-
-Only if none of the expected files exist for the runner the user chose, ask
-them directly where their credentials live (e.g. a custom `CODEX_HOME`).
-
-Full reference:
-https://github.com/atolis-hq/wake/blob/main/docs/configuration.md#sandbox
-
-## After config looks right
-
-Don't try to explain the sandbox lifecycle yourself — point the user at (or
-fetch, if you have web access):
-
-- https://github.com/atolis-hq/wake/blob/main/docs/getting-started.md —
-  `wake sandbox build` / `up` / `setup` / `exec` / `down`
-- https://github.com/atolis-hq/wake/blob/main/docs/runner-comparison.md —
-  deeper comparison of runner tradeoffs if the user asks which to pick
-- https://github.com/atolis-hq/wake/blob/main/docs/configuration.md — every
-  config field, if something here doesn't cover their situation