@hasna/mementos 0.14.86 → 0.14.88

package/dist/db/store-backend.d.ts

@@ -0,0 +1,42 @@
+/**
+ * The transport that reads and writes will actually use.
+ *
+ * - `local-sqlite`   — the on-disk SQLite file at `db_path` is authoritative.
+ * - `cloud-api`      — authed HTTPS to the server (the shared store).
+ * - `cloud-postgres` — a direct Postgres DSN; server-only, never a client.
+ */
+export type StoreBackend = "local-sqlite" | "cloud-api" | "cloud-postgres";
+export interface StoreBackendReport {
+    /** Machine-readable contract for scripts and test guards. */
+    schema: "mementos.store_backend.v1";
+    backend: StoreBackend;
+    /** True when the HTTPS client transport is engaged (client reads AND writes). */
+    api_mode: boolean;
+    /** The server data backend (sqlite | postgresql) — reported for diagnosis, NOT the client answer. */
+    server_backend: string;
+    /** The SQLite path that WOULD be used. Meaningful only for `local-sqlite`. */
+    db_path: string;
+    /**
+     * Cloud endpoint origin + prefix as CONFIGURED, not necessarily as used: it
+     * is still reported when an explicit DB_PATH has outranked it, because the
+     * operator needs to see what was set as well as what won. Read `backend` /
+     * `api_mode` for what is actually in force, and `selected_by` for why.
+     * Not a secret; the key is never included.
+     */
+    api_endpoint: string | null;
+    /**
+     * Whether an API key is CONFIGURED in the environment — again independent of
+     * whether it won. The value is never read or reported.
+     */
+    api_key_present: boolean;
+    /** Env key NAMES that produced this backend, or `"default"`. Names only. */
+    selected_by: string;
+}
+/**
+ * Resolve the effective store backend from the environment.
+ *
+ * Pure with respect to storage: touches no database, makes no network call, and
+ * never places a credential value in the returned report.
+ */
+export declare function resolveStoreBackend(): StoreBackendReport;
+//# sourceMappingURL=store-backend.d.ts.map

package/dist/db/store-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-backend.d.ts","sourceRoot":"","sources":["../../src/db/store-backend.ts"],"names":[],"mappings":"AAiCA;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG,cAAc,GAAG,WAAW,GAAG,gBAAgB,CAAC;AAE3E,MAAM,WAAW,kBAAkB;IACjC,6DAA6D;IAC7D,MAAM,EAAE,2BAA2B,CAAC;IACpC,OAAO,EAAE,YAAY,CAAC;IACtB,iFAAiF;IACjF,QAAQ,EAAE,OAAO,CAAC;IAClB,qGAAqG;IACrG,cAAc,EAAE,MAAM,CAAC;IACvB,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B;;;OAGG;IACH,eAAe,EAAE,OAAO,CAAC;IACzB,4EAA4E;IAC5E,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,kBAAkB,CAiDxD"}

package/dist/db/subscriptions.d.ts

@@ -0,0 +1,24 @@
+import { SqliteAdapter as Database } from "../storage.js";
+export interface Subscription {
+    id: string;
+    agent_id: string;
+    key_pattern: string | null;
+    tag_pattern: string | null;
+    scope: string | null;
+}
+export interface CreateSubscriptionInput {
+    agent_id: string;
+    key_pattern?: string | null;
+    tag_pattern?: string | null;
+    scope?: string | null;
+}
+export declare function createSubscription(input: CreateSubscriptionInput, db?: Database): Subscription;
+export declare function deleteSubscription(id: string, db?: Database): boolean;
+/**
+ * Compute human-readable change notifications for an agent: recently changed
+ * memories (last 10 minutes) matching that agent's subscriptions, excluding the
+ * agent's own writes. Encapsulates the whole two-query workflow so callers
+ * (memory_inject) never touch SQLite directly.
+ */
+export declare function getSubscriptionNotifications(agentId: string, db?: Database): string[];
+//# sourceMappingURL=subscriptions.d.ts.map

package/dist/db/subscriptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptions.d.ts","sourceRoot":"","sources":["../../src/db/subscriptions.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAC;AAI1D,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,YAAY,CAmB9F;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,CAQrE;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,EAAE,CAqCrF"}

package/dist/db/synthesis.d.ts

