@tacuchi/agent-workflow-cli 4.0.0

package/dist/application/auto-plan.js

@@ -0,0 +1,190 @@
+import { extractPathsOrRepos, tokens } from "./orchestration.js";
+const RFC_KEYWORDS = new Set(["rfc", "post-mortem", "postmortem"]);
+const TRIVIAL_VERBS = new Set([
+    "typo",
+    "rename",
+    "renombrar",
+    "comment",
+    "comentario",
+    "fix-typo",
+    "comma",
+    "format",
+    "formatear",
+    "indent",
+    "indentación",
+]);
+const DESIGN_KEYWORDS = new Set([
+    "ui",
+    "ux",
+    "interfaz",
+    "diseño",
+    "diseno",
+    "mock",
+    "mockup",
+    "wireframe",
+    "layout",
+    "pantalla",
+    "screen",
+    "form",
+    "formulario",
+    "modal",
+    "componente",
+    "estilo",
+    "css",
+    "tema",
+    "theme",
+    "spec",
+    "design-system",
+]);
+const ANALYZE_KEYWORDS = new Set([
+    "rfc",
+    "post-mortem",
+    "postmortem",
+    "análisis",
+    "analisis",
+    "investigar",
+    "investigación",
+    "investigacion",
+    "auditoría",
+    "auditoria",
+    "hipótesis",
+    "hipotesis",
+    "hallazgo",
+    "evidencia",
+    "métrica",
+    "metrica",
+    "performance",
+    "latencia",
+    "incidente",
+]);
+export function shouldSkipFullPlan(objetivoText) {
+    if (!objetivoText || objetivoText.trim().length === 0) {
+        return {
+            decision: "lite",
+            reason: "OBJETIVO vacío o no provisto; default lite",
+            signals: [],
+        };
+    }
+    const criteria = countAcceptanceCriteria(objetivoText);
+    const sources = countSourcesMentioned(objetivoText);
+    const hasDesign = mentionsAny(objetivoText, DESIGN_KEYWORDS);
+    const hasAnalyze = mentionsAny(objetivoText, ANALYZE_KEYWORDS);
+    const hasRfc = mentionsAny(objetivoText, RFC_KEYWORDS);
+    const eta = estimateEtaHours(objetivoText);
+    const trivial = looksTrivial(objetivoText);
+    const signals = [];
+    if (criteria >= 2)
+        signals.push(`>=2 criterios de aceptación (${criteria})`);
+    if (sources >= 3)
+        signals.push(`>=3 fuentes mencionadas (${sources})`);
+    if (hasDesign)
+        signals.push("menciona diseño/UI/UX");
+    if (hasRfc)
+        signals.push("menciona RFC/post-mortem");
+    if (eta > 4)
+        signals.push(`ETA estimada ${formatNumber(eta)}h (>4h)`);
+    if (signals.length > 0) {
+        return {
+            decision: "full",
+            reason: signals.join("; "),
+            signals,
+            metrics: {
+                criteria,
+                sources,
+                eta_hours: eta,
+                design: hasDesign,
+                analyze: hasAnalyze,
+                rfc: hasRfc,
+            },
+        };
+    }
+    if (trivial) {
+        return {
+            decision: "skip",
+            reason: "OBJETIVO corto + sin estructura + verbos triviales",
+            signals: ["trivial"],
+            metrics: { criteria, sources, eta_hours: eta },
+        };
+    }
+    return {
+        decision: "lite",
+        reason: "tarea moderada sin disparadores fuertes; plan corto suficiente",
+        signals: [],
+        metrics: { criteria, sources, eta_hours: eta },
+    };
+}
+export function countAcceptanceCriteria(text) {
+    if (!text)
+        return 0;
+    // Mirror Python: \Z anchor doesn't exist in JS; line-by-line section parser.
+    const lines = text.split("\n");
+    let captureFrom = null;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (line === undefined)
+            continue;
+        const m = line.match(/^##\s+(?:Criterios?\s+de\s+aceptaci[oó]n|Acceptance\s+Criteria)\s*$/i);
+        if (m) {
+            captureFrom = i + 1;
+            break;
+        }
+    }
+    if (captureFrom === null)
+        return 0;
+    let count = 0;
+    for (let i = captureFrom; i < lines.length; i++) {
+        const line = lines[i];
+        if (line === undefined)
+            continue;
+        if (line.startsWith("##"))
+            break;
+        if (/^\s*[-*]\s+/.test(line))
+            count += 1;
+    }
+    return count;
+}
+export function countSourcesMentioned(text) {
+    return extractPathsOrRepos(text ?? "").size;
+}
+function mentionsAny(text, vocab) {
+    const toks = tokens(text);
+    for (const t of toks)
+        if (vocab.has(t))
+            return true;
+    return false;
+}
+export function looksTrivial(text) {
+    if (!text)
+        return false;
+    const trimmed = text.trim();
+    if (trimmed.length > 200)
+        return false;
+    const toks = tokens(trimmed);
+    for (const t of toks) {
+        if (TRIVIAL_VERBS.has(t))
+            return true;
+    }
+    if (countSourcesMentioned(trimmed) <= 1 && countAcceptanceCriteria(trimmed) === 0) {
+        if (trimmed.split(/\s+/).filter((w) => w.length > 0).length < 15)
+            return true;
+    }
+    return false;
+}
+export function estimateEtaHours(text) {
+    if (!text)
+        return 0;
+    const words = text.split(/\s+/).filter((w) => w.length > 0).length;
+    const sources = countSourcesMentioned(text);
+    const criteria = countAcceptanceCriteria(text);
+    const base = words / 200;
+    const srcFactor = 1 + 0.5 * Math.max(0, sources - 1);
+    const critFactor = 1 + 0.3 * criteria;
+    return Math.round(base * srcFactor * critFactor * 10) / 10;
+}
+function formatNumber(n) {
+    // Python float repr: 4.0 → "4.0"; integers stay as "4". Round to 1 decimal anyway.
+    if (Number.isInteger(n))
+        return `${n}.0`;
+    return String(n);
+}
+//# sourceMappingURL=auto-plan.js.map

