@llm-dev-ops/agentics-cli 1.4.4 → 1.4.7

package/dist/gates/output-format-gate.js

@@ -0,0 +1,136 @@
+/**
+ * Output Format Gate Module
+ *
+ * CONTROL PLANE HARDENING
+ *
+ * PURPOSE: Enforce strict JSON-only output for CLI operations.
+ *          CLI MUST NOT produce narrative output for operational commands.
+ *
+ * CRITICAL REQUIREMENTS:
+ * - Enforce strict JSON outputs
+ * - Never allow narrative output
+ * - Validate output format before rendering
+ *
+ * FORBIDDEN:
+ * - Narrative/prose output
+ * - Unstructured text responses
+ * - Human-readable summaries (for operational commands)
+ */
+import { EXIT_CODES } from '../types/index.js';
+// ============================================================================
+// Output Format Gate Configuration
+// ============================================================================
+/**
+ * Allowed output formats for operational commands.
+ * Only structured formats are permitted.
+ */
+const ALLOWED_STRUCTURED_FORMATS = new Set([
+    'json',
+    'yaml',
+]);
+/**
+ * Exit code for invalid output format.
+ */
+export const INVALID_FORMAT_EXIT_CODE = EXIT_CODES.DATA_FORMAT_ERROR;
+// ============================================================================
+// Output Format Gate Error
+// ============================================================================
+export class InvalidOutputFormatError extends Error {
+    requestedFormat;
+    allowedFormats;
+    constructor(requestedFormat, allowedFormats) {
+        super(`\n` +
+            `━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n` +
+            `  INVALID OUTPUT FORMAT\n` +
+            `━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n` +
+            `\n` +
+            `  Requested format: ${requestedFormat}\n` +
+            `  Allowed formats:  ${allowedFormats.join(', ')}\n` +
+            `\n` +
+            `  The CLI enforces strict JSON output for operational commands.\n` +
+            `  Narrative output formats are not permitted.\n` +
+            `\n` +
+            `  TO FIX:\n` +
+            `\n` +
+            `  Use --format json (default) or --format yaml\n` +
+            `\n` +
+            `  Example:\n` +
+            `    agentics plan "my plan" --format json\n` +
+            `\n` +
+            `━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n`);
+        this.name = 'InvalidOutputFormatError';
+        this.requestedFormat = requestedFormat;
+        this.allowedFormats = allowedFormats;
+    }
+}
+// ============================================================================
+// Output Format Gate Implementation
+// ============================================================================
+/**
+ * Validate the requested output format.
+ * Only structured formats (json, yaml) are allowed for operational commands.
+ */
+export function checkOutputFormatGate(requestedFormat, command) {
+    // Default to JSON if no format specified
+    const format = requestedFormat ?? 'json';
+    // Check if format is allowed
+    if (requiresStructuredOutput(command) && !ALLOWED_STRUCTURED_FORMATS.has(format)) {
+        const allowedFormats = Array.from(ALLOWED_STRUCTURED_FORMATS);
+        return {
+            valid: false,
+            format,
+            exitCode: INVALID_FORMAT_EXIT_CODE,
+            message: new InvalidOutputFormatError(format, allowedFormats).message,
+        };
+    }
+    return {
+        valid: true,
+        format,
+    };
+}
+/**
+ * Enforce the output format gate.
+ * Exits the process if an invalid format is requested.
+ */
+export function enforceOutputFormatGate(requestedFormat, command) {
+    const result = checkOutputFormatGate(requestedFormat, command);
+    if (!result.valid) {
+        console.error(result.message);
+        process.exit(result.exitCode);
+    }
+    return result.format;
+}
+/**
+ * Commands that require structured (JSON/YAML) output.
+ * All operational commands require structured output.
+ * Identity and meta commands can use any format.
+ */
+const STRUCTURED_OUTPUT_COMMANDS = new Set([
+    'plan',
+    'simulate',
+    'inspect',
+    'quantify',
+    'deploy',
+    'export',
+    'diligence',
+    'usage',
+    'policy',
+    'erp',
+]);
+/**
+ * Check if a command requires structured output.
+ */
+export function requiresStructuredOutput(command) {
+    return STRUCTURED_OUTPUT_COMMANDS.has(command);
+}
+/**
+ * Get the default output format for a command.
+ * Always returns 'json' for operational commands.
+ */
+export function getDefaultFormat(command) {
+    if (requiresStructuredOutput(command)) {
+        return 'json';
+    }
+    return 'text';
+}
+//# sourceMappingURL=output-format-gate.js.map

package/dist/gates/output-format-gate.js.map

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