@@ -0,0 +1,101 @@
+import { SqliteAdapter as Database } from "../storage.js";
+export interface SynthesisRun {
+    id: string;
+    triggered_by: "scheduler" | "manual" | "threshold" | "hook";
+    project_id: string | null;
+    agent_id: string | null;
+    corpus_size: number;
+    proposals_generated: number;
+    proposals_accepted: number;
+    proposals_rejected: number;
+    status: "pending" | "running" | "completed" | "failed" | "rolled_back";
+    error: string | null;
+    started_at: string;
+    completed_at: string | null;
+}
+export interface SynthesisProposal {
+    id: string;
+    run_id: string;
+    proposal_type: "merge" | "archive" | "promote" | "update_value" | "add_tag" | "remove_duplicate";
+    memory_ids: string[];
+    target_memory_id: string | null;
+    proposed_changes: Record<string, unknown>;
+    reasoning: string | null;
+    confidence: number;
+    status: "pending" | "accepted" | "rejected" | "rolled_back";
+    created_at: string;
+    executed_at: string | null;
+    rollback_data: Record<string, unknown> | null;
+}
+export interface SynthesisMetric {
+    id: string;
+    run_id: string;
+    metric_type: string;
+    value: number;
+    baseline: number | null;
+    created_at: string;
+}
+export interface SynthesisEvent {
+    id: string;
+    event_type: "recalled" | "searched" | "saved" | "updated" | "deleted" | "injected";
+    memory_id: string | null;
+    agent_id: string | null;
+    project_id: string | null;
+    session_id: string | null;
+    query: string | null;
+    importance_at_time: number | null;
+    metadata: Record<string, unknown>;
+    created_at: string;
+}
+export declare function createSynthesisRun(input: {
+    triggered_by: SynthesisRun["triggered_by"];
+    project_id?: string | null;
+    agent_id?: string | null;
+    corpus_size?: number;
+}, db?: Database): SynthesisRun;
+export declare function getSynthesisRun(id: string, db?: Database): SynthesisRun | null;
+export declare function listSynthesisRuns(filter: {
+    project_id?: string | null;
+    status?: SynthesisRun["status"];
+    limit?: number;
+}, db?: Database): SynthesisRun[];
+export declare function updateSynthesisRun(id: string, updates: Partial<Pick<SynthesisRun, "status" | "error" | "corpus_size" | "proposals_generated" | "proposals_accepted" | "proposals_rejected" | "completed_at">>, db?: Database): SynthesisRun;
+export declare function createProposal(input: {
+    run_id: string;
+    proposal_type: SynthesisProposal["proposal_type"];
+    memory_ids: string[];
+    target_memory_id?: string | null;
+    proposed_changes: Record<string, unknown>;
+    reasoning?: string | null;
+    confidence: number;
+}, db?: Database): SynthesisProposal;
+export declare function getProposal(id: string, db?: Database): SynthesisProposal | null;
+export declare function listProposals(run_id: string, filter?: {
+    status?: SynthesisProposal["status"];
+}, db?: Database): SynthesisProposal[];
+export declare function updateProposal(id: string, updates: Partial<Pick<SynthesisProposal, "status" | "executed_at" | "rollback_data">>, db?: Database): SynthesisProposal;
+export declare function createMetric(input: {
+    run_id: string;
+    metric_type: string;
+    value: number;
+    baseline?: number | null;
+}, db?: Database): SynthesisMetric;
+export declare function listMetrics(run_id: string, db?: Database): SynthesisMetric[];
+export declare function recordSynthesisEvent(input: {
+    event_type: SynthesisEvent["event_type"];
+    memory_id?: string | null;
+    agent_id?: string | null;
+    project_id?: string | null;
+    session_id?: string | null;
+    query?: string | null;
+    importance_at_time?: number | null;
+    metadata?: Record<string, unknown>;
+}, db?: Database): void;
+export declare function listSynthesisEvents(filter: {
+    memory_id?: string;
+    project_id?: string;
+    event_type?: SynthesisEvent["event_type"];
+    since?: string;
+    limit?: number;
+}, db?: Database): SynthesisEvent[];
+//# sourceMappingURL=synthesis.d.ts.map

package/dist/db/synthesis.d.ts.map

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

package/dist/db/tasks.d.ts

