@animus-ui/cli 0.1.11 → 0.1.14

package/dist/signals.d.ts

@@ -0,0 +1,23 @@
+/** Listeners run on the event loop, so a handler never lands inside the
+ *  writer's synchronous swap; with none the kernel kills mid-publish. */
+/** Signal exit conventions (128 + signal number). */
+export declare const EXIT_SIGINT = 130;
+export declare const EXIT_SIGTERM = 143;
+/** `abandoned` means a second signal cut an unfinished drain short. */
+export interface ShutdownOutcome {
+    exitCode: number;
+    signal: string;
+    abandoned: boolean;
+}
+export interface ShutdownHandlers {
+    /** Called once. An abandoned outcome must give up the SAME claims as a
+     *  drained one, or `lock.json` outlives the process. */
+    release: (outcome: ShutdownOutcome) => void;
+    /** Bounded work that must finish before the claim is given up; a second
+     *  signal during it abandons the drain and exits at once. */
+    drain?: (exitCode: number, signal: string) => Promise<void>;
+}
+/** Removal is mandatory on the normal path: `main()` is re-enterable in
+ *  process, so a listener left behind accumulates one per call. */
+export declare function installShutdownSignals({ release, drain, }: ShutdownHandlers): () => void;
+//# sourceMappingURL=signals.d.ts.map

package/dist/signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signals.d.ts","sourceRoot":"","sources":["../src/signals.ts"],"names":[],"mappings":"AAAA;yEACyE;AAEzE,qDAAqD;AACrD,eAAO,MAAM,WAAW,MAAM,CAAC;AAC/B,eAAO,MAAM,YAAY,MAAM,CAAC;AAShC,uEAAuE;AACvE,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B;4DACwD;IACxD,OAAO,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,CAAC;IAC5C;iEAC6D;IAC7D,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D;AAED;mEACmE;AACnE,wBAAgB,sBAAsB,CAAC,EACrC,OAAO,EACP,KAAK,GACN,EAAE,gBAAgB,GAAG,MAAM,IAAI,CAmC/B"}

package/dist/watch.d.ts

@@ -1,70 +1,21 @@
-/**
- * `animus watch` — the session's watcher loop as a long-lived foreground
- * process (openspec: standalone-extraction-cli, design D5 watch half).
- *
- * Contract:
- * - Readiness is an explicit observable event distinct from idle: ONE
- *   structured stderr `watch ready` line after the first complete,
- *   consistent publication (plus the session status artifact's additive
- *   monotonic `ready` field, schema-bumped compatibly).
- * - Mid-run failures keep last-good output and report per-cycle on stderr;
- *   every publication goes through the SAME deterministic CLI writer as
- *   `animus build` (design D3) and the advisory lock is held for the
- *   watch's lifetime.
- * - Watch-capability degradation is loud and names roots: a persistent
- *   stderr warning per unwatched root at every publication, and
- *   `--fail-on-degraded` for orchestrators that would rather die (exit 3).
- * - The process stays alive on purpose: the session watcher unrefs every
- *   handle (it must never hold a plugin host's process open), so the CLI
- *   holds its own ref'd keepalive. SIGINT exits 130, SIGTERM 143, both
- *   releasing the lock and removing the session tree — a watch keeps its
- *   session tree alive WHILE RUNNING (transform consumers may exist) and
- *   removes it on clean shutdown, unlike build's publish-then-remove.
- *
- * COORDINATION: `external-source-watch-ingestion` owns watch-ingestion
- * semantics — this verb consumes `startTurbopackWatcher` and
- * `handleWatchUpdate` as-is (the per-cycle wrapper below only observes
- * cycle boundaries to drive publication policy; it forks no ingestion
- * behavior).
- */
 import type { ResolvedCliConfig } from './config';
 export interface WatchFlags {
-    /** Exit (code 3) instead of running degraded when any root is unwatched. */
     failOnDegraded: boolean;
 }
 export interface DegradedRoot {
     root: string;
     reason: string;
 }
-/**
- * The degradation list for one publication — every root whose edits the
- * watch will NOT observe, with the reason. Sources:
- * - the project root itself when the platform watcher could not start
- *   (recursive fs.watch unavailable / registration failed — the session
- *   degrades to no-watch with a warning and returns no handle);
- * - external roots resolved through node_modules (documented unwatchable —
- *   the orchestrator never registers them; its own guardrail-G2 comment on
- *   `openExternalWatcher`'s early return);
- * - external roots whose watcher failed after registration (the session's
- *   sticky `external-watch:` diagnostics, which carry the reason).
- */
+export type ProjectWatchState = 'active' | 'unavailable' | 'already-watched';
 export declare function collectDegradedRoots(inputs: {
     projectRoot: string;
-    projectWatchActive: boolean;
+    projectWatch: ProjectWatchState;
     externalWatchRoots: readonly string[];
     stickyDiagnostics: ReadonlyMap<string, string>;
 }): DegradedRoot[];
