@eyeauras/cli-factory 0.1.0

package/dist/src/target-commands.d.ts

@@ -0,0 +1,19 @@
+import type { InferredCommandHandler } from "./command-input.js";
+import type { CommandContext, CommandDefinition, OptionDefinition } from "./types.js";
+type CommandInputFor<Syntax extends string> = Parameters<InferredCommandHandler<Syntax>>[0];
+export type TargetCommandHandler<Target, Syntax extends string> = (target: Target, input: CommandInputFor<Syntax>, context: CommandContext) => unknown;
+export type TargetCommand<Target> = <const Syntax extends string>(syntax: Syntax, description: string, permission: string, run: TargetCommandHandler<Target, Syntax>, options?: readonly OptionDefinition[]) => CommandDefinition;
+export type GatedTargetCommand<Target> = <const Syntax extends string>(syntax: Syntax, description: string, run: TargetCommandHandler<Target, Syntax>, options?: readonly OptionDefinition[]) => CommandDefinition;
+export interface TargetCommands<Target> {
+    command: TargetCommand<Target>;
+    read: GatedTargetCommand<Target>;
+    update: GatedTargetCommand<Target>;
+    gated(permission: string): GatedTargetCommand<Target>;
+}
+/**
+ * Bind service leaves to one invocation-scoped target such as an authenticated HTTP client.
+ * Resolution still happens after Core selects the profile and admits the permission gate.
+ */
+export declare function targetCommands<Target>(resolve: (context: CommandContext) => Target | Promise<Target>): TargetCommands<Target>;
+export {};
+//# sourceMappingURL=target-commands.d.ts.map

package/dist/src/target-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-commands.d.ts","sourceRoot":"","sources":["../../src/target-commands.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAEjE,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB,KAAK,eAAe,CAAC,MAAM,SAAS,MAAM,IAAI,UAAU,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAE5F,MAAM,MAAM,oBAAoB,CAAC,MAAM,EAAE,MAAM,SAAS,MAAM,IAAI,CAChE,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,eAAe,CAAC,MAAM,CAAC,EAC9B,OAAO,EAAE,cAAc,KACpB,OAAO,CAAC;AAEb,MAAM,MAAM,aAAa,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,SAAS,MAAM,EAC9D,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,EACzC,OAAO,CAAC,EAAE,SAAS,gBAAgB,EAAE,KAClC,iBAAiB,CAAC;AAEvB,MAAM,MAAM,kBAAkB,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,SAAS,MAAM,EACnE,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,EACzC,OAAO,CAAC,EAAE,SAAS,gBAAgB,EAAE,KAClC,iBAAiB,CAAC;AAEvB,MAAM,WAAW,cAAc,CAAC,MAAM;IACpC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC/B,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACjC,MAAM,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACnC,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;CACvD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EACnC,OAAO,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,GAC7D,cAAc,CAAC,MAAM,CAAC,CAwBxB"}

package/dist/src/target-commands.js

@@ -0,0 +1,17 @@
+import { command } from "./command.js";
+import { Permission } from "./permissions.js";
+/**
+ * Bind service leaves to one invocation-scoped target such as an authenticated HTTP client.
+ * Resolution still happens after Core selects the profile and admits the permission gate.
+ */
+export function targetCommands(resolve) {
+    const targetCommand = (syntax, description, permission, run, options = []) => command(syntax, description, async (input, context) => run(await resolve(context), input, context), { permission, options });
+    const gated = (permission) => (syntax, description, run, options) => targetCommand(syntax, description, permission, run, options);
+    return {
+        command: targetCommand,
+        read: gated(Permission.ReadOnly),
+        update: gated(Permission.Update),
+        gated,
+    };
+}
+//# sourceMappingURL=target-commands.js.map

