@animus-ui/extract 0.1.11 → 0.1.12

package/dist/session/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../session/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC3E,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,UAAU,EACV,qBAAqB,EACrB,eAAe,EACf,yBAAyB,GAC1B,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,cAAc,EACd,cAAc,EACd,eAAe,GAChB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,EACL,0BAA0B,EAC1B,SAAS,EACT,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,YAAY,EACZ,qBAAqB,EACrB,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,GAChB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../session/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC3E,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,EACL,iBAAiB,EACjB,8BAA8B,EAC9B,uBAAuB,EACvB,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,eAAe,EACf,aAAa,EACb,YAAY,EACZ,YAAY,GACb,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,UAAU,EACV,qBAAqB,EACrB,eAAe,EACf,yBAAyB,GAC1B,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,cAAc,EACd,cAAc,EACd,eAAe,GAChB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,SAAS,EACT,yBAAyB,EACzB,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,YAAY,EACZ,qBAAqB,EACrB,wBAAwB,EACxB,oBAAoB,EACpB,yBAAyB,EACzB,eAAe,GAChB,MAAM,aAAa,CAAC"}

package/dist/session/published-set.d.ts

@@ -1,32 +1,52 @@
-/**
- * The CLI published-set contract, shared logic (openspec:
- * standalone-extraction-cli D3): ONE implementation of "does this flat
- * artifact set verify against its commit record" and ONE collector for the
- * session's copied asset() files — consumed by the CLI writer
- * (staging/verification) and the session's start hygiene (confinement
- * gate). Two copies of either had already drifted once: the hygiene copy
- * verified payloads as UTF-8 strings while the writer hashed raw bytes, so
- * any asset-carrying set (fonts are not UTF-8) could never verify and a
- * legitimately published set was classified as debris.
- */
-/**
- * Recompute every payload hash recorded in the directory's commit record
- * and compare — raw bytes on both sides, matching the writer's hashing
- * domain. Returns failure lines; empty means the set verifies. An absent
- * or unparsable record is itself a failure (the record is written LAST, so
- * a torn or aborted publish cannot verify).
- */
+export interface CommitRecord {
+    schema: 1;
+    payloads: Record<string, {
+        hash: string;
+    }>;
+}
+export declare function decodeCommitRecord(bytes: string): CommitRecord | null;
+/** Recompute every recorded payload hash over raw bytes — the writer's own
+ *  hashing domain — and return the mismatches; empty means the set verifies. */
 export declare function verifyCommitRecord(dir: string): string[];
-/** One published asset file: its session-relative name and raw bytes. */
+export interface CliLockRecord {
+    pid: number;
+    startedAt?: string;
+    heartbeatAt?: string;
+}
+export declare const CLI_LOCK_HEARTBEAT_INTERVAL_MS = 60000;
+/** A claim whose heartbeat is older than this has no live holder. Five missed
+ *  refreshes: synchronous extraction can block the holder's refresh timer. */
+export declare const CLI_LOCK_STALE_AFTER_MS: number;
+export type CliLockLiveness = {
+    live: true;
+} | {
+    live: false;
+    reason: string;
+};
+export type CliLockRead = {
+    kind: 'none';
+} | {
+    kind: 'held';
+    record: CliLockRecord;
+} | {
+    kind: 'indeterminate';
+};
+export declare function readCliLockRecord(dir: string): CliLockRead;
+export declare function isLockHolderAlive(pid: number): boolean;
+export declare function checkLockLiveness(record: CliLockRecord): CliLockLiveness;
+export declare function lockRecordBytes(startedAt: string): string;
+export interface DirectoryClaimOptions {
+    /** `in-place` (default) keeps a watched directory's mtime still — renaming
+     *  every interval starts phantom rebuilds; `rename` avoids torn reads. */
+    write?: 'in-place' | 'rename';
+    startedAt?: string;
+}
+export declare function holdDirectoryClaim(dir: string, options?: DirectoryClaimOptions): () => void;
 export interface SessionAsset {
     name: string;
     bytes: Buffer;
 }
-/**
- * Snapshot the session's copied asset() files (sorted by name) — read
- * BEFORE the session tree is disposed. The emitted stylesheet references
- * them as `./assets/<name>`, so every driver must publish them beside its
- * stylesheet or the urls dangle.
- */
+/** Snapshot the session's copied asset() files, sorted, BEFORE the session
+ *  tree is disposed. Drivers publish them beside the emitted stylesheet. */
 export declare function collectSessionAssets(sessionDir: string | null): SessionAsset[];
 //# sourceMappingURL=published-set.d.ts.map