-/** One persistent stderr warning per unwatched root (design D5: loud,
- *  names the root and the consequence, repeated at every publication —
- *  never a one-shot). */
 export declare function formatDegradedRootLine(entry: DegradedRoot): string;
-/**
- * Run the watch loop. Resolves with the process exit code on shutdown
- * (130 SIGINT / 143 SIGTERM / 3 --fail-on-degraded trip). Startup
- * failures — preflight, first pipeline, first publication — THROW with
- * the same taxonomy as build: readiness is a contract (NS3), so a
- * supervisor either observes the ready event or observes a nonzero exit,
- * never a silent hang with no first publication.
- */
+export declare function formatCyclePublishFailure<Thrown>(outDir: string, error: Thrown): string;
+/** Resolves with the process exit code at shutdown. Startup failures throw,
+ *  so a supervisor sees either `watch ready` or a nonzero exit, never a hang. */
 export declare function runWatch(config: ResolvedCliConfig, flags: WatchFlags): Promise<number>;
 //# sourceMappingURL=watch.d.ts.map

package/dist/watch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../src/watch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAsBH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAalD,MAAM,WAAW,UAAU;IACzB,4EAA4E;IAC5E,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,iBAAiB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChD,GAAG,YAAY,EAAE,CA6BjB;AAED;;yBAEyB;AACzB,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAElE;AAYD;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,UAAU,GAChB,OAAO,CAAC,MAAM,CAAC,CAiLjB"}
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../src/watch.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AASlD,MAAM,WAAW,UAAU;IACzB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,aAAa,GAAG,iBAAiB,CAAC;AAS7E,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,iBAAiB,CAAC;IAChC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,iBAAiB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChD,GAAG,YAAY,EAAE,CA0BjB;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAElE;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAC9C,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,MAAM,CAKR;AAgBD;iFACiF;AACjF,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,UAAU,GAChB,OAAO,CAAC,MAAM,CAAC,CAwMjB"}

package/dist/writer.d.ts

@@ -1,15 +1,5 @@
-/**
- * Deterministic fixed-path artifact writer (design D3): raw payload bytes —
- * no session envelope, no per-invocation identity — staged into a private
- * subdirectory, VERIFIED there, then renamed into place with `commit.json`
- * LAST carrying content hashes of every payload (asset files included), so
- * a reader holding only the record and the payload bytes can verify set
- * completeness and consistency — and a publication that cannot verify
- * never replaces the previous generation. A single-writer advisory lock
- * fails loud instead of last-writer-wins; the lock never outlives the
- * invocation, so repeated identical builds are byte-identical trees.
- */
-import type { SessionAsset } from '@animus-ui/extract/session';
+import { AnimusConfigError } from '@animus-ui/extract/pipeline';
+import type { CommitRecord, SessionAsset } from '@animus-ui/extract/session';
 export declare const STYLES_FILE = "styles.css";
 export declare const SYSTEM_PROPS_FILE = "system-props.js";
 export declare const MANIFEST_FILE = "manifest.json";
@@ -20,40 +10,33 @@ export interface ArtifactPayloads {
     stylesCss: string;
     systemPropsJs: string;
     manifestJson: string;
-    /** The session's copied asset() files (`collectSessionAssets` output),
-     *  published under `assets/<name>` beside styles.css — the stylesheet's
+    /** Published under `assets/<name>` beside styles.css — the stylesheet's
      *  relative urls dangle without them. */
     assets?: readonly SessionAsset[];
 }
-export interface CommitRecord {
-    schema: 1;
-    payloads: Record<string, {
-        hash: string;
-    }>;
-}
-/** Publication rejected by the pre-swap consistency check: the staged set
- *  did not verify, and the previous generation was left untouched. */
+/** Rejected by the pre-swap consistency check: the staged set did not
+ *  verify, and the previous generation was left untouched. */
 export declare class PublishInconsistencyError extends Error {
     readonly failures: string[];
     constructor(failures: string[]);
 }
