@planu/cli 4.13.0 → 5.0.0

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,16 +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 to the learnings buffer with exclusive-lock retry.
- * Uses 'wx' flag on a lock file with jitter-backoff (3 retries, 100ms each).
- */
-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,114 +0,0 @@
-// engine/session-safeguard/learnings-buffer.ts — SPEC-585: Append/flush learnings buffer
-import { open, readFile, writeFile, mkdir, unlink } from 'node:fs/promises';
-import { homedir } from 'node:os';
-import { join } from 'node:path';
-import { hashProjectPath, projectDataDir } from '../../storage/base-store.js';
-const BUFFER_VERSION = 1;
-const MAX_RETRIES = 50;
-const JITTER_MS = 100;
-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 writeFile(path, JSON.stringify(buffer, null, 2), 'utf-8');
-}
-/**
- * Append an entry to the learnings buffer with exclusive-lock retry.
- * Uses 'wx' flag on a lock file with jitter-backoff (3 retries, 100ms each).
- */
-export async function appendToBuffer(projectPath, entry) {
-    const lockFile = `${bufferPath(projectPath)}.lock`;
-    await mkdir(join(lockFile, '..'), { recursive: true });
-    let lastError;
-    for (let attempt = 0; attempt < MAX_RETRIES; attempt++) {
-        try {
-            const fh = await open(lockFile, 'wx');
-            try {
-                const buffer = await readBuffer(projectPath);
-                buffer.entries.push(entry);
-                await writeBuffer(projectPath, buffer);
-            }
-            finally {
-                try {
-                    await fh.close();
-                }
-                catch {
-                    /* best-effort */
-                }
-                try {
-                    await unlink(lockFile);
-                }
-                catch {
-                    /* best-effort */
-                }
-            }
-            return;
-        }
-        catch (err) {
-            lastError = err;
-            const isExist = err instanceof Error && 'code' in err
-                ? err.code === 'EEXIST'
-                : false;
-            if (!isExist) {
-                break;
-            }
-            await new Promise((resolve) => setTimeout(resolve, JITTER_MS + Math.random() * JITTER_MS));
-        }
-    }
-    throw lastError instanceof Error
-        ? lastError
-        : new Error('Unable to acquire learnings buffer lock');
-}
-/** 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) {
-    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 writeFile(memoryPath, existing + section, 'utf-8');
-    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

package/dist/engine/session-safeguard/unpushed-detector.js

@@ -1,59 +0,0 @@
-// engine/session-safeguard/unpushed-detector.ts — SPEC-585: Detect unpushed commits with age
-import { execFile } from 'node:child_process';
-import { promisify } from 'node:util';
-const execFileAsync = promisify(execFile);
-const MS_PER_HOUR = 3_600_000;
-/** Return the current branch name or null if not in a git repo / detached HEAD. */
-async function getBranch(projectPath) {
-    try {
-        const { stdout } = await execFileAsync('git', ['rev-parse', '--abbrev-ref', 'HEAD'], {
-            cwd: projectPath,
-        });
-        const branch = stdout.trim();
-        return branch && branch !== 'HEAD' ? branch : null;
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * List unpushed commits as Unix timestamps (author date, seconds).
- * Returns empty array when no upstream or no commits ahead.
- */
-async function getUnpushedTimestamps(projectPath, branch) {
-    try {
-        const { stdout } = await execFileAsync('git', ['log', `origin/${branch}..HEAD`, '--format=%at'], { cwd: projectPath });
-        return stdout
-            .trim()
-            .split('\n')
-            .filter(Boolean)
-            .map((line) => parseInt(line, 10))
-            .filter((n) => !isNaN(n));
-    }
-    catch {
-        return [];
-    }
-}
-/**
- * Detect unpushed commits on the current branch.
- * Returns null when not a git repo, detached HEAD, or no upstream configured.
- */
-export async function detectUnpushedCommits(projectPath) {
-    const branch = await getBranch(projectPath);
-    if (!branch) {
-        return null;
-    }
-    const timestamps = await getUnpushedTimestamps(projectPath, branch);
-    if (timestamps.length === 0) {
-        return null;
-    }
-    const nowMs = Date.now();
-    const oldestTimestampMs = Math.min(...timestamps) * 1000;
-    const oldestAgeHours = Math.round((nowMs - oldestTimestampMs) / MS_PER_HOUR);
-    return {
-        count: timestamps.length,
-        branch,
-        oldestAgeHours,
-    };
-}
-//# sourceMappingURL=unpushed-detector.js.map

package/dist/engine/spec-changelog/core.d.ts

@@ -1,16 +0,0 @@
-import type { SpecChangelogEntry, SpecChangelogData, AppendChangelogOptions, ReadChangelogOptions } from '../../types/index.js';
-/** Format a single changelog entry as Markdown. */
-export declare function formatEntry(entry: SpecChangelogEntry, specId: string): string;
-/** Parse the timestamp from the first entry in a CHANGELOG.md content. */
-export declare function parseFirstEntryTimestamp(content: string): string | null;
-/** Parse changelog entries from a CHANGELOG.md content string. */
-export declare function parseChangelogEntries(content: string, specId: string): SpecChangelogEntry[];
-/** Read the CHANGELOG.md for a spec directory. Returns null if not found. */
-export declare function readChangelog(options: ReadChangelogOptions): Promise<SpecChangelogData | null>;
-/** Read only the timestamp of the last (most recent) changelog entry. Optimized for list_specs. */
-export declare function readLastModifiedTimestamp(specDir: string): Promise<string | null>;
-/** Append a new entry to the CHANGELOG.md for a spec. Creates the file if it doesn't exist. */
-export declare function appendChangelogEntry(options: AppendChangelogOptions): Promise<boolean>;
-/** Format a relative date string (e.g. "hace 2 dias") for a timestamp. */
-export declare function formatRelativeDate(timestamp: string): string;
-//# sourceMappingURL=core.d.ts.map