@tacuchi/agent-workflow-cli 4.0.0

package/dist/application/checkpoint-service.js

@@ -0,0 +1,259 @@
+import { join } from "node:path";
+import { firstNonEmptyLine, parseMdSection, parseMdValue } from "./markdown.js";
+import { parseProjectBlock } from "./parsers/project-block.js";
+const PLACEHOLDER_MARKER = "_[AI:";
+const DEFAULT_STALE_THRESHOLD_SECONDS = 300;
+export async function readLatestCheckpoint(fs, sessionPath) {
+    const path = join(sessionPath, "CHECKPOINT.md");
+    if (!(await fs.exists(path)))
+        return null;
+    const text = await fs.readText(path);
+    return {
+        path,
+        actualizado: parseMdValue(text, "Actualizado") ?? null,
+        fase: parseMdValue(text, "Fase actual") ?? null,
+        avance: parseMdValue(text, "Avance") ?? null,
+        ultimo: parseMdSection(text, "Lo último que hice") ?? null,
+        proximo: parseMdSection(text, "Próximo paso") ?? parseMdSection(text, "Proximo paso") ?? null,
+        decisiones: parseMdSection(text, "Decisiones recientes") ?? null,
+        archivos: parseMdSection(text, "Archivos tocados (post-último-commit)") ??
+            parseMdSection(text, "Archivos tocados") ??
+            null,
+        contexto: parseMdSection(text, "Contexto crítico para retomar") ??
+            parseMdSection(text, "Contexto critico para retomar") ??
+            null,
+        refs: parseMdSection(text, "Refs") ?? null,
+        raw: text,
+    };
+}
+export async function computeCheckpointStatus(fs, sessionPath, options = {}) {
+    const threshold = options.staleThresholdSeconds ?? DEFAULT_STALE_THRESHOLD_SECONDS;
+    const now = options.now ?? new Date();
+    const path = join(sessionPath, "CHECKPOINT.md");
+    if (!(await fs.exists(path))) {
+        return {
+            status: "missing",
+            checkpoint_path: null,
+            unfilled_placeholders: [],
+            needs_ai_action: true,
+            age_seconds: null,
+        };
+    }
+    const text = await fs.readText(path);
+    const placeholders = findUnfilledPlaceholders(text);
+    const actualizado = parseMdValue(text, "Actualizado");
+    const ts = parseActualizado(actualizado);
+    const age = ts !== null ? Math.max(0, Math.floor((now.getTime() - ts.getTime()) / 1000)) : null;
+    let status;
+    if (placeholders.length > 0)
+        status = "draft";
+    else if (age !== null && age > threshold)
+        status = "stale";
+    else
+        status = "complete";
+    return {
+        status,
+        checkpoint_path: path,
+        unfilled_placeholders: placeholders,
+        needs_ai_action: status !== "complete",
+        age_seconds: age,
+    };
+}
+function findUnfilledPlaceholders(text) {
+    if (!text.includes(PLACEHOLDER_MARKER))
+        return [];
+    const found = [];
+    const seen = new Set();
+    for (const [header, body] of splitSections(text)) {
+        if (!body.includes(PLACEHOLDER_MARKER))
+            continue;
+        const field = sectionToField(header);
+        if (field && !seen.has(field)) {
+            seen.add(field);
+            found.push(field);
+        }
+    }
+    return found;
+}
+function splitSections(text) {
+    const sections = [];
+    let currentHeader = null;
+    let currentBody = [];
+    for (const line of text.split("\n")) {
+        if (line.startsWith("## ")) {
+            if (currentHeader !== null) {
+                sections.push([currentHeader, currentBody.join("\n")]);
+            }
+            currentHeader = line.slice(3).trim();
+            currentBody = [];
+        }
+        else if (currentHeader !== null) {
+            currentBody.push(line);
+        }
+    }
+    if (currentHeader !== null) {
+        sections.push([currentHeader, currentBody.join("\n")]);
+    }
+    return sections;
+}
+function sectionToField(header) {
+    const h = stripAccentsLower(header);
+    if (h.includes("lo ultimo que hice"))
+        return "ultimo";
+    if (h.includes("proximo paso"))
+        return "proximo";
+    if (h.startsWith("archivos tocados"))
+        return "archivos_proposito";
+    if (h.includes("contexto critico"))
+        return "contexto";
+    if (h === "refs")
+        return "skills";
+    return null;
+}
+function stripAccentsLower(s) {
+    let r = s.toLowerCase();
+    r = r.replace(/á/g, "a");
+    r = r.replace(/é/g, "e");
+    r = r.replace(/í/g, "i");
+    r = r.replace(/ó/g, "o");
+    r = r.replace(/ú/g, "u");
+    r = r.replace(/ü/g, "u");
+    return r;
+}
+function parseActualizado(value) {
+    if (!value)
+        return null;
+    const s = value.trim();
+    // Match Python formats: %Y-%m-%d %H:%M:%S, %Y-%m-%d %H:%M
+    const m = s.match(/^(\d{4})-(\d{2})-(\d{2}) (\d{2}):(\d{2})(?::(\d{2}))?$/);
+    if (!m || !m[1] || !m[2] || !m[3] || !m[4] || !m[5])
+        return null;
+    const date = new Date(Number.parseInt(m[1], 10), Number.parseInt(m[2], 10) - 1, Number.parseInt(m[3], 10), Number.parseInt(m[4], 10), Number.parseInt(m[5], 10), m[6] ? Number.parseInt(m[6], 10) : 0);
+    return Number.isFinite(date.getTime()) ? date : null;
+}
+export async function runCheckpointRead(fs, env, paths, code) {
+    const folder = await resolveTargetSession(fs, env, paths, code);
+    if (!folder)
+        return { error: "no hay sesión activa única; especificá --code" };
+    const sessionPath = join(paths.cwdSessionsDir(), folder);
+    const cp = await readLatestCheckpoint(fs, sessionPath);
+    if (!cp) {
+        return { session: folder, checkpoint: null, reason: "CHECKPOINT.md no existe" };
+    }
+    return { session: folder, checkpoint: cp };
+}
+export async function findActiveSessions(fs, cwd) {
+    for (const file of [join(cwd, "CLAUDE.md"), join(cwd, "AGENTS.md")]) {
+        if (!(await fs.exists(file)))
+            continue;
+        const block = parseProjectBlock(await fs.readText(file));
+        if (block)
+            return block.sessions;
+    }
+    return [];
+}
+async function resolveTargetSession(fs, env, paths, code) {
+    if (code) {
+        // Look for matching folder.
+        const sessionsDir = paths.cwdSessionsDir();
+        if (!(await fs.exists(sessionsDir)))
+            return null;
+        const entries = await fs.list(sessionsDir);
+        const norm = code.replace("session", "").split("-")[0]?.padStart(3, "0") ?? code;
+        for (const entry of entries) {
+            if (entry.type !== "dir")
+                continue;
+            const m = entry.name.match(/^session(\d{3})-/);
+            if (m?.[1] === norm)
+                return entry.name;
+        }
+        return null;
+    }
+    const actives = await findActiveSessions(fs, env.cwd());
+    return actives.length === 1 ? (actives[0]?.folder ?? null) : null;
+}
+export async function runResumeSummary(fs, env, paths) {
+    const cwd = env.cwd();
+    const actives = await findActiveSessions(fs, cwd);
+    if (actives.length === 0) {
+        return {
+            active_sessions: [],
+            primary_session: null,
+            checkpoint_present: false,
+            checkpoint_status: "missing",
+            unfilled_placeholders: [],
+            needs_ai_action: false,
+        };
+    }
+    const target = actives[0];
+    if (!target) {
+        return {
+            active_sessions: [],
+            primary_session: null,
+            checkpoint_present: false,
+            checkpoint_status: "missing",
+            unfilled_placeholders: [],
+            needs_ai_action: false,
+        };
+    }
+    const sessionPath = join(paths.cwdSessionsDir(), target.folder);
+    const cp = await readLatestCheckpoint(fs, sessionPath);
+    const cpStatus = await computeCheckpointStatus(fs, sessionPath);
+    const codeMatch = target.folder.split("-", 1)[0]?.replace("session", "");
+    const summary = {
+        active_sessions: actives.map((a) => a.folder),
+        primary_session: target.folder,
+        primary_session_code: codeMatch && codeMatch.length > 0 ? codeMatch : null,
+        phase_from_qtc_project: target.phase,
+        branches_from_qtc_project: target.branches,
+        checkpoint_present: cp !== null,
+        checkpoint_path: cpStatus.checkpoint_path,
+        checkpoint_status: cpStatus.status,
+        checkpoint_age_seconds: cpStatus.age_seconds,
+        unfilled_placeholders: cpStatus.unfilled_placeholders,
+        needs_ai_action: cpStatus.needs_ai_action,
+    };
+    if (cp) {
+        const proximoLines = cp.proximo
+            ? cp.proximo
+                .split("\n")
+                .filter((l) => l.trim().length > 0)
+                .slice(0, 3)
+            : null;
+        summary.checkpoint = {
+            actualizado: cp.actualizado,
+            fase: cp.fase,
+            avance: cp.avance,
+            proximo: proximoLines && proximoLines.length > 0 ? proximoLines : null,
+        };
+    }
+    return summary;
+}
+const COMPRESS_CANDIDATES = ["HALLAZGOS.md", "EVIDENCIA.md", "DISCOVERY.md", "PROBLEMA.md"];
+const DEFAULT_COMPRESS_THRESHOLD = 200;
+export async function runCompressCheckpoint(fs, env, paths, options = {}) {
+    const folder = await resolveTargetSession(fs, env, paths, options.code);
+    if (!folder)
+        return { error: "no hay sesión activa única; especificá --code" };
+    const sessionPath = join(paths.cwdSessionsDir(), folder);
+    const threshold = options.threshold ?? DEFAULT_COMPRESS_THRESHOLD;
+    const candidates = [];
+    for (const fname of COMPRESS_CANDIDATES) {
+        const fpath = join(sessionPath, fname);
+        if (!(await fs.exists(fpath)))
+            continue;
+        const text = await fs.readText(fpath);
+        const lines = text.split("\n");
+        if (lines.length <= threshold)
+            continue;
+        candidates.push({
+            file: fname,
+            lines: lines.length,
+            excess: lines.length - threshold,
+            head_excerpt: (firstNonEmptyLine(text) ?? "").slice(0, 50),
+            tail_excerpt: (lines[lines.length - 2] ?? "").slice(0, 50),
+        });
+    }
+    return { session: folder, candidates };
+}
+//# sourceMappingURL=checkpoint-service.js.map

