@planu/cli 4.14.1 → 5.0.0

package/dist/engine/session/auto-save.d.ts

@@ -1,18 +0,0 @@
-import type { Session, SessionDecision, SessionFile, SessionActiveSpec } from '../../types/index.js';
-/** Get the current in-memory session (may be null if none started). */
-export declare function getCurrentSession(): Session | null;
-/** Reset module state (for testing). */
-export declare function resetSessionState(): void;
-/** Start or resume a session for a project. */
-export declare function startSession(projectId: string, existingSession?: Session): Session;
-/** Record a tool call and maybe persist (debounce). */
-export declare function onToolCall(projectId: string): Promise<void>;
-/** Add an active spec to the current session. */
-export declare function addActiveSpec(spec: SessionActiveSpec): void;
-/** Add a decision to the current session. */
-export declare function addDecision(decision: SessionDecision): void;
-/** Add a modified file to the current session. */
-export declare function addModifiedFile(file: SessionFile): void;
-/** Force-save the current session to disk (bypasses debounce). */
-export declare function persistCurrentSession(): Promise<void>;
-//# sourceMappingURL=auto-save.d.ts.map

package/dist/engine/session/auto-save.js

@@ -1,98 +0,0 @@
-import * as sessionStore from '../../storage/session-store.js';
-import { randomUUID } from 'node:crypto';
-import { buildContextSnapshot } from './context-snapshot.js';
-import { updateCrossConversationMemory } from './memory-sync.js';
-// --- module state ---
-let currentSession = null;
-let lastSaveTimestamp = 0;
-const DEBOUNCE_MS = 30_000; // 30 seconds
-// --- public API ---
-/** Get the current in-memory session (may be null if none started). */
-export function getCurrentSession() {
-    return currentSession;
-}
-/** Reset module state (for testing). */
-export function resetSessionState() {
-    currentSession = null;
-    lastSaveTimestamp = 0;
-}
-/** Start or resume a session for a project. */
-export function startSession(projectId, existingSession) {
-    if (existingSession) {
-        currentSession = { ...existingSession };
-        return currentSession;
-    }
-    const now = new Date().toISOString();
-    currentSession = {
-        id: randomUUID(),
-        projectId,
-        startedAt: now,
-        lastSavedAt: now,
-        activeSpecs: [],
-        decisions: [],
-        modifiedFiles: [],
-        contextSummary: '',
-        toolCallCount: 0,
-        metadata: {},
-    };
-    return currentSession;
-}
-/** Record a tool call and maybe persist (debounce). */
-export async function onToolCall(projectId) {
-    if (!currentSession) {
-        startSession(projectId);
-    }
-    if (currentSession) {
-        currentSession.toolCallCount++;
-        const now = Date.now();
-        if (now - lastSaveTimestamp >= DEBOUNCE_MS) {
-            await persistCurrentSession();
-            lastSaveTimestamp = now;
-        }
-    }
-}
-/** Add an active spec to the current session. */
-export function addActiveSpec(spec) {
-    if (!currentSession) {
-        return;
-    }
-    const exists = currentSession.activeSpecs.some((s) => s.specId === spec.specId);
-    if (!exists) {
-        currentSession.activeSpecs.push(spec);
-    }
-}
-/** Add a decision to the current session. */
-export function addDecision(decision) {
-    if (!currentSession) {
-        return;
-    }
-    currentSession.decisions.push(decision);
-}
-/** Add a modified file to the current session. */
-export function addModifiedFile(file) {
-    if (!currentSession) {
-        return;
-    }
-    const idx = currentSession.modifiedFiles.findIndex((f) => f.path === file.path);
-    if (idx >= 0) {
-        currentSession.modifiedFiles[idx] = file;
-    }
-    else {
-        currentSession.modifiedFiles.push(file);
-    }
-}
-/** Force-save the current session to disk (bypasses debounce). */
-export async function persistCurrentSession() {
-    if (!currentSession) {
-        return;
-    }
-    currentSession.lastSavedAt = new Date().toISOString();
-    currentSession.contextSummary = buildContextSnapshot(currentSession);
-    await sessionStore.save(currentSession);
-    await updateCrossConversationMemory(currentSession);
-    // Fire-and-forget cleanup
-    void sessionStore.cleanup(currentSession.projectId).catch((err) => {
-        console.error('[planu] session cleanup failed:', err);
-    });
-}
-//# sourceMappingURL=auto-save.js.map

