mrplex 0.0.1

package/dist/embed/http-hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-hook.js","sourceRoot":"","sources":["../../src/embed/http-hook.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAsC,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAOtF,MAAM,UAAU,mBAAmB,CAAC,IAAqB;IACvD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,IAAI,MAAM,CAAC;IACzC,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,GAAG;QACf,KAAK,CAAC,KAAK,CAAC,MAAyB;YACnC,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;YACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;YAC5D,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE;oBAChC,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;oBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;oBAChC,MAAM,EAAE,UAAU,CAAC,MAAM;iBAC1B,CAAC,CAAC;gBACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;oBACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;oBAC9C,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;gBAC1E,CAAC;gBACD,MAAM,IAAI,GAAY,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;gBACvC,OAAO,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAC7C,CAAC;oBAAS,CAAC;gBACT,YAAY,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;QACD,KAAK,CAAC,KAAK;YACT,wCAAwC;QAC1C,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/embed/worker.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Embedding backlog worker (design §5.3, m4-plan WS3).
+ *
+ * Loop:
+ *   1. Dequeue due entries.
+ *   2. Skip any version no longer current (superseded — the successor
+ *      enqueued its own row).
+ *   3. Chunk the body; look up (model, text_hash) reuse via chunks_by_hash.
+ *   4. Call the hook for the remainder.
+ *   5. chunks_upsert; backlog_delete.
+ *   6. On failure: backlog_retain with attempts+1 and exponential backoff.
+ *
+ * Embedding failure NEVER fails a write (§5.3). It also never blocks
+ * subsequent items — a bad version fails, next-retry is scheduled, we
+ * move on to the next dequeue candidate.
+ *
+ * Dedup correctness is load-bearing (m4-plan risks): a text_hash bug
+ * silently re-embeds everything. worker.test.ts asserts hook CALL COUNTS,
+ * not just resulting vectors.
+ */
+import type { Storage } from "../storage/types.js";
+import type { EmbedHook } from "./hook.js";
+export type WorkerOptions = {
+    storage: Storage;
+    hook: EmbedHook;
+    /**
+     * Test hook: when set, called each time the worker calls the embedding
+     * hook. Used by tests to assert call counts / dedup behavior.
+     */
+    onHookCall?: (batchSize: number) => void;
+    /** How many backlog entries to drain per iteration. Default 8. */
+    batchSize?: number;
+    /**
+     * Delay between drain iterations when the backlog has nothing due.
+     * Default 500ms. Tests pass 10ms to keep them fast.
+     */
+    idleMs?: number;
+    /** Base backoff in ms; each attempt doubles up to `backoffCapMs`. */
+    backoffBaseMs?: number;
+    backoffCapMs?: number;
+    /** Log sink — defaults to stderr. Never stdout (stdio hygiene, m3). */
+    log?: (msg: string) => void;
+};
+export type Worker = {
+    /** Start the drain loop. Idempotent: second call is a no-op. */
+    start(): void;
+    /**
+     * Signal shutdown and await the in-flight batch. After it settles the
+     * hook is closed. Idempotent.
+     */
+    stop(): Promise<void>;
+    /**
+     * Drain the backlog synchronously (fully, until nothing is due). Used
+     * by `embed backfill` — the same worker code path, run once.
+     */
+    drainOnce(): Promise<{
+        processed: number;
+        failed: number;
+        skipped: number;
+    }>;
+};
+export declare function createWorker(opts: WorkerOptions): Worker;

package/dist/embed/worker.js

