@ontologie/cli 0.1.0-preview.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"plain.d.ts","sourceRoot":"","sources":["../../src/output/plain.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,CAgBlE"}

package/dist/output/plain.js

@@ -0,0 +1,51 @@
+/**
+ * Plain text output — agent-friendly structured text
+ */
+export function outputPlain(data, meta) {
+    if (Array.isArray(data)) {
+        for (const item of data) {
+            outputPlainItem(item);
+            process.stdout.write('\n');
+        }
+    }
+    else if (typeof data === 'object' && data !== null) {
+        outputPlainItem(data);
+    }
+    else {
+        process.stdout.write(String(data) + '\n');
+    }
+    if (meta) {
+        process.stdout.write(`---\n`);
+        process.stdout.write(`Source: ${meta.source} | ${meta.latency_ms}ms | ${meta.retrievedAt}\n`);
+    }
+}
+function outputPlainItem(obj, indent = 0) {
+    const prefix = ' '.repeat(indent);
+    for (const [key, value] of Object.entries(obj)) {
+        if (value === null || value === undefined)
+            continue;
+        if (typeof value === 'object' && !Array.isArray(value)) {
+            process.stdout.write(`${prefix}${key}:\n`);
+            outputPlainItem(value, indent + 2);
+        }
+        else if (Array.isArray(value)) {
+            process.stdout.write(`${prefix}${key}: [${value.length} items]\n`);
+            for (const item of value.slice(0, 5)) {
+                if (typeof item === 'object' && item !== null) {
+                    process.stdout.write(`${prefix}  -\n`);
+                    outputPlainItem(item, indent + 4);
+                }
+                else {
+                    process.stdout.write(`${prefix}  - ${String(item)}\n`);
+                }
+            }
+            if (value.length > 5) {
+                process.stdout.write(`${prefix}  ... and ${value.length - 5} more\n`);
+            }
+        }
+        else {
+            process.stdout.write(`${prefix}${key}: ${String(value)}\n`);
+        }
+    }
+}
+//# sourceMappingURL=plain.js.map

package/dist/output/plain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plain.js","sourceRoot":"","sources":["../../src/output/plain.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,UAAU,WAAW,CAAC,IAAa,EAAE,IAAiB;IAC1D,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;YACxB,eAAe,CAAC,IAAI,CAAC,CAAC;YACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;SAAM,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QACrD,eAAe,CAAC,IAA+B,CAAC,CAAC;IACnD,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC9B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,IAAI,CAAC,MAAM,MAAM,IAAI,CAAC,UAAU,QAAQ,IAAI,CAAC,WAAW,IAAI,CAAC,CAAC;IAChG,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,GAA4B,EAAE,MAAM,GAAG,CAAC;IAC/D,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAClC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QACpD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACvD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC;YAC3C,eAAe,CAAC,KAAgC,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC;QAChE,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,MAAM,WAAW,CAAC,CAAC;YACnE,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;gBACrC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;oBAC9C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,OAAO,CAAC,CAAC;oBACvC,eAAe,CAAC,IAA+B,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC;gBAC/D,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACzD,CAAC;YACH,CAAC;YACD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,aAAa,KAAK,CAAC,MAAM,GAAG,CAAC,SAAS,CAAC,CAAC;YACxE,CAAC;QACH,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,GAAG,GAAG,KAAK,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/output/table.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Lightweight ASCII table renderer (~80 LOC, no dependency)
+ */
+export declare function outputTable(rows: Record<string, unknown>[], columns?: string[]): void;
+//# sourceMappingURL=table.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../src/output/table.ts"],"names":[],"mappings":"AAAA;;GAEG;AAcH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CA4CrF"}

package/dist/output/table.js

