shreni 0.1.0

package/dist/sthapathi/pickup.d.ts

@@ -0,0 +1,13 @@
+import type { KshetraConfig } from '../kshetra/config.js';
+import type { Task } from './types.js';
+export declare class PreFlightError extends Error {
+    readonly task: Task;
+    constructor(task: Task, message: string);
+}
+export declare function toSlug(title: string): string;
+export declare function parseReadyOutput(raw: string): Task[];
+export declare function pickNext(tasks: Task[]): Task | null;
+export declare function preFlightCheck(task: Task, kshetra: KshetraConfig): Promise<void>;
+export declare function selectNext(kshetra: KshetraConfig): Promise<Task | null>;
+export declare function prepareTask(task: Task, kshetra: KshetraConfig): Promise<Task | null>;
+//# sourceMappingURL=pickup.d.ts.map

package/dist/sthapathi/pickup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pickup.d.ts","sourceRoot":"","sources":["../../src/sthapathi/pickup.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAMvC,qBAAa,cAAe,SAAQ,KAAK;aAErB,IAAI,EAAE,IAAI;gBAAV,IAAI,EAAE,IAAI,EAC1B,OAAO,EAAE,MAAM;CAKlB;AAcD,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM5C;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,EAAE,CAwBpD;AAGD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,GAAG,IAAI,CAInD;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBtF;AAOD,wBAAsB,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAG7E;AAMD,wBAAsB,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAyC1F"}

package/dist/sthapathi/pickup.js