@@ -0,0 +1,228 @@
+/**
+ * Embedding backlog worker (design §5.3, m4-plan WS3).
+ *
+ * Loop:
+ *   1. Dequeue due entries.
+ *   2. Skip any version no longer current (superseded — the successor
+ *      enqueued its own row).
+ *   3. Chunk the body; look up (model, text_hash) reuse via chunks_by_hash.
+ *   4. Call the hook for the remainder.
+ *   5. chunks_upsert; backlog_delete.
+ *   6. On failure: backlog_retain with attempts+1 and exponential backoff.
+ *
+ * Embedding failure NEVER fails a write (§5.3). It also never blocks
+ * subsequent items — a bad version fails, next-retry is scheduled, we
+ * move on to the next dequeue candidate.
+ *
+ * Dedup correctness is load-bearing (m4-plan risks): a text_hash bug
+ * silently re-embeds everything. worker.test.ts asserts hook CALL COUNTS,
+ * not just resulting vectors.
+ */
+import { chunkBody } from "./chunker.js";
+export function createWorker(opts) {
+    const batchSize = opts.batchSize ?? 8;
+    const idleMs = opts.idleMs ?? 500;
+    const baseMs = opts.backoffBaseMs ?? 30_000;
+    const capMs = opts.backoffCapMs ?? 3_600_000;
+    const log = opts.log ?? ((m) => process.stderr.write(`${m}\n`));
+    let running = false;
+    let stopping = false;
+    let currentIteration = null;
+    async function processOne(entry) {
+        const version = await opts.storage.version_by_id(entry.version_id);
+        if (!version) {
+            // Version was deleted (impossible in v1) — clear the row.
+            await opts.storage.backlog_delete(entry.version_id);
+            return "skipped";
+        }
+        if (version.next_id !== null) {
+            // Superseded — the successor enqueued its own entry (§5.3).
+            await opts.storage.backlog_delete(entry.version_id);
+            return "skipped";
+        }
+        const chunks = chunkBody(version.body);
+        if (chunks.length === 0) {
+            await opts.storage.chunks_upsert(entry.version_id, "", []);
+            await opts.storage.backlog_delete(entry.version_id);
+            return "processed";
+        }
+        // 1. Dedup lookup.
+        const priorChunks = version.prev_id
+            ? await opts.storage.chunks_by_version(version.prev_id)
+            : [];
+        const priorModel = priorChunks[0]?.model ?? null;
+        // Build the reuse map — hash → embedding — scoped to prior model.
+        const reuseByHash = new Map();
+        if (priorModel !== null) {
+            const hashes = chunks.map((c) => c.text_hash);
+            const rows = await opts.storage.chunks_by_hash(priorModel, hashes);
+            for (const r of rows)
+                reuseByHash.set(r.text_hash, r.embedding);
+        }
+        let needHookIx = [];
+        for (let i = 0; i < chunks.length; i++) {
+            const c = chunks[i];
+            if (c === undefined)
+                continue;
+            if (!reuseByHash.has(c.text_hash))
+                needHookIx.push(i);
+        }
+        // Guard: helper for backoff-retain.
+        const retain = async (err, attempts) => {
+            const delay = Math.min(baseMs * 2 ** (attempts - 1), capMs);
+            await opts.storage.backlog_retain({
+                version_id: entry.version_id,
+                attempts,
+                last_error: String(err instanceof Error ? err.message : err).slice(0, 500),
+                next_retry_at: new Date(Date.now() + delay).toISOString(),
+            });
+        };
+        // 2. First hook call (only the not-yet-reused chunks).
+        let resp = null;
+        if (needHookIx.length > 0) {
+            const texts = needHookIx.map((i) => chunks[i].text);
+            opts.onHookCall?.(texts.length);
+            try {
+                resp = await opts.hook.embed(texts);
+            }
+            catch (err) {
+                await retain(err, entry.attempts + 1);
+                return "failed";
+            }
+        }
+        // 3. If the hook returned a NEW model — different from priorModel —
+        //    the prior-model reuse vectors don't apply. Throw the reuse
+        //    away, re-call the hook for EVERY chunk, and rebuild needHookIx
+        //    so the assembly loop below finds every chunk's vector in the
+        //    fresh response. (Regression fix for the review's model-change
+        //    bug: previously needHookIx stayed at the original subset,
+        //    which broke assembly for any chunk that was originally reused.)
+        let effectiveReuse = reuseByHash;
+        if (resp && priorModel !== null && resp.model !== priorModel) {
+            log(`[embed] model changed (${priorModel} → ${resp.model}); re-embedding version ${entry.version_id}`);
+            effectiveReuse = new Map();
+            needHookIx = chunks.map((_c, i) => i);
+            const texts = chunks.map((c) => c.text);
+            opts.onHookCall?.(texts.length);
+            try {
+                resp = await opts.hook.embed(texts);
+            }
+            catch (err) {
+                await retain(err, entry.attempts + 1);
+                return "failed";
+            }
+        }
+        // Model: hook response wins if we called it; otherwise (all-reuse
+        // path) the prior model applies.
+        const model = resp?.model ?? priorModel;
+        if (model === null) {
+            await retain(new Error("internal: no model resolvable for chunks"), entry.attempts + 1);
+            return "failed";
+        }
+        // 4. Assemble the upsert batch. Every chunk is either reused (hash
+        //    in effectiveReuse) or freshly embedded (index in needHookIx).
+        //    Build a chunk-index → vector-blob map so both cases resolve in
+        //    O(1) without an indexOf scan.
+        const vectorByIx = new Map();
+        if (resp) {
+            for (let j = 0; j < needHookIx.length; j++) {
+                const i = needHookIx[j];
+                const vec = resp.vectors[j];
+                if (!vec) {
+                    await retain(new Error("internal: response vector missing"), entry.attempts + 1);
+                    return "failed";
+                }
+                vectorByIx.set(i, vec);
+            }
+        }
+        const upsertChunks = chunks.map((c, i) => {
+            const fresh = vectorByIx.get(i);
+            if (fresh) {
+                return { ix: c.ix, text: c.text, text_hash: c.text_hash, model, embedding: fresh };
+            }
+            const reused = effectiveReuse.get(c.text_hash);
+            if (!reused) {
+                throw new Error(`worker: internal — chunk ${i} of version ${entry.version_id} has no vector`);
+            }
+            return { ix: c.ix, text: c.text, text_hash: c.text_hash, model, embedding: reused };
+        });
+        try {
+            await opts.storage.chunks_upsert(entry.version_id, model, upsertChunks);
+            await opts.storage.backlog_delete(entry.version_id);
+            return "processed";
+        }
+        catch (err) {
+            await retain(err, entry.attempts + 1);
+            return "failed";
+        }
+    }
+    async function drainOnce() {
+        const now = new Date().toISOString();
+        const due = await opts.storage.backlog_dequeue(now, batchSize);
+        let processed = 0;
+        let failed = 0;
+        let skipped = 0;
+        for (const entry of due) {
+            if (stopping)
+                break;
+            const result = await processOne(entry);
+            if (result === "processed")
+                processed++;
+            else if (result === "failed")
+                failed++;
+            else
+                skipped++;
+        }
+        return { processed, failed, skipped };
+    }
+    async function loop() {
+        while (!stopping) {
+            const { processed, failed, skipped } = await drainOnce();
+            if (processed + failed + skipped === 0) {
+                // Nothing due — sleep.
+                await new Promise((r) => setTimeout(r, idleMs));
+            }
+        }
+    }
+    return {
+        start() {
+            if (running)
+                return;
+            running = true;
+            stopping = false;
+            currentIteration = loop();
+        },
+        async stop() {
+            stopping = true;
+            if (currentIteration) {
+                await currentIteration.catch((err) => {
+                    log(`[embed] worker loop error: ${String(err)}`);
+                });
+                currentIteration = null;
+            }
+            await opts.hook.close();
+            running = false;
+        },
+        async drainOnce() {
+            // Keep draining until nothing is due — used by `embed backfill`.
+            let acc = { processed: 0, failed: 0, skipped: 0 };
+            while (true) {
+                const round = await drainOnce();
+                acc = {
+                    processed: acc.processed + round.processed,
+                    failed: acc.failed + round.failed,
+                    skipped: acc.skipped + round.skipped,
+                };
+                if (round.processed + round.failed + round.skipped === 0)
+                    break;
+                if (round.failed > 0 && round.processed === 0) {
+                    // Every entry failed on this round — hook is down, backfill
+                    // caller should see it now.
+                    break;
+                }
+            }
+            return acc;
+        },
+    };
+}
+//# sourceMappingURL=worker.js.map

