@wrongstack/core 0.284.1 → 0.286.0

package/dist/{goal-store-Datpp-ar.d.ts → storage/goal-store.d.ts}

@@ -1,5 +1,4 @@
-import { E as EventBus } from './events-Bgnh43r9.js';
-
+import type { EventBus } from '../kernel/events.js';
 /**
  * Long-running autonomous mission. A goal survives across sessions and
  * drives the EternalAutonomyEngine — every iteration of the engine
@@ -9,7 +8,7 @@ import { E as EventBus } from './events-Bgnh43r9.js';
  * project-scoped on purpose: the goal belongs to the codebase, not the
  * REPL session.
  */
-interface JournalEntry {
+export interface JournalEntry {
     /** ISO timestamp of the iteration. */
     at: string;
     /** Sequential iteration counter (1-based, monotonically increasing). */
@@ -30,7 +29,7 @@ interface JournalEntry {
     /** Optional USD cost delta for this iteration (provider-estimated). */
     costUsd?: number | undefined;
 }
-interface GoalFile {
+export interface GoalFile {
     version: 1;
     /** The raw mission statement as entered by the user. */
     goal: string;
@@ -80,7 +79,7 @@ interface GoalFile {
     journal: JournalEntry[];
 }
 /** Cap on persisted journal entries — older entries are evicted FIFO. */
-declare const MAX_JOURNAL_ENTRIES = 500;
+export declare const MAX_JOURNAL_ENTRIES = 500;
 /**
  * Resolve the goal file path for a given project root.
  *
@@ -95,33 +94,42 @@ declare const MAX_JOURNAL_ENTRIES = 500;
  * disagreed with `/goal` and littered the home dir with thousands of stray
  * `<hash>/goal.json` directories that held nothing else.
  */
-declare function goalFilePath(projectRoot: string): string;
-declare function loadGoal(filePath: string, events?: EventBus): Promise<GoalFile | null>;
-declare function saveGoal(filePath: string, goal: GoalFile, events?: EventBus): Promise<void>;
-declare function emptyGoal(goal: string): GoalFile;
+export declare function goalFilePath(projectRoot: string): string;
+export declare function loadGoal(filePath: string, events?: EventBus, warn?: (msg: string) => void): Promise<GoalFile | null>;
+export declare function saveGoal(filePath: string, goal: GoalFile, events?: EventBus): Promise<void>;
+/**
+ * Atomically load, modify, and save a goal file under a file lock.
+ * Prevents lost-update races when the autonomy engine and CLI /goal commands
+ * write concurrently (both eternal and parallel engines may run simultaneously).
+ *
+ * `fn` receives the current GoalFile (or `null` if no goal exists yet)
+ * and must return the updated GoalFile (or `null` to delete).
+ */
+export declare function updateGoal(filePath: string, fn: (current: GoalFile | null) => GoalFile | null, events?: EventBus): Promise<void>;
+export declare function emptyGoal(goal: string): GoalFile;
 /**
  * Set progress estimate on a goal. Returns a new GoalFile.
  * Clamps progress to 0-100.
  */
-declare function setProgress(goal: GoalFile, progress: number, note?: string): GoalFile;
+export declare function setProgress(goal: GoalFile, progress: number, note?: string): GoalFile;
 /**
  * Append a journal entry, bumping iteration counters and trimming the
  * ring buffer. Returns a new GoalFile — does not mutate the argument.
  */
-declare function appendJournal(goal: GoalFile, entry: Omit<JournalEntry, 'iteration' | 'at'>): GoalFile;
+export declare function appendJournal(goal: GoalFile, entry: Omit<JournalEntry, 'iteration' | 'at'>): GoalFile;
 /**
  * Aggregate cumulative cost + tokens across all journal entries.
  */
-declare function summarizeUsage(goal: GoalFile): {
+export declare function summarizeUsage(goal: GoalFile): {
     totalCostUsd: number;
     totalInputTokens: number;
     totalOutputTokens: number;
     iterationsWithUsage: number;
 };
 /** Format the goal + recent journal as a human-readable status block. */
-declare function formatGoal(goal: GoalFile, journalLimit?: number): string;
+export declare function formatGoal(goal: GoalFile, journalLimit?: number): string;
 /** A single progress measurement at a point in time. */
-interface ProgressSnapshot {
+export interface ProgressSnapshot {
     at: string;
     progress: number;
     note?: string | undefined;
@@ -134,7 +142,7 @@ interface ProgressSnapshot {
  *   [progress: 100%]
  * Returns null if no match.
  */
-declare function parseProgressFromText(text: string): {
+export declare function parseProgressFromText(text: string): {
     progress: number;
     note?: string;
 } | null;
@@ -144,8 +152,7 @@ declare function parseProgressFromText(text: string): {
  * - progressHistory appended (last 200 entries kept)
  * - progress trend computed (accelerating/steady/stalling)
  */
-declare function recordProgress(goal: GoalFile, progress: number, note?: string): GoalFile;
+export declare function recordProgress(goal: GoalFile, progress: number, note?: string): GoalFile;
 /** Max progress history entries to retain. */
-declare const MAX_PROGRESS_HISTORY = 200;
-
-export { type GoalFile as G, type JournalEntry as J, MAX_JOURNAL_ENTRIES as M, type ProgressSnapshot as P, MAX_PROGRESS_HISTORY as a, appendJournal as b, setProgress as c, summarizeUsage as d, emptyGoal as e, formatGoal as f, goalFilePath as g, loadGoal as l, parseProgressFromText as p, recordProgress as r, saveGoal as s };
+export declare const MAX_PROGRESS_HISTORY = 200;
+//# sourceMappingURL=goal-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"goal-store.d.ts","sourceRoot":"","sources":["../../src/storage/goal-store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAOpD;;;;;;;;GAQG;AAEH,MAAM,WAAW,YAAY;IAC3B,sCAAsC;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,wEAAwE;IACxE,SAAS,EAAE,MAAM,CAAC;IAClB,0GAA0G;IAC1G,MAAM,EAAE,MAAM,GAAG,KAAK,GAAG,YAAY,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;IACzE,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IACtD,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,qDAAqD;IACrD,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IACvD,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,CAAC,CAAC;IACX,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACpC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC;;;OAGG;IACH,eAAe,CAAC,EAAE,gBAAgB,EAAE,GAAG,SAAS,CAAC;IACjD;;;OAGG;IACH,aAAa,CAAC,EAAE,cAAc,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;IACnE,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,cAAc,EAAE,MAAM,CAAC;IACvB,0EAA0E;IAC1E,UAAU,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IAC5C;;OAEG;IACH,SAAS,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,WAAW,GAAG,SAAS,CAAC;IACxE;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,8DAA8D;IAC9D,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAED,yEAAyE;AACzE,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAEvC;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,QAAQ,EACjB,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAC3B,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAqE1B;AAED,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CA4BjG;AAED;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,CAAC,OAAO,EAAE,QAAQ,GAAG,IAAI,KAAK,QAAQ,GAAG,IAAI,EACjD,MAAM,CAAC,EAAE,QAAQ,GAChB,OAAO,CAAC,IAAI,CAAC,CAuCf;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAahD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,QAAQ,EACd,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,MAAM,GACZ,QAAQ,CAOV;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,WAAW,GAAG,IAAI,CAAC,GAAG,QAAQ,CAcrG;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG;IAC9C,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,EAAE,MAAM,CAAC;CAC7B,CAcA;AAID,yEAAyE;AACzE,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,EAAE,YAAY,SAAK,GAAG,MAAM,CAmEpE;AAED,wDAAwD;AACxD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAS9F;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,QAAQ,EACd,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,MAAM,GACZ,QAAQ,CAaV;AAED,8CAA8C;AAC9C,eAAO,MAAM,oBAAoB,MAAM,CAAC"}