agent-tempo 1.7.0 → 2.0.0-beta.2

package/dist/cli/legacy-migration.d.ts

@@ -1,35 +0,0 @@
-/** Marker file name dropped in the new home post-migration. */
-export declare const MIGRATION_MARKER_FILENAME = ".migrated-from-claude-tempo";
-export type MigrationStatus = 'no-legacy' | 'already-migrated' | 'migrated' | 'skipped' | 'failed';
-export interface LegacyMigrationResult {
-    status: MigrationStatus;
-    legacyHome?: string;
-    newHome?: string;
-    /** Relative paths inside the new home that were copied this run. */
-    copiedFiles?: string[];
-    /** Errors collected during partial-copy resume; populated when status === 'failed'. */
-    errors?: string[];
-    /** Set when status === 'skipped' to explain why. */
-    reason?: string;
-}
-export interface LegacyMigrationOpts {
-    /** Don't write anything; report what would happen. */
-    dryRun?: boolean;
-    /** Override the conflict guard (existing new-home without marker) AND the volatile-state guard. */
-    force?: boolean;
-    /** Which profile to migrate. `'prod'` = `~/.claude-tempo` → `~/.agent-tempo`; `'dev'` = `-dev` variants. Default `'prod'`. */
-    profile?: 'prod' | 'dev';
-    /** Test seam — override `homedir()`. */
-    homeDir?: string;
-}
-/**
- * One-shot legacy home migration. See module doc-comment for the full
- * contract. Never throws — all error paths return a structured
- * {@link LegacyMigrationResult}.
- */
-export declare function migrateLegacyHome(opts?: LegacyMigrationOpts): Promise<LegacyMigrationResult>;
-/**
- * Format a {@link LegacyMigrationResult} for human display (CLI verb output
- * + bootstrap step `notes`).
- */
-export declare function formatMigrationResult(r: LegacyMigrationResult): string;

package/dist/cli/legacy-migration.js

