shreni 0.1.0

package/dist/sthapathi/gh.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GhError = void 0;
+exports.gh = gh;
+const child_process_1 = require("child_process");
+const util_1 = require("util");
+const execFileAsync = (0, util_1.promisify)(child_process_1.execFile);
+class GhError extends Error {
+    code;
+    cause;
+    constructor(code, message, cause) {
+        super(message);
+        this.code = code;
+        this.cause = cause;
+        this.name = 'GhError';
+    }
+}
+exports.GhError = GhError;
+async function run(args, cwd) {
+    try {
+        const { stdout } = await execFileAsync('gh', args, { cwd, maxBuffer: 4 * 1024 * 1024 });
+        return stdout.trim();
+    }
+    catch (err) {
+        const e = err;
+        throw new GhError('GH_ERROR', `gh ${args[0]} ${args[1] ?? ''} failed: ${e.stderr ?? e.message ?? String(err)}`, err);
+    }
+}
+// Thin wrapper over the `gh` CLI, scoped to one repo working dir. Used only by
+// the PR merge-policy path (3r2); `gh` is already a Shreni prerequisite and is
+// used at init-kshetra time to create the beads repo.
+function gh(repoPath) {
+    return {
+        // Open a PR bead-branch → base. Idempotent: if a PR already exists for the
+        // head branch, return its URL instead of failing (a re-dispatched or
+        // recovered bead must not error on a PR that is already open).
+        async prCreate(opts) {
+            try {
+                const url = await run(['pr', 'create', '--base', opts.base, '--head', opts.head, '--title', opts.title, '--body', opts.body], repoPath);
+                // gh prints the PR URL as the last line of stdout.
+                return url.split('\n').filter(Boolean).pop() ?? url;
+            }
+            catch (err) {
+                const msg = err.message ?? '';
+                if (/already exists|a pull request for branch/i.test(msg)) {
+                    const existing = await this.prView(opts.head);
+                    if (existing)
+                        return existing.url;
+                }
+                throw err;
+            }
+        },
+        // View the PR for a head branch. Returns null when there is no PR (or gh is
+        // unavailable/unauthenticated) — callers treat null as "nothing to reconcile".
+        async prView(head) {
+            try {
+                const raw = await run(['pr', 'view', head, '--json', 'state,url'], repoPath);
+                const parsed = JSON.parse(raw);
+                if (!parsed.state || !parsed.url)
+                    return null;
+                return { state: parsed.state, url: parsed.url };
+            }
+            catch {
+                return null;
+            }
+        },
+    };
+}
+//# sourceMappingURL=gh.js.map

package/dist/sthapathi/gh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gh.js","sourceRoot":"","sources":["../../src/sthapathi/gh.ts"],"names":[],"mappings":";;;AAmCA,gBAoCC;AAvED,iDAAyC;AACzC,+BAAiC;AAEjC,MAAM,aAAa,GAAG,IAAA,gBAAS,EAAC,wBAAQ,CAAC,CAAC;AAE1C,MAAa,OAAQ,SAAQ,KAAK;IAEd;IAEA;IAHlB,YACkB,IAAY,EAC5B,OAAe,EACC,KAAe;QAE/B,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,SAAI,GAAJ,IAAI,CAAQ;QAEZ,UAAK,GAAL,KAAK,CAAU;QAG/B,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;IACxB,CAAC;CACF;AATD,0BASC;AAQD,KAAK,UAAU,GAAG,CAAC,IAAc,EAAE,GAAW;IAC5C,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC,CAAC;QACxF,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,CAAC,GAAG,GAA4C,CAAC;QACvD,MAAM,IAAI,OAAO,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IACvH,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,+EAA+E;AAC/E,sDAAsD;AACtD,SAAgB,EAAE,CAAC,QAAgB;IACjC,OAAO;QACL,2EAA2E;QAC3E,qEAAqE;QACrE,+DAA+D;QAC/D,KAAK,CAAC,QAAQ,CAAC,IAAiE;YAC9E,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,GAAG,CACnB,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,EACtG,QAAQ,CACT,CAAC;gBACF,mDAAmD;gBACnD,OAAO,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,IAAI,GAAG,CAAC;YACtD,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,GAAG,GAAI,GAAe,CAAC,OAAO,IAAI,EAAE,CAAC;gBAC3C,IAAI,2CAA2C,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC1D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBAC9C,IAAI,QAAQ;wBAAE,OAAO,QAAQ,CAAC,GAAG,CAAC;gBACpC,CAAC;gBACD,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;QAED,4EAA4E;QAC5E,+EAA+E;QAC/E,KAAK,CAAC,MAAM,CAAC,IAAY;YACvB,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,CAAC,EAAE,QAAQ,CAAC,CAAC;gBAC7E,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAqC,CAAC;gBACnE,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,GAAG;oBAAE,OAAO,IAAI,CAAC;gBAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAyB,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC;YACtE,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/sthapathi/git.d.ts

