shreni 0.1.0

package/dist/sthapathi/dispatch.js

@@ -0,0 +1,326 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildAgentContext = buildAgentContext;
+exports.runSilpiSafe = runSilpiSafe;
+exports.runViharapalaSafe = runViharapalaSafe;
+exports.runSilpiViharapalaLoop = runSilpiViharapalaLoop;
+exports.runHealthRepairLoop = runHealthRepairLoop;
+const promises_1 = require("fs/promises");
+const path_1 = require("path");
+const os_1 = require("os");
+const beads_js_1 = require("./beads.js");
+const silpi_js_1 = require("../agents/silpi.js");
+const viharapala_js_1 = require("../agents/viharapala.js");
+const retry_js_1 = require("./retry.js");
+const errors_js_1 = require("./errors.js");
+const activity_log_js_1 = require("./activity-log.js");
+const branch_js_1 = require("./branch.js");
+const merge_js_1 = require("./merge.js");
+const health_js_1 = require("./health.js");
+const lint_js_1 = require("./lint.js");
+const state_js_1 = require("../kshetra/state.js");
+const errors_js_2 = require("./errors.js");
+const guard_js_1 = require("./guard.js");
+// Bail out of a round loop the instant a self-heal abort is requested, so the
+// worker's RECOVER isn't racing a fresh round starting between agent calls
+//. Throwing AgentAbortedError unwinds cleanly through
+// runTaskSafely, which swallows it (no cycle-error handling).
+function throwIfAborted(signal) {
+    if (signal?.aborted)
+        throw new errors_js_2.AgentAbortedError();
+}
+async function readFileOptional(filePath) {
+    try {
+        return await (0, promises_1.readFile)(filePath, 'utf8');
+    }
+    catch {
+        return '';
+    }
+}
+async function loadUniversalSkills() {
+    return readFileOptional((0, path_1.join)((0, os_1.homedir)(), '.shreni', 'skills', 'SKILLS.md'));
+}
+async function buildAgentContext(kshetra, task) {
+    const bdClient = (0, beads_js_1.bd)(kshetra);
+    // Injection flip (the agent-execution design §3.1): the provider CLI now loads the
+    // repo's own config natively (instruction file, `.claude/` skills/rules/
+    // subagents, per-dir CLAUDE.md, the @-imported conventions docs), so Shreni no
+    // longer reads-and-injects any of that — doing so would double-load. Shreni
+    // injects only what has no repo-native home: bd's workflow context, the task
+    // details + acceptance criteria, the cross-project universalSkills, and the
+    // reviewer-only reviewGuide (§3.3 — no provider has a reviewer-only native
+    // file, so this one stays Shreni-injected).
+    const reviewGuidePath = kshetra.conventions?.reviewGuide
+        ? (0, path_1.join)(kshetra.repo.path, kshetra.conventions.reviewGuide)
+        : null;
+    const [projectMemory, taskDetails, universalSkills, reviewGuide] = await Promise.all([
+        bdClient.prime(),
+        bdClient.show(task.id),
+        loadUniversalSkills(),
+        reviewGuidePath ? readFileOptional(reviewGuidePath) : Promise.resolve(''),
+    ]);
+    return {
+        kshetra,
+        task,
+        projectMemory,
+        taskDetails,
+        universalSkills,
+        reviewGuide,
+        // NOT YET IMPLEMENTED: RAG codebase-search retrieval is not wired up, so no
+        // relevant-code chunks are injected. Silpi guards on truthiness
+        // (silpi.ts: `if (context.ragChunks)`), so an empty string simply omits the
+        // "== RELEVANT CODE ==" section. Populate this once retrieval lands.
+        ragChunks: '',
+    };
+}
+async function runSilpiSafe(kshetra, task, context, round, branch, feedback) {
+    const bdClient = (0, beads_js_1.bd)(kshetra);
+    await bdClient.addNote(task.id, `Round ${round}: dispatching Silpi`);
+    try {
+        const output = await (0, retry_js_1.withRetry)(`Silpi r${round}`, () => (0, silpi_js_1.runSilpi)(context, round, feedback, branch));
+        await bdClient.addNote(task.id, `Round ${round}: Silpi submitted`);
+        return output;
+    }
+    catch (err) {
+        if (err instanceof errors_js_1.ParseError) {
+            await bdClient.addNote(task.id, `Round ${round}: Silpi output malformed — ${err.message}`);
+            throw new errors_js_1.AgentError('MALFORMED_OUTPUT', { task, round, cause: err });
+        }
+        await bdClient.addNote(task.id, `Round ${round}: Silpi failed after retries — ${err.message}`);
+        throw new errors_js_1.AgentError('API_FAILURE', { task, round, cause: err });
+    }
+}
+async function runViharapalaSafe(kshetra, task, context, silpiOut, round, branch) {
+    const bdClient = (0, beads_js_1.bd)(kshetra);
+    await bdClient.addNote(task.id, `Round ${round}: dispatching Viharapala`);
+    try {
+        const output = await (0, retry_js_1.withRetry)(`Viharapala r${round}`, () => (0, viharapala_js_1.runViharapala)(context, silpiOut, round, context.taskDetails, branch));
+        await bdClient.addNote(task.id, `Round ${round}: ${output.verdict}`);
+        return output;
+    }
+    catch (err) {
+        if (err instanceof errors_js_1.ParseError) {
+            await bdClient.addNote(task.id, `Round ${round}: Viharapala output malformed — ${err.message}`);
+            throw new errors_js_1.AgentError('MALFORMED_OUTPUT', { task, round, cause: err });
+        }
+        await bdClient.addNote(task.id, `Round ${round}: Viharapala failed after retries — ${err.message}`);
+        throw new errors_js_1.AgentError('API_FAILURE', { task, round, cause: err });
+    }
+}
+// Verify the agent stayed on the bead branch and left main untouched. On a
+// violation, salvage any stray commits, restore main, flag the bead, and return
+// an abort result for the caller to return immediately. Returns null when clean.
+async function guardAfterAgent(kshetra, task, guard, round) {
+    try {
+        await (0, guard_js_1.assertOnBranch)(kshetra, guard);
+        return null;
+    }
+    catch (err) {
+        if (!(err instanceof guard_js_1.OffBranchError))
+            throw err;
+        const salvage = await (0, guard_js_1.recoverOffBranch)(kshetra, task, guard);
+        const salvageNote = salvage ? ` Stray commits preserved on "${salvage}".` : '';
+        (0, activity_log_js_1.emit)({ type: 'task_done', kshetra: kshetra.id, beadId: task.id, title: task.title, approved: false, rounds: round });
+        await (0, beads_js_1.bd)(kshetra).flag(task.id, `Aborted round ${round}: agent left the bead branch — ${err.message}. ` +
+            `main restored to origin.${salvageNote} Investigate manually.`);
+        return { approved: false, note: `Aborted: off-branch (${err.detail.actualHead})` };
+    }
+}
+async function runSilpiViharapalaLoop(kshetra, task, _branchParam, signal) {
+    if ((0, health_js_1.isHealthBead)(task)) {
+        return runHealthRepairLoop(kshetra, task, signal);
+    }
+    const bdClient = (0, beads_js_1.bd)(kshetra);
+    let round = 0;
+    let feedback = null;
+    let lastSilpiOut = null;
+    // Why the most recent round failed — so the terminal "blocked" message can
+    // tell "your own tests/lint failed" apart from "the reviewer rejected you".
+    let lastRejectSource = null;
+    (0, activity_log_js_1.emit)({ type: 'task_claimed', kshetra: kshetra.id, beadId: task.id, title: task.title });
+    // Claiming a bead is forward progress — stamp liveness and clear the stall track so
+    // a fresh cycle never re-trips the watchdog on a stale repeat count (the design §3.2).
+    (0, state_js_1.recordProgress)(kshetra);
+    // Create the bead branch; workers operate on this branch for the whole lifecycle.
+    const branch = await (0, branch_js_1.createTaskBranch)(task, kshetra);
+    // Snapshot the sanctioned starting point (on-branch, main at origin) so each
+    // round can prove the agent didn't commit to main or wander off-branch.
+    const guard = await (0, guard_js_1.captureGuard)(kshetra, branch);
+    while (round < kshetra.agents.maxRoundsPerBead) {
+        round++;
+        throwIfAborted(signal);
+        (0, activity_log_js_1.emit)({ type: 'round_start', kshetra: kshetra.id, beadId: task.id, round, agent: 'silpi' });
+        const context = await buildAgentContext(kshetra, task);
+        const silpiOut = await (0, silpi_js_1.runSilpi)(context, round, feedback, branch, signal);
+        lastSilpiOut = silpiOut;
+        const offBranch = await guardAfterAgent(kshetra, task, guard, round);
+        if (offBranch)
+            return offBranch;
+        // Baseline-aware test gate: treat the suite as passing when the current
+        // failCount is within the accepted baseline of known/quarantined failures.
+        // This mirrors the health-repair loop and the pickup gate, so pre-existing
+        // unrelated failures (or ones quarantined into the baseline) don't auto-
+        // reject an otherwise clean diff. A task that ADDS failures (failCount >
+        // baseline) makes health.green false and still rejects, so real regressions
+        // are not let through. silpiOut.testsPassed is kept for logging only.
+        const health = await (0, health_js_1.measureHealth)(kshetra);
+        // Enforced lint gate: run stack.lintCommand ourselves rather than trusting
+        // Silpi's self-reported lintPassed (the toolchain design §3.3). When no lint gate
+        // is configured, runLintGate skips-and-logs and reports passed=true.
+        const lint = await (0, lint_js_1.runLintGate)(kshetra);
+        (0, activity_log_js_1.emit)({
+            type: 'silpi_done',
+            kshetra: kshetra.id,
+            beadId: task.id,
+            round,
+            summary: silpiOut.summary,
+            confidence: silpiOut.confidenceScore,
+            files: silpiOut.filesChanged.map(f => f.path),
+            lintPassed: lint.passed,
+            testsPassed: health.green,
+        });
+        for (const insight of silpiOut.insights) {
+            await bdClient.remember(insight);
+        }
+        if (!health.green || !lint.passed) {
+            await bdClient.addNote(task.id, `Round ${round}: lint/tests failed`);
+            lastRejectSource = 'tests';
+            feedback = {
+                verdict: 'REJECT',
+                mustFix: ['Tests or lint failed — fix before resubmitting'],
+                overallScore: 0,
+                suggestions: [],
+                issues: [],
+                insights: [],
+            };
+            continue;
+        }
+        await bdClient.addNote(task.id, `Round ${round}: submitted for review`);
+        throwIfAborted(signal);
+        (0, activity_log_js_1.emit)({ type: 'round_start', kshetra: kshetra.id, beadId: task.id, round, agent: 'viharapala' });
+        feedback = await (0, viharapala_js_1.runViharapala)(context, silpiOut, round, context.taskDetails, branch, signal);
+        (0, activity_log_js_1.emit)({
+            type: 'viharapala_done',
+            kshetra: kshetra.id,
+            beadId: task.id,
+            round,
+            verdict: feedback.verdict,
+            score: feedback.overallScore,
+            mustFix: feedback.mustFix,
+        });
+        for (const insight of feedback.insights) {
+            await bdClient.remember(insight);
+        }
+        await bdClient.addNote(task.id, `Round ${round}: ${feedback.verdict}`);
+        if (feedback.verdict === 'APPROVE') {
+            (0, activity_log_js_1.emit)({ type: 'task_done', kshetra: kshetra.id, beadId: task.id, title: task.title, approved: true, rounds: round });
+            (0, state_js_1.recordProgress)(kshetra); // a completed bead is forward progress (the design §3.2)
+            // mergePolicy (3r2): 'pr' opens a PR and defers (bead stays open, closed on
+            // merge by reconcilePullRequests); 'push' squash-merges to main + closes now.
+            if ((0, merge_js_1.resolveMergePolicy)(kshetra) === 'pr') {
+                await (0, merge_js_1.openPrAndDefer)(task, kshetra, silpiOut);
+                return { approved: true, note: `Approved round ${round} — PR opened, awaiting merge` };
+            }
+            // Squash-merge the bead branch into main, close the task, fire Parikshaka
+            await (0, merge_js_1.squashMergeAndClose)(task, kshetra, silpiOut);
+            return { approved: true, note: `Approved round ${round}` };
+        }
+        lastRejectSource = 'reviewer';
+    }
+    (0, activity_log_js_1.emit)({ type: 'task_done', kshetra: kshetra.id, beadId: task.id, title: task.title, approved: false, rounds: round });
+    const cause = lastRejectSource === 'tests'
+        ? "task's own tests/lint kept failing"
+        : 'Viharapala kept rejecting';
+    await bdClient.flag(task.id, `Blocked after ${round} rounds — ${cause}.`);
+    return { approved: false, note: `Blocked after ${round} rounds (${lastRejectSource ?? 'unknown'})` };
+}
+// Repair loop for [shreni-health] beads. Exempt from the green precondition
+// (it is the thing that restores green); gated on "failures must strictly
+// decrease" instead. On reaching zero it merges and resets the baseline. If it
+// stalls, it quarantines the remaining failures (bumps the accepted baseline so
+// feature work isn't wedged forever) and flags for a human.
+async function runHealthRepairLoop(kshetra, task, signal) {
+    const bdClient = (0, beads_js_1.bd)(kshetra);
+    let round = 0;
+    let feedback = null;
+    let lastSilpiOut = null;
+    (0, activity_log_js_1.emit)({ type: 'task_claimed', kshetra: kshetra.id, beadId: task.id, title: task.title });
+    (0, state_js_1.recordProgress)(kshetra); // forward progress: a repair bead claimed (the design §3.2)
+    const branch = await (0, branch_js_1.createTaskBranch)(task, kshetra);
+    const guard = await (0, guard_js_1.captureGuard)(kshetra, branch);
+    // Failures on the branch before any repair work — the bar each round must beat.
+    let prevFailCount = (await (0, health_js_1.measureHealth)(kshetra)).failCount;
+    await bdClient.addNote(task.id, `Repair start: ${prevFailCount} failing`);
+    while (round < kshetra.agents.maxRoundsPerBead) {
+        round++;
+        throwIfAborted(signal);
+        (0, activity_log_js_1.emit)({ type: 'round_start', kshetra: kshetra.id, beadId: task.id, round, agent: 'silpi' });
+        const context = await buildAgentContext(kshetra, task);
+        const silpiOut = await (0, silpi_js_1.runSilpi)(context, round, feedback, branch, signal);
+        lastSilpiOut = silpiOut;
+        for (const insight of silpiOut.insights) {
+            await bdClient.remember(insight);
+        }
+        const offBranch = await guardAfterAgent(kshetra, task, guard, round);
+        if (offBranch)
+            return offBranch;
+        const health = await (0, health_js_1.measureHealth)(kshetra);
+        (0, activity_log_js_1.emit)({
+            type: 'silpi_done',
+            kshetra: kshetra.id,
+            beadId: task.id,
+            round,
+            summary: silpiOut.summary,
+            confidence: silpiOut.confidenceScore,
+            files: silpiOut.filesChanged.map(f => f.path),
+            lintPassed: silpiOut.lintPassed,
+            testsPassed: health.green,
+        });
+        if (health.green) {
+            await bdClient.addNote(task.id, `Round ${round}: suite green — merging`);
+            (0, activity_log_js_1.emit)({ type: 'task_done', kshetra: kshetra.id, beadId: task.id, title: task.title, approved: true, rounds: round });
+            (0, state_js_1.recordProgress)(kshetra); // suite restored to green is forward progress (the design §3.2)
+            // Health-repair beads ALWAYS merge to main directly, regardless of
+            // mergePolicy: they are the mechanism that restores a green base so feature
+            // work can proceed, so deferring one behind a human PR gate would wedge the
+            // whole queue. Only feature work honours the 'pr' policy.
+            await (0, merge_js_1.squashMergeAndClose)(task, kshetra, silpiOut);
+            (0, state_js_1.setHealthBaseline)(kshetra, 0);
+            return { approved: true, note: `Suite restored to green round ${round}` };
+        }
+        if (health.failCount >= 0 && health.failCount < prevFailCount) {
+            await bdClient.addNote(task.id, `Round ${round}: progress ${prevFailCount} -> ${health.failCount} failing`);
+            prevFailCount = health.failCount;
+            feedback = repairFeedback(health.failCount, true);
+        }
+        else {
+            await bdClient.addNote(task.id, `Round ${round}: no progress (${health.failCount} failing)`);
+            feedback = repairFeedback(health.failCount, false);
+        }
+    }
+    // Stalled: quarantine the remaining failures so the rest of the queue can move,
+    // and escalate. Without this, an unfixable suite would wedge the whole Kshetra.
+    void lastSilpiOut;
+    (0, state_js_1.setHealthBaseline)(kshetra, prevFailCount);
+    (0, activity_log_js_1.emit)({ type: 'task_done', kshetra: kshetra.id, beadId: task.id, title: task.title, approved: false, rounds: round });
+    await bdClient.flag(task.id, `[needs-human] Could not restore green after ${round} rounds — ` +
+        `${prevFailCount} failing test(s) quarantined as the accepted baseline. ` +
+        `Investigate manually; feature work resumes against this baseline.`);
+    return { approved: false, note: `Quarantined ${prevFailCount} failing after ${round} rounds` };
+}
+function repairFeedback(failCount, progress) {
+    const label = failCount >= 0 ? `${failCount}` : 'some';
+    return {
+        verdict: 'REJECT',
+        mustFix: [
+            progress
+                ? `${label} test(s) still failing — keep fixing, do not touch unrelated code.`
+                : `Still ${label} failing and no progress this round — try a different approach; fix the tests, don't delete them.`,
+        ],
+        overallScore: 0,
+        suggestions: [],
+        issues: [],
+        insights: [],
+    };
+}
+//# sourceMappingURL=dispatch.js.map

