@dotcontext/mcp 0.9.0

package/dist/services/harness/executionService.js

@@ -0,0 +1,213 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HarnessExecutionService = void 0;
+const runtimeStateService_1 = require("./runtimeStateService");
+const sensorsService_1 = require("./sensorsService");
+const taskContractsService_1 = require("./taskContractsService");
+const policyService_1 = require("./policyService");
+const replayService_1 = require("./replayService");
+const datasetService_1 = require("./datasetService");
+class HarnessExecutionService {
+    constructor(options) {
+        this.options = options;
+        this.state = new runtimeStateService_1.HarnessRuntimeStateService({ repoPath: options.repoPath });
+        this.sensors = new sensorsService_1.HarnessSensorsService({ stateService: this.state });
+        this.contracts = new taskContractsService_1.HarnessTaskContractsService({
+            repoPath: options.repoPath,
+            stateService: this.state,
+        });
+        this.policy = new policyService_1.HarnessPolicyService({ repoPath: options.repoPath });
+        this.replay = new replayService_1.HarnessReplayService({
+            repoPath: options.repoPath,
+            dependencies: {
+                stateService: this.state,
+                sensorsService: this.sensors,
+                contractsService: this.contracts,
+            },
+        });
+        this.datasets = new datasetService_1.HarnessDatasetService({
+            repoPath: options.repoPath,
+            dependencies: {
+                stateService: this.state,
+                replayService: this.replay,
+                taskContractsService: this.contracts,
+            },
+        });
+    }
+    createSession(input) {
+        return this.state.createSession(input);
+    }
+    listSessions() {
+        return this.state.listSessions();
+    }
+    getSession(sessionId) {
+        return this.state.getSession(sessionId);
+    }
+    appendTrace(sessionId, input) {
+        return this.state.appendTrace(sessionId, input);
+    }
+    listTraces(sessionId) {
+        return this.state.listTraces(sessionId);
+    }
+    async addArtifact(sessionId, input) {
+        await this.policy.authorize({
+            tool: 'harness',
+            action: 'addArtifact',
+            paths: input.path ? [input.path] : undefined,
+            risk: 'medium',
+            metadata: input.metadata,
+        });
+        return this.state.addArtifact(sessionId, input);
+    }
+    listArtifacts(sessionId) {
+        return this.state.listArtifacts(sessionId);
+    }
+    async checkpointSession(sessionId, input = {}) {
+        await this.policy.authorize({
+            tool: 'harness',
+            action: 'checkpoint',
+            risk: input.pause ? 'high' : 'low',
+            metadata: { note: input.note },
+        });
+        return this.state.checkpointSession(sessionId, input);
+    }
+    resumeSession(sessionId) {
+        return this.state.resumeSession(sessionId);
+    }
+    async completeSession(sessionId, note) {
+        await this.policy.authorize({
+            tool: 'harness',
+            action: 'completeSession',
+            risk: 'high',
+            metadata: note ? { note } : undefined,
+        });
+        return this.state.completeSession(sessionId, note);
+    }
+    async failSession(sessionId, message) {
+        await this.policy.authorize({
+            tool: 'harness',
+            action: 'failSession',
+            risk: 'high',
+            metadata: { message },
+        });
+        return this.state.failSession(sessionId, message);
+    }
+    async runSensor(definition, input) {
+        await this.policy.authorize({
+            tool: 'harness',
+            action: 'runSensor',
+            risk: definition.blocking ? 'high' : definition.severity === 'critical' ? 'high' : 'medium',
+            metadata: {
+                sensorId: definition.id,
+                sensorName: definition.name,
+                sessionId: input.sessionId,
+                contractId: input.contractId,
+                ...(input.metadata ?? {}),
+            },
+        });
+        this.sensors.registerSensor(definition);
+        return this.sensors.runSensor(definition.id, input);
+    }
+    getSessionSensorRuns(sessionId) {
+        return this.sensors.getSessionSensorRuns(sessionId);
+    }
+    async createTaskContract(input) {
+        await this.policy.authorize({
+            tool: 'harness',
+            action: 'createTask',
+            risk: 'medium',
+            metadata: { title: input.title },
+        });
+        return this.contracts.createTaskContract(input);
+    }
+    listTaskContracts() {
+        return this.contracts.listTaskContracts();
+    }
+    evaluateTaskCompletion(taskId, sessionId) {
+        return this.contracts.evaluateTaskCompletion(taskId, sessionId);
+    }
+    async createHandoffContract(input) {
+        await this.policy.authorize({
+            tool: 'harness',
+            action: 'createHandoff',
+            risk: 'medium',
+            metadata: { from: input.from, to: input.to },
+        });
+        return this.contracts.createHandoffContract(input);
+    }
+    listHandoffContracts() {
+        return this.contracts.listHandoffContracts();
+    }
+    listPolicies() {
+        return this.policy.listRules();
+    }
+    registerPolicy(input) {
+        const target = input.target
+            ?? (input.pathPattern ? 'path' : input.scope === 'risk' ? 'risk' : 'action');
+        const pattern = input.pattern ?? input.pathPattern ?? input.scope ?? input.description ?? input.reason ?? 'harness';
+        return this.policy.registerRule({
+            id: input.id ?? `policy-${Date.now()}`,
+            effect: input.effect,
+            target,
+            pattern,
+            approvalRole: input.approvalRole,
+            reason: input.reason ?? input.description,
+        });
+    }
+    getPolicy() {
+        return this.policy.loadPolicy();
+    }
+    setPolicy(input) {
+        const policy = {
+            version: 1,
+            defaultEffect: input.defaultEffect ?? 'allow',
+            rules: input.rules ?? [],
+        };
+        return this.policy.setPolicy(policy);
+    }
+    async resetPolicy() {
+        return this.policy.setPolicy(await this.policy.createBootstrapPolicy());
+    }
+    evaluatePolicy(input) {
+        return this.policy.evaluate(input);
+    }
+    replaySession(sessionId) {
+        return this.replay.replaySession(sessionId);
+    }
+    listReplays(sessionId) {
+        return this.replay.listReplays(sessionId ? { sessionId } : undefined);
+    }
+    exportFailureDataset(sessionIds) {
+        return this.datasets.buildFailureDataset({
+            sessionIds,
+            includeSuccessfulSessions: true,
+        });
+    }
+    listDatasets() {
+        return this.datasets.listDatasets();
+    }
+    getDataset(datasetId) {
+        return this.datasets.getDataset(datasetId);
+    }
+    getFailureClusters(datasetId) {
+        return this.datasets.getFailureClusters(datasetId);
+    }
+    async getSessionQuality(sessionId, options = {}) {
+        const [session, sensorRuns, taskEvaluation] = await Promise.all([
+            this.state.getSession(sessionId),
+            this.sensors.getSessionSensorRuns(sessionId),
+            options.taskId
+                ? this.contracts.evaluateTaskCompletion(options.taskId, sessionId)
+                : Promise.resolve(null),
+        ]);
+        const backpressure = this.sensors.evaluateBackpressure(sensorRuns, options.policy);
+        return {
+            session,
+            sensorRuns,
+            backpressure,
+            taskEvaluation,
+        };
+    }
+}
+exports.HarnessExecutionService = HarnessExecutionService;
+//# sourceMappingURL=executionService.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"executionService.js","sourceRoot":"","sources":["../../../src/services/harness/executionService.ts"],"names":[],"mappings":";;;AAAA,+DAO+B;AAC/B,qDAO0B;AAC1B,iEAIgC;AAChC,mDAUyB;AACzB,mDAAiF;AACjF,qDAAiH;AAajH,MAAa,uBAAuB;IAQlC,YAA6B,OAAuC;QAAvC,YAAO,GAAP,OAAO,CAAgC;QAClE,IAAI,CAAC,KAAK,GAAG,IAAI,gDAA0B,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC5E,IAAI,CAAC,OAAO,GAAG,IAAI,sCAAqB,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QACvE,IAAI,CAAC,SAAS,GAAG,IAAI,kDAA2B,CAAC;YAC/C,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,YAAY,EAAE,IAAI,CAAC,KAAK;SACzB,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,GAAG,IAAI,oCAAoB,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;QACvE,IAAI,CAAC,MAAM,GAAG,IAAI,oCAAoB,CAAC;YACrC,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,YAAY,EAAE;gBACZ,YAAY,EAAE,IAAI,CAAC,KAAK;gBACxB,cAAc,EAAE,IAAI,CAAC,OAAO;gBAC5B,gBAAgB,EAAE,IAAI,CAAC,SAAS;aACjC;SACF,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,GAAG,IAAI,sCAAqB,CAAC;YACxC,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,YAAY,EAAE;gBACZ,YAAY,EAAE,IAAI,CAAC,KAAK;gBACxB,aAAa,EAAE,IAAI,CAAC,MAAM;gBAC1B,oBAAoB,EAAE,IAAI,CAAC,SAAS;aACrC;SACF,CAAC,CAAC;IACL,CAAC;IAED,aAAa,CAAC,KAAyB;QACrC,OAAO,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;IAED,YAAY;QACV,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;IACnC,CAAC;IAED,UAAU,CAAC,SAAiB;QAC1B,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IAC1C,CAAC;IAED,WAAW,CAAC,SAAiB,EAAE,KAAuB;QACpD,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAClD,CAAC;IAED,UAAU,CAAC,SAAiB;QAC1B,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,SAAiB,EAAE,KAAuB;QAC1D,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;YAC1B,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,aAAa;YACrB,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;YAC5C,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,KAAK,CAAC,QAAQ;SACzB,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAClD,CAAC;IAED,aAAa,CAAC,SAAiB;QAC7B,OAAO,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,SAAiB,EAAE,QAAyB,EAAE;QACpE,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;YAC1B,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,YAAY;YACpB,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK;YAClC,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE;SAC/B,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACxD,CAAC;IAED,aAAa,CAAC,SAAiB;QAC7B,OAAO,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,SAAiB,EAAE,IAAa;QACpD,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;YAC1B,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,iBAAiB;YACzB,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS;SACtC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,SAAiB,EAAE,OAAe;QAClD,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;YAC1B,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,aAAa;YACrB,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE,EAAE,OAAO,EAAE;SACtB,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,SAAS,CACb,UAAmC,EACnC,KAAkC;QAElC,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;YAC1B,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,WAAW;YACnB,IAAI,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ;YAC3F,QAAQ,EAAE;gBACR,QAAQ,EAAE,UAAU,CAAC,EAAE;gBACvB,UAAU,EAAE,UAAU,CAAC,IAAI;gBAC3B,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,GAAG,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;aAC1B;SACF,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IACtD,CAAC;IAED,oBAAoB,CAAC,SAAiB;QACpC,OAAO,IAAI,CAAC,OAAO,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,KAAuE;QAC9F,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;YAC1B,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,YAAY;YACpB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE;SACjC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAClD,CAAC;IAED,iBAAiB;QACf,OAAO,IAAI,CAAC,SAAS,CAAC,iBAAiB,EAAE,CAAC;IAC5C,CAAC;IAED,sBAAsB,CAAC,MAAc,EAAE,SAAkB;QACvD,OAAO,IAAI,CAAC,SAAS,CAAC,sBAAsB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,qBAAqB,CAAC,KAA0E;QACpG,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;YAC1B,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,eAAe;YACvB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE;SAC7C,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC;IACrD,CAAC;IAED,oBAAoB;QAClB,OAAO,IAAI,CAAC,SAAS,CAAC,oBAAoB,EAAE,CAAC;IAC/C,CAAC;IAED,YAAY;QACV,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;IACjC,CAAC;IAED,cAAc,CAAC,KAWd;QACC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM;eACtB,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QAC/E,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,MAAM,IAAI,SAAS,CAAC;QACpH,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC;YAC9B,EAAE,EAAE,KAAK,CAAC,EAAE,IAAI,UAAU,IAAI,CAAC,GAAG,EAAE,EAAE;YACtC,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,MAAM;YACN,OAAO;YACP,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,WAAW;SACH,CAAC,CAAC;IAC5C,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;IAClC,CAAC;IAED,SAAS,CAAC,KAGT;QACC,MAAM,MAAM,GAA0B;YACpC,OAAO,EAAE,CAAC;YACV,aAAa,EAAE,KAAK,CAAC,aAAa,IAAI,OAAO;YAC7C,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,EAAE;SACzB,CAAC;QACF,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,WAAW;QACf,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED,cAAc,CAAC,KAAmC;QAChD,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;IAED,aAAa,CAAC,SAAiB;QAC7B,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;IAC9C,CAAC;IAED,WAAW,CAAC,SAAkB;QAC5B,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACxE,CAAC;IAED,oBAAoB,CAAC,UAAqB;QACxC,OAAO,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAC;YACvC,UAAU;YACV,yBAAyB,EAAE,IAAI;SAChC,CAAC,CAAC;IACL,CAAC;IAED,YAAY;QACV,OAAO,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC;IACtC,CAAC;IAED,UAAU,CAAC,SAAiB;QAC1B,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IAC7C,CAAC;IAED,kBAAkB,CAAC,SAAiB;QAClC,OAAO,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,iBAAiB,CACrB,SAAiB,EACjB,UAGI,EAAE;QAEN,MAAM,CAAC,OAAO,EAAE,UAAU,EAAE,cAAc,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC9D,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC;YAChC,IAAI,CAAC,OAAO,CAAC,oBAAoB,CAAC,SAAS,CAAC;YAC5C,OAAO,CAAC,MAAM;gBACZ,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,sBAAsB,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC;gBAClE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;SAC1B,CAAC,CAAC;QAEH,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,oBAAoB,CAAC,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACnF,OAAO;YACL,OAAO;YACP,UAAU;YACV,YAAY;YACZ,cAAc;SACf,CAAC;IACJ,CAAC;CACF;AAtQD,0DAsQC"}

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