@@ -0,0 +1,41 @@
+import type { Task } from './types.js';
+import type { KshetraConfig } from '../kshetra/config.js';
+export declare class GitError extends Error {
+    readonly code: string;
+    readonly cause?: unknown | undefined;
+    constructor(code: string, message: string, cause?: unknown | undefined);
+}
+export declare function git(kshetraOrPath: KshetraConfig | string): {
+    checkout(ref: string): Promise<void>;
+    pull(...args: string[]): Promise<void>;
+    push(...args: string[]): Promise<void>;
+    fetch(...args: string[]): Promise<void>;
+    add(...args: string[]): Promise<void>;
+    commit(message: string, ...args: string[]): Promise<void>;
+    merge(...args: string[]): Promise<void>;
+    rebase(...args: string[]): Promise<void>;
+    createBranch(task: Task): Promise<string>;
+    headSha(ref?: string): Promise<string>;
+    currentBranch(): Promise<string>;
+    forceBranch(name: string, ref: string): Promise<void>;
+    branchExists(branch: string): Promise<boolean>;
+    resetHard(ref?: string): Promise<void>;
+    clean(): Promise<void>;
+    branches(prefix?: string): Promise<string[]>;
+    status(): Promise<{
+        modified: string[];
+        staged: string[];
+        untracked: string[];
+    }>;
+    revsBetween(from: string, to: string): Promise<string[]>;
+    mergeTree(branch: string, target: string): Promise<string[]>;
+    isAncestor(ancestor: string, descendant: string): Promise<boolean>;
+    diffMerged(branch: string): Promise<string>;
+    branchDiff(branchPrefix: string): Promise<string>;
+    commitFile(filePath: string, message: string): Promise<void>;
+    deleteBranch(branch: string, opts?: {
+        remote?: boolean;
+        force?: boolean;
+    }): Promise<void>;
+};
+//# sourceMappingURL=git.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/sthapathi/git.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAI1D,qBAAa,QAAS,SAAQ,KAAK;aAEf,IAAI,EAAE,MAAM;aAEZ,KAAK,CAAC,EAAE,OAAO;gBAFf,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM,EACC,KAAK,CAAC,EAAE,OAAO,YAAA;CAKlC;AAoBD,wBAAgB,GAAG,CAAC,aAAa,EAAE,aAAa,GAAG,MAAM;kBAKjC,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;kBAItB,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;kBAIxB,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;mBAIvB,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;iBAI1B,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;oBAIrB,MAAM,WAAW,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;mBAY1C,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;oBAIvB,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;uBAIrB,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC;2BAMlB,OAAO,CAAC,MAAM,CAAC;qBAMrB,OAAO,CAAC,MAAM,CAAC;sBAOd,MAAM,OAAO,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;yBAIhC,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;6BAUrB,OAAO,CAAC,IAAI,CAAC;aAO7B,OAAO,CAAC,IAAI,CAAC;sBAKJ,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;cAMlC,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;sBAsB9D,MAAM,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;sBAMtC,MAAM,UAAU,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;yBA+BvC,MAAM,cAAc,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;uBAS/C,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;6BAQlB,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;yBAQ5B,MAAM,WAAW,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;yBAMxD,MAAM,SACR;QAAE,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAC1C,OAAO,CAAC,IAAI,CAAC;EAUnB"}

package/dist/sthapathi/git.js