@@ -0,0 +1,89 @@
+import { SqliteAdapter as Database } from "../storage.js";
+export type TaskStatus = "pending" | "in_progress" | "completed" | "failed" | "cancelled";
+export type TaskPriority = "critical" | "high" | "medium" | "low";
+export interface Task {
+    id: string;
+    subject: string;
+    description: string;
+    status: TaskStatus;
+    priority: TaskPriority;
+    tags: string[];
+    assigned_agent_id: string | null;
+    project_id: string | null;
+    session_id: string | null;
+    parent_task_id: string | null;
+    metadata: Record<string, unknown>;
+    progress: number;
+    due_at: string | null;
+    started_at: string | null;
+    completed_at: string | null;
+    failed_at: string | null;
+    error: string | null;
+    created_at: string;
+    updated_at: string;
+}
+export interface TaskComment {
+    id: string;
+    task_id: string;
+    agent_id: string | null;
+    body: string;
+    created_at: string;
+}
+export interface CreateTaskInput {
+    subject: string;
+    description?: string;
+    priority?: TaskPriority;
+    tags?: string[];
+    assigned_agent_id?: string;
+    project_id?: string;
+    session_id?: string;
+    parent_task_id?: string;
+    metadata?: Record<string, unknown>;
+    due_at?: string;
+}
+export interface UpdateTaskInput {
+    subject?: string;
+    description?: string;
+    status?: TaskStatus;
+    priority?: TaskPriority;
+    tags?: string[];
+    assigned_agent_id?: string | null;
+    metadata?: Record<string, unknown>;
+    progress?: number;
+    due_at?: string | null;
+    error?: string | null;
+}
+export declare function createTask(db: Database, input: CreateTaskInput): Task;
+export declare function getTask(db: Database, id: string): Task | null;
+export declare function listTasks(db: Database, filter?: {
+    status?: TaskStatus;
+    priority?: TaskPriority;
+    assigned_agent_id?: string;
+    project_id?: string;
+    session_id?: string;
+    parent_task_id?: string | null;
+    tags?: string[];
+    limit?: number;
+    offset?: number;
+}): {
+    tasks: Task[];
+    count: number;
+};
+export declare function updateTask(db: Database, id: string, input: UpdateTaskInput): Task | null;
+export declare function deleteTask(db: Database, id: string): boolean;
+export declare function addTaskComment(db: Database, taskId: string, body: string, agentId?: string): TaskComment;
+export declare function listTaskComments(db: Database, taskId: string): {
+    comments: TaskComment[];
+    count: number;
+};
+export declare function deleteTaskComment(db: Database, id: string): boolean;
+export declare function getTaskStats(db: Database, filter?: {
+    project_id?: string;
+    agent_id?: string;
+}): {
+    total: number;
+    by_status: Record<TaskStatus, number>;
+    by_priority: Record<TaskPriority, number>;
+    overdue: number;
+};
+//# sourceMappingURL=tasks.d.ts.map

package/dist/db/tasks.d.ts.map

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

package/dist/db/tool-events.d.ts

@@ -0,0 +1,27 @@
+import { SqliteAdapter as Database } from "../storage.js";
+import type { ToolEvent, CreateToolEventInput, ToolStats } from "../types/index.js";
+export declare function saveToolEvent(input: CreateToolEventInput, db?: Database): ToolEvent;
+export declare function getToolEvent(id: string, db?: Database): ToolEvent | null;
+export declare function getToolEvents(filters: {
+    tool_name?: string;
+    agent_id?: string;
+    project_id?: string;
+    success?: boolean;
+    from_date?: string;
+    to_date?: string;
+    limit?: number;
+    offset?: number;
+}, db?: Database): ToolEvent[];
+export declare function getToolStats(tool_name: string, project_id?: string, db?: Database): ToolStats;
+export declare function getToolLessons(tool_name: string, project_id?: string, limit?: number, db?: Database): {
+    lesson: string;
+    when_to_use: string | null;
+    created_at: string;
+}[];
+export declare function deleteToolEvents(filters: {
+    tool_name?: string;
+    agent_id?: string;
+    project_id?: string;
+    before_date?: string;
+}, db?: Database): number;
+//# sourceMappingURL=tool-events.d.ts.map

