thinkpool-pair 0.7.364 → 0.7.366

package/lane-continuation.mjs

@@ -1,83 +1 @@
-// A continuation is a durable-safe control projection, never a provider
-// transcript or a command to start a new native turn.
-
-import { isSecretFreeRoomPayload, runtimeSupportsCapability } from './runtime-contract.mjs'
-
-const STATES = new Set(['waiting_for_human', 'resumable', 'canceled', 'terminal'])
-const RESUME_KINDS = new Set(['human_response', 'approval', 'redispatch', 'reconnect'])
-const EXECUTION = new Set(['Working', 'Done', 'Failed', 'Canceled'])
-const SAFE_ID = /^[A-Za-z0-9][A-Za-z0-9._:@-]{0,159}$/
-const dispatchers = new WeakSet()
-
-const canonical = (value) => {
-  if (Array.isArray(value)) return value.map(canonical)
-  if (value && typeof value === 'object') return Object.fromEntries(Object.keys(value).sort().map((key) => [key, canonical(value[key])]))
-  return value
-}
-const same = (a, b) => JSON.stringify(canonical(a)) === JSON.stringify(canonical(b))
-const safeId = (value) => typeof value === 'string' && SAFE_ID.test(value)
-const denied = (code) => Object.freeze({ ok: false, code })
-const clone = (value) => {
-  const freeze = (node) => {
-    if (node && typeof node === 'object') {
-      for (const child of Object.values(node)) freeze(child)
-      Object.freeze(node)
-    }
-    return node
-  }
-  return freeze(canonical(value))
-}
-
-export function isSafeContinuationProjection (record) {
-  if (!record || typeof record !== 'object' || Array.isArray(record) || record.version !== 1 || !safeId(record.id) || !safeId(record.laneRef) || !safeId(record.roomCode) || !safeId(record.authorityRef)) return false
-  if (!runtimeSupportsCapability(record.runtime, record.capabilityId) || !STATES.has(record.state) || record.verification !== 'unverified') return false
-  if (record.resumeKind != null && !RESUME_KINDS.has(record.resumeKind)) return false
-  if (record.resumeRef != null && (!record.resumeRef || typeof record.resumeRef !== 'object' || !safeId(record.resumeRef.type) || !safeId(record.resumeRef.id))) return false
-  if (!['canceled', 'terminal'].includes(record.state) && (!record.resumeKind || !record.resumeRef)) return false
-  if (!record.executionBoundary || !EXECUTION.has(record.executionBoundary.state) || !record.executionBoundary.eventRef || !isSecretFreeRoomPayload(record.executionBoundary.eventRef, 2048)) return false
-  if (record.expiresAt != null && (!Number.isSafeInteger(record.expiresAt) || record.expiresAt <= 0)) return false
-  return isSecretFreeRoomPayload(record, 8192)
-}
-
-export function createContinuationDispatcher ({ roomCode, authorityRef, now = () => Date.now() } = {}) {
-  if (!safeId(roomCode) || !safeId(authorityRef) || typeof now !== 'function') throw new TypeError('Invalid continuation dispatcher authority')
-  const records = new Map()
-  const dispatcher = {
-    create (record) {
-      const next = { ...record, version: 1, roomCode, authorityRef, verification: 'unverified' }
-      if (!isSafeContinuationProjection(next)) return denied('invalid_continuation')
-      const prior = records.get(next.id)
-      if (prior) return same(prior, next) ? Object.freeze({ ok: true, code: 'idempotent', record: prior }) : denied('continuation_conflict')
-      const frozen = clone(next)
-      records.set(frozen.id, frozen)
-      return Object.freeze({ ok: true, code: 'created', record: frozen })
-    },
-    consume ({ id, roomCode: consumeRoom, authorityRef: consumeAuthority, control } = {}) {
-      const record = records.get(id)
-      if (!record) return denied('unknown_continuation')
-      if (consumeRoom !== roomCode || consumeAuthority !== authorityRef) return denied('continuation_authority_mismatch')
-      if (record.state === 'canceled') return denied('continuation_canceled')
-      if (record.state === 'terminal') return denied('continuation_terminal')
-      if (record.expiresAt != null && now() > record.expiresAt) return denied('continuation_stale')
-      if (!control || control.authorized !== true || control.roomCode !== roomCode || control.authorityRef !== authorityRef || !same(control.resumeRef, record.resumeRef)) return denied('continuation_control_unverified')
-      // The adapter must explicitly act on this intent. Returning it is not an
-      // auto-resume and cannot fabricate an execution or verification result.
-      return Object.freeze({ ok: true, code: 'resume_intent', record, resumeIntent: Object.freeze({ runtime: record.runtime, laneRef: record.laneRef, resumeKind: record.resumeKind, resumeRef: record.resumeRef }) })
-    },
-    cancel ({ id, roomCode: cancelRoom, authorityRef: cancelAuthority, reason = 'interrupt' } = {}) {
-      const record = records.get(id)
-      if (!record) return denied('unknown_continuation')
-      if (cancelRoom !== roomCode || cancelAuthority !== authorityRef) return denied('continuation_authority_mismatch')
-      if (record.state === 'canceled') return Object.freeze({ ok: true, code: 'idempotent_cancel', record })
-      // Do not preserve an arbitrary reason string: it might be provider prose.
-      // The canceled execution boundary is the safe observable fact.
-      const canceled = clone({ ...record, state: 'canceled', resumeKind: null, resumeRef: null, executionBoundary: { ...record.executionBoundary, state: 'Canceled' }, verification: 'unverified' })
-      records.set(id, canceled)
-      return Object.freeze({ ok: true, code: 'canceled', record: canceled })
-    },
-  }
-  dispatchers.add(dispatcher)
-  return Object.freeze(dispatcher)
-}
-
-export const isBridgeContinuationDispatcher = (value) => dispatchers.has(value)
+import{isSecretFreeRoomPayload as e,runtimeSupportsCapability as t}from"./runtime-contract.mjs";const n=new Set(["waiting_for_human","resumable","canceled","terminal"]),r=new Set(["human_response","approval","redispatch","reconnect"]),o=new Set(["Working","Done","Failed","Canceled"]),i=/^[A-Za-z0-9][A-Za-z0-9._:@-]{0,159}$/,a=new WeakSet,c=e=>Array.isArray(e)?e.map(c):e&&"object"==typeof e?Object.fromEntries(Object.keys(e).sort().map(t=>[t,c(e[t])])):e,u=(e,t)=>JSON.stringify(c(e))===JSON.stringify(c(t)),s=e=>"string"==typeof e&&i.test(e),f=e=>Object.freeze({ok:!1,code:e}),d=e=>{const t=e=>{if(e&&"object"==typeof e){for(const n of Object.values(e))t(n);Object.freeze(e)}return e};return t(c(e))};export function isSafeContinuationProjection(i){return!!(i&&"object"==typeof i&&!Array.isArray(i)&&1===i.version&&s(i.id)&&s(i.laneRef)&&s(i.roomCode)&&s(i.authorityRef))&&!(!t(i.runtime,i.capabilityId)||!n.has(i.state)||"unverified"!==i.verification)&&!(null!=i.resumeKind&&!r.has(i.resumeKind))&&!!(null==i.resumeRef||i.resumeRef&&"object"==typeof i.resumeRef&&s(i.resumeRef.type)&&s(i.resumeRef.id))&&!!(["canceled","terminal"].includes(i.state)||i.resumeKind&&i.resumeRef)&&!!(i.executionBoundary&&o.has(i.executionBoundary.state)&&i.executionBoundary.eventRef&&e(i.executionBoundary.eventRef,2048))&&!(null!=i.expiresAt&&(!Number.isSafeInteger(i.expiresAt)||i.expiresAt<=0))&&e(i,8192)}export function createContinuationDispatcher({roomCode:e,authorityRef:t,now:n=()=>Date.now()}={}){if(!s(e)||!s(t)||"function"!=typeof n)throw new TypeError("Invalid continuation dispatcher authority");const r=new Map,o={create(n){const o={...n,version:1,roomCode:e,authorityRef:t,verification:"unverified"};if(!isSafeContinuationProjection(o))return f("invalid_continuation");const i=r.get(o.id);if(i)return u(i,o)?Object.freeze({ok:!0,code:"idempotent",record:i}):f("continuation_conflict");const a=d(o);return r.set(a.id,a),Object.freeze({ok:!0,code:"created",record:a})},consume({id:o,roomCode:i,authorityRef:a,control:c}={}){const s=r.get(o);return s?i!==e||a!==t?f("continuation_authority_mismatch"):"canceled"===s.state?f("continuation_canceled"):"terminal"===s.state?f("continuation_terminal"):null!=s.expiresAt&&n()>s.expiresAt?f("continuation_stale"):c&&!0===c.authorized&&c.roomCode===e&&c.authorityRef===t&&u(c.resumeRef,s.resumeRef)?Object.freeze({ok:!0,code:"resume_intent",record:s,resumeIntent:Object.freeze({runtime:s.runtime,laneRef:s.laneRef,resumeKind:s.resumeKind,resumeRef:s.resumeRef})}):f("continuation_control_unverified"):f("unknown_continuation")},cancel({id:n,roomCode:o,authorityRef:i,reason:a="interrupt"}={}){const c=r.get(n);if(!c)return f("unknown_continuation");if(o!==e||i!==t)return f("continuation_authority_mismatch");if("canceled"===c.state)return Object.freeze({ok:!0,code:"idempotent_cancel",record:c});const u=d({...c,state:"canceled",resumeKind:null,resumeRef:null,executionBoundary:{...c.executionBoundary,state:"Canceled"},verification:"unverified"});return r.set(n,u),Object.freeze({ok:!0,code:"canceled",record:u})}};return a.add(o),Object.freeze(o)}export const isBridgeContinuationDispatcher=e=>a.has(e);