package/dist/src/target-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-commands.js","sourceRoot":"","sources":["../../src/target-commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAqC9C;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC5B,OAA8D;IAE9D,MAAM,aAAa,GAA0B,CAC3C,MAAM,EACN,WAAW,EACX,UAAU,EACV,GAAG,EACH,OAAO,GAAG,EAAE,EACZ,EAAE,CACF,OAAO,CACL,MAAM,EACN,WAAW,EACX,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,EACrE,EAAE,UAAU,EAAE,OAAO,EAAE,CACxB,CAAC;IACJ,MAAM,KAAK,GAAG,CAAC,UAAkB,EAA8B,EAAE,CAC/D,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,CACpC,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IAEjE,OAAO;QACL,OAAO,EAAE,aAAa;QACtB,IAAI,EAAE,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC;QAChC,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC;QAChC,KAAK;KACN,CAAC;AACJ,CAAC"}

package/dist/src/testing-contracts.d.ts

@@ -0,0 +1,31 @@
+import type { TestContext } from "node:test";
+import type { CliApplication } from "./types.js";
+import type { CliFixture } from "./testing.js";
+export interface HttpRequestExpectation {
+    method: string;
+    /** Origin and pathname, without query; authored independently of production routes. */
+    url: string;
+    query?: Readonly<Record<string, string | readonly string[]>>;
+    headers?: Readonly<Record<string, string | null>>;
+    body?: {
+        json: unknown;
+    } | {
+        text: string;
+    };
+}
+export declare function assertHttpRequest(request: Request, expected: HttpRequestExpectation): Promise<void>;
+/** Register on a catch-all MSW handler so unexpected routes are counted too. */
+export declare function trackRequests(t: Pick<TestContext, "after">, expectedCount: number, respond: (request: Request, index: number) => Response | Promise<Response>): {
+    readonly count: number;
+    verify: () => void;
+    handle(request: Request): Promise<Response>;
+};
+export declare function assertPermissionDenied(app: CliApplication, argv: readonly string[], permission: string, requests: {
+    readonly count: number;
+}): Promise<void>;
+/** For repeatable mocked commands making exactly one HTTP request in each human/JSON invocation. */
+export declare function assertCliOutput(fixture: CliFixture, app: CliApplication, argv: readonly string[], expected: unknown, human: RegExp, requests: {
+    readonly count: number;
+}): Promise<void>;
+export declare function assertSafeCliFailure(fixture: CliFixture, app: CliApplication, argv: readonly string[], message: RegExp, forbidden: RegExp): Promise<void>;
+//# sourceMappingURL=testing-contracts.d.ts.map

package/dist/src/testing-contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing-contracts.d.ts","sourceRoot":"","sources":["../../src/testing-contracts.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,uFAAuF;IACvF,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;IAC7D,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;IAClD,IAAI,CAAC,EAAE;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7C;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAYzG;AAED,gFAAgF;AAChF,wBAAgB,aAAa,CAC3B,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,EAC7B,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;;;oBAelD,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;EAWpD;AAED,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACrG,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,oGAAoG;AACpG,wBAAsB,eAAe,CACnC,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EACnG,QAAQ,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACnC,OAAO,CAAC,IAAI,CAAC,CAYf;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GACpG,OAAO,CAAC,IAAI,CAAC,CAMf"}

package/dist/src/testing-contracts.js

