@aperant/framework 0.6.2

package/dist/cli/coordination/team-status.mjs

@@ -0,0 +1,270 @@
+/**
+ * @internal
+ * team-status.mjs — per-agent status files under .aperant/team-status/ (R2).
+ *
+ * Rationale: active.json was a single JSON object shared across every agent in
+ * the repo — concurrent updaters could drop each other's entries even with
+ * file-level locking (the locks serialized, but the record shape forced a
+ * read-modify-write on a single document). Replacing it with a directory of
+ * per-agent JSON files removes the shared write target entirely. Each agent
+ * owns exactly one file (`.aperant/team-status/{agentId}.json`) and nobody
+ * else writes to it.
+ *
+ * This module is `@internal` — consumed only through the CoordinationStore
+ * seam (store.upsertTeamStatus / removeTeamStatus / listTeamStatus). Do NOT
+ * import from bin/apt-tools.mjs.
+ *
+ * C34: the legacy active.json dual-write / one-shot migration were removed.
+ * The per-agent team-status/ directory is the sole source of truth for the
+ * cross-agent active board.
+ */
+import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, unlinkSync } from 'node:fs';
+import { hostname as osHostname } from 'node:os';
+import { join } from 'node:path';
+import { getCurrentBranch, getGitIdentity } from '../git/identity.mjs';
+import { atomicWriteJson } from '../util/io.mjs';
+import { getAgentIdentity, resolveSharedRoot } from './agent-identity.mjs';
+/** Default TTL applied when a caller doesn't supply one. */
+const DEFAULT_TTL_SECONDS = 90;
+/** Extra tolerance for cross-host clock skew when evaluating TTL (R4). */
+const TTL_SKEW_MS = 30_000;
+function teamStatusDir(projectRoot) {
+    return join(resolveSharedRoot(projectRoot), '.aperant', 'team-status');
+}
+function agentFilePath(projectRoot, agentId) {
+    return join(teamStatusDir(projectRoot), `${agentId}.json`);
+}
+/**
+ * Upsert the current agent's status file. `data` is merged on top of any
+ * existing record so callers can pass partial updates (e.g. a lifecycle-phase
+ * bump without re-asserting owner/branch).
+ *
+ * @internal
+ */
+export function upsertSelf(projectRoot, taskId, data = {}) {
+    const identity = getAgentIdentity(projectRoot);
+    const dir = teamStatusDir(projectRoot);
+    mkdirSync(dir, { recursive: true });
+    const path = agentFilePath(projectRoot, identity.agentId);
+    let existing = {};
+    if (existsSync(path)) {
+        try {
+            existing = JSON.parse(readFileSync(path, 'utf-8')) || {};
+        }
+        catch {
+            existing = {};
+        }
+    }
+    const now = new Date().toISOString();
+    const gitIdentity = (() => {
+        try {
+            return getGitIdentity(projectRoot) || null;
+        }
+        catch {
+            return null;
+        }
+    })();
+    const branch = (() => {
+        try {
+            return getCurrentBranch(projectRoot);
+        }
+        catch {
+            return null;
+        }
+    })();
+    const record = {
+        // ── identity (R4 uses these for liveness) ────────────────────────
+        agentId: identity.agentId,
+        pid: identity.pid,
+        hostname: identity.hostname,
+        incarnation: identity.incarnation,
+        // ── task association ─────────────────────────────────────────────
+        taskId,
+        description: data.description ?? existing.description ?? '',
+        owner: data.owner ?? existing.owner ?? gitIdentity?.name ?? 'unknown',
+        owner_email: data.owner_email ?? existing.owner_email ?? gitIdentity?.email ?? 'unknown',
+        branch: data.branch ?? existing.branch ?? branch ?? null,
+        lifecycle_phase: data.lifecycle_phase ?? existing.lifecycle_phase ?? 'planning',
+        scope: data.scope ?? existing.scope ?? 'project',
+        progress: data.progress ?? existing.progress ?? null,
+        current_subtask: data.current_subtask ?? existing.current_subtask ?? null,
+        // ── timing + liveness envelope ───────────────────────────────────
+        started_at: existing.started_at ?? now,
+        refreshedAt: now,
+        ttlSeconds: data.ttlSeconds ?? existing.ttlSeconds ?? DEFAULT_TTL_SECONDS,
+    };
+    atomicWriteJson(path, record);
+    return record;
+}
+/**
+ * Remove the current agent's file if it currently advertises the given
+ * taskId. No-op if another task is active under this agent (prevents a stale
+ * remove from dropping a newer task's status).
+ *
+ * @internal
+ */
+export function removeSelf(projectRoot, taskId) {
+    const identity = getAgentIdentity(projectRoot);
+    const path = agentFilePath(projectRoot, identity.agentId);
+    if (!existsSync(path))
+        return false;
+    try {
+        const record = JSON.parse(readFileSync(path, 'utf-8'));
+        if (record && record.taskId && record.taskId !== taskId)
+            return false;
+    }
+    catch {
+        /* malformed — fall through and unlink */
+    }
+    try {
+        unlinkSync(path);
+    }
+    catch {
+        /* already gone */
+    }
+    return true;
+}
+/**
+ * Decide whether a team-status entry represents a currently-running agent.
+ *
+ * Same-host semantics (R4):
+ *   - Live iff `process.kill(pid, 0)` succeeds AND the stored incarnation
+ *     matches ANY known live counter value for this host. Since we can only
+ *     verify the current process's incarnation, the cheap heuristic is:
+ *     "same-host + kill signal survives" — if the PID is still alive on this
+ *     machine, it belongs to us (or to another framework process that is
+ *     legitimately tracking the task). PID reuse is bounded by the incarnation
+ *     counter: a stale entry with a recycled PID will have a lower incarnation
+ *     than the current counter, so we reject it.
+ *   - We treat entries with missing pid/incarnation (e.g. legacy migrations)
+ *     as live iff they have a fresh refreshedAt — otherwise they get
+ *     stale-filtered through the TTL path.
+ *
+ * Cross-host semantics:
+ *   - Live iff `now - refreshedAt < ttlSeconds*1000 + TTL_SKEW_MS`.
+ *
+ * @internal
+ */
+export function isAlive(entry, opts = {}) {
+    if (!entry || typeof entry !== 'object')
+        return false;
+    const now = opts.now ?? Date.now();
+    const currentHost = opts.hostname ?? osHostname();
+    const currentIncarnation = opts.currentIncarnation ?? null;
+    const refreshed = entry.refreshedAt ? Date.parse(entry.refreshedAt) : NaN;
+    const ttlMs = (entry.ttlSeconds ?? DEFAULT_TTL_SECONDS) * 1000;
+    const ttlFresh = Number.isFinite(refreshed) && now - refreshed < ttlMs + TTL_SKEW_MS;
+    // Same-host path — requires both a valid PID and a matching-or-higher
+    // incarnation window. If we have the counter, enforce it; otherwise fall
+    // back to the kill-signal check alone.
+    if (entry.hostname && entry.hostname === currentHost) {
+        if (typeof entry.pid !== 'number' || entry.pid <= 1)
+            return ttlFresh;
+        try {
+            // Signal 0 = does-this-pid-exist; throws with ESRCH if not.
+            process.kill(entry.pid, 0);
+        }
+        catch {
+            return false;
+        }
+        if (currentIncarnation != null && typeof entry.incarnation === 'number') {
+            // Accept entries whose incarnation is <= the current counter but
+            // whose PID is still alive. Older incarnations with a dead PID
+            // already failed the kill check above.
+            if (entry.incarnation > currentIncarnation)
+                return false;
+        }
+        return true;
+    }
+    // Cross-host path — fall back to TTL + skew window.
+    return ttlFresh;
+}
+/**
+ * List team-status entries. By default filters out dead/stale records via
+ * `isAlive`. Pass `{ includeStale: true }` to get every parseable file
+ * (debugging surface — exposed via `apt-tools active list --include-stale`).
+ *
+ * C34: the one-shot active.json migration has been removed. An empty
+ * directory just returns [].
+ *
+ * @internal
+ */
+export function listActive(projectRoot, opts = {}) {
+    const dir = teamStatusDir(projectRoot);
+    mkdirSync(dir, { recursive: true });
+    const files = readdirSync(dir).filter((f) => f.endsWith('.json'));
+    const includeStale = opts.includeStale === true;
+    const currentHost = osHostname();
+    // Resolve the current incarnation lazily — tests may not want to read it.
+    let currentIncarnation = null;
+    try {
+        const identity = getAgentIdentity(projectRoot);
+        currentIncarnation = identity.incarnation;
+    }
+    catch {
+        /* best-effort */
+    }
+    const out = [];
+    for (const f of files) {
+        const full = join(dir, f);
+        try {
+            const record = JSON.parse(readFileSync(full, 'utf-8'));
+            if (!record || typeof record !== 'object' || !record.taskId)
+                continue;
+            if (includeStale || isAlive(record, { hostname: currentHost, currentIncarnation })) {
+                out.push(record);
+            }
+        }
+        catch {
+            /* skip malformed */
+        }
+    }
+    return out;
+}
+/**
+ * Helper for tests and diagnostics — never called from lifecycle code.
+ * @internal
+ */
+export function __debugDir(projectRoot) {
+    return teamStatusDir(projectRoot);
+}
+/**
+ * Helper for readers that need to project to the shape consumers of
+ * `active.json` expected. Preserves keys so commands/active.mjs output stays
+ * stable after the cutover.
+ *
+ * @internal
+ */
+export function toActiveBoardShape(entries) {
+    const active = {};
+    let latest = 0;
+    for (const e of entries) {
+        if (!e.taskId)
+            continue;
+        active[e.taskId] = {
+            task_id: e.taskId,
+            description: e.description || '',
+            owner: e.owner || 'unknown',
+            owner_email: e.owner_email || 'unknown',
+            branch: e.branch || null,
+            lifecycle_phase: e.lifecycle_phase || 'planning',
+            scope: e.scope || 'project',
+            progress: e.progress ?? null,
+            current_subtask: e.current_subtask ?? null,
+            started_at: e.started_at || null,
+            updated_at: e.refreshedAt || null,
+        };
+        const ts = Date.parse(e.refreshedAt || '');
+        if (Number.isFinite(ts) && ts > latest)
+            latest = ts;
+    }
+    return {
+        version: 1,
+        active,
+        updated_at: latest ? new Date(latest).toISOString() : new Date().toISOString(),
+    };
+}
+// Unused exports are intentionally retained — future R4/R6 subtasks consume
+// them without needing another patch.
+void statSync;
+//# sourceMappingURL=team-status.mjs.map

