@jungjaehoon/mama-os 0.53.0 → 0.57.0

package/dist/operator/board-slot-instructions.js

@@ -4,9 +4,8 @@
  *
  * Every report producer (dashboard agent persona, its scheduled prompt, the
  * trigger loop's scheduled full report) injects THESE lines so the operator
- * board at /viewer#operator/board receives the same 4-slot, card-based HTML regardless of which
- * agent wrote it. The classes are styled by ui/src/styles/global.css --
- * agents write structure, the board owns look.
+ * report store receives the same 4-slot, card-based HTML regardless of which agent wrote it.
+ * Agents write structure while report consumers own presentation.
  *
  * Generic mechanism only: no personal strings, English source; the agent is
  * told to write CONTENT in the owner's language.
@@ -22,7 +21,7 @@ exports.boardStructuralClasses = boardStructuralClasses;
 exports.htmlUsesBoardVocabulary = htmlUsesBoardVocabulary;
 exports.BOARD_SLOT_ORDER = ['briefing', 'action_required', 'decisions', 'pipeline'];
 /** The exact HTML shapes the board stylesheet understands. */
-function buildBoardHtmlVocabulary() {
+function buildBoardHtmlVocabulary(timeZone) {
     return [
         'Slot HTML must use ONLY this class vocabulary (the board styles it; inline styles are unnecessary):',
         '- Summary header: <div class="report-summary"><div class="summary-title">TITLE</div>',
@@ -31,7 +30,10 @@ function buildBoardHtmlVocabulary() {
         '- Item card: <div class="report-card"><div class="card-header"><div class="card-title">TITLE</div>',
         '  <span class="card-badge badge-warning">STATE</span></div>',
         '  <div class="card-tags"><span class="tag tag-channel">CHANNEL</span></div>',
+        '  <div class="card-meta">WHEN</div>',
         '  <div class="card-action">CONCRETE NEXT ACTION</div></div>',
+        '- card-meta is required on every card: the source time of the latest change the card reports,',
+        `  in ${timeZone} as month/day and HH:mm (for example 9/26 17:54), plus the due date when one exists.`,
         '- Workflow badge classes: badge-danger (blocked), badge-warning (waiting/needs confirmation),',
         '  badge-info (in progress), badge-success (done/quiet).',
         '- Temporal badges are separate facts: badge-danger (overdue), badge-warning (due today),',
@@ -43,12 +45,12 @@ function buildBoardHtmlVocabulary() {
 }
 /**
  * Per-slot shape the board expects. Single source for the legacy persona's
- * publish block and for the report_publish tool contract the standing owner
+ * publish block and for the report.publish contract the standing owner
  * runtime reads through tool_describe at publish time.
  */
 function buildBoardSlotShapeLines() {
     return [
-        '- pipeline: rendered by the host from the task ledger and already published. Never write it.',
+        '- pipeline: the agent-written current workflow table; update it together with the other slots.',
         '- briefing: one report-summary block (title + stat highlights), then up to 4 report-cards for the key situations.',
         '- action_required: a report-section-title, then up to 5 report-cards; every card-action states the concrete next step.',
         '- decisions: report-cards for items waiting on an owner decision or confirmation; omit filler when none exist,',
@@ -56,19 +58,18 @@ function buildBoardSlotShapeLines() {
     ];
 }
 /**
- * The report_publish tool description. The board's class vocabulary belongs
+ * The report.publish summary. The board's class vocabulary belongs
  * with the tool that publishes it, not in per-turn prompt text: an agent that
- * describes report_publish before calling it learns the shape the board styles.
+ * describes report.publish before calling it learns the shape the board styles.
  */
-function buildReportPublishToolContract() {
+function buildReportPublishToolContract(timeZone) {
     const inline = (lines) => lines.join(' ').replace(/\s+/g, ' ').trim();
     return inline([
         'Publish dashboard analysis as HTML.',
-        'pipeline is a managed live task projection; change tasks instead.',
-        'Supply the task basis actually used for analysis; omission means its basis is unknown.',
+        'pipeline is an agent-authored current workflow view; write it from the task ledger and conversations.',
         'SLOT SHAPE:',
         ...buildBoardSlotShapeLines(),
-        ...buildBoardHtmlVocabulary(),
+        ...buildBoardHtmlVocabulary(timeZone),
         "Write slot CONTENT in the owner's language; keep each slot under 6KB.",
         'A slot that contains none of report-summary / report-card / report-section-title / report-table',
         'is still published, but the result reports it back as a',
@@ -76,13 +77,13 @@ function buildReportPublishToolContract() {
     ]);
 }
 /** Instruction block that makes a report run also publish the board slots. */
-function buildBoardPublishLines() {
+function buildBoardPublishLines(timeZone) {
     return [
-        'BEFORE writing your text report, update the operator board: call the report_publish',
-        'gateway tool EXACTLY once with the THREE judgment slots:',
-        '  report_publish({ slots: { briefing: "<html>", action_required: "<html>", decisions: "<html>" } })',
+        'BEFORE writing your text report, update the operator board: call the report.publish',
+        'gateway tool EXACTLY once with all FOUR board slots:',
+        '  report.publish({ slots: { briefing: "<html>", action_required: "<html>", decisions: "<html>", pipeline: "<html>" } })',
         ...buildBoardSlotShapeLines(),
-        ...buildBoardHtmlVocabulary(),
+        ...buildBoardHtmlVocabulary(timeZone),
         "Write all slot CONTENT in the owner's language (match the channels); keep each slot under 6KB.",
         'The plain-text report you write afterwards is a separate output: no HTML in it.',
     ];
@@ -107,9 +108,9 @@ const BOARD_STRUCTURAL_CLASSES = [
  * a class is added to buildBoardHtmlVocabulary() it becomes recognised here.
  * `structural` marks the subset that makes a slot count as board HTML.
  */
-function boardHtmlClassVocabulary() {
+function boardHtmlClassVocabulary(timeZone) {
     const classes = new Set();
-    for (const line of buildBoardHtmlVocabulary()) {
+    for (const line of buildBoardHtmlVocabulary(timeZone)) {
         for (const match of line.matchAll(/class="([^"]*)"/g)) {
             for (const token of match[1].split(/\s+/)) {
                 if (token)
@@ -142,10 +143,10 @@ function boardStructuralClasses() {
  * built out of sub-element classes alone (badge-*, tag-*, summary-*, card-*)
  * does NOT pass -- the board renders it as plain text.
  */
-function htmlUsesBoardVocabulary(html) {
+function htmlUsesBoardVocabulary(html, timeZone) {
     if (typeof html !== 'string' || html.length === 0)
         return false;
-    const { structural } = boardHtmlClassVocabulary();
+    const { structural } = boardHtmlClassVocabulary(timeZone);
     for (const match of html.matchAll(/class\s*=\s*(?:"([^"]*)"|'([^']*)')/g)) {
         const value = match[1] ?? match[2] ?? '';
         for (const token of value.split(/\s+/)) {

package/dist/operator/board-slot-instructions.js.map

@@ -1 +1 @@
-{"version":3,"file":"board-slot-instructions.js","sourceRoot":"","sources":["../../src/operator/board-slot-instructions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"board-slot-instructions.js","sourceRoot":"","sources":["../../src/operator/board-slot-instructions.ts"],"names":[],"mappings":"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"}

package/dist/replay/import-manifest.d.ts

@@ -0,0 +1,21 @@
+import type { DatabaseInstance } from '@jungjaehoon/mama-core/db-manager';
+import type { RawIndexSink, RawStore } from '../storage/source-archive.js';
+export interface ImportManifest {
+    /** Inclusive start and exclusive import fence T, both epoch milliseconds. */
+    fromMs: number;
+    untilMs: number;
+    maxSourceAtMs: number | null;
+    countsByOriginDay: Record<string, Record<string, number>>;
+    rawObservationCount: number;
+    indexCount: number;
+    pendingProjectionCount: number;
+    unmappedByOrigin?: Record<string, number>;
+    trelloCountsByBoardDay?: Record<string, Record<string, number>>;
+}
+/** Persist only bounded import metadata. The caller chooses the destination explicitly. */
+export declare function writeImportManifest(path: string, manifest: ImportManifest): void;
+export declare function readImportManifest(path: string): ImportManifest;
+export declare function createCoreRawIndexSink(adapter: DatabaseInstance): RawIndexSink;
+export declare function assertRawProjectionQueuesEmpty(rawStore: RawStore): void;
+export declare function drainRawProjections(rawStore: RawStore, rawIndexSink: RawIndexSink): Promise<number>;
+//# sourceMappingURL=import-manifest.d.ts.map

package/dist/replay/import-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-manifest.d.ts","sourceRoot":"","sources":["../../src/replay/import-manifest.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAE1E,OAAO,KAAK,EAIV,YAAY,EACZ,QAAQ,EACT,MAAM,8BAA8B,CAAC;AAGtC,MAAM,WAAW,cAAc;IAC7B,6EAA6E;IAC7E,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1D,mBAAmB,EAAE,MAAM,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,sBAAsB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACjE;AAsED,2FAA2F;AAC3F,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,IAAI,CAchF;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAW/D;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,gBAAgB,GAAG,YAAY,CAW9E;AAED,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAOvE;AAED,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,QAAQ,EAClB,YAAY,EAAE,YAAY,GACzB,OAAO,CAAC,MAAM,CAAC,CAqCjB"}

package/dist/replay/import-manifest.js

@@ -0,0 +1,157 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeImportManifest = writeImportManifest;
+exports.readImportManifest = readImportManifest;
+exports.createCoreRawIndexSink = createCoreRawIndexSink;
+exports.assertRawProjectionQueuesEmpty = assertRawProjectionQueuesEmpty;
+exports.drainRawProjections = drainRawProjections;
+const node_crypto_1 = require("node:crypto");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const source_archive_js_1 = require("../storage/source-archive.js");
+const event_index_js_1 = require("../connectors/framework/event-index.js");
+function finiteInteger(value, field, nullable = false) {
+    if (nullable && value === null)
+        return null;
+    if (typeof value !== 'number' || !Number.isSafeInteger(value) || value < 0) {
+        throw new Error(`${field} must be a nonnegative epoch-millisecond integer`);
+    }
+    return value;
+}
+function countRecord(value, field) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error(`${field} must be an object of bounded counts`);
+    }
+    const result = {};
+    for (const [key, count] of Object.entries(value)) {
+        if (key.trim() === '')
+            throw new Error(`${field} contains a blank key`);
+        if (typeof count !== 'number' || !Number.isSafeInteger(count) || count < 0) {
+            throw new Error(`${field}.${key} must be a nonnegative integer`);
+        }
+        result[key] = count;
+    }
+    return result;
+}
+function normalizeManifest(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error('Import manifest must contain an object');
+    }
+    const row = value;
+    const fromMs = finiteInteger(row.fromMs, 'fromMs');
+    const untilMs = finiteInteger(row.untilMs, 'untilMs');
+    if (untilMs < fromMs)
+        throw new Error('Import manifest untilMs must not precede fromMs');
+    const rawCounts = row.countsByOriginDay;
+    if (!rawCounts || typeof rawCounts !== 'object' || Array.isArray(rawCounts)) {
+        throw new Error('countsByOriginDay must be an object of origin/day counts');
+    }
+    const countsByOriginDay = {};
+    for (const [origin, days] of Object.entries(rawCounts)) {
+        countsByOriginDay[origin] = countRecord(days, `countsByOriginDay.${origin}`);
+    }
+    const manifest = {
+        fromMs,
+        untilMs,
+        maxSourceAtMs: finiteInteger(row.maxSourceAtMs, 'maxSourceAtMs', true),
+        countsByOriginDay,
+        rawObservationCount: finiteInteger(row.rawObservationCount, 'rawObservationCount'),
+        indexCount: finiteInteger(row.indexCount, 'indexCount'),
+        pendingProjectionCount: finiteInteger(row.pendingProjectionCount, 'pendingProjectionCount'),
+    };
+    if (row.unmappedByOrigin !== undefined) {
+        manifest.unmappedByOrigin = countRecord(row.unmappedByOrigin, 'unmappedByOrigin');
+    }
+    if (row.trelloCountsByBoardDay !== undefined) {
+        if (!row.trelloCountsByBoardDay ||
+            typeof row.trelloCountsByBoardDay !== 'object' ||
+            Array.isArray(row.trelloCountsByBoardDay)) {
+            throw new Error('trelloCountsByBoardDay must be an object of board/day counts');
+        }
+        const counts = {};
+        for (const [board, days] of Object.entries(row.trelloCountsByBoardDay)) {
+            counts[board] = countRecord(days, `trelloCountsByBoardDay.${board}`);
+        }
+        manifest.trelloCountsByBoardDay = counts;
+    }
+    return manifest;
+}
+/** Persist only bounded import metadata. The caller chooses the destination explicitly. */
+function writeImportManifest(path, manifest) {
+    const normalized = normalizeManifest(manifest);
+    (0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(path), { recursive: true });
+    const temporaryPath = `${path}.${(0, node_crypto_1.randomUUID)()}.tmp`;
+    try {
+        (0, node_fs_1.writeFileSync)(temporaryPath, `${JSON.stringify(normalized, null, 2)}\n`, {
+            encoding: 'utf8',
+            flag: 'wx',
+        });
+        (0, node_fs_1.renameSync)(temporaryPath, path);
+    }
+    catch (error) {
+        (0, node_fs_1.rmSync)(temporaryPath, { force: true });
+        throw error;
+    }
+}
+function readImportManifest(path) {
+    if (!(0, node_fs_1.existsSync)(path))
+        throw new Error(`Import manifest does not exist: ${path}`);
+    let parsed;
+    try {
+        parsed = JSON.parse((0, node_fs_1.readFileSync)(path, 'utf8'));
+    }
+    catch (error) {
+        throw new Error(`Import manifest is unreadable: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    return normalizeManifest(parsed);
+}
+function createCoreRawIndexSink(adapter) {
+    return (connectorName, items) => {
+        return (0, source_archive_js_1.mapNormalizedItemsToConnectorEventIndexInputs)(connectorName, items).map((input) => {
+            const record = (0, event_index_js_1.upsertConnectorEventIndex)(adapter, input);
+            const observationRef = record.current_observation_id;
+            if (!observationRef) {
+                throw new Error(`Raw index projection omitted an observation ref for ${connectorName}`);
+            }
+            return { sourceId: input.source_id, observationRef };
+        });
+    };
+}
+function assertRawProjectionQueuesEmpty(rawStore) {
+    const pending = rawStore
+        .listConnectorNames()
+        .reduce((total, connector) => total + rawStore.pendingProjectionCount(connector), 0);
+    if (pending !== 0) {
+        throw new Error(`Collect-only import requires empty raw projection queues; found ${pending}`);
+    }
+}
+async function drainRawProjections(rawStore, rawIndexSink) {
+    let projected = 0;
+    for (const connector of rawStore.listConnectorNames()) {
+        let afterSequence = 0;
+        let keepPaging = true;
+        while (keepPaging) {
+            const page = rawStore.listPendingProjections(connector, 1_000, afterSequence);
+            if (page.length === 0) {
+                keepPaging = false;
+                continue;
+            }
+            const acknowledgements = [];
+            for (const projection of page) {
+                const saved = await rawIndexSink(connector, [projection]);
+                if (saved.length !== 1 || saved[0]?.sourceId !== projection.sourceId) {
+                    throw new Error(`Raw index projection returned the wrong source identity for ${connector}`);
+                }
+                acknowledgements.push({
+                    revisionSourceId: projection.sourceId,
+                    pendingProjectionId: projection.pendingProjectionId,
+                });
+                projected += 1;
+            }
+            rawStore.acknowledgeProjections(connector, acknowledgements);
+            afterSequence = page[page.length - 1].pendingProjectionId;
+        }
+    }
+    return projected;
+}
+//# sourceMappingURL=import-manifest.js.map

package/dist/replay/import-manifest.js.map

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

package/dist/replay/jev-client.d.ts

@@ -0,0 +1,35 @@
+export interface JevQuestion {
+    readonly type: string;
+    readonly instructions: string;
+}
+export type JevQuestions = Readonly<Record<string, JevQuestion>>;
+export type JevAnswers = Readonly<Record<string, Record<string, unknown>>>;
+export interface JevBatchRequest {
+    readonly state: unknown;
+    readonly questions: JevQuestions;
+    readonly observationRefs: readonly string[];
+}
+export interface JevClientOptions {
+    readonly keyFile: string;
+    readonly vocabFile: string;
+    readonly endpoint?: string;
+    readonly model?: string;
+    readonly fetch?: typeof fetch;
+    readonly sleep?: (milliseconds: number) => Promise<void>;
+    readonly readKey?: (path: string) => string;
+    readonly readVocab?: (path: string) => unknown;
+}
+export declare class JevBatchIncompleteError extends Error {
+    readonly observationRefs: readonly string[];
+    readonly cause: unknown;
+    constructor(observationRefs: readonly string[], cause: unknown);
+}
+interface JevClient {
+    readonly vocabulary: unknown;
+    ask(request: JevBatchRequest): Promise<JevAnswers>;
+    askBatch(requests: readonly JevBatchRequest[]): Promise<readonly JevAnswers[]>;
+}
+export declare function createJevClient(options: JevClientOptions): JevClient;
+export declare function pool<T>(items: readonly T[], worker: (item: T) => Promise<void>, concurrency?: number): Promise<void>;
+export {};
+//# sourceMappingURL=jev-client.d.ts.map

package/dist/replay/jev-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jev-client.d.ts","sourceRoot":"","sources":["../../src/replay/jev-client.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;AACjE,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AAE3E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC5C,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CAChD;AAED,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;gBAEZ,eAAe,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO;CAO/D;AAED,UAAU,SAAS;IACjB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,GAAG,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACnD,QAAQ,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,GAAG,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CAAC;CAChF;AA6BD,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CAiFpE;AAED,wBAAsB,IAAI,CAAC,CAAC,EAC1B,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,EAClC,WAAW,SAAI,GACd,OAAO,CAAC,IAAI,CAAC,CAcf"}

package/dist/replay/jev-client.js

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JevBatchIncompleteError = void 0;
+exports.createJevClient = createJevClient;
+exports.pool = pool;
+const node_fs_1 = require("node:fs");
+class JevBatchIncompleteError extends Error {
+    observationRefs;
+    cause;
+    constructor(observationRefs, cause) {
+        const message = cause instanceof Error ? cause.message : String(cause);
+        super(`Jev batch incomplete for observation refs: ${observationRefs.join(', ')}: ${message}`);
+        this.name = 'JevBatchIncompleteError';
+        this.observationRefs = Object.freeze([...observationRefs]);
+        this.cause = cause;
+    }
+}
+exports.JevBatchIncompleteError = JevBatchIncompleteError;
+const DEFAULT_ENDPOINT = 'https://api.typesafe.ai/v1/systemone';
+const MAX_ATTEMPTS = 3;
+function object(value, field) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error(`Jev ${field} must be an object`);
+    }
+    return value;
+}
+function readJson(path) {
+    return JSON.parse((0, node_fs_1.readFileSync)(path, 'utf8'));
+}
+/** The API's error type and request id, so a failure can be traced with the provider. */
+function errorDetail(text) {
+    try {
+        const detail = JSON.parse(text)
+            .detail;
+        const type = typeof detail?.error_type === 'string' ? detail.error_type : null;
+        const id = typeof detail?.request_id === 'string' ? detail.request_id : null;
+        return type || id ? ` (${[type, id].filter(Boolean).join(', ')})` : '';
+    }
+    catch {
+        return '';
+    }
+}
+function createJevClient(options) {
+    const requestFetch = options.fetch ?? globalThis.fetch;
+    if (typeof requestFetch !== 'function')
+        throw new Error('Jev fetch is unavailable');
+    const sleep = options.sleep ??
+        ((milliseconds) => new Promise((resolve) => setTimeout(resolve, milliseconds)));
+    const readKey = options.readKey ?? ((path) => (0, node_fs_1.readFileSync)(path, 'utf8'));
+    const readVocab = options.readVocab ?? readJson;
+    let key;
+    let vocabulary;
+    const loadKey = () => {
+        if (key === undefined) {
+            const value = readKey(options.keyFile).trim();
+            if (value === '')
+                throw new Error('Jev key file is empty');
+            key = value;
+        }
+        return key;
+    };
+    const loadVocabulary = () => {
+        if (vocabulary === undefined)
+            vocabulary = object(readVocab(options.vocabFile), 'vocabulary');
+        return vocabulary;
+    };
+    const ask = async (request) => {
+        const body = {
+            model: options.model ?? 'jev-latest',
+            state: request.state,
+            questions: request.questions,
+        };
+        let lastRetryStatus = 529;
+        let lastDetail = '';
+        for (let attempt = 0; attempt < MAX_ATTEMPTS; attempt += 1) {
+            const response = await requestFetch(options.endpoint ?? DEFAULT_ENDPOINT, {
+                method: 'POST',
+                headers: {
+                    Authorization: `Bearer ${loadKey()}`,
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify(body),
+            });
+            const text = await response.text();
+            if (response.ok) {
+                let parsed;
+                try {
+                    parsed = JSON.parse(text);
+                }
+                catch {
+                    throw new Error('Jev response is not JSON');
+                }
+                const answers = object(parsed, 'answers response').answers;
+                return object(answers, 'answers');
+            }
+            // 429/529 are the archive's retried statuses; 500/502/503 are transient server errors of
+            // an idempotent judgment (live 2026-09-25: one 500 stopped the 9/11 window).
+            if (![429, 500, 502, 503, 529].includes(response.status)) {
+                throw new Error(`Jev HTTP ${response.status}${errorDetail(text)}`);
+            }
+            lastRetryStatus = response.status;
+            lastDetail = errorDetail(text);
+            if (attempt + 1 < MAX_ATTEMPTS)
+                await sleep(1_500 * (attempt + 1));
+        }
+        throw new Error(`Jev HTTP ${lastRetryStatus} x${MAX_ATTEMPTS}${lastDetail}`);
+    };
+    return {
+        get vocabulary() {
+            return loadVocabulary();
+        },
+        ask,
+        askBatch: async (requests) => {
+            const answers = [];
+            for (const request of requests) {
+                try {
+                    answers.push(await ask(request));
+                }
+                catch (error) {
+                    throw new JevBatchIncompleteError(request.observationRefs, error);
+                }
+            }
+            return Object.freeze(answers);
+        },
+    };
+}
+async function pool(items, worker, concurrency = 5) {
+    if (!Number.isSafeInteger(concurrency) || concurrency < 1) {
+        throw new Error('Jev pool concurrency must be a positive safe integer');
+    }
+    let next = 0;
+    await Promise.all(Array.from({ length: Math.min(concurrency, Math.max(1, items.length)) }, async () => {
+        for (;;) {
+            const index = next++;
+            if (index >= items.length)
+                return;
+            await worker(items[index]);
+        }
+    }));
+}
+//# sourceMappingURL=jev-client.js.map

package/dist/replay/jev-client.js.map

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

package/dist/replay/kagemusha-import.d.ts

@@ -0,0 +1,35 @@
+import type { SQLiteDatabase } from '../sqlite.js';
+import type { RawIndexSink, RawStore } from '../storage/source-archive.js';
+export interface FeedbackObservationFields {
+    translatedText: string;
+    rawBody?: string;
+    chatworkRoomId?: string;
+    slackFileIds?: string[];
+}
+export interface KagemushaImportOptions {
+    sourceDbPath: string;
+    connectorsConfigPath: string;
+    rawStore: RawStore;
+    rawIndexSink: RawIndexSink;
+    fromMs?: number;
+    untilMs?: number;
+    observedAtMs?: number;
+    pageSize?: number;
+    manifestPath?: string;
+    timeZone: string;
+}
+export interface KagemushaImportResult {
+    importedCount: number;
+    importedByOrigin: Record<string, number>;
+    countsByOriginDay: Record<string, Record<string, number>>;
+    unmappedByOrigin: Record<string, number>;
+    fromMs: number;
+    untilMs: number;
+    maxSourceAtMs: number | null;
+    projectedCount: number;
+    pendingProjectionCount: number;
+}
+export declare function parseFeedbackAuditCode(code: string): FeedbackObservationFields | null;
+export declare function openKagemushaReadOnly(path: string): SQLiteDatabase;
+export declare function importKagemushaRows(options: KagemushaImportOptions): Promise<KagemushaImportResult>;
+//# sourceMappingURL=kagemusha-import.d.ts.map

package/dist/replay/kagemusha-import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kagemusha-import.d.ts","sourceRoot":"","sources":["../../src/replay/kagemusha-import.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAkB,YAAY,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AA2B3F,MAAM,WAAW,yBAAyB;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAOD,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,QAAQ,EAAE,QAAQ,CAAC;IACnB,YAAY,EAAE,YAAY,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1D,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAmQD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,yBAAyB,GAAG,IAAI,CAsCrF;AAsED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAElE;AA0CD,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CAqKhC"}