@wrongstack/core 0.313.1 → 0.316.1

package/dist/chronicle/index.js

@@ -18,12 +18,12 @@ import {
   createChronicleProjectAccess,
   isChronicleProjectServerAvailable,
   resolveChronicleProjectServerOptions
-} from "../chunk-ASX6AW36.js";
+} from "../chunk-LXWCMQNJ.js";
 import {
   childChronicleContext,
   createChronicleContext,
   startChronicleFileObserver
-} from "../chunk-62V2AFVG.js";
+} from "../chunk-U4FWBSO3.js";
 import {
   CHRONICLE_FACET_FIELDS,
   CHRONICLE_PROJECT_SERVER_MAX_FRAME_CHARS,
@@ -41,49 +41,49 @@ import {
   findChroniclePartitions,
   isChronicleMetricsAvailable,
   resolveChronicleRuntimeLocation
-} from "../chunk-AT4V4XGI.js";
+} from "../chunk-4BMVPOHO.js";
 import "../chunk-SZ6AYUIZ.js";
-import {
-  createChroniclePromptManifest
-} from "../chunk-2YU4WVBW.js";
-import "../chunk-H5E77KUJ.js";
-import "../chunk-TYW2GI5I.js";
+import "../chunk-J2WRWR37.js";
 import "../chunk-LHOA5DWA.js";
-import "../chunk-GFJOMSHG.js";
-import "../chunk-QRTG4XTI.js";
+import "../chunk-LA7CLDRW.js";
+import "../chunk-WAHQVNWT.js";
 import "../chunk-EODDVJBM.js";
-import "../chunk-CQQL4ZOQ.js";
-import "../chunk-RPOA7IAE.js";
-import "../chunk-FFSX2QDQ.js";
-import "../chunk-DEIQMBD2.js";
-import "../chunk-FNXVT7HF.js";
+import "../chunk-ZT7JNIGX.js";
+import "../chunk-W5VITDM2.js";
+import "../chunk-YPT4A46F.js";
+import "../chunk-B7F4WVP4.js";
 import "../chunk-WQTOVMGV.js";
-import "../chunk-AD7ZFZCS.js";
-import "../chunk-KBZGE6LN.js";
+import "../chunk-FNXVT7HF.js";
+import "../chunk-5BMIE7QG.js";
+import "../chunk-DYLPMV4Q.js";
 import "../chunk-5S437PRC.js";
-import "../chunk-WZO23AWO.js";
+import {
+  createChroniclePromptManifest
+} from "../chunk-2YU4WVBW.js";
+import "../chunk-6FHWXLPT.js";
+import "../chunk-M27LIEKV.js";
 import "../chunk-XEBHSJLT.js";
-import "../chunk-VB3H5WWB.js";
-import "../chunk-M2WF6AXG.js";
-import "../chunk-4XV6IR37.js";
+import "../chunk-6NWEVFEL.js";
+import "../chunk-LSMMOS2Z.js";
 import "../chunk-4VWO3ZXL.js";
-import "../chunk-EFEHDQGY.js";
-import "../chunk-AWNQ6ED6.js";
-import "../chunk-FSWCWSTS.js";
+import "../chunk-ZHZ2Y2DH.js";
+import "../chunk-HI3JGZR2.js";
+import "../chunk-HMLIGAU7.js";
 import "../chunk-TRT2HRWZ.js";
 import "../chunk-LX5QWLBL.js";
-import "../chunk-FAYRX2AD.js";
-import "../chunk-7ZHZE5EO.js";
+import "../chunk-POOOIWE5.js";
+import "../chunk-OSGLYW5J.js";
+import "../chunk-FC2ZGRF3.js";
+import "../chunk-THEGTRAG.js";
 import "../chunk-SVT4RNTR.js";
-import "../chunk-WEBMSQP2.js";
-import "../chunk-YNCVSFGF.js";
-import "../chunk-CB2HFKTP.js";
+import "../chunk-SAFHACFA.js";
+import "../chunk-VVBP6KGT.js";
 import "../chunk-KJ2ZTQSL.js";
 import "../chunk-B4AMLZPB.js";
+import "../chunk-PFZO3C6H.js";
 import "../chunk-O37BQ65S.js";
-import "../chunk-WOEZV3Q4.js";
+import "../chunk-25LSLC3G.js";
 import "../chunk-TBRL2RCC.js";
