@miller-tech/uap 1.104.2 → 1.106.0

package/dist/delivery/completion-ledger.js

@@ -0,0 +1,182 @@
+/**
+ * Completion Ledger (Option B) — the persistent, objective "definition of done"
+ * for a huge multi-epic build.
+ *
+ * A single deliver run judges one task; a huge build is many epics/tasks that
+ * can span many turns and many sessions. The ledger externalizes the whole
+ * build's DAG + per-item status to `.uap/completion-ledger.json`, so the
+ * hands-free machinery (Stop-hook block, reactor injection) can answer one
+ * question at any moment: "is the WHOLE build 100% done, and if not, what
+ * remains?" — independent of any model's self-assessment.
+ *
+ * Pure + fail-soft: every reader tolerates a missing/corrupt file by returning
+ * null, so the ledger can never wedge a session on its own.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync, rmSync } from 'fs';
+import { dirname, join } from 'path';
+/** Where the ledger lives for a project. */
+export function ledgerPath(cwd = process.cwd()) {
+    return join(cwd, '.uap', 'completion-ledger.json');
+}
+export function ledgerExists(cwd = process.cwd()) {
+    return existsSync(ledgerPath(cwd));
+}
+/** Load the ledger, or null when absent/unreadable/corrupt (fail-soft). */
+export function loadLedger(cwd = process.cwd()) {
+    try {
+        const p = ledgerPath(cwd);
+        if (!existsSync(p))
+            return null;
+        const raw = JSON.parse(readFileSync(p, 'utf-8'));
+        if (!raw || !Array.isArray(raw.items))
+            return null;
+        return raw;
+    }
+    catch {
+        return null;
+    }
+}
+export function saveLedger(cwd, ledger) {
+    const p = ledgerPath(cwd);
+    mkdirSync(dirname(p), { recursive: true });
+    ledger.updatedAt = nowISO();
+    writeFileSync(p, JSON.stringify(ledger, null, 2) + '\n');
+}
+export function clearLedger(cwd = process.cwd()) {
+    try {
+        const p = ledgerPath(cwd);
+        if (existsSync(p))
+            rmSync(p);
+    }
+    catch {
+        /* best-effort */
+    }
+}
+/**
+ * Create (or replace) the ledger for a mission from a set of items. Existing
+ * items with the same id preserve their status so re-planning is non-destructive.
+ */
+export function initLedger(cwd, mission, items) {
+    const prior = loadLedger(cwd);
+    const priorById = new Map((prior?.items ?? []).map((i) => [i.id, i]));
+    const ledger = {
+        mission: mission.slice(0, 500),
+        createdAt: prior?.createdAt ?? nowISO(),
+        updatedAt: nowISO(),
+        items: items.map((it) => {
+            const existing = priorById.get(it.id);
+            return {
+                id: it.id,
+                title: it.title.slice(0, 200),
+                kind: it.kind ?? 'epic',
+                status: existing?.status ?? 'pending',
+                ...(it.deps && it.deps.length ? { deps: it.deps } : {}),
+                ...(it.criteria && it.criteria.length ? { criteria: it.criteria } : {}),
+                ...(existing?.note ? { note: existing.note } : {}),
+                updatedAt: existing?.updatedAt ?? nowISO(),
+            };
+        }),
+    };
+    saveLedger(cwd, ledger);
+    return ledger;
+}
+/** Update one item's status. No-op (returns false) if the ledger/item is absent. */
+export function markItem(cwd, id, status, note) {
+    const ledger = loadLedger(cwd);
+    if (!ledger)
+        return false;
+    const item = ledger.items.find((i) => i.id === id);
+    if (!item)
+        return false;
+    item.status = status;
+    item.updatedAt = nowISO();
+    if (note !== undefined)
+        item.note = note.slice(0, 300);
+    saveLedger(cwd, ledger);
+    return true;
+}
+/** Items that are not yet done (pending / in_progress / failed). */
+export function remainingItems(ledger) {
+    return ledger.items.filter((i) => i.status !== 'done');
+}
+/** The whole build is complete only when EVERY item is done. */
+export function isComplete(ledger) {
+    return ledger.items.length > 0 && ledger.items.every((i) => i.status === 'done');
+}
+export function progress(ledger) {
+    const total = ledger.items.length;
+    const done = ledger.items.filter((i) => i.status === 'done').length;
+    const failed = ledger.items.filter((i) => i.status === 'failed').length;
+    const pending = total - done - failed;
+    return { total, done, failed, pending, pct: total ? Math.round((done / total) * 100) : 0 };
+}
+/** A compact, model-facing summary of what still needs doing. */
+export function formatRemaining(ledger, max = 12) {
+    const rem = remainingItems(ledger);
+    if (rem.length === 0)
+        return 'All ledger items complete.';
+    const p = progress(ledger);
+    const lines = rem.slice(0, max).map((i) => {
+        const mark = i.status === 'failed' ? 'x' : i.status === 'in_progress' ? '~' : ' ';
+        return `  [${mark}] ${i.id}: ${i.title}${i.note ? ` (${i.note})` : ''}`;
+    });
+    const more = rem.length > max ? `\n  ...and ${rem.length - max} more` : '';
+    return `Build progress ${p.done}/${p.total} (${p.pct}%). REMAINING:\n${lines.join('\n')}${more}`;
+}
+function nowISO() {
+    // Date.now/new Date are fine at runtime (not inside a workflow script).
+    return new Date().toISOString();
+}
+/** Slugify a todo's content into a stable ledger id. */
+function todoSlug(content, index) {
+    const base = content
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 40);
+    return base || `item-${index + 1}`;
+}
+function mapTodoStatus(s) {
+    if (s === 'completed')
+        return 'done';
+    if (s === 'in_progress')
+        return 'in_progress';
+    return 'pending';
+}
+/**
+ * Mirror a model's plan (Claude Code TodoWrite list) into the completion
+ * ledger — the auto-seed for interactive multi-step builds. The todo list IS
+ * the plan-in-progress, with authoritative statuses, so the ledger simply
+ * tracks it: created on first sync, statuses updated on every sync, and the
+ * mission/createdAt preserved across syncs. Duplicate slugs are de-collided.
+ * Returns the resulting ledger, or null when there is nothing to seed.
+ */
+export function syncLedgerFromTodos(cwd, todos, mission) {
+    const clean = (todos || []).filter((t) => t && typeof t.content === 'string' && t.content.trim());
+    if (clean.length === 0)
+        return null;
+    const prior = loadLedger(cwd);
+    const seen = new Set();
+    const items = clean.map((t, i) => {
+        let id = todoSlug(t.content, i);
+        while (seen.has(id))
+            id = `${id}-${i}`;
+        seen.add(id);
+        return {
+            id,
+            title: t.content.trim().slice(0, 200),
+            kind: 'task',
+            status: mapTodoStatus(t.status),
+            updatedAt: nowISO(),
+        };
+    });
+    const ledger = {
+        mission: (prior?.mission || mission || 'Interactive multi-step build').slice(0, 500),
+        createdAt: prior?.createdAt ?? nowISO(),
+        updatedAt: nowISO(),
+        items,
+    };
+    saveLedger(cwd, ledger);
+    return ledger;
+}
+//# sourceMappingURL=completion-ledger.js.map

