@nwire/forge 0.7.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alex Gefter / 200apps Ltd.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,77 @@
+# @nwire/forge
+
+> Flavor sugar + domain primitives — the aggregation product that composes the framework into one surface.
+
+## What it does
+
+The `define*` surface domain code uses every day: `defineAction` / `defineQuery` (handler sugar), `defineActor` / `defineProjection` / `defineWorkflow` / `defineListener` (domain machinery), `defineEvent`, `defineModule`, `defineApp`, `createApp`, plus the runtime and the InMemory store defaults. Forge doesn't invent primitives — it composes lower packages into the unified DX teams ship features on.
+
+## Install
+
+```bash
+pnpm add @nwire/forge
+```
+
+## Quick start
+
+```ts
+import { z } from "zod";
+import { defineAction, defineActor, defineEvent, defineModule, createApp } from "@nwire/forge";
+
+const StudentWasEnrolled = defineEvent("StudentWasEnrolled", {
+  schema: z.object({ studentId: z.string(), courseId: z.string() }),
+}).public();
+
+const Student = defineActor("Student", {
+  initial: () => ({ enrolments: [] as string[] }),
+  methods: {
+    enrol(state, courseId: string) {
+      return { ...state, enrolments: [...state.enrolments, courseId] };
+    },
+  },
+});
+
+const enrolStudent = defineAction("enrolStudent", {
+  input: z.object({ studentId: z.string(), courseId: z.string() }),
+  emits: [StudentWasEnrolled],
+  handler: async ({ input, use, emit }) => {
+    const student = await use(Student, input.studentId);
+    student.enrol(input.courseId);
+    await emit(StudentWasEnrolled(input));
+  },
+}).public();
+
+export const enrolments = defineModule("enrolments", {
+  actors: [Student],
+  actions: [enrolStudent],
+  events: [StudentWasEnrolled],
+});
+
+export const app = createApp("learnflow", { modules: [enrolments] });
+```
+
+## API surface
+
+- Handler sugar: `defineAction`, `defineQuery`, `defineHandler`, `defineMiddleware`, `pipe`, response helpers.
+- Domain primitives: `defineActor`, `defineProjection`, `defineWorkflow`, `defineListener`, `defineCron`, `defineInbox`, `defineOutbox`, `defineExternalCall`, `defineInboundWebhook`.
+- Composition: `defineModule`, `defineApp`, `createApp`, `definePlugin`.
+- Models/errors: `defineResource`, `defineError`, `defineSchema`.
+- Runtime + InMemory store defaults; `MessageEnvelope` re-exported from `@nwire/envelope`.
+
+## When to use
+
+The default surface for L3+ Nwire apps. Pull `@nwire/forge` directly when you want the full framework DX (actions, actors, projections, workflows, modules) without picking each lower package by hand.
+
+## Used only within nwire-app
+
+This package is part of the Nwire stack — it only makes sense inside a Nwire application built with `@nwire/app` + `@nwire/forge`. If you're looking for a standalone primitive, see:
+
+- [`@nwire/handler`](../nwire-handler/README.md) — the operation primitive (transport-agnostic)
+- [`@nwire/hooks`](../nwire-hooks/README.md) — universal dispatch (chain + listeners)
+- [`@nwire/http`](../nwire-http/README.md) — typed HTTP without forge
+- [`@nwire/endpoint`](../nwire-endpoint/README.md) — graceful shutdown for any host
+
+## See also
+
+- [Architecture sketch §05 — Forge tier](../../architecture-sketch.html#packages)
+- Sibling packages: [@nwire/app](../nwire-app), [@nwire/http](../nwire-http), [@nwire/messages](../nwire-messages)

package/dist/__tests__/actor-methods.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Actor methods + `ctx.use(Actor, id)` — pure invariant-enforcers + event
+ * minters bound to the loaded state. Methods take state, return events or
+ * read values, throw on invariant violation. `ctx.use` loads the actor from
+ * the store and returns a view with state, stateName, key, and pre-bound
+ * methods. The view is a snapshot — the loaded state is frozen for that view.
+ */
+export {};
+//# sourceMappingURL=actor-methods.test.d.ts.map

package/dist/__tests__/actor-methods.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actor-methods.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/actor-methods.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/__tests__/actor-methods.test.js

@@ -0,0 +1,210 @@
+/**
+ * Actor methods + `ctx.use(Actor, id)` — pure invariant-enforcers + event
+ * minters bound to the loaded state. Methods take state, return events or
+ * read values, throw on invariant violation. `ctx.use` loads the actor from
+ * the store and returns a view with state, stateName, key, and pre-bound
+ * methods. The view is a snapshot — the loaded state is frozen for that view.
+ */
+import { describe, it, expect } from "vitest";
+import { z } from "zod";
+import { defineEvent } from "@nwire/messages";
+import { defineAction, defineActor, defineModule, createApp, eventFactory, } from "../foundation.js";
+const SubmissionSchema = z.object({
+    studentId: z.string(),
+    answer: z.string(),
+    flags: z.number(),
+});
+const SubmittedEventDef = defineEvent({
+    name: "sub.submitted",
+    schema: z.object({
+        submissionId: z.string(),
+        studentId: z.string(),
+        answer: z.string(),
+        submittedAt: z.string(),
+    }),
+});
+const Submitted = eventFactory(SubmittedEventDef);
+const FlaggedEventDef = defineEvent({
+    name: "sub.flagged",
+    schema: z.object({
+        submissionId: z.string(),
+        reason: z.string(),
+        flaggedAt: z.string(),
+    }),
+});
+const Flagged = eventFactory(FlaggedEventDef);
+const GradedEventDef = defineEvent({
+    name: "sub.graded",
+    schema: z.object({
+        submissionId: z.string(),
+        verdict: z.enum(["correct", "incorrect"]),
+        gradedAt: z.string(),
+    }),
+});
+const Graded = eventFactory(GradedEventDef);
+const Submission = defineActor("submission", {
+    schema: SubmissionSchema,
+    key: "submissionId",
+    initial: "pending",
+    states: {
+        pending: {
+            on: {
+                [SubmittedEventDef.name]: {
+                    target: "pending",
+                    assign: (_, event) => {
+                        const e = event;
+                        return { studentId: e.studentId, answer: e.answer, flags: 0 };
+                    },
+                },
+                [FlaggedEventDef.name]: {
+                    target: "flagged",
+                    assign: (state) => ({ flags: (state.flags ?? 0) + 1 }),
+                },
+                [GradedEventDef.name]: { target: "graded" },
+            },
+        },
+        flagged: {
+            on: {
+                [GradedEventDef.name]: { target: "graded" },
+            },
+        },
+        graded: { final: true },
+    },
+    methods: {
+        flagForReview(state, reason) {
+            if (reason.length < 3) {
+                throw new Error("reason too short");
+            }
+            return Flagged({
+                submissionId: "placeholder", // handler injects the real id
+                reason,
+                flaggedAt: new Date().toISOString(),
+            });
+        },
+        isGradable(state) {
+            return state.flags === 0;
+        },
+        flagCount(state) {
+            return state.flags;
+        },
+    },
+});
+const submitAnswer = defineAction({
+    name: "sub.submit-answer",
+    schema: z.object({ submissionId: z.string(), studentId: z.string(), answer: z.string() }),
+    handler: async (input) => Submitted({
+        submissionId: input.submissionId,
+        studentId: input.studentId,
+        answer: input.answer,
+        submittedAt: new Date().toISOString(),
+    }),
+});
+const flagForReview = defineAction({
+    name: "sub.flag-for-review",
+    schema: z.object({ submissionId: z.string(), reason: z.string() }),
+    handler: async (input, ctx) => {
+        const submission = await ctx.use(Submission, input.submissionId);
+        // methods return an event — handler returns it for the runtime to apply.
+        const event = submission.flagForReview(input.reason);
+        // Inject the real submissionId (the method had a placeholder).
+        return {
+            ...event,
+            payload: { ...event.payload, submissionId: input.submissionId },
+        };
+    },
+});
+const checkGradable = defineAction({
+    name: "sub.check-gradable",
+    schema: z.object({ submissionId: z.string() }),
+    handler: async (input, ctx) => {
+        const submission = await ctx.use(Submission, input.submissionId);
+        if (!submission.isGradable()) {
+            throw new Error(`not gradable; ${submission.flagCount()} flags`);
+        }
+        return undefined;
+    },
+});
+describe("actor methods + ctx.use", () => {
+    it("ctx.use loads the actor and exposes state + stateName + key", async () => {
+        const app = createApp({
+            modules: [
+                defineModule("m", {
+                    actors: [Submission],
+                    actions: [submitAnswer, checkGradable],
+                    events: [SubmittedEventDef, FlaggedEventDef, GradedEventDef],
+                }),
+            ],
+        });
+        await app.runtime.dispatch(submitAnswer, {
+            submissionId: "s1",
+            studentId: "avi",
+            answer: "4",
+        });
+        // checkGradable handler reads state + invokes methods; no throw = gradable.
+        await app.runtime.dispatch(checkGradable, { submissionId: "s1" });
+    });
+    it("a method returning an event flows through the handler into the runtime", async () => {
+        const app = createApp({
+            modules: [
+                defineModule("m", {
+                    actors: [Submission],
+                    actions: [submitAnswer, flagForReview],
+                    events: [SubmittedEventDef, FlaggedEventDef, GradedEventDef],
+                }),
+            ],
+        });
+        await app.runtime.dispatch(submitAnswer, {
+            submissionId: "s2",
+            studentId: "avi",
+            answer: "4",
+        });
+        await app.runtime.dispatch(flagForReview, {
+            submissionId: "s2",
+            reason: "contains profanity",
+        });
+        const stored = await app.runtime.getActorStore().load("submission", "s2", "");
+        expect(stored?.state).toBe("flagged");
+        expect((stored?.data).flags).toBe(1);
+    });
+    it("a method that throws an invariant error bubbles up from the handler", async () => {
+        const app = createApp({
+            modules: [
+                defineModule("m", {
+                    actors: [Submission],
+                    actions: [submitAnswer, flagForReview],
+                    events: [SubmittedEventDef, FlaggedEventDef, GradedEventDef],
+                }),
+            ],
+        });
+        await app.runtime.dispatch(submitAnswer, {
+            submissionId: "s3",
+            studentId: "avi",
+            answer: "4",
+        });
+        await expect(app.runtime.dispatch(flagForReview, { submissionId: "s3", reason: "ok" })).rejects.toThrow(/reason too short/);
+    });
+    it("ctx.use returns a virgin view when the instance has never received an event", async () => {
+        // Phase 42.1 + 42.2 canonicalized the "virgin instance" pattern so that
+        // `create` methods can bootstrap a brand-new aggregate. ctx.use does
+        // NOT throw on a missing instance — it returns the initial state and
+        // lets the handler decide whether that's an error.
+        const app = createApp({
+            modules: [
+                defineModule("m", {
+                    actors: [Submission],
+                    actions: [checkGradable],
+                    events: [SubmittedEventDef],
+                }),
+            ],
+        });
+        await expect(app.runtime.dispatch(checkGradable, { submissionId: "never-existed" })).rejects.toThrow(/not gradable/);
+    });
+    it("ctx.use throws a helpful error when the actor TYPE is not registered", async () => {
+        // Actor type missing from the module manifest → boot-time framework
+        // problem, not a runtime data problem. Distinct from the virgin-
+        // instance case above.
+        const app = createApp({ modules: [defineModule("m", { actions: [checkGradable] })] });
+        await expect(app.runtime.dispatch(checkGradable, { submissionId: "x" })).rejects.toThrow(/not registered/);
+    });
+});
+//# sourceMappingURL=actor-methods.test.js.map

package/dist/__tests__/actor-methods.test.js.map

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

package/dist/__tests__/actor-schema-bound.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * defineActor — schema-bound form. The schema provides key/initial/final;
+ * the actor provides transitions per state.
+ */
+export {};
+//# sourceMappingURL=actor-schema-bound.test.d.ts.map

package/dist/__tests__/actor-schema-bound.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actor-schema-bound.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/actor-schema-bound.test.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/__tests__/actor-schema-bound.test.js

@@ -0,0 +1,112 @@
+/**
+ * defineActor — schema-bound form. The schema provides key/initial/final;
+ * the actor provides transitions per state.
+ */
+import { describe, it, expect } from "vitest";
+import { z } from "zod";
+import { defineEvent } from "@nwire/messages";
+import { defineActor } from "../define-actor.js";
+import { defineSchema } from "../define-schema.js";
+const AnswerWasSubmitted = defineEvent({
+    name: "submissions.answer-was-submitted",
+    schema: z.object({ submissionId: z.string(), answer: z.string() }),
+});
+const AnswerWasFlagged = defineEvent({
+    name: "submissions.answer-was-flagged",
+    schema: z.object({ submissionId: z.string(), confidence: z.number() }),
+});
+const SubmissionWasManuallyGraded = defineEvent({
+    name: "submissions.was-manually-graded",
+    schema: z.object({ submissionId: z.string(), verdict: z.string() }),
+});
+const SubmissionData = defineSchema({
+    name: "submission",
+    key: "submissionId",
+    fields: {
+        submissionId: z.string(),
+        answer: z.string().optional(),
+        confidence: z.number().optional(),
+        verdict: z.string().optional(),
+    },
+    states: {
+        submitted: { initial: true },
+        "under-review": {},
+        graded: { final: true },
+    },
+});
+describe("defineActor (schema-bound)", () => {
+    it("derives name, key, initial, and final states from the schema", () => {
+        const Submission = defineActor({
+            schema: SubmissionData,
+            states: {
+                submitted: {
+                    on: {
+                        [AnswerWasSubmitted.name]: {
+                            assign: (_s, e) => ({ answer: e.answer }),
+                        },
+                        [AnswerWasFlagged.name]: {
+                            target: "under-review",
+                            assign: (_s, e) => ({ confidence: e.confidence }),
+                        },
+                    },
+                },
+                "under-review": {
+                    on: {
+                        [SubmissionWasManuallyGraded.name]: {
+                            target: "graded",
+                            assign: (_s, e) => ({ verdict: e.verdict }),
+                        },
+                    },
+                },
+            },
+        });
+        expect(Submission.name).toBe("submission");
+        expect(Submission.key).toBe("submissionId");
+        expect(Submission.initial).toBe("submitted");
+        expect(Submission.states.graded?.final).toBe(true);
+        expect(Submission.eventIndex.size).toBe(3);
+    });
+    it("allows a custom name to override the schema's", () => {
+        const Renamed = defineActor({
+            name: "my-submission",
+            schema: SubmissionData,
+        });
+        expect(Renamed.name).toBe("my-submission");
+    });
+    it("rejects transitions for states not in the schema", () => {
+        expect(() => defineActor({
+            schema: SubmissionData,
+            states: {
+                unknown: { on: { [AnswerWasSubmitted.name]: {} } },
+            },
+        })).toThrow(/state "unknown" is not declared in schema/);
+    });
+    it("rejects on: reactions on final states", () => {
+        expect(() => defineActor({
+            schema: SubmissionData,
+            states: {
+                graded: { on: { [AnswerWasSubmitted.name]: {} } },
+            },
+        })).toThrow(/is final in schema/);
+    });
+    it("typed methods are still callable from the actor instance view", () => {
+        const Submission = defineActor({
+            schema: SubmissionData,
+            methods: {
+                isGraded: (state) => state.verdict !== undefined,
+            },
+        });
+        expect(Submission.methods?.isGraded).toBeTypeOf("function");
+    });
+    it("classic positional form still works", () => {
+        const Legacy = defineActor("legacy", {
+            schema: z.object({ id: z.string() }),
+            key: "id",
+            initial: "open",
+            states: { open: {}, closed: { final: true } },
+        });
+        expect(Legacy.name).toBe("legacy");
+        expect(Legacy.initial).toBe("open");
+    });
+});
+//# sourceMappingURL=actor-schema-bound.test.js.map

package/dist/__tests__/actor-schema-bound.test.js.map

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

package/dist/__tests__/app-capabilities.test.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `createApp` registers app capabilities (`execute`, `send`, `useProjection`)
+ * on the container so handlers in any transport — http, queue, cli —
+ * can resolve them as plain functions:
+ *
+ *   const execute = ctx.resolve<ExecuteFn>("execute");
+ *   const result  = await execute(myAction, input);
+ *
+ * Each capability seeds a fresh envelope. Use cases:
+ *   - HTTP handler dispatching an action from an external request
+ *   - Queue worker processing a job that triggers an action
+ *   - CLI command invoking app behavior
+ *
+ * Inside a handler/workflow with an existing envelope, the in-flight
+ * ctx.request / ctx.send / ctx.query still inherit the parent envelope
+ * — those are unaffected.
+ */
+export {};
+//# sourceMappingURL=app-capabilities.test.d.ts.map

package/dist/__tests__/app-capabilities.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-capabilities.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/app-capabilities.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG"}

package/dist/__tests__/app-capabilities.test.js

@@ -0,0 +1,57 @@
+/**
+ * `createApp` registers app capabilities (`execute`, `send`, `useProjection`)
+ * on the container so handlers in any transport — http, queue, cli —
+ * can resolve them as plain functions:
+ *
+ *   const execute = ctx.resolve<ExecuteFn>("execute");
+ *   const result  = await execute(myAction, input);
+ *
+ * Each capability seeds a fresh envelope. Use cases:
+ *   - HTTP handler dispatching an action from an external request
+ *   - Queue worker processing a job that triggers an action
+ *   - CLI command invoking app behavior
+ *
+ * Inside a handler/workflow with an existing envelope, the in-flight
+ * ctx.request / ctx.send / ctx.query still inherit the parent envelope
+ * — those are unaffected.
+ */
+import { describe, it, expect } from "vitest";
+import { z } from "zod";
+import { defineAction, defineModule, createApp } from "../foundation.js";
+describe("createApp app capabilities on container", () => {
+    it("execute resolves and dispatches an action", async () => {
+        let sum = 0;
+        const sumAction = defineAction({
+            name: "sum",
+            schema: z.object({ a: z.number(), b: z.number() }),
+            handler: async (input) => {
+                sum = input.a + input.b;
+                return undefined;
+            },
+        });
+        const app = createApp({ modules: [defineModule("m", { actions: [sumAction] })] });
+        await app.start();
+        const execute = app.runtime.getContainer().resolve("execute");
+        await execute(sumAction, { a: 2, b: 3 });
+        expect(sum).toBe(5);
+        await app.stop();
+    });
+    it("send dispatches fire-and-forget", async () => {
+        let seen;
+        const recordAction = defineAction({
+            name: "record",
+            schema: z.object({ tag: z.string() }),
+            handler: async (input) => {
+                seen = input;
+                return undefined;
+            },
+        });
+        const app = createApp({ modules: [defineModule("m", { actions: [recordAction] })] });
+        await app.start();
+        const send = app.runtime.getContainer().resolve("send");
+        await send(recordAction, { tag: "hello" });
+        expect(seen).toEqual({ tag: "hello" });
+        await app.stop();
+    });
+});
+//# sourceMappingURL=app-capabilities.test.js.map

package/dist/__tests__/app-capabilities.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-capabilities.test.js","sourceRoot":"","sources":["../../src/__tests__/app-capabilities.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAOtE,QAAQ,CAAC,yCAAyC,EAAE,GAAG,EAAE;IACvD,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;QACzD,IAAI,GAAG,GAAG,CAAC,CAAC;QACZ,MAAM,SAAS,GAAG,YAAY,CAAC;YAC7B,IAAI,EAAE,KAAK;YACX,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;YAClD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;gBACvB,GAAG,GAAG,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;gBACxB,OAAO,SAAS,CAAC;YACnB,CAAC;SACF,CAAC,CAAC;QAEH,MAAM,GAAG,GAAG,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QAClF,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;QAElB,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,OAAO,CAAY,SAAS,CAAC,CAAC;QACzE,MAAM,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACzC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAEpB,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,KAAK,IAAI,EAAE;QAC/C,IAAI,IAAa,CAAC;QAClB,MAAM,YAAY,GAAG,YAAY,CAAC;YAChC,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;YACrC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;gBACvB,IAAI,GAAG,KAAK,CAAC;gBACb,OAAO,SAAS,CAAC;YACnB,CAAC;SACF,CAAC,CAAC;QAEH,MAAM,GAAG,GAAG,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QACrF,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;QAElB,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,OAAO,CAAY,MAAM,CAAC,CAAC;QACnE,MAAM,IAAI,CAAC,YAAY,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;QAC3C,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;QAEvC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IACnB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/cli-runner.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * CLI runner — contract test. Verifies argv parsing → action/query dispatch
+ * → stdout/stderr capture, with no actual process spawning.
+ */
+export {};
+//# sourceMappingURL=cli-runner.test.d.ts.map

package/dist/__tests__/cli-runner.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-runner.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/cli-runner.test.ts"],"names":[],"mappings":"AAAA;;;GAGG"}