package/dist/session/published-set.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"published-set.d.ts","sourceRoot":"","sources":["../../session/published-set.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAQH;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CA6BxD;AAED,yEAAyE;AACzE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,GAAG,IAAI,GACxB,YAAY,EAAE,CAOhB"}
+{"version":3,"file":"published-set.d.ts","sourceRoot":"","sources":["../../session/published-set.ts"],"names":[],"mappings":"AA2CA,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,CAAC,CAAC;IACV,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5C;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAiBrE;AAED;gFACgF;AAChF,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAuBxD;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,8BAA8B,QAAS,CAAC;AAErD;8EAC8E;AAC9E,eAAO,MAAM,uBAAuB,QAAqC,CAAC;AAE1E,MAAM,MAAM,eAAe,GAAG;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/E,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,CAAC;AAgB9B,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CA0B1D;AAYD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOtD;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,eAAe,CAmBxE;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAMzD;AAID,MAAM,WAAW,qBAAqB;IACpC;8EAC0E;IAC1E,KAAK,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,qBAA0B,GAClC,MAAM,IAAI,CAwCZ;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED;4EAC4E;AAC5E,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,GAAG,IAAI,GACxB,YAAY,EAAE,CAOhB"}

package/dist/session/resolve-packages.d.ts

@@ -1,8 +1,7 @@
-/**
- * Resolve external DS package specifiers to rootDir-relative entry paths.
- * Node-generic (no webpack APIs): Pass 1 walks the consumer's workspaces for
- * matching package names; Pass 2 falls back to `require.resolve`. Specifiers
- * that resolve nowhere are simply omitted (spec: silent skip).
- */
-export declare function resolvePackagesByName(rootDir: string, names: string[]): Record<string, string>;
+/** Package specifier → rootDir-relative entry path. An unresolved specifier
+ *  has no key at all, never a key with an empty target. */
+export interface ResolvedPackageMap {
+    [specifier: string]: string;
+}
+export declare function resolvePackagesByName(rootDir: string, names: string[]): ResolvedPackageMap;
 //# sourceMappingURL=resolve-packages.d.ts.map

package/dist/session/resolve-packages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-packages.d.ts","sourceRoot":"","sources":["../../session/resolve-packages.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EAAE,GACd,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA0DxB"}
+{"version":3,"file":"resolve-packages.d.ts","sourceRoot":"","sources":["../../session/resolve-packages.ts"],"names":[],"mappings":"AAGA;2DAC2D;AAC3D,MAAM,WAAW,kBAAkB;IACjC,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;CAC7B;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EAAE,GACd,kBAAkB,CA8CpB"}

package/dist/session/session-paths.d.ts

@@ -1,30 +1,19 @@
 /**
- * Session-scoped artifact names, path derivations, and the analysis-status
- * shape (openspec: next-turbopack-served-transform-coherence, design D1–D3)
- * — shared by the session writer (extraction-session), the webpack
- * plugin/loader, and the Turbopack loader.
- *
- * Deliberately free of singleton/session imports: the Turbopack loader
- * executes in isolated worker processes and its module graph must stay
- * worker-local (guardrail G1) — this module is pure path/shape vocabulary.
+ * Session artifact names, path derivations, and artifact shapes. Imports no
+ * session or singleton module: the Turbopack loader graph stays worker-local.
  */
-/** Session-dir-relative name of the replacement-epoch disk witness
- *  (openspec: next-webpack-served-transform-coherence, design D2;
- *  session-scoped by next-turbopack-served-transform-coherence D2). */
+/** Session-dir-relative name of the replacement-epoch disk witness. */
 export declare const REPLACEMENT_EPOCH_ARTIFACT = "replacements-epoch";
-/** Virtual module id of the emitted system-props module — session
- *  vocabulary shared by the orchestrator and the Turbopack config
- *  assembly (hoisted here so the session home stays framework-free). */
+/** Virtual module id of the emitted system-props module. */
 export declare const TURBOPACK_SYSTEM_PROPS_ID = "virtual:animus/system-props";