@@ -0,0 +1,54 @@
+/**
+ * Lightweight ASCII table renderer (~80 LOC, no dependency)
+ */
+const MAX_COL_WIDTH = 40;
+const isTTY = process.stdout.isTTY;
+function truncate(str, max) {
+    if (str.length <= max)
+        return str;
+    return str.slice(0, max - 1) + '…';
+}
+function pad(str, width) {
+    return str + ' '.repeat(Math.max(0, width - str.length));
+}
+export function outputTable(rows, columns) {
+    if (rows.length === 0) {
+        process.stdout.write('(no results)\n');
+        return;
+    }
+    const cols = columns || Object.keys(rows[0]);
+    // Compute column widths
+    const widths = new Map();
+    for (const col of cols) {
+        widths.set(col, col.length);
+    }
+    for (const row of rows) {
+        for (const col of cols) {
+            const val = String(row[col] ?? '');
+            const len = Math.min(val.length, MAX_COL_WIDTH);
+            widths.set(col, Math.max(widths.get(col), len));
+        }
+    }
+    // Header
+    const headerLine = cols.map(c => pad(c.toUpperCase(), widths.get(c))).join('  ');
+    if (isTTY) {
+        process.stdout.write(`\x1b[1m${headerLine}\x1b[0m\n`);
+    }
+    else {
+        process.stdout.write(headerLine + '\n');
+    }
+    // Separator
+    const sep = cols.map(c => '─'.repeat(widths.get(c))).join('──');
+    process.stdout.write(sep + '\n');
+    // Rows
+    for (const row of rows) {
+        const line = cols.map(c => {
+            const val = String(row[c] ?? '');
+            return pad(truncate(val, MAX_COL_WIDTH), widths.get(c));
+        }).join('  ');
+        process.stdout.write(line + '\n');
+    }
+    // Footer
+    process.stdout.write(`\n${rows.length} row(s)\n`);
+}
+//# sourceMappingURL=table.js.map

package/dist/output/table.js.map

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

package/dist/output/types.d.ts

@@ -0,0 +1,54 @@
+/**
+ * CLI JSON Contract types — dataforge.cli.v1
+ *
+ * Canonical reference: sdk/docs/cli-contract.md
+ *
+ * SOT direction:
+ *  - Zod schemas in `./envelope.schema.ts` are the source of truth.
+ *  - Derived TypeScript types (`CliMeta`, `CliError`, `CliWarning`, `CliPage`,
+ *    `CliEnvelope`, `CliEnvironment`, `CliErrorCode`, `CLI_META_SCHEMA_VERSION`)
+ *    are exported from `envelope.schema.ts` via `z.infer` and re-exported here.
+ *  - The ZOD-TS-PARITY-01 structural ratchet enforces this direction.
+ *  - Hand-written types in this file (JSONL events, exit map, helpers) cover
+ *    surfaces Zod cannot model directly (generic payloads, runtime helpers).
+ */
+export { CLI_META_SCHEMA_VERSION, type CliMetaSchemaVersion, type CliEnvironment, type CliErrorCode, type CliMeta, type CliError, type CliWarning, type CliPage, type CliEnvelope, } from './envelope.schema.js';
+import type { CliErrorCode } from './envelope.schema.js';
+export declare const ERROR_EXIT_MAP: Record<CliErrorCode, number>;
+import type { CliMeta, CliError, CliWarning } from './envelope.schema.js';
+export type JsonlEventType = 'started' | 'progress' | 'item' | 'warning' | 'completed' | 'error';
+export interface JsonlStartedEvent {
+    type: 'started';
+    meta: CliMeta;
+    total: number | null;
+}
+export interface JsonlProgressEvent {
+    type: 'progress';
+    current: number;
+    total: number | null;
+    message: string;
+}
+export interface JsonlItemEvent<T = unknown> {
+    type: 'item';
+    data: T;
+}
+export interface JsonlWarningEvent {
+    type: 'warning';
+    warning: CliWarning;
+}
+export interface JsonlCompletedEvent {
+    type: 'completed';
+    meta: CliMeta;
+    summary: {
+        count: number;
+        costUnits: number;
+    };
+}
+export interface JsonlErrorEvent {
+    type: 'error';
+    error: CliError;
+}
+export type JsonlEvent<T = unknown> = JsonlStartedEvent | JsonlProgressEvent | JsonlItemEvent<T> | JsonlWarningEvent | JsonlCompletedEvent | JsonlErrorEvent;
+export declare function isRetryable(code: CliErrorCode): boolean;
+export declare function generateRequestId(prefix?: 'req' | 'local_req' | 'mock_req'): string;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/output/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAQH,OAAO,EACL,uBAAuB,EACvB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,OAAO,EACZ,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,OAAO,EACZ,KAAK,WAAW,GACjB,MAAM,sBAAsB,CAAC;AAM9B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAqCvD,CAAC;AAMF,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAE1E,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;AAEjG,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,CAAC,CAAC;CACT;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,UAAU,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/C;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,QAAQ,CAAC;CACjB;AAED,MAAM,MAAM,UAAU,CAAC,CAAC,GAAG,OAAO,IAC9B,iBAAiB,GACjB,kBAAkB,GAClB,cAAc,CAAC,CAAC,CAAC,GACjB,iBAAiB,GACjB,mBAAmB,GACnB,eAAe,CAAC;AAiBpB,wBAAgB,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAEvD;AAMD,wBAAgB,iBAAiB,CAAC,MAAM,GAAE,KAAK,GAAG,WAAW,GAAG,UAAwB,GAAG,MAAM,CAEhG"}