package/dist/delivery/completion-ledger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion-ledger.js","sourceRoot":"","sources":["../../src/delivery/completion-ledger.ts"],"names":[],"mappings":"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"}

package/dist/delivery/handsfree-config.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Hands-free config resolution — the master switch and active-model lookup for
+ * the persistence machinery (Options A-D). Auto-ON by default: hands-free
+ * persistence applies to any project with an active completion ledger unless
+ * explicitly disabled via `UAP_HANDSFREE=0` or `.uap.json` handsfree.enabled=false.
+ */
+import type { PersistenceConfig } from './persistence-profile.js';
+/** Resolve the persistence config from env + .uap.json (fail-soft, default ON). */
+export declare function loadPersistenceConfig(cwd?: string): PersistenceConfig;
+/** The model doing the work — env override, else the executor role, else unknown. */
+export declare function resolveActiveModel(cwd?: string): string;
+//# sourceMappingURL=handsfree-config.d.ts.map

package/dist/delivery/handsfree-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handsfree-config.d.ts","sourceRoot":"","sources":["../../src/delivery/handsfree-config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,mFAAmF;AACnF,wBAAgB,qBAAqB,CAAC,GAAG,GAAE,MAAsB,GAAG,iBAAiB,CAepF;AAED,qFAAqF;AACrF,wBAAgB,kBAAkB,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,CAWtE"}