package/dist/sthapathi/dispatch.js.map

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

package/dist/sthapathi/errors.d.ts

@@ -0,0 +1,27 @@
+import type { KshetraConfig } from '../kshetra/config.js';
+import type { Task } from './types.js';
+export declare class ParseError extends Error {
+    readonly cause?: unknown | undefined;
+    constructor(message: string, cause?: unknown | undefined);
+}
+export declare class AgentAbortedError extends Error {
+    constructor(message?: string);
+}
+export type AgentErrorKind = 'MALFORMED_OUTPUT' | 'API_FAILURE';
+export declare class AgentError extends Error {
+    readonly kind: AgentErrorKind;
+    readonly context: {
+        task: Task;
+        round: number;
+        cause?: unknown;
+    };
+    constructor(kind: AgentErrorKind, context: {
+        task: Task;
+        round: number;
+        cause?: unknown;
+    });
+}
+export declare function cleanupBranch(kshetra: KshetraConfig, task: Task): Promise<void>;
+export declare function notifyOperator(kshetra: KshetraConfig, task: Task | null, event: string, reason?: string, remediation?: string): Promise<void>;
+export declare function handleCycleError(kshetra: KshetraConfig, task: Task | null, err: Error): Promise<void>;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/sthapathi/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAOvC,qBAAa,UAAW,SAAQ,KAAK;aACU,KAAK,CAAC,EAAE,OAAO;gBAAhD,OAAO,EAAE,MAAM,EAAkB,KAAK,CAAC,EAAE,OAAO,YAAA;CAI7D;AAQD,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,SAAoC;CAIxD;AAED,MAAM,MAAM,cAAc,GAAG,kBAAkB,GAAG,aAAa,CAAC;AAEhE,qBAAa,UAAW,SAAQ,KAAK;aAEjB,IAAI,EAAE,cAAc;aACpB,OAAO,EAAE;QAAE,IAAI,EAAE,IAAI,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;gBADvD,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE;QAAE,IAAI,EAAE,IAAI,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAK1E;AA2BD,wBAAsB,aAAa,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAYrF;AAMD,wBAAsB,cAAc,CAClC,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE,IAAI,GAAG,IAAI,EACjB,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE,IAAI,GAAG,IAAI,EACjB,GAAG,EAAE,KAAK,GACT,OAAO,CAAC,IAAI,CAAC,CAwEf"}