@@ -0,0 +1,199 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GitError = void 0;
+exports.git = git;
+const child_process_1 = require("child_process");
+const util_1 = require("util");
+const execFileAsync = (0, util_1.promisify)(child_process_1.execFile);
+class GitError extends Error {
+    code;
+    cause;
+    constructor(code, message, cause) {
+        super(message);
+        this.code = code;
+        this.cause = cause;
+        this.name = 'GitError';
+    }
+}
+exports.GitError = GitError;
+async function run(args, cwd) {
+    try {
+        const result = await execFileAsync('git', args, { cwd, maxBuffer: 10 * 1024 * 1024 });
+        // trimEnd only — leading whitespace in stdout is meaningful for git --porcelain format
+        return { stdout: result.stdout.trimEnd(), stderr: result.stderr.trim() };
+    }
+    catch (err) {
+        const e = err;
+        throw new GitError('GIT_ERROR', `git ${args[0]} failed: ${e.stderr ?? e.message ?? String(err)}`, err);
+    }
+}
+function git(kshetraOrPath) {
+    const repoPath = typeof kshetraOrPath === 'string' ? kshetraOrPath : kshetraOrPath.repo.path;
+    return {
+        async checkout(ref) {
+            await run(['checkout', ref], repoPath);
+        },
+        async pull(...args) {
+            await run(['pull', ...args], repoPath);
+        },
+        async push(...args) {
+            await run(['push', ...args], repoPath);
+        },
+        async fetch(...args) {
+            await run(['fetch', ...args], repoPath);
+        },
+        async add(...args) {
+            await run(['add', ...args], repoPath);
+        },
+        async commit(message, ...args) {
+            try {
+                await run(['commit', '-m', message, ...args], repoPath);
+            }
+            catch (err) {
+                // git exits 1 when nothing to commit; message appears in stdout, not stderr
+                const cause = err.cause;
+                const combined = `${err.message} ${cause?.stdout ?? ''}`;
+                if (combined.includes('nothing to commit') || combined.includes('nothing added'))
+                    return;
+                throw err;
+            }
+        },
+        async merge(...args) {
+            await run(['merge', ...args], repoPath);
+        },
+        async rebase(...args) {
+            await run(['rebase', ...args], repoPath);
+        },
+        async createBranch(task) {
+            const branch = `bead-${task.id}/${task.slug}`;
+            await run(['checkout', '-b', branch], repoPath);
+            return branch;
+        },
+        async headSha(ref = 'HEAD') {
+            const { stdout } = await run(['rev-parse', ref], repoPath);
+            return stdout.trim();
+        },
+        // Current branch name, or 'HEAD' when detached.
+        async currentBranch() {
+            const { stdout } = await run(['rev-parse', '--abbrev-ref', 'HEAD'], repoPath);
+            return stdout.trim();
+        },
+        // Move a branch ref to point at <ref> without checking it out. Used to
+        // restore main / salvage stray commits during off-branch recovery.
+        async forceBranch(name, ref) {
+            await run(['branch', '-f', name, ref], repoPath);
+        },
+        async branchExists(branch) {
+            try {
+                await run(['rev-parse', '--verify', branch], repoPath);
+                return true;
+            }
+            catch {
+                return false;
+            }
+        },
+        // Discard tracked changes by moving the working tree to <ref> (default HEAD).
+        async resetHard(ref = 'HEAD') {
+            await run(['reset', '--hard', ref], repoPath);
+        },
+        // Remove untracked files and directories (respects .gitignore — ignored
+        // files like node_modules are left alone). Used by RECOVER to discard
+        // interrupted, uncommitted agent work.
+        async clean() {
+            await run(['clean', '-fd'], repoPath);
+        },
+        // Local branch names, optionally filtered to those starting with <prefix>.
+        async branches(prefix) {
+            const { stdout } = await run(['branch', '--format=%(refname:short)'], repoPath);
+            const all = stdout.split('\n').map(s => s.trim()).filter(Boolean);
+            return prefix ? all.filter(b => b.startsWith(prefix)) : all;
+        },
+        async status() {
+            const { stdout } = await run(['status', '--porcelain'], repoPath);
+            const modified = [];
+            const staged = [];
+            const untracked = [];
+            for (const line of stdout.split('\n').filter(Boolean)) {
+                const index = line[0];
+                const worktree = line[1];
+                const file = line.slice(3);
+                if (index === '?' && worktree === '?') {
+                    untracked.push(file);
+                }
+                else {
+                    if (index !== ' ' && index !== '?')
+                        staged.push(file);
+                    if (worktree !== ' ' && worktree !== '?')
+                        modified.push(file);
+                }
+            }
+            return { modified, staged, untracked };
+        },
+        async revsBetween(from, to) {
+            const { stdout } = await run(['rev-list', `${from}..${to}`], repoPath);
+            return stdout.split('\n').filter(Boolean);
+        },
+        // Dry-run conflict check using merge-tree
+        async mergeTree(branch, target) {
+            try {
+                const { stdout } = await run(['merge-tree', '--write-tree', branch, target], repoPath);
+                // merge-tree exits 0 on clean merge, 1 on conflicts
+                // When conflicts exist they appear in stdout — parse conflicted paths
+                const conflictedFiles = [];
+                for (const line of stdout.split('\n')) {
+                    if (line.startsWith('CONFLICT')) {
+                        const match = line.match(/Merge conflict in (.+)/);
+                        if (match)
+                            conflictedFiles.push(match[1]);
+                    }
+                }
+                return conflictedFiles;
+            }
+            catch (err) {
+                // Exit code 1 with conflict output — parse it
+                const e = err;
+                const output = e.message ?? '';
+                const conflictedFiles = [];
+                for (const line of output.split('\n')) {
+                    if (line.includes('Merge conflict in')) {
+                        const match = line.match(/Merge conflict in (.+)/);
+                        if (match)
+                            conflictedFiles.push(match[1].trim());
+                    }
+                }
+                return conflictedFiles;
+            }
+        },
+        async isAncestor(ancestor, descendant) {
+            try {
+                await run(['merge-base', '--is-ancestor', ancestor, descendant], repoPath);
+                return true;
+            }
+            catch {
+                return false;
+            }
+        },
+        async diffMerged(branch) {
+            const { stdout } = await run(['diff', `main...${branch}`, '--stat'], repoPath);
+            return stdout;
+        },
+        async branchDiff(branchPrefix) {
+            const { stdout } = await run(['diff', `main...${branchPrefix}`, '--unified=3'], repoPath);
+            return stdout;
+        },
+        async commitFile(filePath, message) {
+            await run(['add', filePath], repoPath);
+            await this.commit(message);
+        },
+        async deleteBranch(branch, opts = {}) {
+            // -D (force) is required to remove a branch holding commits that were
+            // never merged — e.g. cleaning up after a failed cycle where the agent
+            // committed partial work we are discarding. -d alone refuses those.
+            await run(['branch', opts.force ? '-D' : '-d', branch], repoPath);
+            if (opts.remote) {
+                await run(['push', 'origin', '--delete', branch], repoPath);
+            }
+        },
+    };
+}
+//# sourceMappingURL=git.js.map

