@hoangsonw/forge 0.1.0

package/dist/core/estimation.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.estimatePlan = void 0;
+const WEIGHTS = {
+    analyze: 20,
+    plan: 10,
+    edit_file: 30,
+    apply_patch: 25,
+    create_file: 15,
+    delete_file: 10,
+    run_command: 60,
+    run_tests: 120,
+    review: 15,
+    debug: 30,
+    retrieve_context: 15,
+    ask_user: 45,
+    custom: 30,
+};
+const estimatePlan = (plan) => {
+    let fileWrites = 0;
+    let shellCalls = 0;
+    let networkCalls = 0;
+    let total = 0;
+    for (const s of plan.steps) {
+        if (s.estimatedSeconds)
+            total += s.estimatedSeconds;
+        else
+            total += WEIGHTS[s.type] ?? 20;
+        if (s.type === 'edit_file' ||
+            s.type === 'apply_patch' ||
+            s.type === 'create_file' ||
+            s.type === 'delete_file') {
+            fileWrites++;
+        }
+        if (s.type === 'run_command' || s.type === 'run_tests')
+            shellCalls++;
+        if (s.tool && (s.tool.startsWith('web.') || s.tool.startsWith('mcp.')))
+            networkCalls++;
+    }
+    const summary = `${plan.steps.length} steps · ~${fileWrites} file writes · ~${shellCalls} shell calls` +
+        (networkCalls ? ` · ~${networkCalls} network calls` : '') +
+        ` · ~${Math.round(total / 60)}m estimated`;
+    return {
+        stepCount: plan.steps.length,
+        fileWrites,
+        shellCalls,
+        networkCalls,
+        estimatedSeconds: total,
+        summary,
+    };
+};
+exports.estimatePlan = estimatePlan;
+//# sourceMappingURL=estimation.js.map

package/dist/core/estimation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"estimation.js","sourceRoot":"","sources":["../../src/core/estimation.ts"],"names":[],"mappings":";;;AAmBA,MAAM,OAAO,GAA2B;IACtC,OAAO,EAAE,EAAE;IACX,IAAI,EAAE,EAAE;IACR,SAAS,EAAE,EAAE;IACb,WAAW,EAAE,EAAE;IACf,WAAW,EAAE,EAAE;IACf,WAAW,EAAE,EAAE;IACf,WAAW,EAAE,EAAE;IACf,SAAS,EAAE,GAAG;IACd,MAAM,EAAE,EAAE;IACV,KAAK,EAAE,EAAE;IACT,gBAAgB,EAAE,EAAE;IACpB,QAAQ,EAAE,EAAE;IACZ,MAAM,EAAE,EAAE;CACX,CAAC;AAEK,MAAM,YAAY,GAAG,CAAC,IAAU,EAAY,EAAE;IACnD,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC3B,IAAI,CAAC,CAAC,gBAAgB;YAAE,KAAK,IAAI,CAAC,CAAC,gBAAgB,CAAC;;YAC/C,KAAK,IAAI,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACpC,IACE,CAAC,CAAC,IAAI,KAAK,WAAW;YACtB,CAAC,CAAC,IAAI,KAAK,aAAa;YACxB,CAAC,CAAC,IAAI,KAAK,aAAa;YACxB,CAAC,CAAC,IAAI,KAAK,aAAa,EACxB,CAAC;YACD,UAAU,EAAE,CAAC;QACf,CAAC;QACD,IAAI,CAAC,CAAC,IAAI,KAAK,aAAa,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW;YAAE,UAAU,EAAE,CAAC;QACrE,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;YAAE,YAAY,EAAE,CAAC;IACzF,CAAC;IACD,MAAM,OAAO,GACX,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,aAAa,UAAU,mBAAmB,UAAU,cAAc;QACtF,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,YAAY,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC;QACzD,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,aAAa,CAAC;IAC7C,OAAO;QACL,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM;QAC5B,UAAU;QACV,UAAU;QACV,YAAY;QACZ,gBAAgB,EAAE,KAAK;QACvB,OAAO;KACR,CAAC;AACJ,CAAC,CAAC;AA/BW,QAAA,YAAY,gBA+BvB"}

package/dist/core/fork.d.ts

@@ -0,0 +1,7 @@
+export interface ForkResult {
+    newTaskId: string;
+    newSessionId: string | null;
+    copiedSessionEntries: number;
+}
+export declare const forkTask: (projectRoot: string, taskId: string) => ForkResult;
+//# sourceMappingURL=fork.d.ts.map

package/dist/core/fork.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fork.d.ts","sourceRoot":"","sources":["../../src/core/fork.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,eAAO,MAAM,QAAQ,GAAI,aAAa,MAAM,EAAE,QAAQ,MAAM,KAAG,UA8C9D,CAAC"}

package/dist/core/fork.js