package/dist/output/types.js

@@ -0,0 +1,80 @@
+/**
+ * CLI JSON Contract types — dataforge.cli.v1
+ *
+ * Canonical reference: sdk/docs/cli-contract.md
+ *
+ * SOT direction:
+ *  - Zod schemas in `./envelope.schema.ts` are the source of truth.
+ *  - Derived TypeScript types (`CliMeta`, `CliError`, `CliWarning`, `CliPage`,
+ *    `CliEnvelope`, `CliEnvironment`, `CliErrorCode`, `CLI_META_SCHEMA_VERSION`)
+ *    are exported from `envelope.schema.ts` via `z.infer` and re-exported here.
+ *  - The ZOD-TS-PARITY-01 structural ratchet enforces this direction.
+ *  - Hand-written types in this file (JSONL events, exit map, helpers) cover
+ *    surfaces Zod cannot model directly (generic payloads, runtime helpers).
+ */
+import { randomUUID } from 'node:crypto';
+// ---------------------------------------------------------------------------
+// Re-exports from the Zod SOT (envelope.schema.ts)
+// ---------------------------------------------------------------------------
+export { CLI_META_SCHEMA_VERSION, } from './envelope.schema.js';
+export const ERROR_EXIT_MAP = {
+    // Exit 1 — General / internal / unavailable / not found
+    INTERNAL_ERROR: 1,
+    NOT_FOUND: 1,
+    UNAVAILABLE: 1,
+    RUNTIME_UNAVAILABLE: 1,
+    // Exit 2 — Usage or validation
+    INVALID_USAGE: 2,
+    VALIDATION_ERROR: 2,
+    // Exit 3 — Authentication
+    AUTHENTICATION_ERROR: 3,
+    // Exit 4 — Authorization
+    AUTHORIZATION_ERROR: 4,
+    WRITE_POLICY_VIOLATION: 4,
+    // Exit 5 — Capability drift
+    CAPABILITY_DRIFT_ERROR: 5,
+    // Exit 6 — Schema drift
+    SCHEMA_DRIFT_ERROR: 6,
+    // Exit 7 — Conflict
+    CONFLICT_ERROR: 7,
+    // Exit 8 — Rate limited
+    RATE_LIMITED: 8,
+    // Exit 9 — Network / timeout
+    NETWORK_ERROR: 9,
+    TIMEOUT_ERROR: 9,
+    // Exit 10 — Precondition / confirmation / policy
+    PRECONDITION_FAILED: 10,
+    CONFIRMATION_REQUIRED: 10,
+    POLICY_VIOLATION: 10,
+    PLAN_POLICY_MISMATCH: 10,
+    SOURCE_OF_TRUTH_CONFLICT: 10,
+    PLAN_CONTEXT_MISMATCH: 10,
+    // Exit 11 — Quota / budget
+    QUOTA_EXCEEDED: 11,
+    BUDGET_EXCEEDED: 11,
+    // Exit 12 — Configuration
+    CONFIGURATION_ERROR: 12,
+};
+// ---------------------------------------------------------------------------
+// Retryable codes
+// ---------------------------------------------------------------------------
+const RETRYABLE_CODES = new Set([
+    'RATE_LIMITED',
+    'CONFLICT_ERROR',
+    'PLAN_POLICY_MISMATCH',
+    'PLAN_CONTEXT_MISMATCH',
+    'NETWORK_ERROR',
+    'TIMEOUT_ERROR',
+    'UNAVAILABLE',
+    'RUNTIME_UNAVAILABLE',
+]);
+export function isRetryable(code) {
+    return RETRYABLE_CODES.has(code);
+}
+// ---------------------------------------------------------------------------
+// Request ID generation
+// ---------------------------------------------------------------------------
+export function generateRequestId(prefix = 'local_req') {
+    return `${prefix}_${randomUUID().replace(/-/g, '')}`;
+}
+//# sourceMappingURL=types.js.map