package/dist/gates/service-health-gate.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Service Health Gate Module
+ *
+ * CONTROL PLANE HARDENING
+ *
+ * PURPOSE: Validate Ruvector-backed service availability before ANY remote execution.
+ *          This gate ensures the CLI NEVER executes against misconfigured or unavailable services.
+ *
+ * CRITICAL REQUIREMENTS:
+ * - CLI MUST require Ruvector-backed services
+ * - CLI MUST fail loudly if services are misconfigured
+ * - Abort command if health check fails
+ *
+ * FORBIDDEN:
+ * - Fallback behavior
+ * - Local caching of results
+ * - Silent failures
+ */
+/**
+ * Exit code for service unavailable.
+ */
+export declare const SERVICE_UNAVAILABLE_EXIT_CODE: 69;
+export declare class ServiceHealthError extends Error {
+    readonly serviceName: string;
+    readonly healthCheckUrl: string;
+    readonly cause?: Error;
+    constructor(serviceName: string, healthCheckUrl: string, cause?: Error);
+}
+export interface ServiceHealthResult {
+    healthy: boolean;
+    service: string;
+    url: string;
+    latency?: number;
+    error?: string;
+}
+export interface ServiceHealthGateResult {
+    passed: boolean;
+    results: ServiceHealthResult[];
+    exitCode?: number;
+    message?: string;
+}
+/**
+ * Check if all critical services are healthy.
+ * Returns a structured result - does not exit the process.
+ */
+export declare function checkServiceHealthGate(): Promise<ServiceHealthGateResult>;
+/**
+ * Enforce the service health gate. Exits the process if any critical service is unhealthy.
+ * This is the HARD gate that blocks all operations if services are misconfigured.
+ */
+export declare function enforceServiceHealthGate(): Promise<void>;
+/**
+ * Check if a command requires service health check.
+ */
+export declare function requiresHealthCheck(command: string): boolean;
+//# sourceMappingURL=service-health-gate.d.ts.map

package/dist/gates/service-health-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-health-gate.d.ts","sourceRoot":"","sources":["../../src/gates/service-health-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAsBH;;GAEG;AACH,eAAO,MAAM,6BAA6B,IAAiC,CAAC;AAM5E,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;gBAEX,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAoCvE;AAMD,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA4CD;;;GAGG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,uBAAuB,CAAC,CAgC/E;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC,CAO9D;AAoBD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE5D"}

package/dist/gates/service-health-gate.js

