@pickle-pee/runtime 0.0.0

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+export { bridgePiMonoEvent, createInitialBridgeState, type PiMonoBridgeResult, type PiMonoBridgeState, PiMonoSessionAdapter, type PiMonoSessionAdapterOptions, } from "./adapters/index.js";
+export type { KernelSessionAdapter, RawUpstreamEvent } from "./adapters/kernel-session-adapter.js";
+export type { AppRuntime, AppRuntimeConfig } from "./create-app-runtime.js";
+export { createAppRuntime } from "./create-app-runtime.js";
+export type { EventBus, EventListener, Unsubscribe } from "./events/event-bus.js";
+export { createEventBus } from "./events/event-bus.js";
+export type { BaseEvent, CompactionCompletedEvent, CompactionEvent, CompactionStartedEvent, PermissionDecisionEvent, PermissionRequestedEvent, PermissionResolvedEvent, PlanCompletedEvent, PlanCreatedEvent, PlanProgressEvent, PlanReworkEvent, PlanStepCompletedEvent, PlanStepFailedEvent, PlanStepStartedEvent, RuntimeEvent, SessionClosedEvent, SessionClosingEvent, SessionCreatedEvent, SessionLifecycleEvent, SessionResumedEvent, SessionSuspendedEvent, TextDeltaEvent, TextStreamEvent, ThinkingDeltaEvent, ToolCompletedEvent, ToolDeniedEvent, ToolExecutionEvent, ToolStartedEvent, ToolUpdateEvent, } from "./events/runtime-event.js";
+export type { GovernorDecision, ToolExecutionContext, ToolExecutionResult, ToolGovernor, } from "./governance/tool-governor.js";
+export { createToolGovernor } from "./governance/tool-governor.js";
+export type { Plan, PlanEngine } from "./planning/plan-engine.js";
+export { createPlanEngine } from "./planning/plan-engine.js";
+export { planCompleted, planCreated, planRework, planStepCompleted, planStepFailed, planStepStarted, } from "./planning/plan-events.js";
+export type { PlanOrchestrator } from "./planning/plan-orchestrator.js";
+export { createPlanOrchestrator } from "./planning/plan-orchestrator.js";
+export type { PlanOutcomeReason, PlanStatus, PlanStep, PlanStepDetail, PlanStepStatus, PlanSummary, } from "./planning/plan-types.js";
+export type { RuntimeContextParams } from "./runtime-context.js";
+export { createRuntimeContext, updateTaskState } from "./runtime-context.js";
+export { EventNormalizer } from "./services/event-normalizer.js";
+export { generateEventId, sessionClosed, sessionCreated, sessionResumed } from "./session/session-events.js";
+export type { SessionFacade } from "./session/session-facade.js";
+export { SessionFacadeImpl } from "./session/session-facade.js";
+export { createInitialSessionState, recoverSessionState, serializeForRecovery, updateCompactionSummary, updatePlanSummary, updateSessionStatus, updateTaskState as updateSessionTaskState, } from "./session/session-state.js";
+export { aggregateResults, decideRework } from "./subagent/aggregation.js";
+export { isPathAllowed, isPathForbidden, scopesOverlap, wouldViolateBoundary } from "./subagent/path-scope.js";
+export type { AggregationResult, ReworkDecision, SubagentResult, SubagentResultStatus, SubagentRuntimeSnapshot, TaskRisk, VerificationResult, } from "./subagent/result-types.js";
+export type { SubagentRuntimeState } from "./subagent/stop-condition.js";
+export { createInitialRuntimeState, evaluateStopConditions, recordBoundaryViolation, recordError, recordModification, updateElapsedTime, } from "./subagent/stop-condition.js";
+export type { PathScope, StopCondition, StopConditionType, SubagentTask, TaskInputs, Verification, VerificationType, } from "./subagent/task-types.js";
+export type { ValidationResult } from "./subagent/task-validator.js";
+export { hasConsistentScope, hasRequiredFields, validateTask } from "./subagent/task-validator.js";
+export type { VerificationEvaluation } from "./subagent/verification.js";
+export { evaluateVerifications, isVerificationTrustworthy } from "./subagent/verification.js";
+export type { CliMode, CompactionSummary, ModelDescriptor, RuntimeContext, SessionId, SessionRecoveryData, SessionState, SessionStatus, TaskState, TaskStatus, ToolSetDescriptor, } from "./types/index.js";

package/dist/index.js