package/lane-lifecycle.mjs

@@ -1,189 +1 @@
-import { classifyCodeEvent } from './code-event-contract.mjs'
-import { isSafeContinuationProjection } from './lane-continuation.mjs'
-
-// This file ships in the standalone thinkpool-pair tarball. Keep the canonical
-// vocabulary here rather than importing from ../src (which is not packaged).
-// The browser-side module re-exports these constants from this file.
-export const LIFECYCLE_STATE = Object.freeze({
-  WORKING: 'Working', BLOCKED: 'Blocked', FAILED: 'Failed', DONE: 'Done', CANCELED: 'Canceled',
-})
-export const BLOCKED_REASON = Object.freeze({
-  NEEDS_DECISION: 'needs_decision', NEEDS_INPUT: 'needs_input', DEPENDENCY: 'dependency',
-  OFFLINE: 'offline', STALLED: 'stalled', UNKNOWN_GAP: 'unknown_gap',
-  VERIFICATION_REQUIRED: 'verification_required',
-})
-
-const TERMINAL = new Set([LIFECYCLE_STATE.FAILED, LIFECYCLE_STATE.DONE, LIFECYCLE_STATE.CANCELED])
-const RESULT_CANCELED = new Set(['aborted', 'cancelled', 'canceled', 'interrupted'])
-
-export function canTransitionLifecycle (from, to, { beginsNewWork = false } = {}) {
-  if (!from || from === to) return true
-  if (TERMINAL.has(from)) return beginsNewWork && to === LIFECYCLE_STATE.WORKING
-  return from === LIFECYCLE_STATE.WORKING || from === LIFECYCLE_STATE.BLOCKED
-}
-
-export function transitionLifecycle (current, next, opts = {}) {
-  if (!canTransitionLifecycle(current?.state, next?.state, opts)) {
-    if (opts.strict !== false) throw new TypeError(`Illegal lifecycle transition: ${current?.state} -> ${next?.state}`)
-    return current
-  }
-  return { ...next, rawStatus: next.rawStatus ?? current?.rawStatus ?? null }
-}
-
-// JSON.stringify's array replacer applies at every nesting level. The previous
-// implementation therefore discarded nested assistant blocks/payload fields and
-// could treat two conflicting events as identical. Sort every object recursively
-// so replay identity compares the complete event, not a top-level silhouette.
-const stableEventShape = (event) => JSON.stringify(event, (_key, value) => {
-  if (!value || typeof value !== 'object' || Array.isArray(value)) return value
-  return Object.fromEntries(Object.keys(value).sort().map((key) => [key, value[key]]))
-})
-
-// Replay identity is two-dimensional: cid identifies the optimistic/live event and
-// seq identifies its durable position. A conflict in either dimension is evidence
-// of a split/restarted stream, never a reason to choose whichever array order arrived.
-const normalizeReplayEvents = (events) => {
-  const input = Array.isArray(events) ? events : []
-  const allSequenced = input.every((event) => Number.isFinite(event?.seq))
-  const ordered = input
-    .map((event, sourceIndex) => ({ event, shape: stableEventShape(event), sourceIndex }))
-    .sort((a, b) => {
-      // Old/current optimistic transcript events can legitimately have no seq.
-      // Their array position is the only boundary order; lexical kind sorting
-      // can move a `you` event after its aborted `result` and resurrect a turn.
-      if (!allSequenced) return a.sourceIndex - b.sourceIndex
-      if (a.event.seq !== b.event.seq) return a.event.seq - b.event.seq
-      const at = Number(a.event?.ts) || 0, bt = Number(b.event?.ts) || 0
-      if (at !== bt) return at - bt
-      return String(a.event?.cid || '').localeCompare(String(b.event?.cid || '')) || a.shape.localeCompare(b.shape)
-    })
-  const cids = new Map()
-  const seqs = new Map()
-  const out = []
-  const conflicts = []
-  for (const item of ordered) {
-    const { event, shape } = item
-    const cid = typeof event?.cid === 'string' && event.cid ? event.cid : null
-    const seq = Number.isFinite(event?.seq) ? event.seq : null
-    const cidPrior = cid ? cids.get(cid) : null
-    const seqPrior = seq != null ? seqs.get(seq) : null
-    if (cidPrior || seqPrior) {
-      const prior = cidPrior || seqPrior
-      if (prior.shape !== shape) conflicts.push({ cid, seq, priorCid: prior.cid, priorSeq: prior.seq })
-      continue
-    }
-    const record = { cid, seq, shape }
-    if (cid) cids.set(cid, record)
-    if (seq != null) seqs.set(seq, record)
-    out.push(event)
-  }
-  return { events: out, conflicts }
-}
-
-const base = (state, reason = null, extra = {}) => ({ state, reason, phase: null, freshness: 'current', transport: 'online', rawStatus: null, verified: false, ...extra })
-
-export function projectLaneLifecycle ({
-  events = [], busy = false, pendingCount = 0, pendingReason = null,
-  stalled = false, offline = false, stale = false, failed = false, canceled = false,
-  rawStatus = null, continuation = null,
-} = {}) {
-  let out = base(LIFECYCLE_STATE.BLOCKED, BLOCKED_REASON.NEEDS_INPUT, { rawStatus })
-  const replay = normalizeReplayEvents(events)
-  let unknownEvent = false
-  for (const event of replay.events) {
-    const contract = classifyCodeEvent(event, { strict: false })
-    if (!contract.known) { unknownEvent = true; continue }
-    if (contract.eventClass === 'volatile-presence') continue
-    if (event.kind === 'pool' && (event.transient || event.pending)) {
-      continue
-    }
-    if (event.kind === 'you' || event.kind === 'assistant' || event.kind === 'tool_result' || event.kind === 'pool') {
-      out = base(LIFECYCLE_STATE.WORKING, null, { rawStatus, phase: event.kind })
-    } else if (event.kind === 'propose' || event.kind === 'answer') {
-      out = base(LIFECYCLE_STATE.BLOCKED, BLOCKED_REASON.NEEDS_DECISION, { rawStatus })
-    } else if (event.kind === 'needs-input') {
-      out = base(LIFECYCLE_STATE.BLOCKED, BLOCKED_REASON.NEEDS_INPUT, { rawStatus })
-    } else if (event.kind === 'error') {
-      out = base(LIFECYCLE_STATE.FAILED, null, { rawStatus })
-    } else if (event.kind === 'result') {
-      if (RESULT_CANCELED.has(event.subtype)) out = base(LIFECYCLE_STATE.CANCELED, null, { rawStatus })
-      else if (event.subtype && event.subtype !== 'success') out = base(LIFECYCLE_STATE.FAILED, null, { rawStatus })
-      // A successful result is authoritative for the execution boundary: the
-      // runtime turn finished and the lane is idle. It is not proof that the
-      // worker's findings or changed product behavior were independently
-      // verified. Keep that evidence dimension in `verified`; pair-control
-      // receipts, not transcript claims, are the only authority for upgrading it.
-      else out = base(LIFECYCLE_STATE.DONE, null, { rawStatus })
-    }
-  }
-
-  if (replay.conflicts.length || unknownEvent) out = base(LIFECYCLE_STATE.BLOCKED, BLOCKED_REASON.UNKNOWN_GAP, { rawStatus })
-  else if (failed) out = base(LIFECYCLE_STATE.FAILED, null, { rawStatus })
-  else if (canceled) out = base(LIFECYCLE_STATE.CANCELED, null, { rawStatus })
-  else if (pendingCount > 0) out = base(LIFECYCLE_STATE.BLOCKED, pendingReason || BLOCKED_REASON.NEEDS_DECISION, { rawStatus })
-  // This is explanation only. A continuation cannot certify verification or
-  // resurrect an interrupted/canceled execution boundary.
-  else if (isSafeContinuationProjection(continuation) && !TERMINAL.has(out.state) && continuation.state !== 'terminal') {
-    out = base(LIFECYCLE_STATE.BLOCKED, continuation.state === 'waiting_for_human' ? BLOCKED_REASON.NEEDS_INPUT : BLOCKED_REASON.NEEDS_DECISION, { rawStatus, phase: 'continuation' })
-  }
-  else if (stalled) out = base(LIFECYCLE_STATE.BLOCKED, BLOCKED_REASON.STALLED, { rawStatus, phase: 'stalled' })
-  else if (busy && !TERMINAL.has(out.state)) out = base(LIFECYCLE_STATE.WORKING, null, { rawStatus, phase: out.phase || 'active' })
-  else if (offline && !TERMINAL.has(out.state)) out = base(LIFECYCLE_STATE.BLOCKED, BLOCKED_REASON.OFFLINE, { rawStatus })
-
-  if (offline) out.transport = 'offline'
-  if (stale) out.freshness = 'stale'
-  return Object.freeze(out)
-}
-
-export function projectFlowLifecycle (rawStatus) {
-  switch (rawStatus) {
-    case 'building': case 'dispatched': case 'reviewing': case 'assembling': case 'planning':
-      return base(LIFECYCLE_STATE.WORKING, null, { rawStatus, phase: rawStatus })
-    case 'awaiting_approval': case 'approved':
-      return base(LIFECYCLE_STATE.BLOCKED, BLOCKED_REASON.NEEDS_DECISION, { rawStatus })
-    case 'pending': case 'ready': case 'reverted':
-      return base(LIFECYCLE_STATE.BLOCKED, BLOCKED_REASON.DEPENDENCY, { rawStatus })
-    case 'failed': return base(LIFECYCLE_STATE.FAILED, null, { rawStatus })
-    case 'cancelled': case 'canceled': return base(LIFECYCLE_STATE.CANCELED, null, { rawStatus })
-    // `done` is the Flow execution boundary. Commits and artifacts remain
-    // unverified evidence until an authority-bound receipt observes them.
-    case 'done': return base(LIFECYCLE_STATE.DONE, null, { rawStatus })
-    default: return base(LIFECYCLE_STATE.BLOCKED, BLOCKED_REASON.NEEDS_INPUT, { rawStatus })
-  }
-}
-
-export function projectRecoveryWatermark ({ events = [], epoch = 0, floor = null, gap = null, offline = false, stale = false } = {}) {
-  const replay = normalizeReplayEvents(events)
-  const foreignEpoch = replay.events.some((e) => Number.isFinite(e?.epoch) && e.epoch !== epoch)
-  const seqEvents = replay.events.filter((e) => Number.isFinite(e?.seq) && (!Number.isFinite(e?.epoch) || e.epoch === epoch))
-  const last = seqEvents.reduce((best, e) => !best || e.seq > best.seq ? e : best, null)
-  let unknownGap = gap && Number.isFinite(gap.from) && Number.isFinite(gap.to)
-    ? { from: gap.from, to: gap.to, reason: gap.reason || 'unknown', recoverable: gap.recoverable !== false }
-    : null
-  if (!unknownGap && (replay.conflicts.length || foreignEpoch)) {
-    const seqs = replay.conflicts.map((c) => c.seq).filter(Number.isFinite)
-    unknownGap = {
-      from: seqs.length ? Math.min(...seqs) : null,
-      to: seqs.length ? Math.max(...seqs) : null,
-      reason: replay.conflicts.length ? 'conflicting_event_identity' : 'foreign_epoch',
-      recoverable: true,
-    }
-  }
-  if (!unknownGap && seqEvents.length > 1) {
-    for (let i = 1; i < seqEvents.length; i++) {
-      if (seqEvents[i].seq > seqEvents[i - 1].seq + 1) {
-        unknownGap = { from: seqEvents[i - 1].seq + 1, to: seqEvents[i].seq - 1, reason: 'out_of_order_or_trimmed', recoverable: true }
-        break
-      }
-    }
-  }
-  return Object.freeze({
-    epoch,
-    floor: Number.isFinite(floor) ? floor : null,
-    lastProven: last ? { cid: last.cid || null, seq: last.seq, epoch } : null,
-    unknownGap,
-    freshness: stale ? 'stale' : 'current',
-    transport: offline ? 'offline' : 'online',
-    globalRollbackAvailable: false,
-  })
-}
+import{classifyCodeEvent as e}from"./code-event-contract.mjs";import{isSafeContinuationProjection as t}from"./lane-continuation.mjs";export const LIFECYCLE_STATE=Object.freeze({WORKING:"Working",BLOCKED:"Blocked",FAILED:"Failed",DONE:"Done",CANCELED:"Canceled"});export const BLOCKED_REASON=Object.freeze({NEEDS_DECISION:"needs_decision",NEEDS_INPUT:"needs_input",DEPENDENCY:"dependency",OFFLINE:"offline",STALLED:"stalled",UNKNOWN_GAP:"unknown_gap",VERIFICATION_REQUIRED:"verification_required"});const n=new Set([LIFECYCLE_STATE.FAILED,LIFECYCLE_STATE.DONE,LIFECYCLE_STATE.CANCELED]),s=new Set(["aborted","cancelled","canceled","interrupted"]);export function canTransitionLifecycle(e,t,{beginsNewWork:s=!1}={}){return!e||e===t||(n.has(e)?s&&t===LIFECYCLE_STATE.WORKING:e===LIFECYCLE_STATE.WORKING||e===LIFECYCLE_STATE.BLOCKED)}export function transitionLifecycle(e,t,n={}){if(!canTransitionLifecycle(e?.state,t?.state,n)){if(!1!==n.strict)throw new TypeError(`Illegal lifecycle transition: ${e?.state} -> ${t?.state}`);return e}return{...t,rawStatus:t.rawStatus??e?.rawStatus??null}}const r=e=>JSON.stringify(e,(e,t)=>!t||"object"!=typeof t||Array.isArray(t)?t:Object.fromEntries(Object.keys(t).sort().map(e=>[e,t[e]]))),a=e=>{const t=Array.isArray(e)?e:[],n=t.every(e=>Number.isFinite(e?.seq)),s=t.map((e,t)=>({event:e,shape:r(e),sourceIndex:t})).sort((e,t)=>{if(!n)return e.sourceIndex-t.sourceIndex;if(e.event.seq!==t.event.seq)return e.event.seq-t.event.seq;const s=Number(e.event?.ts)||0,r=Number(t.event?.ts)||0;return s!==r?s-r:String(e.event?.cid||"").localeCompare(String(t.event?.cid||""))||e.shape.localeCompare(t.shape)}),a=new Map,E=new Map,l=[],i=[];for(const e of s){const{event:t,shape:n}=e,s="string"==typeof t?.cid&&t.cid?t.cid:null,r=Number.isFinite(t?.seq)?t.seq:null,o=s?a.get(s):null,c=null!=r?E.get(r):null;if(o||c){const e=o||c;e.shape!==n&&i.push({cid:s,seq:r,priorCid:e.cid,priorSeq:e.seq});continue}const u={cid:s,seq:r,shape:n};s&&a.set(s,u),null!=r&&E.set(r,u),l.push(t)}return{events:l,conflicts:i}},E=(e,t=null,n={})=>({state:e,reason:t,phase:null,freshness:"current",transport:"online",rawStatus:null,verified:!1,...n});export function projectLaneLifecycle({events:r=[],busy:l=!1,pendingCount:i=0,pendingReason:o=null,stalled:c=!1,offline:u=!1,stale:C=!1,failed:L=!1,canceled:S=!1,rawStatus:p=null,continuation:N=null}={}){let T=E(LIFECYCLE_STATE.BLOCKED,BLOCKED_REASON.NEEDS_INPUT,{rawStatus:p});const _=a(r);let f=!1;for(const t of _.events){const n=e(t,{strict:!1});n.known?"volatile-presence"!==n.eventClass&&("pool"===t.kind&&(t.transient||t.pending)||("you"===t.kind||"assistant"===t.kind||"tool_result"===t.kind||"pool"===t.kind?T=E(LIFECYCLE_STATE.WORKING,null,{rawStatus:p,phase:t.kind}):"propose"===t.kind||"answer"===t.kind?T=E(LIFECYCLE_STATE.BLOCKED,BLOCKED_REASON.NEEDS_DECISION,{rawStatus:p}):"needs-input"===t.kind?T=E(LIFECYCLE_STATE.BLOCKED,BLOCKED_REASON.NEEDS_INPUT,{rawStatus:p}):"error"===t.kind?T=E(LIFECYCLE_STATE.FAILED,null,{rawStatus:p}):"result"===t.kind&&(T=s.has(t.subtype)?E(LIFECYCLE_STATE.CANCELED,null,{rawStatus:p}):t.subtype&&"success"!==t.subtype?E(LIFECYCLE_STATE.FAILED,null,{rawStatus:p}):E(LIFECYCLE_STATE.DONE,null,{rawStatus:p})))):f=!0}return _.conflicts.length||f?T=E(LIFECYCLE_STATE.BLOCKED,BLOCKED_REASON.UNKNOWN_GAP,{rawStatus:p}):L?T=E(LIFECYCLE_STATE.FAILED,null,{rawStatus:p}):S?T=E(LIFECYCLE_STATE.CANCELED,null,{rawStatus:p}):i>0?T=E(LIFECYCLE_STATE.BLOCKED,o||BLOCKED_REASON.NEEDS_DECISION,{rawStatus:p}):t(N)&&!n.has(T.state)&&"terminal"!==N.state?T=E(LIFECYCLE_STATE.BLOCKED,"waiting_for_human"===N.state?BLOCKED_REASON.NEEDS_INPUT:BLOCKED_REASON.NEEDS_DECISION,{rawStatus:p,phase:"continuation"}):c?T=E(LIFECYCLE_STATE.BLOCKED,BLOCKED_REASON.STALLED,{rawStatus:p,phase:"stalled"}):l&&!n.has(T.state)?T=E(LIFECYCLE_STATE.WORKING,null,{rawStatus:p,phase:T.phase||"active"}):u&&!n.has(T.state)&&(T=E(LIFECYCLE_STATE.BLOCKED,BLOCKED_REASON.OFFLINE,{rawStatus:p})),u&&(T.transport="offline"),C&&(T.freshness="stale"),Object.freeze(T)}export function projectFlowLifecycle(e){switch(e){case"building":case"dispatched":case"reviewing":case"assembling":case"planning":return E(LIFECYCLE_STATE.WORKING,null,{rawStatus:e,phase:e});case"awaiting_approval":case"approved":return E(LIFECYCLE_STATE.BLOCKED,BLOCKED_REASON.NEEDS_DECISION,{rawStatus:e});case"pending":case"ready":case"reverted":return E(LIFECYCLE_STATE.BLOCKED,BLOCKED_REASON.DEPENDENCY,{rawStatus:e});case"failed":return E(LIFECYCLE_STATE.FAILED,null,{rawStatus:e});case"cancelled":case"canceled":return E(LIFECYCLE_STATE.CANCELED,null,{rawStatus:e});case"done":return E(LIFECYCLE_STATE.DONE,null,{rawStatus:e});default:return E(LIFECYCLE_STATE.BLOCKED,BLOCKED_REASON.NEEDS_INPUT,{rawStatus:e})}}export function projectRecoveryWatermark({events:e=[],epoch:t=0,floor:n=null,gap:s=null,offline:r=!1,stale:E=!1}={}){const l=a(e),i=l.events.some(e=>Number.isFinite(e?.epoch)&&e.epoch!==t),o=l.events.filter(e=>Number.isFinite(e?.seq)&&(!Number.isFinite(e?.epoch)||e.epoch===t)),c=o.reduce((e,t)=>!e||t.seq>e.seq?t:e,null);let u=s&&Number.isFinite(s.from)&&Number.isFinite(s.to)?{from:s.from,to:s.to,reason:s.reason||"unknown",recoverable:!1!==s.recoverable}:null;if(!u&&(l.conflicts.length||i)){const e=l.conflicts.map(e=>e.seq).filter(Number.isFinite);u={from:e.length?Math.min(...e):null,to:e.length?Math.max(...e):null,reason:l.conflicts.length?"conflicting_event_identity":"foreign_epoch",recoverable:!0}}if(!u&&o.length>1)for(let e=1;e<o.length;e++)if(o[e].seq>o[e-1].seq+1){u={from:o[e-1].seq+1,to:o[e].seq-1,reason:"out_of_order_or_trimmed",recoverable:!0};break}return Object.freeze({epoch:t,floor:Number.isFinite(n)?n:null,lastProven:c?{cid:c.cid||null,seq:c.seq,epoch:t}:null,unknownGap:u,freshness:E?"stale":"current",transport:r?"offline":"online",globalRollbackAvailable:!1})}