package/dist/cli/coordination/team-status.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-status.mjs","sourceRoot":"","sources":["../../../src/cli/coordination/team-status.mjs"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAChG,OAAO,EAAE,QAAQ,IAAI,UAAU,EAAE,MAAM,SAAS,CAAA;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAE1E,4DAA4D;AAC5D,MAAM,mBAAmB,GAAG,EAAE,CAAA;AAE9B,0EAA0E;AAC1E,MAAM,WAAW,GAAG,MAAM,CAAA;AAE1B,SAAS,aAAa,CAAC,WAAW;IACjC,OAAO,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,EAAE,UAAU,EAAE,aAAa,CAAC,CAAA;AACvE,CAAC;AAED,SAAS,aAAa,CAAC,WAAW,EAAE,OAAO;IAC1C,OAAO,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,EAAE,GAAG,OAAO,OAAO,CAAC,CAAA;AAC3D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,GAAG,EAAE;IACxD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAA;IAC9C,MAAM,GAAG,GAAG,aAAa,CAAC,WAAW,CAAC,CAAA;IACtC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACnC,MAAM,IAAI,GAAG,aAAa,CAAC,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;IAEzD,IAAI,QAAQ,GAAG,EAAE,CAAA;IACjB,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,IAAI,CAAC;YACJ,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAA;QACzD,CAAC;QAAC,MAAM,CAAC;YACR,QAAQ,GAAG,EAAE,CAAA;QACd,CAAC;IACF,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IACpC,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE;QACzB,IAAI,CAAC;YACJ,OAAO,cAAc,CAAC,WAAW,CAAC,IAAI,IAAI,CAAA;QAC3C,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,IAAI,CAAA;QACZ,CAAC;IACF,CAAC,CAAC,EAAE,CAAA;IACJ,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE;QACpB,IAAI,CAAC;YACJ,OAAO,gBAAgB,CAAC,WAAW,CAAC,CAAA;QACrC,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,IAAI,CAAA;QACZ,CAAC;IACF,CAAC,CAAC,EAAE,CAAA;IAEJ,MAAM,MAAM,GAAG;QACd,oEAAoE;QACpE,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,GAAG,EAAE,QAAQ,CAAC,GAAG;QACjB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,oEAAoE;QACpE,MAAM;QACN,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,QAAQ,CAAC,WAAW,IAAI,EAAE;QAC3D,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC,KAAK,IAAI,WAAW,EAAE,IAAI,IAAI,SAAS;QACrE,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,QAAQ,CAAC,WAAW,IAAI,WAAW,EAAE,KAAK,IAAI,SAAS;QACxF,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM,IAAI,MAAM,IAAI,IAAI;QACxD,eAAe,EAAE,IAAI,CAAC,eAAe,IAAI,QAAQ,CAAC,eAAe,IAAI,UAAU;QAC/E,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC,KAAK,IAAI,SAAS;QAChD,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ,IAAI,IAAI;QACpD,eAAe,EAAE,IAAI,CAAC,eAAe,IAAI,QAAQ,CAAC,eAAe,IAAI,IAAI;QACzE,oEAAoE;QACpE,UAAU,EAAE,QAAQ,CAAC,UAAU,IAAI,GAAG;QACtC,WAAW,EAAE,GAAG;QAChB,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,QAAQ,CAAC,UAAU,IAAI,mBAAmB;KACzE,CAAA;IAED,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IAC7B,OAAO,MAAM,CAAA;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,WAAW,EAAE,MAAM;IAC7C,MAAM,QAAQ,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAA;IAC9C,MAAM,IAAI,GAAG,aAAa,CAAC,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;IACzD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAA;IACnC,IAAI,CAAC;QACJ,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAA;QACtD,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM;YAAE,OAAO,KAAK,CAAA;IACtE,CAAC;IAAC,MAAM,CAAC;QACR,yCAAyC;IAC1C,CAAC;IACD,IAAI,CAAC;QACJ,UAAU,CAAC,IAAI,CAAC,CAAA;IACjB,CAAC;IAAC,MAAM,CAAC;QACR,kBAAkB;IACnB,CAAC;IACD,OAAO,IAAI,CAAA;AACZ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,OAAO,CAAC,KAAK,EAAE,IAAI,GAAG,EAAE;IACvC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IACrD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,CAAA;IAClC,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,IAAI,UAAU,EAAE,CAAA;IACjD,MAAM,kBAAkB,GAAG,IAAI,CAAC,kBAAkB,IAAI,IAAI,CAAA;IAE1D,MAAM,SAAS,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,CAAA;IACzE,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,UAAU,IAAI,mBAAmB,CAAC,GAAG,IAAI,CAAA;IAC9D,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,GAAG,GAAG,SAAS,GAAG,KAAK,GAAG,WAAW,CAAA;IAEpF,sEAAsE;IACtE,yEAAyE;IACzE,uCAAuC;IACvC,IAAI,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,QAAQ,KAAK,WAAW,EAAE,CAAC;QACtD,IAAI,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC;YAAE,OAAO,QAAQ,CAAA;QACpE,IAAI,CAAC;YACJ,4DAA4D;YAC5D,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;QAC3B,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,KAAK,CAAA;QACb,CAAC;QACD,IAAI,kBAAkB,IAAI,IAAI,IAAI,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;YACzE,iEAAiE;YACjE,+DAA+D;YAC/D,uCAAuC;YACvC,IAAI,KAAK,CAAC,WAAW,GAAG,kBAAkB;gBAAE,OAAO,KAAK,CAAA;QACzD,CAAC;QACD,OAAO,IAAI,CAAA;IACZ,CAAC;IAED,oDAAoD;IACpD,OAAO,QAAQ,CAAA;AAChB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,UAAU,CAAC,WAAW,EAAE,IAAI,GAAG,EAAE;IAChD,MAAM,GAAG,GAAG,aAAa,CAAC,WAAW,CAAC,CAAA;IACtC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACnC,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAA;IAEjE,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,KAAK,IAAI,CAAA;IAC/C,MAAM,WAAW,GAAG,UAAU,EAAE,CAAA;IAChC,0EAA0E;IAC1E,IAAI,kBAAkB,GAAG,IAAI,CAAA;IAC7B,IAAI,CAAC;QACJ,MAAM,QAAQ,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAA;QAC9C,kBAAkB,GAAG,QAAQ,CAAC,WAAW,CAAA;IAC1C,CAAC;IAAC,MAAM,CAAC;QACR,iBAAiB;IAClB,CAAC;IAED,MAAM,GAAG,GAAG,EAAE,CAAA;IACd,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;QACzB,IAAI,CAAC;YACJ,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAA;YACtD,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,MAAM;gBAAE,SAAQ;YACrE,IAAI,YAAY,IAAI,OAAO,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE,CAAC,EAAE,CAAC;gBACpF,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YACjB,CAAC;QACF,CAAC;QAAC,MAAM,CAAC;YACR,oBAAoB;QACrB,CAAC;IACF,CAAC;IACD,OAAO,GAAG,CAAA;AACX,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,WAAW;IACrC,OAAO,aAAa,CAAC,WAAW,CAAC,CAAA;AAClC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAO;IACzC,MAAM,MAAM,GAAG,EAAE,CAAA;IACjB,IAAI,MAAM,GAAG,CAAC,CAAA;IACd,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACzB,IAAI,CAAC,CAAC,CAAC,MAAM;YAAE,SAAQ;QACvB,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG;YAClB,OAAO,EAAE,CAAC,CAAC,MAAM;YACjB,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,EAAE;YAChC,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,SAAS;YAC3B,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,SAAS;YACvC,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,IAAI;YACxB,eAAe,EAAE,CAAC,CAAC,eAAe,IAAI,UAAU;YAChD,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,SAAS;YAC3B,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,IAAI;YAC5B,eAAe,EAAE,CAAC,CAAC,eAAe,IAAI,IAAI;YAC1C,UAAU,EAAE,CAAC,CAAC,UAAU,IAAI,IAAI;YAChC,UAAU,EAAE,CAAC,CAAC,WAAW,IAAI,IAAI;SACjC,CAAA;QACD,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,IAAI,EAAE,CAAC,CAAA;QAC1C,IAAI,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,MAAM;YAAE,MAAM,GAAG,EAAE,CAAA;IACpD,CAAC;IACD,OAAO;QACN,OAAO,EAAE,CAAC;QACV,MAAM;QACN,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KAC9E,CAAA;AACF,CAAC;AAED,4EAA4E;AAC5E,sCAAsC;AACtC,KAAK,QAAQ,CAAA"}