@@ -0,0 +1,144 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PreFlightError = void 0;
+exports.toSlug = toSlug;
+exports.parseReadyOutput = parseReadyOutput;
+exports.pickNext = pickNext;
+exports.preFlightCheck = preFlightCheck;
+exports.selectNext = selectNext;
+exports.prepareTask = prepareTask;
+const zod_1 = require("zod");
+const beads_js_1 = require("./beads.js");
+const git_js_1 = require("./git.js");
+const health_js_1 = require("./health.js");
+const state_js_1 = require("../kshetra/state.js");
+class PreFlightError extends Error {
+    task;
+    constructor(task, message) {
+        super(message);
+        this.task = task;
+        this.name = 'PreFlightError';
+    }
+}
+exports.PreFlightError = PreFlightError;
+const BeadsIssueSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    title: zod_1.z.string(),
+    priority: zod_1.z.number().int().min(0).max(4),
+    status: zod_1.z.string(),
+    description: zod_1.z.string().optional(),
+    notes: zod_1.z.string().optional(),
+});
+// Deterministic slug from a bead title — the same function that names bead
+// branches at creation, exported so reconcilePullRequests can reconstruct a
+// bead's branch name from its title (bd list --json carries no slug field).
+function toSlug(title) {
+    return title
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 50);
+}
+function parseReadyOutput(raw) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return [];
+    }
+    if (!Array.isArray(parsed))
+        return [];
+    const tasks = [];
+    for (const item of parsed) {
+        const result = BeadsIssueSchema.safeParse(item);
+        if (!result.success)
+            continue;
+        const r = result.data;
+        tasks.push({
+            id: r.id,
+            slug: toSlug(r.title),
+            title: r.title,
+            description: r.description,
+            status: 'pending',
+            priority: r.priority,
+            notes: r.notes,
+        });
+    }
+    return tasks;
+}
+// Stable sort: P0 first, then preserve arrival order (FIFO) within same priority
+function pickNext(tasks) {
+    if (tasks.length === 0)
+        return null;
+    const sorted = tasks.slice().sort((a, b) => a.priority - b.priority);
+    return sorted[0] ?? null;
+}
+async function preFlightCheck(task, kshetra) {
+    const g = (0, git_js_1.git)(kshetra);
+    const main = kshetra.repo.mainBranch;
+    await g.checkout(main);
+    const status = await g.status();
+    const dirty = [...status.modified, ...status.staged];
+    if (dirty.length > 0) {
+        throw new PreFlightError(task, `dirty working tree: ${dirty.join(', ')}`);
+    }
+    await g.pull('--rebase', 'origin', main);
+    const branch = `bead-${task.id}/${task.slug}`;
+    if (await g.branchExists(branch)) {
+        throw new PreFlightError(task, `branch already exists: ${branch}`);
+    }
+}
+// SELECT (read-only). Picks the highest-priority ready bead. Performs NO git ops
+// and NO claim, so it is safe to call on every poll — the scheduler only commits
+// to mutating the work tree once it advances a selected task into PREPARE. This
+// separation is what stops a poll from checking out main under an in-flight agent
+// (see the Sthapathi workflow design §4.2).
+async function selectNext(kshetra) {
+    const raw = await (0, beads_js_1.bd)(kshetra).ready();
+    return pickNext(parseReadyOutput(raw));
+}
+// PREPARE (the ONLY mutator in the pickup path) + bd claim. Syncs beads, runs
+// preFlightCheck (checkout main, pull, branch guard) and the health gate, then
+// claims. Returns the task when it is ready to work, or null when preflight
+// rejects or the base suite is red — both logged, so a wedge is never silent.
+async function prepareTask(task, kshetra) {
+    await (0, beads_js_1.syncBeads)(kshetra);
+    try {
+        await preFlightCheck(task, kshetra);
+    }
+    catch (err) {
+        if (err instanceof PreFlightError) {
+            // Surface the rejection — otherwise a leftover branch or persistently
+            // dirty tree wedges the worker silently, returning null on every poll
+            // with no clue why nothing is progressing. Record the stall so the
+            // watchdog trips if the same rejection repeats.
+            (0, state_js_1.recordStall)(kshetra, `preflight: ${err.message}`);
+            console.warn(`[shreni prepare:${kshetra.id}] preflight rejected ${task.id}: ${err.message}`);
+            return null;
+        }
+        throw err;
+    }
+    // Health gate: a fresh feature task only starts when the base suite is green
+    // (modulo the accepted baseline). preFlightCheck has put us on a clean, pulled
+    // main, so this measures the right tree. A red base does not start the task —
+    // it queues a P0 repair bead instead, which is exempt from this gate. This
+    // runs at the prepare boundary only, never mid-loop, so it can't interfere with
+    // an in-flight Silpi↔Viharapala round.
+    if (!(0, health_js_1.isHealthBead)(task)) {
+        const health = await (0, health_js_1.checkHealth)(kshetra);
+        if (!health.green) {
+            const created = await (0, health_js_1.ensureHealthBead)(kshetra, health.failCount);
+            (0, state_js_1.recordStall)(kshetra, 'base suite red');
+            console.warn(`[shreni prepare:${kshetra.id}] base suite red ` +
+                `(${health.failCount} failing > baseline ${health.baseline}); ` +
+                `deferring ${task.id}, ${created ? 'queued' : 'awaiting'} health repair`);
+            return null;
+        }
+    }
+    await (0, beads_js_1.bd)(kshetra).claim(task.id);
+    // Forward progress: a bead was successfully claimed — clear any stall counter.
+    (0, state_js_1.recordProgress)(kshetra);
+    return task;
+}
+//# sourceMappingURL=pickup.js.map

package/dist/sthapathi/pickup.js.map

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

package/dist/sthapathi/recover.d.ts

@@ -0,0 +1,16 @@
+import type { KshetraConfig } from '../kshetra/config.js';
+import type { Task } from './types.js';
+export type ResumeRunner = (kshetra: KshetraConfig, task: Task, branch: string) => Promise<{
+    approved: boolean;
+    note: string;
+}>;
+export declare const MAX_RECOVER_ATTEMPTS = 3;
+export declare function parseInFlightTasks(raw: string): Task[];
+export declare function recoverKshetra(kshetra: KshetraConfig, opts?: {
+    keepBranch?: string;
+}): Promise<Task[]>;
+export declare function scheduleResume(kshetra: KshetraConfig, task: Task, run?: ResumeRunner): Promise<{
+    approved: boolean;
+    note: string;
+}>;
+//# sourceMappingURL=recover.d.ts.map

package/dist/sthapathi/recover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recover.d.ts","sourceRoot":"","sources":["../../src/sthapathi/recover.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAQvC,MAAM,MAAM,YAAY,GAAG,CACzB,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM,KACX,OAAO,CAAC;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAKlD,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAEtC,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,EAAE,CAsBtD;AASD,wBAAsB,cAAc,CAClC,OAAO,EAAE,aAAa,EACtB,IAAI,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GACjC,OAAO,CAAC,IAAI,EAAE,CAAC,CAsDjB;AAgBD,wBAAsB,cAAc,CAClC,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE,IAAI,EACV,GAAG,CAAC,EAAE,YAAY,GACjB,OAAO,CAAC;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAS9C"}

