@melite/estate-drafts 0.1.4-alpha → 0.1.5-pre-alpha

package/lib/spec.d.ts

@@ -15,6 +15,23 @@ declare const DraftRecordSchema: z.ZodObject<{
     }, z.core.$loose>;
 }, z.core.$strip>;
 export type DraftRecord = z.infer<typeof DraftRecordSchema>;
+/** One character record (audit 004/C2): the reusable identity
+ *  bundle. `references` is the ORDERED reference-image list — path
+ *  strings of exactly the class the submit walk stages (data URLs,
+ *  http(s), estate asset URLs, runs-relative and cwd-relative
+ *  paths; `uploadReferenced` walks the whole graph and stages any
+ *  of them, audit 004 §3), order preserved — sheet views are
+ *  position-coded. `description` is the LOCKED identity prompt (a
+ *  character-sheet ten-section block, audit 004/C7's skill); the
+ *  run-time seam (how it reaches a prompt) is C3's decision, not
+ *  this table's. */
+declare const CharacterRecordSchema: z.ZodObject<{
+    name: z.ZodString;
+    references: z.ZodArray<z.ZodString>;
+    description: z.ZodString;
+    updated_at: z.ZodNumber;
+}, z.core.$strip>;
+export type CharacterRecord = z.infer<typeof CharacterRecordSchema>;
 /** The draft-id law (editor_runs.818-822 heritage): 1..96 chars,
  *  [A-Za-z0-9_-] ASCII only, path-safe. THE SSOT — the queue's
  *  submit gate and the drafts remote both test this one address
@@ -28,10 +45,14 @@ export declare const DRAFT_ID_PATTERN: RegExp;
 export declare const DRAFT_ID_MAX_LEN = 96;
 /** draft_id_ok (the doors' hand-loop drop-in): the law, one voice. */
 export declare function draftIdOk(draftId: string): boolean;
-/** The drafts domain (unit dir `drafts/`, version 1). */
+/** The drafts domain (unit dir `drafts/`, version 2 — the
+ *  characters table join; version-1 record documents stay
+ *  readable through compatibleVersions, the per-record
+ *  contract's accepted-stamp set). */
 export declare const draftsDomainSpec: {
     name: string;
     version: number;
+    compatibleVersions: number[];
     layout: "per-record";
     invalidRecords: "backup-and-skip";
     global: {
@@ -54,6 +75,12 @@ export declare const draftsDomainSpec: {
                 }[];
             };
         }>;
+        characters: import("@deepseek-ai/dsh-storage-domain").DomainTableSpec<string, {
+            name: string;
+            references: string[];
+            description: string;
+            updated_at: number;
+        }>;
     };
 };
 export type DraftsDomainSpec = typeof draftsDomainSpec;

package/lib/spec.js

@@ -7,6 +7,15 @@
 // skipped by the facility (`invalidRecords: 'backup-and-skip'`).
 // The global slot is the one-time legacy-import marker: 0 until the
 // legacy drafts tree has been imported, the import epoch (ms) after.
