cortex-agents 3.4.0 → 4.0.0

package/dist/utils/change-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-scope.d.ts","sourceRoot":"","sources":["../../src/utils/change-scope.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,KAAK,GAAG,UAAU,GAAG,MAAM,CAAC;AAElE,MAAM,WAAW,iBAAiB;IAChC,kCAAkC;IAClC,KAAK,EAAE,WAAW,CAAC;IACnB,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,EAAE,OAAO,CAAC;CACrB;AAwHD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,iBAAiB,CAsE7E"}

package/dist/utils/change-scope.js

@@ -0,0 +1,198 @@
+/**
+ * Change Scope Detection
+ *
+ * Categorizes changed files by risk level to determine which sub-agents
+ * should be triggered during the quality gate. Avoids wasting tokens on
+ * trivial changes while ensuring high-risk changes get full coverage.
+ */
+// ─── File Pattern Matchers ───────────────────────────────────────────────────
+/** Patterns that indicate trivial changes — docs, comments, formatting only */
+const TRIVIAL_PATTERNS = [
+    /\.md$/i,
+    /\.txt$/i,
+    /\.mdx$/i,
+    /LICENSE/i,
+    /CHANGELOG/i,
+    /\.prettierrc/,
+    /\.editorconfig/,
+    /\.vscode\//,
+    /\.idea\//,
+];
+/** Patterns that indicate test/config-only changes — low risk */
+const LOW_RISK_PATTERNS = [
+    /\.test\.[jt]sx?$/,
+    /\.spec\.[jt]sx?$/,
+    /__tests__\//,
+    /test\//,
+    /tests\//,
+    /\.eslintrc/,
+    /\.prettierrc/,
+    /tsconfig.*\.json$/,
+    /jest\.config/,
+    /vitest\.config/,
+    /\.gitignore$/,
+];
+/** Patterns that indicate high-risk changes — auth, payments, infra, security */
+const HIGH_RISK_PATTERNS = [
+    // Auth & security
+    /auth/i,
+    /login/i,
+    /session/i,
+    /password/i,
+    /token/i,
+    /crypto/i,
+    /encrypt/i,
+    /permission/i,
+    /rbac/i,
+    /oauth/i,
+    /jwt/i,
+    /middleware\/auth/i,
+    // Payment & sensitive data
+    /payment/i,
+    /billing/i,
+    /stripe/i,
+    /checkout/i,
+    // Infrastructure & deployment
+    /Dockerfile/i,
+    /docker-compose/i,
+    /\.github\/workflows\//,
+    /\.gitlab-ci/,
+    /Jenkinsfile/i,
+    /\.circleci\//,
+    /terraform\//,
+    /pulumi\//,
+    /k8s\//,
+    /deploy\//,
+    /infra\//,
+    /nginx\.conf/i,
+    /Caddyfile/i,
+    /Procfile/i,
+    /fly\.toml/i,
+];
+/** Patterns that indicate DevOps file changes */
+const DEVOPS_PATTERNS = [
+    /Dockerfile/i,
+    /docker-compose/i,
+    /\.dockerignore/i,
+    /\.github\/workflows\//,
+    /\.gitlab-ci/,
+    /Jenkinsfile/i,
+    /\.circleci\//,
+    /terraform\//,
+    /pulumi\//,
+    /cdk\//,
+    /k8s\//,
+    /deploy\//,
+    /infra\//,
+    /nginx\.conf/i,
+    /Caddyfile/i,
+    /Procfile/i,
+    /fly\.toml/i,
+    /railway\.json/i,
+    /render\.yaml/i,
+];
+/** Patterns that indicate performance-sensitive changes */
+const PERF_PATTERNS = [
+    /query/i,
+    /database/i,
+    /migration/i,
+    /\.sql$/i,
+    /prisma/i,
+    /drizzle/i,
+    /repository/i,
+    /cache/i,
+    /render/i,
+    /component/i,
+    /hook/i,
+    /algorithm/i,
+    /sort/i,
+    /search/i,
+    /index/i,
+    /worker/i,
+    /stream/i,
+    /batch/i,
+    /queue/i,
+];
+// ─── Classification ──────────────────────────────────────────────────────────
+/**
+ * Classify a set of changed files into a risk scope and determine
+ * which sub-agents should be triggered.
+ *
+ * @param changedFiles - Array of file paths that were created or modified
+ * @returns Classification result with scope, rationale, and agent triggers
+ */
+export function classifyChangeScope(changedFiles) {
+    if (changedFiles.length === 0) {
+        return {
+            scope: "trivial",
+            rationale: "No files changed",
+            agents: noAgents(),
+        };
+    }
+    const hasHighRisk = changedFiles.some((f) => HIGH_RISK_PATTERNS.some((p) => p.test(f)));
+    const hasDevOps = changedFiles.some((f) => DEVOPS_PATTERNS.some((p) => p.test(f)));
+    const hasPerf = changedFiles.some((f) => PERF_PATTERNS.some((p) => p.test(f)));
+    const allTrivial = changedFiles.every((f) => TRIVIAL_PATTERNS.some((p) => p.test(f)));
+    const allLowRisk = changedFiles.every((f) => LOW_RISK_PATTERNS.some((p) => p.test(f)) || TRIVIAL_PATTERNS.some((p) => p.test(f)));
+    // Trivial — docs/comments only
+    if (allTrivial) {
+        return {
+            scope: "trivial",
+            rationale: "Documentation/formatting changes only — no quality gate needed",
+            agents: {
+                ...noAgents(),
+                docsWriter: true,
+            },
+        };
+    }
+    // Low risk — tests/config only
+    if (allLowRisk) {
+        return {
+            scope: "low",
+            rationale: "Test/config changes only — minimal quality gate",
+            agents: {
+                ...noAgents(),
+                testing: true,
+            },
+        };
+    }
+    // High risk — auth, payments, infra
+    if (hasHighRisk) {
+        return {
+            scope: "high",
+            rationale: "High-risk changes detected (auth/security/payments/infra) — full quality gate",
+            agents: {
+                testing: true,
+                security: true,
+                audit: true,
+                devops: hasDevOps,
+                perf: hasPerf,
+                docsWriter: true,
+            },
+        };
+    }
+    // Standard — everything else
+    return {
+        scope: "standard",
+        rationale: "Standard code changes — normal quality gate",
+        agents: {
+            testing: true,
+            security: true,
+            audit: true,
+            devops: hasDevOps,
+            perf: hasPerf,
+            docsWriter: true,
+        },
+    };
+}
+/** Helper: no agents triggered */
+function noAgents() {
+    return {
+        testing: false,
+        security: false,
+        audit: false,
+        devops: false,
+        perf: false,
+        docsWriter: false,
+    };
+}