package/dist/engine/session/context-snapshot.d.ts

@@ -1,8 +0,0 @@
-import type { Session } from '../../types/index.js';
-/**
- * Build a markdown context summary from the current session state.
- * Includes: specs in progress, last 5 modified files, last 3 decisions.
- * Truncated to 2000 chars max.
- */
-export declare function buildContextSnapshot(session: Session): string;
-//# sourceMappingURL=context-snapshot.d.ts.map

package/dist/engine/session/context-snapshot.js

@@ -1,49 +0,0 @@
-const MAX_SUMMARY_LENGTH = 2000;
-/**
- * Build a markdown context summary from the current session state.
- * Includes: specs in progress, last 5 modified files, last 3 decisions.
- * Truncated to 2000 chars max.
- */
-export function buildContextSnapshot(session) {
-    const parts = [];
-    parts.push(`## Session Summary`);
-    parts.push(`- **Started**: ${session.startedAt}`);
-    parts.push(`- **Tool calls**: ${String(session.toolCallCount)}`);
-    parts.push('');
-    // Active specs
-    if (session.activeSpecs.length > 0) {
-        parts.push('### Active Specs');
-        for (const spec of session.activeSpecs) {
-            parts.push(`- **${spec.specId}** (${spec.status}): ${spec.summary}`);
-        }
-        parts.push('');
-    }
-    // Last 5 modified files
-    if (session.modifiedFiles.length > 0) {
-        parts.push('### Recent Files');
-        const recentFiles = session.modifiedFiles.slice(-5);
-        for (const file of recentFiles) {
-            parts.push(`- \`${file.path}\` (${file.action})`);
-        }
-        parts.push('');
-    }
-    // Last 3 decisions
-    if (session.decisions.length > 0) {
-        parts.push('### Recent Decisions');
-        const recentDecisions = session.decisions.slice(-3);
-        for (const d of recentDecisions) {
-            const specRef = d.specId ? ` [${d.specId}]` : '';
-            parts.push(`- ${d.decision}${specRef}`);
-            if (d.rationale) {
-                parts.push(`  _Rationale: ${d.rationale}_`);
-            }
-        }
-        parts.push('');
-    }
-    const full = parts.join('\n');
-    if (full.length <= MAX_SUMMARY_LENGTH) {
-        return full;
-    }
-    return `${full.slice(0, MAX_SUMMARY_LENGTH - 3)}...`;
-}
-//# sourceMappingURL=context-snapshot.js.map

package/dist/engine/session/memory-sync.d.ts

@@ -1,12 +0,0 @@
-import type { Session, SessionMemory } from '../../types/index.js';
-/**
- * Update cross-conversation memory with decisions from the current session.
- * Only persists decisions with non-empty rationale.
- * Deduplicates by decision content. Keeps max 100 (most recent win).
- */
-export declare function updateCrossConversationMemory(session: Session): Promise<void>;
-/**
- * Load historical decisions from memory to inject into a new session.
- */
-export declare function loadHistoricalDecisions(projectId: string): Promise<SessionMemory>;
-//# sourceMappingURL=memory-sync.d.ts.map

package/dist/engine/session/memory-sync.js