package/dist/output/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/output/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,8EAA8E;AAC9E,mDAAmD;AACnD,8EAA8E;AAE9E,OAAO,EACL,uBAAuB,GASxB,MAAM,sBAAsB,CAAC;AAQ9B,MAAM,CAAC,MAAM,cAAc,GAAiC;IAC1D,wDAAwD;IACxD,cAAc,EAAE,CAAC;IACjB,SAAS,EAAE,CAAC;IACZ,WAAW,EAAE,CAAC;IACd,mBAAmB,EAAE,CAAC;IACtB,+BAA+B;IAC/B,aAAa,EAAE,CAAC;IAChB,gBAAgB,EAAE,CAAC;IACnB,0BAA0B;IAC1B,oBAAoB,EAAE,CAAC;IACvB,yBAAyB;IACzB,mBAAmB,EAAE,CAAC;IACtB,sBAAsB,EAAE,CAAC;IACzB,4BAA4B;IAC5B,sBAAsB,EAAE,CAAC;IACzB,wBAAwB;IACxB,kBAAkB,EAAE,CAAC;IACrB,oBAAoB;IACpB,cAAc,EAAE,CAAC;IACjB,wBAAwB;IACxB,YAAY,EAAE,CAAC;IACf,6BAA6B;IAC7B,aAAa,EAAE,CAAC;IAChB,aAAa,EAAE,CAAC;IAChB,iDAAiD;IACjD,mBAAmB,EAAE,EAAE;IACvB,qBAAqB,EAAE,EAAE;IACzB,gBAAgB,EAAE,EAAE;IACpB,oBAAoB,EAAE,EAAE;IACxB,wBAAwB,EAAE,EAAE;IAC5B,qBAAqB,EAAE,EAAE;IACzB,2BAA2B;IAC3B,cAAc,EAAE,EAAE;IAClB,eAAe,EAAE,EAAE;IACnB,0BAA0B;IAC1B,mBAAmB,EAAE,EAAE;CACxB,CAAC;AAoDF,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,MAAM,eAAe,GAA8B,IAAI,GAAG,CAAC;IACzD,cAAc;IACd,gBAAgB;IAChB,sBAAsB;IACtB,uBAAuB;IACvB,eAAe;IACf,eAAe;IACf,aAAa;IACb,qBAAqB;CACtB,CAAC,CAAC;AAEH,MAAM,UAAU,WAAW,CAAC,IAAkB;IAC5C,OAAO,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC;AAED,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E,MAAM,UAAU,iBAAiB,CAAC,SAA2C,WAAW;IACtF,OAAO,GAAG,MAAM,IAAI,UAAU,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;AACvD,CAAC"}

package/dist/output/warnings.d.ts

@@ -0,0 +1,15 @@
+/**
+ * CLI warning collector — accumulates structured warnings per CLI invocation.
+ *
+ * Warnings are injected into CliMeta.warnings by buildCliMeta().
+ */
+import type { CliWarning } from './types.js';
+export declare function addWarning(warning: CliWarning): void;
+export declare function getWarnings(): CliWarning[];
+export declare function clearWarnings(): void;
+export declare const DEPRECATION_ESPACE: CliWarning;
+export declare function DEPRECATION_LEGACY_ENV(envVar: string, replacement: string): CliWarning;
+export declare const DEPRECATION_DOCS_ALIAS: CliWarning;
+export declare const DEPRECATION_DFRC: CliWarning;
+export declare const DEPRECATION_PARAMS: CliWarning;
+//# sourceMappingURL=warnings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"warnings.d.ts","sourceRoot":"","sources":["../../src/output/warnings.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAI7C,wBAAgB,UAAU,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAEpD;AAED,wBAAgB,WAAW,IAAI,UAAU,EAAE,CAE1C;AAED,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAMD,eAAO,MAAM,kBAAkB,EAAE,UAIhC,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,UAAU,CAMtF;AAED,eAAO,MAAM,sBAAsB,EAAE,UAIpC,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,UAI9B,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,UAIhC,CAAC"}

package/dist/output/warnings.js