package/dist/utils/plan-extract.d.ts

@@ -1,3 +1,17 @@
+/**
+ * Map plan types to git branch prefixes.
+ */
+export declare const TYPE_TO_PREFIX: Record<string, string>;
+/**
+ * Parse YAML frontmatter from plan content.
+ * Returns a map of key-value pairs, or null if no frontmatter found.
+ */
+export declare function parseFrontmatter(content: string): Record<string, string> | null;
+/**
+ * Update or insert a field in the plan's YAML frontmatter.
+ * Returns the updated file content.
+ */
+export declare function upsertFrontmatterField(content: string, key: string, value: string): string;
 /**
  * Sections extracted from a plan for use in a PR body.
  */
@@ -13,6 +27,13 @@ export interface PlanSections {
     /** The raw plan filename */
     filename: string;
 }
+/**
+ * Extract the branch name from plan frontmatter.
+ *
+ * Looks for `branch: feature/xyz` in YAML frontmatter.
+ * Returns the branch name string, or null if not found.
+ */
+export declare function extractBranch(planContent: string): string | null;
 /**
  * Extract GitHub issue references from plan frontmatter.
  *

package/dist/utils/plan-extract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plan-extract.d.ts","sourceRoot":"","sources":["../../src/utils/plan-extract.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAY9D;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,CAuCvF;AAmCD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAwBlE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,MAAM,EACrB,UAAU,CAAC,EAAE,MAAM,GAClB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA0C9C"}
+{"version":3,"file":"plan-extract.d.ts","sourceRoot":"","sources":["../../src/utils/plan-extract.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAOjD,CAAC;AAEF;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAY/E;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAiB1F;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAShE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAY9D;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,CAuCvF;AAmCD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAwBlE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,MAAM,EACrB,UAAU,CAAC,EAAE,MAAM,GAClB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA0C9C"}

package/dist/utils/plan-extract.js

@@ -2,6 +2,71 @@ import * as fs from "fs";
 import * as path from "path";
 const CORTEX_DIR = ".cortex";
 const PLANS_DIR = "plans";
+/**
+ * Map plan types to git branch prefixes.
+ */
+export const TYPE_TO_PREFIX = {
+    feature: "feature",
+    bugfix: "bugfix",
+    refactor: "refactor",
+    architecture: "refactor",
+    spike: "feature",
+    docs: "docs",
+};
+/**
+ * Parse YAML frontmatter from plan content.
+ * Returns a map of key-value pairs, or null if no frontmatter found.
+ */
+export function parseFrontmatter(content) {
+    const match = content.match(/^---\n([\s\S]*?)\n---/);
+    if (!match)
+        return null;
+    const fm = {};
+    for (const line of match[1].split("\n")) {
+        const kv = line.match(/^(\w+):\s*"?([^"\n]*)"?\s*$/);
+        if (kv) {
+            fm[kv[1]] = kv[2].trim();
+        }
+    }
+    return fm;
+}
+/**
+ * Update or insert a field in the plan's YAML frontmatter.
+ * Returns the updated file content.
+ */
+export function upsertFrontmatterField(content, key, value) {
+    const fmMatch = content.match(/^(---\n)([\s\S]*?)(\n---)/);
+    if (!fmMatch)
+        return content;
+    const fmBody = fmMatch[2];
+    const fieldRegex = new RegExp(`^${key}:\\s*.*$`, "m");
+    let updatedFm;
+    if (fieldRegex.test(fmBody)) {
+        // Update existing field
+        updatedFm = fmBody.replace(fieldRegex, `${key}: ${value}`);
+    }
+    else {
+        // Insert before the closing ---
+        updatedFm = fmBody + `\n${key}: ${value}`;
+    }
+    return fmMatch[1] + updatedFm + fmMatch[3] + content.slice(fmMatch[0].length);
+}
+/**
+ * Extract the branch name from plan frontmatter.
+ *
+ * Looks for `branch: feature/xyz` in YAML frontmatter.
+ * Returns the branch name string, or null if not found.
+ */
+export function extractBranch(planContent) {
+    const frontmatterMatch = planContent.match(/^---\n([\s\S]*?)\n---/);
+    if (!frontmatterMatch)
+        return null;
+    const branchMatch = frontmatterMatch[1].match(/^branch:\s*(.+)$/m);
+    if (!branchMatch)
+        return null;
+    const branch = branchMatch[1].trim();
+    return branch || null;
+}
 /**
  * Extract GitHub issue references from plan frontmatter.
  *

package/dist/utils/repl.d.ts

@@ -21,12 +21,18 @@ export interface ReplTask {
     index: number;
     /** Task description from the plan */
     description: string;