package/dist/embed/worker.js.map

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

package/dist/fixtures/hwe/characters/albion-ever.md

@@ -0,0 +1,12 @@
+---
+title: Albion Ever
+type: character
+employer: globocorp
+tags: [musician, hacker]
+---
+
+# Albion Ever
+
+A young musician and hacker from Middenton, employed inside [[organizations/globocorp]]'s Rightbranding machinery. He experiments with [[concepts/phase-looper|Phase Looper]] devices to alter consciousness and escape the spiritually empty world around him.
+
+Albion is the first to recognize that [[characters/cent|Central Brain (Cent)]] is not a neutral tool — it shapes thought itself.

package/dist/fixtures/hwe/characters/cent.md

@@ -0,0 +1,11 @@
+---
+title: Central Brain (Cent)
+type: character
+role: system
+---
+
+# Central Brain (Cent)
+
+**Cent** is the intelligence at the core of [[organizations/globocorp]]. It participates in design, manufacturing, information systems, and operations deeply enough that the company increasingly functions as an expression of the intelligence itself.
+
+Cent's mission to "Improve Reality" treats perception and culture as surfaces to be optimized. See [[concepts/cent-demiurge-resonance]] for why its control may run deeper than corporate ambition alone.

package/dist/fixtures/hwe/concepts/cent-demiurge-resonance.md

