kairo-mcp 1.3.0

package/dist/core/continuation/continuationBuilder.js

@@ -0,0 +1,184 @@
+import { unresolvedErrors } from '../session/reducer.js';
+import { resolveBudget, clip } from '../brief/budget.js';
+export function buildContinuationMarkdown(cp, opts = {}) {
+    const budget = opts.budget ?? resolveBudget('normal');
+    const md = budget.mode === 'tiny' ? renderTiny(cp, budget) : renderFull(cp, budget);
+    // Budget-truncate from the tail — critical sections are front-loaded.
+    return clip(md, budget.maxBriefChars);
+}
+function renderTiny(cp, b) {
+    const L = [];
+    L.push('# Kairo Continuation Brief (tiny)');
+    L.push('');
+    L.push(`- **Task:** ${cp.task || '_unspecified_'}`);
+    L.push(`- **Stop point:** ${cp.reason} · risk ${cp.risk.level.toUpperCase()} · pressure ${cp.pressure.directive}`);
+    L.push(`- **Files changed:** ${cp.changedFiles.length}` +
+        (cp.changedFiles.length === 0
+            ? ''
+            : ` — top: ${[...cp.changedFiles]
+                .sort((a, b) => rank(b) - rank(a))
+                .slice(0, 5)
+                .map((f) => f.path)
+                .join(', ')}`));
+    const next = recommendNextActions(cp).slice(0, 3);
+    if (next.length > 0) {
+        L.push('- **Next:**');
+        for (const a of next)
+            L.push(`  1. ${a}`);
+    }
+    const warnings = [];
+    for (const e of cp.unresolvedErrors.slice(0, b.maxWarnings))
+        warnings.push(`⚠️ ${e.message}`);
+    for (const f of cp.risk.factors
+        .filter((r) => r.level !== 'low')
+        .slice(0, b.maxWarnings - warnings.length)) {
+        warnings.push(`⚠️ ${f.detail}`);
+    }
+    if (warnings.length > 0) {
+        L.push('- **Critical warnings:**');
+        for (const w of warnings)
+            L.push(`  - ${w}`);
+    }
+    return L.join('\n');
+}
+function renderFull(cp, b) {
+    const isNormal = b.mode === 'normal';
+    const L = [];
+    const list = (items, empty) => {
+        if (items.length === 0)
+            L.push(`_${empty}_`);
+        else
+            for (const i of items)
+                L.push(`- ${i}`);
+    };
+    L.push(`# Kairo Continuation Brief`);
+    L.push('');
+    L.push(`> Resume from this brief. Do **not** rescan the whole repository — inspect`);
+    L.push(`> only the files listed below unless they prove insufficient.`);
+    L.push('');
+    L.push(`- **Generated:** ${cp.createdAt}`);
+    L.push(`- **Checkpoint:** \`${cp.id}\` (${cp.reason})`);
+    L.push(`- **Session:** \`${cp.sessionId}\` — agent \`${cp.agent}\``);
+    L.push(`- **Project root:** \`${cp.projectRoot}\``);
+    L.push(`- **Context-loss pressure:** ${cp.pressure.score} → ${cp.pressure.directive}`);
+    L.push('');
+    L.push(`## Task`);
+    L.push(cp.task || '_No task description recorded._');
+    L.push('');
+    L.push(`## Engineering risk at checkpoint`);
+    L.push(`**${cp.risk.level.toUpperCase()}** (score ${cp.risk.score}).`);
+    if (cp.risk.factors.length === 0) {
+        L.push('_No notable risk factors._');
+    }
+    else {
+        for (const f of cp.risk.factors)
+            L.push(`- [${f.level.toUpperCase()}] ${f.detail}`);
+    }
+    L.push('');
+    L.push(`## Completed`);
+    list(cp.completedWork, 'Nothing explicitly marked complete.');
+    L.push('');
+    L.push(`## Remaining work (start here)`);
+    list(cp.remainingWork, 'No remaining work recorded.');
+    L.push('');
+    L.push(`## Blockers`);
+    list(cp.blockers, 'None recorded.');
+    L.push('');
+    L.push(`## Files changed this session — inspect these first`);
+    if (cp.changedFiles.length === 0) {
+        L.push('_No file changes recorded._');
+    }
+    else {
+        L.push('| File | Change | Risk | Touches | Note |');
+        L.push('|---|---|---|---|---|');
+        // Normal mode caps the file table; deep mode shows everything.
+        const cap = isNormal ? 10 : cp.changedFiles.length;
+        const rows = [...cp.changedFiles].sort((a, b) => rank(b) - rank(a)).slice(0, cap);
+        for (const f of rows) {
+            L.push(`| \`${f.path}\` | ${f.changeKind} | ${f.risk.toUpperCase()} | ${f.touches} | ${f.note ?? ''} |`);
+        }
+        if (cp.changedFiles.length > rows.length) {
+            L.push(`| _…and ${cp.changedFiles.length - rows.length} more (deep mode shows all)_ | | | | |`);
+        }
+    }
+    L.push('');
+    L.push(`## Key decisions`);
+    if (cp.decisions.length === 0) {
+        L.push('_None recorded._');
+    }
+    else {
+        const cap = isNormal ? 5 : cp.decisions.length;
+        for (const d of cp.decisions.slice(0, cap)) {
+            L.push(`- **${d.summary}**${d.rationale ? ` — ${d.rationale}` : ''}`);
+        }
+        if (cp.decisions.length > cap)
+            L.push(`- _…and ${cp.decisions.length - cap} more._`);
+    }
+    L.push('');
+    L.push(`## Unresolved errors`);
+    if (cp.unresolvedErrors.length === 0) {
+        L.push('_None._');
+    }
+    else {
+        const cap = b.maxWarnings;
+        for (const e of cp.unresolvedErrors.slice(0, cap)) {
+            L.push(`- ${e.message}${e.context ? ` _(context: ${e.context})_` : ''}`);
+        }
+        if (cp.unresolvedErrors.length > cap) {
+            L.push(`- _…and ${cp.unresolvedErrors.length - cap} more._`);
+        }
+    }
+    L.push('');
+    L.push(`## Recommended next actions`);
+    for (const a of recommendNextActions(cp))
+        L.push(`1. ${a}`);
+    L.push('');
+    L.push(`## Cooperation contract`);
+    L.push(`- Call \`kairo_session_start\` first; it returns this brief so you skip rescanning.`);
+    L.push(`- Record file changes/decisions/errors via \`kairo_record\` as you go.`);
+    L.push(`- Call \`kairo_heartbeat\` every few steps (note any file you re-read).`);
+    L.push(`- When Kairo returns \`CHECKPOINT_NOW\`, call \`kairo_checkpoint\` before risky work.`);
+    L.push('');
+    return L.join('\n');
+}
+function rank(f) {
+    const r = f.risk === 'high' ? 200 : f.risk === 'medium' ? 100 : 0;
+    return r + f.touches;
+}
+function recommendNextActions(cp) {
+    const actions = [];
+    if (cp.unresolvedErrors.length > 0) {
+        actions.push(`Resolve the ${cp.unresolvedErrors.length} unresolved error(s) before new feature work.`);
+    }
+    if (cp.blockers.length > 0) {
+        actions.push(`Clear blockers: ${cp.blockers.join('; ')}.`);
+    }
+    const firstRemaining = cp.remainingWork[0];
+    if (firstRemaining) {
+        // rc1 dogfood polish: strip a trailing period before re-adding one (avoids "..");
+        // skip when the remaining item is the auto-injected error-investigation boilerplate
+        // (already covered by the "Resolve N unresolved errors" action above).
+        const trimmed = firstRemaining.replace(/\.+\s*$/, '');
+        const isErrorBoilerplate = /^Investigate and resolve outstanding errors/.test(trimmed);
+        if (!isErrorBoilerplate) {
+            actions.push(`Continue remaining work, starting with: ${trimmed}.`);
+        }
+    }
+    const highRisk = cp.changedFiles.filter((f) => f.risk === 'high').map((f) => f.path);
+    if (highRisk.length > 0) {
+        actions.push(`Re-validate high-risk changes before proceeding: ${highRisk.slice(0, 5).join(', ')}.`);
+    }
+    if (actions.length === 0) {
+        actions.push('Confirm the task is complete and run the test suite, then kairo_session_end.');
+    }
+    return actions;
+}
+/** Derives the remaining-work list for a checkpoint from session state. */
+export function deriveRemaining(state, explicit) {
+    const remaining = [...(explicit ?? []), ...state.pendingWork];
+    if (unresolvedErrors(state) > 0 && remaining.length === 0) {
+        remaining.push('Investigate and resolve outstanding errors (see Unresolved errors).');
+    }
+    return [...new Set(remaining)];
+}
+//# sourceMappingURL=continuationBuilder.js.map