@@ -0,0 +1,72 @@
+import assert from "node:assert/strict";
+export async function assertHttpRequest(request, expected) {
+    const url = new URL(request.url);
+    assert.equal(request.method, expected.method, "HTTP method");
+    assert.equal(url.origin + url.pathname, expected.url, "HTTP origin/path");
+    const actualQuery = Object.fromEntries([...new Set(url.searchParams.keys())].map(key => [key, url.searchParams.getAll(key)]));
+    const expectedQuery = Object.fromEntries(Object.entries(expected.query ?? {}).map(([key, value]) => [key, typeof value === "string" ? [value] : [...value]]));
+    assert.deepEqual(actualQuery, expectedQuery, "HTTP query (including repeated values)");
+    for (const [name, value] of Object.entries(expected.headers ?? {}))
+        assert.equal(request.headers.get(name), value, "HTTP header: " + name);
+    if (expected.body && "json" in expected.body)
+        assert.deepEqual(await request.json(), expected.body.json, "HTTP JSON body");
+    else
+        assert.equal(await request.text(), expected.body?.text ?? "", "HTTP text body");
+}
+/** Register on a catch-all MSW handler so unexpected routes are counted too. */
+export function trackRequests(t, expectedCount, respond) {
+    assert.ok(Number.isSafeInteger(expectedCount) && expectedCount >= 0, "Expected request count must be nonnegative.");
+    let count = 0;
+    const failures = [];
+    const verify = () => {
+        if (failures.length)
+            throw failures[0];
+        assert.equal(count, expectedCount, "HTTP request count (no retries or hidden requests)");
+    };
+    // MSW turns resolver exceptions into HTTP errors. Re-raise the original assertion outside it,
+    // even when the CLI assertion or the test itself fails first.
+    t.after(verify);
+    return {
+        get count() { return count; },
+        verify,
+        async handle(request) {
+            const index = count++;
+            try {
+                assert.ok(count <= expectedCount, "Unexpected extra HTTP request.");
+                return await respond(request, index);
+            }
+            catch (error) {
+                failures.push(error);
+                return new Response(null, { status: 500 });
+            }
+        },
+    };
+}
+export async function assertPermissionDenied(app, argv, permission, requests) {
+    assert.equal(requests.count, 0, "Permission check must start before service I/O.");
+    await assert.rejects(app.execute(argv), error => error instanceof Error &&
+        error.message.includes("Permission '" + permission + "' is disabled"));
+    assert.equal(requests.count, 0, "Permission denial must precede service I/O.");
+}
+/** For repeatable mocked commands making exactly one HTTP request in each human/JSON invocation. */
+export async function assertCliOutput(fixture, app, argv, expected, human, requests) {
+    const before = requests.count;
+    const result = await fixture.run(app, argv);
+    assert.equal(requests.count, before + 1, "Human invocation must make exactly one HTTP request.");
+    assert.equal(result.exitCode, 0, result.stderr);
+    assert.match(result.stdout, human);
+    assert.equal(result.stderr, "");
+    const json = await fixture.run(app, ["--json", ...argv]);
+    assert.equal(requests.count, before + 2, "JSON invocation must make exactly one HTTP request.");
+    assert.equal(json.exitCode, 0, json.stderr);
+    assert.deepEqual(JSON.parse(json.stdout), expected);
+    assert.equal(json.stderr, "");
+}
+export async function assertSafeCliFailure(fixture, app, argv, message, forbidden) {
+    const result = await fixture.run(app, argv);
+    assert.equal(result.exitCode, 1);
+    assert.equal(result.stdout, "");
+    assert.match(result.stderr, message);
+    assert.doesNotMatch(result.stderr, forbidden);
+}
+//# sourceMappingURL=testing-contracts.js.map

package/dist/src/testing-contracts.js.map

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

package/dist/src/testing.d.ts