@@ -0,0 +1,21 @@
+/**
+ * Harness service exports.
+ *
+ * These services hold transport-agnostic harness logic that can be consumed
+ * by MCP, CLI, or future adapters.
+ */
+export { HarnessAgentsService, type HarnessAgentsServiceOptions } from './agentsService';
+export { HarnessPlansService, type HarnessPlansServiceOptions } from './plansService';
+export { HarnessContextService, type HarnessContextServiceOptions, type HarnessContextInitResult, type HarnessContextPlanScaffoldResult, type HarnessBootstrapStatusResult, } from './contextService';
+export { readFileTool, listFilesTool, analyzeSymbolsTool, getFileStructureTool, searchCodeTool, checkScaffoldingTool, initializeContextTool, scaffoldPlanTool, fillScaffoldingTool, listFilesToFillTool, fillSingleFileTool, getCodebaseMapTool, getOrBuildContext, cleanupSharedContext, type ToolName, } from './contextTools';
+export { HarnessSkillsService, type HarnessSkillsServiceOptions } from './skillsService';
+export { HarnessRuntimeStateService, type HarnessRuntimeStateServiceOptions, type HarnessSessionStatus, type HarnessTraceLevel, type HarnessArtifactKind, type HarnessSessionRecord, type HarnessSessionCheckpoint, type HarnessTraceRecord, type HarnessArtifactRecord, type HarnessRuntimeStatePort, type CreateSessionInput, type AppendTraceInput, type AddArtifactInput, type CheckpointInput, } from './runtimeStateService';
+export { HarnessSensorsService, type HarnessSensorsServiceOptions, type HarnessSensorSeverity, type HarnessSensorStatus, type HarnessSensorExecutionInput, type HarnessSensorExecutionResult, type HarnessSensorDefinition, type HarnessSensorRun, type HarnessBackpressurePolicy, type HarnessBackpressureResult, } from './sensorsService';
+export { HarnessSensorCatalogService, type HarnessSensorCatalogServiceOptions, type HarnessShellSensorConfig, type HarnessSensorCatalogDocument, type HarnessSensorCatalogSeverity, } from './sensorCatalogService';
+export { HarnessTaskContractsService, type HarnessTaskContractsServiceOptions, type HarnessTaskContractStatus, type HarnessTaskContract, type HarnessHandoffContract, type HarnessTaskCompletionResult, } from './taskContractsService';
+export { HarnessExecutionService, type HarnessExecutionServiceOptions, type HarnessSessionQualitySnapshot, } from './executionService';
+export { HarnessReplayService, type HarnessReplayServiceOptions, type HarnessReplayDependencies, type HarnessReplayEvent, type HarnessReplayEventSource, type HarnessReplayRecord, type ReplaySessionOptions, } from './replayService';
+export { HarnessDatasetService, type HarnessDatasetServiceOptions, type HarnessDatasetDependencies, type BuildHarnessDatasetOptions, type HarnessFailureKind, type HarnessFailureRecord, type HarnessFailureCluster, type HarnessFailureDataset, } from './datasetService';
+export { HarnessPolicyService, HarnessPolicyBlockedError, type HarnessPolicyServiceOptions, type HarnessPolicyTarget, type HarnessPolicyScope, type HarnessPolicyEffect, type HarnessPolicyRisk, type HarnessPolicyRule, type CreateHarnessPolicyRuleInput, type HarnessPolicyEvaluationInput, type HarnessPolicyEvaluationResult, } from './policyService';
+export { HarnessWorkflowStateService, type HarnessWorkflowStateServiceOptions, type HarnessWorkflowRecord, type WorkflowHarnessBinding, } from './workflowStateService';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/services/harness/index.js

