@graphorin/cli 0.6.1 → 0.7.0

package/dist/commands/consolidator.js

@@ -12,7 +12,10 @@ const VALID_TIERS = Object.freeze([
 ]);
 /** @stable */
 async function runConsolidatorStatus(options = {}) {
-	const ctx = await openStoreContext({ ...options.config !== void 0 ? { config: options.config } : {} });
+	const ctx = await openStoreContext({
+		migrationPolicy: "check",
+		...options.config !== void 0 ? { config: options.config } : {}
+	});
 	try {
 		const conn = ctx.store.connection;
 		const recent = conn.get("SELECT COUNT(*) AS n FROM consolidator_runs WHERE started_at > ?", [Date.now() - 1440 * 6e4]);
@@ -81,6 +84,89 @@ async function runConsolidatorStop(options = {}) {
 		await ctx.close();
 	}
 }
+/**
+* W-065: make the permanent `dead-letter queue: N` status warning
+* actionable. Operator-level (DB-wide) view, like the `dlqSize`
+* counter in `runConsolidatorStatus` - `listFailedBatches` on the
+* store is scoped to one `SessionScope.userId`, which a CLI does not
+* have; use `--user` to narrow.
+*
+* @stable
+*/
+async function runConsolidatorDlqList(options = {}) {
+	const ctx = await openStoreContext({
+		migrationPolicy: "check",
+		...options.config !== void 0 ? { config: options.config } : {}
+	});
+	try {
+		const conn = ctx.store.connection;
+		const limit = options.limit ?? 100;
+		const rows = options.user !== void 0 ? conn.all("SELECT id, scope_user_id, phase, error_kind, retry_count, failed_at, next_retry_at FROM consolidator_failed_batches WHERE scope_user_id = ? ORDER BY failed_at DESC LIMIT ?", [options.user, limit]) : conn.all("SELECT id, scope_user_id, phase, error_kind, retry_count, failed_at, next_retry_at FROM consolidator_failed_batches ORDER BY failed_at DESC LIMIT ?", [limit]);
+		const out = Object.freeze(rows.map((row) => Object.freeze({
+			id: row.id,
+			userId: row.scope_user_id,
+			phase: row.phase,
+			errorKind: row.error_kind,
+			retryCount: row.retry_count,
+			failedAt: new Date(row.failed_at).toISOString(),
+			exhausted: row.next_retry_at === null
+		})));
+		emitReport(options, out, () => {
+			const print = options.print ?? defaultPrintSink;
+			if (out.length === 0) {
+				print(brand("dead-letter queue is empty."));
+				return;
+			}
+			print(brand(`dead-letter queue: ${out.length} batch(es)`));
+			for (const entry of out) {
+				const state = entry.exhausted ? "EXHAUSTED" : "awaiting retry";
+				print(`  ${entry.id}  user=${entry.userId ?? "-"}  phase=${entry.phase ?? "-"}  kind=${entry.errorKind ?? "-"}  retries=${entry.retryCount}  failedAt=${entry.failedAt}  [${state}]`);
+			}
+		});
+		return out;
+	} finally {
+		await ctx.close();
+	}
+}
+/**
+* W-065: clear dead-letter batches. Defaults are conservative:
+* exhausted-only, all users, no age bound. The batch payload (message
+* ids) is lost on delete - that is the explicit point of the command.
+*
+* @stable
+*/
+async function runConsolidatorDlqClear(options = {}) {
+	const ctx = await openStoreContext({ ...options.config !== void 0 ? { config: options.config } : {} });
+	try {
+		const conn = ctx.store.connection;
+		const conditions = [];
+		const params = [];
+		if (options.id !== void 0) {
+			conditions.push("id = ?");
+			params.push(options.id);
+		}
+		if (options.exhaustedOnly !== false) conditions.push("next_retry_at IS NULL");
+		if (options.before !== void 0) {
+			const ms = Number.isFinite(Number(options.before)) ? Number(options.before) : Date.parse(options.before);
+			if (!Number.isFinite(ms)) throw new Error(`[graphorin/cli] --before '${options.before}' is not a valid ISO date or epoch-ms value.`);
+			conditions.push("failed_at < ?");
+			params.push(ms);
+		}
+		if (options.user !== void 0) {
+			conditions.push("scope_user_id = ?");
+			params.push(options.user);
+		}
+		const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+		const result = conn.run(`DELETE FROM consolidator_failed_batches ${where}`, params);
+		const out = Object.freeze({ removed: result.changes ?? 0 });
+		emitReport(options, out, () => {
+			(options.print ?? defaultPrintSink)(brand(`${out.removed > 0 ? statusMarker("ok") : statusMarker("info")} cleared ${out.removed} dead-letter batch(es).`));
+		});
+		return out;
+	} finally {
+		await ctx.close();
+	}
+}
 function isTier(value) {
 	return typeof value === "string" && VALID_TIERS.includes(value);
 }
@@ -93,5 +179,5 @@ function isTier(value) {
 const CONSOLIDATOR_INVALID_TIER_EXIT = EXIT_CODES.RECOVERABLE_FAILURE;
 
 //#endregion
-export { CONSOLIDATOR_INVALID_TIER_EXIT, runConsolidatorSetTier, runConsolidatorStatus, runConsolidatorStop };
+export { CONSOLIDATOR_INVALID_TIER_EXIT, runConsolidatorDlqClear, runConsolidatorDlqList, runConsolidatorSetTier, runConsolidatorStatus, runConsolidatorStop };
 //# sourceMappingURL=consolidator.js.map

package/dist/commands/consolidator.js.map

@@ -1 +1 @@
-{"version":3,"file":"consolidator.js","names":["VALID_TIERS: ReadonlyArray<ConsolidatorTier>","out: ConsolidatorStatusResult"],"sources":["../../src/commands/consolidator.ts"],"sourcesContent":["/**\n * `graphorin consolidator` - inspect and steer the background memory\n * consolidation pipeline.\n *\n * Surface (per Phase 15 § Consolidator):\n *\n *  - `graphorin consolidator status` - current tier + pending CONFLICT-\n *    CHECK runs + DLQ size + recent run history.\n *  - `graphorin consolidator set-tier <free|cheap|standard|enterprise>`\n *    - persist the requested tier so the next process startup picks it\n *    up.\n *  - `graphorin consolidator stop` - pause the consolidator until the\n *    operator resumes it (next `graphorin start`).\n *\n * The consolidator runs **inside** the server process, so the CLI\n * cannot direct-control a live in-memory instance from a different\n * process. `status` reads the SQLite tables the running consolidator\n * writes to (`consolidator_state`, `consolidator_runs`,\n * `consolidator_failed_batches`, `conflict_check_pending`); `set-tier`\n * and `stop` honestly report UNSUPPORTED until a daemon-side control\n * channel exists (IP-4) - nothing polls an admin table.\n *\n * @packageDocumentation\n */\n\nimport type { ConsolidatorTier } from '@graphorin/memory';\n\nimport { EXIT_CODES } from '../internal/exit.js';\nimport {\n  brand,\n  type CommonOutputOptions,\n  defaultPrintSink,\n  emitReport,\n  statusMarker,\n} from '../internal/output.js';\nimport { openStoreContext } from '../internal/store-context.js';\n\nconst VALID_TIERS: ReadonlyArray<ConsolidatorTier> = Object.freeze([\n  'free',\n  'cheap',\n  'standard',\n  'full',\n  'custom',\n] as const);\n\n/** @stable */\nexport interface ConsolidatorCommonOptions extends CommonOutputOptions {\n  readonly config?: string;\n}\n\n/** @stable */\nexport interface ConsolidatorStatusResult {\n  readonly tierHint?: ConsolidatorTier;\n  readonly recentRuns: number;\n  readonly successfulRuns: number;\n  readonly failedRuns: number;\n  readonly dlqSize: number;\n  readonly pendingConflicts: number;\n  readonly lastRunAt?: string;\n  readonly lastRunStatus?: string;\n}\n\n/** @stable */\nexport async function runConsolidatorStatus(\n  options: ConsolidatorCommonOptions = {},\n): Promise<ConsolidatorStatusResult> {\n  const ctx = await openStoreContext({\n    ...(options.config !== undefined ? { config: options.config } : {}),\n  });\n  try {\n    const conn = ctx.store.connection;\n    const recent = conn.get<{ n: number }>(\n      'SELECT COUNT(*) AS n FROM consolidator_runs WHERE started_at > ?',\n      [Date.now() - 24 * 60 * 60_000],\n    );\n    // MCON-5: the store writes 'running' | 'completed' | 'failed' |\n    // 'partial' | 'deferred' (consolidator-store.ts) - the old queries\n    // asked for 'success'/'error'/'pending' and always returned 0.\n    const success = conn.get<{ n: number }>(\n      \"SELECT COUNT(*) AS n FROM consolidator_runs WHERE status = 'completed' AND started_at > ?\",\n      [Date.now() - 24 * 60 * 60_000],\n    );\n    const failed = conn.get<{ n: number }>(\n      \"SELECT COUNT(*) AS n FROM consolidator_runs WHERE status = 'failed' AND started_at > ?\",\n      [Date.now() - 24 * 60 * 60_000],\n    );\n    const dlq = conn.get<{ n: number }>('SELECT COUNT(*) AS n FROM consolidator_failed_batches');\n    // Pending conflict work lives in conflict_check_pending, not in\n    // consolidator_runs ('pending' was never a run status).\n    const pending = conn.get<{ n: number }>(\n      'SELECT COUNT(*) AS n FROM conflict_check_pending WHERE resolved_at IS NULL',\n    );\n    const last = conn.get<{ started_at: number; status: string }>(\n      'SELECT started_at, status FROM consolidator_runs ORDER BY started_at DESC LIMIT 1',\n    );\n    const out: ConsolidatorStatusResult = Object.freeze({\n      recentRuns: recent?.n ?? 0,\n      successfulRuns: success?.n ?? 0,\n      failedRuns: failed?.n ?? 0,\n      dlqSize: dlq?.n ?? 0,\n      pendingConflicts: pending?.n ?? 0,\n      ...(last !== undefined ? { lastRunAt: new Date(last.started_at).toISOString() } : {}),\n      ...(last !== undefined ? { lastRunStatus: last.status } : {}),\n    });\n    emitReport(options, out, () => {\n      const print = options.print ?? defaultPrintSink;\n      const tier = out.tierHint ?? '<from running config>';\n      print(brand(`consolidator status (tier hint: ${tier})`));\n      print(\n        `  ${statusMarker('ok')} runs in last 24h: ${out.recentRuns} (${out.successfulRuns} success, ${out.failedRuns} error)`,\n      );\n      print(`  ${statusMarker(out.dlqSize > 0 ? 'warn' : 'ok')} dead-letter queue: ${out.dlqSize}`);\n      print(\n        `  ${statusMarker(out.pendingConflicts > 0 ? 'warn' : 'ok')} pending CONFLICT-CHECK runs: ${out.pendingConflicts}`,\n      );\n      if (out.lastRunAt !== undefined) {\n        print(`  last run: ${out.lastRunAt} (${out.lastRunStatus})`);\n      }\n    });\n    return out;\n  } finally {\n    await ctx.close();\n  }\n}\n\n/** @stable */\nexport interface ConsolidatorSetTierOptions extends ConsolidatorCommonOptions {\n  readonly tier: ConsolidatorTier;\n}\n\n/** @stable */\nexport async function runConsolidatorSetTier(options: ConsolidatorSetTierOptions): Promise<{\n  readonly tier: ConsolidatorTier;\n  readonly applied: false;\n  readonly unsupported: true;\n}> {\n  if (!isTier(options.tier)) {\n    throw new Error(\n      `[graphorin/cli] invalid tier '${String(options.tier)}'. Allowed: ${VALID_TIERS.join(' | ')}.`,\n    );\n  }\n  const ctx = await openStoreContext({\n    ...(options.config !== undefined ? { config: options.config } : {}),\n  });\n  try {\n    // IP-4: the old implementation upserted a `consolidator_admin` row\n    // NOTHING polls (neither the daemon nor process startup reads it -\n    // createConsolidator takes the tier from opts) and reported\n    // success. Honest answer until a daemon-side control channel\n    // exists: UNSUPPORTED with the working alternative.\n    const result = { tier: options.tier, applied: false, unsupported: true } as const;\n    emitReport(options, result, () => {\n      const print = options.print ?? defaultPrintSink;\n      print(\n        brand(\n          `runtime tier switching is not wired yet - set the tier in the server config (consolidator.tier: '${options.tier}') and restart, or use the server API when available.`,\n        ),\n      );\n    });\n    process.exitCode = EXIT_CODES.UNSUPPORTED;\n    return result;\n  } finally {\n    await ctx.close();\n  }\n}\n\n/** @stable */\nexport interface ConsolidatorStopOptions extends ConsolidatorCommonOptions {}\n\n/** @stable */\nexport async function runConsolidatorStop(\n  options: ConsolidatorStopOptions = {},\n): Promise<{ readonly stopped: false; readonly unsupported: true }> {\n  const ctx = await openStoreContext({\n    ...(options.config !== undefined ? { config: options.config } : {}),\n  });\n  try {\n    // IP-4: the old implementation persisted a pause flag NOTHING\n    // honoured and told the operator the daemon would stop - the worst\n    // possible lie when someone is trying to stop runaway LLM spend.\n    const result = { stopped: false, unsupported: true } as const;\n    emitReport(options, result, () => {\n      const print = options.print ?? defaultPrintSink;\n      print(\n        brand(\n          'a CLI stop channel is not wired yet - to stop consolidation NOW, stop the server process (the consolidator runs inside it).',\n        ),\n      );\n      print(\n        brand(\n          'To stay stopped across restarts set consolidator.tier to a zero-budget tier in the config.',\n        ),\n      );\n    });\n    process.exitCode = EXIT_CODES.UNSUPPORTED;\n    return result;\n  } finally {\n    await ctx.close();\n  }\n}\n\nfunction isTier(value: unknown): value is ConsolidatorTier {\n  return typeof value === 'string' && (VALID_TIERS as ReadonlyArray<string>).includes(value);\n}\n\n/**\n * Exit code emitted when a tier value fails validation. Re-exported\n * so the binary can surface the same code to downstream callers.\n *\n * @stable\n */\nexport const CONSOLIDATOR_INVALID_TIER_EXIT = EXIT_CODES.RECOVERABLE_FAILURE;\n"],"mappings":"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"}
+{"version":3,"file":"consolidator.js","names":["VALID_TIERS: ReadonlyArray<ConsolidatorTier>","out: ConsolidatorStatusResult","out: ReadonlyArray<ConsolidatorDlqEntry>","conditions: string[]","params: unknown[]","out: ConsolidatorDlqClearResult"],"sources":["../../src/commands/consolidator.ts"],"sourcesContent":["/**\n * `graphorin consolidator` - inspect and steer the background memory\n * consolidation pipeline.\n *\n * Surface (per Phase 15 § Consolidator):\n *\n *  - `graphorin consolidator status` - current tier + pending CONFLICT-\n *    CHECK runs + DLQ size + recent run history.\n *  - `graphorin consolidator set-tier <free|cheap|standard|enterprise>`\n *    - persist the requested tier so the next process startup picks it\n *    up.\n *  - `graphorin consolidator stop` - pause the consolidator until the\n *    operator resumes it (next `graphorin start`).\n *\n * The consolidator runs **inside** the server process, so the CLI\n * cannot direct-control a live in-memory instance from a different\n * process. `status` reads the SQLite tables the running consolidator\n * writes to (`consolidator_state`, `consolidator_runs`,\n * `consolidator_failed_batches`, `conflict_check_pending`); `set-tier`\n * and `stop` honestly report UNSUPPORTED until a daemon-side control\n * channel exists (IP-4) - nothing polls an admin table.\n *\n * @packageDocumentation\n */\n\nimport type { ConsolidatorTier } from '@graphorin/memory';\n\nimport { EXIT_CODES } from '../internal/exit.js';\nimport {\n  brand,\n  type CommonOutputOptions,\n  defaultPrintSink,\n  emitReport,\n  statusMarker,\n} from '../internal/output.js';\nimport { openStoreContext } from '../internal/store-context.js';\n\nconst VALID_TIERS: ReadonlyArray<ConsolidatorTier> = Object.freeze([\n  'free',\n  'cheap',\n  'standard',\n  'full',\n  'custom',\n] as const);\n\n/** @stable */\nexport interface ConsolidatorCommonOptions extends CommonOutputOptions {\n  readonly config?: string;\n}\n\n/** @stable */\nexport interface ConsolidatorStatusResult {\n  readonly tierHint?: ConsolidatorTier;\n  readonly recentRuns: number;\n  readonly successfulRuns: number;\n  readonly failedRuns: number;\n  readonly dlqSize: number;\n  readonly pendingConflicts: number;\n  readonly lastRunAt?: string;\n  readonly lastRunStatus?: string;\n}\n\n/** @stable */\nexport async function runConsolidatorStatus(\n  options: ConsolidatorCommonOptions = {},\n): Promise<ConsolidatorStatusResult> {\n  const ctx = await openStoreContext({\n    // W-068: read-only command - never auto-migrate a live database.\n    migrationPolicy: 'check',\n    ...(options.config !== undefined ? { config: options.config } : {}),\n  });\n  try {\n    const conn = ctx.store.connection;\n    const recent = conn.get<{ n: number }>(\n      'SELECT COUNT(*) AS n FROM consolidator_runs WHERE started_at > ?',\n      [Date.now() - 24 * 60 * 60_000],\n    );\n    // MCON-5: the store writes 'running' | 'completed' | 'failed' |\n    // 'partial' | 'deferred' (consolidator-store.ts) - the old queries\n    // asked for 'success'/'error'/'pending' and always returned 0.\n    const success = conn.get<{ n: number }>(\n      \"SELECT COUNT(*) AS n FROM consolidator_runs WHERE status = 'completed' AND started_at > ?\",\n      [Date.now() - 24 * 60 * 60_000],\n    );\n    const failed = conn.get<{ n: number }>(\n      \"SELECT COUNT(*) AS n FROM consolidator_runs WHERE status = 'failed' AND started_at > ?\",\n      [Date.now() - 24 * 60 * 60_000],\n    );\n    const dlq = conn.get<{ n: number }>('SELECT COUNT(*) AS n FROM consolidator_failed_batches');\n    // Pending conflict work lives in conflict_check_pending, not in\n    // consolidator_runs ('pending' was never a run status).\n    const pending = conn.get<{ n: number }>(\n      'SELECT COUNT(*) AS n FROM conflict_check_pending WHERE resolved_at IS NULL',\n    );\n    const last = conn.get<{ started_at: number; status: string }>(\n      'SELECT started_at, status FROM consolidator_runs ORDER BY started_at DESC LIMIT 1',\n    );\n    const out: ConsolidatorStatusResult = Object.freeze({\n      recentRuns: recent?.n ?? 0,\n      successfulRuns: success?.n ?? 0,\n      failedRuns: failed?.n ?? 0,\n      dlqSize: dlq?.n ?? 0,\n      pendingConflicts: pending?.n ?? 0,\n      ...(last !== undefined ? { lastRunAt: new Date(last.started_at).toISOString() } : {}),\n      ...(last !== undefined ? { lastRunStatus: last.status } : {}),\n    });\n    emitReport(options, out, () => {\n      const print = options.print ?? defaultPrintSink;\n      const tier = out.tierHint ?? '<from running config>';\n      print(brand(`consolidator status (tier hint: ${tier})`));\n      print(\n        `  ${statusMarker('ok')} runs in last 24h: ${out.recentRuns} (${out.successfulRuns} success, ${out.failedRuns} error)`,\n      );\n      print(`  ${statusMarker(out.dlqSize > 0 ? 'warn' : 'ok')} dead-letter queue: ${out.dlqSize}`);\n      print(\n        `  ${statusMarker(out.pendingConflicts > 0 ? 'warn' : 'ok')} pending CONFLICT-CHECK runs: ${out.pendingConflicts}`,\n      );\n      if (out.lastRunAt !== undefined) {\n        print(`  last run: ${out.lastRunAt} (${out.lastRunStatus})`);\n      }\n    });\n    return out;\n  } finally {\n    await ctx.close();\n  }\n}\n\n/** @stable */\nexport interface ConsolidatorSetTierOptions extends ConsolidatorCommonOptions {\n  readonly tier: ConsolidatorTier;\n}\n\n/** @stable */\nexport async function runConsolidatorSetTier(options: ConsolidatorSetTierOptions): Promise<{\n  readonly tier: ConsolidatorTier;\n  readonly applied: false;\n  readonly unsupported: true;\n}> {\n  if (!isTier(options.tier)) {\n    throw new Error(\n      `[graphorin/cli] invalid tier '${String(options.tier)}'. Allowed: ${VALID_TIERS.join(' | ')}.`,\n    );\n  }\n  const ctx = await openStoreContext({\n    ...(options.config !== undefined ? { config: options.config } : {}),\n  });\n  try {\n    // IP-4: the old implementation upserted a `consolidator_admin` row\n    // NOTHING polls (neither the daemon nor process startup reads it -\n    // createConsolidator takes the tier from opts) and reported\n    // success. Honest answer until a daemon-side control channel\n    // exists: UNSUPPORTED with the working alternative.\n    const result = { tier: options.tier, applied: false, unsupported: true } as const;\n    emitReport(options, result, () => {\n      const print = options.print ?? defaultPrintSink;\n      print(\n        brand(\n          `runtime tier switching is not wired yet - set the tier in the server config (consolidator.tier: '${options.tier}') and restart, or use the server API when available.`,\n        ),\n      );\n    });\n    process.exitCode = EXIT_CODES.UNSUPPORTED;\n    return result;\n  } finally {\n    await ctx.close();\n  }\n}\n\n/** @stable */\nexport interface ConsolidatorStopOptions extends ConsolidatorCommonOptions {}\n\n/** @stable */\nexport async function runConsolidatorStop(\n  options: ConsolidatorStopOptions = {},\n): Promise<{ readonly stopped: false; readonly unsupported: true }> {\n  const ctx = await openStoreContext({\n    ...(options.config !== undefined ? { config: options.config } : {}),\n  });\n  try {\n    // IP-4: the old implementation persisted a pause flag NOTHING\n    // honoured and told the operator the daemon would stop - the worst\n    // possible lie when someone is trying to stop runaway LLM spend.\n    const result = { stopped: false, unsupported: true } as const;\n    emitReport(options, result, () => {\n      const print = options.print ?? defaultPrintSink;\n      print(\n        brand(\n          'a CLI stop channel is not wired yet - to stop consolidation NOW, stop the server process (the consolidator runs inside it).',\n        ),\n      );\n      print(\n        brand(\n          'To stay stopped across restarts set consolidator.tier to a zero-budget tier in the config.',\n        ),\n      );\n    });\n    process.exitCode = EXIT_CODES.UNSUPPORTED;\n    return result;\n  } finally {\n    await ctx.close();\n  }\n}\n\n/** One dead-letter batch as surfaced by `consolidator dlq list`. @stable */\nexport interface ConsolidatorDlqEntry {\n  readonly id: string;\n  readonly userId: string | null;\n  readonly phase: string | null;\n  readonly errorKind: string | null;\n  readonly retryCount: number;\n  readonly failedAt: string;\n  /** `true` when retries are exhausted (`next_retry_at IS NULL`). */\n  readonly exhausted: boolean;\n}\n\n/** @stable */\nexport interface ConsolidatorDlqListOptions extends ConsolidatorCommonOptions {\n  /** Narrow to one user's batches (`scope_user_id`). */\n  readonly user?: string;\n  readonly limit?: number;\n}\n\n/**\n * W-065: make the permanent `dead-letter queue: N` status warning\n * actionable. Operator-level (DB-wide) view, like the `dlqSize`\n * counter in `runConsolidatorStatus` - `listFailedBatches` on the\n * store is scoped to one `SessionScope.userId`, which a CLI does not\n * have; use `--user` to narrow.\n *\n * @stable\n */\nexport async function runConsolidatorDlqList(\n  options: ConsolidatorDlqListOptions = {},\n): Promise<ReadonlyArray<ConsolidatorDlqEntry>> {\n  const ctx = await openStoreContext({\n    // W-068: read-only command - never auto-migrate a live database.\n    migrationPolicy: 'check',\n    ...(options.config !== undefined ? { config: options.config } : {}),\n  });\n  try {\n    const conn = ctx.store.connection;\n    const limit = options.limit ?? 100;\n    const rows =\n      options.user !== undefined\n        ? conn.all<DlqRow>(\n            'SELECT id, scope_user_id, phase, error_kind, retry_count, failed_at, next_retry_at FROM consolidator_failed_batches WHERE scope_user_id = ? ORDER BY failed_at DESC LIMIT ?',\n            [options.user, limit],\n          )\n        : conn.all<DlqRow>(\n            'SELECT id, scope_user_id, phase, error_kind, retry_count, failed_at, next_retry_at FROM consolidator_failed_batches ORDER BY failed_at DESC LIMIT ?',\n            [limit],\n          );\n    const out: ReadonlyArray<ConsolidatorDlqEntry> = Object.freeze(\n      rows.map((row) =>\n        Object.freeze({\n          id: row.id,\n          userId: row.scope_user_id,\n          phase: row.phase,\n          errorKind: row.error_kind,\n          retryCount: row.retry_count,\n          failedAt: new Date(row.failed_at).toISOString(),\n          exhausted: row.next_retry_at === null,\n        }),\n      ),\n    );\n    emitReport(options, out, () => {\n      const print = options.print ?? defaultPrintSink;\n      if (out.length === 0) {\n        print(brand('dead-letter queue is empty.'));\n        return;\n      }\n      print(brand(`dead-letter queue: ${out.length} batch(es)`));\n      for (const entry of out) {\n        const state = entry.exhausted ? 'EXHAUSTED' : 'awaiting retry';\n        print(\n          `  ${entry.id}  user=${entry.userId ?? '-'}  phase=${entry.phase ?? '-'}  kind=${entry.errorKind ?? '-'}  retries=${entry.retryCount}  failedAt=${entry.failedAt}  [${state}]`,\n        );\n      }\n    });\n    return out;\n  } finally {\n    await ctx.close();\n  }\n}\n\n/** @stable */\nexport interface ConsolidatorDlqClearOptions extends ConsolidatorCommonOptions {\n  /**\n   * Only clear EXHAUSTED batches (`next_retry_at IS NULL`). Default\n   * `true` - batches still awaiting retry belong to\n   * `claimReadyBatches` and are only removed with an explicit\n   * `--exhausted-only=false`.\n   */\n  readonly exhaustedOnly?: boolean;\n  /** ISO date / epoch-ms: only batches that failed before this instant. */\n  readonly before?: string;\n  /** Clear one batch by id. */\n  readonly id?: string;\n  /** Narrow to one user's batches (`scope_user_id`). */\n  readonly user?: string;\n}\n\n/** @stable */\nexport interface ConsolidatorDlqClearResult {\n  readonly removed: number;\n}\n\n/**\n * W-065: clear dead-letter batches. Defaults are conservative:\n * exhausted-only, all users, no age bound. The batch payload (message\n * ids) is lost on delete - that is the explicit point of the command.\n *\n * @stable\n */\nexport async function runConsolidatorDlqClear(\n  options: ConsolidatorDlqClearOptions = {},\n): Promise<ConsolidatorDlqClearResult> {\n  const ctx = await openStoreContext({\n    ...(options.config !== undefined ? { config: options.config } : {}),\n  });\n  try {\n    const conn = ctx.store.connection;\n    const conditions: string[] = [];\n    const params: unknown[] = [];\n    if (options.id !== undefined) {\n      conditions.push('id = ?');\n      params.push(options.id);\n    }\n    if (options.exhaustedOnly !== false) {\n      conditions.push('next_retry_at IS NULL');\n    }\n    if (options.before !== undefined) {\n      const ms = Number.isFinite(Number(options.before))\n        ? Number(options.before)\n        : Date.parse(options.before);\n      if (!Number.isFinite(ms)) {\n        throw new Error(\n          `[graphorin/cli] --before '${options.before}' is not a valid ISO date or epoch-ms value.`,\n        );\n      }\n      conditions.push('failed_at < ?');\n      params.push(ms);\n    }\n    if (options.user !== undefined) {\n      conditions.push('scope_user_id = ?');\n      params.push(options.user);\n    }\n    const where = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';\n    const result = conn.run(`DELETE FROM consolidator_failed_batches ${where}`, params);\n    const out: ConsolidatorDlqClearResult = Object.freeze({ removed: result.changes ?? 0 });\n    emitReport(options, out, () => {\n      const print = options.print ?? defaultPrintSink;\n      const mark = out.removed > 0 ? statusMarker('ok') : statusMarker('info');\n      print(brand(`${mark} cleared ${out.removed} dead-letter batch(es).`));\n    });\n    return out;\n  } finally {\n    await ctx.close();\n  }\n}\n\ninterface DlqRow {\n  readonly id: string;\n  readonly scope_user_id: string | null;\n  readonly phase: string | null;\n  readonly error_kind: string | null;\n  readonly retry_count: number;\n  readonly failed_at: number;\n  readonly next_retry_at: number | null;\n}\n\nfunction isTier(value: unknown): value is ConsolidatorTier {\n  return typeof value === 'string' && (VALID_TIERS as ReadonlyArray<string>).includes(value);\n}\n\n/**\n * Exit code emitted when a tier value fails validation. Re-exported\n * so the binary can surface the same code to downstream callers.\n *\n * @stable\n */\nexport const CONSOLIDATOR_INVALID_TIER_EXIT = EXIT_CODES.RECOVERABLE_FAILURE;\n"],"mappings":"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"}

package/dist/commands/doctor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doctor.d.ts","names":[],"sources":["../../src/commands/doctor.ts"],"sourcesContent":[],"mappings":";;;;;;;AAmDA;AA2BiB,UA3BA,oBAAA,SAA6B,mBA2BjB,CAAA;EAGR;;;;EAQgB,SAAA,IAAA,CAAA,EAAA,MAAA;EASf;EAAmB,SAAA,QAAA,CAAA,EAAA,OAAA;EAAoC;EAAR,SAAA,UAAA,CAAA,EAAA,OAAA;EAAO;EA4F5D,SAAA,YAAiB,CAAA,EAAA,OAAyB;;;;;;;;;;yCAtHjB;;;;;UAMxB,YAAA;;;qBAGI,MAAA,CAAO;mBACT,cAAc;;;;;;;wBAOT;;;;;;;;iBASF,SAAA,WAAmB,uBAA4B,QAAQ;;;;;;;iBA4F7D,iBAAA,gBAAiC,SAAS"}
+{"version":3,"file":"doctor.d.ts","names":[],"sources":["../../src/commands/doctor.ts"],"sourcesContent":[],"mappings":";;;;;;;AAmDA;AA2BiB,UA3BA,oBAAA,SAA6B,mBA2BjB,CAAA;EAGR;;;;EAQgB,SAAA,IAAA,CAAA,EAAA,MAAA;EASf;EAAmB,SAAA,QAAA,CAAA,EAAA,OAAA;EAAoC;EAAR,SAAA,UAAA,CAAA,EAAA,OAAA;EAAO;EA4F5D,SAAA,YAAiB,CAAA,EAAA,OAAA;;;;;;;;;;yCAtHQ;;;;;UAMxB,YAAA;;;qBAGI,MAAA,CAAO;mBACT,cAAc;;;;;;;wBAOT;;;;;;;;iBASF,SAAA,WAAmB,uBAA4B,QAAQ;;;;;;;iBA4F7D,iBAAA,gBAAiC,SAAS"}

package/dist/commands/index.d.ts

@@ -1,10 +1,10 @@
 import { AuditCommonOptions, AuditExportOptions, AuditExportResult, AuditPruneOptions, AuditVerifyResult, runAuditExport, runAuditPrune, runAuditVerify } from "./audit.js";
 import { AuthCommonOptions, AuthListOptions, AuthLoginOptions, AuthRefreshOptions, AuthRevokeOptions, runAuthList, runAuthLogin, runAuthRefresh, runAuthRevoke, runAuthStatus } from "./auth.js";
-import { CONSOLIDATOR_INVALID_TIER_EXIT, ConsolidatorCommonOptions, ConsolidatorSetTierOptions, ConsolidatorStatusResult, ConsolidatorStopOptions, runConsolidatorSetTier, runConsolidatorStatus, runConsolidatorStop } from "./consolidator.js";
+import { CONSOLIDATOR_INVALID_TIER_EXIT, ConsolidatorCommonOptions, ConsolidatorDlqClearOptions, ConsolidatorDlqClearResult, ConsolidatorDlqEntry, ConsolidatorDlqListOptions, ConsolidatorSetTierOptions, ConsolidatorStatusResult, ConsolidatorStopOptions, runConsolidatorDlqClear, runConsolidatorDlqList, runConsolidatorSetTier, runConsolidatorStatus, runConsolidatorStop } from "./consolidator.js";
 import { DoctorCommandOptions, DoctorReport, expectedFileModes, runDoctor } from "./doctor.js";
 import { GuardCommonOptions, GuardExplainOptions, GuardExplainResult, GuardStatusEntry, runGuardExplain, runGuardStatus } from "./guard.js";
 import { InitCommandOptions, InitCommandResult, runInit } from "./init.js";
-import { MemoryActivityConflict, MemoryActivityEvent, MemoryActivityOptions, MemoryActivityResult, MemoryCitingInsight, MemoryCommonOptions, MemoryConflictEntry, MemoryHistoryEntry, MemoryInspectEntity, MemoryInspectFact, MemoryInspectOptions, MemoryInspectResult, MemoryMigrateOptions, MemoryReviewItem, MemoryReviewOptions, MemoryReviewResult, MemoryStatusEmbedder, MemoryStatusResult, MemoryWhyOptions, MemoryWhyRecall, MemoryWhyResult, runMemoryActivity, runMemoryInspect, runMemoryMigrate, runMemoryReview, runMemoryStatus, runMemoryWhy } from "./memory.js";
+import { MemoryActivityConflict, MemoryActivityEvent, MemoryActivityOptions, MemoryActivityResult, MemoryCitingInsight, MemoryCommonOptions, MemoryConflictEntry, MemoryHistoryEntry, MemoryInspectEntity, MemoryInspectFact, MemoryInspectOptions, MemoryInspectResult, MemoryMigrateOptions, MemoryPruneHistoryOptions, MemoryPruneHistoryResult, MemoryReviewItem, MemoryReviewOptions, MemoryReviewResult, MemoryStatusEmbedder, MemoryStatusResult, MemoryWhyOptions, MemoryWhyRecall, MemoryWhyResult, runMemoryActivity, runMemoryInspect, runMemoryMigrate, runMemoryPruneHistory, runMemoryReview, runMemoryStatus, runMemoryWhy } from "./memory.js";
 import { MigrateCommandOptions, MigrateCommandResult, runMigrate } from "./migrate.js";
 import { MigrateConfigOptions, MigrateConfigResult, runMigrateConfig } from "./migrate-config.js";
 import { MigrateExportOptions, MigrateExportResult, runMigrateExport } from "./migrate-export.js";
@@ -12,10 +12,10 @@ import { PricingCommonOptions, PricingDiffOptions, PricingLookupOptions, Pricing
 import { SecretsCommonOptions, SecretsDeleteOptions, SecretsGetOptions, SecretsGetResult, SecretsListOptions, SecretsRefOptions, SecretsRefResult, SecretsRotateOptions, SecretsSetOptions, runSecretsDelete, runSecretsGet, runSecretsList, runSecretsRef, runSecretsRotate, runSecretsSet } from "./secrets.js";
 import { SkillTrustLevelInput, SkillsAuditOptions, SkillsCommonOptions, SkillsInspectOptions, SkillsInstallOptions, SkillsMigrateFrontmatterOptions, SkillsMigrateFrontmatterResult, runSkillsAudit, runSkillsInspect, runSkillsInstall, runSkillsMigrateFrontmatter } from "./skills.js";
 import { SecretsSourceFlag, StartCommandOptions, runStart } from "./start.js";
-import { StorageBackupOptions, StorageBackupResult, StorageCleanupBackupsOptions, StorageCleanupBackupsResult, StorageCommonOptions, StorageEncryptOptions, StorageRekeyOptions, StorageStatusResult, runStorageBackup, runStorageCleanupBackups, runStorageEncrypt, runStorageRekey, runStorageStatus } from "./storage.js";
+import { StorageBackupOptions, StorageBackupResult, StorageCleanupBackupsOptions, StorageCleanupBackupsResult, StorageCommonOptions, StorageCompactOptions, StorageCompactResult, StorageEncryptOptions, StorageRekeyOptions, StorageStatusResult, runStorageBackup, runStorageCleanupBackups, runStorageCompact, runStorageEncrypt, runStorageRekey, runStorageStatus } from "./storage.js";
 import { TelemetryStatusResult, runTelemetryDisable, runTelemetryEnable, runTelemetryInspect, runTelemetryStatus } from "./telemetry.js";
 import { TokenCommonOptions, TokenCreateOptions, TokenCreateResult, TokenListOptions, TokenRekeyOptions, TokenRevokeOptions, TokenRotateOptions, TokenVerifyOptions, TokenVerifyResult, parseDuration, runTokenCreate, runTokenList, runTokenRekey, runTokenRevoke, runTokenRotate, runTokenVerify } from "./token.js";
 import { ToolsLintOptions, ToolsLintReport, runToolsLint } from "./tools-lint.js";
 import { TracesCommonOptions, TracesPruneOptions, TracesPruneResult, TracesStatusResult, runTracesPrune, runTracesStatus } from "./traces.js";
 import { TriggersCommonOptions, TriggersDisableOptions, TriggersFireOptions, TriggersPruneOptions, TriggersPruneResult, TriggersStatusOptions, runTriggersDisable, runTriggersFire, runTriggersList, runTriggersPrune, runTriggersStatus } from "./triggers.js";
-export { type AuditCommonOptions, type AuditExportOptions, type AuditExportResult, type AuditPruneOptions, type AuditVerifyResult, type AuthCommonOptions, type AuthListOptions, type AuthLoginOptions, type AuthRefreshOptions, type AuthRevokeOptions, CONSOLIDATOR_INVALID_TIER_EXIT, type ConsolidatorCommonOptions, type ConsolidatorSetTierOptions, type ConsolidatorStatusResult, type ConsolidatorStopOptions, type DoctorCommandOptions, type DoctorReport, type GuardCommonOptions, type GuardExplainOptions, type GuardExplainResult, type GuardStatusEntry, type InitCommandOptions, type InitCommandResult, type MemoryActivityConflict, type MemoryActivityEvent, type MemoryActivityOptions, type MemoryActivityResult, type MemoryCitingInsight, type MemoryCommonOptions, type MemoryConflictEntry, type MemoryHistoryEntry, type MemoryInspectEntity, type MemoryInspectFact, type MemoryInspectOptions, type MemoryInspectResult, type MemoryMigrateOptions, type MemoryReviewItem, type MemoryReviewOptions, type MemoryReviewResult, type MemoryStatusEmbedder, type MemoryStatusResult, type MemoryWhyOptions, type MemoryWhyRecall, type MemoryWhyResult, type MigrateCommandOptions, type MigrateCommandResult, type MigrateConfigOptions, type MigrateConfigResult, type MigrateExportOptions, type MigrateExportResult, type PricingCommonOptions, type PricingDiffOptions, type PricingLookupOptions, type PricingMissingOptions, type PricingRefreshOptions, type PricingStatusResult, type SecretsCommonOptions, type SecretsDeleteOptions, type SecretsGetOptions, type SecretsGetResult, type SecretsListOptions, type SecretsRefOptions, type SecretsRefResult, type SecretsRotateOptions, type SecretsSetOptions, type SecretsSourceFlag, type SkillTrustLevelInput, type SkillsAuditOptions, type SkillsCommonOptions, type SkillsInspectOptions, type SkillsInstallOptions, type SkillsMigrateFrontmatterOptions, type SkillsMigrateFrontmatterResult, type StartCommandOptions, type StorageBackupOptions, type StorageBackupResult, type StorageCleanupBackupsOptions, type StorageCleanupBackupsResult, type StorageCommonOptions, type StorageEncryptOptions, type StorageRekeyOptions, type StorageStatusResult, type TelemetryStatusResult, type TokenCommonOptions, type TokenCreateOptions, type TokenCreateResult, type TokenListOptions, type TokenRekeyOptions, type TokenRevokeOptions, type TokenRotateOptions, type TokenVerifyOptions, type TokenVerifyResult, type ToolsLintOptions, type ToolsLintReport, type TracesCommonOptions, type TracesPruneOptions, type TracesPruneResult, type TracesStatusResult, type TriggersCommonOptions, type TriggersDisableOptions, type TriggersFireOptions, type TriggersPruneOptions, type TriggersPruneResult, type TriggersStatusOptions, expectedFileModes, parseDuration, runAuditExport, runAuditPrune, runAuditVerify, runAuthList, runAuthLogin, runAuthRefresh, runAuthRevoke, runAuthStatus, runConsolidatorSetTier, runConsolidatorStatus, runConsolidatorStop, runDoctor, runGuardExplain, runGuardStatus, runInit, runMemoryActivity, runMemoryInspect, runMemoryMigrate, runMemoryReview, runMemoryStatus, runMemoryWhy, runMigrate, runMigrateConfig, runMigrateExport, runPricingDiff, runPricingLookup, runPricingMissing, runPricingRefresh, runPricingStatus, runSecretsDelete, runSecretsGet, runSecretsList, runSecretsRef, runSecretsRotate, runSecretsSet, runSkillsAudit, runSkillsInspect, runSkillsInstall, runSkillsMigrateFrontmatter, runStart, runStorageBackup, runStorageCleanupBackups, runStorageEncrypt, runStorageRekey, runStorageStatus, runTelemetryDisable, runTelemetryEnable, runTelemetryInspect, runTelemetryStatus, runTokenCreate, runTokenList, runTokenRekey, runTokenRevoke, runTokenRotate, runTokenVerify, runToolsLint, runTracesPrune, runTracesStatus, runTriggersDisable, runTriggersFire, runTriggersList, runTriggersPrune, runTriggersStatus };
+export { type AuditCommonOptions, type AuditExportOptions, type AuditExportResult, type AuditPruneOptions, type AuditVerifyResult, type AuthCommonOptions, type AuthListOptions, type AuthLoginOptions, type AuthRefreshOptions, type AuthRevokeOptions, CONSOLIDATOR_INVALID_TIER_EXIT, type ConsolidatorCommonOptions, type ConsolidatorDlqClearOptions, type ConsolidatorDlqClearResult, type ConsolidatorDlqEntry, type ConsolidatorDlqListOptions, type ConsolidatorSetTierOptions, type ConsolidatorStatusResult, type ConsolidatorStopOptions, type DoctorCommandOptions, type DoctorReport, type GuardCommonOptions, type GuardExplainOptions, type GuardExplainResult, type GuardStatusEntry, type InitCommandOptions, type InitCommandResult, type MemoryActivityConflict, type MemoryActivityEvent, type MemoryActivityOptions, type MemoryActivityResult, type MemoryCitingInsight, type MemoryCommonOptions, type MemoryConflictEntry, type MemoryHistoryEntry, type MemoryInspectEntity, type MemoryInspectFact, type MemoryInspectOptions, type MemoryInspectResult, type MemoryMigrateOptions, type MemoryPruneHistoryOptions, type MemoryPruneHistoryResult, type MemoryReviewItem, type MemoryReviewOptions, type MemoryReviewResult, type MemoryStatusEmbedder, type MemoryStatusResult, type MemoryWhyOptions, type MemoryWhyRecall, type MemoryWhyResult, type MigrateCommandOptions, type MigrateCommandResult, type MigrateConfigOptions, type MigrateConfigResult, type MigrateExportOptions, type MigrateExportResult, type PricingCommonOptions, type PricingDiffOptions, type PricingLookupOptions, type PricingMissingOptions, type PricingRefreshOptions, type PricingStatusResult, type SecretsCommonOptions, type SecretsDeleteOptions, type SecretsGetOptions, type SecretsGetResult, type SecretsListOptions, type SecretsRefOptions, type SecretsRefResult, type SecretsRotateOptions, type SecretsSetOptions, type SecretsSourceFlag, type SkillTrustLevelInput, type SkillsAuditOptions, type SkillsCommonOptions, type SkillsInspectOptions, type SkillsInstallOptions, type SkillsMigrateFrontmatterOptions, type SkillsMigrateFrontmatterResult, type StartCommandOptions, type StorageBackupOptions, type StorageBackupResult, type StorageCleanupBackupsOptions, type StorageCleanupBackupsResult, type StorageCommonOptions, type StorageCompactOptions, type StorageCompactResult, type StorageEncryptOptions, type StorageRekeyOptions, type StorageStatusResult, type TelemetryStatusResult, type TokenCommonOptions, type TokenCreateOptions, type TokenCreateResult, type TokenListOptions, type TokenRekeyOptions, type TokenRevokeOptions, type TokenRotateOptions, type TokenVerifyOptions, type TokenVerifyResult, type ToolsLintOptions, type ToolsLintReport, type TracesCommonOptions, type TracesPruneOptions, type TracesPruneResult, type TracesStatusResult, type TriggersCommonOptions, type TriggersDisableOptions, type TriggersFireOptions, type TriggersPruneOptions, type TriggersPruneResult, type TriggersStatusOptions, expectedFileModes, parseDuration, runAuditExport, runAuditPrune, runAuditVerify, runAuthList, runAuthLogin, runAuthRefresh, runAuthRevoke, runAuthStatus, runConsolidatorDlqClear, runConsolidatorDlqList, runConsolidatorSetTier, runConsolidatorStatus, runConsolidatorStop, runDoctor, runGuardExplain, runGuardStatus, runInit, runMemoryActivity, runMemoryInspect, runMemoryMigrate, runMemoryPruneHistory, runMemoryReview, runMemoryStatus, runMemoryWhy, runMigrate, runMigrateConfig, runMigrateExport, runPricingDiff, runPricingLookup, runPricingMissing, runPricingRefresh, runPricingStatus, runSecretsDelete, runSecretsGet, runSecretsList, runSecretsRef, runSecretsRotate, runSecretsSet, runSkillsAudit, runSkillsInspect, runSkillsInstall, runSkillsMigrateFrontmatter, runStart, runStorageBackup, runStorageCleanupBackups, runStorageCompact, runStorageEncrypt, runStorageRekey, runStorageStatus, runTelemetryDisable, runTelemetryEnable, runTelemetryInspect, runTelemetryStatus, runTokenCreate, runTokenList, runTokenRekey, runTokenRevoke, runTokenRotate, runTokenVerify, runToolsLint, runTracesPrune, runTracesStatus, runTriggersDisable, runTriggersFire, runTriggersList, runTriggersPrune, runTriggersStatus };

package/dist/commands/index.js

@@ -1,10 +1,10 @@
 import { runAuditExport, runAuditPrune, runAuditVerify } from "./audit.js";
 import { runAuthList, runAuthLogin, runAuthRefresh, runAuthRevoke, runAuthStatus } from "./auth.js";
-import { CONSOLIDATOR_INVALID_TIER_EXIT, runConsolidatorSetTier, runConsolidatorStatus, runConsolidatorStop } from "./consolidator.js";
+import { CONSOLIDATOR_INVALID_TIER_EXIT, runConsolidatorDlqClear, runConsolidatorDlqList, runConsolidatorSetTier, runConsolidatorStatus, runConsolidatorStop } from "./consolidator.js";
 import { expectedFileModes, runDoctor } from "./doctor.js";
 import { runGuardExplain, runGuardStatus } from "./guard.js";
 import { runInit } from "./init.js";
-import { runMemoryActivity, runMemoryInspect, runMemoryMigrate, runMemoryReview, runMemoryStatus, runMemoryWhy } from "./memory.js";
+import { runMemoryActivity, runMemoryInspect, runMemoryMigrate, runMemoryPruneHistory, runMemoryReview, runMemoryStatus, runMemoryWhy } from "./memory.js";
 import { runStart } from "./start.js";
 import { runMigrate } from "./migrate.js";
 import { runMigrateConfig } from "./migrate-config.js";
@@ -12,11 +12,11 @@ import { runMigrateExport } from "./migrate-export.js";
 import { runPricingDiff, runPricingLookup, runPricingMissing, runPricingRefresh, runPricingStatus } from "./pricing.js";
 import { runSecretsDelete, runSecretsGet, runSecretsList, runSecretsRef, runSecretsRotate, runSecretsSet } from "./secrets.js";
 import { runSkillsAudit, runSkillsInspect, runSkillsInstall, runSkillsMigrateFrontmatter } from "./skills.js";
-import { runStorageBackup, runStorageCleanupBackups, runStorageEncrypt, runStorageRekey, runStorageStatus } from "./storage.js";
+import { runStorageBackup, runStorageCleanupBackups, runStorageCompact, runStorageEncrypt, runStorageRekey, runStorageStatus } from "./storage.js";
 import { runTelemetryDisable, runTelemetryEnable, runTelemetryInspect, runTelemetryStatus } from "./telemetry.js";
 import { parseDuration, runTokenCreate, runTokenList, runTokenRekey, runTokenRevoke, runTokenRotate, runTokenVerify } from "./token.js";
 import { runToolsLint } from "./tools-lint.js";
 import { runTracesPrune, runTracesStatus } from "./traces.js";
 import { runTriggersDisable, runTriggersFire, runTriggersList, runTriggersPrune, runTriggersStatus } from "./triggers.js";
 
-export { CONSOLIDATOR_INVALID_TIER_EXIT, expectedFileModes, parseDuration, runAuditExport, runAuditPrune, runAuditVerify, runAuthList, runAuthLogin, runAuthRefresh, runAuthRevoke, runAuthStatus, runConsolidatorSetTier, runConsolidatorStatus, runConsolidatorStop, runDoctor, runGuardExplain, runGuardStatus, runInit, runMemoryActivity, runMemoryInspect, runMemoryMigrate, runMemoryReview, runMemoryStatus, runMemoryWhy, runMigrate, runMigrateConfig, runMigrateExport, runPricingDiff, runPricingLookup, runPricingMissing, runPricingRefresh, runPricingStatus, runSecretsDelete, runSecretsGet, runSecretsList, runSecretsRef, runSecretsRotate, runSecretsSet, runSkillsAudit, runSkillsInspect, runSkillsInstall, runSkillsMigrateFrontmatter, runStart, runStorageBackup, runStorageCleanupBackups, runStorageEncrypt, runStorageRekey, runStorageStatus, runTelemetryDisable, runTelemetryEnable, runTelemetryInspect, runTelemetryStatus, runTokenCreate, runTokenList, runTokenRekey, runTokenRevoke, runTokenRotate, runTokenVerify, runToolsLint, runTracesPrune, runTracesStatus, runTriggersDisable, runTriggersFire, runTriggersList, runTriggersPrune, runTriggersStatus };
+export { CONSOLIDATOR_INVALID_TIER_EXIT, expectedFileModes, parseDuration, runAuditExport, runAuditPrune, runAuditVerify, runAuthList, runAuthLogin, runAuthRefresh, runAuthRevoke, runAuthStatus, runConsolidatorDlqClear, runConsolidatorDlqList, runConsolidatorSetTier, runConsolidatorStatus, runConsolidatorStop, runDoctor, runGuardExplain, runGuardStatus, runInit, runMemoryActivity, runMemoryInspect, runMemoryMigrate, runMemoryPruneHistory, runMemoryReview, runMemoryStatus, runMemoryWhy, runMigrate, runMigrateConfig, runMigrateExport, runPricingDiff, runPricingLookup, runPricingMissing, runPricingRefresh, runPricingStatus, runSecretsDelete, runSecretsGet, runSecretsList, runSecretsRef, runSecretsRotate, runSecretsSet, runSkillsAudit, runSkillsInspect, runSkillsInstall, runSkillsMigrateFrontmatter, runStart, runStorageBackup, runStorageCleanupBackups, runStorageCompact, runStorageEncrypt, runStorageRekey, runStorageStatus, runTelemetryDisable, runTelemetryEnable, runTelemetryInspect, runTelemetryStatus, runTokenCreate, runTokenList, runTokenRekey, runTokenRevoke, runTokenRotate, runTokenVerify, runToolsLint, runTracesPrune, runTracesStatus, runTriggersDisable, runTriggersFire, runTriggersList, runTriggersPrune, runTriggersStatus };

package/dist/commands/init.d.ts

@@ -4,9 +4,17 @@
  *
  * Writes a fresh `graphorin.config.ts` to the current working
  * directory (or `--out`), prompts the operator for the cloud-upload
- * sensitivity tier + storage encryption opt-in, and prints exactly
- * one bootstrap admin token (held by the operator from this point
- * onward - the tool never persists nor logs the raw value).
+ * sensitivity tier + storage encryption opt-in, prints the server
+ * pepper hex ONCE, and walks the operator through the working
+ * credential path: persist the pepper (stdin, never argv), migrate,
+ * then mint a real token with `graphorin token create`.
+ *
+ * W-003: init deliberately does NOT emit a token itself. Token
+ * verification requires an HMAC lookup in the auth-token store, which
+ * requires migrations + the pepper - init's contract is "write the
+ * config file, touch nothing else" (pinned by tests), so any token it
+ * printed was guaranteed to 401. Honestly pointing at `token create`
+ * follows the IP-4 precedent (no phantom credentials).
  *
  * `--non-interactive` accepts every choice through flags or env vars
  * so the command works equally well in CI / image-build pipelines.
@@ -32,7 +40,6 @@ interface InitCommandOptions {
  */
 interface InitCommandResult {
   readonly configPath: string;
-  readonly bootstrapToken: string;
   readonly serverPepperHex: string;
   readonly cloudConsent: 'public-only' | 'public-and-internal' | 'all-with-warnings';
   readonly storageEncrypted: boolean;

package/dist/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","names":[],"sources":["../../src/commands/init.ts"],"sourcesContent":[],"mappings":";;AA0BA;AAeA;AAWA;;;;;;;;;;;;;;UA1BiB,kBAAA;;;;;;;;;;;;;;UAeA,iBAAA;;;;;;;;;;iBAWK,OAAA,WAAiB,qBAA0B,QAAQ"}
+{"version":3,"file":"init.d.ts","names":[],"sources":["../../src/commands/init.ts"],"sourcesContent":[],"mappings":";;AAkCA;AAeA;AAUA;;;;;;;;;;;;;;;;;;;;;;UAzBiB,kBAAA;;;;;;;;;;;;;;UAeA,iBAAA;;;;;;;;;iBAUK,OAAA,WAAiB,qBAA0B,QAAQ"}

package/dist/commands/init.js

@@ -2,7 +2,7 @@ import { confirm, select } from "../internal/prompts.js";
 import { mkdir, stat, writeFile } from "node:fs/promises";
 import { dirname, isAbsolute, resolve } from "node:path";
 import process from "node:process";
-import { generatePepper, generateRawToken } from "@graphorin/security";
+import { generatePepper } from "@graphorin/security";
 
 //#region src/commands/init.ts
 /**
@@ -10,9 +10,17 @@ import { generatePepper, generateRawToken } from "@graphorin/security";
 *
 * Writes a fresh `graphorin.config.ts` to the current working
 * directory (or `--out`), prompts the operator for the cloud-upload
-* sensitivity tier + storage encryption opt-in, and prints exactly
-* one bootstrap admin token (held by the operator from this point
-* onward - the tool never persists nor logs the raw value).
+* sensitivity tier + storage encryption opt-in, prints the server
+* pepper hex ONCE, and walks the operator through the working
+* credential path: persist the pepper (stdin, never argv), migrate,
+* then mint a real token with `graphorin token create`.
+*
+* W-003: init deliberately does NOT emit a token itself. Token
+* verification requires an HMAC lookup in the auth-token store, which
+* requires migrations + the pepper - init's contract is "write the
+* config file, touch nothing else" (pinned by tests), so any token it
+* printed was guaranteed to 401. Honestly pointing at `token create`
+* follows the IP-4 precedent (no phantom credentials).
 *
 * `--non-interactive` accepts every choice through flags or env vars
 * so the command works equally well in CI / image-build pipelines.
@@ -28,7 +36,6 @@ async function runInit(options = {}) {
 	const cloudConsent = await resolveCloudConsent(options);
 	const storageEncrypted = await resolveEncryption(options);
 	const pepperHex = await generatePepper().useBuffer((buf) => buf.toString("hex"));
-	const bootstrap = generateRawToken({ env: "live" });
 	if (options.dryRun !== true) {
 		if (await fileExists(target)) throw new Error(`[graphorin/cli] refusing to overwrite existing '${target}'. Move it aside or pass --out <path>.`);
 		await mkdir(dirname(target), { recursive: true });
@@ -38,19 +45,16 @@ async function runInit(options = {}) {
 		}), { mode: 384 });
 	}
 	print(`[graphorin/cli] wrote ${target}`);
-	print(`[graphorin/cli] bootstrap admin token (shown ONCE):`);
-	print(`  ${bootstrap.raw}`);
 	print(`[graphorin/cli] server pepper hex (store in your keyring as 'graphorin_server_pepper'):`);
 	print(`  ${pepperHex}`);
 	print("");
 	print("Next steps:");
-	print(`  1. Persist the pepper: graphorin secrets set graphorin_server_pepper --value ${pepperHex}`);
-	print(`  2. Persist the bootstrap token securely; do NOT commit it.`);
-	print(`  3. Run \`graphorin migrate --config ${target}\` to apply storage migrations.`);
+	print(`  1. Persist the pepper WITHOUT argv: printf '%s' '<hex-from-above>' | graphorin secrets set graphorin_server_pepper --from-stdin`);
+	print(`  2. Run \`graphorin migrate --config ${target}\` to apply storage migrations.`);
+	print("  3. Mint your admin token: graphorin token create --label bootstrap --scopes <scopes> (the raw token is shown ONCE).");
 	print(`  4. Run \`graphorin start --config ${target}\` to launch the server.`);
 	return Object.freeze({
 		configPath: target,
-		bootstrapToken: bootstrap.raw,
 		serverPepperHex: pepperHex,
 		cloudConsent,
 		storageEncrypted

package/dist/commands/init.js.map

@@ -1 +1 @@
-{"version":3,"file":"init.js","names":[],"sources":["../../src/commands/init.ts"],"sourcesContent":["/**\n * `graphorin init` - interactive bootstrap.\n *\n * Writes a fresh `graphorin.config.ts` to the current working\n * directory (or `--out`), prompts the operator for the cloud-upload\n * sensitivity tier + storage encryption opt-in, and prints exactly\n * one bootstrap admin token (held by the operator from this point\n * onward - the tool never persists nor logs the raw value).\n *\n * `--non-interactive` accepts every choice through flags or env vars\n * so the command works equally well in CI / image-build pipelines.\n *\n * @packageDocumentation\n */\n\nimport { mkdir, stat, writeFile } from 'node:fs/promises';\nimport { dirname, isAbsolute, resolve } from 'node:path';\nimport process from 'node:process';\n\nimport { generatePepper, generateRawToken } from '@graphorin/security';\n\nimport { confirm, select } from '../internal/prompts.js';\n\n/**\n * @stable\n */\nexport interface InitCommandOptions {\n  readonly out?: string;\n  readonly nonInteractive?: boolean;\n  readonly cloudConsent?: 'public-only' | 'public-and-internal' | 'all-with-warnings';\n  readonly encrypted?: boolean;\n  readonly cwd?: string;\n  /** Test seam: skip writing files (only print the report). */\n  readonly dryRun?: boolean;\n  /** Test seam: redirect stdout/err. */\n  readonly print?: (line: string) => void;\n}\n\n/**\n * @stable\n */\nexport interface InitCommandResult {\n  readonly configPath: string;\n  readonly bootstrapToken: string;\n  readonly serverPepperHex: string;\n  readonly cloudConsent: 'public-only' | 'public-and-internal' | 'all-with-warnings';\n  readonly storageEncrypted: boolean;\n}\n\n/**\n * @stable\n */\nexport async function runInit(options: InitCommandOptions = {}): Promise<InitCommandResult> {\n  const cwd = options.cwd ?? process.cwd();\n  const target = resolveOutPath(cwd, options.out);\n  const print = options.print ?? ((line: string) => process.stderr.write(`${line}\\n`));\n\n  const cloudConsent = await resolveCloudConsent(options);\n  const storageEncrypted = await resolveEncryption(options);\n\n  const pepper = generatePepper();\n  const pepperHex = await pepper.useBuffer((buf) => buf.toString('hex'));\n\n  const bootstrap = generateRawToken({ env: 'live' });\n\n  if (options.dryRun !== true) {\n    if (await fileExists(target)) {\n      throw new Error(\n        `[graphorin/cli] refusing to overwrite existing '${target}'. Move it aside or pass --out <path>.`,\n      );\n    }\n    await mkdir(dirname(target), { recursive: true });\n    await writeFile(target, renderConfig({ cloudConsent, storageEncrypted }), { mode: 0o600 });\n  }\n\n  print(`[graphorin/cli] wrote ${target}`);\n  print(`[graphorin/cli] bootstrap admin token (shown ONCE):`);\n  print(`  ${bootstrap.raw}`);\n  print(`[graphorin/cli] server pepper hex (store in your keyring as 'graphorin_server_pepper'):`);\n  print(`  ${pepperHex}`);\n  print('');\n  print('Next steps:');\n  print(\n    `  1. Persist the pepper: graphorin secrets set graphorin_server_pepper --value ${pepperHex}`,\n  );\n  print(`  2. Persist the bootstrap token securely; do NOT commit it.`);\n  print(`  3. Run \\`graphorin migrate --config ${target}\\` to apply storage migrations.`);\n  print(`  4. Run \\`graphorin start --config ${target}\\` to launch the server.`);\n\n  return Object.freeze({\n    configPath: target,\n    bootstrapToken: bootstrap.raw,\n    serverPepperHex: pepperHex,\n    cloudConsent,\n    storageEncrypted,\n  });\n}\n\nfunction resolveOutPath(cwd: string, out: string | undefined): string {\n  if (out === undefined || out.length === 0) return resolve(cwd, 'graphorin.config.ts');\n  return isAbsolute(out) ? out : resolve(cwd, out);\n}\n\nasync function fileExists(path: string): Promise<boolean> {\n  try {\n    await stat(path);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nasync function resolveCloudConsent(\n  options: InitCommandOptions,\n): Promise<'public-only' | 'public-and-internal' | 'all-with-warnings'> {\n  if (options.cloudConsent !== undefined) return options.cloudConsent;\n  const envValue = process.env.GRAPHORIN_CLOUD_CONSENT;\n  if (\n    envValue === 'public-only' ||\n    envValue === 'public-and-internal' ||\n    envValue === 'all-with-warnings'\n  ) {\n    return envValue;\n  }\n  if (options.nonInteractive === true) return 'public-and-internal';\n  const choice = await select(\n    'Cloud-upload consent for context sent to providers:',\n    ['public-only', 'public-and-internal', 'all-with-warnings'],\n    'public-and-internal',\n  );\n  return choice as 'public-only' | 'public-and-internal' | 'all-with-warnings';\n}\n\nasync function resolveEncryption(options: InitCommandOptions): Promise<boolean> {\n  if (options.encrypted !== undefined) return options.encrypted;\n  if (process.env.GRAPHORIN_STORAGE_ENCRYPTED === '1') return true;\n  if (process.env.GRAPHORIN_STORAGE_ENCRYPTED === '0') return false;\n  if (options.nonInteractive === true) return false;\n  return await confirm('Enable storage encryption (defense-in-depth on top of FDE)?', false);\n}\n\nfunction renderConfig(input: {\n  readonly cloudConsent: 'public-only' | 'public-and-internal' | 'all-with-warnings';\n  readonly storageEncrypted: boolean;\n}): string {\n  return `import { defineConfig } from '@graphorin/server';\n\nexport default defineConfig({\n  server: {\n    host: '127.0.0.1',\n    port: 8080,\n  },\n  auth: {\n    kind: 'token',\n    pepperRef: 'keyring:graphorin_server_pepper',\n  },\n  storage: {\n    path: './.graphorin/data.db',\n    mode: 'server',\n    encryption: ${\n      input.storageEncrypted\n        ? `{\n      enabled: true,\n      passphraseRef: 'keyring:graphorin_db_passphrase',\n    }`\n        : `{ enabled: false }`\n    },\n  },\n  audit: {\n    enabled: ${input.storageEncrypted ? 'true' : 'false'},\n  },\n  secrets: {\n    source: 'auto',\n    strict: false,\n  },\n  observability: {\n    logger: 'json',\n  },\n  // IP-5: no top-level 'defaults' block - the strict server-config\n  // parser rejects unknown keys, so the old render made a fresh\n  // 'graphorin init' fail on the very next migrate/start. The tier you\n  // chose at init is recorded below; enforce it via the memory\n  // package (createMemory contextEngine privacy options):\n  // cloudUploadConsent: ${JSON.stringify(input.cloudConsent)}\n});\n`;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAoDA,eAAsB,QAAQ,UAA8B,EAAE,EAA8B;CAE1F,MAAM,SAAS,eADH,QAAQ,OAAO,QAAQ,KAAK,EACL,QAAQ,IAAI;CAC/C,MAAM,QAAQ,QAAQ,WAAW,SAAiB,QAAQ,OAAO,MAAM,GAAG,KAAK,IAAI;CAEnF,MAAM,eAAe,MAAM,oBAAoB,QAAQ;CACvD,MAAM,mBAAmB,MAAM,kBAAkB,QAAQ;CAGzD,MAAM,YAAY,MADH,gBAAgB,CACA,WAAW,QAAQ,IAAI,SAAS,MAAM,CAAC;CAEtE,MAAM,YAAY,iBAAiB,EAAE,KAAK,QAAQ,CAAC;AAEnD,KAAI,QAAQ,WAAW,MAAM;AAC3B,MAAI,MAAM,WAAW,OAAO,CAC1B,OAAM,IAAI,MACR,mDAAmD,OAAO,wCAC3D;AAEH,QAAM,MAAM,QAAQ,OAAO,EAAE,EAAE,WAAW,MAAM,CAAC;AACjD,QAAM,UAAU,QAAQ,aAAa;GAAE;GAAc;GAAkB,CAAC,EAAE,EAAE,MAAM,KAAO,CAAC;;AAG5F,OAAM,yBAAyB,SAAS;AACxC,OAAM,sDAAsD;AAC5D,OAAM,KAAK,UAAU,MAAM;AAC3B,OAAM,0FAA0F;AAChG,OAAM,KAAK,YAAY;AACvB,OAAM,GAAG;AACT,OAAM,cAAc;AACpB,OACE,kFAAkF,YACnF;AACD,OAAM,+DAA+D;AACrE,OAAM,yCAAyC,OAAO,iCAAiC;AACvF,OAAM,uCAAuC,OAAO,0BAA0B;AAE9E,QAAO,OAAO,OAAO;EACnB,YAAY;EACZ,gBAAgB,UAAU;EAC1B,iBAAiB;EACjB;EACA;EACD,CAAC;;AAGJ,SAAS,eAAe,KAAa,KAAiC;AACpE,KAAI,QAAQ,UAAa,IAAI,WAAW,EAAG,QAAO,QAAQ,KAAK,sBAAsB;AACrF,QAAO,WAAW,IAAI,GAAG,MAAM,QAAQ,KAAK,IAAI;;AAGlD,eAAe,WAAW,MAAgC;AACxD,KAAI;AACF,QAAM,KAAK,KAAK;AAChB,SAAO;SACD;AACN,SAAO;;;AAIX,eAAe,oBACb,SACsE;AACtE,KAAI,QAAQ,iBAAiB,OAAW,QAAO,QAAQ;CACvD,MAAM,WAAW,QAAQ,IAAI;AAC7B,KACE,aAAa,iBACb,aAAa,yBACb,aAAa,oBAEb,QAAO;AAET,KAAI,QAAQ,mBAAmB,KAAM,QAAO;AAM5C,QALe,MAAM,OACnB,uDACA;EAAC;EAAe;EAAuB;EAAoB,EAC3D,sBACD;;AAIH,eAAe,kBAAkB,SAA+C;AAC9E,KAAI,QAAQ,cAAc,OAAW,QAAO,QAAQ;AACpD,KAAI,QAAQ,IAAI,gCAAgC,IAAK,QAAO;AAC5D,KAAI,QAAQ,IAAI,gCAAgC,IAAK,QAAO;AAC5D,KAAI,QAAQ,mBAAmB,KAAM,QAAO;AAC5C,QAAO,MAAM,QAAQ,+DAA+D,MAAM;;AAG5F,SAAS,aAAa,OAGX;AACT,QAAO;;;;;;;;;;;;;;kBAeH,MAAM,mBACF;;;SAIA,qBACL;;;eAGU,MAAM,mBAAmB,SAAS,QAAQ;;;;;;;;;;;;;;2BAc9B,KAAK,UAAU,MAAM,aAAa,CAAC"}
+{"version":3,"file":"init.js","names":[],"sources":["../../src/commands/init.ts"],"sourcesContent":["/**\n * `graphorin init` - interactive bootstrap.\n *\n * Writes a fresh `graphorin.config.ts` to the current working\n * directory (or `--out`), prompts the operator for the cloud-upload\n * sensitivity tier + storage encryption opt-in, prints the server\n * pepper hex ONCE, and walks the operator through the working\n * credential path: persist the pepper (stdin, never argv), migrate,\n * then mint a real token with `graphorin token create`.\n *\n * W-003: init deliberately does NOT emit a token itself. Token\n * verification requires an HMAC lookup in the auth-token store, which\n * requires migrations + the pepper - init's contract is \"write the\n * config file, touch nothing else\" (pinned by tests), so any token it\n * printed was guaranteed to 401. Honestly pointing at `token create`\n * follows the IP-4 precedent (no phantom credentials).\n *\n * `--non-interactive` accepts every choice through flags or env vars\n * so the command works equally well in CI / image-build pipelines.\n *\n * @packageDocumentation\n */\n\nimport { mkdir, stat, writeFile } from 'node:fs/promises';\nimport { dirname, isAbsolute, resolve } from 'node:path';\nimport process from 'node:process';\n\nimport { generatePepper } from '@graphorin/security';\n\nimport { confirm, select } from '../internal/prompts.js';\n\n/**\n * @stable\n */\nexport interface InitCommandOptions {\n  readonly out?: string;\n  readonly nonInteractive?: boolean;\n  readonly cloudConsent?: 'public-only' | 'public-and-internal' | 'all-with-warnings';\n  readonly encrypted?: boolean;\n  readonly cwd?: string;\n  /** Test seam: skip writing files (only print the report). */\n  readonly dryRun?: boolean;\n  /** Test seam: redirect stdout/err. */\n  readonly print?: (line: string) => void;\n}\n\n/**\n * @stable\n */\nexport interface InitCommandResult {\n  readonly configPath: string;\n  readonly serverPepperHex: string;\n  readonly cloudConsent: 'public-only' | 'public-and-internal' | 'all-with-warnings';\n  readonly storageEncrypted: boolean;\n}\n\n/**\n * @stable\n */\nexport async function runInit(options: InitCommandOptions = {}): Promise<InitCommandResult> {\n  const cwd = options.cwd ?? process.cwd();\n  const target = resolveOutPath(cwd, options.out);\n  const print = options.print ?? ((line: string) => process.stderr.write(`${line}\\n`));\n\n  const cloudConsent = await resolveCloudConsent(options);\n  const storageEncrypted = await resolveEncryption(options);\n\n  const pepper = generatePepper();\n  const pepperHex = await pepper.useBuffer((buf) => buf.toString('hex'));\n\n  if (options.dryRun !== true) {\n    if (await fileExists(target)) {\n      throw new Error(\n        `[graphorin/cli] refusing to overwrite existing '${target}'. Move it aside or pass --out <path>.`,\n      );\n    }\n    await mkdir(dirname(target), { recursive: true });\n    await writeFile(target, renderConfig({ cloudConsent, storageEncrypted }), { mode: 0o600 });\n  }\n\n  print(`[graphorin/cli] wrote ${target}`);\n  print(`[graphorin/cli] server pepper hex (store in your keyring as 'graphorin_server_pepper'):`);\n  print(`  ${pepperHex}`);\n  print('');\n  print('Next steps:');\n  // W-041: never put the pepper on argv - shell history and the process\n  // list would hold the key material behind every token HMAC (the\n  // secrets CLI itself refuses plaintext on the command line).\n  print(\n    `  1. Persist the pepper WITHOUT argv: printf '%s' '<hex-from-above>' | graphorin secrets set graphorin_server_pepper --from-stdin`,\n  );\n  print(`  2. Run \\`graphorin migrate --config ${target}\\` to apply storage migrations.`);\n  print(\n    '  3. Mint your admin token: graphorin token create --label bootstrap --scopes <scopes> (the raw token is shown ONCE).',\n  );\n  print(`  4. Run \\`graphorin start --config ${target}\\` to launch the server.`);\n\n  return Object.freeze({\n    configPath: target,\n    serverPepperHex: pepperHex,\n    cloudConsent,\n    storageEncrypted,\n  });\n}\n\nfunction resolveOutPath(cwd: string, out: string | undefined): string {\n  if (out === undefined || out.length === 0) return resolve(cwd, 'graphorin.config.ts');\n  return isAbsolute(out) ? out : resolve(cwd, out);\n}\n\nasync function fileExists(path: string): Promise<boolean> {\n  try {\n    await stat(path);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nasync function resolveCloudConsent(\n  options: InitCommandOptions,\n): Promise<'public-only' | 'public-and-internal' | 'all-with-warnings'> {\n  if (options.cloudConsent !== undefined) return options.cloudConsent;\n  const envValue = process.env.GRAPHORIN_CLOUD_CONSENT;\n  if (\n    envValue === 'public-only' ||\n    envValue === 'public-and-internal' ||\n    envValue === 'all-with-warnings'\n  ) {\n    return envValue;\n  }\n  if (options.nonInteractive === true) return 'public-and-internal';\n  const choice = await select(\n    'Cloud-upload consent for context sent to providers:',\n    ['public-only', 'public-and-internal', 'all-with-warnings'],\n    'public-and-internal',\n  );\n  return choice as 'public-only' | 'public-and-internal' | 'all-with-warnings';\n}\n\nasync function resolveEncryption(options: InitCommandOptions): Promise<boolean> {\n  if (options.encrypted !== undefined) return options.encrypted;\n  if (process.env.GRAPHORIN_STORAGE_ENCRYPTED === '1') return true;\n  if (process.env.GRAPHORIN_STORAGE_ENCRYPTED === '0') return false;\n  if (options.nonInteractive === true) return false;\n  return await confirm('Enable storage encryption (defense-in-depth on top of FDE)?', false);\n}\n\nfunction renderConfig(input: {\n  readonly cloudConsent: 'public-only' | 'public-and-internal' | 'all-with-warnings';\n  readonly storageEncrypted: boolean;\n}): string {\n  return `import { defineConfig } from '@graphorin/server';\n\nexport default defineConfig({\n  server: {\n    host: '127.0.0.1',\n    port: 8080,\n  },\n  auth: {\n    kind: 'token',\n    pepperRef: 'keyring:graphorin_server_pepper',\n  },\n  storage: {\n    path: './.graphorin/data.db',\n    mode: 'server',\n    encryption: ${\n      input.storageEncrypted\n        ? `{\n      enabled: true,\n      passphraseRef: 'keyring:graphorin_db_passphrase',\n    }`\n        : `{ enabled: false }`\n    },\n  },\n  audit: {\n    enabled: ${input.storageEncrypted ? 'true' : 'false'},\n  },\n  secrets: {\n    source: 'auto',\n    strict: false,\n  },\n  observability: {\n    logger: 'json',\n  },\n  // IP-5: no top-level 'defaults' block - the strict server-config\n  // parser rejects unknown keys, so the old render made a fresh\n  // 'graphorin init' fail on the very next migrate/start. The tier you\n  // chose at init is recorded below; enforce it via the memory\n  // package (createMemory contextEngine privacy options):\n  // cloudUploadConsent: ${JSON.stringify(input.cloudConsent)}\n});\n`;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2DA,eAAsB,QAAQ,UAA8B,EAAE,EAA8B;CAE1F,MAAM,SAAS,eADH,QAAQ,OAAO,QAAQ,KAAK,EACL,QAAQ,IAAI;CAC/C,MAAM,QAAQ,QAAQ,WAAW,SAAiB,QAAQ,OAAO,MAAM,GAAG,KAAK,IAAI;CAEnF,MAAM,eAAe,MAAM,oBAAoB,QAAQ;CACvD,MAAM,mBAAmB,MAAM,kBAAkB,QAAQ;CAGzD,MAAM,YAAY,MADH,gBAAgB,CACA,WAAW,QAAQ,IAAI,SAAS,MAAM,CAAC;AAEtE,KAAI,QAAQ,WAAW,MAAM;AAC3B,MAAI,MAAM,WAAW,OAAO,CAC1B,OAAM,IAAI,MACR,mDAAmD,OAAO,wCAC3D;AAEH,QAAM,MAAM,QAAQ,OAAO,EAAE,EAAE,WAAW,MAAM,CAAC;AACjD,QAAM,UAAU,QAAQ,aAAa;GAAE;GAAc;GAAkB,CAAC,EAAE,EAAE,MAAM,KAAO,CAAC;;AAG5F,OAAM,yBAAyB,SAAS;AACxC,OAAM,0FAA0F;AAChG,OAAM,KAAK,YAAY;AACvB,OAAM,GAAG;AACT,OAAM,cAAc;AAIpB,OACE,oIACD;AACD,OAAM,yCAAyC,OAAO,iCAAiC;AACvF,OACE,wHACD;AACD,OAAM,uCAAuC,OAAO,0BAA0B;AAE9E,QAAO,OAAO,OAAO;EACnB,YAAY;EACZ,iBAAiB;EACjB;EACA;EACD,CAAC;;AAGJ,SAAS,eAAe,KAAa,KAAiC;AACpE,KAAI,QAAQ,UAAa,IAAI,WAAW,EAAG,QAAO,QAAQ,KAAK,sBAAsB;AACrF,QAAO,WAAW,IAAI,GAAG,MAAM,QAAQ,KAAK,IAAI;;AAGlD,eAAe,WAAW,MAAgC;AACxD,KAAI;AACF,QAAM,KAAK,KAAK;AAChB,SAAO;SACD;AACN,SAAO;;;AAIX,eAAe,oBACb,SACsE;AACtE,KAAI,QAAQ,iBAAiB,OAAW,QAAO,QAAQ;CACvD,MAAM,WAAW,QAAQ,IAAI;AAC7B,KACE,aAAa,iBACb,aAAa,yBACb,aAAa,oBAEb,QAAO;AAET,KAAI,QAAQ,mBAAmB,KAAM,QAAO;AAM5C,QALe,MAAM,OACnB,uDACA;EAAC;EAAe;EAAuB;EAAoB,EAC3D,sBACD;;AAIH,eAAe,kBAAkB,SAA+C;AAC9E,KAAI,QAAQ,cAAc,OAAW,QAAO,QAAQ;AACpD,KAAI,QAAQ,IAAI,gCAAgC,IAAK,QAAO;AAC5D,KAAI,QAAQ,IAAI,gCAAgC,IAAK,QAAO;AAC5D,KAAI,QAAQ,mBAAmB,KAAM,QAAO;AAC5C,QAAO,MAAM,QAAQ,+DAA+D,MAAM;;AAG5F,SAAS,aAAa,OAGX;AACT,QAAO;;;;;;;;;;;;;;kBAeH,MAAM,mBACF;;;SAIA,qBACL;;;eAGU,MAAM,mBAAmB,SAAS,QAAQ;;;;;;;;;;;;;;2BAc9B,KAAK,UAAU,MAAM,aAAa,CAAC"}

package/dist/commands/memory.d.ts

@@ -238,6 +238,31 @@ interface MemoryReviewOptions extends MemoryCommonOptions {
  * @stable
  */
 declare function runMemoryReview(options?: MemoryReviewOptions): Promise<MemoryReviewResult>;
+/** @stable */
+interface MemoryPruneHistoryOptions extends MemoryCommonOptions {
+  /**
+   * Age threshold: a duration (`'30d'`, `'12h'`, `'45m'`, `'30s'`) or
+   * an ISO date / `YYYY-MM-DD` strictly in the past. Mandatory - the
+   * command is destructive by design and must never default.
+   */
+  readonly olderThan: string;
+}
+/** @stable */
+interface MemoryPruneHistoryResult {
+  readonly deleted: number;
+  /** The resolved AGE in milliseconds passed to `pruneHistory`. */
+  readonly olderThanMs: number;
+}
+/**
+ * `graphorin memory prune-history --older-than <duration|date>` (W-066)
+ * - the supported surface over `MemoryStoreExt.pruneHistory`.
+ * `memory_history` grows by design (every supersede / quarantine
+ * transition appends) and `purge()` already scrubs sensitive text;
+ * this is the storage-cost hygiene lever.
+ *
+ * @stable
+ */
+declare function runMemoryPruneHistory(options: MemoryPruneHistoryOptions): Promise<MemoryPruneHistoryResult>;
 //#endregion
-export { MemoryActivityConflict, MemoryActivityEvent, MemoryActivityOptions, MemoryActivityResult, MemoryCitingInsight, MemoryCommonOptions, MemoryConflictEntry, MemoryHistoryEntry, MemoryInspectEntity, MemoryInspectFact, MemoryInspectOptions, MemoryInspectResult, MemoryMigrateOptions, MemoryReviewItem, MemoryReviewOptions, MemoryReviewResult, MemoryStatusEmbedder, MemoryStatusResult, MemoryWhyOptions, MemoryWhyRecall, MemoryWhyResult, runMemoryActivity, runMemoryInspect, runMemoryMigrate, runMemoryReview, runMemoryStatus, runMemoryWhy };
+export { MemoryActivityConflict, MemoryActivityEvent, MemoryActivityOptions, MemoryActivityResult, MemoryCitingInsight, MemoryCommonOptions, MemoryConflictEntry, MemoryHistoryEntry, MemoryInspectEntity, MemoryInspectFact, MemoryInspectOptions, MemoryInspectResult, MemoryMigrateOptions, MemoryPruneHistoryOptions, MemoryPruneHistoryResult, MemoryReviewItem, MemoryReviewOptions, MemoryReviewResult, MemoryStatusEmbedder, MemoryStatusResult, MemoryWhyOptions, MemoryWhyRecall, MemoryWhyResult, runMemoryActivity, runMemoryInspect, runMemoryMigrate, runMemoryPruneHistory, runMemoryReview, runMemoryStatus, runMemoryWhy };
 //# sourceMappingURL=memory.d.ts.map

package/dist/commands/memory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory.d.ts","names":[],"sources":["../../src/commands/memory.ts"],"sourcesContent":[],"mappings":";;;;;AAyPgC,UAxNf,mBAAA,SAA4B,mBAwNb,CAAA;EAAd,SAAA,MAAA,CAAA,EAAA,MAAA;;;AAEkB,UArNnB,oBAAA,CAqNmB;EAAd,SAAA,EAAA,EAAA,MAAA;EACmB,SAAA,KAAA,EAAA,MAAA;EAAd,SAAA,GAAA,EAAA,MAAA;EAEc,SAAA,cAAA,EAAA,MAAA;EAAd,SAAA,OAAA,EAAA,OAAA;EAAa,SAAA,SAAA,EAAA,MAAA;EAIvB,SAAA,SAAA,CAAA,EAAA,MAAqB;AAatC;;AAEW,UAhOM,kBAAA,CAgON;EAAR,SAAA,WAAA,EAAA,MAAA;EAAO,SAAA,SAAA,EA9NY,aA8NZ,CA9N0B,oBA8N1B,CAAA;EAwJO,SAAA,MAAA,EAAA;IASA,SAAA,KAAA,EAAA,MAAsB;IAStB,SAAA,QAAA,EAAoB,MAAA;IAMG,SAAA,eAAA,EAAA,MAAA;IAAd,SAAA,UAAA,EAAA,MAAA;EACgB,CAAA;;;AAIzB,iBAzYK,eAAA,CAyYyB,OAAmB,CAAnB,EAxYpC,mBAwYuD,CAAA,EAvY/D,OAuY+D,CAvYvD,kBAuYuD,CAAA;AAclE;AACW,UAtWM,oBAAA,SAA6B,mBAsWnC,CAAA;EACA,SAAA,IAAA,EAAA,MAAA;EAAR,SAAA,EAAA,EAAA,MAAA;EAAO,SAAA,QAAA,EAAA,eAAA,GAAA,cAAA,GAAA,cAAA;EAiGO;;;;;AAajB;AAKA;EAqBsB,SAAA,eAAY,CAAA,EAAA,MAAA;;;;;AAyElC;AAOA;;;;AAIqB,iBA7iBC,gBAAA,CA6iBD,OAAA,EA7iB2B,oBA6iB3B,CAAA,EA7iBkD,OA6iBlD,CAAA,KAAA,CAAA;;AACA,UAnfJ,iBAAA,CAmfI;EACgB,SAAA,EAAA,EAAA,MAAA;EAAd,SAAA,IAAA,EAAA,MAAA;EAAa,SAAA,MAAA,EAAA,MAAA;EAInB,SAAA,UAAA,EAAA,MAAoB,GAAA,IAAQ;EA2BvB;EACX,SAAA,UAAA,EAAA,MAAA,GAAA,IAAA;EACA,SAAA,SAAA,EAAA,MAAA,GAAA,IAAA;EAAR,SAAA,OAAA,EAAA,MAAA,GAAA,IAAA;EAAO,SAAA,UAAA,EAAA,MAAA,GAAA,IAAA;;;;;;;;;;UAjgBO,mBAAA;;;;;;;;UASA,kBAAA;;;;;;UAOA,mBAAA;;;;;;;;;UAUA,mBAAA;;;;;;;UAQA,mBAAA;;iBAEA;kBACC,cAAc;oBACZ,cAAc;sBACZ,cAAc;2BACT,cAAc;;2BAEd,cAAc;;;UAIxB,oBAAA,SAA6B;;;;;;;;;;;;iBAaxB,gBAAA,UACX,uBACR,QAAQ;;UAwJM,mBAAA;;;;;;;;UASA,sBAAA;;;;;;;;UASA,oBAAA;;;;;;0BAMS,cAAc;4BACZ,cAAc;;;UAIzB,qBAAA,SAA8B;;;;;;;;;;;;;iBAczB,iBAAA,WACX,wBACR,QAAQ;;UAiGM,eAAA;;;;oBAIG;;;;sBAIE,SAAS;;;;UAKd,eAAA;oBACG,cAAc;;;UAIjB,gBAAA,SAAyB;;;;;;;;;;;;;;iBAqBpB,YAAA,UAAsB,mBAAmB,QAAQ;;UAyEtD,gBAAA;;;;;;UAOA,kBAAA;;;;;;kBAGC,cAAc;qBACX,cAAc;qBACd,cAAc;uBACZ,cAAc;;;UAIpB,mBAAA,SAA4B;;;;;;;;;;;;;;;;;;;iBA2BvB,eAAA,WACX,sBACR,QAAQ"}
+{"version":3,"file":"memory.d.ts","names":[],"sources":["../../src/commands/memory.ts"],"sourcesContent":[],"mappings":";;;;;AAyPgC,UAxNf,mBAAA,SAA4B,mBAwNb,CAAA;EAAd,SAAA,MAAA,CAAA,EAAA,MAAA;;;AAEkB,UArNnB,oBAAA,CAqNmB;EAAd,SAAA,EAAA,EAAA,MAAA;EACmB,SAAA,KAAA,EAAA,MAAA;EAAd,SAAA,GAAA,EAAA,MAAA;EAEc,SAAA,cAAA,EAAA,MAAA;EAAd,SAAA,OAAA,EAAA,OAAA;EAAa,SAAA,SAAA,EAAA,MAAA;EAIvB,SAAA,SAAA,CAAA,EAAA,MAAqB;AAatC;;AAEW,UAhOM,kBAAA,CAgON;EAAR,SAAA,WAAA,EAAA,MAAA;EAAO,SAAA,SAAA,EA9NY,aA8NZ,CA9N0B,oBA8N1B,CAAA;EA0JO,SAAA,MAAA,EAAA;IASA,SAAA,KAAA,EAAA,MAAsB;IAStB,SAAA,QAAA,EAAoB,MAAA;IAMG,SAAA,eAAA,EAAA,MAAA;IAAd,SAAA,UAAA,EAAA,MAAA;EACgB,CAAA;;;AAIzB,iBA3YK,eAAA,CA2YyB,OAAmB,CAAnB,EA1YpC,mBA0YuD,CAAA,EAzY/D,OAyY+D,CAzYvD,kBAyYuD,CAAA;AAclE;AACW,UAxWM,oBAAA,SAA6B,mBAwWnC,CAAA;EACA,SAAA,IAAA,EAAA,MAAA;EAAR,SAAA,EAAA,EAAA,MAAA;EAAO,SAAA,QAAA,EAAA,eAAA,GAAA,cAAA,GAAA,cAAA;EAmGO;;;;;AAajB;AAKA;EAqBsB,SAAA,eAAY,CAAA,EAAA,MAAA;;;;;AAyElC;AAOA;;;;AAIqB,iBAjjBC,gBAAA,CAijBD,OAAA,EAjjB2B,oBAijB3B,CAAA,EAjjBkD,OAijBlD,CAAA,KAAA,CAAA;;AACA,UAvfJ,iBAAA,CAufI;EACgB,SAAA,EAAA,EAAA,MAAA;EAAd,SAAA,IAAA,EAAA,MAAA;EAAa,SAAA,MAAA,EAAA,MAAA;EAInB,SAAA,UAAA,EAAA,MAAoB,GAAA,IAAQ;EA2BvB;EACX,SAAA,UAAA,EAAA,MAAA,GAAA,IAAA;EACA,SAAA,SAAA,EAAA,MAAA,GAAA,IAAA;EAAR,SAAA,OAAA,EAAA,MAAA,GAAA,IAAA;EAAO,SAAA,UAAA,EAAA,MAAA,GAAA,IAAA;EA+OO,SAAA,YAAA,EAAA,MAA0B,GAAA,IAAA;EAU1B,SAAA,SAAA,EAAA,MAAA;AAejB;;;;;;;UA7wBiB,mBAAA;;;;;;;;UASA,kBAAA;;;;;;UAOA,mBAAA;;;;;;;;;UAUA,mBAAA;;;;;;;UAQA,mBAAA;;iBAEA;kBACC,cAAc;oBACZ,cAAc;sBACZ,cAAc;2BACT,cAAc;;2BAEd,cAAc;;;UAIxB,oBAAA,SAA6B;;;;;;;;;;;;iBAaxB,gBAAA,UACX,uBACR,QAAQ;;UA0JM,mBAAA;;;;;;;;UASA,sBAAA;;;;;;;;UASA,oBAAA;;;;;;0BAMS,cAAc;4BACZ,cAAc;;;UAIzB,qBAAA,SAA8B;;;;;;;;;;;;;iBAczB,iBAAA,WACX,wBACR,QAAQ;;UAmGM,eAAA;;;;oBAIG;;;;sBAIE,SAAS;;;;UAKd,eAAA;oBACG,cAAc;;;UAIjB,gBAAA,SAAyB;;;;;;;;;;;;;;iBAqBpB,YAAA,UAAsB,mBAAmB,QAAQ;;UAyEtD,gBAAA;;;;;;UAOA,kBAAA;;;;;;kBAGC,cAAc;qBACX,cAAc;qBACd,cAAc;uBACZ,cAAc;;;UAIpB,mBAAA,SAA4B;;;;;;;;;;;;;;;;;;;iBA2BvB,eAAA,WACX,sBACR,QAAQ;;UA+OM,yBAAA,SAAkC;;;;;;;;;UAUlC,wBAAA;;;;;;;;;;;;;;iBAeK,qBAAA,UACX,4BACR,QAAQ"}

package/dist/commands/memory.js

@@ -87,7 +87,10 @@ const FACT_INSPECT_COLUMNS = "id, text, status, provenance, importance, valid_fr
 * @stable
 */
 async function runMemoryInspect(options) {
-	const ctx = await openStoreContext({ ...options.config !== void 0 ? { config: options.config } : {} });
+	const ctx = await openStoreContext({
+		migrationPolicy: "check",
+		...options.config !== void 0 ? { config: options.config } : {}
+	});
 	try {
 		const conn = ctx.store.connection;
 		const factRow = conn.get(`SELECT ${FACT_INSPECT_COLUMNS} FROM facts WHERE id = ?`, [options.factId]);
@@ -182,7 +185,10 @@ async function runMemoryInspect(options) {
 */
 async function runMemoryActivity(options = {}) {
 	const limit = Math.max(1, options.limit ?? 20);
-	const ctx = await openStoreContext({ ...options.config !== void 0 ? { config: options.config } : {} });
+	const ctx = await openStoreContext({
+		migrationPolicy: "check",
+		...options.config !== void 0 ? { config: options.config } : {}
+	});
 	try {
 		const conn = ctx.store.connection;
 		const quarantine = Object.freeze({
@@ -465,7 +471,54 @@ function countTable(conn, table) {
 		return 0;
 	}
 }
+/**
+* `graphorin memory prune-history --older-than <duration|date>` (W-066)
+* - the supported surface over `MemoryStoreExt.pruneHistory`.
+* `memory_history` grows by design (every supersede / quarantine
+* transition appends) and `purge()` already scrubs sensitive text;
+* this is the storage-cost hygiene lever.
+*
+* @stable
+*/
+async function runMemoryPruneHistory(options) {
+	const olderThanMs = resolveOlderThanMs(options.olderThan);
+	const ctx = await openStoreContext({ ...options.config !== void 0 ? { config: options.config } : {} });
+	try {
+		const deleted = await ctx.store.memory.pruneHistory(olderThanMs);
+		const out = Object.freeze({
+			deleted,
+			olderThanMs
+		});
+		emitReport(options, out, () => {
+			(options.print ?? defaultPrintSink)(brand(`pruned ${deleted} memory_history row(s) older than ${options.olderThan} (age ${olderThanMs} ms).`));
+		});
+		return out;
+	} finally {
+		await ctx.close();
+	}
+}
+/** Resolve `--older-than` into an AGE in ms; fail fast on nonsense. */
+function resolveOlderThanMs(input) {
+	const raw = input.trim();
+	const duration = /^(\d+)\s*([smhd])$/i.exec(raw);
+	if (duration !== null) {
+		const value = Number.parseInt(duration[1], 10);
+		switch (duration[2].toLowerCase()) {
+			case "s": return value * 1e3;
+			case "m": return value * 6e4;
+			case "h": return value * 36e5;
+			default: return value * 864e5;
+		}
+	}
+	const date = new Date(raw);
+	if (!Number.isNaN(date.getTime())) {
+		const age = Date.now() - date.getTime();
+		if (age <= 0) throw new Error(`[graphorin/cli] --older-than '${input}' is not in the past - refusing (a future date would prune the entire history).`);
+		return age;
+	}
+	throw new Error(`[graphorin/cli] invalid --older-than '${input}'. Use '<number><s|m|h|d>' (e.g. 30d) or a past ISO date.`);
+}
 
 //#endregion
-export { runMemoryActivity, runMemoryInspect, runMemoryMigrate, runMemoryReview, runMemoryStatus, runMemoryWhy };
+export { runMemoryActivity, runMemoryInspect, runMemoryMigrate, runMemoryPruneHistory, runMemoryReview, runMemoryStatus, runMemoryWhy };
 //# sourceMappingURL=memory.js.map