@objectstack/metadata-fs 17.0.0-rc.5 → 17.0.0

package/dist/index.js

@@ -210,8 +210,6 @@ var FileSystemRepository = class {
     this.heads = /* @__PURE__ */ new Map();
     /** Next seq counter, hydrated from the log on `start()`. */
     this.nextSeq = 1;
-    /** Paths we wrote ourselves; suppress the resulting chokidar event. */
-    this.selfWrites = /* @__PURE__ */ new Set();
     this.watcher = null;
     this.started = false;
     this.org = opts.org;
@@ -222,15 +220,42 @@ var FileSystemRepository = class {
     this.log = new JsonlLog(logFile(this.layout));
   }
   // ── Lifecycle ───────────────────────────────────────────────────────
+  /**
+   * Attach the repository. **Creates nothing on disk** (#7000).
+   *
+   * Attaching is not a write. `start()` used to `mkdir` both the root and
+   * `<root>/.objectstack/.log` unconditionally, which meant every read-only
+   * boot that merely attaches a repository left a skeleton behind — most
+   * visibly `os migrate plan`, a declared dry run, on a project that has
+   * never been started. That is the same property #6743 ruled on for
+   * `.objectstack/data/`: a dry run leaves nothing behind, and the existence
+   * of `.objectstack/` has to stay a usable "this project has been started"
+   * signal.
+   *
+   * Every read path below already treats a missing root as an empty
+   * repository (`scanHeads` swallows ENOENT, `JsonlLog` guards on
+   * `existsSync`, `get` guards on `existsSync`), so the root is materialized
+   * by `ensureRoot()` on the first write instead.
+   */
   async start() {
     if (this.started) return;
     this.started = true;
-    await fs2.mkdir(this.layout.root, { recursive: true });
-    await fs2.mkdir(logDir(this.layout), { recursive: true });
     await this.scanHeads();
     const highest = await this.log.highestSeq();
     this.nextSeq = highest + 1;
-    if (!this.disableWatch) this.startWatcher();
+    if (!this.disableWatch && existsSync2(this.layout.root)) this.startWatcher();
+  }
+  /**
+   * Bring the repository root into existence. Called by every write path
+   * immediately before it touches the disk — `start()` deliberately does not
+   * create it (#7000), so this is the single seam where the root appears.
+   *
+   * It is also where a watcher that `start()` could not arm (missing root)
+   * gets armed, so "external edits are detected" survives the change.
+   */
+  async ensureRoot() {
+    await fs2.mkdir(this.layout.root, { recursive: true });
+    if (this.started && !this.disableWatch && !this.watcher) this.startWatcher();
   }
   async close() {
     if (this.watcher) {
@@ -348,13 +373,10 @@ var FileSystemRepository = class {
       const seq = this.nextSeq++;
       const ts = this.now().toISOString();
       const file = itemPath(this.layout, ref.type, ref.name);
+      await this.ensureRoot();
       await fs2.mkdir(typeDir(this.layout, ref.type), { recursive: true });
-      this.selfWrites.add(file);
-      try {
-        await writeJsonAtomic(file, spec);
-      } finally {
-        setTimeout(() => this.selfWrites.delete(file), 200);
-      }
+      await writeJsonAtomic(file, spec);
+      this.trackWrittenPath(file);
       this.heads.set(key, hash);
       const evt = {
         seq,
@@ -394,13 +416,14 @@ var FileSystemRepository = class {
         throw new ConflictError(ref, opts.parentVersion, currentHead);
       }
       const file = itemPath(this.layout, ref.type, ref.name);
-      this.selfWrites.add(file);
+      await this.ensureRoot();
+      this.heads.delete(key);
       try {
         if (existsSync2(file)) await fs2.unlink(file);
-      } finally {
-        setTimeout(() => this.selfWrites.delete(file), 200);
+      } catch (err) {
+        if (currentHead !== null) this.heads.set(key, currentHead);
+        throw err;
       }
-      this.heads.delete(key);
       const seq = this.nextSeq++;
       const ts = this.now().toISOString();
       const evt = {
@@ -469,10 +492,58 @@ var FileSystemRepository = class {
     }
     return last;
   }
+  /**
+   * Register a path this repository just wrote with the watcher (#7282).
+   *
+   * chokidar's initial scan is asynchronous, and every write path here can be
+   * running **while it is still walking the tree** — `start()` arms the watcher
+   * and the caller may `put()` on the next tick, and `ensureRoot()` arms it in
+   * the middle of the very first write. With `usePolling` that combination has
+   * a permanently-blinding interleaving, measured on chokidar 5 with this
+   * repository's own options:
+   *
+   *   1. chokidar reads `<root>/<type>/` and finds it EMPTY — the atomic
+   *      `rename` in `writeJsonAtomic` has not landed yet.
+   *   2. the rename lands; the directory's mtime changes.
+   *   3. chokidar calls `watchFile()` on that directory, and libuv takes its
+   *      polling baseline stat — which already reflects step 2.
+   *
+   * From then on the directory's stat never changes again, so no poll ever
+   * fires for it, `_handleRead` never re-runs, the item file is never added to
+   * the watched set, and no per-file watcher is ever created. chokidar emits
+   * neither `add` nor `change` for that path **for the life of the process** —
+   * `getWatched()` reports the type directory as `[]` forever while the file
+   * sits in it. That is the whole of #7282: the four merge-queue ejections all
+   * waited out their deadlines (20s, then 25541ms against 25s) on an event that
+   * was never going to be delivered, which is why widening the deadline and
+   * widening the pre-edit sleep both changed nothing, and why lowering
+   * `interval` would change nothing either — a shorter poll re-compares against
+   * the same unchanged directory stat.
+   *
+   * The window is exactly "files that exist at baseline time but were absent
+   * from the snapshot read a moment earlier", and the only writer that can be
+   * inside it is us. So we close it at the source: tell the watcher explicitly
+   * about every path we create, instead of hoping its scan happened to see it.
+   *
+   * `add()` is idempotent here — `_handleFile` returns early when the parent
+   * directory already tracks the basename — and it emits nothing, because
+   * chokidar treats an explicit `add()` as an initial add and `ignoreInitial`
+   * is set. Its effect is the one we need: `_watchWithNodeFs` registers the
+   * basename with the parent directory (without which chokidar drops `change`
+   * events for the file) and starts the per-file poll.
+   */
+  trackWrittenPath(file) {
+    const w = this.watcher;
+    if (!w || w.closed) return;
+    w.add(file);
+  }
   startWatcher() {
-    const w = chokidar.watch(this.layout.root, {
-      ignored: [/(^|[\\/])\../],
-      // skip dotfiles incl. .objectstack
+    const root = this.layout.root;
+    const w = chokidar.watch(root, {
+      // Skip dotfiles under the root — including the repository's own
+      // `.objectstack/` bookkeeping subtree — matched on the path RELATIVE
+      // to the watch root (#7150). See `isIgnoredWatchPath`.
+      ignored: (p) => isIgnoredWatchPath(root, p),
       ignoreInitial: true,
       depth: 2,
       awaitWriteFinish: { stabilityThreshold: 50, pollInterval: 20 },
@@ -488,8 +559,55 @@ var FileSystemRepository = class {
     w.on("unlink", (p) => void this.handleFsChange(p, "unlink"));
     this.watcher = w;
   }
+  /**
+   * Translate a watcher event into a `MetadataEvent`, or drop it.
+   *
+   * ## Self-writes are suppressed by content identity, never by a clock (#7335)
+   *
+   * This used to open with `if (this.selfWrites.has(absPath)) return;` — a
+   * `Set` that `put()`/`delete()` added the path to and a `setTimeout(…, 200)`
+   * cleared. That check discarded **every** event for a recently-written path
+   * without ever looking at what the watcher had actually observed, which is
+   * the whole defect: with `usePolling`, chokidar compares state once per
+   * `interval`, so our write and an external edit landing between two ticks
+   * are delivered as **one** event carrying the *external* content. Dropping
+   * it on a wall clock destroyed the only notification that edit would ever
+   * produce.
+   *
+   * Measured on `origin/main` @ `69fde55`, 40 iterations, poll phase
+   * randomised so the delivery lag samples `[0, interval)` uniformly:
+   *
+   *   delivery lag < 200ms  →  7 runs  →  external edit SWALLOWED, every time
+   *   delivery lag > 200ms  →  33 runs →  external edit delivered, every time
+   *
+   * A perfect split on the wall-clock boundary, and the reason earlier
+   * instrumentation saw 0/360: a *fixed* pre-edit sleep phase-locks the poll,
+   * pinning the lag (measured: 519–585ms across 25 runs) safely outside the
+   * window. Nothing about the window was rare — it was unsampled.
+   *
+   * What remains is the check that was already doing the real work one step
+   * down, and it needs no timer because it compares the content the watcher
+   * **read** against the index:
+   *
+   *   - `add`/`change` — `currentHead === hash` drops the event when the bytes
+   *     on disk are the bytes we last published. `put()` sets that head in the
+   *     same continuation as its `rename`, and `awaitWriteFinish` holds the
+   *     event for a further `stabilityThreshold`, so it is never late.
+   *   - `unlink` — `!currentHead` drops the event when the index already
+   *     agrees the item is gone. `delete()` retires the head *before* it
+   *     unlinks, precisely because this face gets no `awaitWriteFinish` delay.
+   *
+   * Both faces are pinned together in `test/self-write-suppression.test.ts`.
+   *
+   * Note the deliberate limit: identity is judged on what round-trips through
+   * the file, so a spec whose in-memory form does not (a `Date`, which
+   * canonicalises to `{}` in memory but to an ISO string once written and
+   * re-read) is republished as an external `update`. That predates this change
+   * and is independent of it — such a spec already fails `put().version ===
+   * get().hash`, and the 200ms window never covered it either, expiring some
+   * 360ms before the event it would have had to catch.
+   */
   async handleFsChange(absPath, kind) {
-    if (this.selfWrites.has(absPath)) return;
     const parsed = parseItemPath(this.layout, absPath);
     if (!parsed) return;
     const ref = {
@@ -540,6 +658,11 @@ var FileSystemRepository = class {
     });
   }
 };
+function isIgnoredWatchPath(root, absPath) {
+  const rel = path3.relative(root, absPath);
+  if (rel === "" || rel.startsWith("..")) return false;
+  return rel.split(/[\\/]/).some((segment) => segment.startsWith("."));
+}
 async function readJson(file) {
   try {
     const text = await fs2.readFile(file, "utf8");

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/repository.ts","../src/layout.ts","../src/jsonl-log.ts","../src/sync.ts","../src/watch-iterable.ts"],"sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\n/**\n * `FileSystemRepository` — Node-only implementation of\n * `MetadataRepository` backed by JSON files plus a JSONL change log.\n *\n * See `README.md` for the on-disk layout and ADR-0008 §10 PR-4 for the\n * design rationale.\n *\n * Invariants\n * ──────────\n *   - All `put` / `delete` ops serialize per-key via `KeyedMutex`.\n *   - The change-log JSONL is the durable source of `seq`. On boot we\n *     scan the log to learn the next seq value.\n *   - Body files (`<type>/<name>.json`) are the source of truth; the\n *     log is a denormalised history index.\n *   - chokidar-driven external edits are translated into MetadataEvents\n *     by hashing the new content and comparing to the last-known hash.\n */\n\nimport fs from 'node:fs/promises';\nimport { existsSync } from 'node:fs';\nimport path from 'node:path';\nimport type { FSWatcher } from 'chokidar';\nimport chokidar from 'chokidar';\nimport {\n  type MetadataRepository,\n  type MetaRef,\n  type MetadataItem,\n  type MetadataItemHeader,\n  type MetadataEvent,\n  type PutOptions,\n  type PutResult,\n  type DeleteOptions,\n  type DeleteResult,\n  type ListFilter,\n  type WatchFilter,\n  type HistoryOptions,\n  type MetadataType,\n  hashSpec,\n  ConflictError,\n  refKey,\n} from '@objectstack/metadata-core';\nimport {\n  type FsLayout,\n  itemPath,\n  parseItemPath,\n  typeDir,\n  logDir,\n  logFile,\n} from './layout.js';\nimport { JsonlLog } from './jsonl-log.js';\nimport { KeyedMutex, createBroker, type EventBroker } from './sync.js';\nimport { createWatchIterable } from './watch-iterable.js';\n\nexport interface FileSystemRepositoryOptions {\n  /** Absolute path to the metadata root directory. */\n  root: string;\n  /** Tenant/org. */\n  org: string;\n  /** Identity reported in events that originate from external FS edits. */\n  fsActor?: string;\n  /** Disable chokidar watcher (e.g. for read-only contexts). */\n  disableWatch?: boolean;\n  /** Optional clock injection for deterministic tests. */\n  now?: () => Date;\n}\n\nconst matchRefFilter = (\n  ref: MetaRef,\n  filter: { org?: string; type?: MetadataType; name?: string },\n): boolean => {\n  if (filter.org && filter.org !== ref.org) return false;\n  if (filter.type && filter.type !== ref.type) return false;\n  if (filter.name && filter.name !== ref.name) return false;\n  return true;\n};\n\nconst matchEvent = (evt: MetadataEvent, filter: WatchFilter): boolean => matchRefFilter(evt.ref, filter);\n\nexport class FileSystemRepository implements MetadataRepository {\n  private readonly layout: FsLayout;\n  private readonly org: string;\n  private readonly fsActor: string;\n  private readonly disableWatch: boolean;\n  private readonly now: () => Date;\n  private readonly log: JsonlLog;\n  private readonly mutex = new KeyedMutex();\n  private readonly broker: EventBroker = createBroker(matchEvent);\n\n  /** In-memory index: refKey → current hash (HEAD). */\n  private readonly heads = new Map<string, string>();\n  /** Next seq counter, hydrated from the log on `start()`. */\n  private nextSeq = 1;\n  /** Paths we wrote ourselves; suppress the resulting chokidar event. */\n  private readonly selfWrites = new Set<string>();\n  private watcher: FSWatcher | null = null;\n  private started = false;\n\n  constructor(opts: FileSystemRepositoryOptions) {\n    this.org = opts.org;\n    this.fsActor = opts.fsActor ?? 'fs';\n    this.disableWatch = opts.disableWatch ?? false;\n    this.now = opts.now ?? (() => new Date());\n    this.layout = { root: path.resolve(opts.root) };\n    this.log = new JsonlLog(logFile(this.layout));\n  }\n\n  // ── Lifecycle ───────────────────────────────────────────────────────\n\n  async start(): Promise<void> {\n    if (this.started) return;\n    this.started = true;\n    await fs.mkdir(this.layout.root, { recursive: true });\n    await fs.mkdir(logDir(this.layout), { recursive: true });\n\n    // 1) Scan body files to build the head index.\n    await this.scanHeads();\n\n    // 2) Hydrate nextSeq from the existing log.\n    const highest = await this.log.highestSeq();\n    this.nextSeq = highest + 1;\n\n    // 3) Start the watcher (unless disabled).\n    if (!this.disableWatch) this.startWatcher();\n  }\n\n  async close(): Promise<void> {\n    if (this.watcher) {\n      await this.watcher.close();\n      this.watcher = null;\n    }\n    this.started = false;\n  }\n\n  // ── Read API ────────────────────────────────────────────────────────\n\n  async get(ref: MetaRef): Promise<MetadataItem | null> {\n    this.assertScope(ref);\n    const file = itemPath(this.layout, ref.type, ref.name);\n    if (!existsSync(file)) return null;\n    const body = await readJson(file);\n    if (!body) return null;\n    const hash = hashSpec(body);\n    if (ref.version && ref.version !== hash) return null;\n    // Walk back through the log to populate parent/authoredBy/seq.\n    const meta = await this.findMetaForHash(ref, hash);\n    return {\n      ref: { ...ref, version: undefined },\n      body: body as Record<string, unknown>,\n      hash,\n      parentHash: meta?.parentHash ?? null,\n      authoredBy: meta?.actor ?? this.fsActor,\n      authoredAt: meta?.ts ?? new Date(0).toISOString(),\n      message: meta?.message,\n      seq: meta?.seq ?? 0,\n    };\n  }\n\n  async getByHash(ref: MetaRef, hash: string): Promise<MetadataItem | null> {\n    // FS repo stores only HEAD bodies on disk; the JSONL log records\n    // events (hashes) but not historical bodies. Resolve only if the\n    // requested hash matches HEAD.\n    const head = await this.get(ref);\n    if (!head || head.hash !== hash) return null;\n    return head;\n  }\n\n  async *list(filter: ListFilter): AsyncIterable<MetadataItemHeader> {\n    const limit = filter.limit ?? Infinity;\n    let yielded = 0;\n    for (const [key, hash] of this.heads) {\n      const ref = parseRefKey(key);\n      if (!ref) continue;\n      if (!matchRefFilter(ref, filter)) continue;\n      if (filter.nameContains && !ref.name.includes(filter.nameContains)) continue;\n      const meta = await this.findMetaForHash(ref, hash);\n      const header: MetadataItemHeader = {\n        ref: { ...ref, version: undefined },\n        hash,\n        parentHash: meta?.parentHash ?? null,\n        authoredBy: meta?.actor ?? this.fsActor,\n        authoredAt: meta?.ts ?? new Date(0).toISOString(),\n        message: meta?.message,\n        seq: meta?.seq ?? 0,\n      };\n      yield header;\n      if (++yielded >= limit) return;\n    }\n  }\n\n  async *history(ref: MetaRef, opts: HistoryOptions = {}): AsyncIterable<MetadataEvent> {\n    this.assertScope(ref);\n    const since = opts.sinceSeq ?? -1;\n    const limit = opts.limit ?? Infinity;\n    let yielded = 0;\n    for await (const evt of this.log.readAll()) {\n      if (evt.seq <= since) continue;\n      if (evt.ref.type !== ref.type || evt.ref.name !== ref.name) continue;\n      if (evt.ref.org !== ref.org) continue;\n      yield evt;\n      if (++yielded >= limit) return;\n    }\n  }\n\n  watch(filter: WatchFilter, since?: number): AsyncIterable<MetadataEvent> {\n    // Eagerly snapshot the existing log for replay; new events route via broker.\n    const replay: MetadataEvent[] = [];\n    const promise = (async () => {\n      for await (const evt of this.log.readAll()) {\n        if (matchEvent(evt, filter)) replay.push(evt);\n      }\n    })();\n    // We must await replay before returning, but the public API is\n    // sync-returning AsyncIterable. Wrap in a deferred iterable.\n    return deferredIterable(promise.then(() =>\n      createWatchIterable({\n        filter,\n        since,\n        replay,\n        broker: this.broker,\n        matches: matchEvent,\n        branchKeyOf: (e) => e.ref.org,\n      }),\n    ));\n  }\n\n  // ── Write API ───────────────────────────────────────────────────────\n\n  put(ref: MetaRef, spec: unknown, opts: PutOptions): Promise<PutResult> {\n    this.assertScope(ref);\n    return this.mutex.run(refKey(ref), async () => {\n      const key = refKey(ref);\n      const currentHead = this.heads.get(key) ?? null;\n      if ((opts.parentVersion ?? null) !== currentHead) {\n        throw new ConflictError(ref, opts.parentVersion ?? null, currentHead);\n      }\n      const hash = hashSpec(spec);\n      if (currentHead === hash) {\n        // No-op write — same content.\n        const meta = await this.findMetaForHash(ref, hash);\n        return {\n          version: hash,\n          seq: meta?.seq ?? 0,\n          item: {\n            ref: { ...ref, version: undefined },\n            body: spec as Record<string, unknown>,\n            hash,\n            parentHash: meta?.parentHash ?? null,\n            authoredBy: meta?.actor ?? this.fsActor,\n            authoredAt: meta?.ts ?? this.now().toISOString(),\n            message: meta?.message,\n            seq: meta?.seq ?? 0,\n          },\n        };\n      }\n\n      const seq = this.nextSeq++;\n      const ts = this.now().toISOString();\n      const file = itemPath(this.layout, ref.type, ref.name);\n      await fs.mkdir(typeDir(this.layout, ref.type), { recursive: true });\n      this.selfWrites.add(file);\n      try {\n        await writeJsonAtomic(file, spec);\n      } finally {\n        // Hold the suppression until chokidar has had a chance to emit;\n        // we keep it in selfWrites for one debounce tick.\n        setTimeout(() => this.selfWrites.delete(file), 200);\n      }\n      this.heads.set(key, hash);\n\n      const evt: MetadataEvent = {\n        seq,\n        op: currentHead ? 'update' : 'create',\n        ref: { ...ref, version: undefined },\n        hash,\n        parentHash: currentHead,\n        actor: opts.actor,\n        message: opts.message,\n        ts,\n        source: opts.source ?? 'fs',\n      };\n      await this.log.append(evt);\n      this.broker.publish(evt);\n\n      return {\n        version: hash,\n        seq,\n        item: {\n          ref: { ...ref, version: undefined },\n          body: spec as Record<string, unknown>,\n          hash,\n          parentHash: currentHead,\n          authoredBy: opts.actor,\n          authoredAt: ts,\n          message: opts.message,\n          seq,\n        },\n      };\n    });\n  }\n\n  delete(ref: MetaRef, opts: DeleteOptions): Promise<DeleteResult> {\n    this.assertScope(ref);\n    return this.mutex.run(refKey(ref), async () => {\n      const key = refKey(ref);\n      const currentHead = this.heads.get(key) ?? null;\n      if (currentHead !== opts.parentVersion) {\n        throw new ConflictError(ref, opts.parentVersion, currentHead);\n      }\n      const file = itemPath(this.layout, ref.type, ref.name);\n      this.selfWrites.add(file);\n      try {\n        if (existsSync(file)) await fs.unlink(file);\n      } finally {\n        setTimeout(() => this.selfWrites.delete(file), 200);\n      }\n      this.heads.delete(key);\n      const seq = this.nextSeq++;\n      const ts = this.now().toISOString();\n      const evt: MetadataEvent = {\n        seq,\n        op: 'delete',\n        ref: { ...ref, version: undefined },\n        hash: null,\n        parentHash: currentHead,\n        actor: opts.actor,\n        message: opts.message,\n        ts,\n        source: opts.source ?? 'fs',\n      };\n      await this.log.append(evt);\n      this.broker.publish(evt);\n      return { seq };\n    });\n  }\n\n  // ── Internals ───────────────────────────────────────────────────────\n\n  private assertScope(ref: MetaRef): void {\n    if (ref.org !== this.org) {\n      throw new Error(\n        `FileSystemRepository scope mismatch: expected org=${this.org}, got org=${ref.org}`,\n      );\n    }\n  }\n\n  private async scanHeads(): Promise<void> {\n    this.heads.clear();\n    // Walk one level deep: <root>/<type>/<name>.json\n    let entries: import('node:fs').Dirent[] = [];\n    try {\n      entries = await fs.readdir(this.layout.root, { withFileTypes: true });\n    } catch {\n      return;\n    }\n    for (const entry of entries) {\n      if (!entry.isDirectory()) continue;\n      if (entry.name.startsWith('.')) continue;\n      const type = entry.name;\n      const dir = path.join(this.layout.root, type);\n      let files: string[] = [];\n      try {\n        files = await fs.readdir(dir);\n      } catch {\n        continue;\n      }\n      for (const file of files) {\n        if (!file.endsWith('.json')) continue;\n        const name = file.slice(0, -'.json'.length);\n        const ref: MetaRef = {\n          org: this.org,\n          type: type as MetadataType,\n          name,\n        };\n        const body = await readJson(path.join(dir, file));\n        if (!body) continue;\n        this.heads.set(refKey(ref), hashSpec(body));\n      }\n    }\n  }\n\n  private async findMetaForHash(\n    ref: MetaRef,\n    hash: string,\n  ): Promise<MetadataEvent | null> {\n    let last: MetadataEvent | null = null;\n    for await (const evt of this.log.readAll()) {\n      if (evt.ref.type !== ref.type || evt.ref.name !== ref.name) continue;\n      if (evt.ref.org !== ref.org) continue;\n      if (evt.hash === hash) last = evt;\n    }\n    return last;\n  }\n\n  private startWatcher(): void {\n    const w = chokidar.watch(this.layout.root, {\n      ignored: [/(^|[\\\\/])\\../], // skip dotfiles incl. .objectstack\n      ignoreInitial: true,\n      depth: 2,\n      awaitWriteFinish: { stabilityThreshold: 50, pollInterval: 20 },\n      // Use polling to avoid `fs.watch` EMFILE on macOS / busy dev hosts.\n      // The depth-2 recursion would otherwise wire native watches across\n      // the entire customization tree.\n      usePolling: true,\n      interval: 1000,\n      binaryInterval: 2000,\n    });\n    w.on('add', (p) => void this.handleFsChange(p, 'add'));\n    w.on('change', (p) => void this.handleFsChange(p, 'change'));\n    w.on('unlink', (p) => void this.handleFsChange(p, 'unlink'));\n    this.watcher = w;\n  }\n\n  private async handleFsChange(absPath: string, kind: 'add' | 'change' | 'unlink'): Promise<void> {\n    if (this.selfWrites.has(absPath)) return; // Suppress our own writes.\n    const parsed = parseItemPath(this.layout, absPath);\n    if (!parsed) return;\n    const ref: MetaRef = {\n      org: this.org,\n      type: parsed.type as MetadataType,\n      name: parsed.name,\n    };\n    const key = refKey(ref);\n    await this.mutex.run(key, async () => {\n      if (kind === 'unlink') {\n        const currentHead = this.heads.get(key) ?? null;\n        if (!currentHead) return;\n        this.heads.delete(key);\n        const seq = this.nextSeq++;\n        const evt: MetadataEvent = {\n          seq,\n          op: 'delete',\n          ref: { ...ref, version: undefined },\n          hash: null,\n          parentHash: currentHead,\n          actor: this.fsActor,\n          ts: this.now().toISOString(),\n          source: 'fs',\n        };\n        await this.log.append(evt);\n        this.broker.publish(evt);\n        return;\n      }\n      const body = await readJson(absPath);\n      if (!body) return;\n      const hash = hashSpec(body);\n      const currentHead = this.heads.get(key) ?? null;\n      if (currentHead === hash) return; // No content change.\n      this.heads.set(key, hash);\n      const seq = this.nextSeq++;\n      const evt: MetadataEvent = {\n        seq,\n        op: currentHead ? 'update' : 'create',\n        ref: { ...ref, version: undefined },\n        hash,\n        parentHash: currentHead,\n        actor: this.fsActor,\n        ts: this.now().toISOString(),\n        source: 'fs',\n      };\n      await this.log.append(evt);\n      this.broker.publish(evt);\n    });\n  }\n}\n\n// ── Utilities ─────────────────────────────────────────────────────────\n\nasync function readJson(file: string): Promise<unknown | null> {\n  try {\n    const text = await fs.readFile(file, 'utf8');\n    return JSON.parse(text);\n  } catch {\n    return null;\n  }\n}\n\nasync function writeJsonAtomic(file: string, body: unknown): Promise<void> {\n  const tmp = `${file}.${process.pid}.${Date.now()}.tmp`;\n  await fs.writeFile(tmp, JSON.stringify(body, null, 2) + '\\n', 'utf8');\n  await fs.rename(tmp, file);\n}\n\nfunction parseRefKey(key: string): MetaRef | null {\n  const parts = key.split('/');\n  if (parts.length !== 3) return null;\n  return {\n    org: parts[0]!,\n    type: parts[1]! as MetadataType,\n    name: parts[2]!,\n  };\n}\n\n/**\n * Wrap a Promise<AsyncIterable<T>> as a sync-returning AsyncIterable<T>.\n * The first `.next()` awaits the promise.\n */\nfunction deferredIterable<T>(promise: Promise<AsyncIterable<T>>): AsyncIterable<T> {\n  return {\n    [Symbol.asyncIterator]() {\n      let inner: AsyncIterator<T> | null = null;\n      return {\n        async next() {\n          if (!inner) {\n            const iterable = await promise;\n            inner = iterable[Symbol.asyncIterator]();\n          }\n          return inner.next();\n        },\n        async return(value?: unknown) {\n          if (!inner) {\n            const iterable = await promise;\n            inner = iterable[Symbol.asyncIterator]();\n          }\n          if (inner.return) return inner.return(value);\n          return { value: undefined, done: true };\n        },\n      } as AsyncIterator<T>;\n    },\n  };\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\n/**\n * Disk layout helpers — see ADR-0008 §10 PR-4 / packages/metadata-fs README.\n *\n *   <root>/<type>/<name>.json     — canonical body\n *   <root>/.objectstack/.log/main.jsonl  — append-only change log\n */\n\nimport path from 'node:path';\nimport type { MetadataType } from '@objectstack/metadata-core';\n\nexport interface FsLayout {\n  /** Absolute path to the metadata root. */\n  root: string;\n}\n\nexport function itemPath(layout: FsLayout, type: MetadataType, name: string): string {\n  return path.join(layout.root, type, `${name}.json`);\n}\n\nexport function typeDir(layout: FsLayout, type: MetadataType): string {\n  return path.join(layout.root, type);\n}\n\nexport function logDir(layout: FsLayout): string {\n  return path.join(layout.root, '.objectstack', '.log');\n}\n\nexport function logFile(layout: FsLayout): string {\n  // Single change log per filesystem root (branching is a Git concern,\n  // not a metadata-layer concern).\n  return path.join(logDir(layout), `main.jsonl`);\n}\n\n/** Parse a path like \".../view/case_grid.json\" into {type, name}. */\nexport function parseItemPath(\n  layout: FsLayout,\n  absPath: string,\n): { type: string; name: string } | null {\n  const rel = path.relative(layout.root, absPath);\n  if (rel.startsWith('..') || rel.startsWith('.objectstack')) return null;\n  const segments = rel.split(path.sep);\n  if (segments.length !== 2) return null;\n  const type = segments[0]!;\n  const file = segments[1]!;\n  if (!file.endsWith('.json')) return null;\n  const name = file.slice(0, -'.json'.length);\n  return { type, name };\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\n/**\n * Append-only JSONL change log writer / reader. Each line is a single\n * `MetadataEvent` serialized via `JSON.stringify`.\n *\n * Durability strategy\n * ───────────────────\n *   - Append with `O_APPEND` semantics (Node's `fs.appendFile` is\n *     atomic for sub-PIPE_BUF-sized writes; events are well under 4 KiB).\n *   - Read by streaming the file line-by-line and JSON.parse-ing each.\n *   - On a corrupt line we skip and continue — the body files are the\n *     source of truth; the log is a denormalised history index.\n */\n\nimport fs from 'node:fs/promises';\nimport path from 'node:path';\nimport readline from 'node:readline';\nimport { createReadStream, existsSync } from 'node:fs';\nimport type { MetadataEvent } from '@objectstack/metadata-core';\n\nexport class JsonlLog {\n  constructor(private readonly file: string) {}\n\n  async append(evt: MetadataEvent): Promise<void> {\n    await fs.mkdir(path.dirname(this.file), { recursive: true });\n    await fs.appendFile(this.file, JSON.stringify(evt) + '\\n', 'utf8');\n  }\n\n  /** Read all events in seq order (i.e. file order). */\n  async *readAll(): AsyncIterable<MetadataEvent> {\n    if (!existsSync(this.file)) return;\n    const rl = readline.createInterface({\n      input: createReadStream(this.file, { encoding: 'utf8' }),\n      crlfDelay: Infinity,\n    });\n    try {\n      for await (const line of rl) {\n        if (!line.trim()) continue;\n        try {\n          yield JSON.parse(line) as MetadataEvent;\n        } catch {\n          // Skip corrupt line.\n        }\n      }\n    } finally {\n      rl.close();\n    }\n  }\n\n  /** Return the highest seq number in the log, or 0 if empty. */\n  async highestSeq(): Promise<number> {\n    let max = 0;\n    for await (const evt of this.readAll()) {\n      if (typeof evt.seq === 'number' && evt.seq > max) max = evt.seq;\n    }\n    return max;\n  }\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\n/**\n * Mutex / event-broker primitives used by FileSystemRepository.\n *\n * `KeyedMutex` serializes operations on the same key (refKey). The\n * broker re-uses the same manual-AsyncIterator pattern as\n * InMemoryRepository so that consumer `return()` reliably unblocks.\n */\n\nimport type { MetadataEvent, WatchFilter } from '@objectstack/metadata-core';\n\nexport class KeyedMutex {\n  private readonly tails = new Map<string, Promise<unknown>>();\n\n  async run<T>(key: string, fn: () => Promise<T>): Promise<T> {\n    const prev = this.tails.get(key) ?? Promise.resolve();\n    const next = prev.then(fn, fn);\n    // Save the swallowed-error tail so successive runs don't reject on\n    // an unrelated prior failure.\n    const swallowed = next.catch(() => undefined);\n    this.tails.set(key, swallowed);\n    try {\n      return await next;\n    } finally {\n      // Best-effort cleanup: drop the entry if nothing newer was queued.\n      if (this.tails.get(key) === swallowed) {\n        this.tails.delete(key);\n      }\n    }\n  }\n}\n\nexport interface BrokerSubscriber {\n  filter: WatchFilter;\n  closed: boolean;\n  push(evt: MetadataEvent): void;\n}\n\nexport interface EventBroker {\n  subscribe(sub: BrokerSubscriber): void;\n  unsubscribe(sub: BrokerSubscriber): void;\n  publish(evt: MetadataEvent): void;\n}\n\nexport function createBroker(matches: (evt: MetadataEvent, filter: WatchFilter) => boolean): EventBroker {\n  const subs = new Set<BrokerSubscriber>();\n  return {\n    subscribe: (s) => { subs.add(s); },\n    unsubscribe: (s) => { subs.delete(s); },\n    publish: (evt) => {\n      for (const s of subs) {\n        if (s.closed) continue;\n        if (!matches(evt, s.filter)) continue;\n        s.push(evt);\n      }\n    },\n  };\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\n/**\n * Manual `AsyncIterator` factory for `repo.watch()`. Mirrors the\n * pattern used in `@objectstack/metadata-core`'s `InMemoryRepository`:\n * async generators do NOT run `finally` when paused on an unresolved\n * `await`, so we cannot use them to implement `watch()`.\n */\n\nimport type { MetadataEvent, WatchFilter } from '@objectstack/metadata-core';\nimport { type EventBroker, type BrokerSubscriber } from './sync.js';\n\nexport interface CreateWatchIteratorArgs {\n  filter: WatchFilter;\n  since: number | undefined;\n  replay: MetadataEvent[];\n  broker: EventBroker;\n  /** Returns true if `evt.ref` matches `filter`. */\n  matches: (evt: MetadataEvent, filter: WatchFilter) => boolean;\n  branchKeyOf: (evt: MetadataEvent) => string;\n}\n\nexport function createWatchIterable(\n  args: CreateWatchIteratorArgs,\n): AsyncIterable<MetadataEvent> {\n  const queue: MetadataEvent[] = [];\n  let waiter: ((evt: IteratorResult<MetadataEvent>) => void) | null = null;\n  let closed = false;\n  const delivered = new Set<string>();\n  const evtKey = (e: MetadataEvent) => `${args.branchKeyOf(e)}#${e.seq}`;\n\n  const subscriber: BrokerSubscriber = {\n    filter: args.filter,\n    closed: false,\n    push: (evt) => {\n      if (subscriber.closed) return;\n      const k = evtKey(evt);\n      if (delivered.has(k)) return;\n      if (waiter) {\n        delivered.add(k);\n        const w = waiter;\n        waiter = null;\n        w({ value: clone(evt), done: false });\n      } else {\n        queue.push(evt);\n      }\n    },\n  };\n  args.broker.subscribe(subscriber);\n\n  const replay = [...args.replay].sort((a, b) => a.seq - b.seq);\n  let replayIdx = 0;\n\n  const drain = (): IteratorResult<MetadataEvent> | null => {\n    while (replayIdx < replay.length) {\n      const evt = replay[replayIdx++]!;\n      if (typeof args.since === 'number' && evt.seq <= args.since) continue;\n      const k = evtKey(evt);\n      if (delivered.has(k)) continue;\n      delivered.add(k);\n      return { value: clone(evt), done: false };\n    }\n    while (queue.length > 0) {\n      const evt = queue.shift()!;\n      const k = evtKey(evt);\n      if (delivered.has(k)) continue;\n      delivered.add(k);\n      return { value: clone(evt), done: false };\n    }\n    return null;\n  };\n\n  const close = (): IteratorResult<MetadataEvent> => {\n    if (!closed) {\n      closed = true;\n      subscriber.closed = true;\n      args.broker.unsubscribe(subscriber);\n      if (waiter) {\n        const w = waiter;\n        waiter = null;\n        w({ value: undefined, done: true });\n      }\n    }\n    return { value: undefined, done: true };\n  };\n\n  const iterator: AsyncIterator<MetadataEvent> = {\n    next: () => {\n      if (closed) return Promise.resolve({ value: undefined, done: true });\n      const immediate = drain();\n      if (immediate) return Promise.resolve(immediate);\n      return new Promise<IteratorResult<MetadataEvent>>((resolve) => {\n        waiter = resolve;\n      });\n    },\n    return: () => Promise.resolve(close()),\n    throw: (err) => {\n      close();\n      return Promise.reject(err);\n    },\n  };\n  return { [Symbol.asyncIterator]: () => iterator };\n}\n\nfunction clone<T>(value: T): T {\n  return JSON.parse(JSON.stringify(value)) as T;\n}\n"],"mappings":"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","names":["fs","existsSync","path","path","path","fs","existsSync","currentHead","seq","evt"]}
+{"version":3,"sources":["../src/repository.ts","../src/layout.ts","../src/jsonl-log.ts","../src/sync.ts","../src/watch-iterable.ts"],"sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\n/**\n * `FileSystemRepository` — Node-only implementation of\n * `MetadataRepository` backed by JSON files plus a JSONL change log.\n *\n * See `README.md` for the on-disk layout and ADR-0008 §10 PR-4 for the\n * design rationale.\n *\n * Invariants\n * ──────────\n *   - All `put` / `delete` ops serialize per-key via `KeyedMutex`.\n *   - The change-log JSONL is the durable source of `seq`. On boot we\n *     scan the log to learn the next seq value.\n *   - Body files (`<type>/<name>.json`) are the source of truth; the\n *     log is a denormalised history index.\n *   - chokidar-driven external edits are translated into MetadataEvents\n *     by hashing the new content and comparing to the last-known hash.\n *   - The root directory is created **on the first write, not on attach**\n *     (#7000). Attaching and reading a repository whose root does not exist\n *     is legal and answers \"empty\"; see `start()` / `ensureRoot()`.\n */\n\nimport fs from 'node:fs/promises';\nimport { existsSync } from 'node:fs';\nimport path from 'node:path';\nimport type { FSWatcher } from 'chokidar';\nimport chokidar from 'chokidar';\nimport {\n  type MetadataRepository,\n  type MetaRef,\n  type MetadataItem,\n  type MetadataItemHeader,\n  type MetadataEvent,\n  type PutOptions,\n  type PutResult,\n  type DeleteOptions,\n  type DeleteResult,\n  type ListFilter,\n  type WatchFilter,\n  type HistoryOptions,\n  type MetadataType,\n  hashSpec,\n  ConflictError,\n  refKey,\n} from '@objectstack/metadata-core';\nimport {\n  type FsLayout,\n  itemPath,\n  parseItemPath,\n  typeDir,\n  logFile,\n} from './layout.js';\nimport { JsonlLog } from './jsonl-log.js';\nimport { KeyedMutex, createBroker, type EventBroker } from './sync.js';\nimport { createWatchIterable } from './watch-iterable.js';\n\nexport interface FileSystemRepositoryOptions {\n  /** Absolute path to the metadata root directory. */\n  root: string;\n  /** Tenant/org. */\n  org: string;\n  /** Identity reported in events that originate from external FS edits. */\n  fsActor?: string;\n  /** Disable chokidar watcher (e.g. for read-only contexts). */\n  disableWatch?: boolean;\n  /** Optional clock injection for deterministic tests. */\n  now?: () => Date;\n}\n\nconst matchRefFilter = (\n  ref: MetaRef,\n  filter: { org?: string; type?: MetadataType; name?: string },\n): boolean => {\n  if (filter.org && filter.org !== ref.org) return false;\n  if (filter.type && filter.type !== ref.type) return false;\n  if (filter.name && filter.name !== ref.name) return false;\n  return true;\n};\n\nconst matchEvent = (evt: MetadataEvent, filter: WatchFilter): boolean => matchRefFilter(evt.ref, filter);\n\nexport class FileSystemRepository implements MetadataRepository {\n  private readonly layout: FsLayout;\n  private readonly org: string;\n  private readonly fsActor: string;\n  private readonly disableWatch: boolean;\n  private readonly now: () => Date;\n  private readonly log: JsonlLog;\n  private readonly mutex = new KeyedMutex();\n  private readonly broker: EventBroker = createBroker(matchEvent);\n\n  /** In-memory index: refKey → current hash (HEAD). */\n  private readonly heads = new Map<string, string>();\n  /** Next seq counter, hydrated from the log on `start()`. */\n  private nextSeq = 1;\n  private watcher: FSWatcher | null = null;\n  private started = false;\n\n  constructor(opts: FileSystemRepositoryOptions) {\n    this.org = opts.org;\n    this.fsActor = opts.fsActor ?? 'fs';\n    this.disableWatch = opts.disableWatch ?? false;\n    this.now = opts.now ?? (() => new Date());\n    this.layout = { root: path.resolve(opts.root) };\n    this.log = new JsonlLog(logFile(this.layout));\n  }\n\n  // ── Lifecycle ───────────────────────────────────────────────────────\n\n  /**\n   * Attach the repository. **Creates nothing on disk** (#7000).\n   *\n   * Attaching is not a write. `start()` used to `mkdir` both the root and\n   * `<root>/.objectstack/.log` unconditionally, which meant every read-only\n   * boot that merely attaches a repository left a skeleton behind — most\n   * visibly `os migrate plan`, a declared dry run, on a project that has\n   * never been started. That is the same property #6743 ruled on for\n   * `.objectstack/data/`: a dry run leaves nothing behind, and the existence\n   * of `.objectstack/` has to stay a usable \"this project has been started\"\n   * signal.\n   *\n   * Every read path below already treats a missing root as an empty\n   * repository (`scanHeads` swallows ENOENT, `JsonlLog` guards on\n   * `existsSync`, `get` guards on `existsSync`), so the root is materialized\n   * by `ensureRoot()` on the first write instead.\n   */\n  async start(): Promise<void> {\n    if (this.started) return;\n    this.started = true;\n\n    // 1) Scan body files to build the head index. No-op on a missing root.\n    await this.scanHeads();\n\n    // 2) Hydrate nextSeq from the existing log. No-op on a missing log.\n    const highest = await this.log.highestSeq();\n    this.nextSeq = highest + 1;\n\n    // 3) Start the watcher (unless disabled). chokidar cannot watch a path\n    //    that does not exist yet: measured on chokidar 5 with `usePolling`,\n    //    a root created AFTER `watch()` produces no events at all, ever. So\n    //    when the root is absent the watcher is armed later, by the\n    //    `ensureRoot()` call that brings the root into existence — otherwise\n    //    dropping the `mkdir` above would silently kill external-edit\n    //    detection for the whole life of the process.\n    if (!this.disableWatch && existsSync(this.layout.root)) this.startWatcher();\n  }\n\n  /**\n   * Bring the repository root into existence. Called by every write path\n   * immediately before it touches the disk — `start()` deliberately does not\n   * create it (#7000), so this is the single seam where the root appears.\n   *\n   * It is also where a watcher that `start()` could not arm (missing root)\n   * gets armed, so \"external edits are detected\" survives the change.\n   */\n  private async ensureRoot(): Promise<void> {\n    await fs.mkdir(this.layout.root, { recursive: true });\n    if (this.started && !this.disableWatch && !this.watcher) this.startWatcher();\n  }\n\n  async close(): Promise<void> {\n    if (this.watcher) {\n      await this.watcher.close();\n      this.watcher = null;\n    }\n    this.started = false;\n  }\n\n  // ── Read API ────────────────────────────────────────────────────────\n\n  async get(ref: MetaRef): Promise<MetadataItem | null> {\n    this.assertScope(ref);\n    const file = itemPath(this.layout, ref.type, ref.name);\n    if (!existsSync(file)) return null;\n    const body = await readJson(file);\n    if (!body) return null;\n    const hash = hashSpec(body);\n    if (ref.version && ref.version !== hash) return null;\n    // Walk back through the log to populate parent/authoredBy/seq.\n    const meta = await this.findMetaForHash(ref, hash);\n    return {\n      ref: { ...ref, version: undefined },\n      body: body as Record<string, unknown>,\n      hash,\n      parentHash: meta?.parentHash ?? null,\n      authoredBy: meta?.actor ?? this.fsActor,\n      authoredAt: meta?.ts ?? new Date(0).toISOString(),\n      message: meta?.message,\n      seq: meta?.seq ?? 0,\n    };\n  }\n\n  async getByHash(ref: MetaRef, hash: string): Promise<MetadataItem | null> {\n    // FS repo stores only HEAD bodies on disk; the JSONL log records\n    // events (hashes) but not historical bodies. Resolve only if the\n    // requested hash matches HEAD.\n    const head = await this.get(ref);\n    if (!head || head.hash !== hash) return null;\n    return head;\n  }\n\n  async *list(filter: ListFilter): AsyncIterable<MetadataItemHeader> {\n    const limit = filter.limit ?? Infinity;\n    let yielded = 0;\n    for (const [key, hash] of this.heads) {\n      const ref = parseRefKey(key);\n      if (!ref) continue;\n      if (!matchRefFilter(ref, filter)) continue;\n      if (filter.nameContains && !ref.name.includes(filter.nameContains)) continue;\n      const meta = await this.findMetaForHash(ref, hash);\n      const header: MetadataItemHeader = {\n        ref: { ...ref, version: undefined },\n        hash,\n        parentHash: meta?.parentHash ?? null,\n        authoredBy: meta?.actor ?? this.fsActor,\n        authoredAt: meta?.ts ?? new Date(0).toISOString(),\n        message: meta?.message,\n        seq: meta?.seq ?? 0,\n      };\n      yield header;\n      if (++yielded >= limit) return;\n    }\n  }\n\n  async *history(ref: MetaRef, opts: HistoryOptions = {}): AsyncIterable<MetadataEvent> {\n    this.assertScope(ref);\n    const since = opts.sinceSeq ?? -1;\n    const limit = opts.limit ?? Infinity;\n    let yielded = 0;\n    for await (const evt of this.log.readAll()) {\n      if (evt.seq <= since) continue;\n      if (evt.ref.type !== ref.type || evt.ref.name !== ref.name) continue;\n      if (evt.ref.org !== ref.org) continue;\n      yield evt;\n      if (++yielded >= limit) return;\n    }\n  }\n\n  watch(filter: WatchFilter, since?: number): AsyncIterable<MetadataEvent> {\n    // Eagerly snapshot the existing log for replay; new events route via broker.\n    const replay: MetadataEvent[] = [];\n    const promise = (async () => {\n      for await (const evt of this.log.readAll()) {\n        if (matchEvent(evt, filter)) replay.push(evt);\n      }\n    })();\n    // We must await replay before returning, but the public API is\n    // sync-returning AsyncIterable. Wrap in a deferred iterable.\n    return deferredIterable(promise.then(() =>\n      createWatchIterable({\n        filter,\n        since,\n        replay,\n        broker: this.broker,\n        matches: matchEvent,\n        branchKeyOf: (e) => e.ref.org,\n      }),\n    ));\n  }\n\n  // ── Write API ───────────────────────────────────────────────────────\n\n  put(ref: MetaRef, spec: unknown, opts: PutOptions): Promise<PutResult> {\n    this.assertScope(ref);\n    return this.mutex.run(refKey(ref), async () => {\n      const key = refKey(ref);\n      const currentHead = this.heads.get(key) ?? null;\n      if ((opts.parentVersion ?? null) !== currentHead) {\n        throw new ConflictError(ref, opts.parentVersion ?? null, currentHead);\n      }\n      const hash = hashSpec(spec);\n      if (currentHead === hash) {\n        // No-op write — same content.\n        const meta = await this.findMetaForHash(ref, hash);\n        return {\n          version: hash,\n          seq: meta?.seq ?? 0,\n          item: {\n            ref: { ...ref, version: undefined },\n            body: spec as Record<string, unknown>,\n            hash,\n            parentHash: meta?.parentHash ?? null,\n            authoredBy: meta?.actor ?? this.fsActor,\n            authoredAt: meta?.ts ?? this.now().toISOString(),\n            message: meta?.message,\n            seq: meta?.seq ?? 0,\n          },\n        };\n      }\n\n      const seq = this.nextSeq++;\n      const ts = this.now().toISOString();\n      const file = itemPath(this.layout, ref.type, ref.name);\n      // First write of the process materializes the root (#7000).\n      await this.ensureRoot();\n      await fs.mkdir(typeDir(this.layout, ref.type), { recursive: true });\n      await writeJsonAtomic(file, spec);\n      // The watcher must not depend on its own directory scan to notice a\n      // path we created ourselves (#7282). See `trackWrittenPath`.\n      this.trackWrittenPath(file);\n      // Publishing the new head here is what suppresses the watcher event this\n      // write is about to produce — see `handleFsChange` (#7335). It runs in\n      // the same continuation as the `rename` above, and `awaitWriteFinish`\n      // holds any event for a further `stabilityThreshold`, so the index is\n      // always current by the time an event for this path can be delivered.\n      this.heads.set(key, hash);\n\n      const evt: MetadataEvent = {\n        seq,\n        op: currentHead ? 'update' : 'create',\n        ref: { ...ref, version: undefined },\n        hash,\n        parentHash: currentHead,\n        actor: opts.actor,\n        message: opts.message,\n        ts,\n        source: opts.source ?? 'fs',\n      };\n      await this.log.append(evt);\n      this.broker.publish(evt);\n\n      return {\n        version: hash,\n        seq,\n        item: {\n          ref: { ...ref, version: undefined },\n          body: spec as Record<string, unknown>,\n          hash,\n          parentHash: currentHead,\n          authoredBy: opts.actor,\n          authoredAt: ts,\n          message: opts.message,\n          seq,\n        },\n      };\n    });\n  }\n\n  delete(ref: MetaRef, opts: DeleteOptions): Promise<DeleteResult> {\n    this.assertScope(ref);\n    return this.mutex.run(refKey(ref), async () => {\n      const key = refKey(ref);\n      const currentHead = this.heads.get(key) ?? null;\n      if (currentHead !== opts.parentVersion) {\n        throw new ConflictError(ref, opts.parentVersion, currentHead);\n      }\n      const file = itemPath(this.layout, ref.type, ref.name);\n      // A delete appends a tombstone to the change log, so it is a write too.\n      await this.ensureRoot();\n      // Retire the head BEFORE touching the disk, not after (#7335).\n      //\n      // `awaitWriteFinish` only debounces `add`/`change`; chokidar emits\n      // `unlink` with no stability delay at all, so — unlike `put()` — this\n      // face has no cushion between the disk mutation and the event it\n      // produces. Clearing the index first makes `handleFsChange`'s\n      // `if (!currentHead) return` a total suppression for our own removal\n      // rather than a race against the poll callback.\n      this.heads.delete(key);\n      try {\n        if (existsSync(file)) await fs.unlink(file);\n      } catch (err) {\n        // The disk still holds the item, so the index must too — otherwise a\n        // failed delete would leave the repository claiming a file it can\n        // still read. Restores exactly the pre-call state before rethrowing.\n        if (currentHead !== null) this.heads.set(key, currentHead);\n        throw err;\n      }\n      const seq = this.nextSeq++;\n      const ts = this.now().toISOString();\n      const evt: MetadataEvent = {\n        seq,\n        op: 'delete',\n        ref: { ...ref, version: undefined },\n        hash: null,\n        parentHash: currentHead,\n        actor: opts.actor,\n        message: opts.message,\n        ts,\n        source: opts.source ?? 'fs',\n      };\n      await this.log.append(evt);\n      this.broker.publish(evt);\n      return { seq };\n    });\n  }\n\n  // ── Internals ───────────────────────────────────────────────────────\n\n  private assertScope(ref: MetaRef): void {\n    if (ref.org !== this.org) {\n      throw new Error(\n        `FileSystemRepository scope mismatch: expected org=${this.org}, got org=${ref.org}`,\n      );\n    }\n  }\n\n  private async scanHeads(): Promise<void> {\n    this.heads.clear();\n    // Walk one level deep: <root>/<type>/<name>.json\n    let entries: import('node:fs').Dirent[] = [];\n    try {\n      entries = await fs.readdir(this.layout.root, { withFileTypes: true });\n    } catch {\n      return;\n    }\n    for (const entry of entries) {\n      if (!entry.isDirectory()) continue;\n      if (entry.name.startsWith('.')) continue;\n      const type = entry.name;\n      const dir = path.join(this.layout.root, type);\n      let files: string[] = [];\n      try {\n        files = await fs.readdir(dir);\n      } catch {\n        continue;\n      }\n      for (const file of files) {\n        if (!file.endsWith('.json')) continue;\n        const name = file.slice(0, -'.json'.length);\n        const ref: MetaRef = {\n          org: this.org,\n          type: type as MetadataType,\n          name,\n        };\n        const body = await readJson(path.join(dir, file));\n        if (!body) continue;\n        this.heads.set(refKey(ref), hashSpec(body));\n      }\n    }\n  }\n\n  private async findMetaForHash(\n    ref: MetaRef,\n    hash: string,\n  ): Promise<MetadataEvent | null> {\n    let last: MetadataEvent | null = null;\n    for await (const evt of this.log.readAll()) {\n      if (evt.ref.type !== ref.type || evt.ref.name !== ref.name) continue;\n      if (evt.ref.org !== ref.org) continue;\n      if (evt.hash === hash) last = evt;\n    }\n    return last;\n  }\n\n  /**\n   * Register a path this repository just wrote with the watcher (#7282).\n   *\n   * chokidar's initial scan is asynchronous, and every write path here can be\n   * running **while it is still walking the tree** — `start()` arms the watcher\n   * and the caller may `put()` on the next tick, and `ensureRoot()` arms it in\n   * the middle of the very first write. With `usePolling` that combination has\n   * a permanently-blinding interleaving, measured on chokidar 5 with this\n   * repository's own options:\n   *\n   *   1. chokidar reads `<root>/<type>/` and finds it EMPTY — the atomic\n   *      `rename` in `writeJsonAtomic` has not landed yet.\n   *   2. the rename lands; the directory's mtime changes.\n   *   3. chokidar calls `watchFile()` on that directory, and libuv takes its\n   *      polling baseline stat — which already reflects step 2.\n   *\n   * From then on the directory's stat never changes again, so no poll ever\n   * fires for it, `_handleRead` never re-runs, the item file is never added to\n   * the watched set, and no per-file watcher is ever created. chokidar emits\n   * neither `add` nor `change` for that path **for the life of the process** —\n   * `getWatched()` reports the type directory as `[]` forever while the file\n   * sits in it. That is the whole of #7282: the four merge-queue ejections all\n   * waited out their deadlines (20s, then 25541ms against 25s) on an event that\n   * was never going to be delivered, which is why widening the deadline and\n   * widening the pre-edit sleep both changed nothing, and why lowering\n   * `interval` would change nothing either — a shorter poll re-compares against\n   * the same unchanged directory stat.\n   *\n   * The window is exactly \"files that exist at baseline time but were absent\n   * from the snapshot read a moment earlier\", and the only writer that can be\n   * inside it is us. So we close it at the source: tell the watcher explicitly\n   * about every path we create, instead of hoping its scan happened to see it.\n   *\n   * `add()` is idempotent here — `_handleFile` returns early when the parent\n   * directory already tracks the basename — and it emits nothing, because\n   * chokidar treats an explicit `add()` as an initial add and `ignoreInitial`\n   * is set. Its effect is the one we need: `_watchWithNodeFs` registers the\n   * basename with the parent directory (without which chokidar drops `change`\n   * events for the file) and starts the per-file poll.\n   */\n  private trackWrittenPath(file: string): void {\n    const w = this.watcher;\n    // `add()` clears `closed`, so never hand a closing watcher a new path.\n    if (!w || w.closed) return;\n    w.add(file);\n  }\n\n  private startWatcher(): void {\n    const root = this.layout.root;\n    const w = chokidar.watch(root, {\n      // Skip dotfiles under the root — including the repository's own\n      // `.objectstack/` bookkeeping subtree — matched on the path RELATIVE\n      // to the watch root (#7150). See `isIgnoredWatchPath`.\n      ignored: (p: string) => isIgnoredWatchPath(root, p),\n      ignoreInitial: true,\n      depth: 2,\n      awaitWriteFinish: { stabilityThreshold: 50, pollInterval: 20 },\n      // Use polling to avoid `fs.watch` EMFILE on macOS / busy dev hosts.\n      // The depth-2 recursion would otherwise wire native watches across\n      // the entire customization tree.\n      usePolling: true,\n      interval: 1000,\n      binaryInterval: 2000,\n    });\n    w.on('add', (p) => void this.handleFsChange(p, 'add'));\n    w.on('change', (p) => void this.handleFsChange(p, 'change'));\n    w.on('unlink', (p) => void this.handleFsChange(p, 'unlink'));\n    this.watcher = w;\n  }\n\n  /**\n   * Translate a watcher event into a `MetadataEvent`, or drop it.\n   *\n   * ## Self-writes are suppressed by content identity, never by a clock (#7335)\n   *\n   * This used to open with `if (this.selfWrites.has(absPath)) return;` — a\n   * `Set` that `put()`/`delete()` added the path to and a `setTimeout(…, 200)`\n   * cleared. That check discarded **every** event for a recently-written path\n   * without ever looking at what the watcher had actually observed, which is\n   * the whole defect: with `usePolling`, chokidar compares state once per\n   * `interval`, so our write and an external edit landing between two ticks\n   * are delivered as **one** event carrying the *external* content. Dropping\n   * it on a wall clock destroyed the only notification that edit would ever\n   * produce.\n   *\n   * Measured on `origin/main` @ `69fde55`, 40 iterations, poll phase\n   * randomised so the delivery lag samples `[0, interval)` uniformly:\n   *\n   *   delivery lag < 200ms  →  7 runs  →  external edit SWALLOWED, every time\n   *   delivery lag > 200ms  →  33 runs →  external edit delivered, every time\n   *\n   * A perfect split on the wall-clock boundary, and the reason earlier\n   * instrumentation saw 0/360: a *fixed* pre-edit sleep phase-locks the poll,\n   * pinning the lag (measured: 519–585ms across 25 runs) safely outside the\n   * window. Nothing about the window was rare — it was unsampled.\n   *\n   * What remains is the check that was already doing the real work one step\n   * down, and it needs no timer because it compares the content the watcher\n   * **read** against the index:\n   *\n   *   - `add`/`change` — `currentHead === hash` drops the event when the bytes\n   *     on disk are the bytes we last published. `put()` sets that head in the\n   *     same continuation as its `rename`, and `awaitWriteFinish` holds the\n   *     event for a further `stabilityThreshold`, so it is never late.\n   *   - `unlink` — `!currentHead` drops the event when the index already\n   *     agrees the item is gone. `delete()` retires the head *before* it\n   *     unlinks, precisely because this face gets no `awaitWriteFinish` delay.\n   *\n   * Both faces are pinned together in `test/self-write-suppression.test.ts`.\n   *\n   * Note the deliberate limit: identity is judged on what round-trips through\n   * the file, so a spec whose in-memory form does not (a `Date`, which\n   * canonicalises to `{}` in memory but to an ISO string once written and\n   * re-read) is republished as an external `update`. That predates this change\n   * and is independent of it — such a spec already fails `put().version ===\n   * get().hash`, and the 200ms window never covered it either, expiring some\n   * 360ms before the event it would have had to catch.\n   */\n  private async handleFsChange(absPath: string, kind: 'add' | 'change' | 'unlink'): Promise<void> {\n    const parsed = parseItemPath(this.layout, absPath);\n    if (!parsed) return;\n    const ref: MetaRef = {\n      org: this.org,\n      type: parsed.type as MetadataType,\n      name: parsed.name,\n    };\n    const key = refKey(ref);\n    await this.mutex.run(key, async () => {\n      if (kind === 'unlink') {\n        const currentHead = this.heads.get(key) ?? null;\n        if (!currentHead) return;\n        this.heads.delete(key);\n        const seq = this.nextSeq++;\n        const evt: MetadataEvent = {\n          seq,\n          op: 'delete',\n          ref: { ...ref, version: undefined },\n          hash: null,\n          parentHash: currentHead,\n          actor: this.fsActor,\n          ts: this.now().toISOString(),\n          source: 'fs',\n        };\n        await this.log.append(evt);\n        this.broker.publish(evt);\n        return;\n      }\n      const body = await readJson(absPath);\n      if (!body) return;\n      const hash = hashSpec(body);\n      const currentHead = this.heads.get(key) ?? null;\n      if (currentHead === hash) return; // No content change.\n      this.heads.set(key, hash);\n      const seq = this.nextSeq++;\n      const evt: MetadataEvent = {\n        seq,\n        op: currentHead ? 'update' : 'create',\n        ref: { ...ref, version: undefined },\n        hash,\n        parentHash: currentHead,\n        actor: this.fsActor,\n        ts: this.now().toISOString(),\n        source: 'fs',\n      };\n      await this.log.append(evt);\n      this.broker.publish(evt);\n    });\n  }\n}\n\n// ── Utilities ─────────────────────────────────────────────────────────\n\n/**\n * Watcher ignore matcher — \"everything under the root, except the\n * repository's own bookkeeping\" (#7150).\n *\n * chokidar hands its matcher **absolute** paths, and applies it to the\n * watched root itself as well as to entries discovered underneath it. The\n * previous matcher was a bare dotfile regex (`/(^|[\\\\/])\\../`), which\n * therefore matched the `.objectstack` segment of the root path the plugin\n * actually uses (`<project>/.objectstack/metadata`, `REPO_SUBDIR` in\n * `packages/metadata/src/plugin.ts`) and ignored the whole watch. Measured on\n * chokidar 5 with this repository's own options, two identical trees\n * differing only in whether the root sits under a dot-directory:\n *\n *   plain root      getWatched: ['<root>', 'view']   events: add+change\n *   dot-rooted      getWatched: []                   events: none\n *\n * So the intent is kept and only the *frame of reference* is fixed: judge the\n * path relative to the root, so dot segments belonging to the root itself are\n * never considered.\n *\n * Why not drop the matcher entirely and lean on `parseItemPath`, which already\n * rejects `.objectstack`? Measured: `parseItemPath` rejects that ONE name, so\n * a dot-directory at the type level leaks — `<root>/.cache/x.json` parses as\n * type `.cache`, and `<root>/view/.scratch.json` as an item named `.scratch`.\n * Both would be published as `MetadataEvent`s while `scanHeads` skips every\n * dot entry on boot, leaving the boot scan and the watcher disagreeing about\n * what the repository contains. Dropping it also puts `.objectstack/.log/` in\n * the poll set, so every one of the repository's own log appends wakes\n * `handleFsChange` only to be discarded.\n */\nfunction isIgnoredWatchPath(root: string, absPath: string): boolean {\n  const rel = path.relative(root, absPath);\n  // The watched root itself, and anything outside it, are not ours to judge.\n  if (rel === '' || rel.startsWith('..')) return false;\n  return rel.split(/[\\\\/]/).some((segment) => segment.startsWith('.'));\n}\n\nasync function readJson(file: string): Promise<unknown | null> {\n  try {\n    const text = await fs.readFile(file, 'utf8');\n    return JSON.parse(text);\n  } catch {\n    return null;\n  }\n}\n\nasync function writeJsonAtomic(file: string, body: unknown): Promise<void> {\n  const tmp = `${file}.${process.pid}.${Date.now()}.tmp`;\n  await fs.writeFile(tmp, JSON.stringify(body, null, 2) + '\\n', 'utf8');\n  await fs.rename(tmp, file);\n}\n\nfunction parseRefKey(key: string): MetaRef | null {\n  const parts = key.split('/');\n  if (parts.length !== 3) return null;\n  return {\n    org: parts[0]!,\n    type: parts[1]! as MetadataType,\n    name: parts[2]!,\n  };\n}\n\n/**\n * Wrap a Promise<AsyncIterable<T>> as a sync-returning AsyncIterable<T>.\n * The first `.next()` awaits the promise.\n */\nfunction deferredIterable<T>(promise: Promise<AsyncIterable<T>>): AsyncIterable<T> {\n  return {\n    [Symbol.asyncIterator]() {\n      let inner: AsyncIterator<T> | null = null;\n      return {\n        async next() {\n          if (!inner) {\n            const iterable = await promise;\n            inner = iterable[Symbol.asyncIterator]();\n          }\n          return inner.next();\n        },\n        async return(value?: unknown) {\n          if (!inner) {\n            const iterable = await promise;\n            inner = iterable[Symbol.asyncIterator]();\n          }\n          if (inner.return) return inner.return(value);\n          return { value: undefined, done: true };\n        },\n      } as AsyncIterator<T>;\n    },\n  };\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\n/**\n * Disk layout helpers — see ADR-0008 §10 PR-4 / packages/metadata-fs README.\n *\n *   <root>/<type>/<name>.json     — canonical body\n *   <root>/.objectstack/.log/main.jsonl  — append-only change log\n */\n\nimport path from 'node:path';\nimport type { MetadataType } from '@objectstack/metadata-core';\n\nexport interface FsLayout {\n  /** Absolute path to the metadata root. */\n  root: string;\n}\n\nexport function itemPath(layout: FsLayout, type: MetadataType, name: string): string {\n  return path.join(layout.root, type, `${name}.json`);\n}\n\nexport function typeDir(layout: FsLayout, type: MetadataType): string {\n  return path.join(layout.root, type);\n}\n\nexport function logDir(layout: FsLayout): string {\n  return path.join(layout.root, '.objectstack', '.log');\n}\n\nexport function logFile(layout: FsLayout): string {\n  // Single change log per filesystem root (branching is a Git concern,\n  // not a metadata-layer concern).\n  return path.join(logDir(layout), `main.jsonl`);\n}\n\n/** Parse a path like \".../view/case_grid.json\" into {type, name}. */\nexport function parseItemPath(\n  layout: FsLayout,\n  absPath: string,\n): { type: string; name: string } | null {\n  const rel = path.relative(layout.root, absPath);\n  if (rel.startsWith('..') || rel.startsWith('.objectstack')) return null;\n  const segments = rel.split(path.sep);\n  if (segments.length !== 2) return null;\n  const type = segments[0]!;\n  const file = segments[1]!;\n  if (!file.endsWith('.json')) return null;\n  const name = file.slice(0, -'.json'.length);\n  return { type, name };\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\n/**\n * Append-only JSONL change log writer / reader. Each line is a single\n * `MetadataEvent` serialized via `JSON.stringify`.\n *\n * Durability strategy\n * ───────────────────\n *   - Append with `O_APPEND` semantics (Node's `fs.appendFile` is\n *     atomic for sub-PIPE_BUF-sized writes; events are well under 4 KiB).\n *   - Read by streaming the file line-by-line and JSON.parse-ing each.\n *   - On a corrupt line we skip and continue — the body files are the\n *     source of truth; the log is a denormalised history index.\n */\n\nimport fs from 'node:fs/promises';\nimport path from 'node:path';\nimport readline from 'node:readline';\nimport { createReadStream, existsSync } from 'node:fs';\nimport type { MetadataEvent } from '@objectstack/metadata-core';\n\nexport class JsonlLog {\n  constructor(private readonly file: string) {}\n\n  async append(evt: MetadataEvent): Promise<void> {\n    await fs.mkdir(path.dirname(this.file), { recursive: true });\n    await fs.appendFile(this.file, JSON.stringify(evt) + '\\n', 'utf8');\n  }\n\n  /** Read all events in seq order (i.e. file order). */\n  async *readAll(): AsyncIterable<MetadataEvent> {\n    if (!existsSync(this.file)) return;\n    const rl = readline.createInterface({\n      input: createReadStream(this.file, { encoding: 'utf8' }),\n      crlfDelay: Infinity,\n    });\n    try {\n      for await (const line of rl) {\n        if (!line.trim()) continue;\n        try {\n          yield JSON.parse(line) as MetadataEvent;\n        } catch {\n          // Skip corrupt line.\n        }\n      }\n    } finally {\n      rl.close();\n    }\n  }\n\n  /** Return the highest seq number in the log, or 0 if empty. */\n  async highestSeq(): Promise<number> {\n    let max = 0;\n    for await (const evt of this.readAll()) {\n      if (typeof evt.seq === 'number' && evt.seq > max) max = evt.seq;\n    }\n    return max;\n  }\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\n/**\n * Mutex / event-broker primitives used by FileSystemRepository.\n *\n * `KeyedMutex` serializes operations on the same key (refKey). The\n * broker re-uses the same manual-AsyncIterator pattern as\n * InMemoryRepository so that consumer `return()` reliably unblocks.\n */\n\nimport type { MetadataEvent, WatchFilter } from '@objectstack/metadata-core';\n\nexport class KeyedMutex {\n  private readonly tails = new Map<string, Promise<unknown>>();\n\n  async run<T>(key: string, fn: () => Promise<T>): Promise<T> {\n    const prev = this.tails.get(key) ?? Promise.resolve();\n    const next = prev.then(fn, fn);\n    // Save the swallowed-error tail so successive runs don't reject on\n    // an unrelated prior failure.\n    const swallowed = next.catch(() => undefined);\n    this.tails.set(key, swallowed);\n    try {\n      return await next;\n    } finally {\n      // Best-effort cleanup: drop the entry if nothing newer was queued.\n      if (this.tails.get(key) === swallowed) {\n        this.tails.delete(key);\n      }\n    }\n  }\n}\n\nexport interface BrokerSubscriber {\n  filter: WatchFilter;\n  closed: boolean;\n  push(evt: MetadataEvent): void;\n}\n\nexport interface EventBroker {\n  subscribe(sub: BrokerSubscriber): void;\n  unsubscribe(sub: BrokerSubscriber): void;\n  publish(evt: MetadataEvent): void;\n}\n\nexport function createBroker(matches: (evt: MetadataEvent, filter: WatchFilter) => boolean): EventBroker {\n  const subs = new Set<BrokerSubscriber>();\n  return {\n    subscribe: (s) => { subs.add(s); },\n    unsubscribe: (s) => { subs.delete(s); },\n    publish: (evt) => {\n      for (const s of subs) {\n        if (s.closed) continue;\n        if (!matches(evt, s.filter)) continue;\n        s.push(evt);\n      }\n    },\n  };\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\n/**\n * Manual `AsyncIterator` factory for `repo.watch()`. Mirrors the\n * pattern used in `@objectstack/metadata-core`'s `InMemoryRepository`:\n * async generators do NOT run `finally` when paused on an unresolved\n * `await`, so we cannot use them to implement `watch()`.\n */\n\nimport type { MetadataEvent, WatchFilter } from '@objectstack/metadata-core';\nimport { type EventBroker, type BrokerSubscriber } from './sync.js';\n\nexport interface CreateWatchIteratorArgs {\n  filter: WatchFilter;\n  since: number | undefined;\n  replay: MetadataEvent[];\n  broker: EventBroker;\n  /** Returns true if `evt.ref` matches `filter`. */\n  matches: (evt: MetadataEvent, filter: WatchFilter) => boolean;\n  branchKeyOf: (evt: MetadataEvent) => string;\n}\n\nexport function createWatchIterable(\n  args: CreateWatchIteratorArgs,\n): AsyncIterable<MetadataEvent> {\n  const queue: MetadataEvent[] = [];\n  let waiter: ((evt: IteratorResult<MetadataEvent>) => void) | null = null;\n  let closed = false;\n  const delivered = new Set<string>();\n  const evtKey = (e: MetadataEvent) => `${args.branchKeyOf(e)}#${e.seq}`;\n\n  const subscriber: BrokerSubscriber = {\n    filter: args.filter,\n    closed: false,\n    push: (evt) => {\n      if (subscriber.closed) return;\n      const k = evtKey(evt);\n      if (delivered.has(k)) return;\n      if (waiter) {\n        delivered.add(k);\n        const w = waiter;\n        waiter = null;\n        w({ value: clone(evt), done: false });\n      } else {\n        queue.push(evt);\n      }\n    },\n  };\n  args.broker.subscribe(subscriber);\n\n  const replay = [...args.replay].sort((a, b) => a.seq - b.seq);\n  let replayIdx = 0;\n\n  const drain = (): IteratorResult<MetadataEvent> | null => {\n    while (replayIdx < replay.length) {\n      const evt = replay[replayIdx++]!;\n      if (typeof args.since === 'number' && evt.seq <= args.since) continue;\n      const k = evtKey(evt);\n      if (delivered.has(k)) continue;\n      delivered.add(k);\n      return { value: clone(evt), done: false };\n    }\n    while (queue.length > 0) {\n      const evt = queue.shift()!;\n      const k = evtKey(evt);\n      if (delivered.has(k)) continue;\n      delivered.add(k);\n      return { value: clone(evt), done: false };\n    }\n    return null;\n  };\n\n  const close = (): IteratorResult<MetadataEvent> => {\n    if (!closed) {\n      closed = true;\n      subscriber.closed = true;\n      args.broker.unsubscribe(subscriber);\n      if (waiter) {\n        const w = waiter;\n        waiter = null;\n        w({ value: undefined, done: true });\n      }\n    }\n    return { value: undefined, done: true };\n  };\n\n  const iterator: AsyncIterator<MetadataEvent> = {\n    next: () => {\n      if (closed) return Promise.resolve({ value: undefined, done: true });\n      const immediate = drain();\n      if (immediate) return Promise.resolve(immediate);\n      return new Promise<IteratorResult<MetadataEvent>>((resolve) => {\n        waiter = resolve;\n      });\n    },\n    return: () => Promise.resolve(close()),\n    throw: (err) => {\n      close();\n      return Promise.reject(err);\n    },\n  };\n  return { [Symbol.asyncIterator]: () => iterator };\n}\n\nfunction clone<T>(value: T): T {\n  return JSON.parse(JSON.stringify(value)) as T;\n}\n"],"mappings":"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","names":["fs","existsSync","path","path","path","existsSync","fs","currentHead","seq","evt"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@objectstack/metadata-fs",
-  "version": "17.0.0-rc.5",
+  "version": "17.0.0",
   "license": "Apache-2.0",
   "description": "FileSystemRepository: Node-only Repository implementation backed by JSON files and a JSONL change log (ADR-0008).",
   "type": "module",
@@ -26,7 +26,7 @@
   ],
   "dependencies": {
     "chokidar": "^5.0.0",
-    "@objectstack/metadata-core": "17.0.0-rc.5"
+    "@objectstack/metadata-core": "17.0.0"
   },
   "devDependencies": {
     "@types/node": "^26.1.2",
@@ -54,6 +54,6 @@
     "clean": "rm -rf dist",
     "test": "vitest run",
     "test:watch": "vitest",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.test.json"
   }
 }