+    /** Acceptance criteria extracted from `- AC:` lines under the task */
+    acceptanceCriteria: string[];
     /** Current status in the state machine */
     status: TaskStatus;
     /** Number of failed attempts (resets on pass) */
     retries: number;
     /** Full iteration history */
     iterations: TaskIteration[];
+    /** ISO timestamp when the task was started */
+    startedAt?: string;
+    /** ISO timestamp when the task was completed/failed/skipped */
+    completedAt?: string;
 }
 export interface ReplState {
     /** Source plan filename */
@@ -48,6 +54,10 @@ export interface ReplState {
     /** All tasks in the loop */
     tasks: ReplTask[];
 }
+export interface CortexConfig {
+    /** Max retries per task before escalating to user */
+    maxRetries?: number;
+}
 export interface CommandDetection {
     buildCommand: string | null;
     testCommand: string | null;
@@ -57,14 +67,25 @@ export interface CommandDetection {
     /** Whether auto-detection found anything */
     detected: boolean;
 }
+export interface ParsedTask {
+    description: string;
+    acceptanceCriteria: string[];
+}
 /**
  * Parse plan tasks from plan markdown content.
  *
  * Looks for unchecked checkbox items (`- [ ] ...`) in a `## Tasks` section.
  * Falls back to any unchecked checkboxes anywhere in the document.
  * Strips the `Task N:` prefix if present to get a clean description.
+ * Extracts `- AC:` lines immediately following each task as acceptance criteria.
  */
 export declare function parseTasksFromPlan(planContent: string): string[];
+/**
+ * Parse plan tasks with their acceptance criteria.
+ *
+ * Returns structured tasks including `- AC:` lines found under each checkbox item.
+ */
+export declare function parseTasksWithAC(planContent: string): ParsedTask[];
 /**
  * Auto-detect build, test, and lint commands from project configuration files.
  *
@@ -77,6 +98,11 @@ export declare function parseTasksFromPlan(planContent: string): string[];
  *   6. mix.exs (Elixir)
  */
 export declare function detectCommands(cwd: string): Promise<CommandDetection>;
+/**
+ * Read cortex config from .cortex/config.json.
+ * Returns an empty config if the file doesn't exist or is malformed.
+ */
+export declare function readCortexConfig(cwd: string): CortexConfig;
 /**
  * Read the current REPL state from .cortex/repl-state.json.
  * Returns null if no state file exists.
@@ -101,6 +127,11 @@ export declare function getCurrentTask(state: ReplState): ReplTask | null;
  * Check if the loop is complete (no pending or in_progress tasks).
  */
 export declare function isLoopComplete(state: ReplState): boolean;
+/**
+ * Detect if a previous REPL loop was interrupted mid-task.
+ * Returns the incomplete state if found, null otherwise.
+ */
+export declare function detectIncompleteState(cwd: string): ReplState | null;
 /**
  * Format the current loop status as a human-readable string.
  * Used by repl_status tool output.

package/dist/utils/repl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repl.d.ts","sourceRoot":"","sources":["../../src/utils/repl.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAaH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,aAAa,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAErF,MAAM,WAAW,aAAa;IAC5B,sCAAsC;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,gCAAgC;IAChC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACjC,yDAAyD;IACzD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,QAAQ;IACvB,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,MAAM,EAAE,UAAU,CAAC;IACnB,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,UAAU,EAAE,aAAa,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,SAAS;IACxB,2BAA2B;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,kDAAkD;IAClD,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,4BAA4B;IAC5B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,kEAAkE;IAClE,UAAU,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,gBAAgB,EAAE,MAAM,CAAC;IACzB,4BAA4B;IAC5B,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,QAAQ,EAAE,OAAO,CAAC;CACnB;AAID;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAsBhE;AA4BD;;;;;;;;;;GAUG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA6H3E;AAWD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAwB3D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI,CAuBlE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,GAAG,IAAI,CAE7D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,GAAG,IAAI,CAEhE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAIxD;AAWD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAwEvD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CA+EtD"}
+{"version":3,"file":"repl.d.ts","sourceRoot":"","sources":["../../src/utils/repl.ts"],"names":[],"mappings":"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"}

package/dist/utils/repl.js

@@ -13,30 +13,55 @@ import * as path from "path";
 // ─── Constants ───────────────────────────────────────────────────────────────
 const CORTEX_DIR = ".cortex";
 const REPL_STATE_FILE = "repl-state.json";
-// ─── Task Parsing ────────────────────────────────────────────────────────────
 /**
  * Parse plan tasks from plan markdown content.
  *
  * Looks for unchecked checkbox items (`- [ ] ...`) in a `## Tasks` section.
  * Falls back to any unchecked checkboxes anywhere in the document.
  * Strips the `Task N:` prefix if present to get a clean description.
+ * Extracts `- AC:` lines immediately following each task as acceptance criteria.
  */
 export function parseTasksFromPlan(planContent) {
-    // Try to find a ## Tasks section first
+    return parseTasksWithAC(planContent).map((t) => t.description);
+}
+/**
+ * Parse plan tasks with their acceptance criteria.
+ *
+ * Returns structured tasks including `- AC:` lines found under each checkbox item.
+ */
+export function parseTasksWithAC(planContent) {
     const tasksSection = extractTasksSection(planContent);
     const source = tasksSection || planContent;
     const tasks = [];
     const lines = source.split("\n");
-    for (const line of lines) {
-        // Match unchecked checkbox items: - [ ] Description
-        const match = line.match(/^[-*]\s*\[\s\]\s+(.+)$/);
+    for (let i = 0; i < lines.length; i++) {
+        const match = lines[i].match(/^[-*]\s*\[\s\]\s+(.+)$/);
         if (match) {
             let description = match[1].trim();
-            // Strip "Task N:" prefix if present
             description = description.replace(/^Task\s+\d+\s*:\s*/i, "");
-            if (description) {
-                tasks.push(description);
+            if (!description)
+                continue;
+            // Collect AC lines immediately following this task
+            const acs = [];
+            for (let j = i + 1; j < lines.length; j++) {
+                const acMatch = lines[j].match(/^\s+[-*]\s*AC:\s*(.+)$/);
+                if (acMatch) {
+                    acs.push(acMatch[1].trim());
+                }
+                else if (lines[j].match(/^[-*]\s*\[/)) {
+                    // Next task checkbox — stop collecting ACs
+                    break;
+                }
+                else if (lines[j].trim() === "") {
+                    // Blank line — continue (may be spacing between AC lines)
+                    continue;
+                }
+                else {
+                    // Non-AC, non-blank, non-checkbox line — stop
+                    break;
+                }
             }
+            tasks.push({ description, acceptanceCriteria: acs });
         }
     }
     return tasks;
@@ -199,6 +224,28 @@ export async function detectCommands(cwd) {
     }
     return result;
 }
+// ─── Config Reading ─────────────────────────────────────────────────────────
+const CONFIG_FILE = "config.json";
+/**
+ * Read cortex config from .cortex/config.json.
+ * Returns an empty config if the file doesn't exist or is malformed.
+ */
+export function readCortexConfig(cwd) {
+    const configPath = path.join(cwd, CORTEX_DIR, CONFIG_FILE);
+    if (!fs.existsSync(configPath))
+        return {};
+    try {
+        const raw = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+        if (typeof raw !== "object" || raw === null)
+            return {};
+        return {
+            maxRetries: typeof raw.maxRetries === "number" ? raw.maxRetries : undefined,
+        };
+    }
+    catch {
+        return {};
+    }
+}
 // ─── State Management ────────────────────────────────────────────────────────
 /**
  * Get the path to the REPL state file.
@@ -226,6 +273,12 @@ export function readReplState(cwd) {
             !Array.isArray(raw.tasks)) {
             return null;
         }
+        // Backward compatibility: ensure all tasks have acceptanceCriteria
+        for (const task of raw.tasks) {
+            if (!Array.isArray(task.acceptanceCriteria)) {
+                task.acceptanceCriteria = [];
+            }
+        }
         return raw;
     }
     catch {
@@ -281,6 +334,44 @@ export function isLoopComplete(state) {
     return state.tasks.every((t) => t.status === "passed" || t.status === "failed" || t.status === "skipped");
 }
 // ─── Formatting ──────────────────────────────────────────────────────────────
+/**
+ * Detect if a previous REPL loop was interrupted mid-task.
+ * Returns the incomplete state if found, null otherwise.
+ */
+export function detectIncompleteState(cwd) {
+    const state = readReplState(cwd);
+    if (!state)
+        return null;
+    // Loop is already complete
+    if (isLoopComplete(state))
+        return null;
+    // There's an in_progress task — session was interrupted
+    const current = getCurrentTask(state);
+    if (current)
+        return state;
+    // There are pending tasks but no in_progress — also incomplete
+    const next = getNextTask(state);
+    if (next)
+        return state;
+    return null;
+}
+/**
+ * Format task duration as a human-readable string.
+ */
+function formatTaskDuration(task) {
+    if (!task.startedAt)
+        return null;
+    const start = new Date(task.startedAt);
+    const end = task.completedAt ? new Date(task.completedAt) : new Date();
+    const durationMs = end.getTime() - start.getTime();
+    if (durationMs < 1000)
+        return "< 1s";
+    if (durationMs < 60_000)
+        return `${Math.round(durationMs / 1000)}s`;
+    const mins = Math.floor(durationMs / 60_000);
+    const secs = Math.round((durationMs % 60_000) / 1000);
+    return secs > 0 ? `${mins}m ${secs}s` : `${mins}m`;
+}
 /** Visual progress bar using block characters. */
 function progressBar(done, total, width = 20) {
     if (total === 0)
@@ -313,11 +404,23 @@ export function formatProgress(state) {
         if (current.retries > 0) {
             lines.push(`  Attempt: ${current.retries + 1}/${state.maxRetries}`);
         }
+        if (current.acceptanceCriteria.length > 0) {
+            lines.push(`  Acceptance Criteria:`);
+            for (const ac of current.acceptanceCriteria) {
+                lines.push(`    - ${ac}`);
+            }
+        }
     }
     else if (next) {
         lines.push("");
         lines.push(`Next Task (#${next.index + 1}):`);
         lines.push(`  "${next.description}"`);
+        if (next.acceptanceCriteria.length > 0) {
+            lines.push(`  Acceptance Criteria:`);
+            for (const ac of next.acceptanceCriteria) {
+                lines.push(`    - ${ac}`);
+            }
+        }
     }
     else if (isLoopComplete(state)) {
         lines.push("");
@@ -339,18 +442,20 @@ export function formatProgress(state) {
         const iterInfo = task.iterations.length > 0
             ? ` (${task.iterations.length} iteration${task.iterations.length > 1 ? "s" : ""}${task.retries > 0 ? `, ${task.retries} retr${task.retries > 1 ? "ies" : "y"}` : ""})`
             : "";
+        const timeInfo = formatTaskDuration(task);
+        const timeSuffix = timeInfo ? ` [${timeInfo}]` : "";
         switch (task.status) {
             case "passed":
-                lines.push(`  \u2713 ${num} ${task.description}${iterInfo}`);
+                lines.push(`  \u2713 ${num} ${task.description}${iterInfo}${timeSuffix}`);
                 break;
             case "failed":
-                lines.push(`  \u2717 ${num} ${task.description}${iterInfo}`);
+                lines.push(`  \u2717 ${num} ${task.description}${iterInfo}${timeSuffix}`);
                 break;
             case "skipped":
-                lines.push(`  \u2298 ${num} ${task.description}`);
+                lines.push(`  \u2298 ${num} ${task.description}${timeSuffix}`);
                 break;
             case "in_progress":
-                lines.push(`  \u25B6 ${num} ${task.description}${iterInfo}`);
+                lines.push(`  \u25B6 ${num} ${task.description}${iterInfo}${timeSuffix}`);
                 break;
             case "pending":
                 lines.push(`  \u25CB ${num} ${task.description}`);
@@ -407,7 +512,15 @@ export function formatSummary(state) {
         lines.push(`| ${num} | ${desc} | ${statusIcon} | ${attempts} |`);
     }
     lines.push("");
-    lines.push(`**Results: ${passed} passed, ${failed} failed, ${skipped} skipped** (${totalIterations} total iterations)`);
+    const totalACs = state.tasks.reduce((sum, t) => sum + t.acceptanceCriteria.length, 0);
+    const passedACs = state.tasks
+        .filter((t) => t.status === "passed")
+        .reduce((sum, t) => sum + t.acceptanceCriteria.length, 0);
+    let resultsLine = `**Results: ${passed} passed, ${failed} failed, ${skipped} skipped** (${totalIterations} total iterations)`;
+    if (totalACs > 0) {
+        resultsLine += ` | **ACs: ${passedACs}/${totalACs} satisfied**`;
+    }
+    lines.push(resultsLine);
     // Timing
     if (state.startedAt) {
         const start = new Date(state.startedAt);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cortex-agents",
-  "version": "3.4.0",
+  "version": "4.0.0",
   "description": "Supercharge OpenCode with structured workflows, intelligent agents, and automated development practices",
   "type": "module",
   "main": "dist/index.js",