package/dist/application/auto-plan.js.map

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

package/dist/application/check-branch-service.d.ts

@@ -0,0 +1,31 @@
+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 CheckBranchInput {
+    alias?: string;
+    pathArg?: string;
+    fileArg?: string;
+    sessionCode?: string;
+    flowOverride?: string;
+    strict?: boolean;
+}
+export interface CheckBranchOutput {
+    match: boolean;
+    reason?: string;
+    alias?: string;
+    path?: string;
+    flow?: string | null;
+    current_branch?: string | null;
+    expected_work_branch?: string | null;
+    dirty?: boolean | null;
+    changed_files?: string[];
+    is_repo?: boolean;
+    error?: string | null;
+    main_branch?: string;
+    session_code?: string | null;
+    work_branch?: string | null;
+    exitCode?: number;
+}
+export declare function runCheckBranch(fs: FileSystemPort, env: EnvPort, git: GitPort, paths: PathsService, input: CheckBranchInput): Promise<CheckBranchOutput>;
+//# sourceMappingURL=check-branch-service.d.ts.map

package/dist/application/check-branch-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-branch-service.d.ts","sourceRoot":"","sources":["../../src/application/check-branch-service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAM/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,cAAc,CAClC,EAAE,EAAE,cAAc,EAClB,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,iBAAiB,CAAC,CAiF5B"}

package/dist/application/check-branch-service.js

@@ -0,0 +1,140 @@
+import { join } from "node:path";
+import { parseProjectBlock, } from "./parsers/project-block.js";
+export async function runCheckBranch(fs, env, git, paths, input) {
+    const cwd = env.cwd();
+    const block = await readBlock(fs, cwd, paths);
+    const sources = block?.fuentes ?? [];
+    if (sources.length === 0) {
+        return { match: true, reason: "no_sources_declared" };
+    }
+    const target = await resolveTarget(fs, sources, input);
+    if (!target) {
+        return { match: true, reason: "file_not_in_managed_source" };
+    }
+    const sessionEntry = resolveSessionEntry(block?.sessions ?? [], input.sessionCode);
+    const sessionBranches = sessionEntry?.branches ?? [];
+    const flow = input.flowOverride ?? resolveFlow(sessionEntry);
+    const expected = expectedWorkBranch(target, block?.working_branches ?? {}, sessionBranches, flow);
+    if (expected === null) {
+        return {
+            match: true,
+            reason: "no_expected_branch_declared",
+            alias: target.alias,
+            path: target.path,
+            flow,
+        };
+    }
+    // Live git status
+    if (!(await fs.exists(target.path))) {
+        return {
+            ...target,
+            match: false,
+            expected_work_branch: expected,
+            current_branch: null,
+            dirty: null,
+            changed_files: [],
+            is_repo: false,
+            error: `Path does not exist: ${target.path}`,
+            session_code: input.sessionCode ?? null,
+            flow,
+            work_branch: expected,
+        };
+    }
+    if (!(await git.isGitRepo(target.path))) {
+        return {
+            ...target,
+            match: false,
+            expected_work_branch: expected,
+            current_branch: null,
+            dirty: null,
+            changed_files: [],
+            is_repo: false,
+            error: "Not a git repository",
+            session_code: input.sessionCode ?? null,
+            flow,
+            work_branch: expected,
+        };
+    }
+    const current = (await git.currentBranch(target.path)) ?? null;
+    const match = current === expected;
+    let changed = [];
+    try {
+        changed = await git.changedFiles(target.path);
+    }
+    catch {
+        changed = [];
+    }
+    return {
+        ...target,
+        expected_work_branch: expected,
+        current_branch: current,
+        match,
+        dirty: changed.length > 0,
+        changed_files: changed,
+        is_repo: true,
+        error: null,
+        session_code: input.sessionCode ?? null,
+        flow,
+        work_branch: expected,
+    };
+}
+async function readBlock(fs, cwd, paths) {
+    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)
+            return block;
+    }
+    return null;
+}
+async function resolveTarget(_fs, sources, input) {
+    if (input.alias) {
+        return sources.find((s) => s.alias === input.alias) ?? null;
+    }
+    if (input.pathArg) {
+        const target = sources.find((s) => s.path === input.pathArg);
+        return target ?? null;
+    }
+    if (input.fileArg) {
+        // Match if fileArg starts with the source path.
+        for (const s of sources) {
+            if (input.fileArg.startsWith(s.path))
+                return s;
+        }
+        return null;
+    }
+    return null;
+}
+function resolveSessionEntry(sessions, sessionCode) {
+    if (!sessionCode)
+        return sessions[0] ?? null;
+    for (const s of sessions) {
+        if (s.folder.startsWith(`session${sessionCode}`))
+            return s;
+    }
+    return null;
+}
+function resolveFlow(session) {
+    if (!session)
+        return null;
+    const m = session.folder.match(/^session(\d{3})-([a-z]+)-/);
+    if (!m || !m[2])
+        return null;
+    return ["dev", "design", "analyze"].includes(m[2]) ? m[2] : null;
+}
+function expectedWorkBranch(source, workingBranches, sessionBranches, flow) {
+    for (const entry of sessionBranches) {
+        if (!entry.includes(":"))
+            continue;
+        const [a, b] = entry.split(":", 2);
+        if (a?.trim() === source.alias && b?.trim())
+            return b.trim();
+    }
+    if (flow === "analyze")
+        return source.main_branch;
+    if (workingBranches[source.alias])
+        return workingBranches[source.alias] ?? null;
+    return null;
+}
+//# sourceMappingURL=check-branch-service.js.map