@@ -0,0 +1,52 @@
+"use strict";
+/**
+ * Harness service exports.
+ *
+ * These services hold transport-agnostic harness logic that can be consumed
+ * by MCP, CLI, or future adapters.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HarnessWorkflowStateService = exports.HarnessPolicyBlockedError = exports.HarnessPolicyService = exports.HarnessDatasetService = exports.HarnessReplayService = exports.HarnessExecutionService = exports.HarnessTaskContractsService = exports.HarnessSensorCatalogService = exports.HarnessSensorsService = exports.HarnessRuntimeStateService = exports.HarnessSkillsService = exports.cleanupSharedContext = exports.getOrBuildContext = exports.getCodebaseMapTool = exports.fillSingleFileTool = exports.listFilesToFillTool = exports.fillScaffoldingTool = exports.scaffoldPlanTool = exports.initializeContextTool = exports.checkScaffoldingTool = exports.searchCodeTool = exports.getFileStructureTool = exports.analyzeSymbolsTool = exports.listFilesTool = exports.readFileTool = exports.HarnessContextService = exports.HarnessPlansService = exports.HarnessAgentsService = void 0;
+var agentsService_1 = require("./agentsService");
+Object.defineProperty(exports, "HarnessAgentsService", { enumerable: true, get: function () { return agentsService_1.HarnessAgentsService; } });
+var plansService_1 = require("./plansService");
+Object.defineProperty(exports, "HarnessPlansService", { enumerable: true, get: function () { return plansService_1.HarnessPlansService; } });
+var contextService_1 = require("./contextService");
+Object.defineProperty(exports, "HarnessContextService", { enumerable: true, get: function () { return contextService_1.HarnessContextService; } });
+var contextTools_1 = require("./contextTools");
+Object.defineProperty(exports, "readFileTool", { enumerable: true, get: function () { return contextTools_1.readFileTool; } });
+Object.defineProperty(exports, "listFilesTool", { enumerable: true, get: function () { return contextTools_1.listFilesTool; } });
+Object.defineProperty(exports, "analyzeSymbolsTool", { enumerable: true, get: function () { return contextTools_1.analyzeSymbolsTool; } });
+Object.defineProperty(exports, "getFileStructureTool", { enumerable: true, get: function () { return contextTools_1.getFileStructureTool; } });
+Object.defineProperty(exports, "searchCodeTool", { enumerable: true, get: function () { return contextTools_1.searchCodeTool; } });
+Object.defineProperty(exports, "checkScaffoldingTool", { enumerable: true, get: function () { return contextTools_1.checkScaffoldingTool; } });
+Object.defineProperty(exports, "initializeContextTool", { enumerable: true, get: function () { return contextTools_1.initializeContextTool; } });
+Object.defineProperty(exports, "scaffoldPlanTool", { enumerable: true, get: function () { return contextTools_1.scaffoldPlanTool; } });
+Object.defineProperty(exports, "fillScaffoldingTool", { enumerable: true, get: function () { return contextTools_1.fillScaffoldingTool; } });
+Object.defineProperty(exports, "listFilesToFillTool", { enumerable: true, get: function () { return contextTools_1.listFilesToFillTool; } });
+Object.defineProperty(exports, "fillSingleFileTool", { enumerable: true, get: function () { return contextTools_1.fillSingleFileTool; } });
+Object.defineProperty(exports, "getCodebaseMapTool", { enumerable: true, get: function () { return contextTools_1.getCodebaseMapTool; } });
+Object.defineProperty(exports, "getOrBuildContext", { enumerable: true, get: function () { return contextTools_1.getOrBuildContext; } });
+Object.defineProperty(exports, "cleanupSharedContext", { enumerable: true, get: function () { return contextTools_1.cleanupSharedContext; } });
+var skillsService_1 = require("./skillsService");
+Object.defineProperty(exports, "HarnessSkillsService", { enumerable: true, get: function () { return skillsService_1.HarnessSkillsService; } });
+var runtimeStateService_1 = require("./runtimeStateService");
+Object.defineProperty(exports, "HarnessRuntimeStateService", { enumerable: true, get: function () { return runtimeStateService_1.HarnessRuntimeStateService; } });
+var sensorsService_1 = require("./sensorsService");
+Object.defineProperty(exports, "HarnessSensorsService", { enumerable: true, get: function () { return sensorsService_1.HarnessSensorsService; } });
+var sensorCatalogService_1 = require("./sensorCatalogService");
+Object.defineProperty(exports, "HarnessSensorCatalogService", { enumerable: true, get: function () { return sensorCatalogService_1.HarnessSensorCatalogService; } });
+var taskContractsService_1 = require("./taskContractsService");
+Object.defineProperty(exports, "HarnessTaskContractsService", { enumerable: true, get: function () { return taskContractsService_1.HarnessTaskContractsService; } });
+var executionService_1 = require("./executionService");
+Object.defineProperty(exports, "HarnessExecutionService", { enumerable: true, get: function () { return executionService_1.HarnessExecutionService; } });
+var replayService_1 = require("./replayService");
+Object.defineProperty(exports, "HarnessReplayService", { enumerable: true, get: function () { return replayService_1.HarnessReplayService; } });
+var datasetService_1 = require("./datasetService");
+Object.defineProperty(exports, "HarnessDatasetService", { enumerable: true, get: function () { return datasetService_1.HarnessDatasetService; } });
+var policyService_1 = require("./policyService");
+Object.defineProperty(exports, "HarnessPolicyService", { enumerable: true, get: function () { return policyService_1.HarnessPolicyService; } });
+Object.defineProperty(exports, "HarnessPolicyBlockedError", { enumerable: true, get: function () { return policyService_1.HarnessPolicyBlockedError; } });
+var workflowStateService_1 = require("./workflowStateService");
+Object.defineProperty(exports, "HarnessWorkflowStateService", { enumerable: true, get: function () { return workflowStateService_1.HarnessWorkflowStateService; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/harness/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,iDAAyF;AAAhF,qHAAA,oBAAoB,OAAA;AAC7B,+CAAsF;AAA7E,mHAAA,mBAAmB,OAAA;AAC5B,mDAM0B;AALxB,uHAAA,qBAAqB,OAAA;AAMvB,+CAgBwB;AAftB,4GAAA,YAAY,OAAA;AACZ,6GAAA,aAAa,OAAA;AACb,kHAAA,kBAAkB,OAAA;AAClB,oHAAA,oBAAoB,OAAA;AACpB,8GAAA,cAAc,OAAA;AACd,oHAAA,oBAAoB,OAAA;AACpB,qHAAA,qBAAqB,OAAA;AACrB,gHAAA,gBAAgB,OAAA;AAChB,mHAAA,mBAAmB,OAAA;AACnB,mHAAA,mBAAmB,OAAA;AACnB,kHAAA,kBAAkB,OAAA;AAClB,kHAAA,kBAAkB,OAAA;AAClB,iHAAA,iBAAiB,OAAA;AACjB,oHAAA,oBAAoB,OAAA;AAGtB,iDAAyF;AAAhF,qHAAA,oBAAoB,OAAA;AAC7B,6DAe+B;AAd7B,iIAAA,0BAA0B,OAAA;AAe5B,mDAW0B;AAVxB,uHAAA,qBAAqB,OAAA;AAWvB,+DAMgC;AAL9B,mIAAA,2BAA2B,OAAA;AAM7B,+DAOgC;AAN9B,mIAAA,2BAA2B,OAAA;AAO7B,uDAI4B;AAH1B,2HAAA,uBAAuB,OAAA;AAIzB,iDAQyB;AAPvB,qHAAA,oBAAoB,OAAA;AAQtB,mDAS0B;AARxB,uHAAA,qBAAqB,OAAA;AASvB,iDAYyB;AAXvB,qHAAA,oBAAoB,OAAA;AACpB,0HAAA,yBAAyB,OAAA;AAW3B,+DAKgC;AAJ9B,mIAAA,2BAA2B,OAAA"}

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

@@ -0,0 +1,45 @@
+/**
+ * Harness Plans Service
+ *
+ * Transport-agnostic plan management and execution tracking logic.
+ */
+import { type PrevcPhase } from '../../workflow';
+export interface HarnessPlansServiceOptions {
+    repoPath: string;
+}
+export declare class HarnessPlansService {
+    private readonly options;
+    private readonly linker;
+    constructor(options: HarnessPlansServiceOptions);
+    private get repoPath();
+    link(planSlug: string): Promise<Record<string, unknown>>;
+    getLinked(): Promise<Record<string, unknown>>;
+    getDetails(planSlug: string): Promise<Record<string, unknown>>;
+    getForPhase(phase: PrevcPhase): Promise<Record<string, unknown>>;
+    updatePhase(planSlug: string, phaseId: string, status: 'pending' | 'in_progress' | 'completed' | 'skipped'): Promise<Record<string, unknown>>;
+    recordDecision(params: {
+        planSlug: string;
+        title: string;
+        description: string;
+        phase?: PrevcPhase;
+        alternatives?: string[];
+    }): Promise<Record<string, unknown>>;
+    updateStep(params: {
+        planSlug: string;
+        phaseId: string;
+        stepIndex: number;
+        status: 'pending' | 'in_progress' | 'completed' | 'skipped';
+        output?: string;
+        notes?: string;
+    }): Promise<Record<string, unknown>>;
+    getStatus(planSlug: string): Promise<Record<string, unknown>>;
+    syncMarkdown(planSlug: string): Promise<Record<string, unknown>>;
+    commitPhase(params: {
+        planSlug: string;
+        phaseId: string;
+        coAuthor?: string;
+        stagePatterns?: string[];
+        dryRun?: boolean;
+    }): Promise<Record<string, unknown>>;
+}
+//# sourceMappingURL=plansService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plansService.d.ts","sourceRoot":"","sources":["../../../src/services/harness/plansService.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAIL,KAAK,UAAU,EAChB,MAAM,gBAAgB,CAAC;AAGxB,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,mBAAmB;IAGlB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAEK,OAAO,EAAE,0BAA0B;IAMhE,OAAO,KAAK,QAAQ,GAEnB;IAEK,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAiExD,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAK7C,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAsB9D,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAkBhE,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAK7I,cAAc,CAAC,MAAM,EAAE;QAC3B,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,UAAU,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;KACzB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAY9B,UAAU,CAAC,MAAM,EAAE;QACvB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,SAAS,CAAC;QAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAkB9B,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAa7D,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAUhE,WAAW,CAAC,MAAM,EAAE;QACxB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;QACzB,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CA8DrC"}

