cortex-agents 4.0.2 → 4.0.3

package/dist/tools/quality-gate.d.ts

@@ -8,6 +8,7 @@ export declare const qualityGateSummary: {
     description: string;
     args: {
         scope: import("zod").ZodOptional<import("zod").ZodString>;
+        changedFiles: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
         testing: import("zod").ZodOptional<import("zod").ZodString>;
         security: import("zod").ZodOptional<import("zod").ZodString>;
         audit: import("zod").ZodOptional<import("zod").ZodString>;
@@ -17,6 +18,7 @@ export declare const qualityGateSummary: {
     };
     execute(args: {
         scope?: string | undefined;
+        changedFiles?: string[] | undefined;
         testing?: string | undefined;
         security?: string | undefined;
         audit?: string | undefined;

package/dist/tools/quality-gate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"quality-gate.d.ts","sourceRoot":"","sources":["../../src/tools/quality-gate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA6CH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;CA+I7B,CAAC"}
+{"version":3,"file":"quality-gate.d.ts","sourceRoot":"","sources":["../../src/tools/quality-gate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA8CH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;CA0J7B,CAAC"}

package/dist/tools/quality-gate.js

@@ -7,6 +7,7 @@
 import { tool } from "@opencode-ai/plugin";
 import * as fs from "fs";
 import * as path from "path";
+import { classifyChangeScope } from "../utils/change-scope.js";
 const CORTEX_DIR = ".cortex";
 const QUALITY_GATE_FILE = "quality-gate.json";
 // ─── Severity ordering ───────────────────────────────────────────────────────
@@ -27,7 +28,11 @@ export const qualityGateSummary = tool({
         scope: tool.schema
             .string()
             .optional()
-            .describe("Change scope classification: trivial, low, standard, high"),
+            .describe("Change scope classification: trivial, low, standard, high. If changedFiles is provided, this is auto-classified and this field is ignored."),
+        changedFiles: tool.schema
+            .array(tool.schema.string())
+            .optional()
+            .describe("Array of changed file paths. When provided, scope is auto-classified using classifyChangeScope."),
         testing: tool.schema
             .string()
             .optional()
@@ -56,6 +61,12 @@ export const qualityGateSummary = tool({
     async execute(args, context) {
         const cwd = context.worktree;
         const reports = [];
+        // Auto-classify scope from changed files if provided
+        let resolvedScope = args.scope ?? "unknown";
+        if (args.changedFiles && args.changedFiles.length > 0) {
+            const classification = classifyChangeScope(args.changedFiles);
+            resolvedScope = classification.scope;
+        }
         // Parse each provided report
         const agentEntries = [
             ["testing", args.testing],
@@ -93,7 +104,7 @@ export const qualityGateSummary = tool({
         // Build state for persistence
         const state = {
             timestamp: new Date().toISOString(),
-            scope: args.scope ?? "unknown",
+            scope: resolvedScope,
             reports,
             recommendation,
         };
@@ -104,7 +115,7 @@ export const qualityGateSummary = tool({
         lines.push(`\u2713 Quality Gate Summary`);
         lines.push("");
         lines.push(`**Recommendation: ${recommendation}**`);
-        lines.push(`Scope: ${args.scope ?? "unknown"}`);
+        lines.push(`Scope: ${resolvedScope}`);
         lines.push(`Agents: ${reports.map((r) => r.agent).join(", ")}`);
         lines.push(`Total findings: ${allFindings.length}`);
         lines.push("");

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

@@ -1 +1 @@
-{"version":3,"file":"repl.d.ts","sourceRoot":"","sources":["../../src/tools/repl.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA0BH,eAAO,MAAM,IAAI;;;;;;;;;;;;;;CAwGf,CAAC;AAIH,eAAO,MAAM,MAAM;;;;CA0BjB,CAAC;AAIH,eAAO,MAAM,MAAM;;;;;;;;;;;;;;CAwCjB,CAAC;AAkFH,eAAO,MAAM,MAAM;;;;CA+CjB,CAAC;AAIH,eAAO,MAAM,OAAO;;;;CAclB,CAAC"}
+{"version":3,"file":"repl.d.ts","sourceRoot":"","sources":["../../src/tools/repl.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA0BH,eAAO,MAAM,IAAI;;;;;;;;;;;;;;CAyGf,CAAC;AAIH,eAAO,MAAM,MAAM;;;;CA0BjB,CAAC;AAIH,eAAO,MAAM,MAAM;;;;;;;;;;;;;;CAwCjB,CAAC;AAkFH,eAAO,MAAM,MAAM;;;;CA+CjB,CAAC;AAIH,eAAO,MAAM,OAAO;;;;CAclB,CAAC"}

package/dist/tools/repl.js

@@ -73,6 +73,7 @@ export const init = tool({
             iterations: [],
         }));
         const state = {
+            version: 1,
             planFilename,
             startedAt: new Date().toISOString(),
             buildCommand: finalBuild,

package/dist/tools/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/tools/session.ts"],"names":[],"mappings":"AA4BA,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;CAuFf,CAAC;AAEH,eAAO,MAAM,IAAI;;;;;;;;CA8Df,CAAC;AAEH,eAAO,MAAM,IAAI;;;;;;;;CAuBf,CAAC"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/tools/session.ts"],"names":[],"mappings":"AA4DA,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;CA2Ff,CAAC;AAEH,eAAO,MAAM,IAAI;;;;;;;;CA8Df,CAAC;AAEH,eAAO,MAAM,IAAI;;;;;;;;CAuBf,CAAC"}

package/dist/tools/session.js

@@ -2,8 +2,40 @@ import { tool } from "@opencode-ai/plugin";
 import * as fs from "fs";
 import * as path from "path";
 import { git } from "../utils/shell.js";
+import { readCortexConfig } from "../utils/repl.js";
 const CORTEX_DIR = ".cortex";
 const SESSIONS_DIR = "sessions";
+/**
+ * Delete session files older than the configured retention period.
+ */
+function cleanExpiredSessions(worktree) {
+    const config = readCortexConfig(worktree);
+    const retentionDays = config.sessionRetentionDays;
+    if (!retentionDays || retentionDays <= 0)
+        return 0;
+    const sessionsPath = path.join(worktree, CORTEX_DIR, SESSIONS_DIR);
+    if (!fs.existsSync(sessionsPath))
+        return 0;
+    const cutoff = Date.now() - retentionDays * 24 * 60 * 60 * 1000;
+    let deleted = 0;
+    for (const file of fs.readdirSync(sessionsPath)) {
+        if (!file.endsWith(".md"))
+            continue;
+        // Session filenames start with YYYY-MM-DD — parse the date prefix
+        const dateStr = file.substring(0, 10);
+        const fileDate = new Date(dateStr);
+        if (!isNaN(fileDate.getTime()) && fileDate.getTime() < cutoff) {
+            try {
+                fs.unlinkSync(path.join(sessionsPath, file));
+                deleted++;
+            }
+            catch {
+                // Ignore deletion errors
+            }
+        }
+    }
+    return deleted;
+}
 function getDatePrefix() {
     const now = new Date();
     return now.toISOString().split("T")[0]; // YYYY-MM-DD
@@ -90,12 +122,15 @@ See: \`.cortex/plans/${relatedPlan}\`
         }
         // Write file
         fs.writeFileSync(filepath, content);
+        // Clean up expired sessions based on retention config
+        const cleaned = cleanExpiredSessions(context.worktree);
+        const cleanedMsg = cleaned > 0 ? `\nCleaned up ${cleaned} expired session(s).` : "";
         return `✓ Session summary saved
 
 File: ${filename}
 Branch: ${currentBranch}
 Decisions recorded: ${decisions.length}
-${filesChanged ? `Files tracked: ${filesChanged.length}` : ""}
+${filesChanged ? `Files tracked: ${filesChanged.length}` : ""}${cleanedMsg}
 
 Session summaries are stored in .cortex/sessions/ and gitignored by default.`;
     },

package/dist/tools/task.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../src/tools/task.ts"],"names":[],"mappings":"AA+EA,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;CA0OnB,CAAC"}
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../src/tools/task.ts"],"names":[],"mappings":"AAgFA,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;CAyPnB,CAAC"}

package/dist/tools/task.js

@@ -5,6 +5,7 @@ import { detectWorktreeInfo } from "../utils/worktree-detect.js";
 import { findPlanContent, extractPlanSections, extractIssueRefs, buildPrBodyFromPlan, } from "../utils/plan-extract.js";
 import { git, gh } from "../utils/shell.js";
 import { checkGhAvailability } from "../utils/github.js";
+const CORTEX_DIR = ".cortex";
 const PROTECTED_BRANCHES = ["main", "master", "develop", "production", "staging"];
 const DOCS_DIR = "docs";
 // ─── Helpers ─────────────────────────────────────────────────────────────────
@@ -162,9 +163,21 @@ Create a feature/bugfix branch first with branch_create or worktree_create.`;
         else {
             output.push(`Documentation: ${docsCheck.count} doc(s) found`);
         }
-        // ── 6. Stage all changes ──────────────────────────────────
+        // ── 6. Stage changes safely ─────────────────────────────
         try {
-            await git(cwd, "add", "-A");
+            // Stage tracked file changes (safe — won't pick up new untracked files)
+            await git(cwd, "add", "-u");
+            // Stage .cortex/ directory explicitly (plans, state, etc.)
+            const cortexPath = path.join(cwd, CORTEX_DIR);
+            if (fs.existsSync(cortexPath)) {
+                await git(cwd, "add", CORTEX_DIR);
+            }
+            // Warn about untracked files that won't be staged
+            const { stdout: untrackedOut } = await git(cwd, "ls-files", "--others", "--exclude-standard");
+            const untrackedFiles = untrackedOut.trim().split("\n").filter(Boolean);
+            if (untrackedFiles.length > 0) {
+                warnings.push(`${untrackedFiles.length} untracked file(s) not staged: ${untrackedFiles.slice(0, 5).join(", ")}${untrackedFiles.length > 5 ? ` (and ${untrackedFiles.length - 5} more)` : ""}. Stage them manually with \`git add <file>\` if needed.`);
+            }
         }
         catch (error) {
             return `✗ Error staging changes: ${error.message || error}`;

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

@@ -1 +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"}
+{"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;AAmHD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,iBAAiB,CAsE7E"}

package/dist/utils/change-scope.js

@@ -34,13 +34,14 @@ const LOW_RISK_PATTERNS = [
 ];
 /** Patterns that indicate high-risk changes — auth, payments, infra, security */
 const HIGH_RISK_PATTERNS = [
-    // Auth & security
-    /auth/i,
+    // Auth & security — match directory boundaries, not arbitrary substrings
+    /\bauth[/\-._]/i,
+    /\/auth\b/i,
     /login/i,
-    /session/i,
+    /\/session\b/i,
     /password/i,
-    /token/i,
-    /crypto/i,
+    /\/tokens?\b/i,
+    /\bcrypto[/\-._]/i,
     /encrypt/i,
     /permission/i,
     /rbac/i,
@@ -51,7 +52,7 @@ const HIGH_RISK_PATTERNS = [
     /payment/i,
     /billing/i,
     /stripe/i,
-    /checkout/i,
+    /\/checkout\b/i,
     // Infrastructure & deployment
     /Dockerfile/i,
     /docker-compose/i,
@@ -93,21 +94,15 @@ const DEVOPS_PATTERNS = [
 ];
 /** Patterns that indicate performance-sensitive changes */
 const PERF_PATTERNS = [
-    /query/i,
+    /\/queries?\b/i,
     /database/i,
     /migration/i,
     /\.sql$/i,
     /prisma/i,
     /drizzle/i,
     /repository/i,
-    /cache/i,
-    /render/i,
-    /component/i,
-    /hook/i,
+    /\/cache[/\-._]/i,
     /algorithm/i,
-    /sort/i,
-    /search/i,
-    /index/i,
     /worker/i,
     /stream/i,
     /batch/i,

package/dist/utils/repl.d.ts

@@ -35,6 +35,8 @@ export interface ReplTask {
     completedAt?: string;
 }
 export interface ReplState {
+    /** Schema version for migration support */
+    version: number;
     /** Source plan filename */
     planFilename: string;
     /** ISO timestamp when the loop started */
@@ -57,6 +59,8 @@ export interface ReplState {
 export interface CortexConfig {
     /** Max retries per task before escalating to user */
     maxRetries?: number;
+    /** Session retention in days */
+    sessionRetentionDays?: number;
 }
 export interface CommandDetection {
     buildCommand: string | null;
@@ -86,6 +90,11 @@ export declare function parseTasksFromPlan(planContent: string): string[];
  * Returns structured tasks including `- AC:` lines found under each checkbox item.
  */
 export declare function parseTasksWithAC(planContent: string): ParsedTask[];
+/**
+ * Detect the package manager from lockfiles.
+ * Priority: bun > pnpm > yarn > npm (fallback)
+ */
+export declare function detectPackageManager(cwd: string): "bun" | "pnpm" | "yarn" | "npm";
 /**
  * Auto-detect build, test, and lint commands from project configuration files.
  *

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

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

package/dist/utils/repl.js

@@ -13,6 +13,7 @@ import * as path from "path";
 // ─── Constants ───────────────────────────────────────────────────────────────
 const CORTEX_DIR = ".cortex";
 const REPL_STATE_FILE = "repl-state.json";
+const REPL_STATE_VERSION = 1;
 /**
  * Parse plan tasks from plan markdown content.
  *
@@ -89,6 +90,23 @@ function extractTasksSection(content) {
     return sectionLines.length > 0 ? sectionLines.join("\n") : null;
 }
 // ─── Command Auto-Detection ──────────────────────────────────────────────────
+/**
+ * Detect the package manager from lockfiles.
+ * Priority: bun > pnpm > yarn > npm (fallback)
+ */
+export function detectPackageManager(cwd) {
+    if (fs.existsSync(path.join(cwd, "bun.lockb")) ||
+        fs.existsSync(path.join(cwd, "bun.lock"))) {
+        return "bun";
+    }
+    if (fs.existsSync(path.join(cwd, "pnpm-lock.yaml"))) {
+        return "pnpm";
+    }
+    if (fs.existsSync(path.join(cwd, "yarn.lock"))) {
+        return "yarn";
+    }
+    return "npm";
+}
 /**
  * Auto-detect build, test, and lint commands from project configuration files.
  *
@@ -116,30 +134,32 @@ export async function detectCommands(cwd) {
             const scripts = pkg.scripts || {};
             const devDeps = pkg.devDependencies || {};
             const deps = pkg.dependencies || {};
+            // Detect package manager from lockfiles
+            const pm = detectPackageManager(cwd);
             // Build command
             if (scripts.build) {
-                result.buildCommand = "npm run build";
+                result.buildCommand = pm === "yarn" ? "yarn build" : `${pm} run build`;
             }
             // Test command — prefer specific runner detection
             if (devDeps.vitest || deps.vitest) {
-                result.testCommand = "npx vitest run";
+                result.testCommand = pm === "bun" ? "bun vitest run" : "npx vitest run";
                 result.framework = "vitest";
             }
             else if (devDeps.jest || deps.jest) {
-                result.testCommand = "npx jest";
+                result.testCommand = pm === "bun" ? "bun jest" : "npx jest";
                 result.framework = "jest";
             }
             else if (devDeps.mocha || deps.mocha) {
-                result.testCommand = "npx mocha";
+                result.testCommand = pm === "bun" ? "bun mocha" : "npx mocha";
                 result.framework = "mocha";
             }
             else if (scripts.test && scripts.test !== 'echo "Error: no test specified" && exit 1') {
-                result.testCommand = "npm test";
+                result.testCommand = pm === "yarn" ? "yarn test" : `${pm} test`;
                 result.framework = "npm-test";
             }
             // Lint command
             if (scripts.lint) {
-                result.lintCommand = "npm run lint";
+                result.lintCommand = pm === "yarn" ? "yarn lint" : `${pm} run lint`;
             }
             result.detected = !!(result.buildCommand || result.testCommand);
             if (result.detected)
@@ -238,8 +258,10 @@ export function readCortexConfig(cwd) {
         const raw = JSON.parse(fs.readFileSync(configPath, "utf-8"));
         if (typeof raw !== "object" || raw === null)
             return {};
+        const sessions = typeof raw.sessions === "object" && raw.sessions !== null ? raw.sessions : {};
         return {
             maxRetries: typeof raw.maxRetries === "number" ? raw.maxRetries : undefined,
+            sessionRetentionDays: typeof sessions.retention === "number" ? sessions.retention : undefined,
         };
     }
     catch {
@@ -273,6 +295,14 @@ export function readReplState(cwd) {
             !Array.isArray(raw.tasks)) {
             return null;
         }
+        // Migrate from v0 (no version field) to v1
+        if (typeof raw.version !== "number") {
+            raw.version = REPL_STATE_VERSION;
+        }
+        // Reject state from a newer version we don't understand
+        if (raw.version > REPL_STATE_VERSION) {
+            return null;
+        }
         // Backward compatibility: ensure all tasks have acceptanceCriteria
         for (const task of raw.tasks) {
             if (!Array.isArray(task.acceptanceCriteria)) {

package/package.json

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