package/dist/application/check-branch-service.js.map

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

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

@@ -0,0 +1,77 @@
+import type { EnvPort } from "../ports/env.js";
+import type { FileSystemPort } from "../ports/file-system.js";
+import { type ProjectSession } from "./parsers/project-block.js";
+import type { PathsService } from "./paths-service.js";
+export interface CheckpointFields {
+    path: string;
+    actualizado: string | null;
+    fase: string | null;
+    avance: string | null;
+    ultimo: string | null;
+    proximo: string | null;
+    decisiones: string | null;
+    archivos: string | null;
+    contexto: string | null;
+    refs: string | null;
+    raw: string;
+}
+export interface CheckpointStatus {
+    status: "missing" | "draft" | "stale" | "complete";
+    checkpoint_path: string | null;
+    unfilled_placeholders: string[];
+    needs_ai_action: boolean;
+    age_seconds: number | null;
+}
+export declare function readLatestCheckpoint(fs: FileSystemPort, sessionPath: string): Promise<CheckpointFields | null>;
+export declare function computeCheckpointStatus(fs: FileSystemPort, sessionPath: string, options?: {
+    staleThresholdSeconds?: number;
+    now?: Date;
+}): Promise<CheckpointStatus>;
+export interface CheckpointReadOutput {
+    session: string;
+    checkpoint: CheckpointFields | null;
+    reason?: string;
+}
+export interface CheckpointReadError {
+    error: string;
+}
+export declare function runCheckpointRead(fs: FileSystemPort, env: EnvPort, paths: PathsService, code: string | undefined): Promise<CheckpointReadOutput | CheckpointReadError>;
+export declare function findActiveSessions(fs: FileSystemPort, cwd: string): Promise<ProjectSession[]>;
+export interface ResumeSummaryOutput {
+    active_sessions: string[];
+    primary_session: string | null;
+    primary_session_code?: string | null;
+    phase_from_qtc_project?: string | null;
+    branches_from_qtc_project?: string[];
+    checkpoint_present: boolean;
+    checkpoint_path?: string | null;
+    checkpoint_status: CheckpointStatus["status"];
+    checkpoint_age_seconds?: number | null;
+    unfilled_placeholders: string[];
+    needs_ai_action: boolean;
+    checkpoint?: {
+        actualizado: string | null;
+        fase: string | null;
+        avance: string | null;
+        proximo: string[] | null;
+    };
+}
+export declare function runResumeSummary(fs: FileSystemPort, env: EnvPort, paths: PathsService): Promise<ResumeSummaryOutput>;
+export interface CompressCheckpointOutput {
+    session: string;
+    candidates: Array<{
+        file: string;
+        lines: number;
+        excess: number;
+        head_excerpt: string;
+        tail_excerpt: string;
+    }>;
+}
+export interface CompressCheckpointError {
+    error: string;
+}
+export declare function runCompressCheckpoint(fs: FileSystemPort, env: EnvPort, paths: PathsService, options?: {
+    code?: string;
+    threshold?: number;
+}): Promise<CompressCheckpointOutput | CompressCheckpointError>;
+//# sourceMappingURL=checkpoint-service.d.ts.map

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

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