package/dist/sthapathi/git.js.map

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

package/dist/sthapathi/guard.d.ts

@@ -0,0 +1,24 @@
+import type { KshetraConfig } from '../kshetra/config.js';
+import type { Task } from './types.js';
+export declare class OffBranchError extends Error {
+    readonly detail: {
+        branch: string;
+        expectedMain: string;
+        actualHead: string;
+        actualMain: string;
+    };
+    constructor(message: string, detail: {
+        branch: string;
+        expectedMain: string;
+        actualHead: string;
+        actualMain: string;
+    });
+}
+export interface BranchGuard {
+    branch: string;
+    mainSha: string;
+}
+export declare function captureGuard(kshetra: KshetraConfig, branch: string): Promise<BranchGuard>;
+export declare function assertOnBranch(kshetra: KshetraConfig, guard: BranchGuard): Promise<void>;
+export declare function recoverOffBranch(kshetra: KshetraConfig, task: Task, guard: BranchGuard): Promise<string | null>;
+//# sourceMappingURL=guard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"guard.d.ts","sourceRoot":"","sources":["../../src/sthapathi/guard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAMvC,qBAAa,cAAe,SAAQ,KAAK;aAGrB,MAAM,EAAE;QACtB,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;KACpB;gBAND,OAAO,EAAE,MAAM,EACC,MAAM,EAAE;QACtB,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;KACpB;CAKJ;AAKD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAI/F;AAID,wBAAsB,cAAc,CAAC,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB9F;AAMD,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,WAAW,GACjB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAcxB"}