+//
+
+// character bundle (ordered reference paths + a locked description),
+// same id grammar as drafts (one address class, one law — the
+// per-record layout's SAFE_KEY_RE is exactly DRAFT_ID_RE's set), the
+// storage root itself is the tenant boundary. Version 2 with
+// compatibleVersions [1]: existing v1-stamped record documents keep
+// reading green (the per-record contract accepts the declared set),
+// new writes stamp 2.
 import { defineDomain, domainTable } from "@deepseek-ai/dsh-storage-domain";
 import { z } from "zod";
 /** One draft doc — the composer's shape: six contract keys plus
@@ -28,6 +37,22 @@ const DraftRecordSchema = z.object({
     updated_at: z.number().int(),
     doc: DraftDocSchema,
 });
+/** One character record (audit 004/C2): the reusable identity
+ *  bundle. `references` is the ORDERED reference-image list — path
+ *  strings of exactly the class the submit walk stages (data URLs,
+ *  http(s), estate asset URLs, runs-relative and cwd-relative
+ *  paths; `uploadReferenced` walks the whole graph and stages any
+ *  of them, audit 004 §3), order preserved — sheet views are
+ *  position-coded. `description` is the LOCKED identity prompt (a
+ *  character-sheet ten-section block, audit 004/C7's skill); the
+ *  run-time seam (how it reaches a prompt) is C3's decision, not
+ *  this table's. */
+const CharacterRecordSchema = z.object({
+    name: z.string().min(1),
+    references: z.array(z.string()),
+    description: z.string(),
+    updated_at: z.number().int(),
+});
 /** The draft-id law (editor_runs.818-822 heritage): 1..96 chars,
  *  [A-Za-z0-9_-] ASCII only, path-safe. THE SSOT — the queue's
  *  submit gate and the drafts remote both test this one address
@@ -43,15 +68,20 @@ export const DRAFT_ID_MAX_LEN = 96;
 export function draftIdOk(draftId) {
     return DRAFT_ID_RE.test(draftId);
 }
-/** The drafts domain (unit dir `drafts/`, version 1). */
+/** The drafts domain (unit dir `drafts/`, version 2 — the
+ *  characters table join; version-1 record documents stay
+ *  readable through compatibleVersions, the per-record
+ *  contract's accepted-stamp set). */
 export const draftsDomainSpec = defineDomain({
     name: "drafts",
-    version: 1,
+    version: 2,
+    compatibleVersions: [1],
     layout: "per-record",
     invalidRecords: "backup-and-skip",
     global: { schema: z.number().int(), initial: 0 },
     tables: {
         docs: domainTable(DraftRecordSchema),
+        characters: domainTable(CharacterRecordSchema),
     },
 });
 //# sourceMappingURL=spec.js.map

package/lib/store.d.ts

@@ -1,12 +1,46 @@
-import type { Context } from "@deepseek-ai/cordis";
+import { Service, type Context } from "@deepseek-ai/cordis";
 import type { Domain } from "@deepseek-ai/dsh-storage-domain";
 import type { DraftsDomainSpec } from "./spec.js";
-/** Env override for the unit-file root (an env seam, never a hardcode). */
-export declare const STORAGE_ROOT_ENV: string;
-/** The json backend's unit-file root: `<stateRoot>/storage`. */
-export declare function resolveStorageRoot(): string;
+/** The drafts plugin's config (J12: the retired
+ *  MELITE_STORAGE_ROOT / MELITE_STATE_ROOT env seams' config
+ *  twin — the unit-file root the json backend hangs under,
+ *  named at the composition site, never read from the env). */
+export interface DraftsConfig {
+    /** The storage unit-file root (`<stateRoot>/storage` at the
+     *  composition site); default `data/runs/storage`. */
+    storageRoot?: string;
+}
+/** The json backend's unit-file root. */
+export declare function resolveStorageRoot(config?: Readonly<DraftsConfig>): string;
+/** The fiber-scoped seat owning the drafts domain handles (id
+ *  `meliteDraftsDomain` — the estate-seat prefix law, cf.
+ *  skillRegistry.ts:20-28): one instance per mounting fiber, so the
+ *  cached opens die with the fiber instead of living at module
+ *  scope. Fields are TS-`private`, never `#private` — cordis
+ *  `ctx.get` returns a proxy and private class fields die through
+ *  it ("Cannot read private member ... whose class did not declare
+ *  it"; the flows seat, flowsData.ts, is the measured precedent). */
+export declare class DraftsDomainSeatService extends Service {
+    static readonly inject: {
+        readonly optional: readonly [];
+    };
+    /** Per-facility open handles, keyed by the facility object (one
+     *  slot per provider; GC-bounded, fiber-lifetime). */
+    private cached;
+    constructor(ctx: Context, config?: Readonly<DraftsConfig>);
+    /** The composition site's named storage root (J12: config —
+     *  the retired env seam's twin). */
+    readonly config: Readonly<DraftsConfig>;
+    
 
 
 
+    open(): Promise<Domain<DraftsDomainSpec>>;
+}
+/** Open (or reuse) the drafts domain through the mounted seat. The
+ *  apply mounts `DraftsDomainSeatService` before the remote
+ *  services; tests mount it on their own Context.
+ *  @param ctx - the Context whose fiber carries the seat.
+ *  @returns the ready domain handle. */
 export declare function openDraftsDomain(ctx: Context): Promise<Domain<DraftsDomainSpec>>;
 //# sourceMappingURL=store.d.ts.map

