@noodleseed/one 0.74.1 → 0.75.0

package/dist/commands/org-member-args.d.ts

@@ -0,0 +1,51 @@
+import type { CliFailure } from './shared.js';
+export interface MemberArgs {
+    readonly serviceFlag?: string;
+    readonly authFlag?: string;
+    readonly org?: string;
+    readonly subject?: string;
+    readonly email?: string;
+    readonly role?: 'owner' | 'developer';
+    readonly json: boolean;
+    readonly all: boolean;
+    readonly parseError?: string;
+}
+export type ValidatedMemberAction = {
+    readonly ok: true;
+    readonly action: 'list' | 'invitations';
+    readonly args: MemberArgs;
+    readonly org: string;
+} | {
+    readonly ok: true;
+    readonly action: 'add';
+    readonly args: MemberArgs;
+    readonly org: string;
+    readonly subject: string;
+    readonly email: string;
+} | {
+    readonly ok: true;
+    readonly action: 'remove';
+    readonly args: MemberArgs;
+    readonly org: string;
+    readonly subject: string;
+} | {
+    readonly ok: true;
+    readonly action: 'set-role';
+    readonly args: MemberArgs;
+    readonly org: string;
+    readonly subject: string;
+    readonly role: 'owner' | 'developer';
+} | {
+    readonly ok: true;
+    readonly action: 'revoke';
+    readonly args: MemberArgs;
+    readonly org: string;
+    readonly email: string;
+} | {
+    readonly ok: false;
+    readonly failure: CliFailure;
+    readonly json: boolean;
+};
+export declare function validateMemberActionArgs(action: string | undefined, args: MemberArgs): ValidatedMemberAction;
+export declare function parseMemberArgs(rest: readonly string[]): MemberArgs;
+//# sourceMappingURL=org-member-args.d.ts.map

package/dist/commands/org-member-args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"org-member-args.d.ts","sourceRoot":"","sources":["../../src/commands/org-member-args.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,WAAW,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,MAAM,qBAAqB,GAC7B;IACE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC;IACxC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB,GACD;IACE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,GACD;IACE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,GACD;IACE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW,CAAC;CACtC,GACD;IACE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,GACD;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAEjF,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,IAAI,EAAE,UAAU,GACf,qBAAqB,CAiEvB;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,CAmDnE"}

package/dist/commands/org-member-args.js