package/dist/sthapathi/guard.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OffBranchError = void 0;
+exports.captureGuard = captureGuard;
+exports.assertOnBranch = assertOnBranch;
+exports.recoverOffBranch = recoverOffBranch;
+const git_js_1 = require("./git.js");
+// Thrown when an agent run leaves the bead branch — HEAD moved off the branch,
+// or main acquired commits outside the sanctioned squash-merge flow. Carries
+// enough detail to flag the bead and (if recovered) point at the salvage ref.
+class OffBranchError extends Error {
+    detail;
+    constructor(message, detail) {
+        super(message);
+        this.detail = detail;
+        this.name = 'OffBranchError';
+    }
+}
+exports.OffBranchError = OffBranchError;
+async function captureGuard(kshetra, branch) {
+    const g = (0, git_js_1.git)(kshetra);
+    const mainSha = await g.headSha(kshetra.repo.mainBranch);
+    return { branch, mainSha };
+}
+// Assert the working state is still on the bead branch and main is unchanged.
+// Throws OffBranchError otherwise — the caller recovers and flags.
+async function assertOnBranch(kshetra, guard) {
+    const g = (0, git_js_1.git)(kshetra);
+    const [head, mainSha] = await Promise.all([
+        g.currentBranch(),
+        g.headSha(kshetra.repo.mainBranch),
+    ]);
+    const offBranch = head !== guard.branch;
+    const mainMoved = mainSha !== guard.mainSha;
+    if (!offBranch && !mainMoved)
+        return;
+    const reason = offBranch
+        ? `HEAD is on "${head}", expected bead branch "${guard.branch}"`
+        : `main moved from ${guard.mainSha.slice(0, 8)} to ${mainSha.slice(0, 8)} outside the squash-merge flow`;
+    throw new OffBranchError(reason, {
+        branch: guard.branch,
+        expectedMain: guard.mainSha,
+        actualHead: head,
+        actualMain: mainSha,
+    });
+}
+// Restore the sanctioned invariant after an off-branch violation WITHOUT losing
+// the agent's commits: stray commits on main are preserved on a salvage branch,
+// then main is reset to where origin left it. Returns the salvage ref name when
+// main had diverged (so it can be named in the flag), else null.
+async function recoverOffBranch(kshetra, task, guard) {
+    const g = (0, git_js_1.git)(kshetra);
+    const strayMain = await g.headSha(kshetra.repo.mainBranch);
+    // Get HEAD back onto the bead branch first — we can't move main while on it.
+    await g.checkout(guard.branch);
+    if (strayMain === guard.mainSha)
+        return null;
+    // Preserve the diverged commits before rewinding main.
+    const salvage = `shreni-salvage/${task.id}`;
+    await g.forceBranch(salvage, strayMain);
+    await g.forceBranch(kshetra.repo.mainBranch, guard.mainSha);
+    return salvage;
+}
+//# sourceMappingURL=guard.js.map