@@ -1,341 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MIGRATION_MARKER_FILENAME = void 0;
-exports.migrateLegacyHome = migrateLegacyHome;
-exports.formatMigrationResult = formatMigrationResult;
-/**
- * Legacy home migration — `~/.claude-tempo/` → `~/.agent-tempo/`.
- *
- * PR-2 of the v1.0 rebrand renames the on-disk profile directory. This
- * helper performs a one-shot copy on first boot of the new binary so
- * users don't lose their saved config / lineups / state.
- *
- * Contract (see brief):
- *   1. **Idempotent.** Re-running on a migrated home is `'already-migrated'`.
- *   2. **Copy, not move.** Legacy `~/.claude-tempo/` stays untouched as a
- *      safety net for one release.
- *   3. **Marker file.** Writes `~/.agent-tempo/.migrated-from-claude-tempo`
- *      with `{ migratedAt, copiedFromHash, files }`.
- *   4. **Conflict policy.** If `~/.agent-tempo/` exists AND has no marker,
- *      refuse with `'skipped'`; user must pass `force: true` or delete.
- *      Don't clobber a user-initiated new home.
- *   5. **Partial-copy resume.** Per-file SHA-256 in the marker — re-running
- *      a partially-completed run finishes only the missing/changed files.
- *   6. **Files copied.** Allowlist — `config.json`, `.bootstrap-cache.json`,
- *      any `*.yaml` user-stashed lineup files, plus subdirs `ensembles/`,
- *      `state/`, `coat-check/` (forward-compat — fine if absent). The
- *      volatile runtime trio (`daemon.pid`, `daemon.port`, `daemon.log`)
- *      is intentionally skipped — let the daemon recreate them.
- *      (Historical note: the original brief named the lineup subdir
- *      `lineups/`, but the actual on-disk name has always been
- *      `ensembles/` — see `src/ensemble/{saver,loader}.ts`. The original
- *      implementation copied the brief's typo verbatim, which silently
- *      stranded user lineups across the v0.x → v1.x migration. Fixed by
- *      pointing the allowlist at the real directory name.)
- *   7. **Volatile-state guard.** If `daemon.pid` is present in the legacy
- *      home (likely-running daemon), refuses unless `force: true`.
- *
- * Single owner file — narrow blast radius. The CLI verb in `src/cli.ts`
- * and the bootstrap step in `src/cli/startup.ts` are the only callers.
- */
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const crypto = __importStar(require("crypto"));
-const os_1 = require("os");
-const config_1 = require("../config");
-/** Legacy POSIX/macOS/Windows home dir name (pre-v1.0 rebrand). */
-const LEGACY_PROD_HOME_DIR_NAME = '.claude-tempo';
-const LEGACY_DEV_HOME_DIR_NAME = '.claude-tempo-dev';
-/** Marker file name dropped in the new home post-migration. */
-exports.MIGRATION_MARKER_FILENAME = '.migrated-from-claude-tempo';
-/** Volatile runtime state — never copied (daemon recreates on boot). */
-const VOLATILE_FILES = new Set(['daemon.pid', 'daemon.port', 'daemon.log']);
-/** Allowlisted top-level files. `*.yaml` is matched as a glob. */
-const ALLOWLIST_FILES = new Set(['config.json', '.bootstrap-cache.json']);
-/** Allowlisted top-level subdirs (recursive copy). Forward-compat — fine if absent. */
-const ALLOWLIST_SUBDIRS = ['ensembles', 'state', 'coat-check'];
-function legacyHomeFor(profile, home) {
-    return path.join(home, profile === 'dev' ? LEGACY_DEV_HOME_DIR_NAME : LEGACY_PROD_HOME_DIR_NAME);
-}
-function newHomeFor(profile, home) {
-    return path.join(home, profile === 'dev' ? config_1.DEV_HOME_DIR_NAME : config_1.PROD_HOME_DIR_NAME);
-}
-/** SHA-256 hex digest of a file's contents. */
-function hashFile(absPath) {
-    const hash = crypto.createHash('sha256');
-    hash.update(fs.readFileSync(absPath));
-    return hash.digest('hex');
-}
-/** Aggregate hash of a whole tree — order-stable by sorting relative paths. */
-function hashTree(root, files) {
-    const hash = crypto.createHash('sha256');
-    for (const f of files.slice().sort((a, b) => a.rel.localeCompare(b.rel))) {
-        hash.update(f.rel + ':' + hashFile(f.abs) + '\n');
-    }
-    return hash.digest('hex');
-}
-/** Read the migration marker, returning `null` if absent / malformed. */
-function readMarker(newHome) {
-    const markerPath = path.join(newHome, exports.MIGRATION_MARKER_FILENAME);
-    if (!fs.existsSync(markerPath))
-        return null;
-    try {
-        const parsed = JSON.parse(fs.readFileSync(markerPath, 'utf8'));
-        if (typeof parsed.copiedFromHash !== 'string' || !Array.isArray(parsed.files))
-            return null;
-        return {
-            migratedAt: parsed.migratedAt ?? '',
-            copiedFromHash: parsed.copiedFromHash,
-            files: parsed.files,
-            fileHashes: parsed.fileHashes ?? {},
-        };
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * Walk a directory tree, yielding `{ rel, abs }` entries for files matching
- * the allowlist. Returns `[]` if `legacyHome` doesn't exist.
- *
- * Allowlist:
- *   - top-level files in {@link ALLOWLIST_FILES}
- *   - top-level `*.yaml` / `*.yml` files
- *   - everything (recursively) under top-level subdirs in {@link ALLOWLIST_SUBDIRS}
- *
- * The volatile trio (`daemon.pid`/`.port`/`.log`) is excluded everywhere.
- */
-function walkLegacyTree(legacyHome) {
-    if (!fs.existsSync(legacyHome))
-        return [];
-    const out = [];
-    // Top-level entries
-    let entries;
-    try {
-        entries = fs.readdirSync(legacyHome, { withFileTypes: true });
-    }
-    catch {
-        return [];
-    }
-    for (const entry of entries) {
-        if (VOLATILE_FILES.has(entry.name))
-            continue;
-        if (entry.name === exports.MIGRATION_MARKER_FILENAME)
-            continue;
-        const abs = path.join(legacyHome, entry.name);
-        if (entry.isFile()) {
-            if (ALLOWLIST_FILES.has(entry.name) || /\.ya?ml$/i.test(entry.name)) {
-                out.push({ rel: entry.name, abs });
-            }
-            continue;
-        }
-        if (entry.isDirectory() && ALLOWLIST_SUBDIRS.includes(entry.name)) {
-            walkSubtree(abs, entry.name, out);
-        }
-    }
-    return out;
-}
-function walkSubtree(absRoot, relRoot, out) {
-    let entries;
-    try {
-        entries = fs.readdirSync(absRoot, { withFileTypes: true });
-    }
-    catch {
-        return;
-    }
-    for (const entry of entries) {
-        const abs = path.join(absRoot, entry.name);
-        const rel = path.posix.join(relRoot, entry.name);
-        if (entry.isFile()) {
-            out.push({ rel, abs });
-        }
-        else if (entry.isDirectory()) {
-            walkSubtree(abs, rel, out);
-        }
-    }
-}
-/**
- * One-shot legacy home migration. See module doc-comment for the full
- * contract. Never throws — all error paths return a structured
- * {@link LegacyMigrationResult}.
- */
-async function migrateLegacyHome(opts = {}) {
-    const profile = opts.profile ?? 'prod';
-    const home = opts.homeDir ?? (0, os_1.homedir)();
-    const legacyHome = legacyHomeFor(profile, home);
-    const newHome = newHomeFor(profile, home);
-    // 1. No legacy → nothing to do.
-    if (!fs.existsSync(legacyHome)) {
-        return { status: 'no-legacy', legacyHome, newHome };
-    }
-    // 2. Volatile state guard — daemon.pid likely means a running daemon.
-    const pidPath = path.join(legacyHome, 'daemon.pid');
-    if (!opts.force && fs.existsSync(pidPath)) {
-        return {
-            status: 'skipped',
-            legacyHome,
-            newHome,
-            reason: `Legacy daemon.pid present at ${pidPath}. The daemon may still be running — ` +
-                `stop it first (\`agent-tempo daemon stop\` or \`claude-tempo daemon stop\`) ` +
-                `and re-run, or pass \`--force\` to migrate anyway.`,
-        };
-    }
-    // 3. Conflict policy — new home exists without our marker = user-initiated, refuse.
-    const newHomeExists = fs.existsSync(newHome);
-    const existingMarker = newHomeExists ? readMarker(newHome) : null;
-    if (newHomeExists && !existingMarker && !opts.force) {
-        return {
-            status: 'skipped',
-            legacyHome,
-            newHome,
-            reason: `Refusing to overwrite ${newHome} — directory exists and was not created ` +
-                `by a previous migration (no \`${exports.MIGRATION_MARKER_FILENAME}\` marker found). ` +
-                `Pass \`--force\` to migrate anyway, or delete the directory first.`,
-        };
-    }
-    // 4. Enumerate legacy files + hash the source tree.
-    const legacyFiles = walkLegacyTree(legacyHome);
-    if (legacyFiles.length === 0) {
-        // Legacy dir exists but holds only volatile state / nothing to migrate.
-        return { status: 'no-legacy', legacyHome, newHome };
-    }
-    const sourceHash = hashTree(legacyHome, legacyFiles);
-    // 5. Idempotency — same source content + valid marker = already migrated.
-    if (existingMarker && existingMarker.copiedFromHash === sourceHash) {
-        return {
-            status: 'already-migrated',
-            legacyHome,
-            newHome,
-            copiedFiles: [],
-        };
-    }
-    // 6. Plan the copy. Partial-copy resume: skip files whose dest already has the right SHA.
-    const plan = [];
-    const errors = [];
-    for (const f of legacyFiles) {
-        let srcHash;
-        try {
-            srcHash = hashFile(f.abs);
-        }
-        catch (err) {
-            errors.push(`hash failed for ${f.rel}: ${err.message}`);
-            continue;
-        }
-        const destAbs = path.join(newHome, f.rel);
-        if (existingMarker?.fileHashes?.[f.rel] === srcHash && fs.existsSync(destAbs)) {
-            try {
-                if (hashFile(destAbs) === srcHash)
-                    continue; // already copied with right content
-            }
-            catch { /* fall through and re-copy */ }
-        }
-        plan.push({ rel: f.rel, abs: f.abs, destAbs, sourceHash: srcHash });
-    }
-    if (opts.dryRun) {
-        return {
-            status: 'migrated',
-            legacyHome,
-            newHome,
-            copiedFiles: plan.map((p) => p.rel),
-        };
-    }
-    // 7. Execute the copy.
-    const copied = [];
-    const fileHashes = { ...(existingMarker?.fileHashes ?? {}) };
-    try {
-        fs.mkdirSync(newHome, { recursive: true });
-    }
-    catch (err) {
-        errors.push(`mkdir ${newHome}: ${err.message}`);
-        return { status: 'failed', legacyHome, newHome, errors };
-    }
-    for (const p of plan) {
-        try {
-            fs.mkdirSync(path.dirname(p.destAbs), { recursive: true });
-            fs.copyFileSync(p.abs, p.destAbs);
-            copied.push(p.rel);
-            fileHashes[p.rel] = p.sourceHash;
-        }
-        catch (err) {
-            errors.push(`copy ${p.rel}: ${err.message}`);
-        }
-    }
-    if (errors.length > 0 && copied.length === 0) {
-        return { status: 'failed', legacyHome, newHome, errors };
-    }
-    // 8. Drop the marker — captures final state for idempotency.
-    const allFiles = legacyFiles.map((f) => f.rel).sort();
-    const marker = {
-        migratedAt: new Date().toISOString(),
-        copiedFromHash: sourceHash,
-        files: allFiles,
-        fileHashes,
-    };
-    try {
-        fs.writeFileSync(path.join(newHome, exports.MIGRATION_MARKER_FILENAME), JSON.stringify(marker, null, 2) + '\n');
-    }
-    catch (err) {
-        errors.push(`marker write: ${err.message}`);
-    }
-    return {
-        status: 'migrated',
-        legacyHome,
-        newHome,
-        copiedFiles: copied,
-        ...(errors.length > 0 ? { errors } : {}),
-    };
-}
-/**
- * Format a {@link LegacyMigrationResult} for human display (CLI verb output
- * + bootstrap step `notes`).
- */
-function formatMigrationResult(r) {
-    switch (r.status) {
-        case 'no-legacy':
-            return `No legacy home at ${r.legacyHome} — nothing to migrate.`;
-        case 'already-migrated':
-            return `Already migrated — ${r.newHome} is up-to-date with ${r.legacyHome}.`;
-        case 'migrated': {
-            const n = r.copiedFiles?.length ?? 0;
-            const errSuffix = r.errors?.length ? ` (${r.errors.length} error(s) recorded)` : '';
-            return `Migrated ${n} file(s) ${r.legacyHome} → ${r.newHome}${errSuffix}.`;
-        }
-        case 'skipped':
-            return r.reason ?? 'Migration skipped.';
-        case 'failed':
-            return `Migration failed: ${(r.errors ?? []).join('; ')}`;
-    }
-}

package/dist/client/ensure-conductor-spawned.d.ts

@@ -1,35 +0,0 @@
-/**
- * Shared helper for restore-after-shutdown: make sure a conductor terminal
- * is attached to an ensemble before `/restore` completes. Called by the
- * TUI `/restore` slash command (`App.tsx`, `commands.ts`).
- *
- * NOTE: This file lives in `src/client/` because the CLI `restore` command
- * was expected to adopt it. If no CLI consumer adopts within 2 PRs after
- * #308 merges, move to `src/tui/utils/` — current consumers are TUI-only.
- *
- * Returns a structured outcome so callers can render a summary without
- * parsing strings. Never throws — callers should treat a missing conductor
- * as a soft failure.
- */
-import type { TempoClientWithSpawn } from './interface';
-export type EnsureConductorSpawnedOutcome = {
-    spawned: false;
-    reason: 'alreadyLive';
-} | {
-    spawned: true;
-} | {
-    spawned: false;
-    reason: 'spawnFailed';
-    error: string;
-};
-/**
- * If the ensemble already has a conductor session in a live phase, no-op.
- * Otherwise shell out via {@link TempoClientWithSpawn.spawnConductor} to
- * open a conductor terminal. The `agent-tempo up` path is idempotent at
- * the workflow layer, so a benign race (two restores in flight) converges
- * on one workflow.
- *
- * Typed against `TempoClientWithSpawn` (not `TempoClient` alias) so the
- * spawn dependency is explicit at the call site (#308 follow-up).
- */
-export declare function ensureConductorSpawned(ensemble: string, client: TempoClientWithSpawn): Promise<EnsureConductorSpawnedOutcome>;

package/dist/client/ensure-conductor-spawned.js

@@ -1,48 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ensureConductorSpawned = ensureConductorSpawned;
-/**
- * If the ensemble already has a conductor session in a live phase, no-op.
- * Otherwise shell out via {@link TempoClientWithSpawn.spawnConductor} to
- * open a conductor terminal. The `agent-tempo up` path is idempotent at
- * the workflow layer, so a benign race (two restores in flight) converges
- * on one workflow.
- *
- * Typed against `TempoClientWithSpawn` (not `TempoClient` alias) so the
- * spawn dependency is explicit at the call site (#308 follow-up).
- */
-async function ensureConductorSpawned(ensemble, client) {
-    try {
-        const info = await client.attachmentInfo(ensemble, 'conductor');
-        const phase = info.phase;
-        const alreadyLive = phase === 'attached' || phase === 'processing'
-            || phase === 'awaiting' || phase === 'booting';
-        if (alreadyLive)
-            return { spawned: false, reason: 'alreadyLive' };
-    }
-    catch {
-        // No conductor session / query failed — fall through to spawn.
-    }
-    try {
-        await client.spawnConductor({ ensemble });
-        return { spawned: true };
-    }
-    catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        // #306: `/restore` runs two parallel paths that can both spawn the
-        // conductor — `restoreOrphansOnce` reattaches the orphan adapter via
-        // `deliverRestart`, and this helper falls through to a fresh spawn when
-        // the attachment-info query returns a non-live phase. If the orphan
-        // reattach wins the race, our spawn (`agent-tempo up <ensemble>`)
-        // throws "A conductor is already running for ensemble" — which is the
-        // success condition for THIS helper. Swallow the race and report alive.
-        if (/conductor is already running/i.test(message)) {
-            return { spawned: false, reason: 'alreadyLive' };
-        }
-        return {
-            spawned: false,
-            reason: 'spawnFailed',
-            error: message,
-        };
-    }
-}

package/dist/tui/App.d.ts

@@ -1,85 +0,0 @@
-/**
- * Root TUI application component — chat-focused shell with slash commands.
- *
- * Layout (top to bottom):
- * - TitleBar (pinned)
- * - Divider
- * - Static scroll-up history
- * - Live content area (splash, main, chat, error)
- * - Divider
- * - PromptArea (pinned)
- */
-import React from 'react';
-import type { TuiState } from './store';
-import type { TempoClient } from '../client';
-interface AppProps {
-    api: TempoClient;
-    /** If provided, start directly in ensemble view. */
-    ensemble?: string;
-    /** Default agent type from config (defaults to 'claude'). */
-    defaultAgent?: 'claude' | 'copilot';
-}
-export declare function App({ api, ensemble, defaultAgent }: AppProps): React.ReactSVGElement | React.FunctionComponentElement<React.FragmentProps>;
-/**
- * #306: Strip a leading kind-icon (`✗ `, `⚠ `, `ⓘ `) from notification
- * content. Defensive: many call sites historically prepended the icon into
- * the message string, and the renderer also prepends a kind-based icon —
- * without this normalization the user sees the icon twice (e.g.
- * `✗ ✗ Cannot destroy the conductor …`). Exported for unit testing.
- */
-export declare function stripLeadingIcon(content: string): string;
-/**
- * #306: True when the TUI is on the home picker view — `phase === 'main'`
- * AND `view === 'home'`. The chat input has no target on this view (the
- * ensemble has not been entered yet), and HomeView owns Enter to navigate
- * its own row list. Render guard for PromptArea + the second divider so
- * the input cannot double-fire alongside HomeView's own `useInput`.
- *
- * Pure function, exported so tests can pin the guard's logic without
- * standing up an Ink render. Mirrors the splash-phase bypass pattern.
- */
-export declare function isHomeView(state: Pick<TuiState, 'phase' | 'view'>): boolean;
-/**
- * #306: Build the pinned-confirmation line(s) for the current state. Returns
- * an array (possibly empty) of `{ key, text }` entries — one per active
- * `confirming*` state field. Rendered above the notifications stack by
- * `renderPinnedConfirmations` and sized by `countPinnedConfirmationLines`
- * so `FOOTER_LINES` reserves terminal rows correctly.
- *
- * Pure function, exported for unit testing — no Ink imports, no dispatch.
- * The render helper below is the only caller that wraps these in Text nodes.
- */
-export declare function pinnedConfirmationLines(state: Pick<TuiState, 'confirmingStop' | 'confirmingStopReason' | 'confirmingDisband' | 'confirmingEnsembleDestroy' | 'confirmingLineup'>): Array<{
-    key: string;
-    text: string;
-}>;
-/**
- * #306: Count of pinned confirmation lines — one per active `confirming*`
- * state field. Consumed by the `FOOTER_LINES` reservation so the live
- * content area shrinks when a confirmation is active, keeping the pinned
- * prompt on-screen.
- */
-export declare function countPinnedConfirmationLines(state: Pick<TuiState, 'confirmingStop' | 'confirmingStopReason' | 'confirmingDisband' | 'confirmingEnsembleDestroy' | 'confirmingLineup'>): number;
-/**
- * #306 follow-up: Build the pinned tip line for the current paused/held
- * state. Returns `null` when neither flag is set — no tip should render.
- *
- * The tip appears below the input prompt in a dim color (informational,
- * not an error or warning) and tells the user which slash commands they
- * need to fully resume the ensemble. `/load_lineup` flips both flags;
- * `/play` clears only paused; `/go` clears only held — without this
- * tip users would unpause an ensemble and stare at frozen players.
- *
- * Pure function, exported for unit testing — no Ink imports.
- */
-export declare function pinnedTipLine(state: Pick<TuiState, 'ensemblePaused' | 'ensembleHeld' | 'activeEnsemble'>): {
-    key: string;
-    text: string;
-} | null;
-/**
- * Count of pinned tip lines (0 or 1). Mirrors
- * {@link countPinnedConfirmationLines} so `FOOTER_LINES` can reserve a
- * row for the tip without re-evaluating the state shape twice.
- */
-export declare function countPinnedTipLines(state: Pick<TuiState, 'ensemblePaused' | 'ensembleHeld' | 'activeEnsemble'>): number;
-export {};