package/dist/sthapathi/recover.js

@@ -0,0 +1,149 @@
+"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.MAX_RECOVER_ATTEMPTS = void 0;
+exports.parseInFlightTasks = parseInFlightTasks;
+exports.recoverKshetra = recoverKshetra;
+exports.scheduleResume = scheduleResume;
+const beads_js_1 = require("./beads.js");
+const git_js_1 = require("./git.js");
+const branch_js_1 = require("./branch.js");
+const state_js_1 = require("../kshetra/state.js");
+// A bead is reopened after a crash/restart at most this many times before it is
+// left blocked for a human. Prevents the reopen→fail→reopen loop. Default per
+// the Sthapathi workflow design §4.5 (D1); made configurable later (bjo).
+exports.MAX_RECOVER_ATTEMPTS = 3;
+function parseInFlightTasks(raw) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return [];
+    }
+    if (!Array.isArray(parsed))
+        return [];
+    const tasks = [];
+    for (const item of parsed) {
+        if (typeof item.id !== 'string' || typeof item.title !== 'string')
+            continue;
+        tasks.push({
+            id: item.id,
+            slug: String(item.slug ?? item.id),
+            title: item.title,
+            status: 'in_progress',
+            priority: typeof item.priority === 'number' ? item.priority : 2,
+            round: typeof item.round === 'number' ? item.round : 1,
+            notes: typeof item.notes === 'string' ? item.notes : undefined,
+        });
+    }
+    return tasks;
+}
+// RECOVER — reconcile the four drifting truths (work tree, git branches, bead
+// status, scheduler phase) back to a clean IDLE after a crash, restart, or a
+// PREPARE that detected drift. We do NOT try to resume a half-done bead from the
+// exact stage it died at (fragile); instead we discard the interrupted work and
+// reopen the bead for a fresh cycle, under an attempt budget. This codifies the
+// manual recovery captured in `bd remember [shreni-worker-recovery]`.
+// See the Sthapathi workflow design §4.3.
+async function recoverKshetra(kshetra, opts = {}) {
+    const g = (0, git_js_1.git)(kshetra);
+    const main = kshetra.repo.mainBranch;
+    // 1. Reset the work tree to a clean main — discard any interrupted, uncommitted
+    //    work so the next PREPARE starts from a sanctioned point.
+    await g.resetHard();
+    await g.checkout(main);
+    await g.clean();
+    // 2. Drop stale bead-* branches. Nothing is active at startup; when invoked
+    //    mid-run from PREPARE, opts.keepBranch protects the in-flight bead's branch.
+    //    A leftover branch makes preFlightCheck reject its bead forever
+    //    ("branch already exists").
+    for (const branch of await g.branches('bead-')) {
+        if (branch === opts.keepBranch)
+            continue;
+        await g.deleteBranch(branch, { force: true });
+    }
+    // 3. Reopen beads stranded in_progress by the interruption — under the attempt
+    //    budget. Past MAX_RECOVER_ATTEMPTS, leave the bead blocked and escalate to
+    //    a human rather than loop on it.
+    const maxAttempts = kshetra.watchdog?.maxRecoverAttempts ?? exports.MAX_RECOVER_ATTEMPTS;
+    // Exclude awaiting-merge beads (mergePolicy 'pr', 3r2): they are intentionally
+    // left in_progress with their branch/PR open, NOT stranded by a crash. Reopening
+    // and re-working one would discard an already-approved change that is just
+    // waiting on a human merge. reconcilePullRequests closes them when the PR lands.
+    const inFlight = parseInFlightTasks(await (0, beads_js_1.bd)(kshetra).list({ status: 'in_progress', excludeLabel: 'awaiting-merge' }));
+    const resumable = [];
+    for (const task of inFlight) {
+        const attempts = (0, state_js_1.recordBeadAttempt)(kshetra, task.id);
+        if (attempts > maxAttempts) {
+            await (0, beads_js_1.bd)(kshetra).flag(task.id, `Recover: exceeded ${maxAttempts} restart attempts — left blocked for human review.`);
+        }
+        else {
+            await (0, beads_js_1.bd)(kshetra).reopen(task.id);
+            await (0, beads_js_1.bd)(kshetra).addNote(task.id, `Recovered after restart (attempt ${attempts}/${maxAttempts}) — reopened for a fresh cycle.`);
+            resumable.push(task);
+        }
+    }
+    await (0, beads_js_1.syncBeads)(kshetra);
+    // Hand the reopened beads back to the caller (the worker) so it can RESUME
+    // them via the work loop — bypassing the pickup health gate — instead of
+    // waiting for the next gated poll to re-select them. See scheduleResume.
+    return resumable;
+}
+// RESUME — re-enter the WORK phase for a bead that was already in flight, without
+// going back through SELECT / PREPARE. Used for a bead reopened by RECOVER after a
+// crash/restart (and, in future, the mid-loop merge-conflict re-dispatch).
+//
+// Resume deliberately does NOT run the pickup health gate (checkHealth). That gate
+// is a pickup-only precondition that admits *new* feature work only onto a green
+// base; it runs at the prepare boundary, never mid-loop. A bead that is already in
+// flight was admitted when it was first picked up, so re-gating it on resume would
+// (a) re-run the whole suite inside the work loop — exactly the mid-loop suite run
+// the phase machine forbids (the jhl regression), and (b) let a base that went red
+// *after* admission strand an otherwise-in-progress bead. runSilpiViharapalaLoop
+// routes [shreni-health] beads to the repair loop internally, so this single
+// entrypoint resumes both feature and repair work. See the Sthapathi workflow
+// design §4.2: WIP resumes via the recovery path, bypassing the gate.
+async function scheduleResume(kshetra, task, run) {
+    // Re-claim the reopened bead (RECOVER set it back to open). This is the only
+    // pickup-side step resume performs — no preFlightCheck, no checkHealth.
+    await (0, beads_js_1.bd)(kshetra).claim(task.id);
+    (0, state_js_1.recordProgress)(kshetra);
+    // Lazy-load the loop so recover.ts's static import graph (and its unit tests)
+    // never pull in the agent modules; production callers inject the runner.
+    const runTask = run ?? (await Promise.resolve().then(() => __importStar(require('./dispatch.js')))).runSilpiViharapalaLoop;
+    return runTask(kshetra, task, (0, branch_js_1.branchName)(task));
+}
+//# sourceMappingURL=recover.js.map