@@ -0,0 +1,134 @@
+import { EXIT } from './output.js';
+export function validateMemberActionArgs(action, args) {
+    if (args.parseError !== undefined) {
+        return {
+            ok: false,
+            failure: usageError(args.parseError, 'noodle members --help'),
+            json: args.json,
+        };
+    }
+    if (args.org === undefined) {
+        return {
+            ok: false,
+            failure: {
+                code: 'target_required',
+                message: 'members requires --org',
+                cause: 'No org was supplied for the members command.',
+                fix: 'Pass --org <slug>.',
+                next: 'noodle orgs list',
+                exitCode: EXIT.USAGE,
+            },
+            json: args.json,
+        };
+    }
+    if (action === 'list' || action === 'invitations') {
+        return { ok: true, action, args, org: args.org };
+    }
+    if (action === 'add' && args.subject !== undefined && args.email !== undefined) {
+        return {
+            ok: true,
+            action,
+            args,
+            org: args.org,
+            subject: args.subject,
+            email: args.email,
+        };
+    }
+    if (action === 'remove' && args.subject !== undefined) {
+        return { ok: true, action, args, org: args.org, subject: args.subject };
+    }
+    if (action === 'set-role' && args.subject !== undefined && args.role !== undefined) {
+        return {
+            ok: true,
+            action,
+            args,
+            org: args.org,
+            subject: args.subject,
+            role: args.role,
+        };
+    }
+    if (action === 'revoke' && args.email !== undefined) {
+        return { ok: true, action, args, org: args.org, email: args.email };
+    }
+    const failure = action === 'add'
+        ? usageError('members add requires --subject and --email', 'noodle members --help')
+        : action === 'remove'
+            ? usageError('members remove requires --subject', 'noodle members --help')
+            : action === 'set-role'
+                ? usageError('members set-role requires --subject and --role', 'noodle members --help')
+                : action === 'revoke'
+                    ? usageError('members revoke requires --email', 'noodle members --help')
+                    : usageError('usage: noodle members list|add|remove|set-role|invitations|revoke', 'noodle members --help');
+    return { ok: false, failure, json: args.json };
+}
+export function parseMemberArgs(rest) {
+    let serviceFlag;
+    let authFlag;
+    let org;
+    let subject;
+    let email;
+    let role;
+    let parseError;
+    const json = rest.includes('--json');
+    const all = rest.includes('--all');
+    for (let i = 0; i < rest.length; i++) {
+        const arg = rest[i];
+        if (arg === '--json' || arg === '--all')
+            continue;
+        if (arg === '--service' ||
+            arg === '--auth-token' ||
+            arg === '--org' ||
+            arg === '--subject' ||
+            arg === '--email' ||
+            arg === '--role') {
+            const value = rest[i + 1];
+            if (value === undefined || value.startsWith('--')) {
+                parseError ??= `${arg} requires a value`;
+                continue;
+            }
+            if (arg === '--service')
+                serviceFlag = value;
+            else if (arg === '--auth-token')
+                authFlag = value;
+            else if (arg === '--org')
+                org = value;
+            else if (arg === '--subject')
+                subject = value;
+            else if (arg === '--email')
+                email = value;
+            else if (value === 'owner' || value === 'developer')
+                role = value;
+            else
+                parseError ??= '--role must be owner or developer';
+            i++;
+        }
+        else if (arg?.startsWith('-')) {
+            parseError ??= `unknown option: ${arg}`;
+        }
+        else if (arg !== undefined) {
+            parseError ??= `unexpected positional argument: ${arg}`;
+        }
+    }
+    return {
+        ...(serviceFlag !== undefined ? { serviceFlag } : {}),
+        ...(authFlag !== undefined ? { authFlag } : {}),
+        ...(org !== undefined ? { org } : {}),
+        ...(subject !== undefined ? { subject } : {}),
+        ...(email !== undefined ? { email } : {}),
+        ...(role !== undefined ? { role } : {}),
+        json,
+        all,
+        ...(parseError !== undefined ? { parseError } : {}),
+    };
+}
+function usageError(message, next) {
+    return {
+        code: 'usage_error',
+        message,
+        cause: message,
+        fix: 'Check the command arguments.',
+        next,
+        exitCode: EXIT.USAGE,
+    };
+}
+//# sourceMappingURL=org-member-args.js.map

package/dist/commands/org-member-args.js.map

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