@@ -0,0 +1,93 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.forkTask = void 0;
+/**
+ * Session / task fork — copy an existing task (and session) into a new id so
+ * an alternative approach can be explored without losing the original.
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const tasks_1 = require("../persistence/tasks");
+const paths_1 = require("../config/paths");
+const trace_1 = require("../logging/trace");
+const errors_1 = require("../types/errors");
+const forkTask = (projectRoot, taskId) => {
+    const source = (0, tasks_1.loadTask)(projectRoot, taskId);
+    if (!source) {
+        throw new errors_1.ForgeRuntimeError({
+            class: 'not_found',
+            message: `Task ${taskId} not found`,
+            retryable: false,
+        });
+    }
+    const now = new Date().toISOString();
+    const nextId = (0, trace_1.newTaskId)();
+    const cloned = {
+        ...source,
+        id: nextId,
+        status: 'draft',
+        parentTaskId: source.id,
+        traceId: (0, trace_1.newTraceId)(),
+        runId: (0, trace_1.newRunId)(),
+        createdAt: now,
+        updatedAt: now,
+        startedAt: undefined,
+        completedAt: undefined,
+        result: undefined,
+        attempts: 0,
+    };
+    (0, tasks_1.saveTask)(projectRoot, cloned);
+    // Copy the most recent session JSONL, if one exists.
+    const subs = (0, paths_1.projectSubdirs)(projectRoot);
+    let newSessId = null;
+    let copied = 0;
+    if (fs.existsSync(subs.sessions)) {
+        const sessions = fs.readdirSync(subs.sessions).filter((f) => f.endsWith('.jsonl'));
+        const mostRecent = sessions
+            .map((f) => ({ f, mtime: fs.statSync(path.join(subs.sessions, f)).mtimeMs }))
+            .sort((a, b) => b.mtime - a.mtime)[0]?.f;
+        if (mostRecent) {
+            const srcPath = path.join(subs.sessions, mostRecent);
+            newSessId = (0, trace_1.newSessionId)();
+            const dst = path.join(subs.sessions, `${newSessId}.jsonl`);
+            fs.copyFileSync(srcPath, dst);
+            copied = fs.readFileSync(dst, 'utf8').split('\n').filter(Boolean).length;
+        }
+    }
+    return { newTaskId: nextId, newSessionId: newSessId, copiedSessionEntries: copied };
+};
+exports.forkTask = forkTask;
+//# sourceMappingURL=fork.js.map

package/dist/core/fork.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fork.js","sourceRoot":"","sources":["../../src/core/fork.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;;;GAGG;AACH,uCAAyB;AACzB,2CAA6B;AAC7B,gDAA0D;AAC1D,2CAAiD;AACjD,4CAAiF;AACjF,4CAAoD;AAQ7C,MAAM,QAAQ,GAAG,CAAC,WAAmB,EAAE,MAAc,EAAc,EAAE;IAC1E,MAAM,MAAM,GAAG,IAAA,gBAAQ,EAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAC7C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,0BAAiB,CAAC;YAC1B,KAAK,EAAE,WAAW;YAClB,OAAO,EAAE,QAAQ,MAAM,YAAY;YACnC,SAAS,EAAE,KAAK;SACjB,CAAC,CAAC;IACL,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,MAAM,GAAG,IAAA,iBAAS,GAAE,CAAC;IAC3B,MAAM,MAAM,GAAG;QACb,GAAG,MAAM;QACT,EAAE,EAAE,MAAM;QACV,MAAM,EAAE,OAAgB;QACxB,YAAY,EAAE,MAAM,CAAC,EAAE;QACvB,OAAO,EAAE,IAAA,kBAAU,GAAE;QACrB,KAAK,EAAE,IAAA,gBAAQ,GAAE;QACjB,SAAS,EAAE,GAAG;QACd,SAAS,EAAE,GAAG;QACd,SAAS,EAAE,SAAS;QACpB,WAAW,EAAE,SAAS;QACtB,MAAM,EAAE,SAAS;QACjB,QAAQ,EAAE,CAAC;KACZ,CAAC;IACF,IAAA,gBAAQ,EAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAE9B,qDAAqD;IACrD,MAAM,IAAI,GAAG,IAAA,sBAAc,EAAC,WAAW,CAAC,CAAC;IACzC,IAAI,SAAS,GAAkB,IAAI,CAAC;IACpC,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;QACnF,MAAM,UAAU,GAAG,QAAQ;aACxB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;aAC5E,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC3C,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;YACrD,SAAS,GAAG,IAAA,oBAAY,GAAE,CAAC;YAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,SAAS,QAAQ,CAAC,CAAC;YAC3D,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YAC9B,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;QAC3E,CAAC;IACH,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,EAAE,CAAC;AACtF,CAAC,CAAC;AA9CW,QAAA,QAAQ,YA8CnB"}

package/dist/core/interactive-host.d.ts

@@ -0,0 +1,28 @@
+import type { ForgeEvent, PermissionDecision, PermissionRequest, Plan } from '../types';
+import type { PermissionFlags } from '../permissions/manager';
+/**
+ * InteractiveHost lets the core loop surface decisions to whatever interface
+ * is driving it. The CLI binds a terminal-prompt host; the UI server binds
+ * one that routes through WebSocket. Each running task gets its own host
+ * scope via AsyncLocalStorage so concurrent tasks from different surfaces
+ * don't collide.
+ *
+ * A null host means "use the default CLI prompt" — keeps existing scripts
+ * and direct `forge run` invocations unchanged.
+ */
+export interface InteractiveHost {
+    /** Returns 'approve' (run the plan), 'cancel' (stop the task), 'edit' (open an editor — only CLI implements this). */
+    confirmPlan(plan: Plan, taskId: string): Promise<'approve' | 'cancel' | 'edit'>;
+    /** Decide whether a tool action is permitted. Honor flags (allow-files, strict, non-interactive, etc.). */
+    requestPermission(req: PermissionRequest, flags: PermissionFlags): Promise<PermissionDecision>;
+    /** Free-form question to the operator. Return empty string when the user skips. */
+    askUser(taskId: string, question: string, choices?: string[], defaultValue?: string): Promise<string>;
+    /** Side-channel event emission (streamed to whatever surface subscribed). */
+    emit?(taskId: string, event: ForgeEvent): void;
+    /** Unique label used by logs/metrics. */
+    readonly name: string;
+}
+export declare const withHost: <T>(host: InteractiveHost, fn: () => Promise<T>) => Promise<T>;
+export declare const setDefaultHost: (host: InteractiveHost | null) => void;
+export declare const currentHost: () => InteractiveHost | null;
+//# sourceMappingURL=interactive-host.d.ts.map