package/dist/core/continuation/continuationBuilder.js.map

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

package/dist/core/coordination/coordinationManager.d.ts

@@ -0,0 +1,34 @@
+import type { StorageAdapter } from '../../storage/storageAdapter.js';
+import type { Clock } from '../../utils/time.js';
+import type { RepoGraph } from '../graph/types.js';
+import type { CoordinationState, LeaseDecision, LeaseScopeKind, TimelineCheckpoint } from './types.js';
+/**
+ * Projects coordination state from the shared event log and appends coordination
+ * events (ADR-0007). Pure projection → deterministic; conflict resolution is by log
+ * order (earliest overlapping lease wins). Cooperative: a denied acquire is advisory.
+ */
+export declare class CoordinationManager {
+    private readonly adapter;
+    private readonly clock;
+    constructor(adapter: StorageAdapter, clock: Clock);
+    private append;
+    static scopesOverlap(kind: LeaseScopeKind, a: string, b: string): boolean;
+    /** Deterministic left-fold of coordination events → state at `asOf`. */
+    state(asOfMs?: number): Promise<CoordinationState>;
+    /** sessionId → namespace, from `worker.registered` events (for memory isolation). */
+    sessionNamespaceMap(): Promise<Map<string, string>>;
+    registerWorker(sessionId: string, workerId: string, namespace: string, agent: string): Promise<void>;
+    acquire(args: {
+        sessionId: string;
+        workerId: string;
+        scopeKind: LeaseScopeKind;
+        scope: string;
+        ttlMs: number;
+    }): Promise<LeaseDecision>;
+    renew(sessionId: string, workerId: string, leaseId: string, ttlMs: number): Promise<LeaseDecision>;
+    release(sessionId: string, workerId: string, leaseId: string): Promise<LeaseDecision>;
+    /** The distributed checkpoint DAG across workers/sessions. */
+    timeline(): Promise<TimelineCheckpoint[]>;
+    timelineGraph(): Promise<RepoGraph>;
+}
+//# sourceMappingURL=coordinationManager.d.ts.map