@@ -0,0 +1,76 @@
+"use strict";
+// Runtime — the shared product-layer runtime.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isVerificationTrustworthy = exports.evaluateVerifications = exports.validateTask = exports.hasRequiredFields = exports.hasConsistentScope = exports.updateElapsedTime = exports.recordModification = exports.recordError = exports.recordBoundaryViolation = exports.evaluateStopConditions = exports.createInitialRuntimeState = exports.wouldViolateBoundary = exports.scopesOverlap = exports.isPathForbidden = exports.isPathAllowed = exports.decideRework = exports.aggregateResults = exports.updateSessionTaskState = exports.updateSessionStatus = exports.updatePlanSummary = exports.updateCompactionSummary = exports.serializeForRecovery = exports.recoverSessionState = exports.createInitialSessionState = exports.SessionFacadeImpl = exports.sessionResumed = exports.sessionCreated = exports.sessionClosed = exports.generateEventId = exports.EventNormalizer = exports.updateTaskState = exports.createRuntimeContext = exports.createPlanOrchestrator = exports.planStepStarted = exports.planStepFailed = exports.planStepCompleted = exports.planRework = exports.planCreated = exports.planCompleted = exports.createPlanEngine = exports.createToolGovernor = exports.createEventBus = exports.createAppRuntime = exports.PiMonoSessionAdapter = exports.createInitialBridgeState = exports.bridgePiMonoEvent = void 0;
+var index_js_1 = require("./adapters/index.js");
+Object.defineProperty(exports, "bridgePiMonoEvent", { enumerable: true, get: function () { return index_js_1.bridgePiMonoEvent; } });
+Object.defineProperty(exports, "createInitialBridgeState", { enumerable: true, get: function () { return index_js_1.createInitialBridgeState; } });
+Object.defineProperty(exports, "PiMonoSessionAdapter", { enumerable: true, get: function () { return index_js_1.PiMonoSessionAdapter; } });
+// Entry point
+var create_app_runtime_js_1 = require("./create-app-runtime.js");
+Object.defineProperty(exports, "createAppRuntime", { enumerable: true, get: function () { return create_app_runtime_js_1.createAppRuntime; } });
+// Events
+var event_bus_js_1 = require("./events/event-bus.js");
+Object.defineProperty(exports, "createEventBus", { enumerable: true, get: function () { return event_bus_js_1.createEventBus; } });
+// Governance
+var tool_governor_js_1 = require("./governance/tool-governor.js");
+Object.defineProperty(exports, "createToolGovernor", { enumerable: true, get: function () { return tool_governor_js_1.createToolGovernor; } });
+// Planning
+var plan_engine_js_1 = require("./planning/plan-engine.js");
+Object.defineProperty(exports, "createPlanEngine", { enumerable: true, get: function () { return plan_engine_js_1.createPlanEngine; } });
+var plan_events_js_1 = require("./planning/plan-events.js");
+Object.defineProperty(exports, "planCompleted", { enumerable: true, get: function () { return plan_events_js_1.planCompleted; } });
+Object.defineProperty(exports, "planCreated", { enumerable: true, get: function () { return plan_events_js_1.planCreated; } });
+Object.defineProperty(exports, "planRework", { enumerable: true, get: function () { return plan_events_js_1.planRework; } });
+Object.defineProperty(exports, "planStepCompleted", { enumerable: true, get: function () { return plan_events_js_1.planStepCompleted; } });
+Object.defineProperty(exports, "planStepFailed", { enumerable: true, get: function () { return plan_events_js_1.planStepFailed; } });
+Object.defineProperty(exports, "planStepStarted", { enumerable: true, get: function () { return plan_events_js_1.planStepStarted; } });
+var plan_orchestrator_js_1 = require("./planning/plan-orchestrator.js");
+Object.defineProperty(exports, "createPlanOrchestrator", { enumerable: true, get: function () { return plan_orchestrator_js_1.createPlanOrchestrator; } });
+var runtime_context_js_1 = require("./runtime-context.js");
+Object.defineProperty(exports, "createRuntimeContext", { enumerable: true, get: function () { return runtime_context_js_1.createRuntimeContext; } });
+Object.defineProperty(exports, "updateTaskState", { enumerable: true, get: function () { return runtime_context_js_1.updateTaskState; } });
+// Services
+var event_normalizer_js_1 = require("./services/event-normalizer.js");
+Object.defineProperty(exports, "EventNormalizer", { enumerable: true, get: function () { return event_normalizer_js_1.EventNormalizer; } });
+// Session events
+var session_events_js_1 = require("./session/session-events.js");
+Object.defineProperty(exports, "generateEventId", { enumerable: true, get: function () { return session_events_js_1.generateEventId; } });
+Object.defineProperty(exports, "sessionClosed", { enumerable: true, get: function () { return session_events_js_1.sessionClosed; } });
+Object.defineProperty(exports, "sessionCreated", { enumerable: true, get: function () { return session_events_js_1.sessionCreated; } });
+Object.defineProperty(exports, "sessionResumed", { enumerable: true, get: function () { return session_events_js_1.sessionResumed; } });
+var session_facade_js_1 = require("./session/session-facade.js");
+Object.defineProperty(exports, "SessionFacadeImpl", { enumerable: true, get: function () { return session_facade_js_1.SessionFacadeImpl; } });
+var session_state_js_1 = require("./session/session-state.js");
+Object.defineProperty(exports, "createInitialSessionState", { enumerable: true, get: function () { return session_state_js_1.createInitialSessionState; } });
+Object.defineProperty(exports, "recoverSessionState", { enumerable: true, get: function () { return session_state_js_1.recoverSessionState; } });
+Object.defineProperty(exports, "serializeForRecovery", { enumerable: true, get: function () { return session_state_js_1.serializeForRecovery; } });
+Object.defineProperty(exports, "updateCompactionSummary", { enumerable: true, get: function () { return session_state_js_1.updateCompactionSummary; } });
+Object.defineProperty(exports, "updatePlanSummary", { enumerable: true, get: function () { return session_state_js_1.updatePlanSummary; } });
+Object.defineProperty(exports, "updateSessionStatus", { enumerable: true, get: function () { return session_state_js_1.updateSessionStatus; } });
+Object.defineProperty(exports, "updateSessionTaskState", { enumerable: true, get: function () { return session_state_js_1.updateTaskState; } });
+// Subagent — aggregation
+var aggregation_js_1 = require("./subagent/aggregation.js");
+Object.defineProperty(exports, "aggregateResults", { enumerable: true, get: function () { return aggregation_js_1.aggregateResults; } });
+Object.defineProperty(exports, "decideRework", { enumerable: true, get: function () { return aggregation_js_1.decideRework; } });
+// Subagent — path scope
+var path_scope_js_1 = require("./subagent/path-scope.js");
+Object.defineProperty(exports, "isPathAllowed", { enumerable: true, get: function () { return path_scope_js_1.isPathAllowed; } });
+Object.defineProperty(exports, "isPathForbidden", { enumerable: true, get: function () { return path_scope_js_1.isPathForbidden; } });
+Object.defineProperty(exports, "scopesOverlap", { enumerable: true, get: function () { return path_scope_js_1.scopesOverlap; } });
+Object.defineProperty(exports, "wouldViolateBoundary", { enumerable: true, get: function () { return path_scope_js_1.wouldViolateBoundary; } });
+var stop_condition_js_1 = require("./subagent/stop-condition.js");
+Object.defineProperty(exports, "createInitialRuntimeState", { enumerable: true, get: function () { return stop_condition_js_1.createInitialRuntimeState; } });
+Object.defineProperty(exports, "evaluateStopConditions", { enumerable: true, get: function () { return stop_condition_js_1.evaluateStopConditions; } });
+Object.defineProperty(exports, "recordBoundaryViolation", { enumerable: true, get: function () { return stop_condition_js_1.recordBoundaryViolation; } });
+Object.defineProperty(exports, "recordError", { enumerable: true, get: function () { return stop_condition_js_1.recordError; } });
+Object.defineProperty(exports, "recordModification", { enumerable: true, get: function () { return stop_condition_js_1.recordModification; } });
+Object.defineProperty(exports, "updateElapsedTime", { enumerable: true, get: function () { return stop_condition_js_1.updateElapsedTime; } });
+var task_validator_js_1 = require("./subagent/task-validator.js");
+Object.defineProperty(exports, "hasConsistentScope", { enumerable: true, get: function () { return task_validator_js_1.hasConsistentScope; } });
+Object.defineProperty(exports, "hasRequiredFields", { enumerable: true, get: function () { return task_validator_js_1.hasRequiredFields; } });
+Object.defineProperty(exports, "validateTask", { enumerable: true, get: function () { return task_validator_js_1.validateTask; } });
+var verification_js_1 = require("./subagent/verification.js");
+Object.defineProperty(exports, "evaluateVerifications", { enumerable: true, get: function () { return verification_js_1.evaluateVerifications; } });
+Object.defineProperty(exports, "isVerificationTrustworthy", { enumerable: true, get: function () { return verification_js_1.isVerificationTrustworthy; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,8CAA8C;;;AAE9C,gDAO6B;AAN5B,6GAAA,iBAAiB,OAAA;AACjB,oHAAA,wBAAwB,OAAA;AAGxB,gHAAA,oBAAoB,OAAA;AAMrB,cAAc;AACd,iEAA2D;AAAlD,yHAAA,gBAAgB,OAAA;AAEzB,SAAS;AACT,sDAAuD;AAA9C,8GAAA,cAAc,OAAA;AAuCvB,aAAa;AACb,kEAAmE;AAA1D,sHAAA,kBAAkB,OAAA;AAE3B,WAAW;AACX,4DAA6D;AAApD,kHAAA,gBAAgB,OAAA;AACzB,4DAOmC;AANlC,+GAAA,aAAa,OAAA;AACb,6GAAA,WAAW,OAAA;AACX,4GAAA,UAAU,OAAA;AACV,mHAAA,iBAAiB,OAAA;AACjB,gHAAA,cAAc,OAAA;AACd,iHAAA,eAAe,OAAA;AAGhB,wEAAyE;AAAhE,8HAAA,sBAAsB,OAAA;AAY/B,2DAA6E;AAApE,0HAAA,oBAAoB,OAAA;AAAE,qHAAA,eAAe,OAAA;AAC9C,WAAW;AACX,sEAAiE;AAAxD,sHAAA,eAAe,OAAA;AACxB,iBAAiB;AACjB,iEAA6G;AAApG,oHAAA,eAAe,OAAA;AAAE,kHAAA,aAAa,OAAA;AAAE,mHAAA,cAAc,OAAA;AAAE,mHAAA,cAAc,OAAA;AAGvE,iEAAgE;AAAvD,sHAAA,iBAAiB,OAAA;AAC1B,+DAQoC;AAPnC,6HAAA,yBAAyB,OAAA;AACzB,uHAAA,mBAAmB,OAAA;AACnB,wHAAA,oBAAoB,OAAA;AACpB,2HAAA,uBAAuB,OAAA;AACvB,qHAAA,iBAAiB,OAAA;AACjB,uHAAA,mBAAmB,OAAA;AACnB,0HAAA,eAAe,OAA0B;AAE1C,yBAAyB;AACzB,4DAA2E;AAAlE,kHAAA,gBAAgB,OAAA;AAAE,8GAAA,YAAY,OAAA;AACvC,wBAAwB;AACxB,0DAA+G;AAAtG,8GAAA,aAAa,OAAA;AAAE,gHAAA,eAAe,OAAA;AAAE,8GAAA,aAAa,OAAA;AAAE,qHAAA,oBAAoB,OAAA;AAa5E,kEAOsC;AANrC,8HAAA,yBAAyB,OAAA;AACzB,2HAAA,sBAAsB,OAAA;AACtB,4HAAA,uBAAuB,OAAA;AACvB,gHAAA,WAAW,OAAA;AACX,uHAAA,kBAAkB,OAAA;AAClB,sHAAA,iBAAiB,OAAA;AAalB,kEAAmG;AAA1F,uHAAA,kBAAkB,OAAA;AAAE,sHAAA,iBAAiB,OAAA;AAAE,iHAAA,YAAY,OAAA;AAG5D,8DAA8F;AAArF,wHAAA,qBAAqB,OAAA;AAAE,4HAAA,yBAAyB,OAAA"}

package/dist/planning/index.d.ts

@@ -0,0 +1,6 @@
+export type { Plan, PlanEngine } from "./plan-engine.js";
+export { createPlanEngine } from "./plan-engine.js";
+export { planCompleted, planCreated, planRework, planStepCompleted, planStepFailed, planStepStarted, } from "./plan-events.js";
+export type { PlanOrchestrator } from "./plan-orchestrator.js";
+export { createPlanOrchestrator } from "./plan-orchestrator.js";
+export type { PlanOutcomeReason, PlanStatus, PlanStep, PlanStepDetail, PlanStepStatus, PlanSummary, } from "./plan-types.js";

package/dist/planning/index.js

@@ -0,0 +1,16 @@
+"use strict";
+// planning/ — Plan engine, orchestrator, types, and event factories.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPlanOrchestrator = exports.planStepStarted = exports.planStepFailed = exports.planStepCompleted = exports.planRework = exports.planCreated = exports.planCompleted = exports.createPlanEngine = void 0;
+var plan_engine_js_1 = require("./plan-engine.js");
+Object.defineProperty(exports, "createPlanEngine", { enumerable: true, get: function () { return plan_engine_js_1.createPlanEngine; } });
+var plan_events_js_1 = require("./plan-events.js");
+Object.defineProperty(exports, "planCompleted", { enumerable: true, get: function () { return plan_events_js_1.planCompleted; } });
+Object.defineProperty(exports, "planCreated", { enumerable: true, get: function () { return plan_events_js_1.planCreated; } });
+Object.defineProperty(exports, "planRework", { enumerable: true, get: function () { return plan_events_js_1.planRework; } });
+Object.defineProperty(exports, "planStepCompleted", { enumerable: true, get: function () { return plan_events_js_1.planStepCompleted; } });
+Object.defineProperty(exports, "planStepFailed", { enumerable: true, get: function () { return plan_events_js_1.planStepFailed; } });
+Object.defineProperty(exports, "planStepStarted", { enumerable: true, get: function () { return plan_events_js_1.planStepStarted; } });
+var plan_orchestrator_js_1 = require("./plan-orchestrator.js");
+Object.defineProperty(exports, "createPlanOrchestrator", { enumerable: true, get: function () { return plan_orchestrator_js_1.createPlanOrchestrator; } });
+//# sourceMappingURL=index.js.map

package/dist/planning/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/planning/index.ts"],"names":[],"mappings":";AAAA,qEAAqE;;;AAGrE,mDAAoD;AAA3C,kHAAA,gBAAgB,OAAA;AACzB,mDAO0B;AANzB,+GAAA,aAAa,OAAA;AACb,6GAAA,WAAW,OAAA;AACX,4GAAA,UAAU,OAAA;AACV,mHAAA,iBAAiB,OAAA;AACjB,gHAAA,cAAc,OAAA;AACd,iHAAA,eAAe,OAAA;AAGhB,+DAAgE;AAAvD,8HAAA,sBAAsB,OAAA"}

package/dist/planning/plan-engine.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Plan state machine and lifecycle management.
+ *
+ * Provides immutable state transitions for plan objects. Every method returns
+ * a new Plan instance — the input is never mutated. Invalid transitions throw
+ * descriptive errors so that bugs surface early during development.
+ *
+ * Lifecycle:
+ *   draft → active → completed | failed | abandoned
+ *   draft → abandoned
+ *
+ * Step lifecycle:
+ *   pending → in_progress → completed | failed
+ *   pending → skipped
+ *   failed  → in_progress (rework, if under limit)
+ */
+import type { SubagentResult } from "../subagent/result-types.js";
+import type { PlanOutcomeReason, PlanStatus, PlanStepDetail, PlanSummary } from "./plan-types.js";
+export interface Plan {
+    readonly planId: string;
+    readonly goal: string;
+    readonly status: PlanStatus;
+    readonly steps: readonly PlanStepDetail[];
+    readonly createdAt: number;
+    readonly updatedAt: number;
+    readonly outcomeReason?: PlanOutcomeReason;
+    readonly maxReworkAttempts: number;
+}
+export interface PlanEngine {
+    /** Create a new plan in "draft" status with the given step descriptions. */
+    createDraft(planId: string, goal: string, stepDescriptions: readonly string[]): Plan;
+    /** Transition plan from "draft" to "active". */
+    activate(plan: Plan): Plan;
+    /** Start a step: transitions to "in_progress" and links a subagent taskId. */
+    startStep(plan: Plan, stepIndex: number, taskId: string): Plan;
+    /** Complete a step successfully with the subagent result. */
+    completeStep(plan: Plan, stepIndex: number, result: SubagentResult): Plan;
+    /** Fail a step with the subagent result. */
+    failStep(plan: Plan, stepIndex: number, result: SubagentResult): Plan;
+    /** Skip a pending step. */
+    skipStep(plan: Plan, stepIndex: number): Plan;
+    /** Abandon the plan with a reason. */
+    abandon(plan: Plan, reason: PlanOutcomeReason): Plan;
+    /** Derive a lightweight PlanSummary from the current plan state. */
+    summarize(plan: Plan): PlanSummary;
+    /** Get the index of the next pending step, or null if none. */
+    nextPendingStep(plan: Plan): number | null;
+}
+export declare function createPlanEngine(maxReworkAttempts?: number): PlanEngine;

package/dist/planning/plan-engine.js

@@ -0,0 +1,174 @@
+"use strict";
+/**
+ * Plan state machine and lifecycle management.
+ *
+ * Provides immutable state transitions for plan objects. Every method returns
+ * a new Plan instance — the input is never mutated. Invalid transitions throw
+ * descriptive errors so that bugs surface early during development.
+ *
+ * Lifecycle:
+ *   draft → active → completed | failed | abandoned
+ *   draft → abandoned
+ *
+ * Step lifecycle:
+ *   pending → in_progress → completed | failed
+ *   pending → skipped
+ *   failed  → in_progress (rework, if under limit)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPlanEngine = createPlanEngine;
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+function createPlanEngine(maxReworkAttempts = 2) {
+    function assertStatus(plan, ...expected) {
+        if (!expected.includes(plan.status)) {
+            throw new Error(`Plan "${plan.planId}" is ${plan.status}, expected ${expected.join(" or ")}`);
+        }
+    }
+    function assertStepStatus(step, index, ...expected) {
+        if (!expected.includes(step.status)) {
+            throw new Error(`Step ${index} ("${step.stepId}") is ${step.status}, expected ${expected.join(" or ")}`);
+        }
+    }
+    function assertIndex(plan, stepIndex) {
+        if (stepIndex < 0 || stepIndex >= plan.steps.length) {
+            throw new Error(`Step index ${stepIndex} out of range [0, ${plan.steps.length})`);
+        }
+    }
+    function updateSteps(plan, stepIndex, patcher) {
+        const steps = plan.steps.map((s, i) => (i === stepIndex ? patcher(s) : s));
+        return { ...plan, steps, updatedAt: Date.now() };
+    }
+    function isTerminal(plan) {
+        return plan.status === "completed" || plan.status === "failed" || plan.status === "abandoned";
+    }
+    function checkAutoComplete(plan) {
+        const allDone = plan.steps.every((s) => s.status === "completed" || s.status === "skipped");
+        if (allDone) {
+            return {
+                ...plan,
+                status: "completed",
+                outcomeReason: "all_steps_completed",
+                updatedAt: Date.now(),
+            };
+        }
+        return plan;
+    }
+    return {
+        createDraft(planId, goal, stepDescriptions) {
+            if (!stepDescriptions || stepDescriptions.length === 0) {
+                throw new Error("Plan must have at least one step");
+            }
+            const now = Date.now();
+            const steps = stepDescriptions.map((desc, i) => ({
+                stepId: `${planId}-step-${i + 1}`,
+                description: desc,
+                status: "pending",
+                reworkCount: 0,
+            }));
+            return {
+                planId,
+                goal,
+                status: "draft",
+                steps,
+                createdAt: now,
+                updatedAt: now,
+                maxReworkAttempts,
+            };
+        },
+        activate(plan) {
+            assertStatus(plan, "draft");
+            return { ...plan, status: "active", updatedAt: Date.now() };
+        },
+        startStep(plan, stepIndex, taskId) {
+            assertStatus(plan, "active");
+            assertIndex(plan, stepIndex);
+            assertStepStatus(plan.steps[stepIndex], stepIndex, "pending", "failed");
+            const step = plan.steps[stepIndex];
+            // If reworking a failed step, increment rework count
+            const reworkCount = step.status === "failed" ? step.reworkCount + 1 : step.reworkCount;
+            if (step.status === "failed" && reworkCount > plan.maxReworkAttempts) {
+                throw new Error(`Step ${stepIndex} ("${step.stepId}") has exceeded max rework attempts (${plan.maxReworkAttempts})`);
+            }
+            return updateSteps(plan, stepIndex, (s) => ({
+                ...s,
+                status: "in_progress",
+                taskId,
+                reworkCount,
+                result: undefined,
+            }));
+        },
+        completeStep(plan, stepIndex, result) {
+            assertStatus(plan, "active");
+            assertIndex(plan, stepIndex);
+            assertStepStatus(plan.steps[stepIndex], stepIndex, "in_progress");
+            if (result.status !== "completed") {
+                throw new Error(`completeStep requires result.status "completed", got "${result.status}". Use failStep for non-completed results.`);
+            }
+            const updated = updateSteps(plan, stepIndex, (s) => ({
+                ...s,
+                status: "completed",
+                result,
+            }));
+            return checkAutoComplete(updated);
+        },
+        failStep(plan, stepIndex, result) {
+            assertStatus(plan, "active");
+            assertIndex(plan, stepIndex);
+            assertStepStatus(plan.steps[stepIndex], stepIndex, "in_progress");
+            const updated = updateSteps(plan, stepIndex, (s) => ({
+                ...s,
+                status: "failed",
+                result,
+            }));
+            // If this step has exhausted rework attempts, fail the whole plan
+            const step = updated.steps[stepIndex];
+            if (step.reworkCount >= plan.maxReworkAttempts) {
+                return {
+                    ...updated,
+                    status: "failed",
+                    outcomeReason: "rework_limit_exceeded",
+                    updatedAt: Date.now(),
+                };
+            }
+            return updated;
+        },
+        skipStep(plan, stepIndex) {
+            assertStatus(plan, "active");
+            assertIndex(plan, stepIndex);
+            assertStepStatus(plan.steps[stepIndex], stepIndex, "pending");
+            const updated = updateSteps(plan, stepIndex, (s) => ({
+                ...s,
+                status: "skipped",
+            }));
+            return checkAutoComplete(updated);
+        },
+        abandon(plan, reason) {
+            if (isTerminal(plan)) {
+                throw new Error(`Plan "${plan.planId}" is already ${plan.status} and cannot be abandoned`);
+            }
+            return {
+                ...plan,
+                status: "abandoned",
+                outcomeReason: reason,
+                updatedAt: Date.now(),
+            };
+        },
+        summarize(plan) {
+            const completedSteps = plan.steps.filter((s) => s.status === "completed" || s.status === "skipped").length;
+            return {
+                planId: plan.planId,
+                goal: plan.goal,
+                status: plan.status,
+                stepCount: plan.steps.length,
+                completedSteps,
+            };
+        },
+        nextPendingStep(plan) {
+            const index = plan.steps.findIndex((s) => s.status === "pending");
+            return index === -1 ? null : index;
+        },
+    };
+}
+//# sourceMappingURL=plan-engine.js.map

package/dist/planning/plan-engine.js.map

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

package/dist/planning/plan-events.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Factory functions for plan lifecycle events.
+ *
+ * Follows the same pattern as session-events.ts: auto-fills id and timestamp
+ * so callers don't repeat boilerplate.
+ */
+import type { PlanCompletedEvent, PlanCreatedEvent, PlanReworkEvent, PlanStepCompletedEvent, PlanStepFailedEvent, PlanStepStartedEvent } from "../events/runtime-event.js";
+import type { PlanSummary, SessionId } from "../types/index.js";
+export declare function planCreated(sessionId: SessionId, planId: string, goal: string, stepCount: number): PlanCreatedEvent;
+export declare function planStepStarted(sessionId: SessionId, planId: string, stepId: string, stepDescription: string): PlanStepStartedEvent;
+export declare function planStepCompleted(sessionId: SessionId, planId: string, stepId: string, success: boolean): PlanStepCompletedEvent;
+export declare function planStepFailed(sessionId: SessionId, planId: string, stepId: string, reason: string, reworkScheduled: boolean): PlanStepFailedEvent;
+export declare function planRework(sessionId: SessionId, planId: string, stepId: string, reworkAttempt: number, focusAreas: readonly string[]): PlanReworkEvent;
+export declare function planCompleted(sessionId: SessionId, planId: string, goal: string, success: boolean, summary: PlanSummary): PlanCompletedEvent;

package/dist/planning/plan-events.js

@@ -0,0 +1,94 @@
+"use strict";
+/**
+ * Factory functions for plan lifecycle events.
+ *
+ * Follows the same pattern as session-events.ts: auto-fills id and timestamp
+ * so callers don't repeat boilerplate.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.planCreated = planCreated;
+exports.planStepStarted = planStepStarted;
+exports.planStepCompleted = planStepCompleted;
+exports.planStepFailed = planStepFailed;
+exports.planRework = planRework;
+exports.planCompleted = planCompleted;
+const session_events_js_1 = require("../session/session-events.js");
+// ---------------------------------------------------------------------------
+// Event factories
+// ---------------------------------------------------------------------------
+function planCreated(sessionId, planId, goal, stepCount) {
+    return {
+        id: (0, session_events_js_1.generateEventId)(),
+        timestamp: Date.now(),
+        sessionId,
+        category: "plan",
+        type: "plan_created",
+        planId,
+        goal,
+        stepCount,
+    };
+}
+function planStepStarted(sessionId, planId, stepId, stepDescription) {
+    return {
+        id: (0, session_events_js_1.generateEventId)(),
+        timestamp: Date.now(),
+        sessionId,
+        category: "plan",
+        type: "plan_step_started",
+        planId,
+        stepId,
+        stepDescription,
+    };
+}
+function planStepCompleted(sessionId, planId, stepId, success) {
+    return {
+        id: (0, session_events_js_1.generateEventId)(),
+        timestamp: Date.now(),
+        sessionId,
+        category: "plan",
+        type: "plan_step_completed",
+        planId,
+        stepId,
+        success,
+    };
+}
+function planStepFailed(sessionId, planId, stepId, reason, reworkScheduled) {
+    return {
+        id: (0, session_events_js_1.generateEventId)(),
+        timestamp: Date.now(),
+        sessionId,
+        category: "plan",
+        type: "plan_step_failed",
+        planId,
+        stepId,
+        reason,
+        reworkScheduled,
+    };
+}
+function planRework(sessionId, planId, stepId, reworkAttempt, focusAreas) {
+    return {
+        id: (0, session_events_js_1.generateEventId)(),
+        timestamp: Date.now(),
+        sessionId,
+        category: "plan",
+        type: "plan_rework",
+        planId,
+        stepId,
+        reworkAttempt,
+        focusAreas,
+    };
+}
+function planCompleted(sessionId, planId, goal, success, summary) {
+    return {
+        id: (0, session_events_js_1.generateEventId)(),
+        timestamp: Date.now(),
+        sessionId,
+        category: "plan",
+        type: "plan_completed",
+        planId,
+        goal,
+        success,
+        summary,
+    };
+}
+//# sourceMappingURL=plan-events.js.map

package/dist/planning/plan-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-events.js","sourceRoot":"","sources":["../../src/planning/plan-events.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAiBH,kCAWC;AAED,0CAgBC;AAED,8CAgBC;AAED,wCAkBC;AAED,gCAkBC;AAED,sCAkBC;AAlHD,oEAA+D;AAG/D,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,SAAgB,WAAW,CAAC,SAAoB,EAAE,MAAc,EAAE,IAAY,EAAE,SAAiB;IAChG,OAAO;QACN,EAAE,EAAE,IAAA,mCAAe,GAAE;QACrB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,SAAS;QACT,QAAQ,EAAE,MAAM;QAChB,IAAI,EAAE,cAAc;QACpB,MAAM;QACN,IAAI;QACJ,SAAS;KACT,CAAC;AACH,CAAC;AAED,SAAgB,eAAe,CAC9B,SAAoB,EACpB,MAAc,EACd,MAAc,EACd,eAAuB;IAEvB,OAAO;QACN,EAAE,EAAE,IAAA,mCAAe,GAAE;QACrB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,SAAS;QACT,QAAQ,EAAE,MAAM;QAChB,IAAI,EAAE,mBAAmB;QACzB,MAAM;QACN,MAAM;QACN,eAAe;KACf,CAAC;AACH,CAAC;AAED,SAAgB,iBAAiB,CAChC,SAAoB,EACpB,MAAc,EACd,MAAc,EACd,OAAgB;IAEhB,OAAO;QACN,EAAE,EAAE,IAAA,mCAAe,GAAE;QACrB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,SAAS;QACT,QAAQ,EAAE,MAAM;QAChB,IAAI,EAAE,qBAAqB;QAC3B,MAAM;QACN,MAAM;QACN,OAAO;KACP,CAAC;AACH,CAAC;AAED,SAAgB,cAAc,CAC7B,SAAoB,EACpB,MAAc,EACd,MAAc,EACd,MAAc,EACd,eAAwB;IAExB,OAAO;QACN,EAAE,EAAE,IAAA,mCAAe,GAAE;QACrB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,SAAS;QACT,QAAQ,EAAE,MAAM;QAChB,IAAI,EAAE,kBAAkB;QACxB,MAAM;QACN,MAAM;QACN,MAAM;QACN,eAAe;KACf,CAAC;AACH,CAAC;AAED,SAAgB,UAAU,CACzB,SAAoB,EACpB,MAAc,EACd,MAAc,EACd,aAAqB,EACrB,UAA6B;IAE7B,OAAO;QACN,EAAE,EAAE,IAAA,mCAAe,GAAE;QACrB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,SAAS;QACT,QAAQ,EAAE,MAAM;QAChB,IAAI,EAAE,aAAa;QACnB,MAAM;QACN,MAAM;QACN,aAAa;QACb,UAAU;KACV,CAAC;AACH,CAAC;AAED,SAAgB,aAAa,CAC5B,SAAoB,EACpB,MAAc,EACd,IAAY,EACZ,OAAgB,EAChB,OAAoB;IAEpB,OAAO;QACN,EAAE,EAAE,IAAA,mCAAe,GAAE;QACrB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,SAAS;QACT,QAAQ,EAAE,MAAM;QAChB,IAAI,EAAE,gBAAgB;QACtB,MAAM;QACN,IAAI;QACJ,OAAO;QACP,OAAO;KACP,CAAC;AACH,CAAC"}

package/dist/planning/plan-orchestrator.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Plan orchestration runtime integration.
+ *
+ * Connects the plan engine, path scope checking, stop condition evaluation,
+ * and result aggregation into a single service that enforces all P4 safety
+ * guarantees. This is the runtime integration point — external callers
+ * (CLI commands, plan execution drivers) interact with plans through this.
+ *
+ * Safety guarantees enforced by submitResult():
+ *   1. Boundary check: modifiedPaths are validated against the assigned task's scope
+ *   2. Stop condition check: runtime state is evaluated against stop conditions
+ *   3. Both checks cause auto-fail before completeStep is called
+ *   4. Rework decisions are made automatically for failed steps
+ */
+import type { EventBus } from "../events/event-bus.js";
+import type { SubagentResult } from "../subagent/result-types.js";
+import type { SubagentTask } from "../subagent/task-types.js";
+import type { SessionId } from "../types/index.js";
+import type { Plan, PlanEngine } from "./plan-engine.js";
+import type { PlanSummary } from "./plan-types.js";
+export interface PlanOrchestrator {
+    /** Underlying plan engine. */
+    readonly engine: PlanEngine;
+    /** Current active plan, or null if no plan has been created yet. */
+    readonly activePlan: Plan | null;
+    /**
+     * Create a draft plan and immediately activate it.
+     * Emits `plan_created` to both event buses.
+     */
+    createAndActivate(planId: string, goal: string, steps: string[]): Plan;
+    /**
+     * Assign a SubagentTask to a step, validate it, and start the step.
+     * Emits `plan_step_started` to both event buses.
+     */
+    assignTask(stepIndex: number, task: SubagentTask): Plan;
+    /**
+     * Submit a result for a step. This is the main safety gate:
+     *
+     * 1. If result.status === "completed":
+     *    a. Check boundary violations on modifiedPaths
+     *    b. Evaluate stop conditions
+     *    c. If violations or stop conditions → auto-fail (never calls completeStep)
+     *    d. Otherwise → complete step
+     * 2. If result.status !== "completed" → fail step
+     * 3. For failures: decideRework, emit plan_rework if scheduled
+     * 4. If plan auto-completes: emit plan_completed
+     */
+    submitResult(stepIndex: number, result: SubagentResult): Plan;
+    /** Skip a pending step. */
+    skipStep(stepIndex: number): Plan;
+    /** Abandon the plan. Emits `plan_completed` with success=false. */
+    abandonPlan(reason: string): Plan;
+    /** Get current plan summary, or null if no active plan. */
+    summarize(): PlanSummary | null;
+}
+export declare function createPlanOrchestrator(engine: PlanEngine, sessionBus: EventBus, globalBus: EventBus, sessionId: SessionId): PlanOrchestrator;