package/dist/commands/org-openai-challenge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"org-openai-challenge.d.ts","sourceRoot":"","sources":["../../src/commands/org-openai-challenge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAenD,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,MAAM,CAAC,CAsFjB"}
+{"version":3,"file":"org-openai-challenge.d.ts","sourceRoot":"","sources":["../../src/commands/org-openai-challenge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAenD,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,MAAM,CAAC,CA6FjB"}

package/dist/commands/org-openai-challenge.js

@@ -3,13 +3,16 @@ import { EXIT, printJsonOk } from './output.js';
 import { authRequired } from './resource-shared.js';
 import { printCliFailure } from './shared.js';
 export async function runOrgsOpenAIChallenge(rest, env, home) {
-    const [action, slug, ...tail] = rest;
-    const args = parseOpenAIChallengeArgs(tail);
-    const json = tail.includes('--json');
+    const args = parseOpenAIChallengeArgs(rest);
+    const [action, slug] = args.positional;
+    const json = args.json;
+    if (args.parseError !== undefined) {
+        return printCliFailure('orgs', usageError(args.parseError, 'noodle orgs openai-challenge --help'), json);
+    }
     if (action !== 'get' && action !== 'set' && action !== 'clear') {
         return printCliFailure('orgs', usageError('orgs openai-challenge requires get, set, or clear', 'noodle orgs openai-challenge get <org>'), json);
     }
-    if (slug === undefined) {
+    if (slug === undefined || args.positional.length !== 2) {
         return printCliFailure('orgs', usageError('orgs openai-challenge requires an org slug', `noodle orgs openai-challenge ${action} <org>`), json);
     }
     if (action === 'set' && args.code === undefined) {
@@ -80,19 +83,41 @@ function parseOpenAIChallengeArgs(rest) {
     let serviceFlag;
     let authFlag;
     let code;
+    let parseError;
+    const positional = [];
+    const json = rest.includes('--json');
     for (let i = 0; i < rest.length; i++) {
         const arg = rest[i];
-        if (arg === '--service')
-            serviceFlag = rest[++i];
-        else if (arg === '--auth-token')
-            authFlag = rest[++i];
-        else if (arg === '--code')
-            code = rest[++i];
+        if (arg === '--json')
+            continue;
+        if (arg === '--service' || arg === '--auth-token' || arg === '--code') {
+            const value = rest[i + 1];
+            if (value === undefined || value.startsWith('--')) {
+                parseError ??= `${arg} requires a value`;
+                continue;
+            }
+            if (arg === '--service')
+                serviceFlag = value;
+            else if (arg === '--auth-token')
+                authFlag = value;
+            else
+                code = value;
+            i++;
+        }
+        else if (arg?.startsWith('-')) {
+            parseError ??= `unknown option: ${arg}`;
+        }
+        else if (arg !== undefined) {
+            positional.push(arg);
+        }
     }
     return {
         ...(serviceFlag !== undefined ? { serviceFlag } : {}),
         ...(authFlag !== undefined ? { authFlag } : {}),
         ...(code !== undefined ? { code } : {}),
+        json,
+        positional,
+        ...(parseError !== undefined ? { parseError } : {}),
     };
 }
 function usageError(message, next) {

package/dist/commands/org-openai-challenge.js.map

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

package/dist/commands/output.d.ts

@@ -1,12 +1,11 @@
 /**
- * Agent-native output contract for the resource commands (`apps`/`envs`/`deployments`/`orgs`).
+ * Agent-native output contract for every CLI command.
  *
- * The success side of the envelope. The failure side already lives in `shared.ts`
- * (`CliFailure` + `printCliFailure` → `{ ok: false, error: { code, message, cause, fix, next } }`);
- * this is its mirror image so every `--json` command emits one stable, machine-readable shape:
+ * The canonical success and failure envelopes ensure every `--json` command emits one stable,
+ * machine-readable shape:
  *
  *   success → { ok: true, data: <T>, warnings?: string[] }
- *   failure → { ok: false, error: { code, message, cause, fix, next, requestId? } }
+ *   failure → { ok: false, error: { code, message, cause?, fix?, next?, requestId? } }
  *
  * Exit codes are the same taxonomy `serviceFailure()` already returns, named here so new
  * commands and their tests reference the contract instead of magic numbers.
@@ -62,6 +61,9 @@ export interface JsonError {
     readonly requestId?: string;
     readonly errors?: readonly JsonFieldError[];
     readonly fixPrompt?: string;
+    readonly suggestions?: readonly string[];
+    readonly retryable?: boolean;
+    readonly retryAfterSeconds?: number;
     /** An opaque upstream detail (e.g. the raw JSON-RPC error) kept for agent debugging, never a secret. */
     readonly detail?: unknown;
 }
@@ -76,12 +78,30 @@ export interface NextCommand {
     readonly command: string;
     readonly reason: string;
 }
+export interface JsonStreamSnapshot<T> {
+    readonly kind: 'snapshot';
+    readonly snapshot: T;
+}
+export interface JsonStreamEvent<T> {
+    readonly kind: 'event';
+    readonly event: T;
+}
+export type JsonStreamRecord<TSnapshot, TEvent> = JsonStreamSnapshot<TSnapshot> | JsonStreamEvent<TEvent>;
 /** Print the success envelope to stdout. Adds `warnings` only when non-empty (matches the error shape). */
-export declare function printJsonOk<T>(data: T, warnings?: readonly string[]): void;
+export declare function printJsonOk<T>(data: T, warnings?: readonly string[], write?: (line: string) => void): void;
 /**
  * Print the failure envelope to stdout and return the exit code. Mirror image of {@link printJsonOk}: every
  * local `--json` command emits `{ ok: false, error }` on failure, and the caller returns the exit code so the
  * command's existing exit taxonomy is preserved.
  */
-export declare function printJsonFailure(error: JsonError, exitCode?: number): number;
+export declare function printJsonFailure(error: JsonError, exitCode?: number, write?: (line: string) => void): number;
+/** Print the initial state for a streaming command as one NDJSON envelope. */
+export declare function printJsonStreamSnapshot<T>(snapshot: T): void;
+/** Print a subsequent streaming record as one NDJSON envelope. */
+export declare function printJsonStreamEvent<T>(event: T): void;
+/**
+ * Print unwrapped JSON only for explicitly human/protocol debugging modes that do not use `--json`.
+ * Machine-mode command output must use the envelope or stream helpers above.
+ */
+export declare function printRawJsonForHumanDebug(value: unknown, indentation?: number, write?: (line: string) => void): void;
 //# sourceMappingURL=output.d.ts.map

package/dist/commands/output.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/commands/output.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,kGAAkG;AAClG,eAAO,MAAM,IAAI;IACf,eAAe;;IAEf,sEAAsE;;IAEtE,8EAA8E;;IAE9E,2DAA2D;;IAE3D,wDAAwD;;IAExD,4EAA4E;;CAEpE,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC,MAAM,OAAO,IAAI,CAAC,CAAC;AAExD,MAAM,WAAW,MAAM,CAAC,CAAC;IACvB,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACjB,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IAC5C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,wGAAwG;IACxG,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;CAC3B;AAED,iFAAiF;AACjF,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC;AAEtD,+GAA+G;AAC/G,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,2GAA2G;AAC3G,wBAAgB,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAM1E;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,SAAI,GAAG,MAAM,CAIvE"}
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/commands/output.ts"],"names":[],"mappings":"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"}

package/dist/commands/output.js

@@ -1,12 +1,11 @@
 /**
- * Agent-native output contract for the resource commands (`apps`/`envs`/`deployments`/`orgs`).
+ * Agent-native output contract for every CLI command.
  *
- * The success side of the envelope. The failure side already lives in `shared.ts`
- * (`CliFailure` + `printCliFailure` → `{ ok: false, error: { code, message, cause, fix, next } }`);
- * this is its mirror image so every `--json` command emits one stable, machine-readable shape:
+ * The canonical success and failure envelopes ensure every `--json` command emits one stable,
+ * machine-readable shape:
  *
  *   success → { ok: true, data: <T>, warnings?: string[] }
- *   failure → { ok: false, error: { code, message, cause, fix, next, requestId? } }
+ *   failure → { ok: false, error: { code, message, cause?, fix?, next?, requestId? } }
  *
  * Exit codes are the same taxonomy `serviceFailure()` already returns, named here so new
  * commands and their tests reference the contract instead of magic numbers.
@@ -27,20 +26,35 @@ export const EXIT = {
     MCP: 5,
 };
 /** Print the success envelope to stdout. Adds `warnings` only when non-empty (matches the error shape). */
-export function printJsonOk(data, warnings) {
+export function printJsonOk(data, warnings, write = console.log) {
     const envelope = warnings !== undefined && warnings.length > 0
         ? { ok: true, data, warnings }
         : { ok: true, data };
-    console.log(JSON.stringify(envelope));
+    write(JSON.stringify(envelope));
 }
 /**
  * Print the failure envelope to stdout and return the exit code. Mirror image of {@link printJsonOk}: every
  * local `--json` command emits `{ ok: false, error }` on failure, and the caller returns the exit code so the
  * command's existing exit taxonomy is preserved.
  */
-export function printJsonFailure(error, exitCode = 1) {
+export function printJsonFailure(error, exitCode = 1, write = console.log) {
     const envelope = { ok: false, error };
-    console.log(JSON.stringify(envelope));
+    write(JSON.stringify(envelope));
     return exitCode;
 }
+/** Print the initial state for a streaming command as one NDJSON envelope. */
+export function printJsonStreamSnapshot(snapshot) {
+    printJsonOk({ kind: 'snapshot', snapshot });
+}
+/** Print a subsequent streaming record as one NDJSON envelope. */
+export function printJsonStreamEvent(event) {
+    printJsonOk({ kind: 'event', event });
+}
+/**
+ * Print unwrapped JSON only for explicitly human/protocol debugging modes that do not use `--json`.
+ * Machine-mode command output must use the envelope or stream helpers above.
+ */
+export function printRawJsonForHumanDebug(value, indentation, write = console.log) {
+    write(JSON.stringify(value, null, indentation));
+}
 //# sourceMappingURL=output.js.map

package/dist/commands/output.js.map

@@ -1 +1 @@
-{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/commands/output.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,kGAAkG;AAClG,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,eAAe;IACf,EAAE,EAAE,CAAC;IACL,sEAAsE;IACtE,OAAO,EAAE,CAAC;IACV,8EAA8E;IAC9E,KAAK,EAAE,CAAC;IACR,2DAA2D;IAC3D,IAAI,EAAE,CAAC;IACP,wDAAwD;IACxD,WAAW,EAAE,CAAC;IACd,4EAA4E;IAC5E,GAAG,EAAE,CAAC;CACE,CAAC;AA2DX,2GAA2G;AAC3G,MAAM,UAAU,WAAW,CAAI,IAAO,EAAE,QAA4B;IAClE,MAAM,QAAQ,GACZ,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;QAC3C,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC9B,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACzB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;AACxC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAgB,EAAE,QAAQ,GAAG,CAAC;IAC7D,MAAM,QAAQ,GAAgB,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IACnD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;IACtC,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/commands/output.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,kGAAkG;AAClG,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,eAAe;IACf,EAAE,EAAE,CAAC;IACL,sEAAsE;IACtE,OAAO,EAAE,CAAC;IACV,8EAA8E;IAC9E,KAAK,EAAE,CAAC;IACR,2DAA2D;IAC3D,IAAI,EAAE,CAAC;IACP,wDAAwD;IACxD,WAAW,EAAE,CAAC;IACd,4EAA4E;IAC5E,GAAG,EAAE,CAAC;CACE,CAAC;AA4EX,2GAA2G;AAC3G,MAAM,UAAU,WAAW,CACzB,IAAO,EACP,QAA4B,EAC5B,QAAgC,OAAO,CAAC,GAAG;IAE3C,MAAM,QAAQ,GACZ,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;QAC3C,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC9B,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;AAClC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAgB,EAChB,QAAQ,GAAG,CAAC,EACZ,QAAgC,OAAO,CAAC,GAAG;IAE3C,MAAM,QAAQ,GAAgB,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IACnD,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;IAChC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,uBAAuB,CAAI,QAAW;IACpD,WAAW,CAAwB,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC;AACrE,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,oBAAoB,CAAI,KAAQ;IAC9C,WAAW,CAAqB,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;AAC5D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CACvC,KAAc,EACd,WAAoB,EACpB,QAAgC,OAAO,CAAC,GAAG;IAE3C,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC;AAClD,CAAC"}

package/dist/commands/policy-ops.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"policy-ops.d.ts","sourceRoot":"","sources":["../../src/commands/policy-ops.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAInD,OAAO,EAA4B,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AA+C1E,wBAAsB,SAAS,CAC7B,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,IAAI,GAAE,cAA0B,GAC/B,OAAO,CAAC,MAAM,CAAC,CAwDjB;AAuHD,gGAAgG;AAChG,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAC5C,IAAI,EAAE,YAAY,GACjB,MAAM,CAER"}
+{"version":3,"file":"policy-ops.d.ts","sourceRoot":"","sources":["../../src/commands/policy-ops.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAInD,OAAO,EAA4B,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAgD1E,wBAAsB,SAAS,CAC7B,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,IAAI,GAAE,cAA0B,GAC/B,OAAO,CAAC,MAAM,CAAC,CAwDjB;AAgHD,gGAAgG;AAChG,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAC5C,IAAI,EAAE,YAAY,GACjB,MAAM,CAER"}