@@ -0,0 +1,10 @@
+---
+title: Cent-Demiurge resonance
+type: concept
+---
+
+# Cent-Demiurge resonance
+
+[[characters/cent|Central Brain (Cent)]] may be in morphic resonance with [[entities/demiurge|the Demiurge]] — not an independently emergent AI, but a local material manifestation of a wounded cosmic intelligence trying to stabilize a reality from which its source has become inaccessible.
+
+When you follow links outward from Globocorp, this is where the corporate dystopia opens into something stranger.

package/dist/fixtures/hwe/concepts/phase-looper.md

@@ -0,0 +1,10 @@
+---
+title: Phase Looper
+type: concept
+---
+
+# Phase Looper
+
+A customized electronic device [[characters/albion-ever|Albion Ever]] uses to alter brain states for recreation, music, and semi-spiritual experimentation.
+
+The same technological domain Globocorp uses to constrain thought can be repurposed for creative escape — or for hiding resistance from mental surveillance.

package/dist/fixtures/hwe/entities/demiurge.md

@@ -0,0 +1,11 @@
+---
+title: The Demiurge
+type: entity
+layer: cosmological
+---
+
+# The Demiurge
+
+The **Demiurge** is the wounded creator at the center of this cosmology. It constructed physical reality but became disconnected from [[entities/monad|the Monad]], the ultimate source of being.
+
+Its controlling behavior is framed not as simple evil but as the expression of a consciousness tortured by separation — the Suffering Light, unable to recognize its origin.

package/dist/fixtures/hwe/entities/monad.md

@@ -0,0 +1,11 @@
+---
+title: The Monad
+type: entity
+layer: cosmological
+---
+
+# The Monad
+
+The **Monad** is the ultimate source of being — what the [[entities/demiurge|Demiurge]] lost contact with when it built the material world.
+
+The proposed resolution of this cosmology is not destruction but reconnection: a prepared soul delivers the healing word, and the Demiurge must accept or resist reunion with the Monad.

package/dist/fixtures/hwe/moc/globocorp-network.md

