@untangle-code/cli 0.0.0-stage → 0.1.1

package/dist/commands/watch/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../src/commands/watch/cli.ts"],"names":[],"mappings":";AAoBA;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAkE1E"}

package/dist/commands/watch/cli.js

@@ -0,0 +1,97 @@
+#!/usr/bin/env node
+/**
+ * Der ausfuehrbare Einstiegspunkt des Waechters.
+ *
+ * Er liegt bewusst INNERHALB von `src/commands/watch/`: das Kommando bringt
+ * seine eigene Verdrahtung mit (Uhr, Zufall, Signale, Standardausgabe) und
+ * haengt an keiner Datei ausserhalb dieses Verzeichnisses. Damit ist der
+ * Waechter fuer sich allein baubar und vorfuehrbar, waehrend der uebrige
+ * CLI-Rahmen (WP-124) noch entsteht.
+ *
+ * Zwei Aufrufwege, beide gleichwertig:
+ *   node dist/index.js watch [OPTIONEN]              (ueber den CLI-Rahmen)
+ *   node dist/commands/watch/cli.js [OPTIONEN]       (direkt)
+ */
+import { hostname } from "node:os";
+import { parseWatchArgs, WATCH_USAGE } from "./options.js";
+import { runWatch } from "./run.js";
+import { CryptoRandom, SystemClock } from "./runtime.js";
+/**
+ * Fuehrt `untangle watch` aus und liefert den Exit-Code.
+ *
+ * 0 = sauber beendet, 1 = Betriebsfehler, 2 = Aufruffehler.
+ */
+export async function runWatchCli(argv) {
+    // The opt-in index mode needs the full composition root. A URL import keeps
+    // build:watch's original complexity-only dependency graph independent.
+    if (argv.some((arg) => ["--index", "--no-index", "--repo", "--ref", "--embedder"].includes(arg.split("=")[0] ?? ""))) {
+        const runtime = (await import(new URL("../../index.js", import.meta.url).href));
+        const controller = new AbortController();
+        const abort = () => controller.abort();
+        process.on("SIGINT", abort);
+        process.on("SIGTERM", abort);
+        try {
+            return await runtime.run(["watch", ...argv], { signal: controller.signal });
+        }
+        finally {
+            process.off("SIGINT", abort);
+            process.off("SIGTERM", abort);
+        }
+    }
+    const parsed = parseWatchArgs(argv, {
+        cwd: process.cwd(),
+        isTty: process.stdout.isTTY === true,
+        noColorEnv: process.env["NO_COLOR"],
+    });
+    if (!parsed.ok) {
+        process.stderr.write(`untangle watch: ${parsed.message}\n\n${WATCH_USAGE}\n`);
+        return 2;
+    }
+    if (parsed.options.help) {
+        process.stdout.write(`${WATCH_USAGE}\n`);
+        return 0;
+    }
+    return runWatch(parsed.options, {
+        clock: new SystemClock(),
+        random: new CryptoRandom(),
+        stdout: (chunk) => {
+            process.stdout.write(chunk);
+        },
+        stderr: (chunk) => {
+            process.stderr.write(chunk);
+        },
+        host: hostname(),
+        /**
+         * SIGINT/SIGTERM. Die Abmeldung wird zurueckgegeben, damit `runWatch`
+         * den Griff loesen kann, sobald der Abbau laeuft: ein ZWEITES Strg-C
+         * soll dann wieder die Vorgabewirkung haben und hart beenden, statt in
+         * einem Waechter zu haengen, der gerade aufraeumt.
+         */
+        installSignalHandler: (handler) => {
+            const signals = ["SIGINT", "SIGTERM"];
+            const listeners = signals.map((signal) => {
+                const listener = () => {
+                    handler(signal);
+                };
+                process.on(signal, listener);
+                return { signal, listener };
+            });
+            return () => {
+                for (const { signal, listener } of listeners)
+                    process.off(signal, listener);
+            };
+        },
+    });
+}
+const isDirectInvocation = process.argv[1] !== undefined && process.argv[1].endsWith("commands/watch/cli.js");
+if (isDirectInvocation) {
+    runWatchCli(process.argv.slice(2))
+        .then((code) => {
+        process.exitCode = code;
+    })
+        .catch((error) => {
+        process.stderr.write(`untangle watch: ${error instanceof Error ? (error.stack ?? error.message) : String(error)}\n`);
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/commands/watch/cli.js.map

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

package/dist/commands/watch/delta.d.ts

@@ -0,0 +1,46 @@
+import type { FileReadingV1 } from "./analyze.js";
+import { type ComplexityDirection, type MetricDeltaV1, type MetricKey, type MetricValues, type ScopeDeltaV1 } from "./events.js";
+/** Kleiner ist einfacher: negatives Delta = abgebaut. */
+export declare function directionOf(delta: number): ComplexityDirection;
+/** Die Lesart, in der ein Metrikwert entstanden ist (siehe `analyze.ts`). */
+export declare function readingOf(metric: MetricKey): "execution_unit" | "file_chunks";
+/**
+ * Deltas je Metrik zwischen zwei Messungen derselben Datei. `previous` fehlt
+ * bei einer neu hinzugekommenen Datei, `current` bei einer geloeschten — in
+ * beiden Faellen wird die fehlende Seite als 0 gelesen, damit das Delta die
+ * tatsaechliche Wirkung auf die Gesamtlage beschreibt.
+ */
+export declare function metricDeltas(previous: FileReadingV1 | undefined, current: FileReadingV1 | undefined): MetricDeltaV1[];
+/**
+ * Deltas je Scope, ueber `metrics_scope_id` aggregiert und ueber den
+ * stabilen `matchKey` zwischen den Staenden zugeordnet (siehe
+ * `ScopeReadingV1.matchKey`: die eindeutige `metrics_scope_id` ist
+ * byte-range-basiert und ueber zwei Staende hinweg absichtlich nicht stabil).
+ *
+ * Nur Scopes, die in der Lesart `"execution_unit"` ein Summand sind, kommen
+ * vor — sonst zaehlte dieselbe Aenderung zweimal, einmal an der Closure und
+ * einmal an ihrer umschliessenden Funktion.
+ *
+ * Sortierung: Betrag absteigend, bei Gleichstand Metrik-Reihenfolge, dann
+ * Codepoint-Ordnung des Labels. Nie `localeCompare`.
+ */
+export declare function scopeDeltas(previous: FileReadingV1 | undefined, current: FileReadingV1 | undefined, limit: number): ScopeDeltaV1[];
+/**
+ * Gesamtrichtung einer Aenderung ueber alle vier Metriken.
+ *
+ * ENTSCHEIDUNG: gezaehlt werden die Metriken, nicht die Betraege — die vier
+ * Metriken haben keine gemeinsame Einheit (ein semantisches Delta von 240
+ * geschaetzten Tokens ist nicht mit 13 kognitiven Punkten verrechenbar), eine
+ * Summe ueber sie waere eine erfundene Zahl. Ueberwiegt keine Richtung, ist
+ * das Urteil `"unveraendert"` — das ist ehrlicher als eine Scheinpraezision.
+ */
+export declare function verdictOf(deltas: readonly MetricDeltaV1[]): ComplexityDirection;
+/**
+ * Gesamtrichtung einer Netto-Bilanz. Zaehlt wie `verdictOf` die Metriken,
+ * nicht die Betraege — aus demselben Grund: die vier haben keine gemeinsame
+ * Einheit.
+ */
+export declare function netDirectionOf(net: MetricValues): ComplexityDirection;
+/** Addiert Metrikwerte (fuer die Netto-Bilanz der Sitzung). */
+export declare function addMetricValues(base: MetricValues, deltas: readonly MetricDeltaV1[]): MetricValues;
+//# sourceMappingURL=delta.d.ts.map

package/dist/commands/watch/delta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delta.d.ts","sourceRoot":"","sources":["../../../src/commands/watch/delta.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,aAAa,EAAkB,MAAM,cAAc,CAAC;AAClE,OAAO,EAGL,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,YAAY,EAClB,MAAM,aAAa,CAAC;AAErB,yDAAyD;AACzD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,CAI9D;AAED,6EAA6E;AAC7E,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,gBAAgB,GAAG,aAAa,CAE7E;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,aAAa,GAAG,SAAS,EACnC,OAAO,EAAE,aAAa,GAAG,SAAS,GACjC,aAAa,EAAE,CAcjB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,aAAa,GAAG,SAAS,EACnC,OAAO,EAAE,aAAa,GAAG,SAAS,EAClC,KAAK,EAAE,MAAM,GACZ,YAAY,EAAE,CAuChB;AAYD;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,GAAG,mBAAmB,CAU/E;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,YAAY,GAAG,mBAAmB,CAUrE;AAED,+DAA+D;AAC/D,wBAAgB,eAAe,CAC7B,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,SAAS,aAAa,EAAE,GAC/B,YAAY,CAId"}

package/dist/commands/watch/delta.js

@@ -0,0 +1,170 @@
+/**
+ * Deltas mit RICHTUNG — der eigentliche Zweck des Waechters.
+ *
+ * vision.md §1b: eine Aenderung, die Komplexitaet senkt, wird als
+ * Verbesserung AUSGEWIESEN und nicht nur stillschweigend hingenommen; eine
+ * Verschlechterung wird mit ihrer Beitragsstelle benannt. Eine nackte Zahl
+ * leistet weder das eine noch das andere.
+ *
+ * Fuer alle vier Metriken gilt dieselbe Leserichtung: kleiner ist einfacher.
+ * Ein negatives Delta heisst deshalb `"abgebaut"`, ein positives
+ * `"aufgebaut"`.
+ *
+ * ## Was diese Datei NICHT behauptet
+ *
+ * vision.md §1b macht die Qualitaetsaussage von drei Bedingungen abhaengig
+ * (unveraenderte oeffentliche Symboloberflaeche, unveraenderte Testergebnisse,
+ * keine neuen Abhaengigkeitskanten). Der Waechter misst hier NUR die
+ * Komplexitaet. `"abgebaut"` heisst also "die Komplexitaet ist gefallen" und
+ * ausdruecklich NICHT "die Aenderung war eine Verbesserung" — das waere ein
+ * Beweis, den eine statische Messung nicht fuehren kann.
+ */
+import { compareCodepoints } from "@untangle-code/domain";
+import { METRIC_KEYS, zeroMetricValues, } from "./events.js";
+/** Kleiner ist einfacher: negatives Delta = abgebaut. */
+export function directionOf(delta) {
+    if (delta < 0)
+        return "abgebaut";
+    if (delta > 0)
+        return "aufgebaut";
+    return "unveraendert";
+}
+/** Die Lesart, in der ein Metrikwert entstanden ist (siehe `analyze.ts`). */
+export function readingOf(metric) {
+    return metric === "semantic" ? "file_chunks" : "execution_unit";
+}
+/**
+ * Deltas je Metrik zwischen zwei Messungen derselben Datei. `previous` fehlt
+ * bei einer neu hinzugekommenen Datei, `current` bei einer geloeschten — in
+ * beiden Faellen wird die fehlende Seite als 0 gelesen, damit das Delta die
+ * tatsaechliche Wirkung auf die Gesamtlage beschreibt.
+ */
+export function metricDeltas(previous, current) {
+    return METRIC_KEYS.map((metric) => {
+        const before = previous === undefined ? null : previous.totals[metric];
+        const after = current === undefined ? null : current.totals[metric];
+        const delta = (after ?? 0) - (before ?? 0);
+        return {
+            metric,
+            reading: readingOf(metric),
+            previous: before,
+            current: after,
+            delta,
+            direction: directionOf(delta),
+        };
+    });
+}
+/**
+ * Deltas je Scope, ueber `metrics_scope_id` aggregiert und ueber den
+ * stabilen `matchKey` zwischen den Staenden zugeordnet (siehe
+ * `ScopeReadingV1.matchKey`: die eindeutige `metrics_scope_id` ist
+ * byte-range-basiert und ueber zwei Staende hinweg absichtlich nicht stabil).
+ *
+ * Nur Scopes, die in der Lesart `"execution_unit"` ein Summand sind, kommen
+ * vor — sonst zaehlte dieselbe Aenderung zweimal, einmal an der Closure und
+ * einmal an ihrer umschliessenden Funktion.
+ *
+ * Sortierung: Betrag absteigend, bei Gleichstand Metrik-Reihenfolge, dann
+ * Codepoint-Ordnung des Labels. Nie `localeCompare`.
+ */
+export function scopeDeltas(previous, current, limit) {
+    const before = indexSelected(previous);
+    const after = indexSelected(current);
+    const keys = new Set([...before.keys(), ...after.keys()]);
+    const deltas = [];
+    for (const key of keys) {
+        const from = before.get(key);
+        const to = after.get(key);
+        for (const metric of METRIC_KEYS) {
+            if (metric === "semantic")
+                continue; // semantische Ladung ist keine Scope-Groesse
+            const previousValue = from === undefined ? null : from.values[metric];
+            const currentValue = to === undefined ? null : to.values[metric];
+            const delta = (currentValue ?? 0) - (previousValue ?? 0);
+            if (delta === 0)
+                continue;
+            const anchor = to ?? from;
+            if (anchor === undefined)
+                continue;
+            deltas.push({
+                metricsScopeId: anchor.metricsScopeId,
+                label: anchor.label,
+                kind: anchor.kind,
+                line: anchor.line,
+                metric,
+                previous: previousValue,
+                current: currentValue,
+                delta,
+                direction: directionOf(delta),
+            });
+        }
+    }
+    deltas.sort((a, b) => Math.abs(b.delta) - Math.abs(a.delta) ||
+        METRIC_KEYS.indexOf(a.metric) - METRIC_KEYS.indexOf(b.metric) ||
+        compareCodepoints(a.label, b.label) ||
+        a.line - b.line);
+    return deltas.slice(0, limit);
+}
+function indexSelected(reading) {
+    const map = new Map();
+    if (reading === undefined)
+        return map;
+    for (const scope of reading.scopes) {
+        if (!scope.selected)
+            continue;
+        map.set(scope.matchKey, scope);
+    }
+    return map;
+}
+/**
+ * Gesamtrichtung einer Aenderung ueber alle vier Metriken.
+ *
+ * ENTSCHEIDUNG: gezaehlt werden die Metriken, nicht die Betraege — die vier
+ * Metriken haben keine gemeinsame Einheit (ein semantisches Delta von 240
+ * geschaetzten Tokens ist nicht mit 13 kognitiven Punkten verrechenbar), eine
+ * Summe ueber sie waere eine erfundene Zahl. Ueberwiegt keine Richtung, ist
+ * das Urteil `"unveraendert"` — das ist ehrlicher als eine Scheinpraezision.
+ */
+export function verdictOf(deltas) {
+    let down = 0;
+    let up = 0;
+    for (const delta of deltas) {
+        if (delta.direction === "abgebaut")
+            down++;
+        if (delta.direction === "aufgebaut")
+            up++;
+    }
+    if (down > up)
+        return "abgebaut";
+    if (up > down)
+        return "aufgebaut";
+    return "unveraendert";
+}
+/**
+ * Gesamtrichtung einer Netto-Bilanz. Zaehlt wie `verdictOf` die Metriken,
+ * nicht die Betraege — aus demselben Grund: die vier haben keine gemeinsame
+ * Einheit.
+ */
+export function netDirectionOf(net) {
+    let down = 0;
+    let up = 0;
+    for (const metric of METRIC_KEYS) {
+        if (net[metric] < 0)
+            down++;
+        if (net[metric] > 0)
+            up++;
+    }
+    if (down > up)
+        return "abgebaut";
+    if (up > down)
+        return "aufgebaut";
+    return "unveraendert";
+}
+/** Addiert Metrikwerte (fuer die Netto-Bilanz der Sitzung). */
+export function addMetricValues(base, deltas) {
+    const next = { ...zeroMetricValues(), ...base };
+    for (const delta of deltas)
+        next[delta.metric] += delta.delta;
+    return next;
+}
+//# sourceMappingURL=delta.js.map

package/dist/commands/watch/delta.js.map

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

package/dist/commands/watch/events.d.ts

@@ -0,0 +1,214 @@
+/**
+ * Die Ereignisse des Komplexitaetswaechters — der Strom, den `untangle watch`
+ * ausgibt (vision.md §1b "Ratsche", §1d "Auffindbarkeit ist selbst ein
+ * Qualitaetssignal").
+ *
+ * Diese Datei fixiert die FORM des Stroms; `render.ts` fixiert nur seine
+ * Darstellung. Beide Ausgabewege (Text, JSON) speisen sich aus denselben
+ * Werten, damit die maschinenlesbare Ausgabe nie etwas anderes behauptet als
+ * die lesbare.
+ *
+ * ENTSCHEIDUNG (E4 an der Oberflaeche): `WatchUnanalyzedEventV1` ist ein
+ * ERSTKLASSIGES Stromereignis, kein Log-Rauschen. Eine Datei, die der
+ * Waechter nicht messen konnte, MUSS im selben Strom auftauchen wie eine, die
+ * er messen konnte — sonst liest der Nutzer aus dem Schweigen "nichts
+ * passiert", und genau das waere schlimmer als kein Waechter.
+ */
+import type { SkipLedgerEntryV1 } from "@untangle-code/domain";
+/**
+ * Die vier Metriken des Waechters (vision.md §1b: "strukturell, semantisch,
+ * cyclomatic, cognitive").
+ *
+ * Reihenfolge ist normativ: sie ist die Ausgabereihenfolge in JEDER
+ * Darstellung, damit zwei Laeufe zeilenweise vergleichbar bleiben.
+ */
+export declare const METRIC_KEYS: readonly ["structural", "semantic", "cyclomatic", "cognitive"];
+export type MetricKey = (typeof METRIC_KEYS)[number];
+/** Metrikwerte einer Messung, immer vollstaendig — kein Feld fehlt je. */
+export type MetricValues = Readonly<Record<MetricKey, number>>;
+/**
+ * Die Richtung einer Aenderung. Fuer ALLE vier Metriken gilt: kleiner ist
+ * einfacher, also bedeutet ein negatives Delta abgebaute Komplexitaet. Eine
+ * nackte Zahl hilft niemandem — die Richtung ist der Teil, der die Aussage
+ * traegt.
+ */
+export type ComplexityDirection = "abgebaut" | "aufgebaut" | "unveraendert";
+/**
+ * Welche Lesart einer Scope-Summe hinter einem Metrikwert steht
+ * (`packages/complexity/src/scope-aggregate.ts`). Eine Zahl ohne Lesart waere
+ * bedeutungslos, deshalb reist sie mit.
+ *
+ * - `"execution_unit"` — Summe ueber die aeussersten Ausfuehrungseinheiten,
+ *   jede genau einmal, verschachtelte Closures darin enthalten. Die Vorgabe
+ *   fuer strukturell/cyclomatic/cognitive.
+ * - `"file_chunks"` — die semantische Ladung wird nicht ueber Scopes
+ *   summiert, sondern ueber die Chunks der Datei (siehe `analyze.ts`).
+ */
+export type MetricReadingKind = "execution_unit" | "file_chunks";
+/** Ein Delta EINER Metrik, mit Richtung. */
+export interface MetricDeltaV1 {
+    metric: MetricKey;
+    reading: MetricReadingKind;
+    /** Wert vor der Aenderung; `null` bei einer neu hinzugekommenen Datei. */
+    previous: number | null;
+    /** Wert nach der Aenderung; `null` bei einer geloeschten Datei. */
+    current: number | null;
+    /** `current - previous`, mit fehlender Seite als 0 gelesen. */
+    delta: number;
+    direction: ComplexityDirection;
+}
+/** Ein Delta EINES Scopes — die Stelle, an der der Preis entsteht. */
+export interface ScopeDeltaV1 {
+    /** `metrics_scope_id` nach spec.md §16.10. */
+    metricsScopeId: string;
+    /** Qualifizierter Name des Scopes, wie ihn der Sprachadapter meldet. */
+    label: string;
+    kind: string;
+    /** Erste Zeile des Scopes NACH der Aenderung, sonst davor. */
+    line: number;
+    metric: MetricKey;
+    previous: number | null;
+    current: number | null;
+    delta: number;
+    direction: ComplexityDirection;
+}
+/** Der Waechter hat den Lock erworben und die Grundmessung begonnen. */
+export interface WatchStartedEventV1 {
+    kind: "started";
+    sequence: number;
+    at: string;
+    root: string;
+    repoId: string;
+    refId: string;
+    lockKey: string;
+}
+/**
+ * Die Grundmessung ist fertig: ab hier sind alle Deltas gegen einen bekannten
+ * Stand gemessen und nicht gegen Nichts.
+ */
+export interface WatchBaselineEventV1 {
+    kind: "baseline";
+    sequence: number;
+    at: string;
+    filesAnalyzed: number;
+    /** Wie viele Dateien mit Grund im Ledger stehen (E4). */
+    filesUnanalyzed: number;
+    /**
+     * Wie viele Pfade der Scanner ueber Ignorierregeln ausgeschlossen hat
+     * (`.gitignore`, Vorgabeausschluesse, Konfiguration).
+     *
+     * WARUM NUR EINE ZAHL UND KEIN EREIGNIS JE PFAD: das sind auf einem
+     * gewoehnlichen Repository zehntausende Pfade (`node_modules/`, `dist/`),
+     * und ein Strom, der davon ueberflutet wird, verbirgt genau das, was E4
+     * sichtbar machen will. Ausgeschlossen-nach-Regel ist zudem eine
+     * Konfigurationsentscheidung des Nutzers, kein Analysefehlschlag. Jeder
+     * Ausschluss, der NICHT auf einer Regel beruht — binaerer Inhalt,
+     * Groessengrenze, unlesbar — bekommt sein eigenes `unanalyzed`-Ereignis.
+     */
+    filesExcludedByRules: number;
+    totals: MetricValues;
+    /** Summe der Scopes, die in die drei Scope-Metriken eingehen. */
+    scopeCount: number;
+    /**
+     * Wie viele Scope-Ids der Sprachadapter innerhalb einer Datei doppelt
+     * vergeben hat und `withUniqueScopeIds` reparieren musste (WP-82). `> 0`
+     * ist kein Fehler, aber eine Einschraenkung, die sichtbar bleiben muss.
+     */
+    scopeIdCollisions: number;
+    /**
+     * Wie viele `NodeKindFact`s nur ueber den Ersatzweg zugeordnet werden
+     * konnten (sie tragen keine `SourceRange`). Betrifft ausschliesslich die
+     * strukturelle Metrik.
+     */
+    nodeKindFallbacks: number;
+    durationMs: number;
+}
+/** Eine Aenderung an einer Datei, mit Deltas je Metrik und je Scope. */
+export interface WatchChangeEventV1 {
+    kind: "change";
+    sequence: number;
+    at: string;
+    changeKind: "added" | "modified" | "deleted";
+    /** "/"-normalisierter, repo-relativer Pfad. */
+    path: string;
+    languageId: string | null;
+    contentHash: string | null;
+    metrics: MetricDeltaV1[];
+    /**
+     * Die Scopes, deren Wert sich geaendert hat — nach Betrag absteigend,
+     * bei Gleichstand nach Scope-Id (Codepoint-Ordnung).
+     */
+    scopes: ScopeDeltaV1[];
+    /** Gesamtrichtung ueber alle vier Metriken (siehe `delta.ts`). */
+    verdict: ComplexityDirection;
+    /**
+     * Einschraenkungen dieser einen Messung im Klartext (Parse-Qualitaet,
+     * Chunker-Abstufung, Scope-Id-Kollisionen). Leer heisst: keine.
+     */
+    notes: string[];
+    analysisMs: number;
+}
+/**
+ * E4 an der Oberflaeche: eine Datei, die NICHT analysiert werden konnte,
+ * erscheint im Strom als solche — mit Grund, Detailtext und der Angabe, ob
+ * ein spaeterer Versuch Aussicht auf Erfolg hat.
+ */
+export interface WatchUnanalyzedEventV1 {
+    kind: "unanalyzed";
+    sequence: number;
+    at: string;
+    /** Woher die Datei kam: Grundmessung oder eine laufende Aenderung. */
+    origin: "baseline" | "change";
+    entry: SkipLedgerEntryV1;
+}
+/** Zustandswechsel des Watchers (`starting` → `running` → `degraded` → `stopped`). */
+export interface WatchStatusEventV1 {
+    kind: "status";
+    sequence: number;
+    at: string;
+    status: "starting" | "running" | "degraded" | "stopped";
+    /** Fehlertext, wenn der Wechsel durch einen Fehler ausgeloest wurde. */
+    detail: string | null;
+}
+/** Der Waechter hat sauber beendet: Strom geschlossen, Lock freigegeben. */
+export interface WatchStoppedEventV1 {
+    kind: "stopped";
+    sequence: number;
+    at: string;
+    /**
+     * `"signal"` = SIGINT/SIGTERM, `"limit"` = `--exit-after` erreicht,
+     * `"baseline"` = `--baseline-only`, `"error"` = Abbruch.
+     */
+    reason: "signal" | "limit" | "baseline" | "error";
+    signal: string | null;
+    changesObserved: number;
+    filesUnanalyzed: number;
+    /** Netto-Delta der Sitzung je Metrik: was diese Sitzung insgesamt bewirkt hat. */
+    net: MetricValues;
+    netDirection: ComplexityDirection;
+    /** Rueckstau-Kennzahlen der `BoundedQueue` (architecture.md §13.2). */
+    queue: {
+        maxDepthObserved: number;
+        maxBytesObserved: number;
+        overBudgetAdmissions: number;
+    };
+    lockReleased: boolean;
+    durationMs: number;
+}
+export type WatchStreamEventV1 = WatchStartedEventV1 | WatchBaselineEventV1 | WatchChangeEventV1 | WatchUnanalyzedEventV1 | WatchStatusEventV1 | WatchStoppedEventV1;
+/** Nullwerte fuer alle vier Metriken — nie `{}` weiterreichen. */
+export declare function zeroMetricValues(): MetricValues;
+/**
+ * Ein Ereignis OHNE Umschlag (`sequence`, `at`) — die Form, in der der
+ * Waechter ein Ereignis meldet; den Umschlag setzt `runWatch` an genau einer
+ * Stelle, damit die laufende Nummer luecken- und sprungfrei bleibt.
+ *
+ * Die Verteilung ueber die Vereinigung (`T extends unknown ? ... : never`)
+ * ist notwendig: ein `Omit` DIREKT auf der Vereinigung behielte nur die
+ * gemeinsamen Felder aller Varianten uebrig und verwuerfe genau die Felder,
+ * um die es geht.
+ */
+type WithoutEnvelope<T> = T extends unknown ? Omit<T, "sequence" | "at"> : never;
+export type WatchStreamEventDraftV1 = WithoutEnvelope<WatchStreamEventV1>;
+export {};
+//# sourceMappingURL=events.d.ts.map

package/dist/commands/watch/events.d.ts.map

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

package/dist/commands/watch/events.js

@@ -0,0 +1,13 @@
+/**
+ * Die vier Metriken des Waechters (vision.md §1b: "strukturell, semantisch,
+ * cyclomatic, cognitive").
+ *
+ * Reihenfolge ist normativ: sie ist die Ausgabereihenfolge in JEDER
+ * Darstellung, damit zwei Laeufe zeilenweise vergleichbar bleiben.
+ */
+export const METRIC_KEYS = ["structural", "semantic", "cyclomatic", "cognitive"];
+/** Nullwerte fuer alle vier Metriken — nie `{}` weiterreichen. */
+export function zeroMetricValues() {
+    return { structural: 0, semantic: 0, cyclomatic: 0, cognitive: 0 };
+}
+//# sourceMappingURL=events.js.map

package/dist/commands/watch/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/commands/watch/events.ts"],"names":[],"mappings":"AAkBA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,CAAU,CAAC;AAiM1F,kEAAkE;AAClE,MAAM,UAAU,gBAAgB;IAC9B,OAAO,EAAE,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;AACrE,CAAC"}

package/dist/commands/watch/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `untangle watch` — der Komplexitaetswaechter (vision.md §1b, §1d).
+ *
+ * Dies ist die EINZIGE oeffentliche Schnittstelle des Kommandos; `main.ts`
+ * und die Tests importieren nur von hier.
+ */
+export { createFileAnalyzer, ORDERED_METRICS } from "./analyze.js";
+export type { AnalysisOutcomeV1, FileAnalyzerOptions, FileReadingV1, ScopeReadingV1, } from "./analyze.js";
+export { addMetricValues, directionOf, metricDeltas, netDirectionOf, readingOf, scopeDeltas, verdictOf, } from "./delta.js";
+export { METRIC_KEYS, zeroMetricValues } from "./events.js";
+export type { ComplexityDirection, MetricDeltaV1, MetricKey, MetricReadingKind, MetricValues, ScopeDeltaV1, WatchBaselineEventV1, WatchChangeEventV1, WatchStartedEventV1, WatchStatusEventV1, WatchStoppedEventV1, WatchStreamEventDraftV1, WatchStreamEventV1, WatchUnanalyzedEventV1, } from "./events.js";
+export { parseWatchArgs, WATCH_USAGE } from "./options.js";
+export type { ParseWatchArgsEnv, WatchOptionsV1 } from "./options.js";
+export { formatNumber, formatSigned, renderJson, renderText } from "./render.js";
+export { runWatch } from "./run.js";
+export type { RunWatchDeps } from "./run.js";
+export { createIgnorePredicate, createStreamSink, CryptoRandom, STATE_DIR_NAME, stripAnsi, SystemClock, } from "./runtime.js";
+export { runWatchCli } from "./cli.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/watch/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/watch/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACnE,YAAY,EACV,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,cAAc,GACf,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,eAAe,EACf,WAAW,EACX,YAAY,EACZ,cAAc,EACd,SAAS,EACT,WAAW,EACX,SAAS,GACV,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC5D,YAAY,EACV,mBAAmB,EACnB,aAAa,EACb,SAAS,EACT,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3D,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,SAAS,EACT,WAAW,GACZ,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC"}

package/dist/commands/watch/index.js

@@ -0,0 +1,15 @@
+/**
+ * `untangle watch` — der Komplexitaetswaechter (vision.md §1b, §1d).
+ *
+ * Dies ist die EINZIGE oeffentliche Schnittstelle des Kommandos; `main.ts`
+ * und die Tests importieren nur von hier.
+ */
+export { createFileAnalyzer, ORDERED_METRICS } from "./analyze.js";
+export { addMetricValues, directionOf, metricDeltas, netDirectionOf, readingOf, scopeDeltas, verdictOf, } from "./delta.js";
+export { METRIC_KEYS, zeroMetricValues } from "./events.js";
+export { parseWatchArgs, WATCH_USAGE } from "./options.js";
+export { formatNumber, formatSigned, renderJson, renderText } from "./render.js";
+export { runWatch } from "./run.js";
+export { createIgnorePredicate, createStreamSink, CryptoRandom, STATE_DIR_NAME, stripAnsi, SystemClock, } from "./runtime.js";
+export { runWatchCli } from "./cli.js";
+//# sourceMappingURL=index.js.map

package/dist/commands/watch/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/watch/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAOnE,OAAO,EACL,eAAe,EACf,WAAW,EACX,YAAY,EACZ,cAAc,EACd,SAAS,EACT,WAAW,EACX,SAAS,GACV,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAiB5D,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3D,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEpC,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,SAAS,EACT,WAAW,GACZ,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC"}