package/dist/cli/coverage-check/acceptance-criteria.d.mts

@@ -0,0 +1,2 @@
+export { parseAcceptanceCriteria, resolveSpecPath } from "../config/coverage-ac.mjs";
+//# sourceMappingURL=acceptance-criteria.d.mts.map

package/dist/cli/coverage-check/acceptance-criteria.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acceptance-criteria.d.mts","sourceRoot":"","sources":["../../../src/cli/coverage-check/acceptance-criteria.mjs"],"names":[],"mappings":""}

package/dist/cli/coverage-check/acceptance-criteria.mjs

@@ -0,0 +1,15 @@
+/**
+ * coverage-check/acceptance-criteria.mjs — C30 canonical home for the
+ * acceptance-criteria parser.
+ *
+ * Historically lived in `bin/apt-tools.mjs` (pre-C29), then moved to
+ * `config/coverage-ac.mjs` as part of the C29 modularization pass. C30
+ * renames the canonical module path to `coverage-check/acceptance-criteria.mjs`
+ * to mirror the command family it serves. The old path re-exports from here
+ * so existing importers keep working.
+ *
+ * Pure, file-IO-free. Tests in src/__tests__/parse-acceptance-criteria.test.ts
+ * import directly from this module (no subprocess, no CLI).
+ */
+export { parseAcceptanceCriteria, resolveSpecPath } from '../config/coverage-ac.mjs';
+//# sourceMappingURL=acceptance-criteria.mjs.map

