@dotcontext/cli 0.8.1 → 0.9.0

package/dist/services/harness/replayService.d.ts

@@ -0,0 +1,63 @@
+import type { HarnessArtifactRecord, HarnessSessionCheckpoint, HarnessSessionRecord, HarnessTraceRecord, HarnessRuntimeStatePort } from './runtimeStateService';
+import { HarnessSensorsService, type HarnessSensorRun } from './sensorsService';
+import { HarnessTaskContractsService, type HarnessHandoffContract, type HarnessTaskContract } from './taskContractsService';
+export type HarnessReplayEventSource = 'session' | 'trace' | 'artifact' | 'checkpoint' | 'sensor' | 'task' | 'handoff';
+export interface HarnessReplayEvent {
+    id: string;
+    sessionId: string;
+    createdAt: string;
+    source: HarnessReplayEventSource;
+    label: string;
+    payload?: Record<string, unknown>;
+}
+export interface HarnessReplayRecord {
+    id: string;
+    sessionId: string;
+    repoPath: string;
+    createdAt: string;
+    replayedAt: string;
+    fidelity: 'complete' | 'partial';
+    eventCount: number;
+    summary: string;
+    events: HarnessReplayEvent[];
+    session: HarnessSessionRecord;
+    artifacts: HarnessArtifactRecord[];
+    checkpoints: HarnessSessionCheckpoint[];
+    traces: HarnessTraceRecord[];
+    sensorRuns: HarnessSensorRun[];
+    tasks: HarnessTaskContract[];
+    handoffs: HarnessHandoffContract[];
+}
+export interface HarnessReplayServiceOptions {
+    repoPath: string;
+    dependencies?: Partial<HarnessReplayDependencies>;
+}
+export interface ReplaySessionOptions {
+    includePayloads?: boolean;
+    maxEvents?: number;
+}
+export interface HarnessReplayDependencies {
+    stateService: HarnessRuntimeStatePort;
+    sensorsService: Pick<HarnessSensorsService, 'getSessionSensorRuns'>;
+    contractsService: Pick<HarnessTaskContractsService, 'listTaskContracts' | 'listHandoffContracts'>;
+}
+export declare class HarnessReplayService {
+    private readonly options;
+    private readonly stateService;
+    private readonly sensorsService;
+    private readonly contractsService;
+    constructor(options: HarnessReplayServiceOptions);
+    private get repoPath();
+    private get replaysPath();
+    private replayFile;
+    private ensureLayout;
+    private saveReplay;
+    private readReplay;
+    buildReplay(sessionId: string, options?: ReplaySessionOptions): Promise<HarnessReplayRecord>;
+    replaySession(sessionId: string, options?: ReplaySessionOptions): Promise<HarnessReplayRecord>;
+    listReplays(filter?: {
+        sessionId?: string;
+    }): Promise<HarnessReplayRecord[]>;
+    getReplay(replayId: string): Promise<HarnessReplayRecord>;
+}
+//# sourceMappingURL=replayService.d.ts.map

package/dist/services/harness/replayService.d.ts.map

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

package/dist/services/harness/replayService.js