package/dist/sthapathi/recover.js.map

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

package/dist/sthapathi/retry.d.ts

@@ -0,0 +1,11 @@
+export declare const AGENT_RETRY_CONFIG: {
+    maxAttempts: number;
+    initialDelayMs: number;
+    backoffMultiplier: number;
+    maxDelayMs: number;
+    retryableStatuses: number[];
+    retryableErrors: string[];
+};
+export type RetryConfig = typeof AGENT_RETRY_CONFIG;
+export declare function withRetry<T>(label: string, fn: () => Promise<T>, config?: RetryConfig): Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/sthapathi/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/sthapathi/retry.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB;;;;;;;CAO9B,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,OAAO,kBAAkB,CAAC;AAapD,wBAAsB,SAAS,CAAC,CAAC,EAC/B,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,MAAM,GAAE,WAAgC,GACvC,OAAO,CAAC,CAAC,CAAC,CAoBZ"}

package/dist/sthapathi/retry.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AGENT_RETRY_CONFIG = void 0;
+exports.withRetry = withRetry;
+exports.AGENT_RETRY_CONFIG = {
+    maxAttempts: 3,
+    initialDelayMs: 5_000,
+    backoffMultiplier: 2,
+    maxDelayMs: 60_000,
+    retryableStatuses: [429, 502, 503, 529],
+    retryableErrors: ['ECONNRESET', 'ETIMEDOUT', 'ENOTFOUND'],
+};
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+function isRetryable(err, config) {
+    const e = err;
+    if (e.status !== undefined && config.retryableStatuses.includes(e.status))
+        return true;
+    const msg = e.message ?? e.code ?? '';
+    return config.retryableErrors.some(code => msg.includes(code));
+}
+async function withRetry(label, fn, config = exports.AGENT_RETRY_CONFIG) {
+    let attempt = 0;
+    let delay = config.initialDelayMs;
+    while (attempt < config.maxAttempts) {
+        attempt++;
+        try {
+            return await fn();
+        }
+        catch (err) {
+            if (!isRetryable(err, config) || attempt >= config.maxAttempts)
+                throw err;
+            console.warn(`[retry] ${label} attempt ${attempt} failed (${err.message}). Retry in ${delay}ms`);
+            await sleep(delay);
+            delay = Math.min(delay * config.backoffMultiplier, config.maxDelayMs);
+        }
+    }
+    // Unreachable — the while loop always throws before exhausting, but TS needs this
+    throw new Error(`${label} exhausted ${config.maxAttempts} attempts`);
+}
+//# sourceMappingURL=retry.js.map