package/lib/store.js

@@ -1,27 +1,34 @@
+// store.ts — open the drafts domain through the host's facility.
+//
+// The facility seat (`ctx.storageDomain`) is provided by the HOST's
+// storage rows (json backend + domain facility); this package never
+// bundles them. The open is lazy and process-scoped (one open per
+// storage root — the domain write chain serializes concurrent puts,
+// so sharing the handle is correct), cached on first use.
+//
+// First open runs the one-time legacy import (the pre-domain
+// STATE_ROOT/drafts tree → the domain), guarded by the global slot:
+// runs only while it serves the initial 0, then stamps the epoch —
+// a wiped unit never re-imports frozen ghosts. The legacy files stay
+// untouched on disk — evidence, never truth.
+import { Service } from "@deepseek-ai/cordis";
 import { readFileSync, readdirSync, statSync } from "node:fs";
 import { join } from "node:path";
+import { isPurelyUnstatedRequiredVoice } from "@melite/contracts/laneRelations";
 import { draftsDomainSpec } from "./spec.js";
-/** Env override for the unit-file root (an env seam, never a hardcode). */
-export const STORAGE_ROOT_ENV = "MELITE_STORAGE_ROOT";
-/** Env seam for the state root the legacy drafts tree hangs under. */
-const STATE_ROOT_ENV = "MELITE_STATE_ROOT";
-/** The json backend's unit-file root: `<stateRoot>/storage`. */
-export function resolveStorageRoot() {
-    const override = process.env[STORAGE_ROOT_ENV] ?? "";
-    if (override !== "")
-        return override;
-    const state = process.env[STATE_ROOT_ENV] ?? "data/runs";
-    return join(state, "storage");
+/** The json backend's unit-file root. */
+export function resolveStorageRoot(config = {}) {
+    return config.storageRoot ?? join("data", "runs", "storage");
 }
 /** The one-time legacy-drafts import (the pre-domain drafts tree →
  *  the drafts domain). Unparseable/non-object legacy files skip;
  *  schema-failing rows skip individually; the rest import. */
-async function importLegacyDrafts(drafts) {
+async function importLegacyDrafts(drafts, storageRoot) {
     const marker = drafts.global;
     if (marker.get() !== 0)
         return;
     const docs = drafts.table("docs");
-    const legacyDir = join(resolveStorageRoot(), "..", "drafts");
+    const legacyDir = join(storageRoot, "..", "drafts");
     let names;
     try {
         names = readdirSync(legacyDir);
@@ -66,41 +73,122 @@ async function importLegacyDrafts(drafts) {
     }
     await marker.set(Date.now());
 }
-let cached = new WeakMap();
 
 
 
-export async function openDraftsDomain(ctx) {
-    const root = resolveStorageRoot();
-    // OPTIONAL-dependency probe per the tutorial's documented pattern
-    // (cordis-tutorial/03-services.md: "skip inject and probe at the
-    // use site" — property reads demand inject on loader-mounted
-    // fibers; ctx.get returns the active provider or undefined).
-    const facility = ctx.get("storageDomain");
-    if (facility === undefined || facility === null) {
-        throw new Error("[estate-drafts] storage domain facility not mounted (ctx.storageDomain)");
+
+
+
+
+
+
+
+
+
+async function healReplayedRefusals(drafts) {
+    const docs = drafts.table("docs");
+    for (const [did, rec] of docs.entries()) {
+        // persisted rows are a durable boundary: a record without a doc
+        // object (or without stages) carries no bench row to heal
+        const doc = typeof rec === "object" && rec !== null ? rec.doc : undefined;
+        if (typeof doc !== "object" || doc === null)
+            continue;
+        const stages = Array.isArray(doc.stages) ? doc.stages : [];
+        let changed = false;
+        for (const stage of stages) {
+            if (typeof stage !== "object" || stage === null)
+                continue;
+            const row = stage;
+            const runStatus = row["runStatus"];
+            if (runStatus !== "failed" && runStatus !== "error")
+                continue;
+            const result = row["result"];
+            const error = typeof result === "object" && result !== null
+                ? result["error"]
+                : undefined;
+            // PURELY the class (the mixed-carry guard): a composite
+            // refusal can join the stem with a stated-wrong half — that
+            // row keeps its failed face, only whole-stem texts heal
+            if (typeof error !== "string" || !isPurelyUnstatedRequiredVoice(error)) {
+                continue;
+            }
+            row["runStatus"] = "";
+            row["result"] = {};
+            changed = true;
+        }
+        if (changed)
+            await docs.put(did, rec);
     }
-    const hit = cached.get(facility);
-    if (hit !== undefined && hit.root === root)
-        return hit.ready;
-    // A foreign root never cross-writes another root's units.
-    if (hit !== undefined && hit.root !== root) {
-        throw new Error("[estate-drafts] storage serves the boot root only");
+}
+/** The fiber-scoped seat owning the drafts domain handles (id
+ *  `meliteDraftsDomain` — the estate-seat prefix law, cf.
+ *  skillRegistry.ts:20-28): one instance per mounting fiber, so the
+ *  cached opens die with the fiber instead of living at module
+ *  scope. Fields are TS-`private`, never `#private` — cordis
+ *  `ctx.get` returns a proxy and private class fields die through
+ *  it ("Cannot read private member ... whose class did not declare
+ *  it"; the flows seat, flowsData.ts, is the measured precedent). */
+export class DraftsDomainSeatService extends Service {
+    static inject = { optional: [] };
+    /** Per-facility open handles, keyed by the facility object (one
+     *  slot per provider; GC-bounded, fiber-lifetime). */
+    cached = new WeakMap();
+    constructor(ctx, config = {}) {
+        // the estate-seat id: dsh core may own the bare name
+        super(ctx, "meliteDraftsDomain");
+        this.config = config;
     }
-    const ready = (async () => {
-        const drafts = await facility.open(draftsDomainSpec);
-        await importLegacyDrafts(drafts);
-        return drafts;
-    })();
-    cached.set(facility, { root, ready });
-    try {
-        return await ready;
+    /** The composition site's named storage root (J12: config —
+     *  the retired env seam's twin). */
+    config;
+    
+
+
+
+    async open() {
+        const root = resolveStorageRoot(this.config);
+        // OPTIONAL-dependency probe per the tutorial's documented pattern
+        // (cordis-tutorial/03-services.md: "skip inject and probe at the
+        // use site" — property reads demand inject on loader-mounted
+        // fibers; ctx.get returns the active provider or undefined).
+        const facility = this.ctx.get("storageDomain");
+        if (facility === undefined || facility === null) {
+            throw new Error("[estate-drafts] storage domain facility not mounted (ctx.storageDomain)");
+        }
+        const hit = this.cached.get(facility);
+        // (J12) the config root is immutable per boot, so a cached hit is
+        // always this root — the drifting-mid-process root the retired
+        
+        if (hit !== undefined)
+            return hit.ready;
+        const ready = (async () => {
+            const drafts = await facility.open(draftsDomainSpec);
+            await importLegacyDrafts(drafts, root);
+            await healReplayedRefusals(drafts);
+            return drafts;
+        })();
+        this.cached.set(facility, { root, ready });
+        try {
+            return await ready;
+        }
+        catch (error) {
+            // Unconditional: one slot per facility exists at a time (a
+            // foreign root refuses above), so this rejection owns the slot.
+            this.cached.delete(facility);
+            throw error;
+        }
     }
-    catch (error) {
-        // Unconditional: one slot per facility exists at a time (a
-        // foreign root refuses above), so this rejection owns the slot.
-        cached.delete(facility);
-        throw error;
+}
+/** Open (or reuse) the drafts domain through the mounted seat. The
+ *  apply mounts `DraftsDomainSeatService` before the remote
+ *  services; tests mount it on their own Context.
+ *  @param ctx - the Context whose fiber carries the seat.
+ *  @returns the ready domain handle. */
+export async function openDraftsDomain(ctx) {
+    const seat = ctx.get("meliteDraftsDomain");
+    if (seat === undefined || seat === null) {
+        throw new Error("[estate-drafts] drafts domain seat not mounted (new DraftsDomainSeatService(ctx))");
     }
+    return seat.open();
 }
 //# sourceMappingURL=store.js.map

package/lib/trail.d.ts

@@ -0,0 +1,16 @@
+export declare function canonicalOutputUrl(url: string): string;
+/** A result's OUTPUT urls, one spelling: the artifacts name→url map
+ *  first, the flat assetUrls list second, the lone url third (the
+ *  same harvest order the client's preview reads). */
+export declare function resultOutputUrls(result: unknown): string[];
+/** The draft row's terminal words (see remote.ts's trail laws). */
+export declare function isTerminalTrailWord(v: unknown): boolean;
+/** Same run identity: two non-empty equal run_id strings. */
+export declare function sameTrailRunIdentity(a: unknown, b: unknown): boolean;
+/** THE ONE-ROW-PER-RUN TRAIL (bench-trail W2's law, applied to any
+ *  carried history): identity is the run_id first — the media route
+ *  and the gallery proxy spell the same file differently — with the
+ *  canonical-url set as the no-id fallback. Order preserved, newest
+ *  first in, newest first out. */
+export declare function trailDedupe(history: unknown[]): unknown[];
+//# sourceMappingURL=trail.d.ts.map

package/lib/trail.js

@@ -0,0 +1,91 @@
+
+// trail's dedup/canonical laws live here so EVERY carrier obeys them
+// — the patch door's archive (remote.ts), the load/undo memory carry
+// (bench.ts), and any future writer. remote.ts imports bench.ts, so
+// bench-facing carriers can never import remote.ts back; this module
+// is the cycle-free home both sides share.
+import { RUN_MEDIA_PREFIX } from "@melite/contracts/benchStage";
+/** One url, canonical: the run-relative path. The media route and
+ *  the gallery proxy spell the SAME file two ways
+ *  (/melite-media/runs/<rest>, /infer-gallery/artifact?path=<enc>) —
+ *  every dedup compares canonical forms, never wire spellings. The
+ *  run-media prefix rides the contract's constant — the closure
+ *  gate's no-second-copy law. */
+const MEDIA_RUNS = RUN_MEDIA_PREFIX + "/";
+export function canonicalOutputUrl(url) {
+    if (url.startsWith(MEDIA_RUNS))
+        return url.slice(MEDIA_RUNS.length);
+    if (url.startsWith("/infer-gallery/artifact?path=")) {
+        try {
+            return decodeURIComponent(url.slice("/infer-gallery/artifact?path=".length));
+        }
+        catch {
+            // a malformed escape is not a spelling of another file — keep it
+            return url;
+        }
+    }
+    return url;
+}
+/** A result's OUTPUT urls, one spelling: the artifacts name→url map
+ *  first, the flat assetUrls list second, the lone url third (the
+ *  same harvest order the client's preview reads). */
+export function resultOutputUrls(result) {
+    if (typeof result !== "object" || result === null || Array.isArray(result))
+        return [];
+    const row = result;
+    const urls = [];
+    if (row["artifacts"] !== null && typeof row["artifacts"] === "object" && !Array.isArray(row["artifacts"])) {
+        for (const v of Object.values(row["artifacts"])) {
+            if (typeof v === "string" && v !== "")
+                urls.push(v);
+        }
+    }
+    if (urls.length === 0 && Array.isArray(row["assetUrls"])) {
+        for (const v of row["assetUrls"]) {
+            if (typeof v === "string" && v !== "")
+                urls.push(v);
+        }
+    }
+    if (urls.length === 0 && typeof row["url"] === "string" && row["url"] !== "")
+        urls.push(row["url"]);
+    return urls;
+}
+const TRAIL_TERMINAL = new Set(["done", "completed", "failed", "stopped"]);
+/** The draft row's terminal words (see remote.ts's trail laws). */
+export function isTerminalTrailWord(v) {
+    return typeof v === "string" && TRAIL_TERMINAL.has(v);
+}
+/** Same run identity: two non-empty equal run_id strings. */
+export function sameTrailRunIdentity(a, b) {
+    return typeof a === "string" && a !== "" && a === b;
+}
+/** THE ONE-ROW-PER-RUN TRAIL (bench-trail W2's law, applied to any
+ *  carried history): identity is the run_id first — the media route
+ *  and the gallery proxy spell the same file differently — with the
+ *  canonical-url set as the no-id fallback. Order preserved, newest
+ *  first in, newest first out. */
+export function trailDedupe(history) {
+    const out = [];
+    const runIds = new Set();
+    const sets = [];
+    for (const entry of history) {
+        if (typeof entry !== "object" || entry === null || Array.isArray(entry)) {
+            out.push(entry);
+            continue;
+        }
+        const row = entry;
+        const rid = row["run_id"];
+        if (typeof rid === "string" && rid !== "") {
+            if (runIds.has(rid))
+                continue;
+            runIds.add(rid);
+        }
+        const canon = new Set(resultOutputUrls(row).map(canonicalOutputUrl));
+        if (sets.some((s) => s.size === canon.size && [...s].every((u) => canon.has(u))))
+            continue;
+        sets.push(canon);
+        out.push(entry);
+    }
+    return out;
+}
+//# sourceMappingURL=trail.js.map

package/lib/typert.host.js

@@ -249,7 +249,7 @@ export const TYPERT = {
         typeSymbol: '@melite/estate-drafts/types#BenchStageRow',
         create: _melite_estate_drafts_bench_add_stage_result$schema,
       },
-      sourceLocation: {"file":"packages/estate/drafts/src/remote.ts","line":1209,"column":9},
+      sourceLocation: {"file":"packages/estate/drafts/src/remote.ts","line":1449,"column":9},
     },
     {
       id: '@melite/estate-drafts#bench/clear',
@@ -286,7 +286,7 @@ export const TYPERT = {
         typeSymbol: '@melite/estate-drafts/types#BenchClearRow',
         create: _melite_estate_drafts_bench_clear_result$schema,
       },
-      sourceLocation: {"file":"packages/estate/drafts/src/remote.ts","line":1232,"column":9},
+      sourceLocation: {"file":"packages/estate/drafts/src/remote.ts","line":1472,"column":9},
     },
     {
       id: '@melite/estate-drafts#bench/ensure',
@@ -313,7 +313,7 @@ export const TYPERT = {
         typeSymbol: '@melite/estate-drafts/types#BenchEnsureRow',
         create: _melite_estate_drafts_bench_ensure_result$schema,
       },
-      sourceLocation: {"file":"packages/estate/drafts/src/remote.ts","line":1142,"column":9},
+      sourceLocation: {"file":"packages/estate/drafts/src/remote.ts","line":1380,"column":9},
     },
     {
       id: '@melite/estate-drafts#bench/get',
@@ -340,7 +340,7 @@ export const TYPERT = {
         typeSymbol: '@melite/estate-drafts/types#BenchGetRow',
         create: _melite_estate_drafts_bench_get_result$schema,
       },
-      sourceLocation: {"file":"packages/estate/drafts/src/remote.ts","line":1052,"column":9},
+      sourceLocation: {"file":"packages/estate/drafts/src/remote.ts","line":1275,"column":9},
     },
     {
       id: '@melite/estate-drafts#bench/group',
@@ -377,7 +377,7 @@ export const TYPERT = {
         typeSymbol: '@melite/estate-drafts/types#BenchStageRow',
         create: _melite_estate_drafts_bench_group_result$schema,
       },
-      sourceLocation: {"file":"packages/estate/drafts/src/remote.ts","line":1268,"column":9},
+      sourceLocation: {"file":"packages/estate/drafts/src/remote.ts","line":1510,"column":9},
     },
     {
       id: '@melite/estate-drafts#bench/patch',
@@ -414,7 +414,7 @@ export const TYPERT = {
         typeSymbol: '@melite/estate-drafts/types#BenchPatchRow',
         create: _melite_estate_drafts_bench_patch_result$schema,
       },
-      sourceLocation: {"file":"packages/estate/drafts/src/remote.ts","line":1199,"column":9},
+      sourceLocation: {"file":"packages/estate/drafts/src/remote.ts","line":1439,"column":9},
     },
     {
       id: '@melite/estate-drafts#bench/remove-stage',
@@ -451,7 +451,7 @@ export const TYPERT = {
         typeSymbol: '@melite/estate-drafts/types#BenchStageRow',
         create: _melite_estate_drafts_bench_remove_stage_result$schema,
       },
-      sourceLocation: {"file":"packages/estate/drafts/src/remote.ts","line":1219,"column":9},
+      sourceLocation: {"file":"packages/estate/drafts/src/remote.ts","line":1459,"column":9},
     },
     {
       id: '@melite/estate-drafts#bench/reorder',
@@ -488,7 +488,7 @@ export const TYPERT = {
         typeSymbol: '@melite/estate-drafts/types#BenchReorderRow',
         create: _melite_estate_drafts_bench_reorder_result$schema,
       },
-      sourceLocation: {"file":"packages/estate/drafts/src/remote.ts","line":1253,"column":9},
+      sourceLocation: {"file":"packages/estate/drafts/src/remote.ts","line":1493,"column":9},
     },
     {
       id: '@melite/estate-drafts#bench/rewire',
@@ -525,7 +525,7 @@ export const TYPERT = {
         typeSymbol: '@melite/estate-drafts/types#BenchRewireRow',
         create: _melite_estate_drafts_bench_rewire_result$schema,
       },
-      sourceLocation: {"file":"packages/estate/drafts/src/remote.ts","line":1242,"column":9},
+      sourceLocation: {"file":"packages/estate/drafts/src/remote.ts","line":1482,"column":9},
     },
     {
       id: '@melite/estate-drafts#bench/subscribe',
@@ -552,7 +552,7 @@ export const TYPERT = {
         typeSymbol: '@melite/estate-drafts/types#BenchGetRow',
         create: _melite_estate_drafts_bench_subscribe_result$schema,
       },
-      sourceLocation: {"file":"packages/estate/drafts/src/remote.ts","line":1070,"column":10},
+      sourceLocation: {"file":"packages/estate/drafts/src/remote.ts","line":1293,"column":10},
     },
     {
       id: '@melite/estate-drafts#bench/undo',
@@ -589,7 +589,7 @@ export const TYPERT = {
         typeSymbol: '@melite/estate-drafts/types#BenchUndoRow',
         create: _melite_estate_drafts_bench_undo_result$schema,
       },
-      sourceLocation: {"file":"packages/estate/drafts/src/remote.ts","line":1296,"column":9},
+      sourceLocation: {"file":"packages/estate/drafts/src/remote.ts","line":1542,"column":9},
     },
     {
       id: '@melite/estate-drafts#bench/ungroup',
@@ -626,7 +626,7 @@ export const TYPERT = {
         typeSymbol: '@melite/estate-drafts/types#BenchStageRow',
         create: _melite_estate_drafts_bench_ungroup_result$schema,
       },
-      sourceLocation: {"file":"packages/estate/drafts/src/remote.ts","line":1282,"column":9},
+      sourceLocation: {"file":"packages/estate/drafts/src/remote.ts","line":1526,"column":9},
     },
     {
       id: '@melite/estate-drafts#drafts/get',
@@ -653,7 +653,7 @@ export const TYPERT = {
         typeSymbol: '@melite/estate-drafts/types#DraftGetRow',
         create: _melite_estate_drafts_drafts_get_result$schema,
       },
-      sourceLocation: {"file":"packages/estate/drafts/src/remote.ts","line":533,"column":9},
+      sourceLocation: {"file":"packages/estate/drafts/src/remote.ts","line":599,"column":9},
     },
     {
       id: '@melite/estate-drafts#drafts/list',
@@ -670,7 +670,7 @@ export const TYPERT = {
         typeSymbol: '@melite/estate-drafts/types#DraftListResult',
         create: _melite_estate_drafts_drafts_list_result$schema,
       },
-      sourceLocation: {"file":"packages/estate/drafts/src/remote.ts","line":527,"column":9},
+      sourceLocation: {"file":"packages/estate/drafts/src/remote.ts","line":593,"column":9},
     },
     {
       id: '@melite/estate-drafts#drafts/patch',
@@ -727,7 +727,7 @@ export const TYPERT = {
         typeSymbol: '@melite/estate-drafts/types#DraftPatchRow',
         create: _melite_estate_drafts_drafts_patch_result$schema,
       },
-      sourceLocation: {"file":"packages/estate/drafts/src/remote.ts","line":620,"column":9},
+      sourceLocation: {"file":"packages/estate/drafts/src/remote.ts","line":686,"column":9},
     },
   ],
   model: {
@@ -913,10 +913,7 @@ export const TYPERT = {
         ]
       },
       {
-        "description": "The drafts Remote owner: list/get over the storage domain.",
-        "summary": "The drafts Remote owner: list/get over the storage domain.",
         "tags": [],
-        "jsDoc": "/** The drafts Remote owner: list/get over the storage domain. */",
         "key": "draftsRemote",
         "exportName": "DraftsRemoteService",
         "members": [
@@ -959,8 +956,8 @@ export const TYPERT = {
             "kind": "method",
             "name": "patch",
             "signature": "async patch( draftId: string, stageId: string, patch: Record<string, unknown>, expectRev: number | null, signal: AbortSignal, ): Promise<DraftPatchRow>",
-            "summary": "The patch arm the adapter above delegates to.",
-            "jsDoc": "/** The patch arm the adapter above delegates to. */"
+            "summary": "The patch arm the adapter above delegates to — one write transaction on the draft's own key, shared with the bench verbs (the round-14 race audit's R3: the author arm's spread-copy of the log forked against their in-place push).",
+            "jsDoc": "/** The patch arm the adapter above delegates to — one write\n *  transaction on the draft's own key, shared with the bench\n *  verbs (the round-14 race audit's R3: the author arm's\n *  spread-copy of the log forked against their in-place push). */"
           }
         ],
         "types": [
@@ -996,6 +993,11 @@ export const TYPERT = {
         "description": "A bench write landed. Emitted after every successful bench verb (and after the drafts-patch door's bench-shaped write).",
         "summary": "A bench write landed.",
         "tags": [
+          {
+            "name": "mode",
+            "comment": "emit",
+            "text": "@mode emit\n     *"
+          },
           {
             "name": "param",
             "argument": "session",
@@ -1003,8 +1005,9 @@ export const TYPERT = {
             "text": "@param session - the bench session whose doc changed."
           }
         ],
-        "jsDoc": "/**\n * A bench write landed. Emitted after every successful bench verb\n * (and after the drafts-patch door's bench-shaped write).\n * @param session - the bench session whose doc changed.\n */",
+        "jsDoc": "/**\n * A bench write landed. Emitted after every successful bench verb\n * (and after the drafts-patch door's bench-shaped write).\n * @mode emit\n * @param session - the bench session whose doc changed.\n */",
         "name": "bench.changed",
+        "mode": "emit",
         "signature": "'bench.changed'(session: string): void"
       }
     ],