@@ -0,0 +1,242 @@
+"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.HarnessReplayService = void 0;
+const fs = __importStar(require("fs-extra"));
+const path = __importStar(require("path"));
+const crypto_1 = require("crypto");
+const runtimeStateService_1 = require("./runtimeStateService");
+const sensorsService_1 = require("./sensorsService");
+const taskContractsService_1 = require("./taskContractsService");
+function nowIso() {
+    return new Date().toISOString();
+}
+function sortByCreatedAt(items) {
+    return [...items].sort((left, right) => left.createdAt.localeCompare(right.createdAt));
+}
+class HarnessReplayService {
+    constructor(options) {
+        this.options = options;
+        const stateService = options.dependencies?.stateService
+            ?? new runtimeStateService_1.HarnessRuntimeStateService({ repoPath: options.repoPath });
+        const sensorsService = options.dependencies?.sensorsService
+            ?? new sensorsService_1.HarnessSensorsService({ stateService });
+        const contractsService = options.dependencies?.contractsService
+            ?? new taskContractsService_1.HarnessTaskContractsService({
+                repoPath: options.repoPath,
+                stateService,
+            });
+        this.stateService = stateService;
+        this.sensorsService = sensorsService;
+        this.contractsService = contractsService;
+    }
+    get repoPath() {
+        return path.resolve(this.options.repoPath);
+    }
+    get replaysPath() {
+        return path.join(this.repoPath, '.context', 'harness', 'replays');
+    }
+    replayFile(replayId) {
+        return path.join(this.replaysPath, `${replayId}.json`);
+    }
+    async ensureLayout() {
+        await fs.ensureDir(this.replaysPath);
+    }
+    async saveReplay(replay) {
+        await this.ensureLayout();
+        await fs.writeJson(this.replayFile(replay.id), replay, { spaces: 2 });
+    }
+    async readReplay(replayId) {
+        const filePath = this.replayFile(replayId);
+        if (!(await fs.pathExists(filePath))) {
+            throw new Error(`Replay not found: ${replayId}`);
+        }
+        return fs.readJson(filePath);
+    }
+    async buildReplay(sessionId, options = {}) {
+        const session = await this.stateService.getSession(sessionId);
+        const [traces, artifacts, checkpoints, sensorRuns, tasks, handoffs] = await Promise.all([
+            this.stateService.listTraces(sessionId),
+            this.stateService.listArtifacts(sessionId),
+            this.stateService.listCheckpoints(sessionId),
+            this.sensorsService.getSessionSensorRuns(sessionId),
+            this.contractsService.listTaskContracts(),
+            this.contractsService.listHandoffContracts(),
+        ]);
+        const sessionTasks = tasks.filter((task) => task.sessionId === sessionId);
+        const sessionHandoffs = handoffs.filter((handoff) => handoff.sessionId === sessionId);
+        const events = [
+            {
+                id: (0, crypto_1.randomUUID)(),
+                sessionId,
+                createdAt: session.createdAt,
+                source: 'session',
+                label: `session:${session.name}`,
+                payload: options.includePayloads === false
+                    ? undefined
+                    : {
+                        id: session.id,
+                        status: session.status,
+                        metadata: session.metadata ?? null,
+                    },
+            },
+            ...traces.map((trace) => ({
+                id: (0, crypto_1.randomUUID)(),
+                sessionId,
+                createdAt: trace.createdAt,
+                source: 'trace',
+                label: trace.event,
+                payload: options.includePayloads === false
+                    ? undefined
+                    : {
+                        level: trace.level,
+                        message: trace.message,
+                        data: trace.data ?? null,
+                    },
+            })),
+            ...artifacts.map((artifact) => ({
+                id: (0, crypto_1.randomUUID)(),
+                sessionId,
+                createdAt: artifact.createdAt,
+                source: 'artifact',
+                label: artifact.name,
+                payload: options.includePayloads === false
+                    ? undefined
+                    : {
+                        kind: artifact.kind,
+                        path: artifact.path ?? null,
+                        metadata: artifact.metadata ?? null,
+                    },
+            })),
+            ...checkpoints.map((checkpoint) => ({
+                id: (0, crypto_1.randomUUID)(),
+                sessionId,
+                createdAt: checkpoint.createdAt,
+                source: 'checkpoint',
+                label: checkpoint.note || checkpoint.id,
+                payload: options.includePayloads === false
+                    ? undefined
+                    : {
+                        artifactIds: checkpoint.artifactIds,
+                        data: checkpoint.data ?? null,
+                    },
+            })),
+            ...sensorRuns.map((run) => ({
+                id: (0, crypto_1.randomUUID)(),
+                sessionId,
+                createdAt: run.createdAt,
+                source: 'sensor',
+                label: run.sensorId,
+                payload: options.includePayloads === false
+                    ? undefined
+                    : {
+                        status: run.status,
+                        summary: run.summary,
+                        severity: run.severity,
+                        blocking: run.blocking,
+                    },
+            })),
+            ...sessionTasks.map((task) => ({
+                id: (0, crypto_1.randomUUID)(),
+                sessionId,
+                createdAt: task.createdAt,
+                source: 'task',
+                label: task.title,
+                payload: options.includePayloads === false
+                    ? undefined
+                    : {
+                        status: task.status,
+                        requiredSensors: task.requiredSensors,
+                        requiredArtifacts: task.requiredArtifacts,
+                        acceptanceCriteria: task.acceptanceCriteria,
+                    },
+            })),
+            ...sessionHandoffs.map((handoff) => ({
+                id: (0, crypto_1.randomUUID)(),
+                sessionId,
+                createdAt: handoff.createdAt,
+                source: 'handoff',
+                label: `${handoff.from} -> ${handoff.to}`,
+                payload: options.includePayloads === false
+                    ? undefined
+                    : {
+                        artifacts: handoff.artifacts,
+                        evidence: handoff.evidence,
+                    },
+            })),
+        ];
+        const orderedEvents = sortByCreatedAt(events).slice(0, options.maxEvents ?? Number.MAX_SAFE_INTEGER);
+        const replay = {
+            id: (0, crypto_1.randomUUID)(),
+            sessionId,
+            repoPath: this.repoPath,
+            createdAt: nowIso(),
+            replayedAt: nowIso(),
+            fidelity: orderedEvents.length >= events.length ? 'complete' : 'partial',
+            eventCount: orderedEvents.length,
+            summary: `Replayed ${orderedEvents.length} events for session ${session.name}`,
+            events: orderedEvents,
+            session,
+            artifacts,
+            checkpoints,
+            traces,
+            sensorRuns,
+            tasks: sessionTasks,
+            handoffs: sessionHandoffs,
+        };
+        return replay;
+    }
+    async replaySession(sessionId, options = {}) {
+        const replay = await this.buildReplay(sessionId, options);
+        await this.saveReplay(replay);
+        return replay;
+    }
+    async listReplays(filter) {
+        await this.ensureLayout();
+        const entries = await fs.readdir(this.replaysPath);
+        const replays = await Promise.all(entries
+            .filter((entry) => entry.endsWith('.json'))
+            .map(async (entry) => fs.readJson(path.join(this.replaysPath, entry))));
+        const filtered = filter?.sessionId
+            ? replays.filter((replay) => replay.sessionId === filter.sessionId)
+            : replays;
+        return filtered.sort((left, right) => right.createdAt.localeCompare(left.createdAt));
+    }
+    async getReplay(replayId) {
+        return this.readReplay(replayId);
+    }
+}
+exports.HarnessReplayService = HarnessReplayService;
+//# sourceMappingURL=replayService.js.map

