semantifold 0.9.0 → 0.10.0

package/build/src/project-watch-reporter.js

@@ -0,0 +1,280 @@
+// @ts-check
+import { diagnosticRecord, formatHumanProjectFailure, normalizeDiagnostic } from "./project-reporter.js";
+/**
+ * Emits long-lived watch state with one terminal record for every admitted cycle and one for the watcher.
+ */
+export class ProjectWatchReporter {
+    /** @type {"human" | "ndjson"} */
+    #format;
+    /** @type {import("./project-reporter.js").WritableOutput} */
+    #stdout;
+    /** @type {import("./project-reporter.js").WritableOutput} */
+    #stderr;
+    /** @type {() => number} */
+    #now;
+    /** @type {string | null} */
+    #projectId = null;
+    /** @type {string | null} */
+    #snapshotHash = null;
+    /** @type {number | null} */
+    #cycle = null;
+    /** @type {readonly string[]} */
+    #changedPaths = Object.freeze([]);
+    #cycleStartedAt = 0;
+    #watchTerminal = false;
+    #cycleTerminal = true;
+    /**
+     * Creates a watch reporter.
+     * @param {{format?: "human" | "ndjson", now?: () => number, stderr?: import("./project-reporter.js").WritableOutput, stdout?: import("./project-reporter.js").WritableOutput}} [options] - Output mode, clock, and sinks.
+     */
+    constructor(options = {}) {
+        const format = options.format ?? "human";
+        if (format != "human" && format != "ndjson" || options.now !== undefined && typeof options.now != "function") {
+            throw new TypeError("Invalid project watch reporter options.");
+        }
+        this.#format = format;
+        this.#stdout = options.stdout ?? process.stdout;
+        this.#stderr = options.stderr ?? process.stderr;
+        this.#now = options.now ?? (() => performance.now());
+        if (typeof this.#stdout?.write != "function" || typeof this.#stderr?.write != "function") {
+            throw new TypeError("Project watch reporter requires writable output sinks.");
+        }
+    }
+    /**
+     * Reports validated watch startup.
+     * @param {string} projectId - Stable initial project identity.
+     * @returns {void}
+     */
+    watchStarted(projectId) {
+        this.#projectId = projectId;
+        this.#emit({ state: "watch-started" });
+    }
+    /**
+     * Reports the selected event backend.
+     * @param {"native" | "polling"} backend - Active event backend.
+     * @returns {void}
+     */
+    watchBackend(backend) {
+        this.#emit({ backend, state: "watch-backend" });
+    }
+    /**
+     * Begins one admitted build cycle.
+     * @param {ProjectWatchCycleContext} cycle - Cycle context.
+     * @returns {void}
+     */
+    cycleStarted(cycle) {
+        if (!this.#cycleTerminal || this.#watchTerminal)
+            throw new TypeError("Project watch reporter cycle lifecycle is invalid.");
+        this.#cycle = cycle.cycle;
+        this.#cycleTerminal = false;
+        this.#changedPaths = Object.freeze([...cycle.changedPaths]);
+        this.#projectId = cycle.projectId;
+        this.#snapshotHash = cycle.snapshotHash ?? null;
+        this.#cycleStartedAt = this.#now();
+        this.#emit({ changedPaths: this.#changedPaths, ...(cycle.snapshotHash === undefined ? {} : { snapshotHash: cycle.snapshotHash }), state: "cycle-started" });
+    }
+    /**
+     * Reports the cycle's validated project identity.
+     * @param {string} projectId - Validated project identity.
+     * @returns {void}
+     */
+    projectLoaded(projectId) {
+        this.#projectId = projectId;
+        this.#emit({ state: "project-loaded" });
+    }
+    /**
+     * Reports the cycle's complete source snapshot.
+     * @param {string} snapshotHash - Complete source snapshot hash.
+     * @returns {void}
+     */
+    snapshotLoaded(snapshotHash) {
+        this.#snapshotHash = snapshotHash;
+        this.#emit({ snapshotHash, state: "snapshot-loaded" });
+    }
+    /**
+     * Reports one generated target.
+     * @param {import("./project-build.js").ProjectBuildTargetResult} target - Generated target.
+     * @returns {void}
+     */
+    targetGenerated(target) {
+        this.#emit({
+            artifactCount: target.artifactCount,
+            language: target.language,
+            role: target.role,
+            state: "target-generated",
+            target: target.id
+        });
+    }
+    /**
+     * Reports one completed target-check stage.
+     * @param {{id: string, language: string, stage: import("./semantic/types.js").TargetCheckStageResult}} checked - Check stage.
+     * @returns {void}
+     */
+    targetChecked(checked) {
+        this.#emit({
+            argv: checked.stage.argv,
+            durationMs: checked.stage.durationMs,
+            exitCode: checked.stage.exitCode,
+            language: checked.language,
+            signal: checked.stage.signal,
+            stage: checked.stage.stage,
+            state: "target-checked",
+            stderr: checked.stage.stderr,
+            stdout: checked.stage.stdout,
+            target: checked.id,
+            tool: checked.stage.tool
+        });
+    }
+    /**
+     * Emits one successful or recovered cycle terminal.
+     * @param {import("./project-build.js").ProjectBuildSuccess} result - Published result.
+     * @param {boolean} recovered - Whether the prior ordinary cycle failed.
+     * @returns {void}
+     */
+    cycleSucceeded(result, recovered) {
+        this.#requireCycle();
+        this.#cycleTerminal = true;
+        this.#snapshotHash = result.snapshotHash;
+        const state = recovered ? "cycle-recovered" : "cycle-succeeded";
+        if (this.#format == "human") {
+            const verb = recovered ? "recovered" : "succeeded";
+            this.#stdout.write(`Watch cycle ${this.#cycle} ${verb}: project '${result.projectId}' published generation '${result.generationId}'.\n`);
+            return;
+        }
+        this.#write({
+            changedPaths: this.#changedPaths,
+            checked: result.checked,
+            durationMs: this.#duration(),
+            generationId: result.generationId,
+            snapshotHash: result.snapshotHash,
+            state,
+            targets: result.targets.map(target => ({ id: target.id, language: target.language, role: target.role })),
+            terminal: true,
+            terminalScope: "cycle"
+        });
+    }
+    /**
+     * Emits one failed, cancelled, or superseded cycle terminal.
+     * @param {unknown} failure - Preserved cycle failure.
+     * @param {"cancelled" | "failed" | "superseded"} status - Terminal classification.
+     * @returns {void}
+     */
+    cycleFailed(failure, status) {
+        this.#requireCycle();
+        this.#cycleTerminal = true;
+        const diagnostic = normalizeDiagnostic(failure);
+        if (this.#format == "human") {
+            this.#stderr.write(formatHumanProjectFailure(diagnostic, `Watch cycle ${this.#cycle} ${status}`));
+            return;
+        }
+        this.#write({
+            changedPaths: this.#changedPaths,
+            diagnostic: diagnosticRecord(diagnostic),
+            durationMs: this.#duration(),
+            ...(this.#snapshotHash === null ? {} : { snapshotHash: this.#snapshotHash }),
+            state: `cycle-${status}`,
+            terminal: true,
+            terminalScope: "cycle"
+        });
+    }
+    /**
+     * Reports reconciliation whose complete content hash did not change.
+     * @param {readonly string[]} changedPaths - Coalesced hint paths.
+     * @returns {void}
+     */
+    unchanged(changedPaths) {
+        this.#emit({ changedPaths, state: "reconciled-unchanged" });
+    }
+    /**
+     * Reports the first filesystem hint admitted while the current cycle remains active.
+     * @returns {void}
+     */
+    cycleDirty() {
+        this.#requireCycle();
+        this.#emit({ state: "cycle-dirty" });
+    }
+    /**
+     * Emits the sole clean watcher terminal.
+     * @param {string} reason - Shutdown reason.
+     * @returns {void}
+     */
+    watchStopped(reason) {
+        this.#requireWatchTerminal();
+        this.#watchTerminal = true;
+        if (this.#format == "human") {
+            this.#stdout.write(`Watch stopped: ${reason}\n`);
+            return;
+        }
+        this.#write({ reason, state: "watch-stopped", terminal: true, terminalScope: "watch" });
+    }
+    /**
+     * Emits the sole startup/configuration watcher terminal.
+     * @param {unknown} failure - Startup/configuration failure.
+     * @returns {void}
+     */
+    watchFailed(failure) {
+        this.#requireWatchTerminal();
+        this.#watchTerminal = true;
+        const diagnostic = normalizeDiagnostic(failure);
+        if (this.#format == "human") {
+            this.#stderr.write(formatHumanProjectFailure(diagnostic, "Watch failed"));
+            return;
+        }
+        this.#write({ diagnostic: diagnosticRecord(diagnostic), state: "watch-failed", terminal: true, terminalScope: "watch" });
+    }
+    /**
+     * Computes a stable non-negative cycle duration.
+     * @returns {number} Cycle duration.
+     */
+    #duration() {
+        const value = this.#now() - this.#cycleStartedAt;
+        return Number.isFinite(value) && value >= 0 ? value : 0;
+    }
+    /**
+     * Emits a non-terminal machine state when selected.
+     * @param {Record<string, unknown>} fields - State fields.
+     * @returns {void}
+     */
+    #emit(fields) {
+        if (this.#format == "ndjson")
+            this.#write(fields);
+    }
+    /**
+     * Writes one complete NDJSON record.
+     * @param {Record<string, unknown>} fields - Protocol fields.
+     * @returns {void}
+     */
+    #write(fields) {
+        this.#stdout.write(`${JSON.stringify({
+            cycle: this.#cycle,
+            project: this.#projectId,
+            schema: "SemantifoldWatchEvent",
+            version: 1,
+            ...fields
+        })}\n`);
+    }
+    /**
+     * Requires one open cycle terminal slot.
+     * @returns {void}
+     */
+    #requireCycle() {
+        if (this.#cycleTerminal || this.#watchTerminal)
+            throw new TypeError("Project watch reporter has no open cycle.");
+    }
+    /**
+     * Requires one open watcher terminal slot.
+     * @returns {void}
+     */
+    #requireWatchTerminal() {
+        if (this.#watchTerminal || !this.#cycleTerminal)
+            throw new TypeError("Project watch reporter watcher lifecycle is invalid.");
+    }
+}
+/**
+ * @typedef ProjectWatchCycleContext
+ * @property {readonly string[]} changedPaths - Stable changed paths.
+ * @property {number} cycle - One-based cycle number.
+ * @property {string} projectId - Stable project identity.
+ * @property {string} [snapshotHash] - Complete snapshot hash when reconciliation succeeded.
+ */
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHJvamVjdC13YXRjaC1yZXBvcnRlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9wcm9qZWN0LXdhdGNoLXJlcG9ydGVyLmpzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLFlBQVk7QUFFWixPQUFPLEVBQUMsZ0JBQWdCLEVBQUUseUJBQXlCLEVBQUUsbUJBQW1CLEVBQUMsTUFBTSx1QkFBdUIsQ0FBQTtBQUV0Rzs7R0FFRztBQUNILE1BQU0sT0FBTyxvQkFBb0I7SUFDL0IsaUNBQWlDO0lBQ2pDLE9BQU8sQ0FBQTtJQUNQLDZEQUE2RDtJQUM3RCxPQUFPLENBQUE7SUFDUCw2REFBNkQ7SUFDN0QsT0FBTyxDQUFBO0lBQ1AsMkJBQTJCO0lBQzNCLElBQUksQ0FBQTtJQUNKLDRCQUE0QjtJQUM1QixVQUFVLEdBQUcsSUFBSSxDQUFBO0lBQ2pCLDRCQUE0QjtJQUM1QixhQUFhLEdBQUcsSUFBSSxDQUFBO0lBQ3BCLDRCQUE0QjtJQUM1QixNQUFNLEdBQUcsSUFBSSxDQUFBO0lBQ2IsZ0NBQWdDO0lBQ2hDLGFBQWEsR0FBRyxNQUFNLENBQUMsTUFBTSxDQUFDLEVBQUUsQ0FBQyxDQUFBO0lBQ2pDLGVBQWUsR0FBRyxDQUFDLENBQUE7SUFDbkIsY0FBYyxHQUFHLEtBQUssQ0FBQTtJQUN0QixjQUFjLEdBQUcsSUFBSSxDQUFBO0lBRXJCOzs7T0FHRztJQUNILFlBQVksT0FBTyxHQUFHLEVBQUU7UUFDdEIsTUFBTSxNQUFNLEdBQUcsT0FBTyxDQUFDLE1BQU0sSUFBSSxPQUFPLENBQUE7UUFFeEMsSUFBSSxNQUFNLElBQUksT0FBTyxJQUFJLE1BQU0sSUFBSSxRQUFRLElBQUksT0FBTyxDQUFDLEdBQUcsS0FBSyxTQUFTLElBQUksT0FBTyxPQUFPLENBQUMsR0FBRyxJQUFJLFVBQVUsRUFBRSxDQUFDO1lBQzdHLE1BQU0sSUFBSSxTQUFTLENBQUMseUNBQXlDLENBQUMsQ0FBQTtRQUNoRSxDQUFDO1FBQ0QsSUFBSSxDQUFDLE9B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SUFBSSxDQUFDLFNBQVMsQ0FBQztZQUNuQyxLQUFLLEVBQUUsSUFBSSxDQUFDLE1BQU07WUFDbEIsT0FBTyxFQUFFLElBQUksQ0FBQyxVQUFVO1lBQ3hCLE1BQU0sRUFBRSx1QkFBdUI7WUFDL0IsT0FBTyxFQUFFLENBQUM7WUFDVixHQUFHLE1BQU07U0FDVixDQUFDLElBQUksQ0FBQyxDQUFBO0lBQ1QsQ0FBQztJQUVEOzs7T0FHRztJQUNILGFBQWE7UUFDWCxJQUFJLElBQUksQ0FBQyxjQUFjLElBQUksSUFBSSxDQUFDLGNBQWM7WUFBRSxNQUFNLElBQUksU0FBUyxDQUFDLDJDQUEyQyxDQUFDLENBQUE7SUFDbEgsQ0FBQztJQUVEOzs7T0FHRztJQUNILHFCQUFxQjtRQUNuQixJQUFJLElBQUksQ0FBQyxjQUFjLElBQUksQ0FBQyxJQUFJLENBQUMsY0FBYztZQUFFLE1BQU0sSUFBSSxTQUFTLENBQUMsc0RBQXNELENBQUMsQ0FBQTtJQUM5SCxDQUFDO0NBQ0Y7QUFFRDs7Ozs7O0dBTUciLCJzb3VyY2VzQ29udGVudCI6WyIvLyBAdHMtY2hlY2tcblxuaW1wb3J0IHtkaWFnbm9zdGljUmVjb3JkLCBmb3JtYXRIdW1hblByb2plY3RGYWlsdXJlLCBub3JtYWxpemVEaWFnbm9zdGljfSBmcm9tIFwiLi9wcm9qZWN0LXJlcG9ydGVyLmpzXCJcblxuLyoqXG4gKiBFbWl0cyBsb25nLWxpdmVkIHdhdGNoIHN0YXRlIHdpdGggb25lIHRlcm1pbmFsIHJlY29yZCBmb3IgZXZlcnkgYWRtaXR0ZWQgY3ljbGUgYW5kIG9uZSBmb3IgdGhlIHdhdGNoZXIuXG4gKi9cbmV4cG9ydCBjbGFzcyBQcm9qZWN0V2F0Y2hSZXBvcnRlciB7XG4gIC8qKiBAdHlwZSB7XCJodW1hblwiIHwgXCJuZGpzb25cIn0gKi9cbiAgI2Zvcm1hdFxuICAvKiogQHR5cGUge2ltcG9ydChcIi4vcHJvamVjdC1yZXBvcnRlci5qc1wiKS5Xcml0YWJsZU91dHB1dH0gKi9cbiAgI3N0ZG91dFxuICAvKiogQHR5cGUge2ltcG9ydChcIi4vcHJvamVjdC1yZXBvcnRlci5qc1wiKS5Xcml0YWJsZU91dHB1dH0gKi9cbiAgI3N0ZGVyclxuICAvKiogQHR5cGUgeygpID0+IG51bWJlcn0gKi9cbiAgI25vd1xuICAvKiogQHR5cGUge3N0cmluZyB8IG51bGx9ICovXG4gICNwcm9qZWN0SWQgPSBudWxsXG4gIC8qKiBAdHlwZSB7c3RyaW5nIHwgbnVsbH0gKi9cbiAgI3NuYXBzaG90SGFzaCA9IG51bGxcbiAgLyoqIEB0eXBlIHtudW1iZXIgfCBudWxsfSAqL1xuICAjY3ljbGUgPSBudWxsXG4gIC8qKiBAdHlwZSB7cmVhZG9ubHkgc3RyaW5nW119ICovXG4gICNjaGFuZ2VkUGF0aHMgPSBPYmplY3QuZnJlZXplKFtdKVxuICAjY3ljbGVTdGFydGVkQXQgPSAwXG4gICN3YXRjaFRlcm1pbmFsID0gZmFsc2VcbiAgI2N5Y2xlVGVybWluYWwgPSB0cnVlXG5cbiAgLyoqXG4gICAqIENyZWF0ZXMgYSB3YXRjaCByZXBvcnRlci5cbiAgICogQHBhcmFtIHt7Zm9ybWF0PzogXCJodW1hblwiIHwgXCJuZGpzb25cIiwgbm93PzogKCkgPT4gbnVtYmVyLCBzdGRlcnI/OiBpbXBvcnQoXCIuL3Byb2plY3QtcmVwb3J0ZXIuanNcIikuV3JpdGFibGVPdXRwdXQsIHN0ZG91dD86IGltcG9ydChcIi4vcHJvamVjdC1yZXBvcnRlci5qc1wiKS5Xcml0YWJsZU91dHB1dH19IFtvcHRpb25zXSAtIE91dHB1dCBtb2RlLCBjbG9jaywgYW5kIHNpbmtzLlxuICAgKi9cbiAgY29uc3RydWN0b3Iob3B0aW9ucyA9IHt9KSB7XG4gICAgY29uc3QgZm9ybWF0ID0gb3B0aW9ucy5mb3JtYXQgPz8gXCJodW1hblwiXG5cbiAgICBpZiAoZm9ybWF0ICE9IFwiaHVtYW5cIiAmJiBmb3JtYXQgIT0gXCJuZGpzb25cIiB8fCBvcHRpb25zLm5vdyAhPT0gdW5kZWZpbmVkICYmIHR5cGVvZiBvcHRpb25zLm5vdyAhPSBcImZ1bmN0aW9uXCIpIHtcbiAgICAgIHRocm93IG5ldyBUeXBlRXJyb3IoXCJJbnZhbGlkIHByb2plY3Qgd2F0Y2ggcmVwb3J0ZXIgb3B0aW9ucy5cIilcbiAgICB9XG4gICAgdGhpcy4jZm9ybWF0ID0gZm9ybWF0XG4gICAgdGhpcy4jc3Rkb3V0ID0gb3B0aW9ucy5zdGRvdXQgPz8gcHJvY2Vzcy5zdGRvdXRcbiAgICB0aGlzLiNzdGRlcnIgPSBvcHRpb25zLnN0ZGVyciA/PyBwcm9jZXNzLnN0ZGVyclxuICAgIHRoaXMuI25vdyA9IG9wdGlvbnMubm93ID8/ICgoKSA9PiBwZXJmb3JtYW5jZS5ub3coKSlcbiAgICBpZiAodHlwZW9mIHRoaXMuI3N0ZG91dD8ud3JpdGUgIT0gXCJmdW5jdGlvblwiIHx8IHR5cGVvZiB0aGlzLiNzdGRlcnI/LndyaXRlICE9IFwiZnVuY3Rpb25cIikge1xuICAgICAgdGhyb3cgbmV3IFR5cGVFcnJvcihcIlByb2plY3Qgd2F0Y2ggcmVwb3J0ZXIgcmVxdWlyZXMgd3JpdGFibGUgb3V0cHV0IHNpbmtzLlwiKVxuICAgIH1cbiAgfVxuXG4gIC8qKlxuICAgKiBSZXBvcnRzIHZhbGlkYXRlZCB3YXRjaCBzdGFydHVwLlxuICAgKiBAcGFyYW0ge3N0cmluZ30gcHJvamVjdElkIC0gU3RhYmxlIGluaXRpYWwgcHJvamVjdCBpZGVudGl0eS5cbiAgICogQHJldHVybnMge3ZvaWR9XG4gICAqL1xuICB3YXRjaFN0YXJ0ZWQocHJvamVjdElkKSB7XG4gICAgdGhpcy4jcHJvamVjdElkID0gcHJvamVjdElkXG4gICAgdGhpcy4jZW1pdCh7c3RhdGU6IFwid2F0Y2gtc3RhcnRlZFwifSlcbiAgfVxuXG4gIC8qKlxuICAgKiBSZXBvcnRzIHRoZSBzZWxlY3RlZCBldmVudCBiYWNrZW5kLlxuICAgKiBAcGFyYW0ge1wibmF0aXZlXCIgfCBcInBvbGxpbmdcIn0gYmFja2VuZCAtIEFjdGl2ZSBldmVudCBiYWNrZW5kLlxuICAgKiBAcmV0dXJucyB7dm9pZH1cbiAgICovXG4gIHdhdGNoQmFja2VuZChiYWNrZW5kKSB7XG4gICAgdGhpcy4jZW1pdCh7YmFja2VuZCwgc3RhdGU6IFwid2F0Y2gtYmFja2VuZFwifSlcbiAgfVxuXG4gIC8qKlxuICAgKiBCZWdpbnMgb25lIGFkbWl0dGVkIGJ1aWxkIGN5Y2xlLlxuICAgKiBAcGFyYW0ge1Byb2plY3RXYXRjaEN5Y2xlQ29udGV4dH0gY3ljbGUgLSBDeWNsZSBjb250ZXh0LlxuICAgKiBAcmV0dXJucyB7dm9pZH1cbiAgICovXG4gIGN5Y2xlU3RhcnRlZChjeWNsZSkge1xuICAgIGlmICghdGhpcy4jY3ljbGVUZXJtaW5hbCB8fCB0aGlzLiN3YXRjaFRlcm1pbmFsKSB0aHJvdyBuZXcgVHlwZUVycm9yKFwiUHJvamVjdCB3YXRjaCByZXBvcnRlciBjeWNsZSBsaWZlY3ljbGUgaXMgaW52YWxpZC5cIilcbiAgICB0aGlzLiNjeWNsZSA9IGN5Y2xlLmN5Y2xlXG4gICAgdGhpcy4jY3ljbGVUZXJtaW5hbCA9IGZhbHNlXG4gICAgdGhpcy4jY2hhbmdlZFBhdGhzID0gT2JqZWN0LmZyZWV6ZShbLi4uY3ljbGUuY2hhbmdlZFBhdGhzXSlcbiAgICB0aGlzLiNwcm9qZWN0SWQgPSBjeWNsZS5wcm9qZWN0SWRcbiAgICB0aGlzLiNzbmFwc2hvdEhhc2ggPSBjeWNsZS5zbmFwc2hvdEhhc2ggPz8gbnVsbFxuICAgIHRoaXMuI2N5Y2xlU3RhcnRlZEF0ID0gdGhpcy4jbm93KClcbiAgICB0aGlzLiNlbWl0KHtjaGFuZ2VkUGF0aHM6IHRoaXMuI2NoYW5nZWRQYXRocywgLi4uKGN5Y2xlLnNuYXBzaG90SGFzaCA9PT0gdW5kZWZpbmVkID8ge30gOiB7c25hcHNob3RIYXNoOiBjeWNsZS5zbmFwc2hvdEhhc2h9KSwgc3RhdGU6IFwiY3ljbGUtc3RhcnRlZFwifSlcbiAgfVxuXG4gIC8qKlxuICAgKiBSZXBvcnRzIHRoZSBjeWNsZSdzIHZhbGlkYXRlZCBwcm9qZWN0IGlkZW50aXR5LlxuICAgKiBAcGFyYW0ge3N0cmluZ30gcHJvamVjdElkIC0gVmFsaWRhdGVkIHByb2plY3QgaWRlbnRpdHkuXG4gICAqIEByZXR1cm5zIHt2b2lkfVxuICAgKi9cbiAgcHJvamVjdExvYWRlZChwcm9qZWN0SWQpIHtcbiAgICB0aGlzLiNwcm9qZWN0SWQgPSBwcm9qZWN0SWRcbiAgICB0aGlzLiNlbWl0KHtzdGF0ZTogXCJwcm9qZWN0LWxvYWRlZFwifSlcbiAgfVxuXG4gIC8qKlxuICAgKiBSZXBvcnRzIHRoZSBjeWNsZSdzIGNvbXBsZXRlIHNvdXJjZSBzbmFwc2hvdC5cbiAgICogQHBhcmFtIHtzdHJpbmd9IHNuYXBzaG90SGFzaCAtIENvbXBsZXRlIHNvdXJjZSBzbmFwc2hvdCBoYXNoLlxuICAgKiBAcmV0dXJucyB7dm9pZH1cbiAgICovXG4gIHNuYXBzaG90TG9hZGVkKHNuYXBzaG90SGFzaCkge1xuICAgIHRoaXMuI3NuYXBzaG90SGFzaCA9IHNuYXBzaG90SGFzaFxuICAgIHRoaXMuI2VtaXQoe3NuYXBzaG90SGFzaCwgc3RhdGU6IFwic25hcHNob3QtbG9hZGVkXCJ9KVxuICB9XG5cbiAgLyoqXG4gICAqIFJlcG9ydHMgb25lIGdlbmVyYXRlZCB0YXJnZXQuXG4gICAqIEBwYXJhbSB7aW1wb3J0KFwiLi9wcm9qZWN0LWJ1aWxkLmpzXCIpLlByb2plY3RCdWlsZFRhcmdldFJlc3VsdH0gdGFyZ2V0IC0gR2VuZXJhdGVkIHRhcmdldC5cbiAgICogQHJldHVybnMge3ZvaWR9XG4gICAqL1xuICB0YXJnZXRHZW5lcmF0ZWQodGFyZ2V0KSB7XG4gICAgdGhpcy4jZW1pdCh7XG4gICAgICBhcnRpZmFjdENvdW50OiB0YXJnZXQuYXJ0aWZhY3RDb3VudCxcbiAgICAgIGxhbmd1YWdlOiB0YXJnZXQubGFuZ3VhZ2UsXG4gICAgICByb2xlOiB0YXJnZXQucm9sZSxcbiAgICAgIHN0YXRlOiBcInRhcmdldC1nZW5lcmF0ZWRcIixcbiAgICAgIHRhcmdldDogdGFyZ2V0LmlkXG4gICAgfSlcbiAgfVxuXG4gIC8qKlxuICAgKiBSZXBvcnRzIG9uZSBjb21wbGV0ZWQgdGFyZ2V0LWNoZWNrIHN0YWdlLlxuICAgKiBAcGFyYW0ge3tpZDogc3RyaW5nLCBsYW5ndWFnZTogc3RyaW5nLCBzdGFnZTogaW1wb3J0KFwiLi9zZW1hbnRpYy90eXBlcy5qc1wiKS5UYXJnZXRDaGVja1N0YWdlUmVzdWx0fX0gY2hlY2tlZCAtIENoZWNrIHN0YWdlLlxuICAgKiBAcmV0dXJucyB7dm9pZH1cbiAgICovXG4gIHRhcmdldENoZWNrZWQoY2hlY2tlZCkge1xuICAgIHRoaXMuI2VtaXQoe1xuICAgICAgYXJndjogY2hlY2tlZC5zdGFnZS5hcmd2LFxuICAgICAgZHVyYXRpb25NczogY2hlY2tlZC5zdGFnZS5kdXJhdGlvbk1zLFxuICAgICAgZXhpdENvZGU6IGNoZWNrZWQuc3RhZ2UuZXhpdENvZGUsXG4gICAgICBsYW5ndWFnZTogY2hlY2tlZC5sYW5ndWFnZSxcbiAgICAgIHNpZ25hbDogY2hlY2tlZC5zdGFnZS5zaWduYWwsXG4gICAgICBzdGFnZTogY2hlY2tlZC5zdGFnZS5zdGFnZSxcbiAgICAgIHN0YXRlOiBcInRhcmdldC1jaGVja2VkXCIsXG4gICAgICBzdGRlcnI6IGNoZWNrZWQuc3RhZ2Uuc3RkZXJyLFxuICAgICAgc3Rkb3V0OiBjaGVja2VkLnN0YWdlLnN0ZG91dCxcbiAgICAgIHRhcmdldDogY2hlY2tlZC5pZCxcbiAgICAgIHRvb2w6IGNoZWNrZWQuc3RhZ2UudG9vbFxuICAgIH0pXG4gIH1cblxuICAvKipcbiAgICogRW1pdHMgb25lIHN1Y2Nlc3NmdWwgb3IgcmVjb3ZlcmVkIGN5Y2xlIHRlcm1pbmFsLlxuICAgKiBAcGFyYW0ge2ltcG9ydChcIi4vcHJvamVjdC1idWlsZC5qc1wiKS5Qcm9qZWN0QnVpbGRTdWNjZXNzfSByZXN1bHQgLSBQdWJsaXNoZWQgcmVzdWx0LlxuICAgKiBAcGFyYW0ge2Jvb2xlYW59IHJlY292ZXJlZCAtIFdoZXRoZXIgdGhlIHByaW9yIG9yZGluYXJ5IGN5Y2xlIGZhaWxlZC5cbiAgICogQHJldHVybnMge3ZvaWR9XG4gICAqL1xuICBjeWNsZVN1Y2NlZWRlZChyZXN1bHQsIHJlY292ZXJlZCkge1xuICAgIHRoaXMuI3JlcXVpcmVDeWNsZSgpXG4gICAgdGhpcy4jY3ljbGVUZXJtaW5hbCA9IHRydWVcbiAgICB0aGlzLiNzbmFwc2hvdEhhc2ggPSByZXN1bHQuc25hcHNob3RIYXNoXG4gICAgY29uc3Qgc3RhdGUgPSByZWNvdmVyZWQgPyBcImN5Y2xlLXJlY292ZXJlZFwiIDogXCJjeWNsZS1zdWNjZWVkZWRcIlxuXG4gICAgaWYgKHRoaXMuI2Zvcm1hdCA9PSBcImh1bWFuXCIpIHtcbiAgICAgIGNvbnN0IHZlcmIgPSByZWNvdmVyZWQgPyBcInJlY292ZXJlZFwiIDogXCJzdWNjZWVkZWRcIlxuXG4gICAgICB0aGlzLiNzdGRvdXQud3JpdGUoYFdhdGNoIGN5Y2xlICR7dGhpcy4jY3ljbGV9ICR7dmVyYn06IHByb2plY3QgJyR7cmVzdWx0LnByb2plY3RJZH0nIHB1Ymxpc2hlZCBnZW5lcmF0aW9uICcke3Jlc3VsdC5nZW5lcmF0aW9uSWR9Jy5cXG5gKVxuICAgICAgcmV0dXJuXG4gICAgfVxuICAgIHRoaXMuI3dyaXRlKHtcbiAgICAgIGNoYW5nZWRQYXRoczogdGhpcy4jY2hhbmdlZFBhdGhzLFxuICAgICAgY2hlY2tlZDogcmVzdWx0LmNoZWNrZWQsXG4gICAgICBkdXJhdGlvbk1zOiB0aGlzLiNkdXJhdGlvbigpLFxuICAgICAgZ2VuZXJhdGlvbklkOiByZXN1bHQuZ2VuZXJhdGlvbklkLFxuICAgICAgc25hcHNob3RIYXNoOiByZXN1bHQuc25hcHNob3RIYXNoLFxuICAgICAgc3RhdGUsXG4gICAgICB0YXJnZXRzOiByZXN1bHQudGFyZ2V0cy5tYXAodGFyZ2V0ID0+ICh7aWQ6IHRhcmdldC5pZCwgbGFuZ3VhZ2U6IHRhcmdldC5sYW5ndWFnZSwgcm9sZTogdGFyZ2V0LnJvbGV9KSksXG4gICAgICB0ZXJtaW5hbDogdHJ1ZSxcbiAgICAgIHRlcm1pbmFsU2NvcGU6IFwiY3ljbGVcIlxuICAgIH0pXG4gIH1cblxuICAvKipcbiAgICogRW1pdHMgb25lIGZhaWxlZCwgY2FuY2VsbGVkLCBvciBzdXBlcnNlZGVkIGN5Y2xlIHRlcm1pbmFsLlxuICAgKiBAcGFyYW0ge3Vua25vd259IGZhaWx1cmUgLSBQcmVzZXJ2ZWQgY3ljbGUgZmFpbHVyZS5cbiAgICogQHBhcmFtIHtcImNhbmNlbGxlZFwiIHwgXCJmYWlsZWRcIiB8IFwic3VwZXJzZWRlZFwifSBzdGF0dXMgLSBUZXJtaW5hbCBjbGFzc2lmaWNhdGlvbi5cbiAgICogQHJldHVybnMge3ZvaWR9XG4gICAqL1xuICBjeWNsZUZhaWxlZChmYWlsdXJlLCBzdGF0dXMpIHtcbiAgICB0aGlzLiNyZXF1aXJlQ3ljbGUoKVxuICAgIHRoaXMuI2N5Y2xlVGVybWluYWwgPSB0cnVlXG4gICAgY29uc3QgZGlhZ25vc3RpYyA9IG5vcm1hbGl6ZURpYWdub3N0aWMoZmFpbHVyZSlcblxuICAgIGlmICh0aGlzLiNmb3JtYXQgPT0gXCJodW1hblwiKSB7XG4gICAgICB0aGlzLiNzdGRlcnIud3JpdGUoZm9ybWF0SHVtYW5Qcm9qZWN0RmFpbHVyZShkaWFnbm9zdGljLCBgV2F0Y2ggY3ljbGUgJHt0aGlzLiNjeWNsZX0gJHtzdGF0dXN9YCkpXG4gICAgICByZXR1cm5cbiAgICB9XG4gICAgdGhpcy4jd3JpdGUoe1xuICAgICAgY2hhbmdlZFBhdGhzOiB0aGlzLiNjaGFuZ2VkUGF0aHMsXG4gICAgICBkaWFnbm9zdGljOiBkaWFnbm9zdGljUmVjb3JkKGRpYWdub3N0aWMpLFxuICAgICAgZHVyYXRpb25NczogdGhpcy4jZHVyYXRpb24oKSxcbiAgICAgIC4uLih0aGlzLiNzbmFwc2hvdEhhc2ggPT09IG51bGwgPyB7fSA6IHtzbmFwc2hvdEhhc2g6IHRoaXMuI3NuYXBzaG90SGFzaH0pLFxuICAgICAgc3RhdGU6IGBjeWNsZS0ke3N0YXR1c31gLFxuICAgICAgdGVybWluYWw6IHRydWUsXG4gICAgICB0ZXJtaW5hbFNjb3BlOiBcImN5Y2xlXCJcbiAgICB9KVxuICB9XG5cbiAgLyoqXG4gICAqIFJlcG9ydHMgcmVjb25jaWxpYXRpb24gd2hvc2UgY29tcGxldGUgY29udGVudCBoYXNoIGRpZCBub3QgY2hhbmdlLlxuICAgKiBAcGFyYW0ge3JlYWRvbmx5IHN0cmluZ1tdfSBjaGFuZ2VkUGF0aHMgLSBDb2FsZXNjZWQgaGludCBwYXRocy5cbiAgICogQHJldHVybnMge3ZvaWR9XG4gICAqL1xuICB1bmNoYW5nZWQoY2hhbmdlZFBhdGhzKSB7XG4gICAgdGhpcy4jZW1pdCh7Y2hhbmdlZFBhdGhzLCBzdGF0ZTogXCJyZWNvbmNpbGVkLXVuY2hhbmdlZFwifSlcbiAgfVxuXG4gIC8qKlxuICAgKiBSZXBvcnRzIHRoZSBmaXJzdCBmaWxlc3lzdGVtIGhpbnQgYWRtaXR0ZWQgd2hpbGUgdGhlIGN1cnJlbnQgY3ljbGUgcmVtYWlucyBhY3RpdmUuXG4gICAqIEByZXR1cm5zIHt2b2lkfVxuICAgKi9cbiAgY3ljbGVEaXJ0eSgpIHtcbiAgICB0aGlzLiNyZXF1aXJlQ3ljbGUoKVxuICAgIHRoaXMuI2VtaXQoe3N0YXRlOiBcImN5Y2xlLWRpcnR5XCJ9KVxuICB9XG5cbiAgLyoqXG4gICAqIEVtaXRzIHRoZSBzb2xlIGNsZWFuIHdhdGNoZXIgdGVybWluYWwuXG4gICAqIEBwYXJhbSB7c3RyaW5nfSByZWFzb24gLSBTaHV0ZG93biByZWFzb24uXG4gICAqIEByZXR1cm5zIHt2b2lkfVxuICAgKi9cbiAgd2F0Y2hTdG9wcGVkKHJlYXNvbikge1xuICAgIHRoaXMuI3JlcXVpcmVXYXRjaFRlcm1pbmFsKClcbiAgICB0aGlzLiN3YXRjaFRlcm1pbmFsID0gdHJ1ZVxuICAgIGlmICh0aGlzLiNmb3JtYXQgPT0gXCJodW1hblwiKSB7XG4gICAgICB0aGlzLiNzdGRvdXQud3JpdGUoYFdhdGNoIHN0b3BwZWQ6ICR7cmVhc29ufVxcbmApXG4gICAgICByZXR1cm5cbiAgICB9XG4gICAgdGhpcy4jd3JpdGUoe3JlYXNvbiwgc3RhdGU6IFwid2F0Y2gtc3RvcHBlZFwiLCB0ZXJtaW5hbDogdHJ1ZSwgdGVybWluYWxTY29wZTogXCJ3YXRjaFwifSlcbiAgfVxuXG4gIC8qKlxuICAgKiBFbWl0cyB0aGUgc29sZSBzdGFydHVwL2NvbmZpZ3VyYXRpb24gd2F0Y2hlciB0ZXJtaW5hbC5cbiAgICogQHBhcmFtIHt1bmtub3dufSBmYWlsdXJlIC0gU3RhcnR1cC9jb25maWd1cmF0aW9uIGZhaWx1cmUuXG4gICAqIEByZXR1cm5zIHt2b2lkfVxuICAgKi9cbiAgd2F0Y2hGYWlsZWQoZmFpbHVyZSkge1xuICAgIHRoaXMuI3JlcXVpcmVXYXRjaFRlcm1pbmFsKClcbiAgICB0aGlzLiN3YXRjaFRlcm1pbmFsID0gdHJ1ZVxuICAgIGNvbnN0IGRpYWdub3N0aWMgPSBub3JtYWxpemVEaWFnbm9zdGljKGZhaWx1cmUpXG5cbiAgICBpZiAodGhpcy4jZm9ybWF0ID09IFwiaHVtYW5cIikge1xuICAgICAgdGhpcy4jc3RkZXJyLndyaXRlKGZvcm1hdEh1bWFuUHJvamVjdEZhaWx1cmUoZGlhZ25vc3RpYywgXCJXYXRjaCBmYWlsZWRcIikpXG4gICAgICByZXR1cm5cbiAgICB9XG4gICAgdGhpcy4jd3JpdGUoe2RpYWdub3N0aWM6IGRpYWdub3N0aWNSZWNvcmQoZGlhZ25vc3RpYyksIHN0YXRlOiBcIndhdGNoLWZhaWxlZFwiLCB0ZXJtaW5hbDogdHJ1ZSwgdGVybWluYWxTY29wZTogXCJ3YXRjaFwifSlcbiAgfVxuXG4gIC8qKlxuICAgKiBDb21wdXRlcyBhIHN0YWJsZSBub24tbmVnYXRpdmUgY3ljbGUgZHVyYXRpb24uXG4gICAqIEByZXR1cm5zIHtudW1iZXJ9IEN5Y2xlIGR1cmF0aW9uLlxuICAgKi9cbiAgI2R1cmF0aW9uKCkge1xuICAgIGNvbnN0IHZhbHVlID0gdGhpcy4jbm93KCkgLSB0aGlzLiNjeWNsZVN0YXJ0ZWRBdFxuXG4gICAgcmV0dXJuIE51bWJlci5pc0Zpbml0ZSh2YWx1ZSkgJiYgdmFsdWUgPj0gMCA/IHZhbHVlIDogMFxuICB9XG5cbiAgLyoqXG4gICAqIEVtaXRzIGEgbm9uLXRlcm1pbmFsIG1hY2hpbmUgc3RhdGUgd2hlbiBzZWxlY3RlZC5cbiAgICogQHBhcmFtIHtSZWNvcmQ8c3RyaW5nLCB1bmtub3duPn0gZmllbGRzIC0gU3RhdGUgZmllbGRzLlxuICAgKiBAcmV0dXJucyB7dm9pZH1cbiAgICovXG4gICNlbWl0KGZpZWxkcykge1xuICAgIGlmICh0aGlzLiNmb3JtYXQgPT0gXCJuZGpzb25cIikgdGhpcy4jd3JpdGUoZmllbGRzKVxuICB9XG5cbiAgLyoqXG4gICAqIFdyaXRlcyBvbmUgY29tcGxldGUgTkRKU09OIHJlY29yZC5cbiAgICogQHBhcmFtIHtSZWNvcmQ8c3RyaW5nLCB1bmtub3duPn0gZmllbGRzIC0gUHJvdG9jb2wgZmllbGRzLlxuICAgKiBAcmV0dXJucyB7dm9pZH1cbiAgICovXG4gICN3cml0ZShmaWVsZHMpIHtcbiAgICB0aGlzLiNzdGRvdXQud3JpdGUoYCR7SlNPTi5zdHJpbmdpZnkoe1xuICAgICAgY3ljbGU6IHRoaXMuI2N5Y2xlLFxuICAgICAgcHJvamVjdDogdGhpcy4jcHJvamVjdElkLFxuICAgICAgc2NoZW1hOiBcIlNlbWFudGlmb2xkV2F0Y2hFdmVudFwiLFxuICAgICAgdmVyc2lvbjogMSxcbiAgICAgIC4uLmZpZWxkc1xuICAgIH0pfVxcbmApXG4gIH1cblxuICAvKipcbiAgICogUmVxdWlyZXMgb25lIG9wZW4gY3ljbGUgdGVybWluYWwgc2xvdC5cbiAgICogQHJldHVybnMge3ZvaWR9XG4gICAqL1xuICAjcmVxdWlyZUN5Y2xlKCkge1xuICAgIGlmICh0aGlzLiNjeWNsZVRlcm1pbmFsIHx8IHRoaXMuI3dhdGNoVGVybWluYWwpIHRocm93IG5ldyBUeXBlRXJyb3IoXCJQcm9qZWN0IHdhdGNoIHJlcG9ydGVyIGhhcyBubyBvcGVuIGN5Y2xlLlwiKVxuICB9XG5cbiAgLyoqXG4gICAqIFJlcXVpcmVzIG9uZSBvcGVuIHdhdGNoZXIgdGVybWluYWwgc2xvdC5cbiAgICogQHJldHVybnMge3ZvaWR9XG4gICAqL1xuICAjcmVxdWlyZVdhdGNoVGVybWluYWwoKSB7XG4gICAgaWYgKHRoaXMuI3dhdGNoVGVybWluYWwgfHwgIXRoaXMuI2N5Y2xlVGVybWluYWwpIHRocm93IG5ldyBUeXBlRXJyb3IoXCJQcm9qZWN0IHdhdGNoIHJlcG9ydGVyIHdhdGNoZXIgbGlmZWN5Y2xlIGlzIGludmFsaWQuXCIpXG4gIH1cbn1cblxuLyoqXG4gKiBAdHlwZWRlZiBQcm9qZWN0V2F0Y2hDeWNsZUNvbnRleHRcbiAqIEBwcm9wZXJ0eSB7cmVhZG9ubHkgc3RyaW5nW119IGNoYW5nZWRQYXRocyAtIFN0YWJsZSBjaGFuZ2VkIHBhdGhzLlxuICogQHByb3BlcnR5IHtudW1iZXJ9IGN5Y2xlIC0gT25lLWJhc2VkIGN5Y2xlIG51bWJlci5cbiAqIEBwcm9wZXJ0eSB7c3RyaW5nfSBwcm9qZWN0SWQgLSBTdGFibGUgcHJvamVjdCBpZGVudGl0eS5cbiAqIEBwcm9wZXJ0eSB7c3RyaW5nfSBbc25hcHNob3RIYXNoXSAtIENvbXBsZXRlIHNuYXBzaG90IGhhc2ggd2hlbiByZWNvbmNpbGlhdGlvbiBzdWNjZWVkZWQuXG4gKi9cbiJdfQ==

package/build/src/project-watch.d.ts

@@ -0,0 +1,133 @@
+import { watch as watchFileSystem } from "node:fs";
+import { ProjectBuilder } from "./project-build.js";
+import { ProjectManifestLoader, SemantifoldProject } from "./project-manifest.js";
+import { ProjectSnapshot, ProjectSnapshotBuilder } from "./project-snapshot.js";
+import { ProjectWatchReporter } from "./project-watch-reporter.js";
+/**
+ * Installs a synchronous lifecycle observer for focused coordination specs.
+ * This helper is intentionally not part of the package root API.
+ * @param {ProjectWatchCoordinator} coordinator - Coordinator instance.
+ * @param {(event: ProjectWatchObservation) => void} observer - Marker observer.
+ * @returns {void}
+ */
+export declare function observeProjectWatch(coordinator: ProjectWatchCoordinator, observer: (event: ProjectWatchObservation) => void): void;
+/**
+ * Creates a coordinator with one instance-owned native event backend for focused fallback specs.
+ * This helper is intentionally not part of the package root API.
+ * @param {{builder?: ProjectBuilder, manifestLoader?: ProjectManifestLoader, nativeWatch: typeof watchFileSystem, pollIntervalMs?: number, quietPeriodMs?: number, snapshotBuilder?: ProjectSnapshotBuilder, watchStateReader?: ProjectWatchStateReader}} options - Coordinator options and backends.
+ * @returns {ProjectWatchCoordinator} Configured coordinator.
+ */
+export declare function createProjectWatchCoordinator(options: {
+    builder?: ProjectBuilder;
+    manifestLoader?: ProjectManifestLoader;
+    nativeWatch: typeof watchFileSystem;
+    pollIntervalMs?: number;
+    quietPeriodMs?: number;
+    snapshotBuilder?: ProjectSnapshotBuilder;
+    watchStateReader?: ProjectWatchStateReader;
+}): ProjectWatchCoordinator;
+/**
+ * Turns filesystem hints into serialized complete project build transactions.
+ */
+export declare class ProjectWatchCoordinator {
+    #private;
+    /**
+     * Creates one idle coordinator without touching the filesystem.
+     * @param {{builder?: ProjectBuilder, manifestLoader?: ProjectManifestLoader, pollIntervalMs?: number, quietPeriodMs?: number, snapshotBuilder?: ProjectSnapshotBuilder}} [options] - Collaborators and bounded timing policy.
+     */
+    constructor(options?: {
+        builder?: ProjectBuilder;
+        manifestLoader?: ProjectManifestLoader;
+        pollIntervalMs?: number;
+        quietPeriodMs?: number;
+        snapshotBuilder?: ProjectSnapshotBuilder;
+    });
+    /**
+     * Starts the initial build and remains active until shutdown or startup failure.
+     * @param {string} [projectPath] - Project manifest path.
+     * @param {ProjectWatchReporter} [reporter] - Watch protocol reporter.
+     * @param {{check?: boolean}} [options] - Whether every cycle runs target-owned checks.
+     * @returns {Promise<Readonly<ProjectWatchResult>>} Terminal watcher result.
+     */
+    run(projectPath?: string, reporter?: ProjectWatchReporter, options?: {
+        check?: boolean;
+    }): Promise<Readonly<ProjectWatchResult>>;
+    /**
+     * Stops admitting work, cancels the exact active operation, and waits through child close and staging cleanup.
+     * @param {string} [reason] - Stable shutdown reason.
+     * @returns {Promise<Readonly<ProjectWatchResult>>} Terminal watcher result.
+     */
+    stop(reason?: string): Promise<Readonly<ProjectWatchResult>>;
+}
+export type ProjectWatchStateReader = (filenames: Readonly<Set<string>>) => Promise<Map<string, string>>;
+export type ProjectWatchObservation = {
+    /**
+     * - Marker type.
+     */
+    type: "cycle-start" | "cycle-terminal" | "dirty" | "ready" | "reconciled" | "stopped" | "watch-backend";
+    /**
+     * - Related cycle number.
+     */
+    cycle?: number;
+    /**
+     * - Marker status.
+     */
+    status: "cancelled" | "dirty" | "failed" | "native" | "polling" | "ready" | "recovered" | "started" | "stopped" | "succeeded" | "superseded" | "unchanged";
+};
+export type ProjectWatchResult = {
+    /**
+     * - Watcher terminal state.
+     */
+    status: "failed" | "stopped";
+    /**
+     * - Admitted cycle count.
+     */
+    cycles: number;
+    /**
+     * - Stable terminal reason.
+     */
+    reason: string;
+};
+export type WatchCycleInput = {
+    /**
+     * - Stable changed paths.
+     */
+    changedPaths: readonly string[];
+    /**
+     * - Whether target checks are enabled.
+     */
+    check: boolean;
+    /**
+     * - Preserved reconciliation failure.
+     */
+    failure?: unknown;
+    /**
+     * - Reconciled project, when valid.
+     */
+    project: SemantifoldProject | undefined;
+    /**
+     * - Reconciled snapshot, when valid.
+     */
+    snapshot: ProjectSnapshot | undefined;
+};
+/**
+ * @typedef ProjectWatchObservation
+ * @property {"cycle-start" | "cycle-terminal" | "dirty" | "ready" | "reconciled" | "stopped" | "watch-backend"} type - Marker type.
+ * @property {number} [cycle] - Related cycle number.
+ * @property {"cancelled" | "dirty" | "failed" | "native" | "polling" | "ready" | "recovered" | "started" | "stopped" | "succeeded" | "superseded" | "unchanged"} status - Marker status.
+ */
+/**
+ * @typedef ProjectWatchResult
+ * @property {"failed" | "stopped"} status - Watcher terminal state.
+ * @property {number} cycles - Admitted cycle count.
+ * @property {string} reason - Stable terminal reason.
+ */
+/**
+ * @typedef WatchCycleInput
+ * @property {readonly string[]} changedPaths - Stable changed paths.
+ * @property {boolean} check - Whether target checks are enabled.
+ * @property {unknown} [failure] - Preserved reconciliation failure.
+ * @property {SemantifoldProject | undefined} project - Reconciled project, when valid.
+ * @property {ProjectSnapshot | undefined} snapshot - Reconciled snapshot, when valid.
+ */
+//# sourceMappingURL=project-watch.d.ts.map

package/build/src/project-watch.d.ts.map

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