package/dist/sthapathi/guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.js","sourceRoot":"","sources":["../../src/sthapathi/guard.ts"],"names":[],"mappings":";;;AA8BA,oCAIC;AAID,wCAoBC;AAMD,4CAkBC;AAhFD,qCAA+B;AAE/B,+EAA+E;AAC/E,6EAA6E;AAC7E,8EAA8E;AAC9E,MAAa,cAAe,SAAQ,KAAK;IAGrB;IAFlB,YACE,OAAe,EACC,MAKf;QAED,KAAK,CAAC,OAAO,CAAC,CAAC;QAPC,WAAM,GAAN,MAAM,CAKrB;QAGD,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAbD,wCAaC;AAUM,KAAK,UAAU,YAAY,CAAC,OAAsB,EAAE,MAAc;IACvE,MAAM,CAAC,GAAG,IAAA,YAAG,EAAC,OAAO,CAAC,CAAC;IACvB,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACzD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC7B,CAAC;AAED,8EAA8E;AAC9E,mEAAmE;AAC5D,KAAK,UAAU,cAAc,CAAC,OAAsB,EAAE,KAAkB;IAC7E,MAAM,CAAC,GAAG,IAAA,YAAG,EAAC,OAAO,CAAC,CAAC;IACvB,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACxC,CAAC,CAAC,aAAa,EAAE;QACjB,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC;KACnC,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,IAAI,KAAK,KAAK,CAAC,MAAM,CAAC;IACxC,MAAM,SAAS,GAAG,OAAO,KAAK,KAAK,CAAC,OAAO,CAAC;IAC5C,IAAI,CAAC,SAAS,IAAI,CAAC,SAAS;QAAE,OAAO;IAErC,MAAM,MAAM,GAAG,SAAS;QACtB,CAAC,CAAC,eAAe,IAAI,4BAA4B,KAAK,CAAC,MAAM,GAAG;QAChE,CAAC,CAAC,mBAAmB,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,gCAAgC,CAAC;IAC3G,MAAM,IAAI,cAAc,CAAC,MAAM,EAAE;QAC/B,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,YAAY,EAAE,KAAK,CAAC,OAAO;QAC3B,UAAU,EAAE,IAAI;QAChB,UAAU,EAAE,OAAO;KACpB,CAAC,CAAC;AACL,CAAC;AAED,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAChF,iEAAiE;AAC1D,KAAK,UAAU,gBAAgB,CACpC,OAAsB,EACtB,IAAU,EACV,KAAkB;IAElB,MAAM,CAAC,GAAG,IAAA,YAAG,EAAC,OAAO,CAAC,CAAC;IACvB,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAE3D,6EAA6E;IAC7E,MAAM,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAE/B,IAAI,SAAS,KAAK,KAAK,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAE7C,uDAAuD;IACvD,MAAM,OAAO,GAAG,kBAAkB,IAAI,CAAC,EAAE,EAAE,CAAC;IAC5C,MAAM,CAAC,CAAC,WAAW,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACxC,MAAM,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAC5D,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/sthapathi/health.d.ts

@@ -0,0 +1,23 @@
+import type { KshetraConfig } from '../kshetra/config.js';
+import type { Task } from './types.js';
+export declare const HEALTH_BEAD_PREFIX = "[shreni-health]";
+export declare const HEALTH_BEAD_TITLE = "[shreni-health] Restore green test suite";
+export interface TestRunResult {
+    passed: boolean;
+    failCount: number;
+    raw: string;
+}
+export interface HealthStatus {
+    green: boolean;
+    failCount: number;
+    baseline: number;
+    sha: string;
+}
+export declare function parseFailCount(raw: string, pattern?: string): number;
+export declare function runTestSuite(kshetra: KshetraConfig): Promise<TestRunResult>;
+export declare function invalidateHealth(kshetra: KshetraConfig): void;
+export declare function checkHealth(kshetra: KshetraConfig): Promise<HealthStatus>;
+export declare function measureHealth(kshetra: KshetraConfig): Promise<HealthStatus>;
+export declare function isHealthBead(task: Task): boolean;
+export declare function ensureHealthBead(kshetra: KshetraConfig, failCount: number): Promise<boolean>;
+//# sourceMappingURL=health.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/sthapathi/health.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAWvC,eAAO,MAAM,kBAAkB,oBAAoB,CAAC;AACpD,eAAO,MAAM,iBAAiB,6CAAmD,CAAC;AAElF,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,OAAO,CAAC;IAGhB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACb;AAaD,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAepE;AAMD,wBAAsB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAkBjF;AAMD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAE7D;AAYD,wBAAsB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAW/E;AAID,wBAAsB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAOjF;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAEhD;AAID,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,aAAa,EACtB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC,CAalB"}

package/dist/sthapathi/health.js