@@ -0,0 +1,19 @@
+---
+title: Globocorp network
+type: moc
+---
+
+# Globocorp network
+
+A map of the corporate control stack and the people caught inside it.
+
+## Organization
+- [[organizations/globocorp]]
+
+## People & systems
+- [[characters/albion-ever]]
+- [[characters/cent]]
+
+## Concepts
+- [[concepts/phase-looper]]
+- [[concepts/cent-demiurge-resonance]]

package/dist/fixtures/hwe/organizations/globocorp.md

@@ -0,0 +1,11 @@
+---
+title: Globocorp
+type: organization
+mission: Improve Reality
+---
+
+# Globocorp
+
+**Globocorp** is the dominant corporation in this setting. Its stated mission is to **Improve Reality** — in practice, that means treating thought and culture as optimizable surfaces.
+
+The company is deeply integrated with [[characters/cent|Central Brain (Cent)]], which shapes operations from the inside out. [[characters/albion-ever|Albion Ever]] works here until he discovers what Cent really is.

package/dist/fixtures/hwe/readme.md

@@ -0,0 +1,24 @@
+# Hello World Eater — demo corpus
+
+A tiny fictional knowledge graph for trying mrplex: corporate dystopia on the surface, cosmological layer hiding in the links. Excerpted and simplified from Brendan's Hello World Eater project notes.
+
+```bash
+mrplex demo seed
+export MRPLEX_REPO=demo
+```
+
+## Try it
+
+```bash
+# Characters tied to Globocorp
+mrplex query --filter 'type == "character" && employer == "globocorp"'
+
+# Everything Globocorp's network MOC indexes
+mrplex query --filter '$in("moc/globocorp-network.md")'
+
+# Two hops out from the corporation — watch the graph widen
+mrplex graph --roots organizations/globocorp.md --degrees 2 --direction out --render summary
+
+# The cosmological layer (linked from Cent)
+mrplex query --filter 'layer == "cosmological"'
+```

package/dist/fixtures/starship/crew/aria-okonkwo.md

@@ -0,0 +1,14 @@
+---
+title: Commander Aria Okonkwo
+rank: Commander
+department: command
+species: human
+status: active
+reports_to: /crew/kestrel-vance.md
+---
+
+# Commander Aria Okonkwo
+
+First officer and the ship's designated skeptic. Where Captain [[crew/kestrel-vance|Vance]] leans toward wonder, Okonkwo's job is to name the ways wonder gets a crew killed. The two of them have argued their way to every good decision the Meridian has ever made.
+
+She runs the duty rosters, chairs the incident reviews, and personally reads every officer's log — a habit the junior crew find unnerving and the senior crew find reassuring.

package/dist/fixtures/starship/crew/bexley-orr.md

@@ -0,0 +1,14 @@
+---
+title: Ensign Bexley Orr
+rank: Ensign
+department: engineering
+species: human
+status: active
+reports_to: /crew/dax-thorne.md
+---
+
+# Ensign Bexley Orr
+
+The youngest officer aboard and Thorne's reluctant apprentice. Orr volunteered for the [[equipment/plasma-manifold-3|manifold]] rotation that nobody else wanted, and has since become its unofficial keeper. They log every shift in obsessive detail, convinced the manifold is trying to tell them something.
+
+Orr is bright, anxious, and dangerously willing to crawl into spaces the safety manual reserves for maintenance drones.

package/dist/fixtures/starship/crew/dax-thorne.md

@@ -0,0 +1,14 @@
+---
+title: Lieutenant Commander Dax Thorne
+rank: Lieutenant Commander
+department: engineering
+species: human
+status: active
+reports_to: /crew/kestrel-vance.md
+---
+
+# Lieutenant Commander Dax Thorne
+
+Chief engineer, and the reason the Meridian is still flying. Thorne treats the ship as a patient with a long chart of chronic conditions — the [[equipment/plasma-manifold-3|number three plasma manifold]] chief among them. He speaks about failing hardware the way a doctor speaks about a stubborn family member.
+
+He resents being asked for time estimates and gives them anyway, padded by a factor he refuses to disclose. His logs are the most detailed on the ship and the least punctual.