package/dist/sthapathi/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/sthapathi/retry.ts"],"names":[],"mappings":";;;AAsBA,8BAwBC;AA9CY,QAAA,kBAAkB,GAAG;IAChC,WAAW,EAAE,CAAC;IACd,cAAc,EAAE,KAAK;IACrB,iBAAiB,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM;IAClB,iBAAiB,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;IACvC,eAAe,EAAE,CAAC,YAAY,EAAE,WAAW,EAAE,WAAW,CAAC;CAC1D,CAAC;AAIF,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,SAAS,WAAW,CAAC,GAAY,EAAE,MAAmB;IACpD,MAAM,CAAC,GAAG,GAA2D,CAAC;IACtE,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IACvF,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;IACtC,OAAO,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;AACjE,CAAC;AAEM,KAAK,UAAU,SAAS,CAC7B,KAAa,EACb,EAAoB,EACpB,SAAsB,0BAAkB;IAExC,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC;IAElC,OAAO,OAAO,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;QACpC,OAAO,EAAE,CAAC;QACV,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,OAAO,IAAI,MAAM,CAAC,WAAW;gBAAE,MAAM,GAAG,CAAC;YAE1E,OAAO,CAAC,IAAI,CACV,WAAW,KAAK,YAAY,OAAO,YAAa,GAAa,CAAC,OAAO,eAAe,KAAK,IAAI,CAC9F,CAAC;YACF,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC;YACnB,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IACD,kFAAkF;IAClF,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,cAAc,MAAM,CAAC,WAAW,WAAW,CAAC,CAAC;AACvE,CAAC"}

package/dist/sthapathi/self-heal.d.ts

@@ -0,0 +1,19 @@
+import type { KshetraConfig } from '../kshetra/config.js';
+import type { Task } from './types.js';
+export interface ActiveRun {
+    controller: AbortController;
+    task: Task;
+    done: Promise<void>;
+}
+export interface PauseSnapshot {
+    paused?: boolean;
+    reason?: string;
+}
+export declare function shouldSelfHeal(prev: PauseSnapshot | undefined, curr: PauseSnapshot | undefined, hasActiveRun: boolean, healing: boolean): boolean;
+export interface SelfHealDeps {
+    recover?: (kshetra: KshetraConfig) => Promise<Task[]>;
+    recordProgress?: (kshetra: KshetraConfig) => void;
+    touchHeartbeat?: (kshetraId: string) => void;
+}
+export declare function selfHeal(kshetra: KshetraConfig, run: ActiveRun, deps?: SelfHealDeps): Promise<void>;
+//# sourceMappingURL=self-heal.d.ts.map

package/dist/sthapathi/self-heal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-heal.d.ts","sourceRoot":"","sources":["../../src/sthapathi/self-heal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AASvC,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,eAAe,CAAC;IAC5B,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;CACrB;AAGD,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAUD,wBAAgB,cAAc,CAC5B,IAAI,EAAE,aAAa,GAAG,SAAS,EAC/B,IAAI,EAAE,aAAa,GAAG,SAAS,EAC/B,YAAY,EAAE,OAAO,EACrB,OAAO,EAAE,OAAO,GACf,OAAO,CAET;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACtD,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,CAAC;IAClD,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9C;AAkBD,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,aAAa,EACtB,GAAG,EAAE,SAAS,EACd,IAAI,GAAE,YAAiB,GACtB,OAAO,CAAC,IAAI,CAAC,CAYf"}