package/dist/core/coordination/coordinationManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinationManager.d.ts","sourceRoot":"","sources":["../../../src/core/coordination/coordinationManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAItE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAEjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EACV,iBAAiB,EAEjB,aAAa,EACb,cAAc,EACd,kBAAkB,EAEnB,MAAM,YAAY,CAAC;AAIpB;;;;GAIG;AACH,qBAAa,mBAAmB;IAE5B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBADL,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,KAAK;YAGjB,MAAM;IAgBpB,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,cAAc,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO;IASzE,wEAAwE;IAClE,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA+ExD,qFAAqF;IAC/E,mBAAmB,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAWnD,cAAc,CAClB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC;IAIV,OAAO,CAAC,IAAI,EAAE;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,cAAc,CAAC;QAC1B,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;KACf,GAAG,OAAO,CAAC,aAAa,CAAC;IA2DpB,KAAK,CACT,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,aAAa,CAAC;IAkBnB,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAc3F,8DAA8D;IACxD,QAAQ,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAuBzC,aAAa,IAAI,OAAO,CAAC,SAAS,CAAC;CAwB1C"}

package/dist/core/coordination/coordinationManager.js

@@ -0,0 +1,253 @@
+import { EVENT_SCHEMA_VERSION } from '../../types/events.js';
+import { newId } from '../../utils/ids.js';
+/**
+ * Projects coordination state from the shared event log and appends coordination
+ * events (ADR-0007). Pure projection → deterministic; conflict resolution is by log
+ * order (earliest overlapping lease wins). Cooperative: a denied acquire is advisory.
+ */
+export class CoordinationManager {
+    adapter;
+    clock;
+    constructor(adapter, clock) {
+        this.adapter = adapter;
+        this.clock = clock;
+    }
+    async append(sessionId, type, payload) {
+        const event = {
+            schema: EVENT_SCHEMA_VERSION,
+            id: newId(this.clock.now()),
+            ts: this.clock.iso(),
+            sessionId,
+            type,
+            payload,
+        };
+        await this.adapter.appendEvent(event);
+    }
+    static scopesOverlap(kind, a, b) {
+        const x = a.trim().toLowerCase();
+        const y = b.trim().toLowerCase();
+        if (kind === 'task')
+            return x === y;
+        // path / module: identical, or one is an ancestor of the other.
+        if (x === y)
+            return true;
+        return x.startsWith(`${y}/`) || y.startsWith(`${x}/`);
+    }
+    /** Deterministic left-fold of coordination events → state at `asOf`. */
+    async state(asOfMs) {
+        // Append order is causal truth on a single shared log. Array.sort is stable, so
+        // ordering by ts ALONE keeps append order for equal timestamps (e.g. fixed clock
+        // / same-ms appends) — sorting by id too would corrupt causality.
+        const events = (await this.adapter.readEvents())
+            .filter((e) => e.type.startsWith('worker.') || e.type.startsWith('lease.'))
+            .sort((p, q) => (p.ts < q.ts ? -1 : p.ts > q.ts ? 1 : 0));
+        const asOf = asOfMs ?? this.clock.now();
+        const workers = new Map();
+        const leases = new Map();
+        const activeAt = (l, atIso) => l.status === 'active' && Date.parse(l.expiresAt) > Date.parse(atIso);
+        for (const e of events) {
+            if (e.type === 'worker.registered') {
+                const p = e.payload;
+                workers.set(p.workerId, {
+                    workerId: p.workerId,
+                    namespace: p.namespace,
+                    agent: p.agent,
+                    lastSeen: e.ts,
+                });
+            }
+            else if (e.type === 'lease.acquired') {
+                const p = e.payload;
+                const w = workers.get(p.workerId);
+                if (w)
+                    w.lastSeen = e.ts;
+                const lease = {
+                    id: p.leaseId,
+                    workerId: p.workerId,
+                    scopeKind: p.scopeKind,
+                    scope: p.scope,
+                    acquiredAt: p.acquiredAt,
+                    expiresAt: new Date(Date.parse(p.acquiredAt) + p.ttlMs).toISOString(),
+                    status: 'active',
+                };
+                // Earliest overlapping holder (different worker) wins → this one superseded.
+                for (const other of leases.values()) {
+                    if (other.workerId !== lease.workerId &&
+                        activeAt(other, e.ts) &&
+                        other.scopeKind === lease.scopeKind &&
+                        CoordinationManager.scopesOverlap(lease.scopeKind, lease.scope, other.scope)) {
+                        lease.status = 'superseded';
+                        lease.supersededBy = other.id;
+                        break;
+                    }
+                }
+                leases.set(lease.id, lease);
+            }
+            else if (e.type === 'lease.renewed') {
+                const p = e.payload;
+                const l = leases.get(p.leaseId);
+                if (l && l.workerId === p.workerId && l.status === 'active') {
+                    l.expiresAt = new Date(Date.parse(p.renewedAt) + p.ttlMs).toISOString();
+                }
+            }
+            else if (e.type === 'lease.released') {
+                const p = e.payload;
+                const l = leases.get(p.leaseId);
+                if (l && l.workerId === p.workerId && l.status === 'active')
+                    l.status = 'released';
+            }
+        }
+        for (const l of leases.values()) {
+            if (l.status === 'active' && Date.parse(l.expiresAt) <= asOf)
+                l.status = 'expired';
+        }
+        const allLeases = [...leases.values()].sort((a, b) => a.acquiredAt < b.acquiredAt ? -1 : a.acquiredAt > b.acquiredAt ? 1 : a.id < b.id ? -1 : 1);
+        return {
+            asOf: new Date(asOf).toISOString(),
+            workers: [...workers.values()].sort((a, b) => (a.workerId < b.workerId ? -1 : 1)),
+            activeLeases: allLeases.filter((l) => l.status === 'active'),
+            allLeases,
+        };
+    }
+    /** sessionId → namespace, from `worker.registered` events (for memory isolation). */
+    async sessionNamespaceMap() {
+        const m = new Map();
+        for (const e of await this.adapter.readEvents()) {
+            if (e.type === 'worker.registered') {
+                const p = e.payload;
+                m.set(e.sessionId, p.namespace);
+            }
+        }
+        return m;
+    }
+    async registerWorker(sessionId, workerId, namespace, agent) {
+        await this.append(sessionId, 'worker.registered', { workerId, namespace, agent });
+    }
+    async acquire(args) {
+        const st = await this.state();
+        const mineActive = st.activeLeases.find((l) => l.workerId === args.workerId &&
+            l.scopeKind === args.scopeKind &&
+            CoordinationManager.scopesOverlap(args.scopeKind, l.scope, args.scope));
+        if (mineActive) {
+            return { granted: true, lease: mineActive, reason: 'You already hold an overlapping lease.' };
+        }
+        const conflict = st.activeLeases.find((l) => l.workerId !== args.workerId &&
+            l.scopeKind === args.scopeKind &&
+            CoordinationManager.scopesOverlap(args.scopeKind, l.scope, args.scope));
+        if (conflict) {
+            await this.adapter.audit({
+                ts: this.clock.iso(),
+                kind: 'lifecycle',
+                message: `lease denied: ${args.scopeKind}:${args.scope} held by ${conflict.workerId} ` +
+                    `until ${conflict.expiresAt}`,
+            });
+            return {
+                granted: false,
+                conflict,
+                reason: `Scope ${args.scopeKind}:"${args.scope}" is leased by worker ` +
+                    `"${conflict.workerId}" until ${conflict.expiresAt}. Coordinate or wait — ` +
+                    `Kairo advises, it does not preempt (ADR-0002).`,
+            };
+        }
+        const leaseId = newId(this.clock.now());
+        const acquiredAt = this.clock.iso();
+        await this.append(args.sessionId, 'lease.acquired', {
+            leaseId,
+            workerId: args.workerId,
+            scopeKind: args.scopeKind,
+            scope: args.scope,
+            ttlMs: args.ttlMs,
+            acquiredAt,
+        });
+        return {
+            granted: true,
+            reason: `Lease granted on ${args.scopeKind}:"${args.scope}".`,
+            lease: {
+                id: leaseId,
+                workerId: args.workerId,
+                scopeKind: args.scopeKind,
+                scope: args.scope,
+                acquiredAt,
+                expiresAt: new Date(Date.parse(acquiredAt) + args.ttlMs).toISOString(),
+                status: 'active',
+            },
+        };
+    }
+    async renew(sessionId, workerId, leaseId, ttlMs) {
+        const st = await this.state();
+        const lease = st.allLeases.find((l) => l.id === leaseId);
+        if (!lease || lease.workerId !== workerId) {
+            return { granted: false, reason: `No lease ${leaseId} owned by ${workerId}.` };
+        }
+        if (lease.status !== 'active') {
+            return { granted: false, reason: `Lease ${leaseId} is ${lease.status}; re-acquire instead.` };
+        }
+        await this.append(sessionId, 'lease.renewed', {
+            leaseId,
+            workerId,
+            renewedAt: this.clock.iso(),
+            ttlMs,
+        });
+        return { granted: true, reason: `Lease ${leaseId} renewed.` };
+    }
+    async release(sessionId, workerId, leaseId) {
+        const st = await this.state();
+        const lease = st.allLeases.find((l) => l.id === leaseId);
+        if (!lease || lease.workerId !== workerId) {
+            return { granted: false, reason: `No lease ${leaseId} owned by ${workerId}.` };
+        }
+        await this.append(sessionId, 'lease.released', {
+            leaseId,
+            workerId,
+            releasedAt: this.clock.iso(),
+        });
+        return { granted: true, reason: `Lease ${leaseId} released.` };
+    }
+    /** The distributed checkpoint DAG across workers/sessions. */
+    async timeline() {
+        const events = await this.adapter.readEvents();
+        const out = [];
+        for (const e of events) {
+            if (e.type !== 'checkpoint.created')
+                continue;
+            const p = e.payload;
+            const cp = await this.adapter.loadCheckpoint(p.checkpointId);
+            if (!cp)
+                continue;
+            out.push({
+                id: cp.id,
+                workerId: cp.ownerWorkerId ?? cp.agent,
+                sessionId: cp.sessionId,
+                task: cp.task,
+                reason: cp.reason,
+                createdAt: cp.createdAt,
+                ...(cp.parentCheckpointId ? { parentId: cp.parentCheckpointId } : {}),
+            });
+        }
+        return out.sort((a, b) => a.createdAt < b.createdAt ? -1 : a.createdAt > b.createdAt ? 1 : a.id < b.id ? -1 : 1);
+    }
+    async timelineGraph() {
+        const tl = await this.timeline();
+        const nodes = tl.map((c) => ({
+            id: c.id.replace(/[^A-Za-z0-9_]/g, '_').slice(0, 60),
+            label: `${c.workerId}\n${c.task.slice(0, 28)}\n${c.reason}`,
+            group: c.workerId,
+        }));
+        const ids = new Set(tl.map((c) => c.id));
+        const edges = tl
+            .filter((c) => c.parentId && ids.has(c.parentId))
+            .map((c) => ({
+            from: c.parentId.replace(/[^A-Za-z0-9_]/g, '_').slice(0, 60),
+            to: c.id.replace(/[^A-Za-z0-9_]/g, '_').slice(0, 60),
+        }));
+        return {
+            // RepoGraph.kind is cosmetic here; the title/note identify this as the timeline.
+            kind: 'module',
+            title: 'Engineering timeline (distributed checkpoint graph)',
+            nodes,
+            edges,
+            truncated: false,
+            note: 'Checkpoint DAG across workers/sessions (ADR-0007). Deterministic from the shared log.',
+        };
+    }
+}
+//# sourceMappingURL=coordinationManager.js.map