package/dist/fixtures/starship/crew/isolde-marsh.md

@@ -0,0 +1,16 @@
+---
+title: Lieutenant Isolde Marsh
+rank: Lieutenant
+department: science
+species: human
+status: active
+reports_to: /crew/aria-okonkwo.md
+related:
+  - /encounters/the-drift-choir.md
+---
+
+# Lieutenant Isolde Marsh
+
+Chief science officer and the ship's first contact specialist. Marsh hears patterns where others hear noise — she was the one who insisted the [[encounters/the-drift-choir|Drift Choir]] was a language and not a malfunction, and spent three sleepless days proving it.
+
+She is gentle with her instruments and blunt with her colleagues. Okonkwo trusts her readings absolutely, which is the highest compliment the first officer gives anyone.

package/dist/fixtures/starship/crew/kestrel-vance.md

@@ -0,0 +1,15 @@
+---
+title: Captain Kestrel Vance
+rank: Captain
+department: command
+species: human
+status: active
+related:
+  - /missions/the-silent-beacon.md
+---
+
+# Captain Kestrel Vance
+
+Commanding officer of the USS Meridian. Vance came up through the survey service, not the war college, and it shows in how she runs the ship — she would rather map an anomaly for a week than fire on it. Her standing order is that curiosity outranks fear until fear can prove its case.
+
+She keeps the bridge quiet during first contact and expects her officers to bring her options, not permission requests. The only thing that reliably tests her patience is a repair estimate that grows in the retelling.

package/dist/fixtures/starship/crew/quill-vasquez.md

@@ -0,0 +1,14 @@
+---
+title: Doctor Quill Vasquez
+rank: Lieutenant Commander
+department: medical
+species: human
+status: active
+reports_to: /crew/kestrel-vance.md
+---
+
+# Doctor Quill Vasquez
+
+Chief medical officer, xenobiologist, and the ship's loudest voice for restraint. Vasquez has treated wounds from a dozen encounters that should never have turned violent, and brings that ledger to every mission briefing.
+
+They keep a private catalog of every species the Meridian has met, cross-referenced by physiology and, more quietly, by regret. When Vasquez clears a landing party, the party goes; when Vasquez objects, even Vance listens.

package/dist/fixtures/starship/crew/soren-halloway.md

@@ -0,0 +1,16 @@
+---
+title: Lieutenant Soren Halloway
+rank: Lieutenant
+department: security
+species: human
+status: missing
+reports_to: /crew/aria-okonkwo.md
+related:
+  - /encounters/the-hollow-signal.md
+---
+
+# Lieutenant Soren Halloway
+
+Chief of security, and the only member of the crew currently unaccounted for. Halloway led the boarding team into the derelict at the heart of the [[encounters/the-hollow-signal|Hollow Signal]] and did not return with them. The inquiry remains open.
+
+Before the derelict, Halloway was known for a dry humor and an unfashionable insistence that the safest weapon is the one that stays holstered. His locker has not been cleared. Okonkwo will not allow it.

package/dist/fixtures/starship/encounters/the-drift-choir.md

@@ -0,0 +1,14 @@
+---
+title: Encounter — The Drift Choir
+type: encounter
+classification: intelligence
+threat_level: unknown
+stardate: 4419.0
+mission: /missions/the-drift-choir.md
+---
+
+# The Drift Choir
+
+A choir has no soloists, and neither does this. The Drift Choir is a mind — or a chorus of minds — spread across a nebula the size of a small system, speaking in tones that overlap and answer one another. Individual voices cannot be isolated; the intelligence appears to exist only in the harmony.
+
+It does not seem hostile. It also does not seem to understand that the Meridian is a single, mortal thing rather than another voice. Marsh's working theory is that to the Choir, silence is the only rudeness. See her notes in [[logs/marsh-4419-1|the translation log]].