package/dist/db/tool-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-events.d.ts","sourceRoot":"","sources":["../../src/db/tool-events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAiCpF,wBAAgB,aAAa,CAAC,KAAK,EAAE,oBAAoB,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,SAAS,CAkCnF;AAMD,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,IAAI,CAKxE;AAED,wBAAgB,aAAa,CAC3B,OAAO,EAAE;IACP,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,EACD,EAAE,CAAC,EAAE,QAAQ,GACZ,SAAS,EAAE,CAqDb;AAMD,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,EACnB,EAAE,CAAC,EAAE,QAAQ,GACZ,SAAS,CAkDX;AAMD,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,EACnB,KAAK,CAAC,EAAE,MAAM,EACd,EAAE,CAAC,EAAE,QAAQ,GACZ;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,EAAE,CAuBtE;AAMD,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE;IACP,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,EACD,EAAE,CAAC,EAAE,QAAQ,GACZ,MAAM,CA8BR"}

package/dist/db/webhook_hooks.d.ts

@@ -0,0 +1,48 @@
+import { SqliteAdapter as Database } from "../storage.js";
+import type { LookupAddress } from "node:dns";
+import type { WebhookHook, HookType } from "../types/hooks.js";
+/**
+ * Resolver signature: returns every A/AAAA address for a hostname.
+ * Defaults to node:dns/promises lookup (all addresses, verbatim order).
+ */
+export type HostResolver = (hostname: string) => Promise<LookupAddress[]>;
+export interface WebhookUrlValidationOptions {
+    /**
+     * Hostname resolver override — a deterministic test seam. Production call
+     * sites never pass it; when absent the real system resolver is used.
+     */
+    lookup?: HostResolver;
+}
+/**
+ * Validate a webhook handler URL. Rejects (async) when the URL is not a
+ * public http(s) endpoint: unparseable, wrong scheme, embedded credentials,
+ * or a loopback / link-local / private / metadata target — whether named
+ * directly as an IP literal or indirectly via a DNS name that resolves to one
+ * of those ranges. A hostname that cannot be resolved is rejected (fail
+ * closed): it could never be delivered, and rejecting it closes the SSRF
+ * class.
+ */
+export declare function validateWebhookHandlerUrl(url: string, opts?: WebhookUrlValidationOptions): Promise<void>;
+export interface CreateWebhookHookInput {
+    type: HookType;
+    handlerUrl: string;
+    priority?: number;
+    blocking?: boolean;
+    agentId?: string;
+    projectId?: string;
+    description?: string;
+}
+export declare function createWebhookHook(input: CreateWebhookHookInput, db?: Database, opts?: WebhookUrlValidationOptions): Promise<WebhookHook>;
+export declare function getWebhookHook(id: string, db?: Database): WebhookHook | null;
+export declare function listWebhookHooks(filter?: {
+    type?: HookType;
+    enabled?: boolean;
+}, db?: Database): WebhookHook[];
+export declare function updateWebhookHook(id: string, updates: {
+    enabled?: boolean;
+    description?: string;
+    priority?: number;
+}, db?: Database): WebhookHook | null;
+export declare function deleteWebhookHook(id: string, db?: Database): boolean;
+export declare function recordWebhookInvocation(id: string, success: boolean, db?: Database): void;
+//# sourceMappingURL=webhook_hooks.d.ts.map

package/dist/db/webhook_hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook_hooks.d.ts","sourceRoot":"","sources":["../../src/db/webhook_hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAC;AAM1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AA6H/D;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;AAE1E,MAAM,WAAW,2BAA2B;IAC1C;;;OAGG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAwBD;;;;;;;;GAQG;AACH,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,2BAA2B,GACjC,OAAO,CAAC,IAAI,CAAC,CA+Df;AAMD,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,sBAAsB,EAC7B,EAAE,CAAC,EAAE,QAAQ,EACb,IAAI,CAAC,EAAE,2BAA2B,GACjC,OAAO,CAAC,WAAW,CAAC,CAoCtB;AAMD,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,WAAW,GAAG,IAAI,CAW5E;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,GAAE;IAAE,IAAI,CAAC,EAAE,QAAQ,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,EACnD,EAAE,CAAC,EAAE,QAAQ,GACZ,WAAW,EAAE,CAyBf;AAMD,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,MAAM,EACV,OAAO,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,EACvE,EAAE,CAAC,EAAE,QAAQ,GACZ,WAAW,GAAG,IAAI,CAoCpB;AAMD,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,CAQpE;AAMD,wBAAgB,uBAAuB,CACrC,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,OAAO,EAChB,EAAE,CAAC,EAAE,QAAQ,GACZ,IAAI,CAmBN"}

