@coralai/sps-cli 0.6.0

package/dist/core/queue.js

@@ -0,0 +1,38 @@
+import { readFileSync, writeFileSync, renameSync, existsSync } from 'node:fs';
+/**
+ * Read pipeline_order.json — a pure array of seq numbers.
+ * Returns empty array if file doesn't exist.
+ */
+export function readQueue(filePath) {
+    if (!existsSync(filePath))
+        return [];
+    try {
+        const raw = readFileSync(filePath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (!Array.isArray(parsed))
+            return [];
+        return parsed.filter((v) => typeof v === 'number');
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Atomic write of pipeline_order.json.
+ */
+export function writeQueue(filePath, queue) {
+    const tmpFile = filePath + '.tmp';
+    writeFileSync(tmpFile, JSON.stringify(queue, null, 2) + '\n');
+    renameSync(tmpFile, filePath);
+}
+/**
+ * Remove a seq from the queue and write back atomically.
+ */
+export function removeFromQueue(filePath, seq) {
+    const queue = readQueue(filePath);
+    const updated = queue.filter((s) => s !== seq);
+    if (updated.length !== queue.length) {
+        writeQueue(filePath, updated);
+    }
+}
+//# sourceMappingURL=queue.js.map

package/dist/core/queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.js","sourceRoot":"","sources":["../../src/core/queue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAG9E;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,QAAgB;IACxC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YAAE,OAAO,EAAE,CAAC;QACtC,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;IAClE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,QAAgB,EAAE,KAAe;IAC1D,MAAM,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;IAClC,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC9D,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,GAAW;IAC3D,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IAClC,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;IAC/C,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC;QACpC,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAChC,CAAC;AACH,CAAC"}

package/dist/core/state.d.ts

@@ -0,0 +1,32 @@
+export interface WorkerSlotState {
+    status: 'idle' | 'active' | 'releasing';
+    seq: number | null;
+    branch: string | null;
+    worktree: string | null;
+    tmuxSession: string | null;
+    claimedAt: string | null;
+    lastHeartbeat: string | null;
+}
+export interface ActiveCardState {
+    seq: number;
+    state: string;
+    worker: string | null;
+    mrUrl: string | null;
+    conflictDomains: string[];
+    startedAt: string;
+}
+export interface RuntimeState {
+    version: number;
+    generation: number;
+    updatedAt: string;
+    updatedBy: string;
+    workers: Record<string, WorkerSlotState>;
+    activeCards: Record<string, ActiveCardState>;
+}
+export declare function readState(stateFile: string, maxWorkers: number): RuntimeState;
+/**
+ * Atomic write: write to temp file, then rename.
+ * Increments generation automatically.
+ */
+export declare function writeState(stateFile: string, state: RuntimeState, updatedBy: string): void;
+//# sourceMappingURL=state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/core/state.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,WAAW,CAAC;IACxC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACzC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CAC9C;AAyBD,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,CAU7E;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAW1F"}

package/dist/core/state.js

@@ -0,0 +1,52 @@
+import { readFileSync, writeFileSync, renameSync, existsSync, mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+function defaultState(maxWorkers) {
+    const workers = {};
+    for (let i = 1; i <= maxWorkers; i++) {
+        workers[`worker-${i}`] = {
+            status: 'idle',
+            seq: null,
+            branch: null,
+            worktree: null,
+            tmuxSession: null,
+            claimedAt: null,
+            lastHeartbeat: null,
+        };
+    }
+    return {
+        version: 1,
+        generation: 0,
+        updatedAt: new Date().toISOString(),
+        updatedBy: 'init',
+        workers,
+        activeCards: {},
+    };
+}
+export function readState(stateFile, maxWorkers) {
+    if (!existsSync(stateFile)) {
+        return defaultState(maxWorkers);
+    }
+    try {
+        const raw = readFileSync(stateFile, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return defaultState(maxWorkers);
+    }
+}
+/**
+ * Atomic write: write to temp file, then rename.
+ * Increments generation automatically.
+ */
+export function writeState(stateFile, state, updatedBy) {
+    const dir = dirname(stateFile);
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    state.generation += 1;
+    state.updatedAt = new Date().toISOString();
+    state.updatedBy = updatedBy;
+    const tmpFile = stateFile + '.tmp';
+    writeFileSync(tmpFile, JSON.stringify(state, null, 2) + '\n');
+    renameSync(tmpFile, stateFile);
+}
+//# sourceMappingURL=state.js.map

package/dist/core/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/core/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACzF,OAAO,EAAW,OAAO,EAAE,MAAM,WAAW,CAAC;AA8B7C,SAAS,YAAY,CAAC,UAAkB;IACtC,MAAM,OAAO,GAAoC,EAAE,CAAC;IACpD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC,GAAG;YACvB,MAAM,EAAE,MAAM;YACd,GAAG,EAAE,IAAI;YACT,MAAM,EAAE,IAAI;YACZ,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,IAAI;YACjB,SAAS,EAAE,IAAI;YACf,aAAa,EAAE,IAAI;SACpB,CAAC;IACJ,CAAC;IACD,OAAO;QACL,OAAO,EAAE,CAAC;QACV,UAAU,EAAE,CAAC;QACb,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,SAAS,EAAE,MAAM;QACjB,OAAO;QACP,WAAW,EAAE,EAAE;KAChB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,SAAiB,EAAE,UAAkB;IAC7D,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,OAAO,YAAY,CAAC,UAAU,CAAC,CAAC;IAClC,CAAC;IACD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC7C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAiB,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,YAAY,CAAC,UAAU,CAAC,CAAC;IAClC,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,SAAiB,EAAE,KAAmB,EAAE,SAAiB;IAClF,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAC/B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE1D,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC;IACtB,KAAK,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;IAE5B,MAAM,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACnC,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC9D,UAAU,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;AACjC,CAAC"}

package/dist/engines/CloseoutEngine.d.ts

@@ -0,0 +1,60 @@
+import type { ProjectContext } from '../core/context.js';
+import type { TaskBackend } from '../interfaces/TaskBackend.js';
+import type { RepoBackend } from '../interfaces/RepoBackend.js';
+import type { WorkerProvider } from '../interfaces/WorkerProvider.js';
+import type { Notifier } from '../interfaces/Notifier.js';
+import type { CommandResult } from '../models/types.js';
+/**
+ * CloseoutEngine handles the QA → merge → Done → resource release pipeline.
+ *
+ * Decision tree per 01 §10.3.2:
+ *   QA card → check MR exists?
+ *     ├─ MR not found → NEEDS-FIX
+ *     └─ MR exists → check MR state
+ *         ├─ already merged → resource release → Done
+ *         ├─ open + CI success + can_be_merged → attempt merge
+ *         ├─ open + CI failed → self-repair or NEEDS-FIX
+ *         ├─ open + CI running/pending → skip
+ *         ├─ open + cannot_be_merged → CONFLICT
+ *         └─ closed (not merged) → NEEDS-FIX
+ */
+export declare class CloseoutEngine {
+    private ctx;
+    private taskBackend;
+    private repoBackend;
+    private workerProvider;
+    private notifier?;
+    private log;
+    constructor(ctx: ProjectContext, taskBackend: TaskBackend, repoBackend: RepoBackend, workerProvider: WorkerProvider, notifier?: Notifier | undefined);
+    tick(): Promise<CommandResult>;
+    private processQaCard;
+    private processOpenMr;
+    private handleCiFailure;
+    private attemptMerge;
+    /**
+     * Release resources after successful merge. Each step failure MUST NOT
+     * block subsequent steps — log and continue.
+     *
+     * Order:
+     *   1. Move card to Done
+     *   2. Release claim in PM
+     *   3. Release worker slot in state.json (→ idle)
+     *   4. Stop worker session
+     *   5. Mark worktree for cleanup
+     */
+    private releaseAndDone;
+    /**
+     * Attempt to resolve merge conflict automatically.
+     * L1: auto rebase + force push
+     * L2: send conflict to original worker to resolve
+     * Returns true if resolution was initiated (wait for next tick to verify).
+     */
+    private resolveConflict;
+    private buildBranchName;
+    private markNeedsFix;
+    private addLabelSafe;
+    private commentSafe;
+    private notifySafe;
+    private logEvent;
+}
+//# sourceMappingURL=CloseoutEngine.d.ts.map

package/dist/engines/CloseoutEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CloseoutEngine.d.ts","sourceRoot":"","sources":["../../src/engines/CloseoutEngine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAyC,MAAM,oBAAoB,CAAC;AAI/F;;;;;;;;;;;;;GAaG;AACH,qBAAa,cAAc;IAIvB,OAAO,CAAC,GAAG;IACX,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,QAAQ,CAAC;IAPnB,OAAO,CAAC,GAAG,CAAS;gBAGV,GAAG,EAAE,cAAc,EACnB,WAAW,EAAE,WAAW,EACxB,WAAW,EAAE,WAAW,EACxB,cAAc,EAAE,cAAc,EAC9B,QAAQ,CAAC,EAAE,QAAQ,YAAA;IAKvB,IAAI,IAAI,OAAO,CAAC,aAAa,CAAC;YAkEtB,aAAa;YAoDb,aAAa;YAkHb,eAAe;YAmFf,YAAY;IAyC1B;;;;;;;;;;OAUG;YACW,cAAc;IA0H5B;;;;;OAKG;YACW,eAAe;IAuF7B,OAAO,CAAC,eAAe;YAST,YAAY;YAMZ,YAAY;YASZ,WAAW;YASX,UAAU;IAYxB,OAAO,CAAC,QAAQ;CAcjB"}