@@ -0,0 +1,142 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HEALTH_BEAD_TITLE = exports.HEALTH_BEAD_PREFIX = void 0;
+exports.parseFailCount = parseFailCount;
+exports.runTestSuite = runTestSuite;
+exports.invalidateHealth = invalidateHealth;
+exports.checkHealth = checkHealth;
+exports.measureHealth = measureHealth;
+exports.isHealthBead = isHealthBead;
+exports.ensureHealthBead = ensureHealthBead;
+const child_process_1 = require("child_process");
+const util_1 = require("util");
+const git_js_1 = require("./git.js");
+const beads_js_1 = require("./beads.js");
+const state_js_1 = require("../kshetra/state.js");
+const toolchain_js_1 = require("../kshetra/toolchain.js");
+const execFileAsync = (0, util_1.promisify)(child_process_1.execFile);
+// Beads with a title beginning with this marker are "restore the suite" repair
+// tasks. They are EXEMPT from the green-suite precondition (they are the thing
+// that makes it green) and are gated on "failures must decrease" instead.
+exports.HEALTH_BEAD_PREFIX = '[shreni-health]';
+exports.HEALTH_BEAD_TITLE = `${exports.HEALTH_BEAD_PREFIX} Restore green test suite`;
+// Parse a failing-test count from common runner summaries, best-effort across
+// ecosystems. The exit code is the primary pass/fail signal (see runTestSuite);
+// this count only refines the "within baseline" comparison. The generic
+// `N failed` pattern covers vitest/jest/pytest/cargo; an optional
+// stack.failCountPattern override wins for a non-standard summary.
+//   vitest: "Tests  2 failed | 30 passed (32)"
+//   jest:   "Tests:       2 failed, 30 passed, 32 total"
+//   pytest: "=== 2 failed, 30 passed in 1.2s ==="
+//   cargo:  "test result: FAILED. 30 passed; 2 failed;"
+// Returns -1 when no count can be found (a red suite with an unknown count is
+// still treated as "not green").
+function parseFailCount(raw, pattern) {
+    const patterns = [];
+    if (pattern) {
+        try {
+            patterns.push(new RegExp(pattern, 'i'));
+        }
+        catch {
+            // A malformed override falls through to the built-in patterns.
+        }
+    }
+    patterns.push(/Tests:?\s+(\d+)\s+failed/i, /(\d+)\s+failed/i);
+    for (const re of patterns) {
+        const m = raw.match(re);
+        if (m && m[1] !== undefined)
+            return Number(m[1]);
+    }
+    return -1;
+}
+// Run the full configured test suite in the Kshetra repo. Resolves (never
+// rejects) with the exit-code-derived pass/fail and a best-effort fail count.
+// An empty test command means the Kshetra has no test gate — that is a visible,
+// logged decision (not a silent pass), reported as green with a note.
+async function runTestSuite(kshetra) {
+    const [cmd, ...args] = (0, toolchain_js_1.splitCommand)((0, toolchain_js_1.resolveTestCommand)(kshetra));
+    if (!cmd) {
+        console.warn(`[health] ${kshetra.id}: no test command configured — test gate skipped`);
+        return { passed: true, failCount: 0, raw: '(no test command configured — test gate skipped)' };
+    }
+    try {
+        const { stdout, stderr } = await execFileAsync(cmd, args, {
+            cwd: kshetra.repo.path,
+            maxBuffer: 32 * 1024 * 1024,
+        });
+        const raw = stdout + stderr;
+        return { passed: true, failCount: 0, raw };
+    }
+    catch (err) {
+        const e = err;
+        const raw = (e.stdout ?? '') + (e.stderr ?? '') + (e.message ?? '');
+        return { passed: false, failCount: parseFailCount(raw, kshetra.stack.failCountPattern), raw };
+    }
+}
+// sha-keyed cache so we don't re-run the suite on every 30s poll. main only
+// moves through squashMergeAndClose, so a stable HEAD means a stable verdict.
+const cache = new Map();
+function invalidateHealth(kshetra) {
+    cache.delete(kshetra.repo.path);
+}
+function computeStatus(result, baseline, sha) {
+    // "green enough" = no failures beyond the accepted baseline. An unknown count
+    // (-1) on a red suite is never green.
+    const green = result.passed || (result.failCount >= 0 && result.failCount <= baseline);
+    const failCount = result.passed ? 0 : result.failCount;
+    return { green, failCount, baseline, sha };
+}
+// Check whether the current tree's base (HEAD) is green, modulo the accepted
+// baseline of known-failing tests. Cached by HEAD sha.
+async function checkHealth(kshetra) {
+    const sha = await (0, git_js_1.git)(kshetra).headSha();
+    const baseline = (0, state_js_1.getHealthBaseline)(kshetra);
+    const cached = cache.get(kshetra.repo.path);
+    if (cached && cached.sha === sha && cached.status.baseline === baseline) {
+        return cached.status;
+    }
+    const result = await runTestSuite(kshetra);
+    const status = computeStatus(result, baseline, sha);
+    cache.set(kshetra.repo.path, { sha, status });
+    return status;
+}
+// Like checkHealth but always re-runs — used after Silpi mutates the tree
+// during a repair loop, where the verdict must reflect the new code.
+async function measureHealth(kshetra) {
+    const sha = await (0, git_js_1.git)(kshetra).headSha();
+    const baseline = (0, state_js_1.getHealthBaseline)(kshetra);
+    const result = await runTestSuite(kshetra);
+    const status = computeStatus(result, baseline, sha);
+    cache.set(kshetra.repo.path, { sha, status });
+    return status;
+}
+function isHealthBead(task) {
+    return task.title.startsWith(exports.HEALTH_BEAD_PREFIX);
+}
+// Ensure a single open repair bead exists. Returns true if one was created.
+// Idempotent: if a health bead is already open/ready, does nothing.
+async function ensureHealthBead(kshetra, failCount) {
+    const bdClient = (0, beads_js_1.bd)(kshetra);
+    for (const status of ['open', 'in_progress', 'blocked']) {
+        const raw = await bdClient.list({ status });
+        if (rawHasHealthBead(raw))
+            return false;
+    }
+    const countLabel = failCount >= 0 ? `${failCount}` : 'an unknown number of';
+    await bdClient.create(`${exports.HEALTH_BEAD_TITLE} (${countLabel} failing)`, 0, 'bug');
+    return true;
+}
+function rawHasHealthBead(raw) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return false;
+    }
+    if (!Array.isArray(parsed))
+        return false;
+    return parsed.some(item => typeof item.title === 'string' &&
+        item.title.startsWith(exports.HEALTH_BEAD_PREFIX));
+}
+//# sourceMappingURL=health.js.map