package/dist/delivery/handsfree-config.js

@@ -0,0 +1,44 @@
+/**
+ * Hands-free config resolution — the master switch and active-model lookup for
+ * the persistence machinery (Options A-D). Auto-ON by default: hands-free
+ * persistence applies to any project with an active completion ledger unless
+ * explicitly disabled via `UAP_HANDSFREE=0` or `.uap.json` handsfree.enabled=false.
+ */
+import { loadUapConfigRaw } from '../utils/config-loader.js';
+/** Resolve the persistence config from env + .uap.json (fail-soft, default ON). */
+export function loadPersistenceConfig(cwd = process.cwd()) {
+    if (process.env.UAP_HANDSFREE === '0')
+        return { enabled: false };
+    let raw = {};
+    try {
+        raw = loadUapConfigRaw(cwd) ?? {};
+    }
+    catch {
+        raw = {};
+    }
+    const hf = raw.handsfree ?? {};
+    const envIntensity = process.env.UAP_HANDSFREE_INTENSITY;
+    return {
+        enabled: hf.enabled !== false && process.env.UAP_HANDSFREE !== '0',
+        ...(envIntensity ? { intensity: envIntensity } : hf.intensity ? { intensity: hf.intensity } : {}),
+        ...(hf.overrides ? { overrides: hf.overrides } : {}),
+    };
+}
+/** The model doing the work — env override, else the executor role, else unknown. */
+export function resolveActiveModel(cwd = process.cwd()) {
+    if (process.env.UAP_ACTIVE_MODEL)
+        return process.env.UAP_ACTIVE_MODEL;
+    if (process.env.ANTHROPIC_MODEL)
+        return process.env.ANTHROPIC_MODEL;
+    try {
+        const raw = loadUapConfigRaw(cwd) ?? {};
+        const mm = raw.multiModel;
+        if (mm?.roles?.executor)
+            return mm.roles.executor;
+    }
+    catch {
+        /* fall through */
+    }
+    return 'unknown';
+}
+//# sourceMappingURL=handsfree-config.js.map