@@ -1,34 +0,0 @@
-import * as sessionStore from '../../storage/session-store.js';
-const MAX_MEMORY_DECISIONS = 100;
-/**
- * Update cross-conversation memory with decisions from the current session.
- * Only persists decisions with non-empty rationale.
- * Deduplicates by decision content. Keeps max 100 (most recent win).
- */
-export async function updateCrossConversationMemory(session) {
-    const newDecisions = session.decisions.filter((d) => d.rationale.length > 0);
-    if (newDecisions.length === 0) {
-        return;
-    }
-    const memory = await sessionStore.loadMemory(session.projectId);
-    // Deduplicate by decision content
-    const existingKeys = new Set(memory.decisions.map((d) => d.decision));
-    const toAdd = newDecisions.filter((d) => !existingKeys.has(d.decision));
-    if (toAdd.length === 0) {
-        return;
-    }
-    memory.decisions.push(...toAdd);
-    // Keep only the most recent MAX_MEMORY_DECISIONS
-    if (memory.decisions.length > MAX_MEMORY_DECISIONS) {
-        memory.decisions = memory.decisions.slice(-MAX_MEMORY_DECISIONS);
-    }
-    memory.updatedAt = new Date().toISOString();
-    await sessionStore.saveMemory(memory);
-}
-/**
- * Load historical decisions from memory to inject into a new session.
- */
-export async function loadHistoricalDecisions(projectId) {
-    return sessionStore.loadMemory(projectId);
-}
-//# sourceMappingURL=memory-sync.js.map

package/dist/engine/session/session-diff.d.ts

@@ -1,11 +0,0 @@
-import type { Session, SessionDiff } from '../../types/index.js';
-/**
- * Compare two sessions and return what changed.
- * `older` is the previous session, `newer` is the current one.
- */
-export declare function diffSessions(older: Session, newer: Session): SessionDiff;
-/**
- * Format a session diff as a human-readable summary string.
- */
-export declare function formatDiffSummary(diff: SessionDiff): string;
-//# sourceMappingURL=session-diff.d.ts.map

package/dist/engine/session/session-diff.js

@@ -1,42 +0,0 @@
-/**
- * Compare two sessions and return what changed.
- * `older` is the previous session, `newer` is the current one.
- */
-export function diffSessions(older, newer) {
-    const oldSpecIds = new Set(older.activeSpecs.map((s) => s.specId));
-    const newSpecIds = new Set(newer.activeSpecs.map((s) => s.specId));
-    // Specs in newer but not in older
-    const newSpecs = newer.activeSpecs.filter((s) => !oldSpecIds.has(s.specId));
-    // Specs in older but not in newer (completed/removed)
-    const completedSpecs = older.activeSpecs.filter((s) => !newSpecIds.has(s.specId));
-    // Decisions in newer that don't exist in older
-    const oldDecisionKeys = new Set(older.decisions.map((d) => `${d.timestamp}|${d.decision}`));
-    const newDecisions = newer.decisions.filter((d) => !oldDecisionKeys.has(`${d.timestamp}|${d.decision}`));
-    // File changes in newer not in older
-    const oldFilePaths = new Set(older.modifiedFiles.map((f) => f.path));
-    const fileChanges = newer.modifiedFiles.filter((f) => !oldFilePaths.has(f.path));
-    return { newSpecs, completedSpecs, newDecisions, fileChanges };
-}
-/**
- * Format a session diff as a human-readable summary string.
- */
-export function formatDiffSummary(diff) {
-    const parts = [];
-    if (diff.completedSpecs.length > 0) {
-        parts.push(`${String(diff.completedSpecs.length)} spec(s) completed`);
-    }
-    if (diff.newSpecs.length > 0) {
-        parts.push(`${String(diff.newSpecs.length)} new spec(s) started`);
-    }
-    if (diff.newDecisions.length > 0) {
-        parts.push(`${String(diff.newDecisions.length)} new decision(s)`);
-    }
-    if (diff.fileChanges.length > 0) {
-        parts.push(`${String(diff.fileChanges.length)} file(s) changed`);
-    }
-    if (parts.length === 0) {
-        return 'No significant changes since last session.';
-    }
-    return `Since your last session: ${parts.join(', ')}.`;
-}
-//# sourceMappingURL=session-diff.js.map

package/dist/engine/session/session-merge.d.ts