package/dist/application/checkpoint-service.js.map

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

package/dist/application/checkpoint-write-service.d.ts

@@ -0,0 +1,42 @@
+import type { EnvPort } from "../ports/env.js";
+import type { FileSystemPort } from "../ports/file-system.js";
+import type { GitPort } from "../ports/git.js";
+import type { PathsService } from "./paths-service.js";
+export interface CheckpointWriteOutput {
+    session: string;
+    checkpoint_path: string;
+    lines_written?: number;
+    phase?: string | null;
+    progress_pct?: number | null;
+    tasks_open?: number;
+    tasks_closed?: number;
+    files_touched_count?: number;
+    skipped?: boolean;
+    reason?: string;
+}
+export interface CheckpointWriteSkipped {
+    skipped: true;
+    reason: string;
+    active_sessions?: string[];
+}
+export declare function runCheckpointWrite(fs: FileSystemPort, env: EnvPort, git: GitPort, paths: PathsService, options?: {
+    code?: string;
+    force?: boolean;
+}): Promise<CheckpointWriteOutput | CheckpointWriteSkipped>;
+export interface AutoCompactOnCloseOutput {
+    checkpoints_written: Array<{
+        session?: string;
+        checkpoint_path?: string;
+        phase?: string | null;
+        progress_pct?: number | null;
+        skipped?: boolean;
+        reason?: string;
+        error?: string;
+    }>;
+}
+export interface AutoCompactOnCloseSkipped {
+    skipped: true;
+    reason: string;
+}
+export declare function runAutoCompactOnClose(fs: FileSystemPort, env: EnvPort, git: GitPort, paths: PathsService): Promise<AutoCompactOnCloseOutput | AutoCompactOnCloseSkipped>;
+//# sourceMappingURL=checkpoint-write-service.d.ts.map