package/dist/delivery/handsfree-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handsfree-config.js","sourceRoot":"","sources":["../../src/delivery/handsfree-config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAG7D,mFAAmF;AACnF,MAAM,UAAU,qBAAqB,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IAC/D,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,KAAK,GAAG;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACjE,IAAI,GAAG,GAA4B,EAAE,CAAC;IACtC,IAAI,CAAC;QACH,GAAG,GAAI,gBAAgB,CAAC,GAAG,CAA6B,IAAI,EAAE,CAAC;IACjE,CAAC;IAAC,MAAM,CAAC;QACP,GAAG,GAAG,EAAE,CAAC;IACX,CAAC;IACD,MAAM,EAAE,GAAI,GAAG,CAAC,SAA2C,IAAI,EAAE,CAAC;IAClE,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAqE,CAAC;IACvG,OAAO;QACL,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,KAAK,GAAG;QAClE,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjG,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACrD,CAAC;AACJ,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,kBAAkB,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IAC5D,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IACtE,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IACpE,IAAI,CAAC;QACH,MAAM,GAAG,GAAI,gBAAgB,CAAC,GAAG,CAA6B,IAAI,EAAE,CAAC;QACrE,MAAM,EAAE,GAAG,GAAG,CAAC,UAA2D,CAAC;QAC3E,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ;YAAE,OAAO,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACP,kBAAkB;IACpB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/delivery/persistence-profile.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Persistence Profile (Option C) — model-aware hands-free forcing intensity.
+ *
+ * Fable persists on long tasks intrinsically (trained). Frontier chat models
+ * (Opus/Sonnet/GPT) are capable but stop at turn boundaries and declare
+ * premature "done". Small local models (qwen35-a3b) additionally loop and
+ * mis-declare completion. So the EXTERNAL forcing the harness applies should
+ * scale inversely with the model's intrinsic persistence: trust Fable, nudge
+ * the frontier, firmly drive the local model — while every profile keeps the
+ * anti-spin safeguards (bounded blocks + stagnation give-up) so "never stop
+ * early" never becomes "spin forever".
+ *
+ * Pure + fail-soft: resolution never throws; unknown models get the safe
+ * `moderate` default.
+ */
+export type PersistenceIntensity = 'off' | 'light' | 'moderate' | 'aggressive';
+export type ModelFamily = 'fable' | 'frontier' | 'local' | 'unknown';
+export interface PersistenceProfile {
+    model: string;
+    family: ModelFamily;
+    intensity: PersistenceIntensity;
+    /** Whether the Stop hook may block session-end while the build is incomplete. */
+    stopHookBlocks: boolean;
+    /** Hard cap on consecutive Stop-hook blocks before giving up (anti-wedge). */
+    maxBlocks: number;
+    /** Consecutive no-progress blocks that trigger give-up + escalation. */
+    stagnationLimit: number;
+    /** Whether to inject the strong autonomy directive into interactive prompts. */
+    injectAutonomy: boolean;
+}
+/** Classify a model id into a persistence family by name heuristics. */
+export declare function classifyModelFamily(modelId: string): ModelFamily;
+export interface PersistenceConfig {
+    /** hands-free master switch; default ON (auto-applied). */
+    enabled?: boolean;
+    /** force a specific intensity regardless of model. */
+    intensity?: PersistenceIntensity;
+    /** per-model overrides keyed by model id substring. */
+    overrides?: Record<string, Partial<PersistenceProfile>>;
+}
+/**
+ * Resolve the effective persistence profile for a model. `off` when hands-free
+ * is disabled. An explicit `intensity` (env/config) overrides the family
+ * default; per-model overrides refine individual fields.
+ */
+export declare function resolvePersistenceProfile(modelId: string | undefined, cfg?: PersistenceConfig): PersistenceProfile;
+//# sourceMappingURL=persistence-profile.d.ts.map

package/dist/delivery/persistence-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence-profile.d.ts","sourceRoot":"","sources":["../../src/delivery/persistence-profile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,OAAO,GAAG,UAAU,GAAG,YAAY,CAAC;AAC/E,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,CAAC;AAErE,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,oBAAoB,CAAC;IAChC,iFAAiF;IACjF,cAAc,EAAE,OAAO,CAAC;IACxB,8EAA8E;IAC9E,SAAS,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,eAAe,EAAE,MAAM,CAAC;IACxB,gFAAgF;IAChF,cAAc,EAAE,OAAO,CAAC;CACzB;AAmBD,wEAAwE;AACxE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAMhE;AAeD,MAAM,WAAW,iBAAiB;IAChC,2DAA2D;IAC3D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,sDAAsD;IACtD,SAAS,CAAC,EAAE,oBAAoB,CAAC;IACjC,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC;CACzD;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,GAAG,GAAE,iBAAsB,GAC1B,kBAAkB,CAqBpB"}

package/dist/delivery/persistence-profile.js