package/dist/diagnostics/historical-project-registration-receipt.d.ts

@@ -0,0 +1,39 @@
+export interface HistoricalReceiptDiagnosticQuery {
+    query<T = Record<string, unknown>>(sql: string, values?: unknown[]): Promise<{
+        rows: T[];
+        rowCount: number | null;
+    }>;
+}
+export interface HistoricalReceiptDiagnosticReport {
+    schema: "mementos.historical-project-registration-receipt-diagnostic.v1";
+    status: "PASS";
+    transaction_read_only: true;
+    exact_receipt_count: 1;
+    table_count_before: string;
+    table_count_after: string;
+    table_digest_before: string;
+    table_digest_after: string;
+    table_count_unchanged: true;
+    table_digest_unchanged: true;
+    authority_id: string;
+    tenant_id: string;
+    corpus_id: string;
+    operation_id: string;
+    step_id: string;
+    target_selector: string;
+    target_id: string;
+    receipt_id: string;
+    identity_digest: string;
+    target_digest: string;
+    operation_digest: string;
+    idempotency_digest: string;
+    result_digest: string;
+    receipt_digest: string;
+    response_digest: string;
+}
+export declare class HistoricalReceiptDiagnosticError extends Error {
+    readonly code: string;
+    constructor(code: string);
+}
+export declare function diagnoseHistoricalProjectRegistrationReceipt(query: HistoricalReceiptDiagnosticQuery): Promise<HistoricalReceiptDiagnosticReport>;
+//# sourceMappingURL=historical-project-registration-receipt.d.ts.map

package/dist/diagnostics/historical-project-registration-receipt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"historical-project-registration-receipt.d.ts","sourceRoot":"","sources":["../../src/diagnostics/historical-project-registration-receipt.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,gCAAgC;IAC/C,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,OAAO,EAAE,GACjB,OAAO,CAAC;QAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;CACpD;AAYD,MAAM,WAAW,iCAAiC;IAChD,MAAM,EAAE,gEAAgE,CAAC;IACzE,MAAM,EAAE,MAAM,CAAC;IACf,qBAAqB,EAAE,IAAI,CAAC;IAC5B,mBAAmB,EAAE,CAAC,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,qBAAqB,EAAE,IAAI,CAAC;IAC5B,sBAAsB,EAAE,IAAI,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,gCAAiC,SAAQ,KAAK;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM;CAIlC;AAyFD,wBAAsB,4CAA4C,CAChE,KAAK,EAAE,gCAAgC,GACtC,OAAO,CAAC,iCAAiC,CAAC,CAgH5C"}

package/dist/diagnostics/historical-project-registration-receipt.js