-import "../chunk-PFZO3C6H.js";
 export {
   CHRONICLE_FACET_FIELDS,
   CHRONICLE_PROJECT_SERVER_MAX_FRAME_CHARS,

package/dist/chronicle/legacy-journal-import.d.ts

@@ -9,11 +9,5 @@ export interface ChronicleLegacyImportResult {
     /** Day families refused for a broken chain; none of their events landed. */
     quarantined: ChronicleQuarantinedFamily[];
 }
-/** A chain break found while importing; carries enough context to act on. */
-export declare class ChronicleImportError extends Error {
-    readonly day: string;
-    readonly sequence: number;
-    constructor(message: string, day: string, sequence: number);
-}
 export declare function importLegacyChronicleJournal(journal: ChronicleSqliteJournal, directory: string): Promise<ChronicleLegacyImportResult>;
 //# sourceMappingURL=legacy-journal-import.d.ts.map

package/dist/chronicle/metrics-ingest.d.ts

@@ -54,6 +54,20 @@ export declare class ChronicleMetricsIngester {
     private ingestEventAtomically;
     private ingestEvent;
     private ingestDailyCounters;
+    /**
+     * Per-tool fold used by the auto-thinning pipeline. Distinct from
+     * `daily_counters` (which is name-agnostic): keyed by `(day, tool_name)`
+     * so `underusedTools()` can pick candidates without scanning the journal.
+     *
+     * `kind` selects which counter increments:
+     *   - `invocation` — `tool.started` and `tool.executed` (success)
+     *   - `failure`    — `tool.failed` and `tool.executed` with `!ok`
+     *
+     * `lastInvokedAt` is the event's wall-clock at fold time, not the tool's
+     * internal duration; the auto-thinning policy uses it to compute
+     * "days since last use" relative to the request's anchor day.
+     */
+    private ingestToolDaily;
     private ingestProvider;
     private ingestTokenCost;
     private ingestTask;

package/dist/chronicle/metrics-schema.d.ts

@@ -1,7 +1,7 @@
 import type { DatabaseSync } from 'node:sqlite';
 import type { ChronicleSignalFamily } from './query.js';
 import type { ChronicleEvent } from './types.js';
-export declare const SCHEMA_VERSION = 4;
+export declare const SCHEMA_VERSION = 6;
 export declare const READ_CHUNK_BYTES: number;
 export declare const SQLITE_SOURCE_PREFIX = "sqlite:";
 export declare const SQLITE_INGEST_BATCH = 2000;
@@ -28,6 +28,15 @@ export interface ChronicleProviderDailyRow {
     avgDurationMs: number;
     maxDurationMs: number;
 }
+/** A row of {@link ChronicleMetricsStore.underusedTools}. */
+export interface ChronicleUnderusedToolRow {
+    toolName: string;
+    invocations: number;
+    failures: number;
+    durationMsTotal: number;
+    lastInvokedAt: number | null;
+    daysSinceLastUse: number | null;
+}
 export interface ChronicleTaskOutcomeRow {
     taskId: string;
     runId: string;

package/dist/chronicle/metrics-store.d.ts

@@ -8,9 +8,10 @@
  * the previous run (per-partition byte offsets in `ingest_state`), so the
  * raw JSONL partitions can be purged by retention without losing metrics.
  */
+import { type ChronicleFileLineageRow, type ChronicleMetricsRefreshResult, type ChronicleMetricsSummary, type ChronicleProviderDailyRow, type ChronicleTaskOutcomeRow, type ChronicleUnderusedToolRow, isChronicleMetricsAvailable } from './metrics-schema.js';
 import type { ChronicleSummary } from './query.js';
-import { isChronicleMetricsAvailable, type ChronicleFileLineageRow, type ChronicleMetricsRefreshResult, type ChronicleMetricsSummary, type ChronicleProviderDailyRow, type ChronicleTaskOutcomeRow } from './metrics-schema.js';
-export { isChronicleMetricsAvailable, type ChronicleFileLineageRow, type ChronicleMetricsRefreshResult, type ChronicleMetricsSummary, type ChronicleProviderDailyRow, type ChronicleTaskOutcomeRow, };
+export type { ChronicleFileLineageRow, ChronicleMetricsRefreshResult, ChronicleMetricsSummary, ChronicleProviderDailyRow, ChronicleTaskOutcomeRow, ChronicleUnderusedToolRow, };
+export { isChronicleMetricsAvailable };
 export declare class ChronicleMetricsStore {
     private readonly db;
     private readonly directory;
@@ -43,6 +44,23 @@ export declare class ChronicleMetricsStore {
         limit?: number;
     }): ChronicleFileLineageRow[];
     summary(): ChronicleMetricsSummary;
+    /**
+     * Per-tool candidates for the auto-thinning pipeline. Returns one row per
+     * tool that has at least one day in `[fromDay, toDay]` (default: last 30
+     * days), with `invocations` summed across the window and `lastInvokedAt`
+     * taken as the max. The caller is responsible for the "underused" filter
+     * (`invocations <= maxInvocations`, `lastInvokedAt` older than
+     * `toDay - idleDays`) and for excluding tools still active in the window.
+     *
+     * The query intentionally does NOT pre-filter by threshold — the policy
+     * layer owns that decision so the same data feeds both the dry-run
+     * (`/tool autothin candidates`) and the apply path.
+     */
+    underusedTools(options?: {
+        from?: string;
+        to?: string;
+        limit?: number;
+    }): ChronicleUnderusedToolRow[];
     /**
      * A `ChronicleSummary` for the default/unfiltered dashboard view — only
      * `from`/`to` (day-precision) narrow it.

package/dist/chronicle/project-server.js

@@ -2,7 +2,7 @@
 import {
   createChronicleContext,
   startChronicleFileObserver
-} from "../chunk-62V2AFVG.js";
+} from "../chunk-U4FWBSO3.js";
 import {
   CHRONICLE_MAX_APPEND_BATCH,
   CHRONICLE_PROJECT_SERVER_MAX_FRAME_CHARS,
@@ -17,54 +17,54 @@ import {
   encodeChronicleProjectServerMessage,
   importLegacyChronicleJournal,
   resolveChronicleRuntimeLocation
-} from "../chunk-AT4V4XGI.js";
+} from "../chunk-4BMVPOHO.js";
 import "../chunk-SZ6AYUIZ.js";
-import {
-  restrictFilePermissions
-} from "../chunk-H5E77KUJ.js";
-import "../chunk-TYW2GI5I.js";
+import "../chunk-J2WRWR37.js";
 import "../chunk-LHOA5DWA.js";
-import "../chunk-GFJOMSHG.js";
-import "../chunk-QRTG4XTI.js";
+import "../chunk-LA7CLDRW.js";
+import "../chunk-WAHQVNWT.js";
 import "../chunk-EODDVJBM.js";
-import "../chunk-CQQL4ZOQ.js";
-import "../chunk-RPOA7IAE.js";
-import "../chunk-FFSX2QDQ.js";
-import "../chunk-DEIQMBD2.js";
+import "../chunk-ZT7JNIGX.js";
+import "../chunk-W5VITDM2.js";
+import "../chunk-YPT4A46F.js";
+import "../chunk-B7F4WVP4.js";
+import "../chunk-WQTOVMGV.js";
 import {
   useDaemonPerfDefaults
 } from "../chunk-FNXVT7HF.js";
-import "../chunk-WQTOVMGV.js";
-import "../chunk-AD7ZFZCS.js";
+import "../chunk-5BMIE7QG.js";
 import {
   startSharedHeapWatchdog
-} from "../chunk-KBZGE6LN.js";
+} from "../chunk-DYLPMV4Q.js";
 import "../chunk-5S437PRC.js";
-import "../chunk-WZO23AWO.js";
+import {
+  restrictFilePermissions
+} from "../chunk-6FHWXLPT.js";
+import "../chunk-M27LIEKV.js";
 import "../chunk-XEBHSJLT.js";
-import "../chunk-VB3H5WWB.js";
-import "../chunk-M2WF6AXG.js";
-import "../chunk-4XV6IR37.js";
+import "../chunk-6NWEVFEL.js";
+import "../chunk-LSMMOS2Z.js";
 import "../chunk-4VWO3ZXL.js";
-import "../chunk-EFEHDQGY.js";
-import "../chunk-AWNQ6ED6.js";
-import "../chunk-FSWCWSTS.js";
+import "../chunk-ZHZ2Y2DH.js";
+import "../chunk-HI3JGZR2.js";
+import "../chunk-HMLIGAU7.js";
 import "../chunk-TRT2HRWZ.js";
 import "../chunk-LX5QWLBL.js";
-import "../chunk-FAYRX2AD.js";
+import "../chunk-POOOIWE5.js";
 import {
   atomicWrite
-} from "../chunk-7ZHZE5EO.js";
+} from "../chunk-OSGLYW5J.js";
+import "../chunk-FC2ZGRF3.js";
+import "../chunk-THEGTRAG.js";
 import "../chunk-SVT4RNTR.js";
-import "../chunk-WEBMSQP2.js";
-import "../chunk-YNCVSFGF.js";
-import "../chunk-CB2HFKTP.js";
+import "../chunk-SAFHACFA.js";
+import "../chunk-VVBP6KGT.js";
 import "../chunk-KJ2ZTQSL.js";
 import "../chunk-B4AMLZPB.js";
+import "../chunk-PFZO3C6H.js";
 import "../chunk-O37BQ65S.js";
-import "../chunk-WOEZV3Q4.js";
+import "../chunk-25LSLC3G.js";
 import "../chunk-TBRL2RCC.js";
-import "../chunk-PFZO3C6H.js";
 
 // src/chronicle/project-server.ts
 import { randomBytes } from "node:crypto";
@@ -94,13 +94,15 @@ function parseArgs(argv) {
     if (!values.get(key)) throw new Error(`Chronicle project server requires ${key}`);
   }
   const retentionInput = Number(values.get("--retention-days"));
+  const durabilityInput = values.get("--durability") ?? process.env["WRONGSTACK_CHRONICLE_DURABILITY"] ?? "";
   return {
     projectRoot: path.resolve(values.get("--project-root")),
     globalRoot: path.resolve(values.get("--global-root")),
     projectId: values.get("--project-id"),
     projectDir: path.resolve(values.get("--project-dir")),
     workspaceId: values.get("--workspace-id"),
-    retentionDays: Number.isFinite(retentionInput) && retentionInput > 0 ? retentionInput : 30
+    retentionDays: Number.isFinite(retentionInput) && retentionInput > 0 ? retentionInput : 30,
+    durability: durabilityInput.trim().toLowerCase() === "full" ? "full" : "normal"
   };
 }
 useDaemonPerfDefaults();
@@ -176,6 +178,7 @@ function store() {
     const journal = new ChronicleSqliteJournal({
       directory: chronicleDirectory,
       retentionDays: parsed.retentionDays,
+      durability: parsed.durability,
       // Bound burst growth independently of age retention. Prefix eviction keeps
       // at most this many rows while preserving chain verification via checkpoints.
       maxEvents: 1e5,
@@ -263,6 +266,10 @@ async function appendInputs(inputs) {
 }
 var watcherSink = {
   append: async (input) => (await appendInputs([input]))[0],
+  // The file observer reconciles a whole burst at once (a branch switch, a
+  // build drop). Routing that through `appendInputs` as ONE call keeps it to
+  // one `BEGIN IMMEDIATE` + one fsync instead of one per changed file.
+  appendBatch: (inputs) => appendInputs([...inputs]),
   flush: async () => flushJournals(),
   stats: () => journalForToday().stats()
 };
@@ -520,7 +527,8 @@ async function stop(_reason) {
       else resolve2();
     });
   });
-  await watcher?.close().catch(() => {
+  await watcher?.close().catch((error) => {
+    watcherLastError = error instanceof Error ? error.message : String(error);
   });
   watcher = void 0;
   await flushJournals().catch(() => {

package/dist/chronicle/sink.d.ts

@@ -8,6 +8,19 @@ import type { ChronicleEvent, ChronicleEventInput } from './types.js';
  */
 export interface ChronicleEventSink {
     append(input: ChronicleEventInput): Promise<ChronicleEvent>;
+    /**
+     * Append many events as ONE unit of work. Optional: adapters that emit a
+     * single event per call have nothing to gain, and leaving it optional keeps
+     * every existing sink (and test double) valid without a shim.
+     *
+     * The SQLite journal wraps each append in `BEGIN IMMEDIATE` and, at
+     * `synchronous = FULL`, fsyncs on commit. Callers that produce a burst —
+     * the file observer reconciling a branch switch, say — turn N transactions
+     * and N fsyncs into one by routing through here. SQLite's binding is
+     * synchronous, so `Promise.all` over N `append()` calls does NOT overlap
+     * them; batching is the only thing that actually helps.
+     */
+    appendBatch?(inputs: readonly ChronicleEventInput[]): Promise<ChronicleEvent[]>;
     flush(): Promise<void>;
     stats(): ChronicleJournalStats;
 }

package/dist/chronicle/sqlite-journal.d.ts

@@ -1,9 +1,9 @@
 import type { ChronicleJournalStats, ChroniclePurgeResult } from './journal.js';
 import { ChronicleStorageQuotaError } from './sqlite-journal-quota.js';
-import { CHRONICLE_SQLITE_FILE, LEGACY_JSONL_BOUNDARY_KEY, LEGACY_JSONL_MIGRATION_KEY, LEGACY_JSONL_QUARANTINE_KEY } from './sqlite-journal-schema.js';
+import { CHRONICLE_SQLITE_FILE, LEGACY_JSONL_BOUNDARY_KEY, LEGACY_JSONL_MIGRATION_KEY } from './sqlite-journal-schema.js';
 import { ChronicleSqliteQueryEngine, type ChronicleSqliteQueryEngineOptions } from './sqlite-query.js';
 import { type ChronicleEvent, type ChronicleEventInput, type ChronicleVerifyResult } from './types.js';
-export { CHRONICLE_SQLITE_FILE, ChronicleStorageQuotaError, LEGACY_JSONL_BOUNDARY_KEY, LEGACY_JSONL_MIGRATION_KEY, LEGACY_JSONL_QUARANTINE_KEY, };
+export { CHRONICLE_SQLITE_FILE, ChronicleStorageQuotaError, LEGACY_JSONL_BOUNDARY_KEY, LEGACY_JSONL_MIGRATION_KEY };
 export interface ChronicleSqliteJournalOptions {
     /** Directory holding the journal, i.e. `<projectDir>/chronicle`. */
     directory: string;
@@ -17,6 +17,24 @@ export interface ChronicleSqliteJournalOptions {
     /** Aggregate SQLite allocation ceiling across the database, WAL, and SHM files. */
     maxBytes?: number | undefined;
     retentionCheckIntervalMs?: number | undefined;
+    /**
+     * WAL durability level. Defaults to `'normal'`.
+     *
+     * In WAL mode `NORMAL` still survives a **process** crash — an aborted
+     * agent, an OOM kill, a `taskkill` — because the WAL is already written;
+     * only an OS crash or power loss can cost the last commits. `FULL` adds an
+     * fsync to every commit to close that last gap.
+     *
+     * This journal is the highest-volume writer in the runtime (measured at
+     * ~7.2GB over 7 days), so that per-commit fsync was the single largest
+     * source of disk I/O in the system — paid continuously, for telemetry that
+     * is reconstructible from the session logs. Every other SQLite store here
+     * (mailbox, kanban, techstack, vector-memory) runs `NORMAL`.
+     *
+     * Set `'full'` when the deployment genuinely needs power-loss durability
+     * for the audit trail.
+     */
+    durability?: 'normal' | 'full' | undefined;
 }
 export interface ChronicleSqlitePurgeOptions {
     retentionDays: number;

package/dist/{chunk-WOEZV3Q4.js → chunk-25LSLC3G.js}

@@ -36,6 +36,7 @@ var ERROR_CODES = {
   SESSION_NOT_FOUND: "SESSION_NOT_FOUND",
   SESSION_CORRUPTED: "SESSION_CORRUPTED",
   SESSION_WRITE_FAILED: "SESSION_WRITE_FAILED",
+  SESSION_ID_REQUIRED: "SESSION_ID_REQUIRED",
   // Container / Registry
   CONTAINER_TOKEN_ALREADY_BOUND: "CONTAINER_TOKEN_ALREADY_BOUND",
   CONTAINER_TOKEN_NOT_BOUND: "CONTAINER_TOKEN_NOT_BOUND",
@@ -330,4 +331,4 @@ export {
   isParseError,
   isSddError
 };
-//# sourceMappingURL=chunk-WOEZV3Q4.js.map
+//# sourceMappingURL=chunk-25LSLC3G.js.map