@@ -0,0 +1,78 @@
+/**
+ * Persistence Profile (Option C) — model-aware hands-free forcing intensity.
+ *
+ * Fable persists on long tasks intrinsically (trained). Frontier chat models
+ * (Opus/Sonnet/GPT) are capable but stop at turn boundaries and declare
+ * premature "done". Small local models (qwen35-a3b) additionally loop and
+ * mis-declare completion. So the EXTERNAL forcing the harness applies should
+ * scale inversely with the model's intrinsic persistence: trust Fable, nudge
+ * the frontier, firmly drive the local model — while every profile keeps the
+ * anti-spin safeguards (bounded blocks + stagnation give-up) so "never stop
+ * early" never becomes "spin forever".
+ *
+ * Pure + fail-soft: resolution never throws; unknown models get the safe
+ * `moderate` default.
+ */
+const PROFILES = {
+    // Fable — trust intrinsic persistence; keep only a light safety net.
+    light: { intensity: 'light', stopHookBlocks: true, maxBlocks: 3, stagnationLimit: 2, injectAutonomy: false },
+    // Opus/Sonnet/GPT — nudge past premature-done; moderate blocking.
+    moderate: { intensity: 'moderate', stopHookBlocks: true, maxBlocks: 6, stagnationLimit: 3, injectAutonomy: true },
+    // qwen / small local — firmly drive; more blocks tolerated, tighter stagnation.
+    aggressive: { intensity: 'aggressive', stopHookBlocks: true, maxBlocks: 9, stagnationLimit: 3, injectAutonomy: true },
+};
+const OFF_PROFILE = {
+    intensity: 'off',
+    stopHookBlocks: false,
+    maxBlocks: 0,
+    stagnationLimit: 0,
+    injectAutonomy: false,
+};
+/** Classify a model id into a persistence family by name heuristics. */
+export function classifyModelFamily(modelId) {
+    const m = (modelId || '').toLowerCase();
+    if (m.includes('fable'))
+        return 'fable';
+    if (/qwen|a3b|llama|gemma|mistral|deepseek|local|small|3b|7b|8b|14b|32b|35b/.test(m))
+        return 'local';
+    if (/opus|sonnet|claude|gpt|o1|o3|gemini|grok|haiku/.test(m))
+        return 'frontier';
+    return 'unknown';
+}
+function familyIntensity(family) {
+    switch (family) {
+        case 'fable':
+            return 'light';
+        case 'local':
+            return 'aggressive';
+        case 'frontier':
+            return 'moderate';
+        default:
+            return 'moderate';
+    }
+}
+/**
+ * Resolve the effective persistence profile for a model. `off` when hands-free
+ * is disabled. An explicit `intensity` (env/config) overrides the family
+ * default; per-model overrides refine individual fields.
+ */
+export function resolvePersistenceProfile(modelId, cfg = {}) {
+    const model = modelId || 'unknown';
+    const family = classifyModelFamily(model);
+    if (cfg.enabled === false) {
+        return { model, family, ...OFF_PROFILE };
+    }
+    const intensity = cfg.intensity ?? familyIntensity(family);
+    const base = intensity === 'off' ? OFF_PROFILE : PROFILES[intensity];
+    let profile = { model, family, ...base, intensity };
+    // Apply any per-model override whose key is a substring of the model id.
+    if (cfg.overrides) {
+        for (const [key, ov] of Object.entries(cfg.overrides)) {
+            if (model.toLowerCase().includes(key.toLowerCase())) {
+                profile = { ...profile, ...ov, model, family };
+            }
+        }
+    }
+    return profile;
+}
+//# sourceMappingURL=persistence-profile.js.map