package/dist/application/checkpoint-write-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint-write-service.d.ts","sourceRoot":"","sources":["../../src/application/checkpoint-write-service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAY,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,KAAK,EAAoB,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAGjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAmCvD,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,IAAI,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,wBAAsB,kBAAkB,CACtC,EAAE,EAAE,cAAc,EAClB,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,YAAY,EACnB,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAC/C,OAAO,CAAC,qBAAqB,GAAG,sBAAsB,CAAC,CAkDzD;AAiSD,MAAM,WAAW,wBAAwB;IACvC,mBAAmB,EAAE,KAAK,CAAC;QACzB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,IAAI,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,qBAAqB,CACzC,EAAE,EAAE,cAAc,EAClB,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,wBAAwB,GAAG,yBAAyB,CAAC,CAY/D"}

package/dist/application/checkpoint-write-service.js

@@ -0,0 +1,354 @@
+import { join } from "node:path";
+import { findActiveSessions } from "./checkpoint-service.js";
+import { parseProjectBlock } from "./parsers/project-block.js";
+const PLACEHOLDER_MARKER = "_[AI:";
+const PHASE_INDEX = {
+    planning: "1/4",
+    planificacion: "1/4",
+    requerimiento: "1/4",
+    plan: "1/4",
+    execution: "2/4",
+    ejecucion: "2/4",
+    implementacion: "2/4",
+    validation: "3/4",
+    validacion: "3/4",
+    closure: "4/4",
+    cierre: "4/4",
+};
+export async function runCheckpointWrite(fs, env, git, paths, options = {}) {
+    const cwd = env.cwd();
+    const folder = await resolveTargetFolder(fs, env, paths, options.code);
+    if (!folder) {
+        const actives = await findActiveSessions(fs, cwd);
+        if (actives.length === 0) {
+            return { skipped: true, reason: "no hay sesiones activas en QTC-PROJECT.Status" };
+        }
+        return {
+            skipped: true,
+            reason: "múltiples sesiones activas; especificá --code <CODE>",
+            active_sessions: actives.map((a) => a.folder),
+        };
+    }
+    const sessionPath = join(paths.cwdSessionsDir(), folder);
+    if (!(await fs.exists(sessionPath))) {
+        throw new Error(`folder no existe: ${sessionPath}`);
+    }
+    const cpPath = join(sessionPath, "CHECKPOINT.md");
+    if ((await fs.exists(cpPath)) && options.force !== true) {
+        const existing = await fs.readText(cpPath);
+        if (!existing.includes(PLACEHOLDER_MARKER)) {
+            return {
+                session: folder,
+                checkpoint_path: cpPath,
+                skipped: true,
+                reason: "CHECKPOINT.md ya está sintetizado (sin placeholders); pasar --force para regenerar",
+            };
+        }
+    }
+    const state = await extractSessionState(fs, git, cwd, paths, sessionPath);
+    const md = formatCheckpointMd(state);
+    await fs.mkdirp(sessionPath);
+    await fs.writeText(cpPath, md);
+    return {
+        session: folder,
+        checkpoint_path: cpPath,
+        // Mirror Python str.splitlines() which doesn't count trailing empty.
+        lines_written: md.replace(/\n$/, "").split("\n").length,
+        phase: state.phase,
+        progress_pct: state.progress_pct,
+        tasks_open: state.tasks.open,
+        tasks_closed: state.tasks.closed,
+        files_touched_count: state.files_touched.length,
+    };
+}
+async function resolveTargetFolder(fs, env, paths, code) {
+    if (code) {
+        const sessionsDir = paths.cwdSessionsDir();
+        if (!(await fs.exists(sessionsDir)))
+            return null;
+        const entries = await fs.list(sessionsDir);
+        const norm = code.replace("session", "").split("-")[0]?.padStart(3, "0") ?? code;
+        for (const entry of entries) {
+            if (entry.type !== "dir")
+                continue;
+            const m = entry.name.match(/^session(\d{3})-/);
+            if (m?.[1] === norm)
+                return entry.name;
+        }
+        return null;
+    }
+    const actives = await findActiveSessions(fs, env.cwd());
+    return actives.length === 1 ? (actives[0]?.folder ?? null) : null;
+}
+async function extractSessionState(fs, git, cwd, paths, sessionPath) {
+    const folder = sessionPath.split(/[\\/]/).pop() ?? "";
+    const parsed = parseSessionFolder(folder);
+    const { phase, branches } = await readPhaseFromBlock(fs, cwd, paths, folder);
+    const tasks = await countTasks(fs, sessionPath);
+    const progressPct = tasks.total > 0 ? Math.round((100 * tasks.closed) / tasks.total) : null;
+    const decisions = await countDecisions(fs, sessionPath);
+    const lastDecision = await readLastDecision(fs, sessionPath);
+    const artefacts = await listArtefacts(fs, sessionPath);
+    const filesTouched = await git.diffNumstat(cwd);
+    const origen = await readOrigen(fs, sessionPath);
+    return {
+        code: parsed.code,
+        flow: parsed.flow,
+        name: parsed.name,
+        folder,
+        phase,
+        branches,
+        tasks,
+        progress_pct: progressPct,
+        decisions_count: decisions,
+        last_decision: lastDecision,
+        artefacts,
+        files_touched: filesTouched,
+        origen,
+        timestamp: formatNowMinute(),
+    };
+}
+function parseSessionFolder(folder) {
+    const m = folder.match(/^session(\d{3})-(.+)/);
+    if (!m || !m[1] || !m[2])
+        return { code: null, flow: null, name: folder };
+    const parts = m[2].split("-");
+    if (parts.length >= 2 && ["dev", "design", "analyze", "core"].includes(parts[0] ?? "")) {
+        return { code: m[1], flow: parts[0] ?? null, name: parts.slice(1).join("-") };
+    }
+    return { code: m[1], flow: null, name: m[2] };
+}
+async function readPhaseFromBlock(fs, cwd, paths, folder) {
+    for (const file of [join(cwd, "CLAUDE.md"), join(cwd, "AGENTS.md")]) {
+        if (!(await fs.exists(file)))
+            continue;
+        const block = parseProjectBlock(await fs.readText(file), paths.blockMarkers());
+        if (!block)
+            continue;
+        for (const s of block.sessions) {
+            if (s.folder === folder)
+                return { phase: s.phase, branches: s.branches };
+        }
+    }
+    return { phase: null, branches: [] };
+}
+async function countTasks(fs, sessionPath) {
+    const path = join(sessionPath, "TASKS.md");
+    if (!(await fs.exists(path)))
+        return { open: 0, closed: 0, total: 0 };
+    const text = await fs.readText(path);
+    const open = (text.match(/^\s*[-*]\s*\[\s\]/gm) ?? []).length;
+    const closed = (text.match(/^\s*[-*]\s*\[[xX]\]/gm) ?? []).length;
+    return { open, closed, total: open + closed };
+}
+async function countDecisions(fs, sessionPath) {
+    const path = join(sessionPath, "DECISIONES.md");
+    if (!(await fs.exists(path)))
+        return 0;
+    const text = await fs.readText(path);
+    return (text.match(/^#{2,3}\s+DEC[- ]\d+/gm) ?? []).length;
+}
+async function readLastDecision(fs, sessionPath) {
+    const path = join(sessionPath, "DECISIONES.md");
+    if (!(await fs.exists(path)))
+        return null;
+    const text = await fs.readText(path);
+    const matches = [...text.matchAll(/^#{2,3}\s+(DEC[- ]\d+[^\n]*)$/gm)];
+    if (matches.length === 0)
+        return null;
+    const last = matches[matches.length - 1];
+    if (!last || !last[1])
+        return null;
+    const id = last[1].trim();
+    const restStart = (last.index ?? 0) + last[0].length;
+    const rest = text.slice(restStart);
+    const body = rest.split("\n##", 1)[0] ?? "";
+    const firstLine = body
+        .split("\n")
+        .map((l) => l.trim())
+        .find((l) => l.length > 0) ?? "";
+    return { id, excerpt: firstLine.slice(0, 140) };
+}
+async function listArtefacts(fs, sessionPath) {
+    const has = async (name) => fs.exists(join(sessionPath, name));
+    const scriptsDir = join(sessionPath, "scripts");
+    const scriptsCount = (await fs.exists(scriptsDir))
+        ? (await listSqlFiles(fs, scriptsDir)).length
+        : 0;
+    return {
+        objetivo: await has("OBJETIVO.md"),
+        tasks: await has("TASKS.md"),
+        decisiones: await has("DECISIONES.md"),
+        dependencias: await has("DEPENDENCIAS.md"),
+        entrega: await has("ENTREGA.md"),
+        evidencia: await has("EVIDENCIA.md"),
+        hallazgos: await has("HALLAZGOS.md"),
+        recomendacion: await has("RECOMENDACION.md"),
+        scripts_count: scriptsCount,
+    };
+}
+async function listSqlFiles(fs, dir) {
+    const entries = await fs.list(dir);
+    const result = [];
+    for (const entry of entries) {
+        if (entry.type === "file" && entry.name.endsWith(".sql")) {
+            result.push(entry.name);
+        }
+    }
+    return result.sort();
+}
+async function readOrigen(fs, sessionPath) {
+    const path = join(sessionPath, "OBJETIVO.md");
+    if (!(await fs.exists(path)))
+        return null;
+    const text = await fs.readText(path);
+    const lines = text.split("\n");
+    let inOrigen = false;
+    for (const line of lines) {
+        if (line.match(/^##\s+Origen\s*$/i)) {
+            inOrigen = true;
+            continue;
+        }
+        if (inOrigen) {
+            if (line.startsWith("##"))
+                break;
+            const trimmed = line.trim();
+            if (trimmed.length > 0)
+                return trimmed.slice(0, 140);
+        }
+    }
+    return null;
+}
+function formatCheckpointMd(state) {
+    const lines = [];
+    appendHeader(lines, state);
+    appendDecisions(lines, state);
+    appendFilesTouched(lines, state);
+    appendContext(lines);
+    appendRefs(lines, state);
+    lines.push("", `<!-- escrito por qtc-core.checkpoint en ${state.timestamp} -->`, "");
+    return lines.join("\n");
+}
+function appendHeader(lines, state) {
+    const phase = state.phase ?? "?";
+    const phaseIdx = PHASE_INDEX[phase.toLowerCase()] ?? "?/4";
+    const progress = state.progress_pct;
+    const progressLine = progress !== null
+        ? `${progress}% (${state.tasks.closed} de ${state.tasks.total} tareas completas)`
+        : "_avance no determinado (TASKS.md ausente o vacío)_";
+    lines.push(`# Checkpoint — ${state.folder}`, "", `- Actualizado: ${state.timestamp}`, `- Fase actual: ${phase} (${phaseIdx})`, `- Avance: ${progressLine}`, "", "## Lo último que hice", "", "_[AI: 1-3 oraciones del último avance concreto. Revisa últimos diffs y la última entrada de DECISIONES.md.]_", "", "## Próximo paso", "", "_[AI: 1-2 oraciones de qué hace falta hacer. Revisa primer item abierto en TASKS.md.]_", "");
+}
+function appendDecisions(lines, state) {
+    lines.push("## Decisiones recientes", "");
+    if (state.last_decision) {
+        lines.push(`- ${state.last_decision.id}: ${state.last_decision.excerpt}`);
+    }
+    else {
+        lines.push("_Sin decisiones registradas._");
+    }
+}
+function appendFilesTouched(lines, state) {
+    lines.push("", "## Archivos tocados (post-último-commit)", "");
+    const files = state.files_touched;
+    if (files.length === 0) {
+        lines.push("_Sin cambios sin commitear detectados en el cwd._");
+        return;
+    }
+    for (const f of files.slice(0, 20)) {
+        lines.push(`- ${f.path} (+${f.added} -${f.removed}) — _[AI: propósito en 1 línea]_`);
+    }
+    if (files.length > 20) {
+        lines.push(`- _… y ${files.length - 20} más_`);
+    }
+}
+function appendContext(lines) {
+    lines.push("", "## Contexto crítico para retomar", "");
+    lines.push("_[AI: 2-3 párrafos con la info mínima para continuar sin re-explorar. Qué descubriste, qué decisiones quedaron tomadas, qué hay que tener presente.]_");
+}
+function appendRefs(lines, state) {
+    lines.push("", "## Refs", "");
+    if (state.origen)
+        lines.push(`- Origen: ${state.origen}`);
+    if (state.branches.length > 0)
+        lines.push(`- Ramas: ${state.branches.join(", ")}`);
+    const present = collectArtefacts(state.artefacts);
+    if (present.length > 0) {
+        lines.push(`- Artefactos presentes: ${present.join(", ")}`);
+    }
+    lines.push("- Skills usadas: _[AI: enumera las skills invocadas durante la sesión]_");
+}
+function collectArtefacts(artefacts) {
+    const present = [];
+    for (const [k, v] of Object.entries(artefacts)) {
+        if (k === "scripts_count")
+            continue;
+        if (v === true)
+            present.push(k);
+    }
+    const scriptsCount = artefacts.scripts_count;
+    if (typeof scriptsCount === "number" && scriptsCount > 0) {
+        present.push(`scripts(${scriptsCount})`);
+    }
+    return present;
+}
+function formatNowMinute() {
+    const now = new Date();
+    const yyyy = now.getFullYear();
+    const mm = String(now.getMonth() + 1).padStart(2, "0");
+    const dd = String(now.getDate()).padStart(2, "0");
+    const hh = String(now.getHours()).padStart(2, "0");
+    const mi = String(now.getMinutes()).padStart(2, "0");
+    return `${yyyy}-${mm}-${dd} ${hh}:${mi}`;
+}
+export async function runAutoCompactOnClose(fs, env, git, paths) {
+    const cwd = env.cwd();
+    const actives = await findActiveSessions(fs, cwd);
+    if (actives.length === 0) {
+        return { skipped: true, reason: "no hay sesiones activas" };
+    }
+    const written = [];
+    for (const a of actives) {
+        const entry = await writeCheckpointForActive(fs, git, cwd, paths, a.folder);
+        if (entry)
+            written.push(entry);
+    }
+    return { checkpoints_written: written };
+}
+async function writeCheckpointForActive(fs, git, cwd, paths, folder) {
+    if (!folder)
+        return null;
+    const sessionPath = join(paths.cwdSessionsDir(), folder);
+    if (!(await fs.exists(sessionPath)))
+        return null;
+    const cpPath = join(sessionPath, "CHECKPOINT.md");
+    if (await fs.exists(cpPath)) {
+        const existing = await fs.readText(cpPath);
+        if (!existing.includes(PLACEHOLDER_MARKER)) {
+            return {
+                session: folder,
+                checkpoint_path: cpPath,
+                skipped: true,
+                reason: "CHECKPOINT.md ya sintetizado",
+            };
+        }
+    }
+    try {
+        const state = await extractSessionState(fs, git, cwd, paths, sessionPath);
+        const md = formatCheckpointMd(state);
+        await fs.mkdirp(sessionPath);
+        await fs.writeText(cpPath, md);
+        return {
+            session: folder,
+            checkpoint_path: cpPath,
+            phase: state.phase,
+            progress_pct: state.progress_pct,
+        };
+    }
+    catch (err) {
+        return {
+            session: folder,
+            error: err instanceof Error ? `${err.name}: ${err.message}` : String(err),
+        };
+    }
+}
+//# sourceMappingURL=checkpoint-write-service.js.map