@@ -0,0 +1,51 @@
+import { Readable, Writable } from "node:stream";
+import type { TestContext } from "node:test";
+import { AppArguments } from "./app-arguments.js";
+import { ProfileStore } from "./profile-store.js";
+import { MemorySecretStore } from "./secret-store.js";
+import type { CliApplication, CliInvocation, CliRuntime, ProfileValues } from "./types.js";
+export interface FixtureProfile {
+    name: string;
+    values?: ProfileValues;
+    permissions?: readonly string[];
+    /** Explicit synthetic credentials; no token protocol is assumed. */
+    secrets?: Readonly<Record<string, string>>;
+}
+export interface CliFixtureOptions {
+    applicationId: string;
+    /** A non-default name requires explicit profiles so its identity is persisted. */
+    defaultProfile?: string;
+    /** Omission leaves the virtual default unconfigured. No authentication runs. */
+    profiles?: readonly FixtureProfile[];
+    input?: string;
+}
+/** Offline fixture mechanics only. The caller owns the definition, auth and network mocks. */
+export declare function createCliFixture(t: Pick<TestContext, "after">, options: CliFixtureOptions): Promise<{
+    root: string;
+    runtime: CliRuntime & Pick<{
+        input: Readable;
+        output: Writable;
+        error: Writable;
+        stdout: () => string;
+        stderr: () => string;
+        resetOutput(): void;
+    }, "error" | "input" | "output">;
+    appArguments: AppArguments;
+    profileStore: ProfileStore;
+    secretStore: MemorySecretStore;
+    dispose: () => Promise<void>;
+    stdout: () => string;
+    stderr: () => string;
+    resetOutput: () => void;
+    createApplication(factory: (runtime: CliRuntime) => CliApplication): CliApplication;
+    run: (app: CliApplication, argv: readonly string[], invocation?: CliInvocation) => Promise<{
+        exitCode: number;
+        stdout: string;
+        stderr: string;
+    }>;
+    json(app: CliApplication, argv: readonly string[], invocation?: CliInvocation): Promise<unknown>;
+    rpc(app: CliApplication, commands: readonly (readonly string[])[], invocation?: CliInvocation): Promise<unknown[]>;
+}>;
+export type CliFixture = Awaited<ReturnType<typeof createCliFixture>>;
+export { assertHttpRequest, trackRequests, assertPermissionDenied, assertCliOutput, assertSafeCliFailure, type HttpRequestExpectation } from "./testing-contracts.js";
+//# sourceMappingURL=testing.d.ts.map

package/dist/src/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../src/testing.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAkB,MAAM,mBAAmB,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3F,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,oEAAoE;IACpE,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,kFAAkF;IAClF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gFAAgF;IAChF,QAAQ,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAcD,8FAA8F;AAC9F,wBAAsB,gBAAgB,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,iBAAiB;;;;;;;;;;;;;mBAU1E,OAAO,CAAC,IAAI,CAAC;;;;+BA0DJ,CAAC,OAAO,EAAE,UAAU,KAAK,cAAc,GAAG,cAAc;eAR7D,cAAc,QAAQ,SAAS,MAAM,EAAE,eAAc,aAAa;;;;;cAexE,cAAc,QAAQ,SAAS,MAAM,EAAE,eAAe,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;aAKvF,cAAc,YAAY,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,eAAe,aAAa,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;GAU3H;AAED,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,sBAAsB,EAAE,eAAe,EAAE,oBAAoB,EAAE,KAAK,sBAAsB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/src/testing.js