package/dist/delivery/persistence-profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence-profile.js","sourceRoot":"","sources":["../../src/delivery/persistence-profile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAmBH,MAAM,QAAQ,GAA+F;IAC3G,qEAAqE;IACrE,KAAK,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,cAAc,EAAE,KAAK,EAAE;IAC5G,kEAAkE;IAClE,QAAQ,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE;IACjH,gFAAgF;IAChF,UAAU,EAAE,EAAE,SAAS,EAAE,YAAY,EAAE,cAAc,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE;CACtH,CAAC;AAEF,MAAM,WAAW,GAAiD;IAChE,SAAS,EAAE,KAAK;IAChB,cAAc,EAAE,KAAK;IACrB,SAAS,EAAE,CAAC;IACZ,eAAe,EAAE,CAAC;IAClB,cAAc,EAAE,KAAK;CACtB,CAAC;AAEF,wEAAwE;AACxE,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,MAAM,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IACxC,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IACxC,IAAI,wEAAwE,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,OAAO,CAAC;IACrG,IAAI,gDAAgD,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,UAAU,CAAC;IAChF,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,eAAe,CAAC,MAAmB;IAC1C,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,OAAO;YACV,OAAO,OAAO,CAAC;QACjB,KAAK,OAAO;YACV,OAAO,YAAY,CAAC;QACtB,KAAK,UAAU;YACb,OAAO,UAAU,CAAC;QACpB;YACE,OAAO,UAAU,CAAC;IACtB,CAAC;AACH,CAAC;AAWD;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CACvC,OAA2B,EAC3B,MAAyB,EAAE;IAE3B,MAAM,KAAK,GAAG,OAAO,IAAI,SAAS,CAAC;IACnC,MAAM,MAAM,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAE1C,IAAI,GAAG,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;QAC1B,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE,CAAC;IAC3C,CAAC;IAED,MAAM,SAAS,GAAyB,GAAG,CAAC,SAAS,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;IACjF,MAAM,IAAI,GAAG,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IACrE,IAAI,OAAO,GAAuB,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,CAAC;IAExE,yEAAyE;IACzE,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;QAClB,KAAK,MAAM,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YACtD,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;gBACpD,OAAO,GAAG,EAAE,GAAG,OAAO,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;YACjD,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miller-tech/uap",
-  "version": "1.104.2",
+  "version": "1.106.0",
   "description": "Autonomous AI agent memory system with CLAUDE.md protocol enforcement",
   "type": "module",
   "main": "dist/index.js",

package/templates/hooks/session-start.sh

@@ -241,6 +241,15 @@ if [ -f "$TASK_DB" ] && [ "$TASK_BLOCKED" -gt 0 ]; then
   fi
 fi
 
+# Hands-free auto-resume: surface an in-progress build's remaining work so the
+# session picks it back up without being asked. Silent when nothing is pending.
+if command -v uap >/dev/null 2>&1; then
+  resume_banner="$( ( cd "$PROJECT_DIR" 2>/dev/null && uap handsfree resume-banner 2>/dev/null ) || true )"
+  if [ -n "$resume_banner" ]; then
+    output+=$'\n'"$resume_banner"$'\n'
+  fi
+fi
+
 if [ -n "$output" ]; then
   echo "$output"
 fi

package/templates/hooks/uap-todo-ledger.sh

@@ -0,0 +1,12 @@
+#!/usr/bin/env bash
+# UAP Hands-free auto-seed — PostToolUse(TodoWrite)
+# Mirror the model's plan (TodoWrite todo list) into the completion ledger so an
+# interactive multi-step build auto-seeds a ledger with zero manual `init`.
+# Silent, fail-open: never blocks or perturbs the session.
+set -uo pipefail
+PROJECT_DIR="${CLAUDE_PROJECT_DIR:-${FACTORY_PROJECT_DIR:-${CURSOR_PROJECT_DIR:-.}}}"
+INPUT="$(timeout 2 cat 2>/dev/null || true)"
+if command -v uap >/dev/null 2>&1; then
+  ( cd "$PROJECT_DIR" && printf '%s' "$INPUT" | uap handsfree sync-todos >/dev/null 2>&1 ) || true
+fi
+exit 0