@@ -0,0 +1,46 @@
+/**
+ * CLI warning collector — accumulates structured warnings per CLI invocation.
+ *
+ * Warnings are injected into CliMeta.warnings by buildCliMeta().
+ */
+const warnings = [];
+export function addWarning(warning) {
+    warnings.push(warning);
+}
+export function getWarnings() {
+    return [...warnings];
+}
+export function clearWarnings() {
+    warnings.length = 0;
+}
+// ---------------------------------------------------------------------------
+// Pre-defined warning constants
+// ---------------------------------------------------------------------------
+export const DEPRECATION_ESPACE = {
+    code: 'DEPRECATION_ESPACE',
+    message: '--espace is deprecated. Use --space instead.',
+    severity: 'deprecated',
+};
+export function DEPRECATION_LEGACY_ENV(envVar, replacement) {
+    return {
+        code: 'DEPRECATION_LEGACY_ENV',
+        message: `${envVar} is deprecated. Use ${replacement} instead.`,
+        severity: 'deprecated',
+    };
+}
+export const DEPRECATION_DOCS_ALIAS = {
+    code: 'DEPRECATION_DOCS_ALIAS',
+    message: '"docs" is deprecated. Use "knowledge" instead.',
+    severity: 'deprecated',
+};
+export const DEPRECATION_DFRC = {
+    code: 'DEPRECATION_DFRC',
+    message: '~/.dfrc is deprecated. Rename to ~/.ontologierc',
+    severity: 'deprecated',
+};
+export const DEPRECATION_PARAMS = {
+    code: 'DEPRECATION_PARAMS',
+    message: '--params is deprecated. Use --input-json or --input instead.',
+    severity: 'deprecated',
+};
+//# sourceMappingURL=warnings.js.map

package/dist/output/warnings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"warnings.js","sourceRoot":"","sources":["../../src/output/warnings.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,QAAQ,GAAiB,EAAE,CAAC;AAElC,MAAM,UAAU,UAAU,CAAC,OAAmB;IAC5C,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;AACtB,CAAC;AAED,8EAA8E;AAC9E,gCAAgC;AAChC,8EAA8E;AAE9E,MAAM,CAAC,MAAM,kBAAkB,GAAe;IAC5C,IAAI,EAAE,oBAAoB;IAC1B,OAAO,EAAE,8CAA8C;IACvD,QAAQ,EAAE,YAAY;CACvB,CAAC;AAEF,MAAM,UAAU,sBAAsB,CAAC,MAAc,EAAE,WAAmB;IACxE,OAAO;QACL,IAAI,EAAE,wBAAwB;QAC9B,OAAO,EAAE,GAAG,MAAM,uBAAuB,WAAW,WAAW;QAC/D,QAAQ,EAAE,YAAY;KACvB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,sBAAsB,GAAe;IAChD,IAAI,EAAE,wBAAwB;IAC9B,OAAO,EAAE,gDAAgD;IACzD,QAAQ,EAAE,YAAY;CACvB,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAe;IAC1C,IAAI,EAAE,kBAAkB;IACxB,OAAO,EAAE,iDAAiD;IAC1D,QAAQ,EAAE,YAAY;CACvB,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAe;IAC5C,IAAI,EAAE,oBAAoB;IAC1B,OAAO,EAAE,8DAA8D;IACvE,QAAQ,EAAE,YAAY;CACvB,CAAC"}

package/dist/output/yaml.d.ts

@@ -0,0 +1,6 @@
+/**
+ * YAML output using the yaml package
+ */
+import type { OutputMeta } from './meta.js';
+export declare function outputYaml(data: unknown, meta?: OutputMeta): void;
+//# sourceMappingURL=yaml.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"yaml.d.ts","sourceRoot":"","sources":["../../src/output/yaml.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,CAGjE"}

package/dist/output/yaml.js

@@ -0,0 +1,9 @@
+/**
+ * YAML output using the yaml package
+ */
+import { stringify } from 'yaml';
+export function outputYaml(data, meta) {
+    const envelope = meta ? { _meta: meta, data } : data;
+    process.stdout.write(stringify(envelope));
+}
+//# sourceMappingURL=yaml.js.map

package/dist/output/yaml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml.js","sourceRoot":"","sources":["../../src/output/yaml.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAGjC,MAAM,UAAU,UAAU,CAAC,IAAa,EAAE,IAAiB;IACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACrD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC5C,CAAC"}

