@remnic/core 9.18.0 → 9.20.0

package/src/meetings/build.ts

@@ -0,0 +1,365 @@
+/**
+ * Meeting building orchestration (issue #1900, Phase 4 slice 2).
+ *
+ * Ties the pure pieces together: detect the day's meetings, fuse each window's
+ * transcript + screen context, and compose idempotent records. Day data is
+ * supplied through an injected source so fixtures (and the later activity/
+ * wearables wiring) share one code path — no hidden IO here.
+ *
+ * Gated on `meetings.enabled`: a disabled subsystem builds nothing on every
+ * surface (degradation-matrix row). Degrades within an enabled build too — a
+ * window with no audio yields an empty transcript, and no activity yields a
+ * record with no screen-context section — because `fuseMeeting` handles both.
+ */
+
+import { detectMeetings } from "./detect.js";
+import { fuseMeeting, type MeetingFusionOptions } from "./fuse.js";
+import { composeMeetingRecord, type MeetingRecordStore, type MeetingRecordSummary } from "./store.js";
+import { log } from "../logger.js";
+import type {
+  MeetingEpisodeGenResult,
+  MeetingMemoryGenerator,
+  MeetingMemoryOutcome,
+  MeetingsDayFactGenResult,
+} from "./memory-generator.js";
+import type { FusionConversationInput } from "../wearables/fusion/types.js";
+import type {
+  DetectedMeeting,
+  MeetingActivitySnapshot,
+  MeetingRecord,
+  MeetingsConfig,
+  MeetingsDetectionInput,
+} from "./types.js";
+
+/** All of a day's already-loaded signals a build needs. */
+export interface MeetingDayData {
+  /** App spans + audio windows for the day (fed to the detector). */
+  detection: MeetingsDetectionInput;
+  /** Fusion conversation inputs across all wearable sources for the day. */
+  conversations: FusionConversationInput[];
+  /** Screen-activity snapshots for the day. */
+  activity?: MeetingActivitySnapshot[];
+}
+
+/** Supplies a day's signals. Backed by fixtures in tests; by the activity +
+ *  wearables stores in the wiring slice. */
+export interface MeetingsDaySource {
+  loadDayData(date: string): Promise<MeetingDayData> | MeetingDayData;
+}
+
+export function buildMeetingRecordsForDay(
+  data: MeetingDayData,
+  config: MeetingsConfig,
+  options: MeetingFusionOptions = {},
+  /** Map a detected meeting to the id its record should carry. Defaults to the
+   *  detector's start-anchored id; the builder overrides this to preserve an
+   *  existing overlapping record's id across shifted-start resyncs. */
+  resolveMeetingId: (meeting: DetectedMeeting) => string = (meeting) => meeting.id,
+): MeetingRecord[] {
+  const meetings = detectMeetings(data.detection, {
+    appPatterns: config.appPatterns,
+    minOverlapMinutes: config.minOverlapMinutes,
+    audioOnlyMinMinutes: config.audioOnlyMinMinutes,
+    mergeGapMinutes: config.mergeGapMinutes,
+  });
+  return meetings.map((meeting) => {
+    const fused = fuseMeeting(
+      { meeting, conversations: data.conversations, ...(data.activity !== undefined ? { activity: data.activity } : {}) },
+      config,
+      options,
+    );
+    return composeMeetingRecord(
+      {
+        id: resolveMeetingId(meeting),
+        date: meeting.date,
+        startUtc: meeting.startUtc,
+        endUtc: meeting.endUtc,
+        ...(meeting.app !== undefined ? { app: meeting.app } : {}),
+        detectionSource: meeting.detectionSource,
+        ...(meeting.title !== undefined ? { title: meeting.title } : {}),
+      },
+      fused,
+    );
+  });
+}
+
+/** Per-meeting outcome of a day build. */
+export interface MeetingBuildOutcome {
+  id: string;
+  startUtc: string;
+  endUtc: string;
+  detectionSource: string;
+  sources: string[];
+  attendees: string[];
+  snapshotCount: number;
+  /** False when the record's contentHash was unchanged (nothing rewritten). */
+  written: boolean;
+}
+
+/** Result of building one day's meetings. */
+export interface MeetingsDayBuildSummary {
+  date: string;
+  /** False when `meetings.enabled` is off (zero behavior). */
+  enabled: boolean;
+  meetings: MeetingBuildOutcome[];
+  /** Records written (new or changed). */
+  built: number;
+  /** Records skipped (unchanged contentHash). */
+  skipped: number;
+  /** Ids of stale same-day records deleted because they no longer detect. */
+  removed: string[];
+  /**
+   * Set when the optional reindex hook rejected AFTER records were already
+   * persisted. The store mutation still succeeded — the build is reported as
+   * successful with this generic warning, and the next scheduled index catches
+   * up. Deliberately does NOT embed the raw error text: this string is printed
+   * to the CLI's stdout, and internal error detail is logged separately.
+   */
+  reindexWarning?: string;
+  /**
+   * Set when the injected `memoryGenerator` rejected AFTER records were already
+   * persisted, OR when a successful generation returned non-fatal warnings. Like
+   * `reindexWarning`, the record writes still succeeded, so the build is reported
+   * successful with this warning; on rejection the next build (or scheduled
+   * maintenance) regenerates the missing memories. Carries no raw exception text —
+   * only the generic rejection message or the generator's own warning strings.
+   */
+  memoryWarning?: string;
+  /**
+   * Deterministic episode-memory counts, present only when a `memoryGenerator`
+   * was injected. One recall-anchor episode is written per built record (idempotent).
+   */
+  episodes?: MeetingEpisodeGenResult;
+  /**
+   * Trust-gated summary/fact counts (decisions, commitments, questions, and the
+   * synthesized summary), present only when a `memoryGenerator` with summary deps
+   * ran and `summaryMode !== "off"`. Aggregated across the day's records.
+   */
+  facts?: MeetingsDayFactGenResult;
+}
+
+/** Optional side effects the builder fires after a day build. */
+export interface MeetingsBuilderHooks {
+  /**
+   * Invoked once per build when records changed (`built > 0 || removed > 0`).
+   * Meeting records live inside the QMD collection root for full-text search,
+   * so a host that wants them discoverable immediately (rather than at the next
+   * scheduled reindex) supplies a reindex here. No-op when omitted — records are
+   * still picked up by the next index update.
+   */
+  reindex?(summary: MeetingsDayBuildSummary): void | Promise<void>;
+}
+
+/** Orchestrates a store-backed build of a day's meetings. */
+export class MeetingsBuilder {
+  constructor(
+    private readonly opts: {
+      source: MeetingsDaySource;
+      store: MeetingRecordStore;
+      config: MeetingsConfig;
+      fusionOptions?: MeetingFusionOptions;
+      hooks?: MeetingsBuilderHooks;
+      /**
+       * When present, the memory-generation layer runs after the record-store
+       * writes: deterministic recall-anchor episodes per built record, the
+       * trust-gated summary/facts layer, and retract-on-removal — all behind the
+       * `MeetingMemoryGenerator` seam (issue #1900). Omitted → pure
+       * detect+fuse+store with no memory writes. The engine depends only on this
+       * interface, never on the memory-gen module.
+       */
+      memoryGenerator?: MeetingMemoryGenerator;
+    },
+  ) {}
+
+  async buildDay(date: string): Promise<MeetingsDayBuildSummary> {
+    if (!this.opts.config.enabled) {
+      return { date, enabled: false, meetings: [], built: 0, skipped: 0, removed: [] };
+    }
+    const data = await this.opts.source.loadDayData(date);
+    // The source contract is loadDayData(date) → THAT day's signals. If the
+    // returned detection day disagrees, records would be written under
+    // data.detection.date while listing/adoption/reconciliation run on `date`,
+    // orphaning records and mis-keying the summary — reject the desync loudly.
+    if (data.detection.date !== date) {
+      throw new RangeError(
+        `meetings: day source returned detection.date "${data.detection.date}" for requested day "${date}".`,
+      );
+    }
+    // Existing records for the day, so an overlapping shifted-start resync keeps
+    // its original id instead of being deleted + re-created under a new one.
+    const existing = await this.opts.store.listMeetingSummaries(date);
+    const claimed = new Set<string>();
+    const resolveMeetingId = (meeting: DetectedMeeting): string =>
+      this.adoptExistingId(meeting, existing, claimed);
+    const records = buildMeetingRecordsForDay(
+      data,
+      this.opts.config,
+      this.opts.fusionOptions ?? {},
+      resolveMeetingId,
+    );
+    const meetings: MeetingBuildOutcome[] = [];
+    let built = 0;
+    let skipped = 0;
+    const builtIds = new Set<string>();
+    // Ids that existed before THIS build, so a same-id rewrite (contentHash
+    // changed) is distinguished from a brand-new record and from an untouched one.
+    const priorIds = new Set(existing.map((summary) => summary.id));
+    // Built ids whose stored record was IDENTICAL this build (nothing rewritten):
+    // the generator must skip them so an idempotent rebuild triggers no LLM calls
+    // and no duplicate memories.
+    const unchangedIds: string[] = [];
+    // Built ids that already existed and were rewritten this build (same id, new
+    // contentHash): the generator must refresh (retract + regenerate) their stale
+    // episode/summary memories.
+    const updatedIds: string[] = [];
+    for (const record of records) {
+      const save = await this.opts.store.saveMeetingRecord(record);
+      if (save.written) {
+        built++;
+        if (priorIds.has(record.id)) updatedIds.push(record.id);
+      } else {
+        skipped++;
+        unchangedIds.push(record.id);
+      }
+      builtIds.add(record.id);
+      meetings.push({
+        id: record.id,
+        startUtc: record.startUtc,
+        endUtc: record.endUtc,
+        detectionSource: record.detectionSource,
+        sources: record.sources,
+        attendees: record.attendees,
+        snapshotCount: record.snapshotCount,
+        written: save.written,
+      });
+    }
+    // Reconcile genuinely stale records: a prior build's meeting the current
+    // rebuild neither reproduced nor adopted (by overlap) is deleted so it does
+    // not linger and orphan its provenance. Delete only within THIS day's dir.
+    const removed: string[] = [];
+    for (const existingId of await this.opts.store.listMeetingIds(date)) {
+      if (builtIds.has(existingId)) continue;
+      await this.opts.store.deleteMeetingRecord(date, existingId);
+      removed.push(existingId);
+    }
+    const summary: MeetingsDayBuildSummary = { date, enabled: true, meetings, built, skipped, removed };
+    // Memory generation runs behind the seam: the deterministic engine hands the
+    // built records, removed ids, and the unchanged/updated id sets to the
+    // injected generator and folds the returned counts + reindex signal into the
+    // summary. The engine never imports the memory-gen module.
+    //
+    // The record writes above already succeeded; a generator rejection must NOT
+    // fail the whole build and lose those persisted records. Isolate it exactly
+    // like the reindex hook: surface a generic warning, log the detail, and let
+    // the next build regenerate the missing memories.
+    let outcome: MeetingMemoryOutcome | undefined;
+    if (this.opts.memoryGenerator !== undefined) {
+      try {
+        outcome = await this.opts.memoryGenerator.onRecordsBuilt({
+          built: records,
+          removedIds: removed,
+          unchangedIds,
+          updatedIds,
+        });
+      } catch (err) {
+        log.error("meetings: memory generation failed after records were persisted", err);
+        summary.memoryWarning = "memory generation failed after records were persisted; see logs for detail";
+      }
+    }
+    if (outcome?.episodes !== undefined) summary.episodes = outcome.episodes;
+    if (outcome?.facts !== undefined) summary.facts = outcome.facts;
+    // A SUCCESSFUL generation can still raise non-fatal warnings (e.g. a summary
+    // dep degraded). The fatal catch above leaves `outcome` undefined, so these
+    // paths are mutually exclusive: fold the generator's own warning strings into
+    // the same `memoryWarning` the CLI/JSON already surfaces so a green build does
+    // not silently hide them. These are generator-authored strings, not raw error
+    // text, so surfacing them is safe.
+    if (outcome?.warnings !== undefined && outcome.warnings.length > 0) {
+      summary.memoryWarning = outcome.warnings.join("; ");
+    }
+    // Meeting records AND their episode/summary memories live inside the QMD
+    // collection root. Fire the isolated reindex whenever anything discoverable
+    // changed — records written/removed (engine) OR newly written episodes/facts
+    // (folded into outcome.reindexNeeded). A rebuild whose records were unchanged
+    // (built == 0 && removed == 0) but whose prior episode write had failed still
+    // creates active memories that must be indexed now, not left dark until the
+    // next scheduled maintenance pass.
+    if (built > 0 || removed.length > 0 || (outcome?.reindexNeeded ?? false)) {
+      // The store mutation already succeeded; a reindex-hook rejection must not
+      // fail the whole build. Log the detail and surface a GENERIC warning — the
+      // raw error must not leak to the CLI's stdout — then let the next scheduled
+      // index update catch up.
+      try {
+        await this.opts.hooks?.reindex?.(summary);
+      } catch (err) {
+        log.error("meetings: reindex hook failed after records were persisted", err);
+        summary.reindexWarning = "reindex hook failed after records were persisted; see logs for detail";
+      }
+    }
+    return summary;
+  }
+
+  /**
+   * Pick the existing same-day record whose window best overlaps `meeting` and
+   * reuse its id — but ONLY when adoption is safe: the windows substantially
+   * coincide (overlap covers a majority of the shorter window), OR a corroborating
+   * identity signal (same app, same title, or a shared transcript source) is
+   * BACKED by a non-marginal overlap (>= a quarter of the shorter window). Coarse
+   * identity signals alone never license adoption across a thin sliver of overlap,
+   * or two genuinely different back-to-back same-app meetings would overwrite each
+   * other's record and `show <old-id>` would point at the wrong meeting. Candidate
+   * selection is deterministic (max overlap, then earliest start, then id).
+   * Returns the detector's fresh id when nothing qualifies.
+   */
+  private adoptExistingId(
+    meeting: DetectedMeeting,
+    existing: readonly MeetingRecordSummary[],
+    claimed: Set<string>,
+  ): string {
+    const dStart = Date.parse(meeting.startUtc);
+    const dEnd = Date.parse(meeting.endUtc);
+    if (!Number.isFinite(dStart) || !Number.isFinite(dEnd)) return meeting.id;
+    let best: { record: MeetingRecordSummary; overlap: number; existingDurationMs: number } | undefined;
+    for (const record of existing) {
+      if (claimed.has(record.id)) continue;
+      const eStart = Date.parse(record.startUtc);
+      const eEnd = Date.parse(record.endUtc);
+      if (!Number.isFinite(eStart) || !Number.isFinite(eEnd)) continue;
+      const overlap = Math.min(dEnd, eEnd) - Math.max(dStart, eStart);
+      if (overlap <= 0) continue;
+      const better =
+        best === undefined ||
+        overlap > best.overlap ||
+        (overlap === best.overlap &&
+          (record.startUtc < best.record.startUtc ||
+            (record.startUtc === best.record.startUtc && record.id < best.record.id)));
+      if (better) best = { record, overlap, existingDurationMs: eEnd - eStart };
+    }
+    if (best === undefined) return meeting.id;
+    // Adoption bar (issue #1900): substantial overlap OR a corroborating identity
+    // signal that is BACKED by a non-marginal overlap — otherwise treat as
+    // removed + new. App name and transcript-source label are COARSE (many
+    // distinct meetings carry "Zoom"/"desktop"), so an identity match on its own
+    // must not license adoption across a thin sliver of overlap, or two genuinely
+    // different back-to-back same-app meetings would clobber each other's record.
+    const shorterWindowMs = Math.min(dEnd - dStart, best.existingDurationMs);
+    if (shorterWindowMs <= 0) return meeting.id;
+    // A shifted-start resync of the SAME meeting: overlap covers a majority of the
+    // shorter window. Adopts on its own.
+    const substantial = best.overlap * 2 >= shorterWindowMs;
+    const sharedSource = meeting.sources.some((source) => best!.record.sources.includes(source));
+    const sameApp =
+      meeting.app !== undefined &&
+      best.record.app !== undefined &&
+      meeting.app.toLowerCase() === best.record.app.toLowerCase();
+    const meetingTitle = meeting.title?.trim() ?? "";
+    const sameTitle = meetingTitle.length > 0 && meetingTitle === (best.record.title?.trim() ?? "");
+    const hasIdentitySignal = sharedSource || sameApp || sameTitle;
+    // Non-marginal overlap gate: an identity signal only corroborates when the
+    // windows overlap by at least a quarter of the shorter window.
+    const nonMarginalOverlap = best.overlap * 4 >= shorterWindowMs;
+    if (!substantial && !(hasIdentitySignal && nonMarginalOverlap)) return meeting.id;
+    claimed.add(best.record.id);
+    return best.record.id;
+  }
+}