@@ -1,12 +0,0 @@
-import type { Session } from '../../types/index.js';
-/**
- * Merge two sessions of the same project.
- * - activeSpecs: union (no duplicate specId)
- * - decisions: union (no duplicate by timestamp+decision)
- * - modifiedFiles: union by path, most recent action wins
- * - toolCallCount: sum
- * - contextSummary: regenerated
- * The returned session uses the earlier startedAt and the later lastSavedAt.
- */
-export declare function mergeSessions(a: Session, b: Session): Session;
-//# sourceMappingURL=session-merge.d.ts.map

package/dist/engine/session/session-merge.js

@@ -1,55 +0,0 @@
-import { buildContextSnapshot } from './context-snapshot.js';
-/**
- * Merge two sessions of the same project.
- * - activeSpecs: union (no duplicate specId)
- * - decisions: union (no duplicate by timestamp+decision)
- * - modifiedFiles: union by path, most recent action wins
- * - toolCallCount: sum
- * - contextSummary: regenerated
- * The returned session uses the earlier startedAt and the later lastSavedAt.
- */
-export function mergeSessions(a, b) {
-    // Determine chronological order
-    const first = a.startedAt <= b.startedAt ? a : b;
-    const second = a.startedAt <= b.startedAt ? b : a;
-    // Merge activeSpecs (union by specId, second wins on conflict)
-    const specMap = new Map(first.activeSpecs.map((s) => [s.specId, s]));
-    for (const s of second.activeSpecs) {
-        specMap.set(s.specId, s);
-    }
-    const activeSpecs = [...specMap.values()];
-    // Merge decisions (union by timestamp+decision key)
-    const decisionKeys = new Set();
-    const allDecisions = [...first.decisions, ...second.decisions];
-    const decisions = allDecisions.filter((d) => {
-        const key = `${d.timestamp}|${d.decision}`;
-        if (decisionKeys.has(key)) {
-            return false;
-        }
-        decisionKeys.add(key);
-        return true;
-    });
-    // Merge modifiedFiles (union by path, later session's action wins)
-    const fileMap = new Map(first.modifiedFiles.map((f) => [f.path, f]));
-    for (const f of second.modifiedFiles) {
-        fileMap.set(f.path, f);
-    }
-    const modifiedFiles = [...fileMap.values()];
-    // Merge metadata (shallow merge, second wins on conflict)
-    const metadata = { ...first.metadata, ...second.metadata };
-    const merged = {
-        id: first.id,
-        projectId: first.projectId,
-        startedAt: first.startedAt,
-        lastSavedAt: second.lastSavedAt > first.lastSavedAt ? second.lastSavedAt : first.lastSavedAt,
-        activeSpecs,
-        decisions,
-        modifiedFiles,
-        contextSummary: '',
-        toolCallCount: first.toolCallCount + second.toolCallCount,
-        metadata,
-    };
-    merged.contextSummary = buildContextSnapshot(merged);
-    return merged;
-}
-//# sourceMappingURL=session-merge.js.map

package/dist/engine/session-safeguard/checkpoint-runner.d.ts

@@ -1,4 +0,0 @@
-import type { CheckpointResult, CheckpointRunnerOptions } from '../../types/index.js';
-/** Run a full session checkpoint: regen context, flush buffer, detect/push unpushed. */
-export declare function runCheckpoint(options: CheckpointRunnerOptions): Promise<CheckpointResult>;
-//# sourceMappingURL=checkpoint-runner.d.ts.map

package/dist/engine/session-safeguard/checkpoint-runner.js