package/dist/services/harness/plansService.js

@@ -0,0 +1,251 @@
+"use strict";
+/**
+ * Harness Plans Service
+ *
+ * Transport-agnostic plan management and execution tracking logic.
+ */
+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.HarnessPlansService = void 0;
+const path = __importStar(require("path"));
+const workflow_1 = require("../workflow");
+const workflow_2 = require("../../workflow");
+const gitService_1 = require("../../utils/gitService");
+class HarnessPlansService {
+    constructor(options) {
+        this.options = options;
+        const contextPath = path.join(this.repoPath, '.context');
+        const statusManager = new workflow_2.PrevcStatusManager(contextPath);
+        this.linker = (0, workflow_2.createPlanLinker)(this.repoPath, statusManager, true);
+    }
+    get repoPath() {
+        return this.options.repoPath;
+    }
+    async link(planSlug) {
+        const ref = await this.linker.linkPlan(planSlug);
+        if (!ref) {
+            return {
+                success: false,
+                error: `Plan not found: ${planSlug}`,
+            };
+        }
+        const service = new workflow_1.WorkflowService(this.repoPath);
+        const workflowActive = await service.hasWorkflow();
+        if (workflowActive) {
+            await service.markPlanCreated(planSlug);
+        }
+        let canAdvanceToReview = false;
+        if (workflowActive) {
+            const gateResult = await service.checkGates();
+            canAdvanceToReview = gateResult.gates.plan_required.passed;
+        }
+        const workflowStatePath = path.join(this.repoPath, '.context', 'harness', 'workflows', 'prevc.json');
+        const enhancementPrompt = workflowActive
+            ? `PLAN LINKED TO ACTIVE WORKFLOW
+
+The linked plan is now attached to the harness-backed PREVC workflow.
+
+Next:
+1. Use workflow-status() to confirm the active phase and harness binding
+2. Continue planning work
+3. Use workflow-advance() when the planning phase is complete`
+            : `PLAN LINKED - WORKFLOW NOT STARTED
+
+The plan reference was created, but no PREVC workflow is active yet.
+Until workflow-init runs, the harness does not have canonical workflow state and plan gates are not armed.
+
+Next:
+1. Call workflow-init({ name: "${planSlug}" }) to create the harness-backed PREVC workflow
+2. Call plan({ action: "link", planSlug: "${planSlug}" }) again after workflow-init
+3. Use workflow-status() to verify the plan is bound to the harness workflow`;
+        const nextSteps = workflowActive
+            ? [
+                'RECOMMENDED: Call workflow-status() to confirm the linked plan and harness binding',
+                'THEN: Continue planning and call workflow-advance() when ready to leave phase P',
+            ]
+            : [
+                `REQUIRED: Call workflow-init({ name: "${planSlug}" }) to start the harness-backed PREVC workflow`,
+                `REQUIRED: Call plan({ action: "link", planSlug: "${planSlug}" }) again after workflow-init so gates see the plan`,
+                'THEN: Call workflow-status() to confirm the workflow and harness binding are active',
+            ];
+        return {
+            success: true,
+            plan: ref,
+            workflowActive,
+            workflowStatePath,
+            planCreatedForGates: workflowActive,
+            canAdvanceToReview,
+            enhancementPrompt,
+            nextSteps,
+        };
+    }
+    async getLinked() {
+        const plans = await this.linker.getLinkedPlans();
+        return { success: true, plans };
+    }
+    async getDetails(planSlug) {
+        const plan = await this.linker.getLinkedPlan(planSlug);
+        if (!plan) {
+            return {
+                success: false,
+                error: `Plan not found or not linked: ${planSlug}`,
+            };
+        }
+        return {
+            success: true,
+            plan: {
+                ...plan,
+                phasesWithPrevc: plan.phases.map(p => ({
+                    ...p,
+                    prevcPhaseName: workflow_2.PHASE_NAMES_EN[p.prevcPhase],
+                })),
+            },
+        };
+    }
+    async getForPhase(phase) {
+        const plans = await this.linker.getPlansForPhase(phase);
+        return {
+            success: true,
+            phase,
+            phaseName: workflow_2.PHASE_NAMES_EN[phase],
+            plans: plans.map(p => ({
+                slug: p.ref.slug,
+                title: p.ref.title,
+                phasesInThisPrevc: p.phases
+                    .filter(ph => ph.prevcPhase === phase)
+                    .map(ph => ({ id: ph.id, name: ph.name, status: ph.status })),
+                hasPendingWork: this.linker.hasPendingWorkForPhase(p, phase),
+            })),
+        };
+    }
+    async updatePhase(planSlug, phaseId, status) {
+        const success = await this.linker.updatePlanPhase(planSlug, phaseId, status);
+        return { success, planSlug, phaseId, status };
+    }
+    async recordDecision(params) {
+        const decision = await this.linker.recordDecision(params.planSlug, {
+            title: params.title,
+            description: params.description,
+            phase: params.phase,
+            alternatives: params.alternatives,
+            status: 'accepted',
+        });
+        return { success: true, decision };
+    }
+    async updateStep(params) {
+        const success = await this.linker.updatePlanStep(params.planSlug, params.phaseId, params.stepIndex, params.status, { output: params.output, notes: params.notes });
+        return {
+            success,
+            planSlug: params.planSlug,
+            phaseId: params.phaseId,
+            stepIndex: params.stepIndex,
+            status: params.status,
+        };
+    }
+    async getStatus(planSlug) {
+        const status = await this.linker.getPlanExecutionStatus(planSlug);
+        if (!status) {
+            return {
+                success: false,
+                error: 'Plan tracking not found. The plan may not have any execution data yet.',
+            };
+        }
+        return { success: true, ...status };
+    }
+    async syncMarkdown(planSlug) {
+        const success = await this.linker.syncPlanMarkdown(planSlug);
+        return {
+            success,
+            planSlug,
+            message: success ? 'Plan markdown synced successfully' : 'Failed to sync - plan or tracking not found',
+        };
+    }
+    async commitPhase(params) {
+        const plan = await this.linker.getLinkedPlan(params.planSlug);
+        if (!plan) {
+            return { success: false, error: `Plan not found: ${params.planSlug}` };
+        }
+        const phase = plan.phases.find(p => p.id === params.phaseId);
+        if (!phase) {
+            return { success: false, error: `Phase not found: ${params.phaseId}` };
+        }
+        const commitMessage = phase.commitCheckpoint ||
+            `chore(plan): complete ${phase.name} for ${params.planSlug}`;
+        const stagePatterns = params.stagePatterns || ['.context/**'];
+        const gitService = new gitService_1.GitService(this.repoPath);
+        if (!gitService.isGitRepository()) {
+            return { success: false, error: 'Not a git repository' };
+        }
+        if (params.dryRun) {
+            const stagedFiles = gitService.stageFiles(stagePatterns);
+            return {
+                success: true,
+                dryRun: true,
+                planSlug: params.planSlug,
+                phaseId: params.phaseId,
+                commitMessage,
+                coAuthor: params.coAuthor,
+                filesWouldBeCommitted: stagedFiles,
+            };
+        }
+        const stagedFiles = gitService.stageFiles(stagePatterns);
+        if (stagedFiles.length === 0) {
+            return {
+                success: false,
+                error: 'Nothing to commit: no files match the stage patterns or all files are already committed',
+            };
+        }
+        const commitResult = gitService.commit(commitMessage, params.coAuthor);
+        await this.linker.recordPhaseCommit(params.planSlug, params.phaseId, {
+            hash: commitResult.hash,
+            shortHash: commitResult.shortHash,
+            committedBy: params.coAuthor,
+        });
+        return {
+            success: true,
+            planSlug: params.planSlug,
+            phaseId: params.phaseId,
+            commit: {
+                hash: commitResult.hash,
+                shortHash: commitResult.shortHash,
+                message: commitMessage,
+                filesCommitted: commitResult.filesCommitted,
+                coAuthor: params.coAuthor,
+            },
+        };
+    }
+}
+exports.HarnessPlansService = HarnessPlansService;
+//# sourceMappingURL=plansService.js.map

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

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