openhorse 0.2.23 → 0.2.24

package/dist/runtime/goals/tools.js

@@ -0,0 +1,88 @@
+"use strict";
+/**
+ * v0.2.24 — Goal Model Tools.
+ *
+ * get_goal, create_goal, update_goal tool definitions for the Agent.
+ * These tools allow the model to read and request changes to the
+ * persistent goal. Actual state changes go through GoalCoordinator.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildGetGoalTool = buildGetGoalTool;
+exports.executeGetGoal = executeGetGoal;
+exports.buildCreateGoalTool = buildCreateGoalTool;
+exports.executeCreateGoal = executeCreateGoal;
+exports.buildUpdateGoalTool = buildUpdateGoalTool;
+exports.executeUpdateGoal = executeUpdateGoal;
+function buildGetGoalTool() {
+    return {
+        name: 'get_goal',
+        description: 'Read the current persistent goal for this session. Returns null if no goal is active.',
+        parameters: {
+            type: 'object',
+            properties: {},
+            required: [],
+        },
+    };
+}
+function executeGetGoal(bindings) {
+    return bindings.coordinator.snapshot();
+}
+function buildCreateGoalTool() {
+    return {
+        name: 'create_goal',
+        description: 'Create a persistent goal for this session. Only use when the user explicitly requests a long-running goal. Rejects if a goal already exists.',
+        parameters: {
+            type: 'object',
+            properties: {
+                objective: {
+                    type: 'string',
+                    description: 'The goal objective. Must be clear, specific, and verifiable.',
+                },
+                token_budget: {
+                    type: 'number',
+                    description: 'Optional token budget. Only set when the user explicitly provides a budget.',
+                },
+            },
+            required: ['objective'],
+        },
+    };
+}
+function executeCreateGoal(bindings, objective, tokenBudget) {
+    const result = bindings.coordinator.create(objective);
+    if (!result.ok)
+        return { ok: false, error: result.error };
+    if (tokenBudget && tokenBudget > 0) {
+        bindings.coordinator.setBudget(tokenBudget);
+    }
+    const snap = bindings.coordinator.snapshot();
+    return snap ? { ok: true, goal: snap } : { ok: false, error: 'Goal was created but snapshot is unavailable.' };
+}
+function buildUpdateGoalTool() {
+    return {
+        name: 'update_goal',
+        description: 'Request a status change for the current goal. The request is audited before the change takes effect.',
+        parameters: {
+            type: 'object',
+            properties: {
+                status: {
+                    type: 'string',
+                    enum: ['complete', 'blocked'],
+                    description: 'The requested target status: "complete" when all requirements are verified; "blocked" when the same blocker persisted for 3+ turns.',
+                },
+            },
+            required: ['status'],
+        },
+    };
+}
+function executeUpdateGoal(bindings, status) {
+    const goal = bindings.coordinator.goal;
+    if (!goal)
+        return { ok: false, error: 'No active goal to update.' };
+    if (goal.status !== 'active')
+        return { ok: false, error: `Goal is not active (current status: ${goal.status}).` };
+    return {
+        ok: true,
+        message: `Goal ${status} request recorded. Audit will verify before applying.`,
+    };
+}
+//# sourceMappingURL=tools.js.map

package/dist/runtime/goals/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/runtime/goals/tools.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AASH,4CAcC;AAED,wCAEC;AAED,kDAuBC;AAED,8CAcC;AAED,kDAoBC;AAED,8CAYC;AA/FD,SAAgB,gBAAgB;IAK9B,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,uFAAuF;QACpG,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;YACd,QAAQ,EAAE,EAAE;SACb;KACF,CAAC;AACJ,CAAC;AAED,SAAgB,cAAc,CAAC,QAA0B;IACvD,OAAO,QAAQ,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC;AACzC,CAAC;AAED,SAAgB,mBAAmB;IAKjC,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,8IAA8I;QAC3J,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,8DAA8D;iBAC5E;gBACD,YAAY,EAAE;oBACZ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,6EAA6E;iBAC3F;aACF;YACD,QAAQ,EAAE,CAAC,WAAW,CAAC;SACxB;KACF,CAAC;AACJ,CAAC;AAED,SAAgB,iBAAiB,CAC/B,QAA0B,EAC1B,SAAiB,EACjB,WAAoB;IAEpB,MAAM,MAAM,GAAG,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACtD,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;IAE1D,IAAI,WAAW,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;QACnC,QAAQ,CAAC,WAAW,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC;IAC7C,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,+CAA+C,EAAE,CAAC;AACjH,CAAC;AAED,SAAgB,mBAAmB;IAKjC,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,sGAAsG;QACnH,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC;oBAC7B,WAAW,EAAE,qIAAqI;iBACnJ;aACF;YACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;SACrB;KACF,CAAC;AACJ,CAAC;AAED,SAAgB,iBAAiB,CAC/B,QAA0B,EAC1B,MAA8B;IAE9B,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC;IACvC,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,2BAA2B,EAAE,CAAC;IACpE,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,uCAAuC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC;IAElH,OAAO;QACL,EAAE,EAAE,IAAI;QACR,OAAO,EAAE,QAAQ,MAAM,uDAAuD;KAC/E,CAAC;AACJ,CAAC"}

package/dist/runtime/goals/types.d.ts

@@ -0,0 +1,167 @@
+/**
+ * v0.2.24 — Goal / Target Mode domain types.
+ *
+ * Goal is a persistent, single-session entity that the Agent pursues across
+ * multiple turns, Compact, process restart, and /resume. It is NOT a
+ * Harness field, a prompt string, or a UI state — it is an independent
+ * lifecycle entity with its own sidecar storage.
+ */
+export type GoalStatus = 'active' | 'paused' | 'blocked' | 'usage_limited' | 'budget_limited' | 'complete';
+export declare const GOAL_ACTIVE_STATES: ReadonlySet<GoalStatus>;
+export declare const GOAL_TERMINAL_STATES: ReadonlySet<GoalStatus>;
+export declare const GOAL_USER_RECOVERABLE_STATES: ReadonlySet<GoalStatus>;
+export interface GoalBlocker {
+    fingerprint: string;
+    firstSeenAt: number;
+    lastSeenAt: number;
+    consecutiveTurns: number;
+    summary: string;
+}
+export interface GoalLastTurn {
+    turnId: string;
+    finishReason: string;
+    endedAt: number;
+    promptTokens: number;
+    completionTokens: number;
+    subagentTokens: number;
+    totalTokens: number;
+    madeProgress: boolean;
+}
+export interface GoalCompletionAudit {
+    requestedAt: number;
+    auditedAt: number;
+    passed: boolean;
+    verificationSummary: string;
+    remainingRequirements: string[];
+    evidenceRefs: string[];
+}
+export interface GoalStopReason {
+    kind: 'user' | 'blocked' | 'usage_limit' | 'budget_limit' | 'runtime_error';
+    message: string;
+    at: number;
+}
+export interface SessionGoalV1 {
+    version: 1;
+    goalId: string;
+    sessionId: string;
+    revision: number;
+    objective: string;
+    status: GoalStatus;
+    tokenBudget?: number;
+    tokensUsed: number;
+    timeUsedMs: number;
+    createdAt: number;
+    updatedAt: number;
+    activeSince?: number;
+    completedAt?: number;
+    continuationCount: number;
+    noProgressCount: number;
+    blocker?: GoalBlocker;
+    lastTurn?: GoalLastTurn;
+    completionAudit?: GoalCompletionAudit;
+    stopReason?: GoalStopReason;
+}
+export interface RuntimeGoalSnapshot {
+    goalId: string;
+    revision: number;
+    objective: string;
+    status: GoalStatus;
+    tokenBudget?: number;
+    tokensUsed: number;
+    timeUsedMs: number;
+    continuationCount: number;
+    updatedAt: number;
+    stopReason?: string;
+}
+export type AgentInputKind = 'user' | 'revision' | 'goal_continuation' | 'command';
+export interface GoalTurnContext {
+    goalId: string;
+    revision: number;
+    continuationIndex: number;
+}
+export interface AgentTurnRequest {
+    inputKind: AgentInputKind;
+    text?: string;
+    sessionId: string;
+    goal?: GoalTurnContext;
+    persistAsUserMessage: boolean;
+    echoToTranscript: boolean;
+}
+export interface AgentTurnOutcome {
+    turnId: string;
+    sessionId: string;
+    goalId?: string;
+    goalRevision?: number;
+    startedAt: number;
+    endedAt: number;
+    finishReason: string;
+    usage: {
+        promptTokens: number;
+        completionTokens: number;
+        subagentTokens: number;
+        totalTokens: number;
+    };
+    madeProgress: boolean;
+    blocker?: {
+        fingerprint: string;
+        summary: string;
+        retryable: boolean;
+    };
+    providerError?: {
+        kind: 'usage_limit' | 'rate_limit' | 'auth' | 'network' | 'unknown';
+        retryable: boolean;
+    };
+    pendingTerminalRequest?: {
+        requestedStatus: 'complete' | 'blocked';
+        requestedAt: number;
+    };
+}
+export type GoalControlAction = 'show' | 'create' | 'edit' | 'replace' | 'pause' | 'resume' | 'clear' | 'set_budget';
+export interface GoalControlInput {
+    type: 'goal_control';
+    action: GoalControlAction;
+    payload?: {
+        objective?: string;
+        tokenBudget?: number | null;
+        confirmed?: boolean;
+    };
+}
+export interface GoalUpdatedEvent {
+    type: 'goal_updated';
+    goal: RuntimeGoalSnapshot;
+    reason: string;
+}
+export interface GoalClearedEvent {
+    type: 'goal_cleared';
+    goalId: string;
+    reason: string;
+}
+export interface GoalContinuationEvent {
+    type: 'goal_continuation';
+    goalId: string;
+    phase: 'scheduled' | 'started' | 'deferred' | 'stopped';
+    reason: string;
+}
+export interface GoalAuditFailedEvent {
+    type: 'goal_audit_failed';
+    goalId: string;
+    audit: 'completion' | 'blocked';
+    summary: string;
+}
+export interface GoalRestoredEvent {
+    type: 'goal_restored';
+    goal: RuntimeGoalSnapshot;
+}
+/**
+ * Valid status transitions for the Goal state machine.
+ * Returns the allowed next status, or null if the transition is invalid.
+ */
+export declare function goalTransition(current: GoalStatus | null, event: 'create' | 'pause' | 'resume' | 'complete' | 'block' | 'usage_limit' | 'budget_limit' | 'replace' | 'clear'): GoalStatus | null;
+/** Constraints from the goal plan that must hold across the state machine. */
+export declare const GOAL_INVARIANTS: {
+    readonly maxObjectiveChars: 4000;
+    readonly maxConsecutiveBlockerTurns: 3;
+    readonly maxConsecutiveNoProgressTurns: 3;
+    readonly tokenBudgetMin: 1;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/runtime/goals/types.d.ts.map

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

package/dist/runtime/goals/types.js

@@ -0,0 +1,72 @@
+"use strict";
+/**
+ * v0.2.24 — Goal / Target Mode domain types.
+ *
+ * Goal is a persistent, single-session entity that the Agent pursues across
+ * multiple turns, Compact, process restart, and /resume. It is NOT a
+ * Harness field, a prompt string, or a UI state — it is an independent
+ * lifecycle entity with its own sidecar storage.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GOAL_INVARIANTS = exports.GOAL_USER_RECOVERABLE_STATES = exports.GOAL_TERMINAL_STATES = exports.GOAL_ACTIVE_STATES = void 0;
+exports.goalTransition = goalTransition;
+exports.GOAL_ACTIVE_STATES = new Set(['active']);
+exports.GOAL_TERMINAL_STATES = new Set([
+    'blocked', 'usage_limited', 'budget_limited', 'complete',
+]);
+exports.GOAL_USER_RECOVERABLE_STATES = new Set([
+    'paused', 'blocked', 'usage_limited', 'budget_limited',
+]);
+// ============================================================================
+// State machine
+// ============================================================================
+/**
+ * Valid status transitions for the Goal state machine.
+ * Returns the allowed next status, or null if the transition is invalid.
+ */
+function goalTransition(current, event) {
+    if (event === 'create')
+        return current === null ? 'active' : null;
+    if (event === 'replace')
+        return 'active'; // always allowed, generates new goalId
+    if (event === 'clear')
+        return null; // removes goal entirely
+    if (current === null)
+        return null;
+    switch (current) {
+        case 'active':
+            if (event === 'pause')
+                return 'paused';
+            if (event === 'complete')
+                return 'complete';
+            if (event === 'block')
+                return 'blocked';
+            if (event === 'usage_limit')
+                return 'usage_limited';
+            if (event === 'budget_limit')
+                return 'budget_limited';
+            return null;
+        case 'paused':
+            if (event === 'resume')
+                return 'active';
+            return null;
+        case 'blocked':
+        case 'usage_limited':
+        case 'budget_limited':
+            if (event === 'resume')
+                return 'active';
+            return null;
+        case 'complete':
+            return null; // terminal — only replace or clear
+        default:
+            return null;
+    }
+}
+/** Constraints from the goal plan that must hold across the state machine. */
+exports.GOAL_INVARIANTS = {
+    maxObjectiveChars: 4000,
+    maxConsecutiveBlockerTurns: 3,
+    maxConsecutiveNoProgressTurns: 3,
+    tokenBudgetMin: 1,
+};
+//# sourceMappingURL=types.js.map

package/dist/runtime/goals/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/runtime/goals/types.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAqOH,wCAmCC;AA1PY,QAAA,kBAAkB,GAA4B,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;AAClE,QAAA,oBAAoB,GAA4B,IAAI,GAAG,CAAC;IACnE,SAAS,EAAE,eAAe,EAAE,gBAAgB,EAAE,UAAU;CACzD,CAAC,CAAC;AACU,QAAA,4BAA4B,GAA4B,IAAI,GAAG,CAAC;IAC3E,QAAQ,EAAE,SAAS,EAAE,eAAe,EAAE,gBAAgB;CACvD,CAAC,CAAC;AAyMH,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E;;;GAGG;AACH,SAAgB,cAAc,CAC5B,OAA0B,EAC1B,KAAkH;IAElH,IAAI,KAAK,KAAK,QAAQ;QAAE,OAAO,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;IAClE,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC,CAAE,uCAAuC;IAClF,IAAI,KAAK,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC,CAAQ,wBAAwB;IAEnE,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAElC,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,QAAQ;YACX,IAAI,KAAK,KAAK,OAAO;gBAAE,OAAO,QAAQ,CAAC;YACvC,IAAI,KAAK,KAAK,UAAU;gBAAE,OAAO,UAAU,CAAC;YAC5C,IAAI,KAAK,KAAK,OAAO;gBAAE,OAAO,SAAS,CAAC;YACxC,IAAI,KAAK,KAAK,aAAa;gBAAE,OAAO,eAAe,CAAC;YACpD,IAAI,KAAK,KAAK,cAAc;gBAAE,OAAO,gBAAgB,CAAC;YACtD,OAAO,IAAI,CAAC;QAEd,KAAK,QAAQ;YACX,IAAI,KAAK,KAAK,QAAQ;gBAAE,OAAO,QAAQ,CAAC;YACxC,OAAO,IAAI,CAAC;QAEd,KAAK,SAAS,CAAC;QACf,KAAK,eAAe,CAAC;QACrB,KAAK,gBAAgB;YACnB,IAAI,KAAK,KAAK,QAAQ;gBAAE,OAAO,QAAQ,CAAC;YACxC,OAAO,IAAI,CAAC;QAEd,KAAK,UAAU;YACb,OAAO,IAAI,CAAC,CAAE,mCAAmC;QAEnD;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED,8EAA8E;AACjE,QAAA,eAAe,GAAG;IAC7B,iBAAiB,EAAE,IAAI;IACvB,0BAA0B,EAAE,CAAC;IAC7B,6BAA6B,EAAE,CAAC;IAChC,cAAc,EAAE,CAAC;CACT,CAAC"}

package/dist/services/goal-sidecar.d.ts

@@ -0,0 +1,96 @@
+/**
+ * openhorse — Goal Sidecar
+ *
+ * Persistent target mode state, stored as a JSON sidecar under the session
+ * directory. Implements cross-turn goal lifecycle, idle continuation, and
+ * per-resume recovery per v0.2.24-target-mode-plan section 8.
+ *
+ * This sidecar is the source of truth for goal state; Compact summaries and
+ * HarnessState.rootObjective are derived shadows, not the canonical record.
+ */
+import { getProjectSessionGoalPath } from './config-dir';
+import type { SessionMeta } from './session-storage';
+export type GoalStatus = 'active' | 'paused' | 'blocked' | 'usage_limited' | 'budget_limited' | 'complete';
+export declare const GOAL_ACTIVE_STATUSES: Set<GoalStatus>;
+export declare const GOAL_TERMINAL_STATUSES: Set<GoalStatus>;
+export declare const GOAL_PAUSABLE_STATUSES: Set<GoalStatus>;
+export declare const GOAL_RESUMABLE_STATUSES: Set<GoalStatus>;
+export declare const GOAL_CLEARABLE_STATUSES: Set<GoalStatus>;
+/**
+ * Accounting counters accumulated across all goal turns.
+ * These are separate from SessionMeta.tokenCount/cost so a replaced
+ * goal does not lose track of its own spend.
+ */
+export interface GoalAccounting {
+    /** Total prompt tokens consumed across all goal turns. */
+    promptTokens: number;
+    /** Total completion tokens consumed across all goal turns. */
+    completionTokens: number;
+    /** Total estimated cost (USD) across all goal turns. */
+    cost: number;
+    /** Number of goal turns (autonomous continuation fires). */
+    turnCount: number;
+    /** Wall-clock milliseconds accumulated across goal turns. */
+    elapsedMs: number;
+}
+export interface GoalBlockedInfo {
+    /** The reason string from the last blocked turn's tool result. */
+    reason: string;
+    /** How many consecutive turns this blocker has been reported. */
+    consecutiveTurns: number;
+}
+export interface GoalCompletionEvidence {
+    /** Requirement-by-requirement audit result. */
+    requirements: Array<{
+        requirement: string;
+        met: boolean;
+        evidence: string;
+    }>;
+    /** Agent-provided summary of completed work. */
+    summary: string;
+    /** Timestamp when completion was proposed. */
+    proposedAt: number;
+}
+export interface GoalSidecarV1 {
+    version: 1;
+    goalId: string;
+    sessionId: string;
+    projectPath: string;
+    /** The original user objective text. Never overwritten by Compact. */
+    objective: string;
+    status: GoalStatus;
+    /** Monotonic CAS revision; incremented on every write. */
+    revision: number;
+    createdAt: number;
+    updatedAt: number;
+    /** Optional user-specified token budget (null = unlimited). */
+    tokenBudget: number | null;
+    accounting: GoalAccounting;
+    /** Blocking information when status === 'blocked'. */
+    blocked?: GoalBlockedInfo;
+    /** Completion evidence when status === 'complete'. */
+    completion?: GoalCompletionEvidence;
+    /** Fingerprint of the last known continueReason; used for blocking detection. */
+    lastContinueReason: string | null;
+}
+export declare function createGoalSidecar(goalId: string, session: Pick<SessionMeta, 'id' | 'projectPath'>, objective: string, tokenBudget?: number | null, now?: number): GoalSidecarV1;
+export declare function loadGoalSidecar(session: Pick<SessionMeta, 'id' | 'projectPath'>): GoalSidecarV1 | null;
+export declare function saveGoalSidecar(sidecar: GoalSidecarV1): void;
+export declare function transitionGoalStatus(sidecar: GoalSidecarV1, target: GoalStatus, metadata?: Partial<Pick<GoalSidecarV1, 'blocked' | 'completion'>>): GoalSidecarV1;
+export declare function accumulateGoalUsage(sidecar: GoalSidecarV1, usage: {
+    promptTokens: number;
+    completionTokens: number;
+    cost: number;
+}, elapsedMs: number): GoalSidecarV1;
+/**
+ * Check whether accumulated cost exceeds the budget.
+ * Returns true when over budget (nil budget = never over).
+ */
+export declare function isGoalOverBudget(sidecar: GoalSidecarV1): boolean;
+/**
+ * Check whether the same blocker reason has persisted for enough
+ * consecutive turns to enter 'blocked' status.
+ */
+export declare function shouldMarkBlocked(sidecar: GoalSidecarV1, currentContinueReason: string, consecutiveThreshold?: number): boolean;
+export { getProjectSessionGoalPath };
+//# sourceMappingURL=goal-sidecar.d.ts.map

package/dist/services/goal-sidecar.d.ts.map

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

package/dist/services/goal-sidecar.js

@@ -0,0 +1,145 @@
+"use strict";
+/**
+ * openhorse — Goal Sidecar
+ *
+ * Persistent target mode state, stored as a JSON sidecar under the session
+ * directory. Implements cross-turn goal lifecycle, idle continuation, and
+ * per-resume recovery per v0.2.24-target-mode-plan section 8.
+ *
+ * This sidecar is the source of truth for goal state; Compact summaries and
+ * HarnessState.rootObjective are derived shadows, not the canonical record.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getProjectSessionGoalPath = exports.GOAL_CLEARABLE_STATUSES = exports.GOAL_RESUMABLE_STATUSES = exports.GOAL_PAUSABLE_STATUSES = exports.GOAL_TERMINAL_STATUSES = exports.GOAL_ACTIVE_STATUSES = void 0;
+exports.createGoalSidecar = createGoalSidecar;
+exports.loadGoalSidecar = loadGoalSidecar;
+exports.saveGoalSidecar = saveGoalSidecar;
+exports.transitionGoalStatus = transitionGoalStatus;
+exports.accumulateGoalUsage = accumulateGoalUsage;
+exports.isGoalOverBudget = isGoalOverBudget;
+exports.shouldMarkBlocked = shouldMarkBlocked;
+const fs_1 = require("fs");
+const atomic_write_1 = require("./atomic-write");
+const config_dir_1 = require("./config-dir");
+Object.defineProperty(exports, "getProjectSessionGoalPath", { enumerable: true, get: function () { return config_dir_1.getProjectSessionGoalPath; } });
+exports.GOAL_ACTIVE_STATUSES = new Set(['active']);
+exports.GOAL_TERMINAL_STATUSES = new Set([
+    'complete',
+    'budget_limited',
+    'usage_limited', // usage_limited is terminal until user resets
+]);
+exports.GOAL_PAUSABLE_STATUSES = new Set(['active']);
+exports.GOAL_RESUMABLE_STATUSES = new Set(['paused']);
+exports.GOAL_CLEARABLE_STATUSES = new Set([
+    'active',
+    'paused',
+    'blocked',
+    'complete',
+    'usage_limited',
+    'budget_limited',
+]);
+// ============================================================================
+// Factory & helpers
+// ============================================================================
+function createGoalSidecar(goalId, session, objective, tokenBudget = null, now = Date.now()) {
+    return {
+        version: 1,
+        goalId,
+        sessionId: session.id,
+        projectPath: session.projectPath,
+        objective,
+        status: 'active',
+        revision: 1,
+        createdAt: now,
+        updatedAt: now,
+        tokenBudget,
+        accounting: {
+            promptTokens: 0,
+            completionTokens: 0,
+            cost: 0,
+            turnCount: 0,
+            elapsedMs: 0,
+        },
+        lastContinueReason: null,
+    };
+}
+// ============================================================================
+// Persistence
+// ============================================================================
+function loadGoalSidecar(session) {
+    const path = (0, config_dir_1.getProjectSessionGoalPath)(session.projectPath, session.id);
+    if (!(0, fs_1.existsSync)(path))
+        return null;
+    try {
+        const parsed = JSON.parse((0, fs_1.readFileSync)(path, 'utf-8'));
+        if (parsed.version !== 1 || typeof parsed.goalId !== 'string' || !parsed.goalId) {
+            return null;
+        }
+        if (typeof parsed.objective !== 'string' || !parsed.objective) {
+            return null;
+        }
+        if (typeof parsed.status !== 'string') {
+            return null;
+        }
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+function saveGoalSidecar(sidecar) {
+    sidecar.revision = (sidecar.revision ?? 0) + 1;
+    sidecar.updatedAt = Date.now();
+    (0, config_dir_1.ensureProjectDir)(sidecar.projectPath);
+    (0, atomic_write_1.atomicWriteFileSync)((0, config_dir_1.getProjectSessionGoalPath)(sidecar.projectPath, sidecar.sessionId), JSON.stringify(sidecar, null, 2), { mode: 0o600 });
+}
+// ============================================================================
+// Status transitions (idempotent, validated)
+// ============================================================================
+function transitionGoalStatus(sidecar, target, metadata) {
+    if (sidecar.status === target)
+        return sidecar;
+    if (target === 'blocked' && metadata?.blocked) {
+        sidecar.status = 'blocked';
+        sidecar.blocked = metadata.blocked;
+    }
+    else if (target === 'complete' && metadata?.completion) {
+        sidecar.status = 'complete';
+        sidecar.completion = metadata.completion;
+    }
+    else {
+        sidecar.status = target;
+    }
+    return sidecar;
+}
+// ============================================================================
+// Accounting accumulation
+// ============================================================================
+function accumulateGoalUsage(sidecar, usage, elapsedMs) {
+    sidecar.accounting.promptTokens += usage.promptTokens;
+    sidecar.accounting.completionTokens += usage.completionTokens;
+    sidecar.accounting.cost += usage.cost;
+    sidecar.accounting.turnCount += 1;
+    sidecar.accounting.elapsedMs += elapsedMs;
+    return sidecar;
+}
+/**
+ * Check whether accumulated cost exceeds the budget.
+ * Returns true when over budget (nil budget = never over).
+ */
+function isGoalOverBudget(sidecar) {
+    if (sidecar.tokenBudget === null)
+        return false;
+    return sidecar.accounting.cost >= sidecar.tokenBudget;
+}
+/**
+ * Check whether the same blocker reason has persisted for enough
+ * consecutive turns to enter 'blocked' status.
+ */
+function shouldMarkBlocked(sidecar, currentContinueReason, consecutiveThreshold = 3) {
+    if (sidecar.lastContinueReason === currentContinueReason) {
+        return (sidecar.blocked?.consecutiveTurns ?? 0) + 1 >= consecutiveThreshold;
+    }
+    return false;
+}
+//# sourceMappingURL=goal-sidecar.js.map

package/dist/services/goal-sidecar.js.map

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

package/dist/services/goal-storage.d.ts

@@ -0,0 +1,22 @@
+/**
+ * v0.2.24 — Goal Storage.
+ *
+ * Atomic sidecar persistence for Session goals. Uses compare-and-swap
+ * revision, temporary file + atomic rename, and corrupt quarantine.
+ */
+import type { SessionGoalV1 } from '../runtime/goals/types';
+export type GoalStorageResult<T = void> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    error: 'not_found' | 'revision_stale' | 'corrupt' | 'io_error';
+    message: string;
+};
+export declare function loadGoal(projectPath: string, sessionId: string): GoalStorageResult<SessionGoalV1>;
+export declare function saveGoal(projectPath: string, sessionId: string, goal: SessionGoalV1, expectedRevision?: number): GoalStorageResult;
+export declare function deleteGoal(projectPath: string, sessionId: string): GoalStorageResult;
+export declare function createGoal(projectPath: string, sessionId: string, objective: string): GoalStorageResult<SessionGoalV1>;
+export declare const GOAL_SIDECAR_SUFFIX = ".goal.json";
+export declare const GOAL_TMP_PREFIX = ".goal.json.tmp-";
+//# sourceMappingURL=goal-storage.d.ts.map

package/dist/services/goal-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"goal-storage.d.ts","sourceRoot":"","sources":["../../src/services/goal-storage.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAc,MAAM,wBAAwB,CAAC;AAcxE,MAAM,MAAM,iBAAiB,CAAC,CAAC,GAAG,IAAI,IAClC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GACtB;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,WAAW,GAAG,gBAAgB,GAAG,SAAS,GAAG,UAAU,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnG,wBAAgB,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,iBAAiB,CAAC,aAAa,CAAC,CA4BjG;AAED,wBAAgB,QAAQ,CACtB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,aAAa,EACnB,gBAAgB,CAAC,EAAE,MAAM,GACxB,iBAAiB,CA0BnB;AAED,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,iBAAiB,CAsBpF;AAED,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,iBAAiB,CAAC,aAAa,CAAC,CAqBtH;AAqBD,eAAO,MAAM,mBAAmB,eAAe,CAAC;AAChD,eAAO,MAAM,eAAe,oBAAoB,CAAC"}