package/dist/sthapathi/health.js.map

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

package/dist/sthapathi/index.d.ts

@@ -0,0 +1,21 @@
+import type { KshetraConfig } from '../kshetra/config.js';
+import type { Task } from './types.js';
+import { type Phase } from './lifecycle.js';
+export type { Phase };
+export interface SchedulerHooks {
+    selectNext(kshetra: KshetraConfig): Promise<Task | null>;
+    prepareTask(task: Task, kshetra: KshetraConfig): Promise<Task | null>;
+    runTask(task: Task, kshetra: KshetraConfig): Promise<void>;
+}
+export interface Scheduler {
+    runCycle(kshetra: KshetraConfig, hooks: SchedulerHooks): Promise<void>;
+    scheduleLoop(kshetra: KshetraConfig, hooks: SchedulerHooks, intervalMs?: number): () => void;
+    start(kshetras: KshetraConfig[], hooks: SchedulerHooks, intervalMs?: number): () => void;
+    getActive(kshetraId: string): Task | undefined;
+    getPhase(kshetraId: string): Phase;
+}
+export declare const DEFAULT_INTERVAL_MS = 30000;
+export declare function createScheduler(opts?: {
+    onPhase?: (kshetraId: string, phase: Phase) => void;
+}): Scheduler;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sthapathi/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAiB,KAAK,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAM3D,YAAY,EAAE,KAAK,EAAE,CAAC;AAEtB,MAAM,WAAW,cAAc;IAE7B,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IAGzD,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IAEtE,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5D;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE,YAAY,CAAC,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,cAAc,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,IAAI,CAAC;IAC7F,KAAK,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,IAAI,CAAC;IACzF,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK,CAAC;CACpC;AAED,eAAO,MAAM,mBAAmB,QAAS,CAAC;AAE1C,wBAAgB,eAAe,CAAC,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;CAAO,GAAG,SAAS,CA4F7G"}