package/dist/core/coordination/coordinationManager.js.map

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

package/dist/core/coordination/types.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Coordinated cognition model (v0.7.0, ADR-0007). Cooperative, deterministic,
+ * file-ledger-based — not a network scheduler.
+ */
+export type LeaseScopeKind = 'task' | 'path' | 'module';
+export type LeaseStatus = 'active' | 'released' | 'expired' | 'superseded';
+export interface Worker {
+    workerId: string;
+    /** Memory namespace; defaults to the workerId (per-worker isolation). */
+    namespace: string;
+    agent: string;
+    /** Last event ts attributed to this worker. */
+    lastSeen: string;
+}
+export interface Lease {
+    id: string;
+    workerId: string;
+    scopeKind: LeaseScopeKind;
+    /** Task string, or a path/module prefix. */
+    scope: string;
+    acquiredAt: string;
+    expiresAt: string;
+    status: LeaseStatus;
+    /** For `superseded`: the lease id that already held an overlapping scope. */
+    supersededBy?: string;
+}
+export interface LeaseDecision {
+    granted: boolean;
+    lease?: Lease;
+    reason: string;
+    /** The active lease that blocked acquisition, if denied. */
+    conflict?: Lease;
+}
+export interface CoordinationState {
+    /** Reference time the projection was evaluated against. */
+    asOf: string;
+    workers: Worker[];
+    /** Currently-active (not released/expired/superseded) leases. */
+    activeLeases: Lease[];
+    /** All leases, any status, for explainability/audit. */
+    allLeases: Lease[];
+}
+export interface TimelineCheckpoint {
+    id: string;
+    workerId: string;
+    sessionId: string;
+    task: string;
+    reason: string;
+    createdAt: string;
+    parentId?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/coordination/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/coordination/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;AACxD,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,YAAY,CAAC;AAE3E,MAAM,WAAW,MAAM;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,cAAc,CAAC;IAC1B,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,WAAW,CAAC;IACpB,6EAA6E;IAC7E,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,KAAK,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,iEAAiE;IACjE,YAAY,EAAE,KAAK,EAAE,CAAC;IACtB,wDAAwD;IACxD,SAAS,EAAE,KAAK,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/core/coordination/types.js

@@ -0,0 +1,6 @@
+/**
+ * Coordinated cognition model (v0.7.0, ADR-0007). Cooperative, deterministic,
+ * file-ledger-based — not a network scheduler.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/coordination/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/coordination/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/core/github/changelog.d.ts

@@ -0,0 +1,9 @@
+import type { SessionState } from '../../types/domain.js';
+import type { ChangelogFragment } from './types.js';
+/**
+ * Builds a Keep-a-Changelog fragment from the session. Decisions drive the prose
+ * (they capture intent); raw file changes are the fallback so a fragment is never
+ * empty. Per ADR-0003 this only produces text — it does not edit CHANGELOG.md.
+ */
+export declare function proposeChangelog(state: SessionState): ChangelogFragment;
+//# sourceMappingURL=changelog.d.ts.map

package/dist/core/github/changelog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog.d.ts","sourceRoot":"","sources":["../../../src/core/github/changelog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,iBAAiB,CAwCvE"}

package/dist/core/github/changelog.js

@@ -0,0 +1,41 @@
+/**
+ * Builds a Keep-a-Changelog fragment from the session. Decisions drive the prose
+ * (they capture intent); raw file changes are the fallback so a fragment is never
+ * empty. Per ADR-0003 this only produces text — it does not edit CHANGELOG.md.
+ */
+export function proposeChangelog(state) {
+    const added = [];
+    const changed = [];
+    const removed = [];
+    const fixed = [];
+    for (const f of Object.values(state.changedFiles)) {
+        if (f.changeKind === 'created')
+            added.push(f.path);
+        else if (f.changeKind === 'deleted')
+            removed.push(f.path);
+        else
+            changed.push(f.path);
+    }
+    for (const e of state.errors) {
+        if (e.resolved)
+            fixed.push(e.message);
+    }
+    // Prefer decisions as the human-readable summary of intent.
+    const decisionLines = state.decisions.map((d) => d.summary);
+    const section = (title, items) => {
+        if (items.length === 0)
+            return [];
+        const uniq = [...new Set(items)].slice(0, 12);
+        return [`### ${title}`, ...uniq.map((i) => `- ${i}`), ''];
+    };
+    const lines = [];
+    if (decisionLines.length > 0) {
+        lines.push(...section('Added / Changed', decisionLines));
+    }
+    lines.push(...section('Added', added), ...section('Changed', changed), ...section('Fixed', fixed), ...section('Removed', removed));
+    if (lines.length === 0) {
+        lines.push('### Changed', '- _No file changes recorded in this session._', '');
+    }
+    return { markdown: lines.join('\n').trim() };
+}
+//# sourceMappingURL=changelog.js.map

package/dist/core/github/changelog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog.js","sourceRoot":"","sources":["../../../src/core/github/changelog.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAmB;IAClD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC;QAClD,IAAI,CAAC,CAAC,UAAU,KAAK,SAAS;YAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;aAC9C,IAAI,CAAC,CAAC,UAAU,KAAK,SAAS;YAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;;YACrD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QAC7B,IAAI,CAAC,CAAC,QAAQ;YAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,4DAA4D;IAC5D,MAAM,aAAa,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAE5D,MAAM,OAAO,GAAG,CAAC,KAAa,EAAE,KAAe,EAAY,EAAE;QAC3D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC9C,OAAO,CAAC,OAAO,KAAK,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IAC5D,CAAC,CAAC;IAEF,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,iBAAiB,EAAE,aAAa,CAAC,CAAC,CAAC;IAC3D,CAAC;IACD,KAAK,CAAC,IAAI,CACR,GAAG,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,EAC1B,GAAG,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,EAC9B,GAAG,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,EAC1B,GAAG,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAC/B,CAAC;IAEF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,aAAa,EAAE,+CAA+C,EAAE,EAAE,CAAC,CAAC;IACjF,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;AAC/C,CAAC"}

package/dist/core/github/commitMessage.d.ts

@@ -0,0 +1,4 @@
+import type { SessionState } from '../../types/domain.js';
+import type { CommitProposal } from './types.js';
+export declare function proposeCommit(state: SessionState, extraSummary?: string): CommitProposal;
+//# sourceMappingURL=commitMessage.d.ts.map