package/dist/core/interactive-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive-host.d.ts","sourceRoot":"","sources":["../../src/core/interactive-host.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AACxF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D;;;;;;;;;GASG;AACH,MAAM,WAAW,eAAe;IAC9B,sHAAsH;IACtH,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC,CAAC;IAEhF,2GAA2G;IAC3G,iBAAiB,CAAC,GAAG,EAAE,iBAAiB,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAE/F,mFAAmF;IACnF,OAAO,CACL,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,EAAE,EAClB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC,CAAC;IAEnB,6EAA6E;IAC7E,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IAE/C,yCAAyC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAKD,eAAO,MAAM,QAAQ,GAAU,CAAC,EAAE,MAAM,eAAe,EAAE,IAAI,MAAM,OAAO,CAAC,CAAC,CAAC,KAAG,OAAO,CAAC,CAAC,CAExF,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,MAAM,eAAe,GAAG,IAAI,KAAG,IAE7D,CAAC;AAEF,eAAO,MAAM,WAAW,QAAO,eAAe,GAAG,IAEhD,CAAC"}

package/dist/core/interactive-host.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.currentHost = exports.setDefaultHost = exports.withHost = void 0;
+const async_hooks_1 = require("async_hooks");
+const storage = new async_hooks_1.AsyncLocalStorage();
+let fallback = null;
+const withHost = async (host, fn) => {
+    return storage.run(host, fn);
+};
+exports.withHost = withHost;
+const setDefaultHost = (host) => {
+    fallback = host;
+};
+exports.setDefaultHost = setDefaultHost;
+const currentHost = () => {
+    return storage.getStore() ?? fallback;
+};
+exports.currentHost = currentHost;
+//# sourceMappingURL=interactive-host.js.map

package/dist/core/interactive-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive-host.js","sourceRoot":"","sources":["../../src/core/interactive-host.ts"],"names":[],"mappings":";;;AAAA,6CAAgD;AAoChD,MAAM,OAAO,GAAG,IAAI,+BAAiB,EAAmB,CAAC;AACzD,IAAI,QAAQ,GAA2B,IAAI,CAAC;AAErC,MAAM,QAAQ,GAAG,KAAK,EAAK,IAAqB,EAAE,EAAoB,EAAc,EAAE;IAC3F,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AAC/B,CAAC,CAAC;AAFW,QAAA,QAAQ,YAEnB;AAEK,MAAM,cAAc,GAAG,CAAC,IAA4B,EAAQ,EAAE;IACnE,QAAQ,GAAG,IAAI,CAAC;AAClB,CAAC,CAAC;AAFW,QAAA,cAAc,kBAEzB;AAEK,MAAM,WAAW,GAAG,GAA2B,EAAE;IACtD,OAAO,OAAO,CAAC,QAAQ,EAAE,IAAI,QAAQ,CAAC;AACxC,CAAC,CAAC;AAFW,QAAA,WAAW,eAEtB"}