package/dist/cli/coverage-check/acceptance-criteria.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"acceptance-criteria.mjs","sourceRoot":"","sources":["../../../src/cli/coverage-check/acceptance-criteria.mjs"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,uBAAuB,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA"}

package/dist/cli/design/extract-repo.d.mts

@@ -0,0 +1,69 @@
+/**
+ * Extract design taste from a repo directory.
+ *
+ * @param {string} root — absolute or relative path to the project root
+ * @param {{root?: string, maxFiles?: number, maxFileBytes?: number}} [opts]
+ * @returns {Promise<ExtractedTaste>}
+ */
+export function extractFromRepo(root: string, opts?: {
+    root?: string;
+    maxFiles?: number;
+    maxFileBytes?: number;
+}): Promise<ExtractedTaste>;
+/**
+ * @typedef {{
+ *   colors: { value: string, weight: number, source: 'css' | 'computed' | 'babel' }[],
+ *   fonts:  { family: string, weight: number }[],
+ *   spacing:{ value: string, weight: number }[],
+ *   radii:  { value: string, weight: number }[],
+ *   shadows:{ value: string, weight: number }[],
+ *   motion: { duration?: string[], easing?: string[] },
+ *   screenshots?: { path: string, scrollY: number }[],
+ *   target: string,
+ *   mode: 'url' | 'repo' | 'github'
+ * }} ExtractedTaste
+ */
+/**
+ * Error thrown when a required optional dep is missing. The CLI wrapper
+ * turns this into a `{status:'error', hint:'run pnpm add …'}` envelope.
+ */
+export class TasteInferMissingDep extends Error {
+    constructor(dep: any, underlying: any);
+    dep: any;
+    hint: string;
+    underlying: any;
+}
+export type ExtractedTaste = {
+    colors: {
+        value: string;
+        weight: number;
+        source: "css" | "computed" | "babel";
+    }[];
+    fonts: {
+        family: string;
+        weight: number;
+    }[];
+    spacing: {
+        value: string;
+        weight: number;
+    }[];
+    radii: {
+        value: string;
+        weight: number;
+    }[];
+    shadows: {
+        value: string;
+        weight: number;
+    }[];
+    motion: {
+        duration?: string[];
+        easing?: string[];
+    };
+    screenshots?: {
+        path: string;
+        scrollY: number;
+    }[];
+    target: string;
+    mode: "url" | "repo" | "github";
+};
+//# sourceMappingURL=extract-repo.d.mts.map

package/dist/cli/design/extract-repo.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-repo.d.mts","sourceRoot":"","sources":["../../../src/cli/design/extract-repo.mjs"],"names":[],"mappings":"AAiVA;;;;;;GAMG;AACH,sCAJW,MAAM,SACN;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAC,GACvD,OAAO,CAAC,cAAc,CAAC,CAmKnC;AArYD;;;;;;;;;;;;GAYG;AAEH;;;GAGG;AACH;IACC,uCAMC;IAHA,SAAc;IACd,aAAgG;IAChG,gBAA4B;CAE7B;6BAzBY;IACR,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,KAAK,GAAG,UAAU,GAAG,OAAO,CAAA;KAAE,EAAE,CAAC;IAClF,KAAK,EAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC7C,OAAO,EAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC5C,KAAK,EAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC5C,OAAO,EAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC5C,MAAM,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACnD,WAAW,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAA;CAChC"}