package/src/meetings/cli.test.ts

@@ -0,0 +1,276 @@
+import assert from "node:assert/strict";
+import { test } from "node:test";
+
+import { MeetingsBuilder, type MeetingDayData, type MeetingsDaySource } from "./build.js";
+import { runMeetingsCliCommand, type MeetingsCliDeps } from "./cli.js";
+import { DEFAULT_MEETINGS_CONFIG } from "./config.js";
+import { MeetingRecordStore, type MeetingRecordFileIo } from "./store.js";
+import type { MeetingsConfig } from "./types.js";
+
+const MEMORY_DIR = "/mem";
+const DATE = "2026-03-10";
+const START = "2026-03-10T14:00:00.000Z";
+const END = "2026-03-10T15:00:00.000Z";
+
+class InMemoryIo implements MeetingRecordFileIo {
+  files = new Map<string, string>();
+  async writeFile(p: string, c: string): Promise<void> {
+    this.files.set(p, c);
+  }
+  async readFile(p: string): Promise<string> {
+    const v = this.files.get(p);
+    if (v === undefined) throw enoent();
+    return v;
+  }
+  async readDir(dirPath: string): Promise<string[]> {
+    const prefix = dirPath.endsWith("/") ? dirPath : `${dirPath}/`;
+    const names = new Set<string>();
+    let found = false;
+    for (const key of this.files.keys()) {
+      if (!key.startsWith(prefix)) continue;
+      found = true;
+      names.add(key.slice(prefix.length).split("/")[0]!);
+    }
+    if (!found) throw enoent();
+    return [...names];
+  }
+  async deleteFile(p: string): Promise<void> {
+    if (!this.files.delete(p)) throw enoent();
+  }
+  async realpath(p: string): Promise<string> {
+    return p;
+  }
+  async lstat(): Promise<{ isSymbolicLink: boolean }> {
+    return { isSymbolicLink: false };
+  }
+}
+
+function enoent(): NodeJS.ErrnoException {
+  const err = new Error("ENOENT") as NodeJS.ErrnoException;
+  err.code = "ENOENT";
+  return err;
+}
+
+function config(overrides: Partial<MeetingsConfig> = {}): MeetingsConfig {
+  return { ...DEFAULT_MEETINGS_CONFIG, appPatterns: [...DEFAULT_MEETINGS_CONFIG.appPatterns], enabled: true, ...overrides };
+}
+
+function dayData(): MeetingDayData {
+  return {
+    detection: { date: DATE, appSpans: [{ app: "Zoom", startUtc: START, endUtc: END }], audioWindows: [{ source: "desktop", startUtc: START, endUtc: END, distinctNonWearerSpeakers: 2 }] },
+    conversations: [
+      { source: "desktop", conversationId: "d1", startIso: START, endIso: END, segments: [{ speaker: "Jane", isSelf: false, text: "hello everyone", startIso: "2026-03-10T14:05:00.000Z" }] },
+    ],
+  };
+}
+
+function makeDeps(data: MeetingDayData = dayData(), cfg: MeetingsConfig = config()): MeetingsCliDeps {
+  const source: MeetingsDaySource = { loadDayData: () => data };
+  const store = new MeetingRecordStore(MEMORY_DIR, new InMemoryIo());
+  return { store, builder: new MeetingsBuilder({ source, store, config: cfg }), config: cfg };
+}
+
+interface Captured {
+  out: string;
+  err: string;
+  code: number;
+}
+
+async function run(deps: MeetingsCliDeps, args: string[]): Promise<Captured> {
+  let out = "";
+  let err = "";
+  const code = await runMeetingsCliCommand(deps, args, {
+    stdout: { write: (c: string) => (out += c) },
+    stderr: { write: (c: string) => (err += c) },
+  });
+  return { out, err, code };
+}
+
+test("build --date requires a valid date", async () => {
+  const deps = makeDeps();
+  const missing = await run(deps, ["build"]);
+  assert.equal(missing.code, 1);
+  assert.match(missing.err, /--date <YYYY-MM-DD> is required/);
+
+  const bad = await run(deps, ["build", "--date", "2026-13-40"]);
+  assert.equal(bad.code, 1);
+  assert.match(bad.err, /real YYYY-MM-DD/);
+});
+
+test("list --date rejects a malformed date and a missing flag value", async () => {
+  const deps = makeDeps();
+  const bad = await run(deps, ["list", "--date", "nope"]);
+  assert.equal(bad.code, 1);
+  assert.match(bad.err, /real YYYY-MM-DD/);
+
+  const noValue = await run(deps, ["list", "--date"]);
+  assert.equal(noValue.code, 1);
+  assert.match(noValue.err, /requires a value/);
+});
+
+test("unknown flags and commands error with guidance", async () => {
+  const deps = makeDeps();
+  const flag = await run(deps, ["list", "--bogus"]);
+  assert.equal(flag.code, 1);
+  assert.match(flag.err, /unknown flag --bogus/);
+
+  const cmd = await run(deps, ["frobnicate"]);
+  assert.equal(cmd.code, 1);
+  assert.match(cmd.err, /unknown meetings command 'frobnicate'/);
+});
+
+test("show validates the id and reports a missing record", async () => {
+  const deps = makeDeps();
+  const noId = await run(deps, ["show"]);
+  assert.equal(noId.code, 1);
+  assert.match(noId.err, /requires a meeting id/);
+
+  const badId = await run(deps, ["show", "not-an-id"]);
+  assert.equal(badId.code, 1);
+  assert.match(badId.err, /invalid meeting id/);
+
+  const missing = await run(deps, ["show", "mtg-2026-03-10-abcdef01"]);
+  assert.equal(missing.code, 1);
+  assert.match(missing.err, /not found/);
+});
+
+test("build then list then show round-trips a real record", async () => {
+  const deps = makeDeps();
+  const built = await run(deps, ["build", "--date", DATE]);
+  assert.equal(built.code, 0);
+  assert.match(built.out, /1 meeting \(1 written/);
+
+  const ids = await deps.store.listMeetingIds(DATE);
+  assert.equal(ids.length, 1);
+  const id = ids[0]!;
+
+  const listed = await run(deps, ["list", "--date", DATE]);
+  assert.equal(listed.code, 0);
+  assert.match(listed.out, new RegExp(id));
+  assert.match(listed.out, /sources=desktop/);
+
+  const shown = await run(deps, ["show", id]);
+  assert.equal(shown.code, 0);
+  assert.match(shown.out, /kind: meeting/);
+  assert.match(shown.out, /\*\*Jane\*\* \[14:05\]: hello everyone/);
+});
+
+test("list --json emits machine-readable output", async () => {
+  const deps = makeDeps();
+  await run(deps, ["build", "--date", DATE]);
+  const json = await run(deps, ["list", "--date", DATE, "--json"]);
+  assert.equal(json.code, 0);
+  const parsed = JSON.parse(json.out) as Array<{ id: string; sources: string[] }>;
+  assert.equal(parsed.length, 1);
+  assert.deepEqual(parsed[0]?.sources, ["desktop"]);
+});
+
+test("build reports the disabled state when the subsystem is off", async () => {
+  const deps = makeDeps(dayData(), config({ enabled: false }));
+  const result = await run(deps, ["build", "--date", DATE]);
+  assert.equal(result.code, 0);
+  assert.match(result.out, /meetings disabled/);
+});
+
+test("show rejects a syntactically valid but impossible calendar id via MeetingsInputError", async () => {
+  const deps = makeDeps();
+  // mtg-2026-13-40-... matches the id SHAPE but 2026-13-40 is not a real date;
+  // this must be a clean input error (exit 1), never a 500 from the path validator.
+  const result = await run(deps, ["show", "mtg-2026-13-40-abcdef01"]);
+  assert.equal(result.code, 1);
+  assert.match(result.err, /not a real calendar date/);
+});
+
+test("build text output surfaces a SANITIZED reindex-hook warning (no raw error text)", async () => {
+  const source: MeetingsDaySource = { loadDayData: () => dayData() };
+  const store = new MeetingRecordStore(MEMORY_DIR, new InMemoryIo());
+  const deps: MeetingsCliDeps = {
+    store,
+    builder: new MeetingsBuilder({
+      source,
+      store,
+      config: config(),
+      hooks: { reindex: () => { throw new Error("index offline at 10.0.0.5:9200"); } },
+    }),
+    config: config(),
+  };
+  const result = await run(deps, ["build", "--date", DATE]);
+  assert.equal(result.code, 0, "reindex failure must not fail the build");
+  assert.match(result.out, /warning: reindex hook failed after records were persisted/);
+  assert.doesNotMatch(result.out, /index offline|10\.0\.0\.5|9200/, "raw internal reindex error must not leak to CLI stdout");
+});
+
+test("findings 7+8 — list/show expose a record when enabled, nothing when meetings.enabled is false", async () => {
+  // Build a real record with the subsystem enabled, then prove EACH read surface
+  // surfaces that record when enabled (so the disabled negatives below are not
+  // vacuous), then flip config off and confirm the same surfaces expose nothing.
+  const store = new MeetingRecordStore(MEMORY_DIR, new InMemoryIo());
+  const source: MeetingsDaySource = { loadDayData: () => dayData() };
+  const enabled: MeetingsCliDeps = { store, builder: new MeetingsBuilder({ source, store, config: config() }), config: config() };
+  await run(enabled, ["build", "--date", DATE]);
+  const id = (await store.listMeetingIds(DATE))[0]!;
+
+  // Positive baseline: enabled reads DO surface the record on every path.
+  const listAllEnabled = await run(enabled, ["list"]);
+  assert.match(listAllEnabled.out, new RegExp(id), "enabled list surfaces the stored record");
+  const listDayEnabled = await run(enabled, ["list", "--date", DATE]);
+  assert.match(listDayEnabled.out, new RegExp(id), "enabled date-scoped list surfaces the stored record");
+  const listJsonEnabled = await run(enabled, ["list", "--date", DATE, "--json"]);
+  assert.match(listJsonEnabled.out, new RegExp(id), "enabled date-scoped json list surfaces the stored record");
+  const shownEnabled = await run(enabled, ["show", id]);
+  assert.match(shownEnabled.out, /kind: meeting/, "enabled show prints the record");
+  assert.match(shownEnabled.out, new RegExp(id), "enabled show prints the requested record's id");
+
+  // Now the same surfaces with the subsystem OFF must expose nothing.
+  const disabled: MeetingsCliDeps = {
+    store,
+    builder: new MeetingsBuilder({ source, store, config: config({ enabled: false }) }),
+    config: config({ enabled: false }),
+  };
+  const listAll = await run(disabled, ["list"]);
+  assert.equal(listAll.code, 0);
+  assert.doesNotMatch(listAll.out, new RegExp(id), "disabled list must not expose a stored record");
+  assert.match(listAll.out, /meetings disabled/);
+
+  const listDay = await run(disabled, ["list", "--date", DATE]);
+  assert.equal(listDay.code, 0);
+  assert.doesNotMatch(listDay.out, new RegExp(id), "disabled date-scoped list must not expose the record it surfaces when enabled");
+
+  const listJson = await run(disabled, ["list", "--date", DATE, "--json"]);
+  assert.equal(listJson.out.trim(), "[]", "disabled json list exposes nothing");
+
+  const shown = await run(disabled, ["show", id]);
+  assert.equal(shown.code, 0);
+  assert.doesNotMatch(shown.out, /kind: meeting/, "disabled show must not print the record it prints when enabled");
+  assert.doesNotMatch(shown.out, new RegExp(id), "disabled show must not echo the record id");
+  assert.match(shown.out, /meetings disabled/);
+});
+
+test("build text output surfaces a SANITIZED memory-generation warning (no raw error text)", async () => {
+  const source: MeetingsDaySource = { loadDayData: () => dayData() };
+  const store = new MeetingRecordStore(MEMORY_DIR, new InMemoryIo());
+  const deps: MeetingsCliDeps = {
+    store,
+    builder: new MeetingsBuilder({
+      source,
+      store,
+      config: config(),
+      // The injected generator rejects AFTER records persist; buildDay isolates
+      // it into summary.memoryWarning. The text renderer must surface that line.
+      memoryGenerator: { onRecordsBuilt: async () => { throw new Error("qdrant offline at 10.0.0.9:6333"); } },
+    }),
+    config: config(),
+  };
+  const result = await run(deps, ["build", "--date", DATE]);
+  assert.equal(result.code, 0, "memory-generation failure must not fail the build");
+  assert.match(result.out, /warning: memory generation failed after records were persisted/);
+  assert.doesNotMatch(result.out, /qdrant offline|10\.0\.0\.9|6333/, "raw internal memory-gen error must not leak to CLI stdout");
+});
+
+test("list --date rejects a malformed date even when meetings.enabled is false", async () => {
+  const deps = makeDeps(dayData(), config({ enabled: false }));
+  const bad = await run(deps, ["list", "--date", "nope", "--json"]);
+  assert.equal(bad.code, 1, "a malformed --date must reject regardless of enabled state");
+  assert.match(bad.err, /real YYYY-MM-DD/);
+  assert.doesNotMatch(bad.out, /\[\]/, "malformed --date must not short-circuit to an empty disabled result");
+});