package/dist/core/loop-detection.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Detects pathological retry patterns (edit → fail → edit → fail …) so the
+ * orchestrator can break out early instead of burning retries. The signal
+ * is simple: if the last N step outcomes are all `false` for the same step
+ * id with a similar error class, call it a loop.
+ */
+export interface StepOutcome {
+    stepId: string;
+    success: boolean;
+    errorClass?: string;
+    timestamp: number;
+}
+export declare class LoopDetector {
+    private windowSize;
+    private repetitionThreshold;
+    private history;
+    constructor(windowSize?: number, repetitionThreshold?: number);
+    record(outcome: StepOutcome): void;
+    isLooping(): {
+        looping: boolean;
+        reason: string | null;
+    };
+    reset(): void;
+}
+//# sourceMappingURL=loop-detection.d.ts.map

package/dist/core/loop-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-detection.d.ts","sourceRoot":"","sources":["../../src/core/loop-detection.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,YAAY;IAGrB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,mBAAmB;IAH7B,OAAO,CAAC,OAAO,CAAqB;gBAE1B,UAAU,SAAI,EACd,mBAAmB,SAAI;IAGjC,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAKlC,SAAS,IAAI;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE;IAgBxD,KAAK,IAAI,IAAI;CAGd"}

package/dist/core/loop-detection.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoopDetector = void 0;
+class LoopDetector {
+    windowSize;
+    repetitionThreshold;
+    history = [];
+    constructor(windowSize = 6, repetitionThreshold = 3) {
+        this.windowSize = windowSize;
+        this.repetitionThreshold = repetitionThreshold;
+    }
+    record(outcome) {
+        this.history.push(outcome);
+        if (this.history.length > this.windowSize)
+            this.history.shift();
+    }
+    isLooping() {
+        if (this.history.length < this.repetitionThreshold)
+            return { looping: false, reason: null };
+        const tail = this.history.slice(-this.repetitionThreshold);
+        const sameStep = tail.every((e) => e.stepId === tail[0].stepId);
+        const sameClass = tail.every((e) => e.errorClass === tail[0].errorClass) && Boolean(tail[0].errorClass);
+        const allFailing = tail.every((e) => !e.success);
+        if (allFailing && sameStep && sameClass) {
+            return {
+                looping: true,
+                reason: `step ${tail[0].stepId} failed ${tail.length} times with ${tail[0].errorClass}`,
+            };
+        }
+        return { looping: false, reason: null };
+    }
+    reset() {
+        this.history.length = 0;
+    }
+}
+exports.LoopDetector = LoopDetector;
+//# sourceMappingURL=loop-detection.js.map

package/dist/core/loop-detection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-detection.js","sourceRoot":"","sources":["../../src/core/loop-detection.ts"],"names":[],"mappings":";;;AAaA,MAAa,YAAY;IAGb;IACA;IAHF,OAAO,GAAkB,EAAE,CAAC;IACpC,YACU,aAAa,CAAC,EACd,sBAAsB,CAAC;QADvB,eAAU,GAAV,UAAU,CAAI;QACd,wBAAmB,GAAnB,mBAAmB,CAAI;IAC9B,CAAC;IAEJ,MAAM,CAAC,OAAoB;QACzB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3B,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,UAAU;YAAE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IAClE,CAAC;IAED,SAAS;QACP,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,mBAAmB;YAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QAC5F,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAC3D,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAChE,MAAM,SAAS,GACb,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;QACxF,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACjD,IAAI,UAAU,IAAI,QAAQ,IAAI,SAAS,EAAE,CAAC;YACxC,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,WAAW,IAAI,CAAC,MAAM,eAAe,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE;aACxF,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAC1C,CAAC;IAED,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IAC1B,CAAC;CACF;AA/BD,oCA+BC"}

package/dist/core/loop.d.ts

@@ -0,0 +1,15 @@
+import { Task, TaskResult, Mode } from '../types';
+import { PermissionFlags } from '../permissions/manager';
+export interface LoopOptions {
+    projectRoot: string;
+    mode: Mode;
+    flags: PermissionFlags;
+    autoApprove?: boolean;
+    planOnly?: boolean;
+}
+export interface LoopResult {
+    task: Task;
+    result: TaskResult;
+}
+export declare const runAgenticLoop: (task: Task, options: LoopOptions) => Promise<LoopResult>;
+//# sourceMappingURL=loop.d.ts.map

package/dist/core/loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../../src/core/loop.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAQ,MAAM,UAAU,CAAC;AAcxD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AASzD,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,eAAe,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAsDD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,eAAO,MAAM,cAAc,GAAU,MAAM,IAAI,EAAE,SAAS,WAAW,KAAG,OAAO,CAAC,UAAU,CA2VzF,CAAC"}