@@ -0,0 +1,126 @@
+import assert from "node:assert/strict";
+import { lstat, mkdtemp, realpath, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { dirname, join } from "node:path";
+import { Readable, Writable } from "node:stream";
+import { AppArguments } from "./app-arguments.js";
+import { ProfileStore } from "./profile-store.js";
+import { MemorySecretStore, ProfileSecrets } from "./secret-store.js";
+function capture(input = "") {
+    let stdout = "", stderr = "";
+    return {
+        input: Readable.from([input]),
+        output: new Writable({ write(chunk, _encoding, done) { stdout += chunk.toString(); done(); } }),
+        error: new Writable({ write(chunk, _encoding, done) { stderr += chunk.toString(); done(); } }),
+        stdout: () => stdout,
+        stderr: () => stderr,
+        resetOutput() { stdout = ""; stderr = ""; },
+    };
+}
+/** Offline fixture mechanics only. The caller owns the definition, auth and network mocks. */
+export async function createCliFixture(t, options) {
+    const defaultProfile = options.defaultProfile ?? "default";
+    if (defaultProfile !== "default" && !options.profiles?.length) {
+        throw new Error("A non-default fixture profile requires explicit profile preparation.");
+    }
+    const parent = await realpath(tmpdir());
+    const root = await mkdtemp(join(parent, "cli-factory-fixture-"));
+    const applications = new Set();
+    let identity;
+    let disposal;
+    const dispose = () => disposal ??= (async () => {
+        const failures = [];
+        for (const app of [...applications].reverse()) {
+            try {
+                await app.dispose();
+            }
+            catch (error) {
+                failures.push(error);
+            }
+        }
+        // A failed shutdown may leave resources using the directory. Retain it for inspection.
+        if (failures.length)
+            throw new AggregateError(failures, "Fixture application disposal failed; temporary data retained.");
+        let current;
+        try {
+            current = await lstat(root);
+        }
+        catch (error) {
+            if (error.code === "ENOENT")
+                return;
+            throw error;
+        }
+        assert.ok(identity && current.isDirectory() && !current.isSymbolicLink(), "Fixture root is no longer an owned directory.");
+        assert.equal(current.dev, identity.dev, "Fixture root device changed.");
+        assert.equal(current.ino, identity.ino, "Fixture root identity changed.");
+        assert.equal(await realpath(root), root, "Fixture root target changed.");
+        assert.equal(dirname(root), parent, "Fixture root escaped its temporary parent.");
+        await rm(root, { recursive: true, force: true });
+    })();
+    // Register before profile preparation or any caller-controlled application factory can fail.
+    t.after(dispose);
+    identity = await lstat(root);
+    const appArguments = new AppArguments({
+        AppName: options.applicationId, Profile: defaultProfile,
+        Environment: {
+            AppDomainDirectory: join(root, "executable"),
+            ApplicationExecutablePath: join(root, "executable", "fixture.js"),
+            EnvironmentAppData: join(root, "roaming"),
+            EnvironmentLocalAppData: join(root, "local"),
+            ProcessId: 1,
+        },
+    });
+    // A view of the real backing document. Do not inject this into the application by default:
+    // Core must still construct its store with the integration's own defaults and validation.
+    const profileStore = new ProfileStore({
+        applicationId: options.applicationId, appArguments, defaultName: defaultProfile,
+    });
+    const secretStore = new MemorySecretStore();
+    for (const profile of options.profiles ?? []) {
+        if (profile.name === defaultProfile)
+            await profileStore.set(profile.name, profile.values ?? {});
+        else
+            await profileStore.create(profile.name, profile.values ?? {});
+        if (profile.permissions !== undefined)
+            await profileStore.setPermissions(profile.name, profile.permissions);
+        const scoped = new ProfileSecrets(secretStore, options.applicationId, profile.name);
+        for (const [name, value] of Object.entries(profile.secrets ?? {}))
+            await scoped.set(name, value);
+    }
+    const output = capture(options.input);
+    const runtime = {
+        appArguments, secretStore, input: output.input, output: output.output, error: output.error,
+    };
+    const run = async (app, argv, invocation = {}) => {
+        const io = capture();
+        const exitCode = await app.run(argv, { ...io, cwd: root, environment: {}, ...invocation });
+        return { exitCode, stdout: io.stdout(), stderr: io.stderr() };
+    };
+    return {
+        root, runtime, appArguments, profileStore, secretStore, dispose,
+        stdout: output.stdout, stderr: output.stderr, resetOutput: output.resetOutput,
+        createApplication(factory) {
+            if (disposal)
+                throw new Error("Fixture is disposed.");
+            const app = factory(runtime);
+            applications.add(app);
+            return app;
+        },
+        run,
+        async json(app, argv, invocation) {
+            const result = await run(app, ["--json", ...argv], invocation);
+            assert.equal(result.exitCode, 0, result.stderr);
+            return JSON.parse(result.stdout);
+        },
+        async rpc(app, commands, invocation) {
+            const input = commands.map((argv, id) => JSON.stringify({ jsonrpc: "2.0", id, method: "cli.execute", params: { argv } })).join("\n") + "\n";
+            const result = await run(app, ["--json-rpc"], { ...invocation, input: Readable.from([input]) });
+            assert.equal(result.exitCode, 0, result.stderr);
+            const replies = result.stdout.trim().split("\n").filter(Boolean).map(line => JSON.parse(line));
+            assert.equal(replies.length, commands.length, "RPC response count does not match its request count.");
+            return replies;
+        },
+    };
+}
+export { assertHttpRequest, trackRequests, assertPermissionDenied, assertCliOutput, assertSafeCliFailure } from "./testing-contracts.js";
+//# sourceMappingURL=testing.js.map

package/dist/src/testing.js.map

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

package/dist/src/types.d.ts

@@ -0,0 +1,174 @@
+import type { Readable, Writable } from "node:stream";
+import type { IAppArguments } from "./app-arguments.js";
+export type ProfileValues = Record<string, unknown>;
+export interface Profile {
+    name: string;
+    values: ProfileValues;
+}
+export interface ProfileField {
+    name: string;
+    flags: string;
+    description: string;
+    /** A service command cannot run until this field has a non-empty value. */
+    required?: boolean;
+}
+export interface ProfileDefinition {
+    defaultName?: string;
+    defaults?: ProfileValues;
+    fields?: readonly ProfileField[];
+    validate?: (values: ProfileValues) => void | Promise<void>;
+}
+export interface SecretStore {
+    get(service: string, account: string): Promise<string | undefined>;
+    set(service: string, account: string, value: string): Promise<void>;
+    delete(service: string, account: string): Promise<void>;
+}
+export interface ScopedSecrets {
+    get(name: string): Promise<string | undefined>;
+    require(name: string): Promise<string>;
+    set(name: string, value: string): Promise<void>;
+    delete(name: string): Promise<void>;
+}
+export interface CommandContext {
+    appArguments: IAppArguments;
+    profile: Profile;
+    secrets: ScopedSecrets;
+    fetch: typeof globalThis.fetch;
+    signal: AbortSignal;
+    io: CliIo;
+    cwd: string;
+    environment: Readonly<NodeJS.ProcessEnv>;
+}
+export interface CommandInput {
+    args: Record<string, unknown>;
+    options: Record<string, unknown>;
+}
+export type CommandHandler = (input: CommandInput, context: CommandContext) => unknown | Promise<unknown>;
+export interface OptionDefinition {
+    flags: string;
+    description: string;
+    /** Require a value (or declared default) before profile onboarding or handler execution. */
+    required?: boolean;
+    defaultValue?: unknown;
+    parse?: (value: string, previous: unknown) => unknown;
+}
+export interface CommandSettings {
+    options?: readonly OptionDefinition[];
+    permission?: string;
+}
+export interface CommandDefinition {
+    /** Command name followed by optional Commander-style arguments, for example `show <id>`. */
+    name: string;
+    description: string;
+    options?: readonly OptionDefinition[];
+    permission?: string;
+    children?: readonly CommandDefinition[];
+    run?: CommandHandler;
+}
+export interface PermissionCategory {
+    name: string;
+    description: string;
+    enabledByDefault?: boolean;
+}
+export interface PermissionGateDefinition {
+    categories?: readonly PermissionCategory[];
+}
+export interface TokenValidationContext {
+    appArguments: IAppArguments;
+    profile: Profile;
+    token: string;
+    fetch: typeof globalThis.fetch;
+    signal: AbortSignal;
+}
+export interface AuthStatus {
+    authenticated: boolean;
+    identity?: unknown;
+}
+export interface AuthContext extends CommandContext {
+    interactive: boolean;
+    stdinAvailable: boolean;
+}
+/** Applications own the protocol. Core owns the common command surface. */
+export interface AuthDefinition {
+    required?: (profile: Profile) => boolean;
+    /** Optional local-only preflight. Must not launch/change browser resources or contact services.
+     * Omit when readiness cannot be determined passively; the service handler then enforces auth. */
+    isReady?: (context: AuthReadinessContext) => boolean | Promise<boolean>;
+    /** Environment inputs consumed by this auth implementation; hosts forward only declared keys. */
+    environmentKeys?: readonly string[];
+    loginOptions?: readonly OptionDefinition[];
+    login: (context: AuthContext, options: Record<string, unknown>) => Promise<AuthStatus>;
+    /** Explicit auth status command only; may actively validate with the service. */
+    status: (context: AuthContext) => Promise<AuthStatus>;
+    logout: (context: AuthContext) => Promise<void>;
+}
+export type AuthReadinessContext = Pick<CommandContext, "appArguments" | "profile" | "secrets" | "signal" | "environment">;
+export interface CliIo {
+    input: Readable;
+    output: Writable;
+    error: Writable;
+}
+export interface CliInvocation {
+    input?: Readable;
+    output?: Writable;
+    error?: Writable;
+    signal?: AbortSignal;
+    cwd?: string;
+    environment?: Readonly<NodeJS.ProcessEnv>;
+}
+export interface CliRuntime {
+    appArguments?: IAppArguments;
+    input?: Readable;
+    output?: Writable;
+    error?: Writable;
+    fetch?: typeof globalThis.fetch;
+    profileStore?: ProfileStoreContract;
+    secretStore?: SecretStore;
+}
+export interface CliDefinition {
+    name: string;
+    description: string;
+    version?: string;
+    applicationId?: string;
+    profile?: ProfileDefinition;
+    auth?: AuthDefinition;
+    /** Extra per-invocation environment inputs; combined with auth.environmentKeys by the host. */
+    environmentKeys?: readonly string[];
+    /** Maximum executing logical commands; omitted means no extra limit. */
+    concurrency?: number;
+    /** Owned instances, closed in reverse registration order. Never register caller-owned I/O. */
+    resources?: readonly CliResource[];
+    permissions?: PermissionGateDefinition;
+    commands: readonly CommandDefinition[];
+    /** Module-owned local management commands, not service leaves. */
+    builtins?: readonly CommandDefinition[];
+    runtime?: CliRuntime;
+}
+/** Flat ownership only: no service lookup, scopes or dependency graph. */
+export interface CliResource {
+    dispose(): void | Promise<void>;
+    /** Called before configure login, after non-auth updates, and before deletion; commands are excluded. */
+    invalidateProfile?(appArguments: IAppArguments): void | Promise<void>;
+}
+export interface ProfileStoreContract {
+    get(name?: string): Promise<Profile>;
+    list(): Promise<{
+        active: string;
+        profiles: Profile[];
+    }>;
+    create(name: string, values?: ProfileValues): Promise<Profile>;
+    set(name: string, values: ProfileValues): Promise<Profile>;
+    setDefault(name: string): Promise<Profile>;
+    delete(name: string): Promise<{
+        deleted: string;
+        default: string;
+    }>;
+    getPermissions(name?: string): Promise<readonly string[] | undefined>;
+    setPermissions(name: string, permissions: readonly string[]): Promise<readonly string[]>;
+}
+export interface CliApplication {
+    run(argv?: readonly string[], invocation?: CliInvocation): Promise<number>;
+    dispose(): Promise<void>;
+    execute(argv: readonly string[], signal?: AbortSignal): Promise<unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

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

package/dist/src/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@eyeauras/cli-factory",
+  "version": "0.1.0",
+  "description": "Reusable primitives for consistent, AI-friendly TypeScript CLIs.",
+  "type": "module",
+  "main": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js"
+    },
+    "./testing": {
+      "types": "./dist/src/testing.d.ts",
+      "import": "./dist/src/testing.js"
+    },
+    "./proof": {
+      "types": "./dist/src/proof.d.ts",
+      "import": "./dist/src/proof.js"
+    }
+  },
+  "files": [
+    "dist/src"
+  ],
+  "scripts": {
+    "build": "tsc --project tsconfig.json",
+    "test:compiled": "node --test dist/tests/*.test.js",
+    "prepack": "npm run build"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "dependencies": {
+    "@napi-rs/keyring": "^1.3.0",
+    "commander": "^14.0.2"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/iXab3r/EyeAuras.CliFactory.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/iXab3r/EyeAuras.CliFactory/tree/main/packages/core",
+  "bugs": {
+    "url": "https://github.com/iXab3r/EyeAuras.CliFactory/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}