package/dist/schema/breaking-changes.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Breaking change detection for schema diffs.
+ *
+ * Covers:
+ *  - Removals of objectType, property, action, linkType, interface
+ *  - Added required property to existing type
+ *  - Property modifications: dataType change, required false/undefined→true,
+ *    unique false/undefined→true, enum value removal
+ *  - LinkType modifications: cardinality, source/target type changes
+ *  - ObjectType modifications: primaryKey change
+ *  - Action modifications: actionType change, target entity change,
+ *    new required input parameter added
+ *  - Interface modifications: sharedProperties change
+ */
+import type { DiffResult, DiffChange } from '@dataforge/schema';
+export declare function getBreakingChanges(result: DiffResult): DiffChange[];
+//# sourceMappingURL=breaking-changes.d.ts.map

package/dist/schema/breaking-changes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"breaking-changes.d.ts","sourceRoot":"","sources":["../../src/schema/breaking-changes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGhE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,EAAE,CA0GnE"}

package/dist/schema/breaking-changes.js

@@ -0,0 +1,108 @@
+/**
+ * Breaking change detection for schema diffs.
+ *
+ * Covers:
+ *  - Removals of objectType, property, action, linkType, interface
+ *  - Added required property to existing type
+ *  - Property modifications: dataType change, required false/undefined→true,
+ *    unique false/undefined→true, enum value removal
+ *  - LinkType modifications: cardinality, source/target type changes
+ *  - ObjectType modifications: primaryKey change
+ *  - Action modifications: actionType change, target entity change,
+ *    new required input parameter added
+ *  - Interface modifications: sharedProperties change
+ */
+import { readRecord, readString } from './helpers.js';
+export function getBreakingChanges(result) {
+    return (result.changes ?? []).filter((change) => {
+        // --- Removals ---
+        if (change.kind === 'removed') {
+            return (change.entity === 'objectType' ||
+                change.entity === 'property' ||
+                change.entity === 'action' ||
+                change.entity === 'linkType' ||
+                change.entity === 'interface');
+        }
+        // --- Added required property is breaking for existing instances ---
+        if (change.kind === 'added' && change.entity === 'property') {
+            const after = readRecord(change.after);
+            return Boolean(after.required);
+        }
+        if (change.kind !== 'modified') {
+            return false;
+        }
+        // --- Property modifications ---
+        if (change.entity === 'property') {
+            const before = readRecord(change.before);
+            const after = readRecord(change.after);
+            // dataType change
+            if (before.dataType !== after.dataType)
+                return true;
+            // required: normalize undefined/false → Boolean before comparing
+            if (!Boolean(before.required) && Boolean(after.required))
+                return true;
+            // unique: normalize undefined/false → Boolean before comparing
+            if (!Boolean(before.unique) && Boolean(after.unique))
+                return true;
+            // Enum value removal
+            if (after.dataType === 'enum') {
+                const beforeValues = Array.isArray(before.enumValues) ? before.enumValues : [];
+                const afterValues = Array.isArray(after.enumValues) ? after.enumValues : [];
+                const afterSet = new Set(afterValues.map(String));
+                if (beforeValues.some((v) => !afterSet.has(String(v))))
+                    return true;
+            }
+            return false;
+        }
+        // --- LinkType modifications ---
+        if (change.entity === 'linkType') {
+            const before = readRecord(change.before);
+            const after = readRecord(change.after);
+            if (before.cardinality !== after.cardinality)
+                return true;
+            // Source/target type changes
+            if (readString(before.sourceTypeApiName) !== readString(after.sourceTypeApiName))
+                return true;
+            if (readString(before.targetTypeApiName) !== readString(after.targetTypeApiName))
+                return true;
+            return false;
+        }
+        // --- ObjectType modifications ---
+        if (change.entity === 'objectType') {
+            const before = readRecord(change.before);
+            const after = readRecord(change.after);
+            return before.primaryKey !== after.primaryKey;
+        }
+        // --- Action modifications ---
+        if (change.entity === 'action') {
+            const before = readRecord(change.before);
+            const after = readRecord(change.after);
+            // actionType change (create → update, etc.)
+            if (readString(before.actionType) !== readString(after.actionType))
+                return true;
+            // Target entity changed
+            if (readString(before.objectTypeApiName) !== readString(after.objectTypeApiName))
+                return true;
+            // New required input parameter added
+            const beforeInputs = Array.isArray(before.parameters) ? before.parameters : [];
+            const afterInputs = Array.isArray(after.parameters) ? after.parameters : [];
+            const beforeNames = new Set(beforeInputs.map((p) => readString(p?.name)));
+            const hasNewRequired = afterInputs.some((p) => {
+                const param = p;
+                return Boolean(param?.required) && !beforeNames.has(readString(param?.name));
+            });
+            if (hasNewRequired)
+                return true;
+            return false;
+        }
+        // --- Interface modifications ---
+        if (change.entity === 'interface') {
+            const before = readRecord(change.before);
+            const after = readRecord(change.after);
+            if (before.sharedProperties !== after.sharedProperties)
+                return true;
+        }
+        return false;
+    });
+}
+//# sourceMappingURL=breaking-changes.js.map