-/** Session-dir-relative name of the analysis-commit transaction artifact
- *  (design D1). */
+/** Session-dir-relative name of the analysis-commit transaction artifact. */
 export declare const ANALYSIS_COMMIT_ARTIFACT = "analysis-commit";
-/** Session-dir-relative name of the analysis-status artifact (design D3). */
+/** Session-dir-relative name of the analysis-status artifact. */
 export declare const ANALYSIS_STATUS_ARTIFACT = "analysis-status.json";
 /** Session-dir-relative name of the manifest payload artifact. */
 export declare const MANIFEST_ARTIFACT = "manifest.json";
-/** Session-dir-relative name of the analysis-inputs payload artifact
- *  (Turbopack loader-worker hydration corpus). */
+/** Session-dir-relative name of the analysis-inputs payload artifact — the
+ *  Turbopack loader-worker hydration corpus. */
 export declare const ANALYSIS_INPUTS_ARTIFACT = "analysis-inputs.json";
 /** Session-dir-relative name of the emitted stylesheet artifact. */
 export declare const STYLES_ARTIFACT = "styles.css";
@@ -32,46 +21,31 @@ export declare const STYLES_ARTIFACT = "styles.css";
 export declare const SYSTEM_PROPS_ARTIFACT = "system-props.js";
 /** Session-dir-relative directory holding copied asset() files. */
 export declare const SESSION_ASSETS_DIR = "assets";
-/** The standalone CLI's published-set commit record, written into the flat
- *  `.animus/` tree (openspec: standalone-extraction-cli D3). Shared here so
- *  the CLI writer and the session's start hygiene agree on ONE name — the
- *  hygiene confinement gate keys on this record, and a renamed literal on
- *  either side would silently re-arm deletion of the CLI's published output. */
+/** The standalone CLI's published-set commit record in the flat `.animus/`
+ *  tree; the session's start hygiene keys on this name before deleting. */
 export declare const CLI_COMMIT_ARTIFACT = "commit.json";
-/** The standalone CLI's single-writer advisory lock in the flat `.animus/`
- *  tree. A live holder means a CLI invocation owns that tree right now. */
+/** Advisory claim record (pid plus heartbeat) of whichever directory holds
+ *  it; sessions write it into their own tree too, despite the `CLI_` name. */
 export declare const CLI_LOCK_ARTIFACT = "lock.json";
-/** Root of every session-scoped artifact tree for a project. */
+/** Project-relative artifact directory: the CLI's default output tree and
+ *  the parent of every session tree. One spelling, or the tree splits. */
+export declare const ANIMUS_ARTIFACT_DIR = ".animus";
+/** Module id the Rust emitter injects, and the alias key both bundlers
+ *  register. A literal on purpose: a rename breaks built consumer packages.
+ *  The Next plugin's webpack alias harvest skips this exact key, so a change
+ *  here is a change in the emitter, both bundler arms and that harvest. */
+export declare const ANIMUS_CSS_MODULE_ID = ".animus/styles.css";
 export declare function sessionsRootDir(rootDir: string): string;
-/** One session's artifact directory (design D2: session-scoped trees,
- *  no global pointer). */
 export declare function sessionArtifactDir(rootDir: string, sessionId: string): string;
-/** Absolute path of a session's replacement-epoch artifact — the single
- *  derivation shared by the session writer, the webpack plugin's
- *  watch-ignore entry, and both loaders' file dependencies. Takes the
- *  SESSION directory (not the project root) since the artifact was
- *  relocated into the session tree. */
 export declare function replacementEpochPath(sessionDir: string): string;
-/** Absolute path of a session's analysis-commit artifact. */
 export declare function analysisCommitPath(sessionDir: string): string;
-/** Absolute path of a session's analysis-status artifact. */
 export declare function analysisStatusPath(sessionDir: string): string;
-/** Absolute path of a session's manifest artifact. */
 export declare function manifestPath(sessionDir: string): string;
-/** Absolute path of a session's analysis-inputs artifact. */
 export declare function analysisInputsPath(sessionDir: string): string;
-/** Absolute path of a session's stylesheet artifact. */
 export declare function stylesPath(sessionDir: string): string;
-/** Absolute path of a session's system-props module artifact. */
 export declare function systemPropsPath(sessionDir: string): string;