@@ -0,0 +1,179 @@
+/**
+ * Service Health Gate Module
+ *
+ * CONTROL PLANE HARDENING
+ *
+ * PURPOSE: Validate Ruvector-backed service availability before ANY remote execution.
+ *          This gate ensures the CLI NEVER executes against misconfigured or unavailable services.
+ *
+ * CRITICAL REQUIREMENTS:
+ * - CLI MUST require Ruvector-backed services
+ * - CLI MUST fail loudly if services are misconfigured
+ * - Abort command if health check fails
+ *
+ * FORBIDDEN:
+ * - Fallback behavior
+ * - Local caching of results
+ * - Silent failures
+ */
+import { loadEndpointConfig } from '../config/endpoints.js';
+import { BaseAdapter } from '../adapters/base-adapter.js';
+import { EXIT_CODES } from '../types/index.js';
+// ============================================================================
+// Service Health Gate Configuration
+// ============================================================================
+/**
+ * Critical services that MUST be healthy before any operational command.
+ * Ruvector is the primary persistence layer - without it, operations cannot be verified.
+ */
+const CRITICAL_SERVICES = ['ruvector-service'];
+/**
+ * Timeout for health checks (in milliseconds).
+ * Fast timeout - services should respond quickly if healthy.
+ */
+const HEALTH_CHECK_TIMEOUT_MS = 5000;
+/**
+ * Exit code for service unavailable.
+ */
+export const SERVICE_UNAVAILABLE_EXIT_CODE = EXIT_CODES.SERVICE_UNAVAILABLE;
+// ============================================================================
+// Service Health Gate Error
+// ============================================================================
+export class ServiceHealthError extends Error {
+    serviceName;
+    healthCheckUrl;
+    cause;
+    constructor(serviceName, healthCheckUrl, cause) {
+        super(`\n` +
+            `━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n` +
+            `  SERVICE UNAVAILABLE\n` +
+            `━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n` +
+            `\n` +
+            `  Service:     ${serviceName}\n` +
+            `  Health URL:  ${healthCheckUrl}/health\n` +
+            `  Status:      UNREACHABLE\n` +
+            `\n` +
+            `  The CLI requires this Ruvector-backed service to be available.\n` +
+            `  All operational commands are blocked until the service is healthy.\n` +
+            `\n` +
+            `  TROUBLESHOOTING:\n` +
+            `\n` +
+            `  1. Verify service deployment:\n` +
+            `     Check that the Cloud Run service is deployed and running.\n` +
+            `\n` +
+            `  2. Check network connectivity:\n` +
+            `     Ensure you have network access to the service URL.\n` +
+            `\n` +
+            `  3. Verify authentication:\n` +
+            `     Run 'agentics whoami' to check authentication status.\n` +
+            `\n` +
+            `  4. Contact platform support:\n` +
+            `     If the issue persists, contact the Agentics platform team.\n` +
+            `\n` +
+            (cause ? `  Error: ${cause.message}\n\n` : '') +
+            `━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n`);
+        this.name = 'ServiceHealthError';
+        this.serviceName = serviceName;
+        this.healthCheckUrl = healthCheckUrl;
+        this.cause = cause;
+    }
+}
+// ============================================================================
+// Service Health Gate Implementation
+// ============================================================================
+/**
+ * Check health of a single service.
+ * Returns structured result - does not throw.
+ */
+async function checkServiceHealth(serviceName) {
+    const startTime = Date.now();
+    try {
+        const config = loadEndpointConfig(serviceName);
+        const adapter = new BaseAdapter({
+            serviceName,
+            config: {
+                ...config,
+                timeout: HEALTH_CHECK_TIMEOUT_MS,
+            },
+        });
+        const healthResult = await adapter.health();
+        return {
+            healthy: healthResult.healthy,
+            service: serviceName,
+            url: config.baseUrl,
+            latency: Date.now() - startTime,
+        };
+    }
+    catch (error) {
+        return {
+            healthy: false,
+            service: serviceName,
+            url: 'unknown',
+            latency: Date.now() - startTime,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+    }
+}
+/**
+ * Check if all critical services are healthy.
+ * Returns a structured result - does not exit the process.
+ */
+export async function checkServiceHealthGate() {
+    const results = [];
+    // Check all critical services in parallel
+    const healthChecks = CRITICAL_SERVICES.map(service => checkServiceHealth(service));
+    const healthResults = await Promise.all(healthChecks);
+    for (const result of healthResults) {
+        results.push(result);
+    }
+    // Gate passes only if ALL critical services are healthy
+    const unhealthyServices = results.filter(r => !r.healthy);
+    if (unhealthyServices.length > 0) {
+        const failedService = unhealthyServices[0];
+        return {
+            passed: false,
+            results,
+            exitCode: SERVICE_UNAVAILABLE_EXIT_CODE,
+            message: new ServiceHealthError(failedService.service, failedService.url, failedService.error ? new Error(failedService.error) : undefined).message,
+        };
+    }
+    return {
+        passed: true,
+        results,
+    };
+}
+/**
+ * Enforce the service health gate. Exits the process if any critical service is unhealthy.
+ * This is the HARD gate that blocks all operations if services are misconfigured.
+ */
+export async function enforceServiceHealthGate() {
+    const result = await checkServiceHealthGate();
+    if (!result.passed) {
+        console.error(result.message);
+        process.exit(result.exitCode);
+    }
+}
+/**
+ * Commands that require service health check.
+ * All operational commands require healthy services.
+ * Identity commands (login, logout, whoami) and meta commands (help, version) do NOT require health checks.
+ */
+const HEALTH_CHECK_REQUIRED_COMMANDS = new Set([
+    'plan',
+    'simulate',
+    'inspect',
+    'quantify',
+    'deploy',
+    'export',
+    'diligence',
+    'usage',
+    'policy',
+    'erp',
+]);
+/**
+ * Check if a command requires service health check.
+ */
+export function requiresHealthCheck(command) {
+    return HEALTH_CHECK_REQUIRED_COMMANDS.has(command);
+}
+//# sourceMappingURL=service-health-gate.js.map

package/dist/gates/service-health-gate.js.map

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

package/dist/modules/help-renderer.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Help Renderer — Auto-Generated from ADR-001
+ *
+ * This module renders CLI help output directly from the command registry
+ * defined in adr-command-semantics.ts. No hand-maintained help strings.
+ *
+ * The ADR is the single source of truth for:
+ * - Command descriptions
+ * - Argument names and types
+ * - Synthesis classification
+ * - Examples
+ */
+/**
+ * Render the top-level help screen.
+ */
+export declare function renderHelp(): string;
+/**
+ * Render help for a specific command (including all its subcommands).
+ */
+export declare function renderCommandHelp(primary: string): string;
+/**
+ * Render help for a specific command + subcommand.
+ */
+export declare function renderSubcommandHelp(primary: string, subcommand: string): string;
+//# sourceMappingURL=help-renderer.d.ts.map

package/dist/modules/help-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-renderer.d.ts","sourceRoot":"","sources":["../../src/modules/help-renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAcH;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAwCnC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAmCzD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAYhF"}

package/dist/modules/help-renderer.js

@@ -0,0 +1,163 @@
+/**
+ * Help Renderer — Auto-Generated from ADR-001
+ *
+ * This module renders CLI help output directly from the command registry
+ * defined in adr-command-semantics.ts. No hand-maintained help strings.
+ *
+ * The ADR is the single source of truth for:
+ * - Command descriptions
+ * - Argument names and types
+ * - Synthesis classification
+ * - Examples
+ */
+import { COMMAND_REGISTRY, getSubcommands, lookupCommand, } from '../contracts/adr-command-semantics.js';
+// ============================================================================
+// Help Rendering
+// ============================================================================
+/**
+ * Render the top-level help screen.
+ */
+export function renderHelp() {
+    const lines = [];
+    lines.push('Agentics CLI — Enterprise Orchestration Platform');
+    lines.push('');
+    lines.push('USAGE:');
+    lines.push('  agentics <command> [subcommand] [args] [options]');
+    lines.push('');
+    lines.push('COMMANDS:');
+    // Group commands by primary
+    const groups = groupByPrimary();
+    for (const [primary, specs] of groups) {
+        const mainSpec = specs.find(s => !s.subcommand) ?? specs[0];
+        const label = primary.padEnd(14);
+        const desc = mainSpec.description;
+        const tag = formatSynthesisTag(mainSpec.synthesis);
+        lines.push(`  ${label} ${desc} ${tag}`);
+    }
+    lines.push('');
+    lines.push('ARGUMENT TYPES:');
+    lines.push('  <id>            Stable identifier (lowercase, hyphenated, or UUID)');
+    lines.push('  "<description>" Quoted natural language (seeds synthesis)');
+    lines.push('  latest          Read-only selector keyword');
+    lines.push('');
+    lines.push('SYNTHESIS TAGS:');
+    lines.push('  [synth]     Command invokes LLM synthesis');
+    lines.push('  [commit]    Irreversible command (requires ID + confirmation)');
+    lines.push('  (unmarked)  Read-only or identity command, no synthesis');
+    lines.push('');
+    lines.push('GLOBAL OPTIONS:');
+    lines.push('  --verbose       Enable verbose output');
+    lines.push('  --format <fmt>  Output format: json | yaml | text');
+    lines.push('  --help          Show help for a specific command');
+    lines.push('');
+    lines.push('Run `agentics <command> --help` for command-specific help.');
+    return lines.join('\n');
+}
+/**
+ * Render help for a specific command (including all its subcommands).
+ */
+export function renderCommandHelp(primary) {
+    const specs = getSubcommands(primary);
+    if (specs.length === 0) {
+        return `Unknown command: ${primary}\n\nRun \`agentics help\` to see available commands.`;
+    }
+    const lines = [];
+    lines.push(`agentics ${primary} — ${specs[0].description}`);
+    lines.push('');
+    if (specs.length === 1 && !specs[0].subcommand) {
+        // Single command, no subcommands
+        lines.push(...renderSpecDetail(specs[0]));
+    }
+    else {
+        lines.push('SUBCOMMANDS:');
+        lines.push('');
+        for (const spec of specs) {
+            if (spec.subcommand) {
+                lines.push(...renderSpecDetail(spec));
+                lines.push('');
+            }
+        }
+        // Also show main command if it has args
+        const mainSpec = specs.find(s => !s.subcommand);
+        if (mainSpec !== undefined && mainSpec.args.length > 0) {
+            lines.push('DEFAULT (no subcommand):');
+            lines.push(...renderSpecDetail(mainSpec));
+            lines.push('');
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Render help for a specific command + subcommand.
+ */
+export function renderSubcommandHelp(primary, subcommand) {
+    const spec = lookupCommand(primary, subcommand);
+    if (!spec) {
+        return `Unknown subcommand: ${primary} ${subcommand}\n\n` +
+            `Run \`agentics ${primary} --help\` to see available subcommands.`;
+    }
+    const lines = [];
+    lines.push(`agentics ${spec.command}`);
+    lines.push('');
+    lines.push(...renderSpecDetail(spec));
+    return lines.join('\n');
+}
+// ============================================================================
+// Internal Rendering Helpers
+// ============================================================================
+function renderSpecDetail(spec) {
+    const lines = [];
+    const tag = formatSynthesisTag(spec.synthesis);
+    const subcmd = spec.subcommand ?? '';
+    lines.push(`  ${subcmd.padEnd(12)} ${spec.description} ${tag}`);
+    if (spec.args.length > 0) {
+        const usage = spec.args
+            .map(a => a.required ? `<${a.name}>` : `[${a.name}]`)
+            .join(' ');
+        lines.push(`               Usage: agentics ${spec.command} ${usage}`);
+        for (const arg of spec.args) {
+            const typeLabel = formatArgumentTypeLabel(arg.type);
+            lines.push(`               ${`<${arg.name}>`.padEnd(20)} ${typeLabel}  ${arg.description}`);
+            lines.push(`               ${''.padEnd(20)} Example: ${arg.example}`);
+        }
+    }
+    if (spec.irreversible) {
+        lines.push(`               WARNING: This command is irreversible.`);
+    }
+    if (spec.requiresConfirmation) {
+        lines.push(`               Requires explicit confirmation (--force or interactive).`);
+    }
+    return lines;
+}
+function formatSynthesisTag(synthesis) {
+    switch (synthesis) {
+        case 'SYNTHESIS_REQUIRED':
+            return '[synth]';
+        case 'COMMITMENT_GRADE':
+            return '[commit]';
+        case 'SYNTHESIS_FORBIDDEN':
+            return '';
+    }
+}
+function formatArgumentTypeLabel(type) {
+    switch (type) {
+        case 'ID':
+            return '(ID)';
+        case 'NATURAL_LANGUAGE':
+            return '(text)';
+        case 'SELECTOR':
+            return '(selector)';
+        default:
+            return '';
+    }
+}
+function groupByPrimary() {
+    const groups = new Map();
+    for (const spec of COMMAND_REGISTRY) {
+        const existing = groups.get(spec.primary) ?? [];
+        existing.push(spec);
+        groups.set(spec.primary, existing);
+    }
+    return groups;
+}
+//# sourceMappingURL=help-renderer.js.map

package/dist/modules/help-renderer.js.map

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

package/dist/modules/index.d.ts

@@ -11,4 +11,5 @@ export { ArtifactHandoff, createArtifactHandoff, isPlanReference, isSimulationRe
 export type { IArtifactHandoff } from './artifact-handoff.js';
 export { OutputRenderer, createOutputRenderer } from './output-renderer.js';
 export type { IOutputRenderer } from './output-renderer.js';
+export { renderHelp, renderCommandHelp, renderSubcommandHelp } from './help-renderer.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/modules/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC7F,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5E,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAC3F,YAAY,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAExG,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,eAAe,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AAC1L,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5E,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/modules/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC7F,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5E,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAC3F,YAAY,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAExG,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,eAAe,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AAC1L,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5E,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/modules/index.js

@@ -7,4 +7,5 @@ export { CommandParser, createCommandParser, SUPPORTED_COMMANDS } from './comman
 export { OrchestrationEngine, createOrchestrationEngine } from './orchestration-engine.js';
 export { ArtifactHandoff, createArtifactHandoff, isPlanReference, isSimulationReference, isIntentReference, isExportReference, isDiligencePackageReference } from './artifact-handoff.js';
 export { OutputRenderer, createOutputRenderer } from './output-renderer.js';
+export { renderHelp, renderCommandHelp, renderSubcommandHelp } from './help-renderer.js';
 //# sourceMappingURL=index.js.map

package/dist/modules/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/modules/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAG7F,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAG3F,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,eAAe,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AAG1L,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/modules/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAG7F,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAG3F,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,eAAe,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AAG1L,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAG5E,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/server/index.d.ts

@@ -9,6 +9,8 @@
  * - GET  /ready                      - Readiness check
  * - POST /v1/cli/auth/sessions       - OAuth device flow session creation
  * - GET  /v1/cli/auth/sessions/:code - Poll auth status
+ * - GET  /v1/identity/whoami         - Identity resolution (user + org + role)
+ * - POST /v1/identity/check-permission - Server-side permission check
  * - POST /v1/simulate                - Simulation engine (inspect command)
  * - POST /v1/manifests               - Manifests service (plan command)
  * - POST /v1/plans                   - Planner service (plan command)

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAsB5B,QAAA,MAAM,GAAG,4EAAa,CAAC;AAsIvB,OAAO,EAAE,GAAG,EAAE,CAAC;AACf,eAAe,GAAG,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAwB5B,QAAA,MAAM,GAAG,4EAAa,CAAC;AAoJvB,OAAO,EAAE,GAAG,EAAE,CAAC;AACf,eAAe,GAAG,CAAC"}