package/dist/schema/breaking-changes.js.map

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

package/dist/schema/helpers.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Shared utility helpers for schema operations.
+ */
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export declare function readString(value: unknown): string | undefined;
+export declare function readId(value: unknown): string | undefined;
+export declare function readRecord(value: unknown): Record<string, unknown>;
+/**
+ * Read a file, returning null if the file does not exist (ENOENT).
+ * Re-throws all other filesystem errors.
+ */
+export declare function readOptionalTextFile(filePath: string): Promise<string | null>;
+/**
+ * Extract the Node.js filesystem error code (e.g. 'ENOENT', 'EACCES') from
+ * an error object.
+ */
+export declare function extractFsCode(err: unknown): string | null;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/schema/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/schema/helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAE7D;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAIzD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAElE;AAMD;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQnF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAIzD"}

package/dist/schema/helpers.js

@@ -0,0 +1,48 @@
+/**
+ * Shared utility helpers for schema operations.
+ */
+export function isRecord(value) {
+    return !!value && typeof value === 'object' && !Array.isArray(value);
+}
+export function readString(value) {
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+export function readId(value) {
+    if (typeof value === 'string' && value.length > 0)
+        return value;
+    if (typeof value === 'number' && Number.isFinite(value))
+        return String(value);
+    return undefined;
+}
+export function readRecord(value) {
+    return isRecord(value) ? value : {};
+}
+// ---------------------------------------------------------------------------
+// Filesystem helpers
+// ---------------------------------------------------------------------------
+/**
+ * Read a file, returning null if the file does not exist (ENOENT).
+ * Re-throws all other filesystem errors.
+ */
+export async function readOptionalTextFile(filePath) {
+    const fs = await import('node:fs');
+    try {
+        return await fs.promises.readFile(filePath, 'utf-8');
+    }
+    catch (error) {
+        if (isRecord(error) && error.code === 'ENOENT')
+            return null;
+        throw error;
+    }
+}
+/**
+ * Extract the Node.js filesystem error code (e.g. 'ENOENT', 'EACCES') from
+ * an error object.
+ */
+export function extractFsCode(err) {
+    if (!err || typeof err !== 'object')
+        return null;
+    const code = err.code;
+    return typeof code === 'string' && /^E[A-Z]+$/.test(code) ? code : null;
+}
+//# sourceMappingURL=helpers.js.map

package/dist/schema/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/schema/helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,CAAC,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,KAAc;IACnC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAChE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9E,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AACtC,CAAC;AAED,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,QAAgB;IACzD,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;IACnC,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACvD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC5D,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACjD,MAAM,IAAI,GAAI,GAA+B,CAAC,IAAI,CAAC;IACnD,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1E,CAAC"}

package/dist/schema/load-schema-file.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Schema file loading — dynamic import with WeakSet deduplication
+ * and clear TypeScript loader error messages.
+ */
+import type { ObjectTypeDefinition, ActionDefinition } from '@dataforge/schema';
+type ParseNodeProperties = (raw: unknown) => unknown[];
+export declare function loadParseNodeProperties(): Promise<ParseNodeProperties>;
+export declare function loadSchemaFile(schemaPath: string): Promise<{
+    objectTypes: ObjectTypeDefinition[];
+    actions: ActionDefinition[];
+}>;
+export {};
+//# sourceMappingURL=load-schema-file.d.ts.map

package/dist/schema/load-schema-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-schema-file.d.ts","sourceRoot":"","sources":["../../src/schema/load-schema-file.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAOhF,KAAK,mBAAmB,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,EAAE,CAAC;AAEvD,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAG5E;AAgED,wBAAsB,cAAc,CAClC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,WAAW,EAAE,oBAAoB,EAAE,CAAC;IAAC,OAAO,EAAE,gBAAgB,EAAE,CAAA;CAAE,CAAC,CAwB/E"}