-/** Session-scoped analysis-status shape (design D3). Successful loader
- *  invocations never depend on it; it exists so a loader observing a
- *  source/commit mismatch can decide — on evidence — whether to wait.
- *
- *  Schema 2 (openspec: standalone-extraction-cli, watch readiness) adds the
- *  additive `ready` field; every other field is unchanged, so schema-1
- *  readers keep working (no reader branches on the schema value — the bump
- *  records the shape revision for artifact archaeology). */
+/** Advisory: a loader reads it only after observing a source/commit
+ *  mismatch, to decide whether to wait. No reader branches on `schema`. */
 export interface AnalysisStatus {
     schema: 1 | 2;
     sessionId: string;
@@ -82,50 +56,42 @@ export interface AnalysisStatus {
     /** Epoch-ms deadline for the active attempt (debounce ceiling + 2s). */
     deadlineAt: number;
     diagnostic?: string;
-    /** Monotonic first-emission witness (additive, schema 2): absent or false
-     *  until the session's FIRST successful complete publication, true on
-     *  every status write after it — including 'failed' writes, which is what
-     *  makes readiness distinct from `state: 'idle'` (idle recurs per attempt;
-     *  ready never regresses within a session). */
+    /** False until the session's first complete publication, true on every
+     *  later write including failures; never regresses within a session. */
     ready?: boolean;
 }
-/** analysis-commit artifact shape (design D1: the transaction identity —
- *  hashes are of the DISK payload bytes, envelope included). `inputsHash`
- *  is present only when the hydration corpus is persisted (Turbopack
- *  orchestration); webpack-mode commits omit it (spec:
- *  next-turbopack-integration, "Webpack mode skips the hydration corpus"). */
+/** Transaction identity: every hash is of the DISK payload bytes, envelope
+ *  included. `inputsHash` is absent when no hydration corpus is persisted. */
 export interface AnalysisCommit {
     schema: 1;
     sessionId: string;
+    /** Forensic ordinal only: no reader decides anything from it, and it is
+     *  monotonic per session directory only because publication is exclusive. */
     generation: number;
     replacementEpoch: string;
     manifestHash: string;
     inputsHash?: string;
     stylesHash: string;
 }
-/** Envelope embedded in every payload artifact (design D2: sessionId in
- *  every artifact; payloadHash lets a same-session restart seed its write
- *  guards without byte-reconstructing the payload). */
+/** Embedded in every payload artifact; `payloadHash` lets a same-session
+ *  restart seed its write guards without rebuilding the payload bytes. */
 export interface SessionEnvelope {
     sessionId: string;
     generation: number;
     replacementEpoch: string;
     payloadHash: string;
 }
-/** Splice the session envelope into a JSON-object payload as a leading
- *  `__animusSession` field, byte-preserving the payload's own content
- *  (parse/re-stringify could reformat engine-emitted JSON). */
+/** Splices the envelope in as a leading `__animusSession` field without
+ *  re-serializing: parse/re-stringify would reformat engine-emitted JSON. */
 export declare function envelopeJsonArtifact(payload: string, envelopeJson: string): string;
-/** Trailing-comment side-band for the CSS artifact (a leading comment
- *  would displace the @layer declaration consumers pin at offset 0). */
+/** Trailing-comment side-band: a leading comment would displace the `@layer`
+ *  declaration consumers pin at offset 0. */
 export declare function envelopeCssArtifact(payload: string, envelopeJson: string): string;
-/** Matches the CSS artifact's envelope side-band. */
 export declare const ENVELOPE_CSS_COMMENT_RE: RegExp;
-/** Envelope of a JSON artifact's bytes, or undefined when the artifact
- *  carries none. THROWS on unparseable bytes — callers decide whether a
- *  torn artifact fails closed or degrades. */
+/** Envelope of a JSON artifact's bytes, or undefined when it carries none.
+ *  Throws on unparseable bytes; callers decide torn-artifact policy. */
 export declare function readJsonEnvelope(bytes: string): SessionEnvelope | undefined;
-/** Envelope of the CSS artifact's side-band comment, or undefined when the
- *  side-band is absent. THROWS on an unparseable envelope body. */
+/** Envelope of the CSS side-band comment, or undefined when it is absent.
+ *  Throws on an unparseable envelope body. */
 export declare function readCssEnvelope(bytes: string): SessionEnvelope | undefined;
 //# sourceMappingURL=session-paths.d.ts.map

package/dist/session/session-paths.d.ts.map

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

package/dist/session/singleton.d.ts

@@ -1,8 +1,12 @@
 export declare function getManifestJson(): string | null;
 export declare function setManifestJson(json: string): void;
-export declare function getAnalysisPromise(): Promise<void> | null;
-export declare function setAnalysisPromise(promise: Promise<void>): void;
-export declare function resetAnalysisPromise(): void;
+/**
+ * A latch over the most recently STARTED analysis, never cleared on settle:
+ * non-null means one was scheduled. In-flight lives in getWatchTransaction.
+ */
+export declare function getAnalysisStartedPromise(): Promise<void> | null;
+export declare function setAnalysisStartedPromise(promise: Promise<void>): void;
+export declare function resetAnalysisStartedPromise(): void;
 export declare function getSharedCss(): string;
 export declare function setSharedCss(css: string): void;
 export declare function getSharedSystemProps(): string;
@@ -11,9 +15,8 @@ export declare function getSharedExternalDirs(): string[];
 export declare function setSharedExternalDirs(dirs: string[]): void;
 export declare function getSharedExternalEntries(): Map<string, string>;
 export declare function setSharedExternalEntries(entries: Map<string, string>): void;
-/** Structural view of the owning session a forwarded watch batch targets —
- *  kept minimal (and defined here, not imported) so the singleton never
- *  depends on the session module it serves. */
+/** Structural view of the target session, declared here rather than imported
+ *  so the singleton never depends on the session module it serves. */
 export interface WatchBatchTarget {
     ingestForwardedBatch(changes: {
         modifiedFiles?: ReadonlySet<string>;
@@ -21,104 +24,62 @@ export interface WatchBatchTarget {
     }): Promise<void>;
 }
 /**
- * The session that completed the full pipeline and holds system state — the
- * only instance that can run watch analysis. Each MultiCompiler child holds
- * its own session AND its own watcher with its own modified set; a
- * non-owning session forwards its batch here instead of dropping it (a file
- * only that compiler watches would otherwise never be analyzed).
+ * The only session that can run watch analysis. A non-owning session forwards
+ * its batch here; dropping it loses files only that watcher sees.
  */
 export declare function getOwningWatchSession(): WatchBatchTarget | null;
 export declare function setOwningWatchSession(session: WatchBatchTarget | null): void;
 /**
- * Per-file analyzed content hashes of the last published analysis (relPath →
- * contentHash of the exact bytes analyzed) — the loader's witness for the
- * unconditional catching-up guard (openspec:
- * next-webpack-served-transform-coherence, design D4). Includes files
- * analyzed with ZERO animus entries: analyzed identity is membership in the
- * analysis input set, not manifest entry count.
+ * Per-file content hashes of the last published analysis (relPath → hash of
+ * the exact bytes analyzed), including files that produced zero entries.
  */
 export declare function getAnalyzedHashes(): ReadonlyMap<string, string> | null;
 export declare function setAnalyzedHashes(hashes: Map<string, string>): void;
 /**
- * Session identity is per Next INVOCATION — one process, however many
- * compiler instances it holds (openspec:
- * next-turbopack-served-transform-coherence, design D2). The first
- * ExtractionSession constructed in a process claims a fresh randomUUID;
- * every later instance (client/server/RSC compilers each construct one)
- * adopts it, so all compilers alias, watch-ignore, and publish ONE
- * session-scoped artifact tree. Separate invocations (`next dev` +
- * `next build` co-writing) are separate processes and therefore separate
- * sessions by construction.
+ * Session identity is per process: the first caller claims a fresh id and
+ * every later one adopts it, so all compilers share one artifact tree.
  */
 export declare function claimProcessSessionId(): string;
 /**
- * Exclusive-ownership claim over the process-global session state — the
- * hard form of the invariant `claimProcessSessionId` documents softly. The
- * shared slots above (manifest, css, artifact dir) plus the one session id
- * mean two CONCURRENT drive loops in one process (a webpack MultiCompiler
- * array config, parallel rollup array builds, two programmatic CLI runs)
- * would share one session directory, overwrite each other's manifests, and
- * delete each other's live trees on dispose. Drivers that run the loop
- * exclusively (the unplugin host) claim for the build's lifetime and
- * release on dispose; SEQUENTIAL claim/release cycles are legal. The Next
- * multi-compiler adoption path stays the non-exclusive default. Throws
- * naming both hosts and the remediation on overlap. The key lives in
- * `SINGLETON_GLOBAL_KEYS`, so per-test global resets clear a leaked claim.
+ * Two CONCURRENT drive loops in one process would share one session tree and
+ * clobber each other; sequential claim/release cycles are legal.
  */
 export declare function claimExclusiveSessionOwner(label: string): () => void;
 /**
- * Absolute session artifact directory of the OWNING session's last
- * publication — the webpack loader's source for the session-scoped epoch
- * dependency path (the loader shares the process with the pipeline; the
- * Turbopack loader instead receives the directory via its options).
+ * Absolute artifact directory of the OWNING session's last publication. The
+ * Turbopack loader runs out of process and receives it via options instead.
  */
 export declare function getSessionArtifactDir(): string | null;
 export declare function setSessionArtifactDir(dir: string): void;
 /**
- * Canonical replacement epoch of the last published analysis
- * (`hashReplacementPlans(snapshotFilePlans(manifest), systemPropsContent)`
- * — openspec: next-webpack-served-transform-coherence, design D5; the
- * served system-props module rides as the served-dependency witness so
- * offline system-props changes move the epoch). Published by the
- * owning session AFTER the manifest so a reader that observes the epoch
- * always observes at least that generation's manifest. (Session
- * attribution lives on the DISK epoch artifact — no in-process mirror.)
+ * Replacement epoch of the last published analysis, written AFTER the
+ * manifest so an epoch reader always sees at least that generation's manifest.
  */
 export declare function getReplacementEpoch(): string | null;
 export declare function setReplacementEpoch(epoch: string): void;
 /**
- * The one in-flight watch-analysis transaction (design D3): the first
- * compiler entering a watch batch runs analysis + publication; every other
- * compiler (client/server/RSC — each holds its own session instance) joins
- * this promise instead of proceeding against a pre-transaction generation.
+ * The one in-flight watch-analysis transaction: a compiler that did not start
+ * it joins this promise rather than read a pre-transaction generation.
  */
 export declare function getWatchTransaction(): Promise<void> | null;
 export declare function setWatchTransaction(transaction: Promise<void> | null): void;
 export type AnimusEngine = 'v2';
-/** Engine selection travels through the singleton so non-owning compiler
- *  instances and the webpack loader honor the same choice as the owner. */
+/** Engine selection travels through the singleton so non-owning compilers
+ *  and the webpack loader honor the owner's choice. */
 export declare function setSharedEngine(engine: AnimusEngine): void;
 export declare function getSharedEngine(): AnimusEngine;
-/** Single engine choke-point for every native extraction call. Return type
- *  mirrors the untyped `require` the call sites previously used — the NAPI
- *  module's own .d.ts is the authoritative surface. */
+/** Single choke-point for every native extraction call; the NAPI module's
+ *  own `.d.ts` is the authoritative surface for what it returns. */
 export declare function requireEngine(): any;
 /**
- * Test seam (injected-fn pattern — module mocks cannot reach a bundled
- * dist copy of this module): inject a replacement engine API. GlobalThis-
- * keyed so every copy of this module — source-imported, dist-imported,
- * ESM/CJS dual-load — honors the one override. Deliberately NOT in
- * SINGLETON_GLOBAL_KEYS: the override's lifecycle belongs to the test
- * file, and per-test global resets must not strip it mid-suite. Pass null
- * to restore the native-backed API.
+ * Test seam, set once at module top level: this key stays OUT of
+ * SINGLETON_GLOBAL_KEYS so a per-test reset cannot strip the override.
  */
 export declare function setEngineApiOverride(api: (() => any) | null): void;
 export declare function engineApi(): any;
 /**
- * Every globalThis key this module owns EXCEPT the engine-api override
- * (whose lifecycle belongs to the test file that set it — see
- * setEngineApiOverride) — the single authority test harnesses
- * snapshot/clear per test (never re-declare this list).
+ * Every globalThis key this module owns except the engine-api override, which
+ * a per-test reset must not clear. Test harnesses clear exactly this list.
  */
-export declare const SINGLETON_GLOBAL_KEYS: readonly ["__animus_manifest_json__", "__animus_analysis_promise__", "__animus_shared_css__", "__animus_shared_system_props__", "__animus_external_pkg_dirs__", "__animus_external_source_entries__", "__animus_analyzed_hashes__", "__animus_replacement_epoch__", "__animus_watch_transaction__", "__animus_process_session_id__", "__animus_session_artifact_dir__", "__animus_owning_watch_session__", "__animus_exclusive_session_owner__", "__animus_engine__", "__animus_v2_engine__", "__animus_v2_sent_sources__", "__animus_v2_drift_warned__"];
+export declare const SINGLETON_GLOBAL_KEYS: readonly ["__animus_manifest_json__", "__animus_analysis_started__", "__animus_shared_css__", "__animus_shared_system_props__", "__animus_external_pkg_dirs__", "__animus_external_source_entries__", "__animus_analyzed_hashes__", "__animus_replacement_epoch__", "__animus_watch_transaction__", "__animus_process_session_id__", "__animus_session_artifact_dir__", "__animus_owning_watch_session__", "__animus_exclusive_session_owner__", "__animus_engine__", "__animus_v2_engine__", "__animus_v2_sent_sources__", "__animus_v2_drift_warned__"];
 //# sourceMappingURL=singleton.d.ts.map

package/dist/session/singleton.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"singleton.d.ts","sourceRoot":"","sources":["../../session/singleton.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"singleton.d.ts","sourceRoot":"","sources":["../../session/singleton.ts"],"names":[],"mappings":"AAkEA,wBAAgB,eAAe,IAAI,MAAM,GAAG,IAAI,CAE/C;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAElD;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAEhE;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAEtE;AAED,wBAAgB,2BAA2B,IAAI,IAAI,CAElD;AAED,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE9C;AAED,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1D;AAED,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAEhD;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAE1D;AAED,wBAAgB,wBAAwB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAE9D;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAE3E;AA8BD;sEACsE;AACtE,MAAM,WAAW,gBAAgB;IAC/B,oBAAoB,CAAC,OAAO,EAAE;QAC5B,aAAa,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;QACpC,YAAY,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;KACpC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnB;AAID;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,gBAAgB,GAAG,IAAI,CAE/D;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,GAAG,IAAI,CAE5E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAEtE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAEnE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAM9C;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,IAAI,CAiBpE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,GAAG,IAAI,CAErD;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEvD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,GAAG,IAAI,CAEnD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAEvD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAE1D;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI,CAE3E;AAED,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC;AAEhC;uDACuD;AACvD,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAE1D;AAED,wBAAgB,eAAe,IAAI,YAAY,CAI9C;AAED;oEACoE;AAEpE,wBAAgB,aAAa,IAAI,GAAG,CAGnC;AA6BD;;;GAGG;AAEH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,CAAC,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAElE;AAGD,wBAAgB,SAAS,IAAI,GAAG,CAG/B;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,2hBAkBxB,CAAC"}

package/dist/session/timing.d.ts

@@ -1,7 +1,2 @@
-/**
- * Verbose build-timing waterfall: JS phases, analysis sub-phases, and the
- * shared Rust phase table. `ANIMUS_TIMING_JSON=1` additionally dumps a
- * machine-readable merged record.
- */
 export declare function logBuildTimings(bt: Record<string, number>, rustTiming: Record<string, number> | undefined, log: (msg: string) => void, verbose: boolean): void;
 //# sourceMappingURL=timing.d.ts.map

package/dist/session/timing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"timing.d.ts","sourceRoot":"","sources":["../../session/timing.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC1B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EAC9C,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,EAC1B,OAAO,EAAE,OAAO,GACf,IAAI,CAqDN"}
+{"version":3,"file":"timing.d.ts","sourceRoot":"","sources":["../../session/timing.ts"],"names":[],"mappings":"AAEA,wBAAgB,eAAe,CAC7B,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC1B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EAC9C,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,EAC1B,OAAO,EAAE,OAAO,GACf,IAAI,CAkDN"}

package/dist/session/turbopack-orchestrator.d.ts

@@ -1,43 +1,27 @@
 import { watch } from 'fs';
 import type { ExtractionSession } from './extraction-session';
-/**
- * Out-of-band pipeline orchestration for Turbopack (spec:
- * next-turbopack-integration). Turbopack exposes no compiler hooks, so the
- * pipeline runs during next.config resolution and, in dev, from a
- * filesystem watcher — the bundler only ever sees the `.animus/` disk
- * artifacts.
- */
-/** Run the full pipeline with the Turbopack emitter identity: the virtual
- *  system-props id (Turbopack rejects the webpack path's absolute-path
- *  imports). Turbopack orchestration persists the analysis-inputs
- *  hydration corpus — its isolated loader workers replay it (spec:
- *  next-turbopack-integration, "Manifest disk artifact"; webpack mode
- *  skips the corpus). */
 export declare function runSessionPipeline(session: ExtractionSession): Promise<void>;
-/**
- * Start the dev watcher: fs.watch per eligible top-level directory (plus a
- * non-recursive watch on the root itself), debounced into
- * existence-partitioned modified/removed sets feeding
- * `session.handleWatchUpdate` (serialized — updates never overlap).
- * Generated and vendored trees (`.animus`, `.next`, node_modules) are never
- * registered with the OS — recursive registration of those trees exhausts
- * inotify/kqueue descriptors (EMFILE/ENOSPC) on large projects.
- * Idempotent per project root; unref'd so it never holds the process open.
- * Asynchronous FSWatcher errors degrade to no-watch with a warning instead
- * of crashing the dev server. Returns a close handle, or null when this
- * root is already watched or the platform lacks recursive fs.watch (Linux
- * before Node 20 — degrades to no-watch with a warning).
- */
-export declare function startTurbopackWatcher(session: ExtractionSession, rootDir: string, debounceMs?: number, watchFn?: typeof watch): TurbopackWatcherHandle | null;
-/** The project-watch handle `startTurbopackWatcher` returns. `close()` is
- *  caller-initiated teardown; `died` flips only on an ASYNC watcher error
- *  (EMFILE/ENOSPC after registration) with `onDied` invoked once so the
- *  process owner can surface the degradation; `settle()` resolves when the
- *  in-flight update chain has drained. */
+export interface TurbopackWatcherOptions {
+    debounceMs?: number;
+    watchFn?: typeof watch;
+    /** Accumulate observed paths until `deliverHeldEvents()`: a cycle scheduled
+     *  before the first analysis joins the running pipeline and does nothing. */
+    holdEvents?: boolean;
+}
+export declare function startTurbopackWatcher(session: ExtractionSession, rootDir: string, options?: TurbopackWatcherOptions): TurbopackWatchOutcome;
+export type TurbopackWatchOutcome = {
+    kind: 'started';
+    handle: TurbopackWatcherHandle;
+} | {
+    kind: 'already-watched';
+} | {
+    kind: 'unavailable';
+};
 export interface TurbopackWatcherHandle {
     close(): void;
     readonly died: boolean;
     onDied: (() => void) | null;
     settle(): Promise<void>;
+    deliverHeldEvents(): Promise<void>;
 }
 //# sourceMappingURL=turbopack-orchestrator.d.ts.map

package/dist/session/turbopack-orchestrator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"turbopack-orchestrator.d.ts","sourceRoot":"","sources":["../../session/turbopack-orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqC,KAAK,EAAE,MAAM,IAAI,CAAC;AAK9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D;;;;;;GAMG;AAEH;;;;;yBAKyB;AACzB,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CAIf;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,MAAM,EACf,UAAU,SAAK,EAGf,OAAO,GAAE,OAAO,KAAa,GAC5B,sBAAsB,GAAG,IAAI,CAoT/B;AAED;;;;0CAI0C;AAC1C,MAAM,WAAW,sBAAsB;IACrC,KAAK,IAAI,IAAI,CAAC;IACd,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC;IAC5B,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB"}
+{"version":3,"file":"turbopack-orchestrator.d.ts","sourceRoot":"","sources":["../../session/turbopack-orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqC,KAAK,EAAE,MAAM,IAAI,CAAC;AAS9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CAIf;AAkCD,MAAM,WAAW,uBAAuB;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IACvB;iFAC6E;IAC7E,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,uBAA4B,GACpC,qBAAqB,CAqQvB;AAED,MAAM,MAAM,qBAAqB,GAC7B;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,sBAAsB,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,iBAAiB,CAAA;CAAE,GAC3B;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,CAAC;AAE5B,MAAM,WAAW,sBAAsB;IACrC,KAAK,IAAI,IAAI,CAAC;IACd,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC;IAC5B,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC"}