@dotcontext/cli 0.8.2 → 0.9.1

package/dist/services/harness/runtimeStateService.js

@@ -0,0 +1,316 @@
+"use strict";
+/**
+ * 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.
+ */
+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.HarnessRuntimeStateService = void 0;
+const fs = __importStar(require("fs-extra"));
+const path = __importStar(require("path"));
+const crypto_1 = require("crypto");
+function nowIso() {
+    return new Date().toISOString();
+}
+function normalizeContent(content) {
+    if (content === undefined) {
+        return undefined;
+    }
+    if (typeof content === 'string') {
+        return content;
+    }
+    return content;
+}
+class HarnessRuntimeStateService {
+    constructor(options) {
+        this.options = options;
+    }
+    get repoPath() {
+        return this.options.repoPath || process.cwd();
+    }
+    get contextPath() {
+        return path.join(this.repoPath, '.context');
+    }
+    get harnessPath() {
+        return path.join(this.contextPath, 'harness');
+    }
+    get sessionsPath() {
+        return path.join(this.harnessPath, 'sessions');
+    }
+    get tracesPath() {
+        return path.join(this.harnessPath, 'traces');
+    }
+    get artifactsPath() {
+        return path.join(this.harnessPath, 'artifacts');
+    }
+    sessionFile(sessionId) {
+        return path.join(this.sessionsPath, `${sessionId}.json`);
+    }
+    traceFile(sessionId) {
+        return path.join(this.tracesPath, `${sessionId}.jsonl`);
+    }
+    artifactFile(sessionId, artifactId) {
+        return path.join(this.artifactsPath, sessionId, `${artifactId}.json`);
+    }
+    async ensureLayout() {
+        await fs.ensureDir(this.sessionsPath);
+        await fs.ensureDir(this.tracesPath);
+        await fs.ensureDir(this.artifactsPath);
+    }
+    async readSession(sessionId) {
+        const file = this.sessionFile(sessionId);
+        if (!(await fs.pathExists(file))) {
+            throw new Error(`Harness session not found: ${sessionId}`);
+        }
+        return fs.readJson(file);
+    }
+    async saveSession(session) {
+        await this.ensureLayout();
+        await fs.writeJson(this.sessionFile(session.id), session, { spaces: 2 });
+    }
+    async appendTraceLine(sessionId, trace) {
+        await this.ensureLayout();
+        await fs.appendFile(this.traceFile(sessionId), `${JSON.stringify(trace)}\n`, 'utf8');
+    }
+    async recordTrace(sessionId, trace) {
+        const session = await this.readSession(sessionId);
+        await this.appendTraceLine(sessionId, trace);
+        session.traceCount += 1;
+        session.lastTraceAt = trace.createdAt;
+        session.updatedAt = trace.createdAt;
+        await this.saveSession(session);
+        return trace;
+    }
+    async createSession(input) {
+        const createdAt = nowIso();
+        const session = {
+            id: (0, crypto_1.randomUUID)(),
+            name: input.name,
+            status: 'active',
+            repoPath: this.repoPath,
+            createdAt,
+            updatedAt: createdAt,
+            startedAt: createdAt,
+            traceCount: 0,
+            artifactCount: 0,
+            checkpointCount: 0,
+            checkpoints: [],
+            metadata: input.metadata,
+        };
+        await this.saveSession(session);
+        await this.recordTrace(session.id, {
+            id: (0, crypto_1.randomUUID)(),
+            sessionId: session.id,
+            level: 'info',
+            event: 'session.created',
+            message: `Session created: ${input.name}`,
+            createdAt,
+            data: input.metadata ? { metadata: input.metadata } : undefined,
+        });
+        return this.readSession(session.id);
+    }
+    async listSessions() {
+        await this.ensureLayout();
+        const entries = await fs.readdir(this.sessionsPath);
+        const sessions = await Promise.all(entries
+            .filter((entry) => entry.endsWith('.json'))
+            .map(async (entry) => fs.readJson(path.join(this.sessionsPath, entry))));
+        return sessions.sort((a, b) => b.updatedAt.localeCompare(a.updatedAt));
+    }
+    async getSession(sessionId) {
+        return this.readSession(sessionId);
+    }
+    async appendTrace(sessionId, input) {
+        const createdAt = nowIso();
+        const trace = {
+            id: (0, crypto_1.randomUUID)(),
+            sessionId,
+            level: input.level,
+            event: input.event,
+            message: input.message,
+            createdAt,
+            data: input.data,
+        };
+        return this.recordTrace(sessionId, trace);
+    }
+    async addArtifact(sessionId, input) {
+        const session = await this.readSession(sessionId);
+        const createdAt = nowIso();
+        const artifact = {
+            id: (0, crypto_1.randomUUID)(),
+            sessionId,
+            name: input.name,
+            kind: input.kind || 'text',
+            createdAt,
+            content: normalizeContent(input.content),
+            path: input.path,
+            metadata: input.metadata,
+        };
+        await fs.ensureDir(path.dirname(this.artifactFile(sessionId, artifact.id)));
+        await fs.writeJson(this.artifactFile(sessionId, artifact.id), artifact, { spaces: 2 });
+        session.artifactCount += 1;
+        session.updatedAt = createdAt;
+        await this.saveSession(session);
+        await this.recordTrace(sessionId, {
+            id: (0, crypto_1.randomUUID)(),
+            sessionId,
+            level: 'info',
+            event: 'artifact.added',
+            message: `Artifact recorded: ${input.name}`,
+            createdAt,
+            data: {
+                artifactId: artifact.id,
+                kind: artifact.kind,
+                path: artifact.path,
+            },
+        });
+        return artifact;
+    }
+    async listCheckpoints(sessionId) {
+        const session = await this.readSession(sessionId);
+        return [...session.checkpoints].sort((a, b) => a.createdAt.localeCompare(b.createdAt));
+    }
+    async listArtifacts(sessionId) {
+        const dir = path.join(this.artifactsPath, sessionId);
+        if (!(await fs.pathExists(dir))) {
+            return [];
+        }
+        const entries = await fs.readdir(dir);
+        const artifacts = await Promise.all(entries
+            .filter((entry) => entry.endsWith('.json'))
+            .map(async (entry) => fs.readJson(path.join(dir, entry))));
+        return artifacts.sort((a, b) => a.createdAt.localeCompare(b.createdAt));
+    }
+    async listTraces(sessionId) {
+        const file = this.traceFile(sessionId);
+        if (!(await fs.pathExists(file))) {
+            return [];
+        }
+        const content = await fs.readFile(file, 'utf8');
+        return content
+            .split('\n')
+            .map((line) => line.trim())
+            .filter(Boolean)
+            .map((line) => JSON.parse(line));
+    }
+    async checkpointSession(sessionId, input = {}) {
+        const session = await this.readSession(sessionId);
+        const createdAt = nowIso();
+        const checkpoint = {
+            id: (0, crypto_1.randomUUID)(),
+            note: input.note,
+            data: input.data,
+            artifactIds: input.artifactIds || [],
+            createdAt,
+        };
+        session.checkpoints.push(checkpoint);
+        session.checkpointCount = session.checkpoints.length;
+        session.lastCheckpointAt = createdAt;
+        session.updatedAt = createdAt;
+        session.status = input.pause ? 'paused' : session.status;
+        await this.saveSession(session);
+        await this.recordTrace(sessionId, {
+            id: (0, crypto_1.randomUUID)(),
+            sessionId,
+            level: 'info',
+            event: input.pause ? 'session.paused' : 'session.checkpointed',
+            message: input.note ? `Checkpoint recorded: ${input.note}` : 'Checkpoint recorded',
+            createdAt,
+            data: {
+                checkpointId: checkpoint.id,
+                artifactIds: checkpoint.artifactIds,
+                payload: input.data,
+            },
+        });
+        return this.readSession(sessionId);
+    }
+    async resumeSession(sessionId) {
+        const session = await this.readSession(sessionId);
+        const createdAt = nowIso();
+        if (session.status === 'completed' || session.status === 'failed') {
+            throw new Error(`Cannot resume a ${session.status} session: ${sessionId}`);
+        }
+        session.status = 'active';
+        session.updatedAt = createdAt;
+        await this.saveSession(session);
+        await this.recordTrace(sessionId, {
+            id: (0, crypto_1.randomUUID)(),
+            sessionId,
+            level: 'info',
+            event: 'session.resumed',
+            message: 'Session resumed',
+            createdAt,
+        });
+        return this.readSession(sessionId);
+    }
+    async completeSession(sessionId, note) {
+        const session = await this.readSession(sessionId);
+        const createdAt = nowIso();
+        session.status = 'completed';
+        session.completedAt = createdAt;
+        session.updatedAt = createdAt;
+        await this.saveSession(session);
+        await this.recordTrace(sessionId, {
+            id: (0, crypto_1.randomUUID)(),
+            sessionId,
+            level: 'info',
+            event: 'session.completed',
+            message: note ? `Session completed: ${note}` : 'Session completed',
+            createdAt,
+        });
+        return this.readSession(sessionId);
+    }
+    async failSession(sessionId, message) {
+        const session = await this.readSession(sessionId);
+        const createdAt = nowIso();
+        session.status = 'failed';
+        session.failedAt = createdAt;
+        session.updatedAt = createdAt;
+        await this.saveSession(session);
+        await this.recordTrace(sessionId, {
+            id: (0, crypto_1.randomUUID)(),
+            sessionId,
+            level: 'error',
+            event: 'session.failed',
+            message,
+            createdAt,
+        });
+        return this.readSession(sessionId);
+    }
+}
+exports.HarnessRuntimeStateService = HarnessRuntimeStateService;
+//# sourceMappingURL=runtimeStateService.js.map

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

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

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

