@legioncodeinc/nectar 0.0.1

package/dist/registration/service.d.ts

@@ -0,0 +1,196 @@
+import { type FuzzyStep } from "./ladder.js";
+import { type WatcherState, type WatchFn } from "./fs-watch.js";
+import type { IgnorePredicate } from "./ignore.js";
+import type { PendingReviewStore } from "./review-store.js";
+import type { HiveGraphStore } from "../hive-graph/store.js";
+import type { Tenancy } from "../hive-graph/model.js";
+import { type Timer } from "../poll-loop.js";
+import type { PipelineMetricsSink } from "../telemetry/metrics.js";
+/** A file's on-disk state, resolved by the injected filesystem seam. */
+export interface StatResult {
+    readonly sizeBytes: number;
+    readonly mtimeObserved: string;
+    readContent(): string | Uint8Array;
+}
+/** The filesystem seam. Injected so the service is testable without touching a real disk. */
+export interface RegistrationFs {
+    /** Stat a repo-relative path; null if it does not exist on disk. */
+    statPath(relPath: string): StatResult | null;
+    /** Whether a repo-relative path currently exists on disk (distinguishes move from copy). */
+    existsOnDisk(relPath: string): boolean;
+    /** Every current repo-relative path on disk (for the full resync settle). */
+    listPaths(): Iterable<string>;
+    /**
+     * True when `relPath` currently exists on disk AS A DIRECTORY (PRD-018c
+     * NEC-008 / AC-018c.5). OPTIONAL and ADDITIVE: an adapter that omits it
+     * (most test fakes) simply never triggers the directory-event resync path -
+     * `stat === null` for a directory is treated as "missing", the pre-018c
+     * behavior, which the prefix-based missing-directory signal below still
+     * catches for a genuine directory rename.
+     */
+    isDirectory?(relPath: string): boolean;
+}
+export interface RegistrationServiceOptions {
+    readonly store: HiveGraphStore;
+    readonly tenancy: Tenancy;
+    readonly fs: RegistrationFs;
+    readonly root: string;
+    /** Step-4 fuzzy matcher (the concrete TLSH-family step). Omit to disable step 4. */
+    readonly fuzzy?: FuzzyStep;
+    /** Where low-confidence step-4 candidates are queued for `review-matches`. */
+    readonly pendingReviews?: PendingReviewStore;
+    /** Ignore contract; ignored paths never trigger a cycle (AC-5). */
+    readonly isIgnored?: IgnorePredicate;
+    /** Debounce window for the intake (DEFAULT 500 ms, PRD-006a). */
+    readonly debounceMs?: number;
+    /** Injected timer for the intake debounce (deterministic tests). */
+    readonly timer?: Timer;
+    /** ISO 8601 "now"; injectable for deterministic tests. */
+    now?(): string;
+    /**
+     * PRD-018c NEC-034 / AC-018c.8: force the case-sensitivity mode instead of
+     * probing. Tests use this to exercise case-fold behavior deterministically
+     * regardless of the CI host's real filesystem; production wiring omits it
+     * so the REAL probe ({@link probeCaseInsensitiveFs}, run once against
+     * `root` at construction) decides.
+     */
+    readonly caseInsensitive?: boolean;
+    /** Fired whenever the watcher's liveness state changes (PRD-018c AC-018c.6/7: running/restarting/degraded/stopped). Defaults to a no-op. */
+    onWatcherStateChange?(state: WatcherState): void;
+    /** Backoff floor for a watcher restart-after-error (ms). Forwarded to {@link WatchIntake}. */
+    readonly watcherRestartBackoffFloorMs?: number;
+    /** Backoff ceiling for a watcher restart-after-error (ms). Forwarded to {@link WatchIntake}. */
+    readonly watcherRestartBackoffCeilingMs?: number;
+    /** Consecutive restart failures before the watcher parks degraded (PRD-018c AC-018c.7). Forwarded to {@link WatchIntake}. */
+    readonly maxWatcherRestartAttempts?: number;
+    /** The raw watch constructor (default: `node:fs`'s `watch`). Forwarded to {@link WatchIntake}; injectable for deterministic error/restart tests (AC-018c.6/7). */
+    readonly watchFn?: WatchFn;
+    /**
+     * PRD-018c AC-018c.7: a slow periodic resync tick that runs regardless of
+     * watcher health, so a permanently-degraded watcher still eventually
+     * reconciles changes. Default {@link DEFAULT_PERIODIC_RESYNC_MS}; set 0 to
+     * disable (most unit tests, which drive resync explicitly).
+     */
+    readonly periodicResyncMs?: number;
+    /** Enrich-queue sink (PRD-016 wires the real queue later). */
+    onEnrichQueued?(nectar: string): void;
+    /**
+     * Observability seam fired at the top of {@link RegistrationService.requestResync}
+     * (PRD-018b): a pure notification (no behavior change to the ladder or the
+     * settle) so the daemon can count the single cold-catch-up resync it requests
+     * after auto-brood settles (AC-018b.5) and surface it to health. Defaults to a
+     * no-op; existing callers are unaffected.
+     */
+    onResyncRequested?(): void;
+    /** Structured log sink; defaults to a no-op. */
+    log?(line: Record<string, unknown>): void;
+    /**
+     * The since-restart pipeline metrics sink (PRD-017b). Counts "files
+     * registered" - once per settled path actually resolved through the ladder
+     * (a NEW/CHANGED path, `resolveExisting`), regardless of the ladder's
+     * outcome. Nectar-mint and version-write counters are captured separately
+     * by wrapping `store` with `telemetry.wrapStore()` (`telemetry/metrics.ts`)
+     * before constructing this service, so this field only needs to cover the
+     * one counter with no other precise 1:1 store-level hook. Omit for a no-op
+     * (the default; existing callers are unaffected).
+     */
+    metrics?: PipelineMetricsSink;
+}
+/** PRD-018c AC-018c.7: the periodic resync backstop's default cadence. Slow enough that the descent-pruned walk (AC-018c.4) makes it cheap even while running. */
+export declare const DEFAULT_PERIODIC_RESYNC_MS: number;
+export declare class RegistrationService {
+    private readonly store;
+    private readonly tenancy;
+    private readonly fs;
+    private readonly fuzzy;
+    private readonly pendingReviews;
+    private readonly isIgnored;
+    private readonly nowFn;
+    private readonly onEnrichQueued;
+    private readonly onResyncRequested;
+    private readonly log;
+    private readonly metrics;
+    private readonly intake;
+    private readonly timer;
+    private readonly caseInsensitive;
+    private readonly statCache;
+    private readonly periodicResyncMs;
+    private readonly pending;
+    private resyncRequested;
+    /** The in-flight (or just-settled) cycle. Tracked so tests can await idle. */
+    private currentCyclePromise;
+    private periodicResyncHandle;
+    constructor(opts: RegistrationServiceOptions);
+    /** Begin watching the workspace root. Idempotent. */
+    start(): void;
+    /** Stop watching, cancel pending debounces, and disarm the periodic resync backstop. Idempotent. */
+    stop(): void;
+    /** PRD-018c AC-018c.7: (re)arm the periodic resync backstop. A no-op when `periodicResyncMs` is 0 (disabled). */
+    private armPeriodicResync;
+    private disarmPeriodicResync;
+    /** Feed a concrete path observation into the debounced intake (test/programmatic entry). */
+    observe(relPath: string): void;
+    /** Feed a raw watch observation (null filename -> resync) into the intake. */
+    observeRaw(filename: string | null | undefined): void;
+    /** Request a debounced full-workspace resync settle. */
+    requestResync(): void;
+    /** Enqueue a settled path and kick the cycle. */
+    private enqueue;
+    /**
+     * Drain seam for tests. Resolves once no cycle is running and nothing is
+     * pending. Mirrors honeycomb's `_waitForIdle()` (`file-watcher.ts:312-314`).
+     */
+    _waitForIdle(): Promise<void>;
+    /** Start a cycle if none is running; the finally re-kicks if work arrived during the cycle. */
+    private kick;
+    /**
+     * The settled handler. Drains the resync request and the pending-path set,
+     * classifying and resolving each path. It catches every per-path error and
+     * continues; it never throws out of the cycle.
+     */
+    private runCycle;
+    /**
+     * PRD-018d (NEC-036): run the idempotent ladder-state repair sweep once per
+     * full resync, so cold catch-up (the moment corruption from a pre-fix or
+     * mid-crash daemon is most likely to have accumulated) is also the moment it
+     * self-heals. Never throws; a per-path cycle failure is isolated the same
+     * way `runCycle` isolates `processOne` failures, but a sweep failure is rare
+     * enough (it touches only already-persisted rows, no disk I/O) that it is
+     * logged rather than silently swallowed.
+     */
+    private runRepairSweep;
+    /** Case-fold a path for lookup purposes only (NEC-034 / AC-018c.8); identity when the workspace is case-sensitive. Never applied to a path that gets stat'd, read, or persisted. */
+    private fold;
+    /** The set of paths currently known to the store (a nectar's latest-version path), scoped and fold-normalized for lookup. */
+    private knownPaths;
+    /**
+     * PRD-018c EX-4: the set of known (real-cased) paths currently missing from
+     * disk, computed once per batch/cycle so the ladder's step-4 candidate scan
+     * (`missingCandidates`) is an O(1) lookup instead of an `existsOnDisk` stat
+     * per candidate per new file.
+     */
+    private missingPaths;
+    /**
+     * PRD-018c NEC-008 / AC-018c.5: true when `relPath` (case-folded) is a
+     * directory PREFIX of some known file path - the signature of a directory
+     * that was renamed/moved out from under its known children. `knownPaths` is
+     * already fold-normalized by `knownPaths()`.
+     */
+    private isKnownPrefix;
+    /** Classify one settled path and, for NEW/CHANGED, resolve it through the ladder. */
+    private processOne;
+    private resolveExisting;
+    private ladderDeps;
+    /**
+     * Persist a low-confidence step-4 candidate for `review-matches` (AC-18).
+     *
+     * The id is derived deterministically from `(candidateNectar, newPath)`
+     * (PRD-018d NEC-036/AC-018d.7) rather than freshly minted per call: a
+     * re-observation of the same target while it is still pending review then
+     * naturally lands on the SAME id, so the store's own id-based replace (and
+     * its belt-and-suspenders tuple-based dedupe) refreshes the one candidate in
+     * place instead of accumulating a sibling per settle.
+     */
+    private handleReview;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/registration/service.d.ts.map

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

package/dist/registration/service.js

@@ -0,0 +1,384 @@
+/**
+ * The settled-handler registration service (PRD-006a AC-4/AC-9).
+ *
+ * This is the orchestrator that wires the whole file-registration pipeline end
+ * to end: the debounced `WatchIntake` (006a) hands settled paths here; each path
+ * is `stat`ed, classified (006b), and, for a NEW/CHANGED path, resolved through
+ * the re-association ladder (006d) and persisted via the `HiveGraphStore`
+ * (005). It mirrors honeycomb's discover -> resolve -> persist shape
+ * (`codebase/api.ts:234-261` `runGraphBuild`) and the fire-and-forget-with-intent
+ * settled handler (`file-watcher.ts:234-293` `runSyncCycle`):
+ *
+ *   - a per-path failure is caught and logged, and the cycle CONTINUES with the
+ *     next path (the whole cycle never throws);
+ *   - the running cycle's promise is tracked (`currentCyclePromise`) so a test
+ *     can await idle via {@link RegistrationService._waitForIdle};
+ *   - a null-filename observation triggers a full workspace resync settle (AC-3);
+ *   - observations are ignore-filtered before they reach a cycle (AC-5).
+ *
+ * Step-4 fingerprints are PERSISTED on the version row (the
+ * `hive_graph_versions.fingerprint` column, written by the ladder), not held
+ * in an in-process cache, so cold-catch-up fuzzy matching survives a daemon
+ * restart (AC-8): step 4 reads each missing candidate's fingerprint straight
+ * from the store.
+ *
+ * Move reconstruction (AC-9) falls out of this end-to-end: feed the intake two
+ * observations (old path now missing, new path new) and, at settle, the ladder's
+ * step 3 carries the nectar when the new content matches the missing file's hash.
+ */
+import { classifyPath } from "./classify.js";
+import { isSafeRelPath } from "./paths-safe.js";
+import { createInMemoryStatCache, reassociate, repairLadderState, } from "./ladder.js";
+import { WatchIntake } from "./fs-watch.js";
+import { probeCaseInsensitiveFs } from "./disk-fs.js";
+import { sha256Hex } from "../hive-graph/hash.js";
+import { realTimer } from "../poll-loop.js";
+/** PRD-018c AC-018c.7: the periodic resync backstop's default cadence. Slow enough that the descent-pruned walk (AC-018c.4) makes it cheap even while running. */
+export const DEFAULT_PERIODIC_RESYNC_MS = 10 * 60 * 1000;
+export class RegistrationService {
+    store;
+    tenancy;
+    fs;
+    fuzzy;
+    pendingReviews;
+    isIgnored;
+    nowFn;
+    onEnrichQueued;
+    onResyncRequested;
+    log;
+    metrics;
+    intake;
+    timer;
+    caseInsensitive;
+    statCache;
+    periodicResyncMs;
+    pending = new Set();
+    resyncRequested = false;
+    /** The in-flight (or just-settled) cycle. Tracked so tests can await idle. */
+    currentCyclePromise = null;
+    periodicResyncHandle = null;
+    constructor(opts) {
+        this.store = opts.store;
+        this.tenancy = opts.tenancy;
+        this.fs = opts.fs;
+        this.fuzzy = opts.fuzzy;
+        this.pendingReviews = opts.pendingReviews;
+        this.isIgnored = opts.isIgnored ?? (() => false);
+        this.nowFn = opts.now ?? (() => new Date().toISOString());
+        this.onEnrichQueued = opts.onEnrichQueued ?? (() => { });
+        this.onResyncRequested = opts.onResyncRequested ?? (() => { });
+        this.log = opts.log ?? (() => { });
+        this.metrics = opts.metrics;
+        this.timer = opts.timer ?? realTimer;
+        // NEC-034 / AC-018c.8: probe ONCE per workspace (never a `process.platform`
+        // guess); a test overrides via `caseInsensitive` for determinism.
+        this.caseInsensitive = opts.caseInsensitive ?? probeCaseInsensitiveFs(opts.root);
+        this.statCache = createInMemoryStatCache();
+        this.periodicResyncMs = Math.max(0, opts.periodicResyncMs ?? DEFAULT_PERIODIC_RESYNC_MS);
+        this.intake = new WatchIntake({
+            root: opts.root,
+            debounceMs: opts.debounceMs,
+            isIgnored: this.isIgnored,
+            timer: opts.timer,
+            onPathChanged: (relPath) => this.enqueue(relPath),
+            onResync: () => this.requestResync(),
+            onError: (err) => this.log({ level: "error", scope: "registration.intake", err: String(err) }),
+            onStateChange: (state) => {
+                this.log({ level: state === "degraded" ? "warn" : "info", scope: "registration.watcher", state });
+                opts.onWatcherStateChange?.(state);
+            },
+            ...(opts.watcherRestartBackoffFloorMs !== undefined
+                ? { restartBackoffFloorMs: opts.watcherRestartBackoffFloorMs }
+                : {}),
+            ...(opts.watcherRestartBackoffCeilingMs !== undefined
+                ? { restartBackoffCeilingMs: opts.watcherRestartBackoffCeilingMs }
+                : {}),
+            ...(opts.maxWatcherRestartAttempts !== undefined ? { maxRestartAttempts: opts.maxWatcherRestartAttempts } : {}),
+            ...(opts.watchFn !== undefined ? { watchFn: opts.watchFn } : {}),
+        });
+    }
+    /** Begin watching the workspace root. Idempotent. */
+    start() {
+        this.intake.start();
+        this.armPeriodicResync();
+    }
+    /** Stop watching, cancel pending debounces, and disarm the periodic resync backstop. Idempotent. */
+    stop() {
+        this.intake.stop();
+        this.disarmPeriodicResync();
+    }
+    /** PRD-018c AC-018c.7: (re)arm the periodic resync backstop. A no-op when `periodicResyncMs` is 0 (disabled). */
+    armPeriodicResync() {
+        if (this.periodicResyncMs <= 0)
+            return;
+        this.disarmPeriodicResync();
+        this.periodicResyncHandle = this.timer.set(() => {
+            this.periodicResyncHandle = null;
+            this.requestResync();
+            this.armPeriodicResync();
+        }, this.periodicResyncMs);
+    }
+    disarmPeriodicResync() {
+        if (this.periodicResyncHandle !== null) {
+            this.timer.clear(this.periodicResyncHandle);
+            this.periodicResyncHandle = null;
+        }
+    }
+    /** Feed a concrete path observation into the debounced intake (test/programmatic entry). */
+    observe(relPath) {
+        this.intake.observe(relPath);
+    }
+    /** Feed a raw watch observation (null filename -> resync) into the intake. */
+    observeRaw(filename) {
+        this.intake.observeRaw(filename);
+    }
+    /** Request a debounced full-workspace resync settle. */
+    requestResync() {
+        this.onResyncRequested();
+        this.resyncRequested = true;
+        this.kick();
+    }
+    /** Enqueue a settled path and kick the cycle. */
+    enqueue(relPath) {
+        if (this.isIgnored(relPath))
+            return;
+        this.pending.add(relPath);
+        this.kick();
+    }
+    /**
+     * Drain seam for tests. Resolves once no cycle is running and nothing is
+     * pending. Mirrors honeycomb's `_waitForIdle()` (`file-watcher.ts:312-314`).
+     */
+    async _waitForIdle() {
+        while (this.currentCyclePromise !== null) {
+            await this.currentCyclePromise;
+        }
+    }
+    /** Start a cycle if none is running; the finally re-kicks if work arrived during the cycle. */
+    kick() {
+        if (this.currentCyclePromise !== null)
+            return;
+        this.currentCyclePromise = this.runCycle().finally(() => {
+            this.currentCyclePromise = null;
+            if (this.pending.size > 0 || this.resyncRequested)
+                this.kick();
+        });
+    }
+    /**
+     * The settled handler. Drains the resync request and the pending-path set,
+     * classifying and resolving each path. It catches every per-path error and
+     * continues; it never throws out of the cycle.
+     */
+    async runCycle() {
+        while (this.resyncRequested || this.pending.size > 0) {
+            if (this.resyncRequested) {
+                this.resyncRequested = false;
+                this.runRepairSweep();
+                for (const p of this.fs.listPaths()) {
+                    const normalized = p.replace(/\\/g, "/");
+                    if (!this.isIgnored(normalized))
+                        this.pending.add(normalized);
+                }
+            }
+            if (this.pending.size === 0)
+                continue;
+            const batch = [...this.pending];
+            this.pending.clear();
+            // Snapshot the known-paths set ONCE per batch (each batch path is distinct
+            // and never re-processed within the same batch), avoiding an O(N^2)
+            // listLatestVersions walk per path. PRD-018c EX-4: the missing-paths set
+            // is ALSO computed once per batch here (one `existsOnDisk` stat per known
+            // path total), rather than once per known path PER new file inside the
+            // ladder's step-4 candidate scan (`ladder.ts`'s `missingCandidates`).
+            const known = this.knownPaths();
+            const missing = this.missingPaths();
+            for (const relPath of batch) {
+                try {
+                    this.processOne(relPath, known, missing);
+                }
+                catch (err) {
+                    this.log({ level: "error", scope: "registration.cycle", relPath, err: String(err) });
+                }
+            }
+        }
+    }
+    /**
+     * PRD-018d (NEC-036): run the idempotent ladder-state repair sweep once per
+     * full resync, so cold catch-up (the moment corruption from a pre-fix or
+     * mid-crash daemon is most likely to have accumulated) is also the moment it
+     * self-heals. Never throws; a per-path cycle failure is isolated the same
+     * way `runCycle` isolates `processOne` failures, but a sweep failure is rare
+     * enough (it touches only already-persisted rows, no disk I/O) that it is
+     * logged rather than silently swallowed.
+     */
+    runRepairSweep() {
+        let report;
+        try {
+            report = repairLadderState(this.store, this.tenancy);
+        }
+        catch (err) {
+            this.log({ level: "error", scope: "registration.repair", err: err instanceof Error ? err.message : String(err) });
+            return;
+        }
+        if (report.healedOrphanIdentities > 0 ||
+            report.healedOrphanVersions > 0 ||
+            report.healedStaleLastUpdate > 0 ||
+            report.healedDuplicatePaths > 0) {
+            this.log({ level: "info", scope: "registration.repair", ...report });
+        }
+    }
+    /** Case-fold a path for lookup purposes only (NEC-034 / AC-018c.8); identity when the workspace is case-sensitive. Never applied to a path that gets stat'd, read, or persisted. */
+    fold(relPath) {
+        return this.caseInsensitive ? relPath.toLowerCase() : relPath;
+    }
+    /** The set of paths currently known to the store (a nectar's latest-version path), scoped and fold-normalized for lookup. */
+    knownPaths() {
+        const set = new Set();
+        for (const lv of this.store.listLatestVersions(this.tenancy))
+            set.add(this.fold(lv.version.path));
+        return set;
+    }
+    /**
+     * PRD-018c EX-4: the set of known (real-cased) paths currently missing from
+     * disk, computed once per batch/cycle so the ladder's step-4 candidate scan
+     * (`missingCandidates`) is an O(1) lookup instead of an `existsOnDisk` stat
+     * per candidate per new file.
+     */
+    missingPaths() {
+        const set = new Set();
+        for (const lv of this.store.listLatestVersions(this.tenancy)) {
+            if (!this.fs.existsOnDisk(lv.version.path))
+                set.add(lv.version.path);
+        }
+        return set;
+    }
+    /**
+     * PRD-018c NEC-008 / AC-018c.5: true when `relPath` (case-folded) is a
+     * directory PREFIX of some known file path - the signature of a directory
+     * that was renamed/moved out from under its known children. `knownPaths` is
+     * already fold-normalized by `knownPaths()`.
+     */
+    isKnownPrefix(relPath, knownPaths) {
+        const prefix = `${this.fold(relPath)}/`;
+        for (const p of knownPaths) {
+            if (p.startsWith(prefix))
+                return true;
+        }
+        return false;
+    }
+    /** Classify one settled path and, for NEW/CHANGED, resolve it through the ladder. */
+    processOne(relPath, knownPaths, missingPaths) {
+        // Containment gate (CWE-22): never stat, read, classify, or persist a path
+        // that escapes the workspace (absolute or `..` traversal). This backstops the
+        // intake filter for the resync/direct-enqueue paths too.
+        if (!isSafeRelPath(relPath)) {
+            this.log({ level: "warn", scope: "registration.cycle", relPath, msg: "dropped unsafe path" });
+            return;
+        }
+        // PRD-018c NEC-008 / AC-018c.5(a): the settled path itself IS a directory
+        // right now (a directory-level watch event, or a rename landing back on an
+        // existing directory name). A directory is never a registrable path; a
+        // resync reconciles every child in one scoped reconciliation instead of
+        // this event being silently dropped.
+        if (this.fs.isDirectory?.(relPath) === true) {
+            this.log({ level: "info", scope: "registration.cycle", relPath, msg: "directory event: requesting resync" });
+            this.requestResync();
+            return;
+        }
+        const stat = this.fs.statPath(relPath);
+        const input = classifyPath({ relPath, existsOnDisk: stat !== null }, knownPaths, (p) => this.fold(p));
+        if (input === null) {
+            // PRD-018c NEC-008 / AC-018c.5(b): the path is missing AND is a prefix of
+            // known paths - the OTHER directory-rename signature (the directory name
+            // itself is gone, only its former children are still known). A resync
+            // re-associates every child to its new location via the ladder.
+            if (stat === null && this.isKnownPrefix(relPath, knownPaths)) {
+                this.log({
+                    level: "info",
+                    scope: "registration.cycle",
+                    relPath,
+                    msg: "missing directory prefix: requesting resync",
+                });
+                this.requestResync();
+            }
+            return;
+        }
+        switch (input.kind) {
+            case "new-path":
+            case "changed-path": {
+                if (stat === null)
+                    return; // defensive: classify said it exists
+                this.resolveExisting(relPath, stat, missingPaths);
+                return;
+            }
+            case "missing-path":
+                // A known nectar whose path is gone: it feeds the missing-files set the
+                // ladder consults for OTHER new paths (move reconstruction). No direct
+                // action here; the nectar is never deleted (only `prune --confirm` does).
+                return;
+            default: {
+                const _exhaustive = input.kind;
+                return _exhaustive;
+            }
+        }
+    }
+    resolveExisting(relPath, stat, missingPaths) {
+        const file = {
+            relPath,
+            sizeBytes: stat.sizeBytes,
+            mtimeObserved: stat.mtimeObserved,
+            readContent: () => stat.readContent(),
+        };
+        // The ladder persists the content fingerprint on the appended version row, so
+        // there is nothing to cache here; step 4 reads it back from the store (AC-8).
+        const result = reassociate(file, this.ladderDeps(missingPaths));
+        // "files registered" (PRD-017b): one settled path actually resolved through
+        // the ladder, counted here at the real completion point regardless of which
+        // step fired or what action it took (noop/append/carry/mint/copy all count -
+        // each is one unit of registration work). A path that never reaches here
+        // (ignored, or classified "missing-path") is correctly never counted.
+        this.metrics?.incrementFilesRegistered();
+        this.log({ level: "debug", scope: "registration.resolve", relPath, step: result.step, action: result.action });
+    }
+    ladderDeps(missingPaths) {
+        return {
+            store: this.store,
+            tenancy: this.tenancy,
+            now: () => this.nowFn(),
+            existsOnDisk: (p) => this.fs.existsOnDisk(p),
+            fuzzy: this.fuzzy,
+            statCache: this.statCache,
+            caseInsensitive: this.caseInsensitive,
+            missingPaths,
+            onReviewNeeded: (candidate) => this.handleReview(candidate),
+            onEnrichQueued: (nectar) => this.onEnrichQueued(nectar),
+        };
+    }
+    /**
+     * Persist a low-confidence step-4 candidate for `review-matches` (AC-18).
+     *
+     * The id is derived deterministically from `(candidateNectar, newPath)`
+     * (PRD-018d NEC-036/AC-018d.7) rather than freshly minted per call: a
+     * re-observation of the same target while it is still pending review then
+     * naturally lands on the SAME id, so the store's own id-based replace (and
+     * its belt-and-suspenders tuple-based dedupe) refreshes the one candidate in
+     * place instead of accumulating a sibling per settle.
+     */
+    handleReview(candidate) {
+        if (this.pendingReviews === undefined)
+            return;
+        this.pendingReviews.add({
+            id: sha256Hex(`${candidate.nectar}|${candidate.relPath}`),
+            candidateNectar: candidate.nectar,
+            newPath: candidate.relPath,
+            confidence: candidate.confidence,
+            distance: candidate.distance,
+            contentHash: candidate.contentHash,
+            sizeBytes: candidate.sizeBytes,
+            mtimeObserved: candidate.mtimeObserved,
+            mintedNectar: candidate.mintedNectar,
+            createdAt: this.nowFn(),
+        });
+    }
+}
+//# sourceMappingURL=service.js.map

package/dist/registration/service.js.map

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