package/dist/sthapathi/self-heal.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shouldSelfHeal = shouldSelfHeal;
+exports.selfHeal = selfHeal;
+const state_js_1 = require("../kshetra/state.js");
+const activity_log_js_1 = require("./activity-log.js");
+const recover_js_1 = require("./recover.js");
+function isStuckPaused(s) {
+    return !!(s?.paused && s.reason === 'stuck');
+}
+// Edge detector: fire self-heal only on a stuck-paused -> resumed TRANSITION,
+// and only when there is an in-flight run to cancel and we are not already
+// healing. Entering the stuck state (prev not stuck, curr stuck) must NOT fire;
+// a resume with no active run is a plain state clear with nothing to recover.
+function shouldSelfHeal(prev, curr, hasActiveRun, healing) {
+    return isStuckPaused(prev) && !isStuckPaused(curr) && hasActiveRun && !healing;
+}
+// In-process recovery of a hung (reason:'stuck') worker after `shreni resume`
+// cleared its pause. Ordering is load-bearing:
+//   1. refresh liveness FIRST (heartbeat file mtime + clear the stall counters)
+//      so the watchdog can't re-trip mid-heal;
+//   2. abort the hung provider subprocess (SIGKILL via the run's signal);
+//   3. await the run fully unwinding — the scheduler's WORK cycle returns and
+//      resets phase to IDLE, and its single-flight latch clears;
+//   4. RECOVER reconciles the four drifting truths (tree, branches, bead status,
+//      phase) and reopens the bead for a fresh, gated pickup;
+//   5. refresh liveness once more post-recover.
+// recordProgress stamps state.json (clears outcomeRepeatCount so the stall branch
+// can't re-trip); touchHeartbeat bumps the separate heartbeat FILE the watchdog
+// actually reads for liveness — both are needed. The caller MUST hold a `healing`
+// gate around this that makes selectNext return null, so no poll cycle can mutate
+// the work tree (prepareTask / checkout main) while RECOVER is running — the loop
+// is already armed here, unlike startup.
+async function selfHeal(kshetra, run, deps = {}) {
+    const recover = deps.recover ?? recover_js_1.recoverKshetra;
+    const recordProgress = deps.recordProgress ?? state_js_1.recordProgress;
+    const touchHeartbeat = deps.touchHeartbeat ?? activity_log_js_1.touchHeartbeat;
+    recordProgress(kshetra); // 1
+    touchHeartbeat(kshetra.id);
+    run.controller.abort(); // 2
+    await run.done; // 3
+    await recover(kshetra); // 4
+    recordProgress(kshetra); // 5
+    touchHeartbeat(kshetra.id);
+}
+//# sourceMappingURL=self-heal.js.map

package/dist/sthapathi/self-heal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-heal.js","sourceRoot":"","sources":["../../src/sthapathi/self-heal.ts"],"names":[],"mappings":";;AA8BA,wCAOC;AAwBD,4BAgBC;AA3ED,kDAA8E;AAC9E,uDAA4E;AAC5E,6CAAgE;AAkBhE,SAAS,aAAa,CAAC,CAA4B;IACjD,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC;AAC/C,CAAC;AAED,8EAA8E;AAC9E,2EAA2E;AAC3E,gFAAgF;AAChF,8EAA8E;AAC9E,SAAgB,cAAc,CAC5B,IAA+B,EAC/B,IAA+B,EAC/B,YAAqB,EACrB,OAAgB;IAEhB,OAAO,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,YAAY,IAAI,CAAC,OAAO,CAAC;AACjF,CAAC;AAQD,8EAA8E;AAC9E,+CAA+C;AAC/C,gFAAgF;AAChF,+CAA+C;AAC/C,0EAA0E;AAC1E,8EAA8E;AAC9E,iEAAiE;AACjE,iFAAiF;AACjF,8DAA8D;AAC9D,gDAAgD;AAChD,kFAAkF;AAClF,gFAAgF;AAChF,kFAAkF;AAClF,kFAAkF;AAClF,kFAAkF;AAClF,yCAAyC;AAClC,KAAK,UAAU,QAAQ,CAC5B,OAAsB,EACtB,GAAc,EACd,OAAqB,EAAE;IAEvB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,2BAAc,CAAC;IAC/C,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,IAAI,yBAAqB,CAAC;IACpE,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,IAAI,gCAAqB,CAAC;IAEpE,cAAc,CAAC,OAAO,CAAC,CAAC,CAAQ,IAAI;IACpC,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC3B,GAAG,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,CAAS,IAAI;IACpC,MAAM,GAAG,CAAC,IAAI,CAAC,CAAiB,IAAI;IACpC,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC,CAAS,IAAI;IACpC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAQ,IAAI;IACpC,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AAC7B,CAAC"}