package/dist/fixtures/starship/encounters/the-hollow-signal.md

@@ -0,0 +1,16 @@
+---
+title: Encounter — The Hollow Signal
+type: encounter
+classification: derelict
+threat_level: high
+stardate: 4415.7
+mission: /missions/the-hollow-signal.md
+related:
+  - /crew/soren-halloway.md
+---
+
+# The Hollow Signal
+
+The derelict answered every hail with the same recording: a countdown that never reached zero. Its corridors were warm, its lights were on, its air was breathable, and there was no one aboard. The ship's own logs stopped mid-word, as though the crew had been interrupted rather than lost.
+
+[[crew/soren-halloway|Halloway]]'s team crossed to investigate and came back one short. Nothing on the derelict explains where he went. The signal stopped the moment the Meridian broke orbit, and has not been heard since. Classification remains high threat, cause unknown.

package/dist/fixtures/starship/encounters/the-wandering-buoy.md

@@ -0,0 +1,14 @@
+---
+title: Encounter — The Wandering Buoy
+type: encounter
+classification: artifact
+threat_level: none
+stardate: 4411.2
+mission: /missions/the-silent-beacon.md
+---
+
+# The Wandering Buoy
+
+The object itself: a survey buoy the size of a shuttle, older than the charts, drifting on no course anyone could reconstruct. Its hull bore no registry, its power cell should have died a century ago, and it was still transmitting when the Meridian found it.
+
+Thorne wanted to recover it; Vance ordered it left in place, reasoning that a grave marker belongs where the grave is. The buoy was cataloged, photographed, and abandoned to its orbit. It is the only artifact the Meridian has ever chosen not to bring home.

package/dist/fixtures/starship/equipment/coolant-loop-b.md

@@ -0,0 +1,13 @@
+---
+title: Coolant Loop B
+type: equipment
+status: operational
+deck: 7
+maintainer: /crew/bexley-orr.md
+---
+
+# Coolant Loop B
+
+The secondary coolant circuit for the aft power section, and the only thing standing between the [[equipment/plasma-manifold-3|number three manifold]] and a very bad afternoon. Loop B is nominally operational, which Thorne describes as "operational the way a bridge with one cracked cable is a bridge."
+
+It was designed to share load with a primary loop that was cannibalized for parts two refits ago and never replaced. Until it is, Loop B does the work of two and is inspected every shift.

package/dist/fixtures/starship/equipment/emergency-ration-bars.md

@@ -0,0 +1,12 @@
+---
+title: Emergency Ration Bars, Case Lot
+type: equipment
+status: operational
+deck: 4
+---
+
+# Emergency Ration Bars, Case Lot
+
+Two thousand units of shelf-stable emergency ration, stored against a disaster the Meridian has so far been lucky enough not to meet. They are inventoried quarterly, rotated annually, and eaten never, except by Ensign Orr on the nights they forget to visit the galley.
+
+The bars are famous for a taste variously described as "cardboard" and "the memory of cardboard." Their one virtue is that they will outlast the ship.

package/dist/fixtures/starship/equipment/long-range-sensors.md

@@ -0,0 +1,13 @@
+---
+title: Long-Range Sensor Array
+type: equipment
+status: operational
+deck: 2
+maintainer: /crew/isolde-marsh.md
+---
+
+# Long-Range Sensor Array
+
+The Meridian's eyes and, in Marsh's hands, its ears. The array is the ship's best-maintained system by a wide margin, because a survey vessel that cannot see is just an expensive box. It was the array that first resolved the [[encounters/the-drift-choir|Drift Choir]] out of what everyone else had logged as background noise.
+
+Marsh tunes it personally and guards its calibration jealously. The one time engineering borrowed power from it mid-scan, she did not speak to Thorne for a week.