package/dist/sthapathi/errors.js

@@ -0,0 +1,174 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentError = exports.AgentAbortedError = exports.ParseError = void 0;
+exports.cleanupBranch = cleanupBranch;
+exports.notifyOperator = notifyOperator;
+exports.handleCycleError = handleCycleError;
+const beads_js_1 = require("./beads.js");
+const state_js_1 = require("../kshetra/state.js");
+const git_js_1 = require("./git.js");
+const branch_js_1 = require("./branch.js");
+const notifications_js_1 = require("./notifications.js");
+class ParseError extends Error {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = 'ParseError';
+    }
+}
+exports.ParseError = ParseError;
+// Thrown when an in-flight agent run is deliberately aborted for self-heal
+//: `shreni resume` on a hung (reason:'stuck') worker cancels
+// the wedged provider subprocess so the worker can RECOVER in-process. This is a
+// SANCTIONED cancellation, not a failure — handleCycleError/classifyError must
+// never see it (it would flag the bead and clean the branch out from under the
+// recovery path), so runTaskSafely intercepts it and returns quietly.
+class AgentAbortedError extends Error {
+    constructor(message = 'agent run aborted for self-heal') {
+        super(message);
+        this.name = 'AgentAbortedError';
+    }
+}
+exports.AgentAbortedError = AgentAbortedError;
+class AgentError extends Error {
+    kind;
+    context;
+    constructor(kind, context) {
+        super(`${kind}: ${context.cause?.message ?? String(context.cause)}`);
+        this.kind = kind;
+        this.context = context;
+        this.name = 'AgentError';
+    }
+}
+exports.AgentError = AgentError;
+function classifyError(err) {
+    if (err instanceof beads_js_1.BeadsError)
+        return 'BD_FAILED';
+    if (err instanceof git_js_1.GitError)
+        return 'GIT_FAILED';
+    if (err instanceof AgentError) {
+        return err.kind === 'MALFORMED_OUTPUT' ? 'MALFORMED_OUTPUT' : 'AGENT_FAILED';
+    }
+    const e = err;
+    const apiDownStatuses = [429, 502, 503, 529];
+    if (e.status !== undefined && apiDownStatuses.includes(e.status))
+        return 'API_DOWN';
+    const msg = e.message ?? e.code ?? '';
+    if (msg.includes('ECONNRESET') || msg.includes('ETIMEDOUT') || msg.includes('ENOTFOUND')) {
+        return 'API_DOWN';
+    }
+    return 'UNKNOWN';
+}
+// The bead branch is created at the start of every cycle but only deleted on
+// the success path (squashMergeAndClose). On a terminal failure we abandon the
+// branch here so it can't linger and silently wedge the next pickup() — a
+// leftover branch makes preFlightCheck throw on every poll. Best-effort: a
+// cleanup failure must never mask the original cycle error. NOT called for
+// GIT_FAILED / merge conflicts, where the branch is deliberately kept for
+// human inspection.
+async function cleanupBranch(kshetra, task) {
+    const g = (0, git_js_1.git)(kshetra);
+    const branch = (0, branch_js_1.branchName)(task);
+    try {
+        if (!(await g.branchExists(branch)))
+            return;
+        // Must be off the branch to delete it; force-delete since the abandoned
+        // branch may hold partial commits we are discarding.
+        await g.checkout(kshetra.repo.mainBranch);
+        await g.deleteBranch(branch, { force: true });
+    }
+    catch (err) {
+        console.warn(`[shreni:${kshetra.id}] failed to clean up branch ${branch}: ${err.message}`);
+    }
+}
+// Notify a human of an end-state / stuck-state that needs intervention. Appends
+// a durable record to the per-Kshetra notifications feed (polled by Phalaka) and
+// logs it. The message names the cause and, when provided, lists remediation
+// steps. Never throws — notification must not crash the worker.
+async function notifyOperator(kshetra, task, event, reason, remediation) {
+    const lines = [`[${kshetra.name}] ${event.replace(/_/g, ' ').toUpperCase()}`];
+    if (task)
+        lines.push(`Bead: ${task.id} — ${task.title}`);
+    if (reason)
+        lines.push(`Cause: ${reason}`);
+    if (remediation)
+        lines.push(`Try:\n${remediation}`);
+    const message = lines.join('\n');
+    (0, notifications_js_1.appendNotification)(kshetra.id, {
+        ts: new Date().toISOString(),
+        event,
+        beadId: task?.id,
+        reason,
+        remediation,
+        message,
+    });
+    console.error(`[shreni notify:${kshetra.id}] ${message}`);
+}
+async function handleCycleError(kshetra, task, err) {
+    const bdClient = (0, beads_js_1.bd)(kshetra);
+    // Track repeating cycle errors so the watchdog can trip on a stall loop
+    // (e.g. the same git/agent failure recurring across polls).
+    const errorClass = classifyError(err);
+    (0, state_js_1.recordStall)(kshetra, `cycle:${errorClass}`);
+    switch (errorClass) {
+        case 'API_DOWN':
+            if (task) {
+                await bdClient.addNote(task.id, `Paused: API unavailable — ${err.message}. Will retry.`);
+                // The retry re-picks the task and creates a fresh branch, so drop the
+                // current one — otherwise preFlightCheck would reject the retry.
+                await cleanupBranch(kshetra, task);
+            }
+            (0, state_js_1.pauseKshetra)(kshetra, {
+                reason: 'api_down',
+                message: err.message,
+                cooldownMs: 5 * 60 * 1000,
+            });
+            await notifyOperator(kshetra, task, 'api_down');
+            break;
+        case 'AGENT_FAILED':
+            if (task) {
+                await bdClient.flag(task.id, `Agent failed: ${err.message}`);
+                await (0, beads_js_1.syncBeads)(kshetra);
+                await cleanupBranch(kshetra, task);
+            }
+            await notifyOperator(kshetra, task, 'agent_failed');
+            break;
+        case 'MALFORMED_OUTPUT':
+            if (task) {
+                await bdClient.flag(task.id, `Malformed output after retries: ${err.message}`);
+                await (0, beads_js_1.syncBeads)(kshetra);
+                await cleanupBranch(kshetra, task);
+            }
+            await notifyOperator(kshetra, task, 'agent_failed');
+            break;
+        case 'GIT_FAILED':
+            if (task) {
+                await bdClient.flag(task.id, `Git failure: ${err.message}. Branch kept.`);
+                await (0, beads_js_1.syncBeads)(kshetra);
+            }
+            (0, state_js_1.pauseKshetra)(kshetra, {
+                reason: 'git_failed',
+                message: err.message,
+                manual: true,
+            });
+            await notifyOperator(kshetra, task, 'git_failed');
+            break;
+        case 'BD_FAILED':
+            (0, state_js_1.pauseKshetra)(kshetra, {
+                reason: 'bd_failed',
+                message: err.message,
+                manual: true,
+            });
+            await notifyOperator(kshetra, null, 'bd_failed');
+            break;
+        default:
+            if (task) {
+                await bdClient.flag(task.id, `Unexpected error: ${err.message}`);
+                await (0, beads_js_1.syncBeads)(kshetra);
+                await cleanupBranch(kshetra, task);
+            }
+            await notifyOperator(kshetra, task, 'unknown_error');
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/sthapathi/errors.js.map

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

package/dist/sthapathi/gh.d.ts

@@ -0,0 +1,19 @@
+export declare class GhError extends Error {
+    readonly code: string;
+    readonly cause?: unknown | undefined;
+    constructor(code: string, message: string, cause?: unknown | undefined);
+}
+export interface PrState {
+    state: 'OPEN' | 'MERGED' | 'CLOSED';
+    url: string;
+}
+export declare function gh(repoPath: string): {
+    prCreate(opts: {
+        base: string;
+        head: string;
+        title: string;
+        body: string;
+    }): Promise<string>;
+    prView(head: string): Promise<PrState | null>;
+};
+//# sourceMappingURL=gh.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gh.d.ts","sourceRoot":"","sources":["../../src/sthapathi/gh.ts"],"names":[],"mappings":"AAKA,qBAAa,OAAQ,SAAQ,KAAK;aAEd,IAAI,EAAE,MAAM;aAEZ,KAAK,CAAC,EAAE,OAAO;gBAFf,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM,EACC,KAAK,CAAC,EAAE,OAAO,YAAA;CAKlC;AAED,MAAM,WAAW,OAAO;IAEtB,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACpC,GAAG,EAAE,MAAM,CAAC;CACb;AAeD,wBAAgB,EAAE,CAAC,QAAQ,EAAE,MAAM;mBAKV;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;iBAoB/E,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;EAWtD"}