package/lane-worktree.mjs

@@ -1,77 +1 @@
-// Lifecycle for ordinary bridge-created terminal worktrees. Deletion authority
-// is the persisted managedWorktree record, never a lane's arbitrary cwd.
-import { execFileSync } from 'node:child_process'
-import path from 'node:path'
-import fs from 'node:fs'
-
-const LOCAL_ENV_FILES = ['.env.local', '.env.development.local']
-
-// Git deliberately omits local env files from worktrees. That is correct for
-// version control but wrong for an isolated lane that must build/preview the
-// same app as the main checkout: Vite otherwise compiles `undefined` public
-// client config and the preview dies before React mounts. Link, never copy, the
-// main checkout's existing ignored env files. Missing files are a clean no-op.
-export function linkLocalEnvIntoWorktree({ root, dir, fsImpl = fs } = {}) {
-  const linked = []
-  for (const name of LOCAL_ENV_FILES) {
-    const source = path.join(root, name)
-    const target = path.join(dir, name)
-    try {
-      if (!fsImpl.existsSync?.(source) || fsImpl.existsSync?.(target)) continue
-      fsImpl.symlinkSync?.(source, target)
-      linked.push(name)
-    } catch { /* local env is optional; worktree creation must still succeed */ }
-  }
-  return linked
-}
-
-export function createManagedLaneWorktree({ terminalId, cwd = process.cwd(), git = runGit, fsImpl = fs } = {}) {
-  const id = String(terminalId || '')
-  const short = id.replace(/[^a-zA-Z0-9]/g, '').slice(0, 8)
-  if (!short) throw new Error('terminal id required for managed worktree')
-  const root = String(git(['rev-parse', '--show-toplevel'], cwd) || '').trim()
-  if (!root) throw new Error('not a git repository')
-  const dir = path.join(root, '.thinkpool', 'worktrees', `terminal-${short}`)
-  const branch = `thinkpool/terminal/${short}`
-  const base = resolveLaneBase({ root, git })
-  fsImpl.mkdirSync(path.dirname(dir), { recursive: true })
-  git(['worktree', 'add', '-b', branch, dir, base], root)
-  linkLocalEnvIntoWorktree({ root, dir, fsImpl })
-  return { terminalId: id, root, dir, branch }
-}
-
-// Ordinary lanes should start from the repository's upstream default branch, not
-// whichever parked/stale branch happens to be checked out in the bridge process.
-// Repositories without a remote remain useful: fall back through conventional local
-// defaults and finally HEAD.
-function resolveLaneBase({ root, git }) {
-  for (const candidate of ['origin/HEAD', 'origin/main', 'origin/master', 'main', 'master', 'HEAD']) {
-    try {
-      const resolved = String(git(['rev-parse', '--verify', '--quiet', candidate], root) || '').trim()
-      if (resolved) return candidate
-    } catch { /* try the next base */ }
-  }
-  return 'HEAD'
-}
-
-export function removeManagedLaneWorktree({ terminalId, managedWorktree, git = runGit } = {}) {
-  const id = String(terminalId || '')
-  const rec = managedWorktree && typeof managedWorktree === 'object' ? managedWorktree : null
-  if (!id || !rec || rec.terminalId !== id) return { removed: false, reason: 'not managed by this terminal' }
-
-  const root = path.resolve(String(rec.root || ''))
-  const dir = path.resolve(String(rec.dir || ''))
-  const branch = String(rec.branch || '')
-  const ownedRoot = path.join(root, '.thinkpool', 'worktrees')
-  const short = id.replace(/[^a-zA-Z0-9]/g, '').slice(0, 8)
-  if (!root || dir === ownedRoot || !dir.startsWith(ownedRoot + path.sep)) return { removed: false, reason: 'path outside managed worktrees' }
-  if (!short || !path.basename(dir).includes(short) || !branch.startsWith(`thinkpool/terminal/${short}`)) return { removed: false, reason: 'ownership marker mismatch' }
-
-  try { git(['worktree', 'remove', dir, '--force'], root) } catch { /* already absent */ }
-  try { git(['branch', '-D', branch], root) } catch { /* already absent */ }
-  return { removed: true, dir, branch }
-}
-
-function runGit(args, cwd) {
-  return execFileSync('git', args, { cwd, stdio: ['ignore', 'pipe', 'pipe'], encoding: 'utf8' })
-}
+import{execFileSync as r}from"node:child_process";import e from"node:path";import t from"node:fs";const o=[".env.local",".env.development.local"];export function linkLocalEnvIntoWorktree({root:r,dir:n,fsImpl:i=t}={}){const a=[];for(const t of o){const o=e.join(r,t),c=e.join(n,t);try{if(!i.existsSync?.(o)||i.existsSync?.(c))continue;i.symlinkSync?.(o,c),a.push(t)}catch{}}return a}export function createManagedLaneWorktree({terminalId:r,cwd:o=process.cwd(),git:i=n,fsImpl:a=t}={}){const c=String(r||""),s=c.replace(/[^a-zA-Z0-9]/g,"").slice(0,8);if(!s)throw new Error("terminal id required for managed worktree");const m=String(i(["rev-parse","--show-toplevel"],o)||"").trim();if(!m)throw new Error("not a git repository");const l=e.join(m,".thinkpool","worktrees",`terminal-${s}`),d=`thinkpool/terminal/${s}`,p=function({root:r,git:e}){for(const t of["origin/HEAD","origin/main","origin/master","main","master","HEAD"])try{if(String(e(["rev-parse","--verify","--quiet",t],r)||"").trim())return t}catch{}return"HEAD"}({root:m,git:i});return a.mkdirSync(e.dirname(l),{recursive:!0}),i(["worktree","add","-b",d,l,p],m),linkLocalEnvIntoWorktree({root:m,dir:l,fsImpl:a}),{terminalId:c,root:m,dir:l,branch:d}}export function removeManagedLaneWorktree({terminalId:r,managedWorktree:t,git:o=n}={}){const i=String(r||""),a=t&&"object"==typeof t?t:null;if(!i||!a||a.terminalId!==i)return{removed:!1,reason:"not managed by this terminal"};const c=e.resolve(String(a.root||"")),s=e.resolve(String(a.dir||"")),m=String(a.branch||""),l=e.join(c,".thinkpool","worktrees"),d=i.replace(/[^a-zA-Z0-9]/g,"").slice(0,8);if(!c||s===l||!s.startsWith(l+e.sep))return{removed:!1,reason:"path outside managed worktrees"};if(!d||!e.basename(s).includes(d)||!m.startsWith(`thinkpool/terminal/${d}`))return{removed:!1,reason:"ownership marker mismatch"};try{o(["worktree","remove",s,"--force"],c)}catch{}try{o(["branch","-D",m],c)}catch{}return{removed:!0,dir:s,branch:m}}function n(e,t){return r("git",e,{cwd:t,stdio:["ignore","pipe","pipe"],encoding:"utf8"})}