package/dist/services/harness/replayService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replayService.js","sourceRoot":"","sources":["../../../src/services/harness/replayService.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,6CAA+B;AAC/B,2CAA6B;AAC7B,mCAAoC;AASpC,+DAAwG;AACxG,qDAAgF;AAChF,iEAIgC;AAuDhC,SAAS,MAAM;IACb,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED,SAAS,eAAe,CAAkC,KAAU;IAClE,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;AACzF,CAAC;AAED,MAAa,oBAAoB;IAK/B,YAA6B,OAAoC;QAApC,YAAO,GAAP,OAAO,CAA6B;QAC/D,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,EAAE,YAAY;eAClD,IAAI,gDAAiC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC3E,MAAM,cAAc,GAAG,OAAO,CAAC,YAAY,EAAE,cAAc;eACtD,IAAI,sCAAqB,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC;QACjD,MAAM,gBAAgB,GAAG,OAAO,CAAC,YAAY,EAAE,gBAAgB;eAC1D,IAAI,kDAA2B,CAAC;gBACjC,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,YAAY;aACb,CAAC,CAAC;QAEL,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;IAC3C,CAAC;IAED,IAAY,QAAQ;QAClB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC7C,CAAC;IAED,IAAY,WAAW;QACrB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IACpE,CAAC;IAEO,UAAU,CAAC,QAAgB;QACjC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,QAAQ,OAAO,CAAC,CAAC;IACzD,CAAC;IAEO,KAAK,CAAC,YAAY;QACxB,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACvC,CAAC;IAEO,KAAK,CAAC,UAAU,CAAC,MAA2B;QAClD,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC1B,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;IACxE,CAAC;IAEO,KAAK,CAAC,UAAU,CAAC,QAAgB;QACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC3C,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,EAAE,CAAC,CAAC;QACnD,CAAC;QAED,OAAO,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAiC,CAAC;IAC/D,CAAC;IAED,KAAK,CAAC,WAAW,CACf,SAAiB,EACjB,UAAgC,EAAE;QAElC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAC9D,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACtF,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,SAAS,CAAC;YACvC,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,SAAS,CAAC;YAC1C,IAAI,CAAC,YAAY,CAAC,eAAe,CAAC,SAAS,CAAC;YAC5C,IAAI,CAAC,cAAc,CAAC,oBAAoB,CAAC,SAAS,CAAC;YACnD,IAAI,CAAC,gBAAgB,CAAC,iBAAiB,EAAE;YACzC,IAAI,CAAC,gBAAgB,CAAC,oBAAoB,EAAE;SAC7C,CAAC,CAAC;QAEH,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC;QAC1E,MAAM,eAAe,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC;QAEtF,MAAM,MAAM,GAAyB;YACnC;gBACE,EAAE,EAAE,IAAA,mBAAU,GAAE;gBAChB,SAAS;gBACT,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,MAAM,EAAE,SAAS;gBACjB,KAAK,EAAE,WAAW,OAAO,CAAC,IAAI,EAAE;gBAChC,OAAO,EAAE,OAAO,CAAC,eAAe,KAAK,KAAK;oBACxC,CAAC,CAAC,SAAS;oBACX,CAAC,CAAC;wBACE,EAAE,EAAE,OAAO,CAAC,EAAE;wBACd,MAAM,EAAE,OAAO,CAAC,MAAM;wBACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,IAAI;qBACnC;aACN;YACD,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBACxB,EAAE,EAAE,IAAA,mBAAU,GAAE;gBAChB,SAAS;gBACT,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,MAAM,EAAE,OAAgB;gBACxB,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,OAAO,EAAE,OAAO,CAAC,eAAe,KAAK,KAAK;oBACxC,CAAC,CAAC,SAAS;oBACX,CAAC,CAAC;wBACE,KAAK,EAAE,KAAK,CAAC,KAAK;wBAClB,OAAO,EAAE,KAAK,CAAC,OAAO;wBACtB,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,IAAI;qBACzB;aACN,CAAC,CAAC;YACH,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;gBAC9B,EAAE,EAAE,IAAA,mBAAU,GAAE;gBAChB,SAAS;gBACT,SAAS,EAAE,QAAQ,CAAC,SAAS;gBAC7B,MAAM,EAAE,UAAmB;gBAC3B,KAAK,EAAE,QAAQ,CAAC,IAAI;gBACpB,OAAO,EAAE,OAAO,CAAC,eAAe,KAAK,KAAK;oBACxC,CAAC,CAAC,SAAS;oBACX,CAAC,CAAC;wBACE,IAAI,EAAE,QAAQ,CAAC,IAAI;wBACnB,IAAI,EAAE,QAAQ,CAAC,IAAI,IAAI,IAAI;wBAC3B,QAAQ,EAAE,QAAQ,CAAC,QAAQ,IAAI,IAAI;qBACpC;aACN,CAAC,CAAC;YACH,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;gBAClC,EAAE,EAAE,IAAA,mBAAU,GAAE;gBAChB,SAAS;gBACT,SAAS,EAAE,UAAU,CAAC,SAAS;gBAC/B,MAAM,EAAE,YAAqB;gBAC7B,KAAK,EAAE,UAAU,CAAC,IAAI,IAAI,UAAU,CAAC,EAAE;gBACvC,OAAO,EAAE,OAAO,CAAC,eAAe,KAAK,KAAK;oBACxC,CAAC,CAAC,SAAS;oBACX,CAAC,CAAC;wBACE,WAAW,EAAE,UAAU,CAAC,WAAW;wBACnC,IAAI,EAAE,UAAU,CAAC,IAAI,IAAI,IAAI;qBAC9B;aACN,CAAC,CAAC;YACH,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBAC1B,EAAE,EAAE,IAAA,mBAAU,GAAE;gBAChB,SAAS;gBACT,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,MAAM,EAAE,QAAiB;gBACzB,KAAK,EAAE,GAAG,CAAC,QAAQ;gBACnB,OAAO,EAAE,OAAO,CAAC,eAAe,KAAK,KAAK;oBACxC,CAAC,CAAC,SAAS;oBACX,CAAC,CAAC;wBACE,MAAM,EAAE,GAAG,CAAC,MAAM;wBAClB,OAAO,EAAE,GAAG,CAAC,OAAO;wBACpB,QAAQ,EAAE,GAAG,CAAC,QAAQ;wBACtB,QAAQ,EAAE,GAAG,CAAC,QAAQ;qBACvB;aACN,CAAC,CAAC;YACH,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBAC7B,EAAE,EAAE,IAAA,mBAAU,GAAE;gBAChB,SAAS;gBACT,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,MAAM,EAAE,MAAe;gBACvB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,OAAO,EAAE,OAAO,CAAC,eAAe,KAAK,KAAK;oBACxC,CAAC,CAAC,SAAS;oBACX,CAAC,CAAC;wBACE,MAAM,EAAE,IAAI,CAAC,MAAM;wBACnB,eAAe,EAAE,IAAI,CAAC,eAAe;wBACrC,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;wBACzC,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;qBAC5C;aACN,CAAC,CAAC;YACH,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;gBACnC,EAAE,EAAE,IAAA,mBAAU,GAAE;gBAChB,SAAS;gBACT,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,MAAM,EAAE,SAAkB;gBAC1B,KAAK,EAAE,GAAG,OAAO,CAAC,IAAI,OAAO,OAAO,CAAC,EAAE,EAAE;gBACzC,OAAO,EAAE,OAAO,CAAC,eAAe,KAAK,KAAK;oBACxC,CAAC,CAAC,SAAS;oBACX,CAAC,CAAC;wBACE,SAAS,EAAE,OAAO,CAAC,SAAS;wBAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ;qBAC3B;aACN,CAAC,CAAC;SACJ,CAAC;QAEF,MAAM,aAAa,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC,gBAAgB,CAAC,CAAC;QACrG,MAAM,MAAM,GAAwB;YAClC,EAAE,EAAE,IAAA,mBAAU,GAAE;YAChB,SAAS;YACT,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS,EAAE,MAAM,EAAE;YACnB,UAAU,EAAE,MAAM,EAAE;YACpB,QAAQ,EAAE,aAAa,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;YACxE,UAAU,EAAE,aAAa,CAAC,MAAM;YAChC,OAAO,EAAE,YAAY,aAAa,CAAC,MAAM,uBAAuB,OAAO,CAAC,IAAI,EAAE;YAC9E,MAAM,EAAE,aAAa;YACrB,OAAO;YACP,SAAS;YACT,WAAW;YACX,MAAM;YACN,UAAU;YACV,KAAK,EAAE,YAAY;YACnB,QAAQ,EAAE,eAAe;SAC1B,CAAC;QAEF,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,aAAa,CACjB,SAAiB,EACjB,UAAgC,EAAE;QAElC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC1D,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAC9B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,MAA+B;QAC/C,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACnD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,OAAO;aACJ,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;aAC1C,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,CAAiC,CAAC,CACzG,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,EAAE,SAAS;YAChC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,KAAK,MAAM,CAAC,SAAS,CAAC;YACnE,CAAC,CAAC,OAAO,CAAC;QAEZ,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;IACvF,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,QAAgB;QAC9B,OAAO,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC;CACF;AA5ND,oDA4NC"}