package/dist/sthapathi/types.d.ts

@@ -0,0 +1,56 @@
+import type { KshetraConfig } from '../kshetra/config.js';
+export interface AgentContext {
+    kshetra: KshetraConfig;
+    task: Task;
+    projectMemory: string;
+    taskDetails: string;
+    universalSkills: string;
+    reviewGuide: string;
+    ragChunks: string;
+}
+export interface Task {
+    id: string;
+    slug: string;
+    title: string;
+    description?: string;
+    status: 'pending' | 'in_progress' | 'blocked' | 'closed';
+    priority: number;
+    round?: number;
+    notes?: string;
+    context?: {
+        relatedFiles?: string[];
+    };
+}
+export interface SilpiOutput {
+    filesChanged: {
+        path: string;
+        diff: string;
+    }[];
+    testFiles: string[];
+    summary: string;
+    confidenceScore: number;
+    questionsForReviewer: string[];
+    lintPassed: boolean;
+    testsPassed: boolean;
+    insights: string[];
+}
+export interface ViharapalaOutput {
+    verdict: 'APPROVE' | 'REJECT';
+    overallScore: number;
+    mustFix: string[];
+    suggestions: string[];
+    issues: {
+        severity: 'blocker' | 'major' | 'minor';
+        file?: string;
+        description: string;
+    }[];
+    insights: string[];
+}
+export interface ParikshakaOutput {
+    coverageGaps: {
+        feature: string;
+        description: string;
+        priority: number;
+    }[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/sthapathi/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/sthapathi/types.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,aAAa,CAAC;IACvB,IAAI,EAAE,IAAI,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IAMpB,eAAe,EAAE,MAAM,CAAC;IAKxB,WAAW,EAAE,MAAM,CAAC;IAIpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,SAAS,GAAG,QAAQ,CAAC;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE;QACR,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;KACzB,CAAC;CACH;AAED,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/C,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,EAAE;QACN,QAAQ,EAAE,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;QACxC,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;KACrB,EAAE,CAAC;IACJ,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC5E"}

package/dist/sthapathi/types.js

@@ -0,0 +1,4 @@
+"use strict";
+// Shared types used across sthapathi modules
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/sthapathi/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/sthapathi/types.ts"],"names":[],"mappings":";AAAA,6CAA6C"}

package/dist/sthapathi/watchdog.d.ts

@@ -0,0 +1,27 @@
+import type { KshetraConfig } from '../kshetra/config.js';
+import type { Phase } from './index.js';
+export declare const STUCK_THRESHOLD_MS: number;
+export declare const MAX_OUTCOME_REPEAT = 5;
+export interface StuckInput {
+    phase: Phase;
+    manuallyPaused: boolean;
+    heartbeatAgeMs: number | null;
+    outcomeRepeatCount: number;
+    lastOutcome?: string;
+    idleNoWork?: boolean;
+    thresholds?: {
+        stuckMs?: number;
+        maxRepeat?: number;
+    };
+}
+export interface StuckVerdict {
+    stuck: boolean;
+    reason?: string;
+    remediation?: string;
+}
+export declare function remediationFor(outcome: string | undefined): string;
+export declare function evaluateStuck(input: StuckInput): StuckVerdict;
+export declare function runWatchdogOnce(kshetra: KshetraConfig, getPhase: () => Phase, now?: number, opts?: {
+    hasReadyWork?: () => boolean | Promise<boolean>;
+}): Promise<StuckVerdict>;
+//# sourceMappingURL=watchdog.d.ts.map

package/dist/sthapathi/watchdog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watchdog.d.ts","sourceRoot":"","sources":["../../src/sthapathi/watchdog.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAOxC,eAAO,MAAM,kBAAkB,QAAiB,CAAC;AACjD,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,KAAK,CAAC;IACb,cAAc,EAAE,OAAO,CAAC;IAIxB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IAIrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACvD;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAID,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAyClE;AAMD,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,YAAY,CA+B7D;AAsBD,wBAAsB,eAAe,CACnC,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,MAAM,KAAK,EACrB,GAAG,GAAE,MAAmB,EACxB,IAAI,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CAAE,GACzD,OAAO,CAAC,YAAY,CAAC,CAkCvB"}