@@ -1,70 +0,0 @@
-import { detectUnpushedCommits } from './unpushed-detector.js';
-import { flushBuffer } from './learnings-buffer.js';
-import { safeAutopush } from './autopush.js';
-const WARN_UNPUSHED_HOURS = 2;
-/** Regenerate session-context.md (fire-and-forget, best-effort). */
-async function regenerateSessionContext(projectPath) {
-    try {
-        const { generateSessionContext } = await import('../session-context-generator.js');
-        const { resolveProjectIdOrAutoDetect } = await import('../../tools/resolve-project-id.js');
-        const resolved = await resolveProjectIdOrAutoDetect({ projectPath });
-        if (!resolved.ok) {
-            return false;
-        }
-        await generateSessionContext(projectPath, resolved.projectId);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-/** Build the human-readable summary line for checkpoint output. */
-function buildHumanSummary(sessionContextRefreshed, learningsFlushed, unpushed, pushed) {
-    const parts = [];
-    if (sessionContextRefreshed) {
-        parts.push('session-context.md refreshed');
-    }
-    if (learningsFlushed > 0) {
-        parts.push(`${String(learningsFlushed)} learning(s) flushed to MEMORY.md`);
-    }
-    if (pushed !== undefined) {
-        if (pushed.pushed) {
-            parts.push(`autopush: ${String(pushed.commitsPushed)} commit(s) pushed to ${pushed.ref}`);
-        }
-        else {
-            parts.push(`autopush skipped (${pushed.reason})`);
-        }
-    }
-    else if (unpushed && unpushed.oldestAgeHours >= WARN_UNPUSHED_HOURS) {
-        parts.push(`WARNING: ${String(unpushed.count)} commit(s) unpushed for ${String(unpushed.oldestAgeHours)}h on branch ${unpushed.branch}. Run git push or enable autopush.`);
-    }
-    return parts.length > 0 ? parts.join('; ') : 'Checkpoint complete — nothing to do.';
-}
-/** Run a full session checkpoint: regen context, flush buffer, detect/push unpushed. */
-export async function runCheckpoint(options) {
-    const { projectPath, dryRun = false, autopush = false, autopushBranches } = options;
-    // This runner backs the explicit checkpoint tool, so refresh even when the
-    // file mtime is recent: package releases can change semantic state instantly.
-    const sessionContextRefreshed = dryRun ? false : await regenerateSessionContext(projectPath);
-    // Flush learnings buffer
-    let learningsFlushed = 0;
-    if (!dryRun) {
-        learningsFlushed = await flushBuffer(projectPath).catch(() => 0);
-    }
-    // Detect unpushed commits
-    const unpushedCommits = await detectUnpushedCommits(projectPath);
-    // Autopush if configured
-    let pushed;
-    if (autopush && !dryRun) {
-        pushed = await safeAutopush(projectPath, autopushBranches);
-    }
-    const humanSummary = buildHumanSummary(sessionContextRefreshed, learningsFlushed, unpushedCommits, pushed);
-    return {
-        sessionContextRefreshed,
-        learningsFlushed,
-        unpushedCommits,
-        ...(pushed !== undefined ? { pushed } : {}),
-        humanSummary,
-    };
-}
-//# sourceMappingURL=checkpoint-runner.js.map

package/dist/engine/session-safeguard/learnings-buffer.d.ts

@@ -1,15 +0,0 @@
-import type { LearningsBuffer, LearningEntry } from '../../types/index.js';
-/** Read the learnings buffer for a project (best-effort, returns empty on miss). */
-export declare function readBuffer(projectPath: string): Promise<LearningsBuffer>;
-/**
- * Append an entry under the shared transactional lease authority.
- */
-export declare function appendToBuffer(projectPath: string, entry: LearningEntry): Promise<void>;
-/**
- * Flush all entries in the learnings buffer to MEMORY.md.
- * Appends under an existing section or creates a new one.
- * Clears the buffer after successful write.
- * Returns the number of entries flushed.
- */
-export declare function flushBuffer(projectPath: string): Promise<number>;
-//# sourceMappingURL=learnings-buffer.d.ts.map

package/dist/engine/session-safeguard/learnings-buffer.js

@@ -1,91 +0,0 @@
-// engine/session-safeguard/learnings-buffer.ts — SPEC-585: Append/flush learnings buffer
-import { readFile, mkdir } from 'node:fs/promises';
-import { homedir } from 'node:os';
-import { join } from 'node:path';
-import { hashProjectPath, projectDataDir } from '../../storage/base-store.js';
-import { acquireLock, releaseLock } from '../safety/file-mutex.js';
-import { atomicWriteFile } from '../safety/atomic-write-file.js';
-import { assertNoObsoleteFileLock } from '../safety/obsolete-lock-guard.js';
-const BUFFER_VERSION = 1;
-const LOCK_TIMEOUT_MS = 10_000;
-function bufferPath(projectPath) {
-    const hash = hashProjectPath(projectPath);
-    return join(projectDataDir(hash), 'learnings-buffer.json');
-}
-function claudeMemoryPath(projectPath) {
-    const projectKey = projectPath.replaceAll('\\', '-').replaceAll('/', '-');
-    return join(homedir(), '.claude', 'projects', projectKey, 'memory', 'MEMORY.md');
-}
-function emptyBuffer() {
-    return { version: BUFFER_VERSION, entries: [] };
-}
-/** Read the learnings buffer for a project (best-effort, returns empty on miss). */
-export async function readBuffer(projectPath) {
-    try {
-        const raw = await readFile(bufferPath(projectPath), 'utf-8');
-        return JSON.parse(raw);
-    }
-    catch {
-        return emptyBuffer();
-    }
-}
-/** Write the buffer to disk, creating parent dirs as needed. */
-async function writeBuffer(projectPath, buffer) {
-    const path = bufferPath(projectPath);
-    await mkdir(join(path, '..'), { recursive: true });
-    await atomicWriteFile(path, JSON.stringify(buffer, null, 2));
-}
-async function withBufferLock(projectPath, operation) {
-    await assertNoObsoleteFileLock(`${bufferPath(projectPath)}.lock`, 'learnings buffer');
-    const handle = await acquireLock(bufferPath(projectPath), LOCK_TIMEOUT_MS);
-    try {
-        return await operation();
-    }
-    finally {
-        await releaseLock(handle);
-    }
-}
-/**
- * Append an entry under the shared transactional lease authority.
- */
-export async function appendToBuffer(projectPath, entry) {
-    await withBufferLock(projectPath, async () => {
-        const buffer = await readBuffer(projectPath);
-        buffer.entries.push(entry);
-        await writeBuffer(projectPath, buffer);
-    });
-}
-/** Build the markdown bullet for an entry to append to MEMORY.md. */
-function entryToMarkdown(entry) {
-    const label = `[${entry.category}/${entry.source}]`;
-    return `- ${label} ${entry.content} _(${entry.timestamp.slice(0, 10)})_`;
-}
-/**
- * Flush all entries in the learnings buffer to MEMORY.md.
- * Appends under an existing section or creates a new one.
- * Clears the buffer after successful write.
- * Returns the number of entries flushed.
- */
-export async function flushBuffer(projectPath) {
-    return withBufferLock(projectPath, async () => {
-        const buffer = await readBuffer(projectPath);
-        if (buffer.entries.length === 0) {
-            return 0;
-        }
-        const memoryPath = claudeMemoryPath(projectPath);
-        let existing = '';
-        try {
-            existing = await readFile(memoryPath, 'utf-8');
-        }
-        catch {
-            /* file may not exist */
-        }
-        const bullets = buffer.entries.map(entryToMarkdown).join('\n');
-        const section = `\n\n## Session Learnings (auto-flushed ${new Date().toISOString().slice(0, 10)})\n\n${bullets}\n`;
-        await mkdir(join(memoryPath, '..'), { recursive: true });
-        await atomicWriteFile(memoryPath, existing + section);
-        await writeBuffer(projectPath, emptyBuffer());
-        return buffer.entries.length;
-    });
-}
-//# sourceMappingURL=learnings-buffer.js.map

package/dist/engine/session-safeguard/precompaction-drain.d.ts

@@ -1,10 +0,0 @@
-import type { PrecompactionDrainReport, PrecompactionDrainOptions } from '../../types/claude-code-runtime.js';
-/**
- * Drain learnings buffer to MEMORY.md fragments, autopush unpushed commits,
- * and write session-context.md — all before context compaction completes.
- *
- * Every operation is best-effort: a failure in one step does not prevent
- * the others from running. The drain report captures all outcomes.
- */
-export declare function runPrecompactionDrain(projectPath: string, options?: PrecompactionDrainOptions): Promise<PrecompactionDrainReport>;
-//# sourceMappingURL=precompaction-drain.d.ts.map

package/dist/engine/session-safeguard/precompaction-drain.js

@@ -1,82 +0,0 @@
-// engine/session-safeguard/precompaction-drain.ts — SPEC-587
-// Runs when PreCompaction fires: drains learnings buffer, autopushes commits,
-// writes session-context.md — all before context compaction completes.
-import { flushBuffer } from './learnings-buffer.js';
-import { safeAutopush } from './autopush.js';
-/**
- * Regenerate session-context.md (best-effort, resolves projectId automatically).
- * Returns true when successfully written.
- */
-async function writeSessionContext(projectPath) {
-    try {
-        const { generateSessionContext } = await import('../session-context-generator.js');
-        const { resolveProjectIdOrAutoDetect } = await import('../../tools/resolve-project-id.js');
-        const resolved = await resolveProjectIdOrAutoDetect({ projectPath });
-        if (!resolved.ok) {
-            return false;
-        }
-        await generateSessionContext(projectPath, resolved.projectId);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Drain learnings buffer to MEMORY.md fragments, autopush unpushed commits,
- * and write session-context.md — all before context compaction completes.
- *
- * Every operation is best-effort: a failure in one step does not prevent
- * the others from running. The drain report captures all outcomes.
- */
-export async function runPrecompactionDrain(projectPath, options = {}) {
-    const { dryRun = false, autopushBranches } = options;
-    // 1. Drain learnings buffer to MEMORY.md fragments
-    let learningsFlushed = 0;
-    if (!dryRun) {
-        learningsFlushed = await flushBuffer(projectPath).catch(() => 0);
-    }
-    // 2. Autopush unpushed commits (best-effort)
-    let autopushResult;
-    if (!dryRun) {
-        const result = await safeAutopush(projectPath, autopushBranches).catch((err) => {
-            const msg = err instanceof Error ? err.message : String(err);
-            return { pushed: false, reason: msg };
-        });
-        autopushResult = result.pushed
-            ? { pushed: true, ref: result.ref, commitsPushed: result.commitsPushed }
-            : { pushed: false, reason: result.reason };
-    }
-    else {
-        autopushResult = { pushed: false, reason: 'dry-run' };
-    }
-    // 3. Write session-context.md
-    let sessionContextWritten = false;
-    if (!dryRun) {
-        sessionContextWritten = await writeSessionContext(projectPath);
-    }
-    // Build human summary
-    const parts = [];
-    if (learningsFlushed > 0) {
-        parts.push(`${String(learningsFlushed)} learning(s) flushed to MEMORY.md`);
-    }
-    if (autopushResult.pushed) {
-        parts.push(`autopush: ${String(autopushResult.commitsPushed)} commit(s) pushed to ${autopushResult.ref}`);
-    }
-    else {
-        parts.push(`autopush skipped (${autopushResult.reason})`);
-    }
-    if (sessionContextWritten) {
-        parts.push('session-context.md written');
-    }
-    const humanSummary = parts.length > 0
-        ? `PreCompaction drain: ${parts.join('; ')}`
-        : 'PreCompaction drain: nothing to do';
-    return {
-        learningsFlushed,
-        sessionContextWritten,
-        autopushResult,
-        humanSummary,
-    };
-}
-//# sourceMappingURL=precompaction-drain.js.map

package/dist/engine/session-safeguard/unpushed-detector.d.ts

@@ -1,7 +0,0 @@
-import type { UnpushedCommitInfo } from '../../types/index.js';
-/**
- * Detect unpushed commits on the current branch.
- * Returns null when not a git repo, detached HEAD, or no upstream configured.
- */
-export declare function detectUnpushedCommits(projectPath: string): Promise<UnpushedCommitInfo | null>;
-//# sourceMappingURL=unpushed-detector.d.ts.map