-/** Take the single-writer advisory lock, failing loud on a live holder.
- *  Returns a release function. */
+export declare class PublishSwapIncompleteError<Thrown> extends Error {
+    readonly outDir: string;
+    /** Names replaced before the failure, in swap order. */
+    readonly landed: readonly string[];
+    readonly failure: Thrown;
+    constructor(outDir: string, 
+    /** Names replaced before the failure, in swap order. */
+    landed: readonly string[], failure: Thrown);
+}
+/** A refused claim on the output tree: another process owns it, or its lock
+ *  cannot be proven dead. Extends `AnimusConfigError`, so it exits 2. */
+export declare class AnimusLockConflictError extends AnimusConfigError {
+    constructor(message: string);
+}
+/** Take the single-writer advisory lock; a live holder is a hard failure. */
 export declare function acquireLock(outDir: string): () => void;
-/**
- * Publish the payload set. The set is STAGED into a private subdirectory,
- * verified there (recompute-and-compare, the same check
- * `verifyPublishedSet` runs), and only a verified set is renamed into
- * place: payloads first, asset files next, the commit record LAST. A set
- * that cannot verify throws `PublishInconsistencyError` with the previous
- * generation untouched — "keeping last-good artifacts" must be literally
- * true for the watch loop's rejection path. The record carries only
- * content-derived data (asset entries sorted by name) so the full tree is
- * byte-identical across identical-input runs.
- */
+/** Staged, verified, then renamed into place with the commit record LAST. A
+ *  set that cannot verify throws with the previous generation untouched. */
 export declare function publishArtifacts(outDir: string, payloads: ArtifactPayloads): CommitRecord;
-/** The documented consistency check — the session-shared implementation
- *  (published-set.ts): recompute every payload hash raw-bytes and compare
- *  against the commit record. Returns failure lines (empty = consistent). */
-export declare function verifyPublishedSet(outDir: string): string[];
 //# sourceMappingURL=writer.d.ts.map

package/dist/writer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../src/writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAsBH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAM/D,eAAO,MAAM,WAAW,eAAkB,CAAC;AAC3C,eAAO,MAAM,iBAAiB,oBAAwB,CAAC;AACvD,eAAO,MAAM,aAAa,kBAAoB,CAAC;AAC/C,eAAO,MAAM,WAAW,gBAAsB,CAAC;AAC/C,eAAO,MAAM,SAAS,cAAoB,CAAC;AAC3C,eAAO,MAAM,UAAU,WAAqB,CAAC;AAE7C,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB;;6CAEyC;IACzC,MAAM,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;CAClC;AAED,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;sEACsE;AACtE,qBAAa,yBAA0B,SAAQ,KAAK;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE;IAAvC,YAAqB,QAAQ,EAAE,MAAM,EAAE,EAKtC;CACF;AAED;kCACkC;AAClC,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,CAsDtD;AA4BD;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,gBAAgB,GACzB,YAAY,CA+Ed;AAED;;6EAE6E;AAC7E,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAE3D"}
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../src/writer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAe,MAAM,6BAA6B,CAAC;AA4B7E,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAI7E,eAAO,MAAM,WAAW,eAAkB,CAAC;AAC3C,eAAO,MAAM,iBAAiB,oBAAwB,CAAC;AACvD,eAAO,MAAM,aAAa,kBAAoB,CAAC;AAC/C,eAAO,MAAM,WAAW,gBAAsB,CAAC;AAC/C,eAAO,MAAM,SAAS,cAAoB,CAAC;AAC3C,eAAO,MAAM,UAAU,WAAqB,CAAC;AAE7C,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB;6CACyC;IACzC,MAAM,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;CAClC;AAYD;8DAC8D;AAC9D,qBAAa,yBAA0B,SAAQ,KAAK;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE;IAAvC,YAAqB,QAAQ,EAAE,MAAM,EAAE,EAKtC;CACF;AAED,qBAAa,0BAA0B,CAAC,MAAM,CAAE,SAAQ,KAAK;IAEzD,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,wDAAwD;IACxD,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM;IAJ1B,YACW,MAAM,EAAE,MAAM;IACvB,wDAAwD;IAC/C,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,OAAO,EAAE,MAAM,EASzB;CACF;AAED;yEACyE;AACzE,qBAAa,uBAAwB,SAAQ,iBAAiB;IAC5D,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAmDD,6EAA6E;AAC7E,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,CAoDtD;AAmBD;4EAC4E;AAC5E,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,gBAAgB,GACzB,YAAY,CA8Ed"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@animus-ui/cli",
-  "version": "0.1.11",
+  "version": "0.1.14",
   "description": "Standalone Animus extraction CLI — one-shot builds and artifact emission for any build system",
   "keywords": [
     "animus",
@@ -41,7 +41,7 @@
     "compile": "tsc --noEmit"
   },
   "dependencies": {
-    "@animus-ui/extract": "0.1.11"
+    "@animus-ui/extract": "0.1.14"
   },
   "engines": {
     "node": ">=22.12.0"