@@ -7,12 +7,118 @@ import pg2 from "pg";
 import { createHash } from "crypto";
 
 // src/storage.ts
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
-import { homedir } from "os";
-import { join } from "path";
+import { existsSync as existsSync2, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { join as join3 } from "path";
 import { fileURLToPath } from "url";
 import { Worker } from "worker_threads";
 import pg from "pg";
+
+// src/lib/paths.ts
+import { existsSync } from "fs";
+import { homedir as homedir2 } from "os";
+import { join as join2, resolve } from "path";
+
+// ../../node_modules/.bun/@hasna+paths@0.1.0/node_modules/@hasna/paths/dist/index.js
+import { homedir } from "os";
+import { join } from "path";
+var KIND_ENV = {
+  config: "HASNA_CONFIG_HOME",
+  data: "HASNA_DATA_HOME",
+  state: "HASNA_STATE_HOME",
+  cache: "HASNA_CACHE_HOME"
+};
+var APP_SLUG_RE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+function assertApp(app) {
+  if (typeof app !== "string" || app.length === 0) {
+    throw new TypeError("paths: app must be a non-empty string");
+  }
+  if (!APP_SLUG_RE.test(app)) {
+    throw new TypeError(`paths: invalid app slug "${app}" \u2014 expected lowercase kebab-case ([a-z0-9]+(-[a-z0-9]+)*)`);
+  }
+}
+function envOf(options) {
+  return options.env ?? process.env;
+}
+function envValue(options, kind) {
+  const value = envOf(options)[KIND_ENV[kind]];
+  return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+function isMacOS(platform) {
+  return platform === "darwin";
+}
+function baseDir(kind, options) {
+  const override = envValue(options, kind);
+  if (override)
+    return override;
+  const home = options.home ?? homedir();
+  const platform = options.platform ?? process.platform;
+  if (isMacOS(platform)) {
+    switch (kind) {
+      case "config":
+      case "data":
+        return join(home, "Library", "Application Support", "Hasna");
+      case "cache":
+        return join(home, "Library", "Caches", "Hasna");
+      case "state":
+        return join(home, "Library", "Logs", "Hasna");
+    }
+  }
+  switch (kind) {
+    case "config":
+      return join(home, ".config", "hasna");
+    case "data":
+      return join(home, ".local", "share", "hasna");
+    case "state":
+      return join(home, ".local", "state", "hasna");
+    case "cache":
+      return join(home, ".cache", "hasna");
+  }
+}
+function resolvePath(kind, options) {
+  assertApp(options.app);
+  const appSegment = options.internal === true ? join("internal", options.app) : options.app;
+  return join(baseDir(kind, options), appSegment);
+}
+function dataDir(options) {
+  return resolvePath("data", options);
+}
+
+// src/lib/paths.ts
+function effectiveHome() {
+  return process.env["HOME"] || process.env["USERPROFILE"] || homedir2() || "/tmp";
+}
+function legacyDataRoot() {
+  return join2(effectiveHome(), ".hasna", "mementos");
+}
+function resolverDataRoot() {
+  return dataDir({
+    app: "mementos",
+    home: process.env["HOME"] || process.env["USERPROFILE"] || undefined
+  });
+}
+function adoptResolverDataRoot(resolved, env = process.env) {
+  const dataOverride = env.HASNA_DATA_HOME;
+  if (typeof dataOverride === "string" && dataOverride.trim().length > 0)
+    return true;
+  return existsSync(join2(resolved, "mementos.db"));
+}
+function exactDataRoot() {
+  for (const key of ["HASNA_MEMENTOS_HOME", "MEMENTOS_HOME"]) {
+    const dir = process.env[key]?.trim();
+    if (dir)
+      return resolve(dir);
+  }
+  return;
+}
+function getDataRoot() {
+  const exact = exactDataRoot();
+  if (exact)
+    return exact;
+  const resolved = resolverDataRoot();
+  return adoptResolverDataRoot(resolved) ? resolve(resolved) : resolve(legacyDataRoot());
+}
+
+// src/storage.ts
 function shouldUsePgSsl(connectionString) {
   let params;
   try {
@@ -65,12 +171,12 @@ class PgSyncPool {
     const ext = import.meta.url.endsWith(".ts") ? ".ts" : ".js";
     const here = fileURLToPath(new URL(".", import.meta.url));
     const candidates = [
-      join(here, `pg-sync-worker${ext}`),
-      join(here, "..", `pg-sync-worker${ext}`),
-      join(here, "..", "..", `pg-sync-worker${ext}`)
+      join3(here, `pg-sync-worker${ext}`),
+      join3(here, "..", `pg-sync-worker${ext}`),
+      join3(here, "..", "..", `pg-sync-worker${ext}`)
     ];
     for (const candidate of candidates) {
-      if (existsSync(candidate))
+      if (existsSync2(candidate))
         return candidate;
     }
     return candidates[0];
@@ -141,9 +247,9 @@ var MEMENTOS_STORAGE_ENV = {
 var MEMENTOS_STORAGE_FALLBACK_ENV = {
   databaseUrl: "MEMENTOS_DATABASE_URL"
 };
-var LOCAL_DATA_DIR = join(homedir(), ".hasna", "mementos");
-var STORAGE_CONFIG_DIR = join(LOCAL_DATA_DIR, "storage");
-var STORAGE_CONFIG_PATH = join(STORAGE_CONFIG_DIR, "config.json");
+var LOCAL_DATA_DIR = getDataRoot();
+var STORAGE_CONFIG_DIR = join3(LOCAL_DATA_DIR, "storage");
+var STORAGE_CONFIG_PATH = join3(STORAGE_CONFIG_DIR, "config.json");
 var DATABASE_ENV_NAMES = [
   { name: MEMENTOS_STORAGE_ENV.databaseUrl, deprecated: false },
   { name: MEMENTOS_STORAGE_FALLBACK_ENV.databaseUrl, deprecated: false }

package/dist/generated/storage-kit/backend.d.ts

@@ -0,0 +1,20 @@
+export declare const SERVER_DATA_BACKENDS: readonly ["sqlite", "postgresql"];
+export type ServerDataBackend = (typeof SERVER_DATA_BACKENDS)[number];
+export type Env = Record<string, string | undefined>;
+/** Upper-snake env token for an app name, e.g. `todos` -> `TODOS`. */
+export declare function envToken(name: string): string;
+export interface ServerDataBackendEnvKeys {
+    databaseUrlKeys: string[];
+}
+export declare function serverDataBackendEnvKeys(name: string): ServerDataBackendEnvKeys;
+export declare function assertNoLegacyStorageMode(name: string, env?: Env): void;
+export interface ServerDataBackendResolution {
+    backend: ServerDataBackend;
+    source: string;
+    databaseUrlPresent: boolean;
+    databaseUrlSource: string | null;
+}
+export declare function resolveServerDataBackend(name: string, env?: Env): ServerDataBackendResolution;
+/** Resolve the database URL without logging it. Returns `null` when unset. */
+export declare function resolveDatabaseUrl(name: string, env?: Env): string | null;
+//# sourceMappingURL=backend.d.ts.map

package/dist/generated/storage-kit/backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../../src/generated/storage-kit/backend.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,oBAAoB,mCAAoC,CAAC;AACtE,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAErD,sEAAsE;AACtE,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,MAAM,WAAW,wBAAwB;IACvC,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,wBAAwB,CAK/E;AA+BD,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,GAAiB,GAAG,IAAI,CASpF;AAED,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,iBAAiB,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,GAAG,GAAE,GAAiB,GACrB,2BAA2B,CAiB7B;AAED,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,GAAiB,GAAG,MAAM,GAAG,IAAI,CAItF"}

package/dist/generated/storage-kit/health.d.ts

@@ -0,0 +1,20 @@
+import type { TypedQueryClient } from "./query.js";
+import { type Migration, type MigrationRunnerOptions } from "./migrations.js";
+export interface HealthResult {
+    ok: boolean;
+    /** Round-trip latency of the probe query, in milliseconds. */
+    latencyMs: number;
+    error?: string;
+}
+/** Cheap reachability probe: `SELECT 1`. Never throws — reports `ok: false`. */
+export declare function checkHealth(client: TypedQueryClient): Promise<HealthResult>;
+export interface ReadyResult extends HealthResult {
+    /** Migration ids that are defined but not yet applied. */
+    pendingMigrations: string[];
+}
+/**
+ * Readiness probe: reachable AND fully migrated. Reports `ok: false` with the
+ * list of pending migration ids when the schema is behind.
+ */
+export declare function checkReady(client: TypedQueryClient, migrations: readonly Migration[], options?: MigrationRunnerOptions): Promise<ReadyResult>;
+//# sourceMappingURL=health.d.ts.map

package/dist/generated/storage-kit/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../../src/generated/storage-kit/health.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAmB,KAAK,SAAS,EAAE,KAAK,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAE/F,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,8DAA8D;IAC9D,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,gFAAgF;AAChF,wBAAsB,WAAW,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CAYjF;AAED,MAAM,WAAW,WAAY,SAAQ,YAAY;IAC/C,0DAA0D;IAC1D,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,gBAAgB,EACxB,UAAU,EAAE,SAAS,SAAS,EAAE,EAChC,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,WAAW,CAAC,CAetB"}

package/dist/generated/storage-kit/index.d.ts

@@ -0,0 +1,8 @@
+export declare const KIT_VERSION = "0.10.6";
+export * from "./backend.js";
+export * from "./tls.js";
+export * from "./query.js";
+export * from "./pool.js";
+export * from "./migrations.js";
+export * from "./health.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/generated/storage-kit/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/generated/storage-kit/index.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,WAAW,WAAW,CAAC;AAEpC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC"}