package/dist/services/harness/runtimeStateService.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Harness Runtime State Service
+ *
+ * Transport-agnostic persistence for sessions, artifacts, traces, and checkpoints.
+ * The storage layout lives under .context/harness so future adapters can share state.
+ */
+export type HarnessSessionStatus = 'active' | 'paused' | 'completed' | 'failed';
+export type HarnessTraceLevel = 'debug' | 'info' | 'warn' | 'error';
+export type HarnessArtifactKind = 'text' | 'json' | 'file';
+export interface HarnessRuntimeStateServiceOptions {
+    repoPath: string;
+}
+export interface HarnessSessionCheckpoint {
+    id: string;
+    note?: string;
+    data?: unknown;
+    artifactIds: string[];
+    createdAt: string;
+}
+export interface HarnessSessionRecord {
+    id: string;
+    name: string;
+    status: HarnessSessionStatus;
+    repoPath: string;
+    createdAt: string;
+    updatedAt: string;
+    startedAt: string;
+    completedAt?: string;
+    failedAt?: string;
+    lastTraceAt?: string;
+    lastCheckpointAt?: string;
+    traceCount: number;
+    artifactCount: number;
+    checkpointCount: number;
+    checkpoints: HarnessSessionCheckpoint[];
+    metadata?: Record<string, unknown>;
+}
+export interface HarnessTraceRecord {
+    id: string;
+    sessionId: string;
+    level: HarnessTraceLevel;
+    event: string;
+    message: string;
+    createdAt: string;
+    data?: Record<string, unknown>;
+}
+export interface HarnessArtifactRecord {
+    id: string;
+    sessionId: string;
+    name: string;
+    kind: HarnessArtifactKind;
+    createdAt: string;
+    content?: unknown;
+    path?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface HarnessRuntimeStatePort {
+    getSession(sessionId: string): Promise<HarnessSessionRecord>;
+    listSessions(): Promise<HarnessSessionRecord[]>;
+    appendTrace(sessionId: string, input: AppendTraceInput): Promise<HarnessTraceRecord>;
+    listTraces(sessionId: string): Promise<HarnessTraceRecord[]>;
+    addArtifact(sessionId: string, input: AddArtifactInput): Promise<HarnessArtifactRecord>;
+    listArtifacts(sessionId: string): Promise<HarnessArtifactRecord[]>;
+    checkpointSession(sessionId: string, input?: CheckpointInput): Promise<HarnessSessionRecord>;
+    listCheckpoints(sessionId: string): Promise<HarnessSessionCheckpoint[]>;
+}
+export interface CreateSessionInput {
+    name: string;
+    metadata?: Record<string, unknown>;
+}
+export interface AppendTraceInput {
+    level: HarnessTraceLevel;
+    event: string;
+    message: string;
+    data?: Record<string, unknown>;
+}
+export interface AddArtifactInput {
+    name: string;
+    kind?: HarnessArtifactKind;
+    content?: unknown;
+    path?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface CheckpointInput {
+    note?: string;
+    data?: unknown;
+    artifactIds?: string[];
+    pause?: boolean;
+}
+export declare class HarnessRuntimeStateService {
+    private readonly options;
+    constructor(options: HarnessRuntimeStateServiceOptions);
+    private get repoPath();
+    private get contextPath();
+    private get harnessPath();
+    private get sessionsPath();
+    private get tracesPath();
+    private get artifactsPath();
+    private sessionFile;
+    private traceFile;
+    private artifactFile;
+    private ensureLayout;
+    private readSession;
+    private saveSession;
+    private appendTraceLine;
+    private recordTrace;
+    createSession(input: CreateSessionInput): Promise<HarnessSessionRecord>;
+    listSessions(): Promise<HarnessSessionRecord[]>;
+    getSession(sessionId: string): Promise<HarnessSessionRecord>;
+    appendTrace(sessionId: string, input: AppendTraceInput): Promise<HarnessTraceRecord>;
+    addArtifact(sessionId: string, input: AddArtifactInput): Promise<HarnessArtifactRecord>;
+    listCheckpoints(sessionId: string): Promise<HarnessSessionCheckpoint[]>;
+    listArtifacts(sessionId: string): Promise<HarnessArtifactRecord[]>;
+    listTraces(sessionId: string): Promise<HarnessTraceRecord[]>;
+    checkpointSession(sessionId: string, input?: CheckpointInput): Promise<HarnessSessionRecord>;
+    resumeSession(sessionId: string): Promise<HarnessSessionRecord>;
+    completeSession(sessionId: string, note?: string): Promise<HarnessSessionRecord>;
+    failSession(sessionId: string, message: string): Promise<HarnessSessionRecord>;
+}
+//# sourceMappingURL=runtimeStateService.d.ts.map

package/dist/services/harness/runtimeStateService.d.ts.map

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