@@ -0,0 +1,50 @@
+/**
+ * Harness Sensor Catalog Service
+ *
+ * Bootstraps a user-editable sensor catalog under .context/harness/sensors.json
+ * and resolves the effective shell-based sensors for workflow/harness runtime.
+ */
+export type HarnessSensorCatalogSeverity = 'critical' | 'warning' | 'info';
+export interface HarnessShellSensorConfig {
+    id: string;
+    name: string;
+    description?: string;
+    severity: HarnessSensorCatalogSeverity;
+    blocking?: boolean;
+    enabled?: boolean;
+    command: string;
+    script?: string;
+}
+export interface HarnessSensorCatalogDocument {
+    version: 1;
+    generatedAt: string;
+    source: 'bootstrap' | 'manual';
+    stack?: {
+        primaryLanguage: string | null;
+        languages: string[];
+        frameworks: string[];
+        buildTools: string[];
+        testFrameworks: string[];
+        packageManager: string | null;
+    };
+    sensors: HarnessShellSensorConfig[];
+}
+export interface HarnessSensorCatalogServiceOptions {
+    repoPath: string;
+    contextPath?: string;
+}
+export declare class HarnessSensorCatalogService {
+    private readonly options;
+    constructor(options: HarnessSensorCatalogServiceOptions);
+    private get repoPath();
+    private get contextPath();
+    get configPath(): string;
+    bootstrap(force?: boolean): Promise<HarnessSensorCatalogDocument>;
+    load(): Promise<HarnessSensorCatalogDocument | null>;
+    loadSync(): HarnessSensorCatalogDocument | null;
+    resolveEffectiveSensorsSync(): HarnessShellSensorConfig[];
+    detectSensorsSync(): HarnessShellSensorConfig[];
+    private detectNodeSensors;
+    private serializeStack;
+}
+//# sourceMappingURL=sensorCatalogService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sensorCatalogService.d.ts","sourceRoot":"","sources":["../../../src/services/harness/sensorCatalogService.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,MAAM,4BAA4B,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;AAE3E,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,4BAA4B,CAAC;IACvC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,CAAC,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAC;IAC/B,KAAK,CAAC,EAAE;QACN,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;QAC/B,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,cAAc,EAAE,MAAM,EAAE,CAAC;QACzB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;KAC/B,CAAC;IACF,OAAO,EAAE,wBAAwB,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,kCAAkC;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,2BAA2B;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,kCAAkC;IAExE,OAAO,KAAK,QAAQ,GAEnB;IAED,OAAO,KAAK,WAAW,GAItB;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IAEK,SAAS,CAAC,KAAK,GAAE,OAAe,GAAG,OAAO,CAAC,4BAA4B,CAAC;IAoBxE,IAAI,IAAI,OAAO,CAAC,4BAA4B,GAAG,IAAI,CAAC;IAQ1D,QAAQ,IAAI,4BAA4B,GAAG,IAAI;IAQ/C,2BAA2B,IAAI,wBAAwB,EAAE;IAWzD,iBAAiB,IAAI,wBAAwB,EAAE;IAwJ/C,OAAO,CAAC,iBAAiB;IA8DzB,OAAO,CAAC,cAAc;CAUvB"}