@ontologie/cli 0.1.0-preview.1

package/dist/commands/instances.js

@@ -0,0 +1,418 @@
+/**
+ * ontologie instance -- list, get, create, update, delete object instances
+ */
+import { resolveConfig } from '../config.js';
+import { createDfClient } from '../client.js';
+import { buildCliMeta, extractMetaFromHeaders } from '../output/meta.js';
+import { output } from '../output/formatter.js';
+import { withErrorHandler, getGlobalFlags, resolveTypeId } from './shared.js';
+import { validateRunGuards } from './actions.js';
+import { getExitCode } from '../output/errors.js';
+// ---------------------------------------------------------------------------
+// Mutation error enrichment (403 mutableBy, 409 OCC)
+// ---------------------------------------------------------------------------
+export function rethrowMutationError(err) {
+    const status = err?.statusCode ?? err?.status;
+    if (status === 409) {
+        throw Object.assign(new Error('Version conflict. Refetch the instance and retry with the updated version (--version <n>).'), { code: 'CONFLICT_ERROR', statusCode: 409 });
+    }
+    if (status === 403) {
+        const serverMsg = err?.body?.message
+            ?? err?.message ?? '';
+        if (/mutableBy|WRITE_POLICY/i.test(serverMsg)) {
+            throw Object.assign(new Error(`Write policy violation: this instance type restricts mutations. ${serverMsg}`), { code: 'WRITE_POLICY_VIOLATION', statusCode: 403 });
+        }
+    }
+    throw err;
+}
+// ---------------------------------------------------------------------------
+// Command registration
+// ---------------------------------------------------------------------------
+export function registerInstances(program) {
+    const instance = program
+        .command('instance')
+        .description('Object instance operations (Digital Twin)');
+    const getFormat = () => {
+        const f = getGlobalFlags(program);
+        return f.format === 'json' ? 'json' : f.format === 'jsonl' ? 'jsonl' : 'text';
+    };
+    // -------------------------------------------------------------------------
+    // instance list <type>
+    // -------------------------------------------------------------------------
+    instance
+        .command('list <type>')
+        .description('List instances of a given object type')
+        .option('--status <status>', 'Filter by status')
+        .option('--source-type <sourceType>', 'Filter by source type')
+        .option('--search <search>', 'Full-text search filter')
+        .option('--sort-by <field>', 'Sort by field')
+        .option('--sort-order <order>', 'Sort order: asc or desc', 'asc')
+        .option('--select <fields>', 'Comma-separated fields to include')
+        .option('--ids-only', 'Output only IDs (one per line)')
+        .action(async (typeName, opts) => withErrorHandler(async () => {
+        const flags = getGlobalFlags(program);
+        const config = resolveConfig(flags);
+        const client = createDfClient(config);
+        const typeId = await resolveTypeId(client, typeName);
+        const query = {
+            limit: flags.limit || 100,
+            status: opts.status,
+            source_type: opts.sourceType,
+            search: opts.search,
+            sort_by: opts.sortBy,
+            sort_order: opts.sortOrder,
+            select: opts.select,
+        };
+        const response = await client.transport.requestWithHeaders({
+            method: 'GET',
+            path: `/api/v1/object-types/${typeId}/instances`,
+            query,
+        });
+        const items = response.data || [];
+        const pagination = response.metadata?.pagination;
+        const limit = Number(flags.limit) || 100;
+        const page = pagination && pagination.total != null && pagination.total > limit
+            ? { limit, nextCursor: null, hasMore: (pagination.offset ?? 0) + limit < pagination.total }
+            : null;
+        if (opts.idsOnly) {
+            for (const item of items) {
+                process.stdout.write(String(item.id) + '\n');
+            }
+            return;
+        }
+        const headerMeta = extractMetaFromHeaders(response.headers);
+        const meta = buildCliMeta({
+            command: 'instance.list',
+            workspaceId: config.workspaceId,
+            apiUrl: config.apiUrl,
+            ...headerMeta,
+        });
+        output(items, meta, flags, ['id', 'external_id', 'status', 'source_type', 'created_at'], page);
+    }, getFormat)());
+    // -------------------------------------------------------------------------
+    // instance get <id>
+    // -------------------------------------------------------------------------
+    instance
+        .command('get <id>')
+        .description('Get a specific instance by ID')
+        .option('--include <sections>', 'Include related data: links, properties (comma-separated)')
+        .action(async (id, opts) => withErrorHandler(async () => {
+        const flags = getGlobalFlags(program);
+        const config = resolveConfig(flags);
+        const client = createDfClient(config);
+        const query = {};
+        if (opts.include) {
+            query.include = opts.include;
+        }
+        const response = await client.transport.requestWithHeaders({
+            method: 'GET',
+            path: `/api/v1/instances/${id}`,
+            query,
+        });
+        const inst = response.data;
+        if (!inst) {
+            throw Object.assign(new Error(`Instance ${id} not found`), { status: 404 });
+        }
+        // If --include links, fetch graph neighbors and merge
+        const includes = (opts.include || '').split(',').map((s) => s.trim());
+        if (includes.includes('links')) {
+            try {
+                const neighborsResponse = await client.transport.request({
+                    method: 'GET',
+                    path: `/api/v1/graph/neighbors/${id}`,
+                    query: { depth: '1' },
+                });
+                inst.links = neighborsResponse;
+            }
+            catch {
+                // Graph endpoint may not be available — degrade gracefully
+                inst.links = { error: 'Graph neighbors endpoint unavailable' };
+            }
+        }
+        const headerMeta = extractMetaFromHeaders(response.headers);
+        const meta = buildCliMeta({
+            command: 'instance.get',
+            workspaceId: config.workspaceId,
+            apiUrl: config.apiUrl,
+            ...headerMeta,
+        });
+        output(inst, meta, flags);
+    }, getFormat)());
+    // -------------------------------------------------------------------------
+    // instance create <type>
+    // -------------------------------------------------------------------------
+    instance
+        .command('create <type>')
+        .description('Create a new instance of a given object type')
+        .requiredOption('--data <json>', 'Instance data as JSON string')
+        .option('--external-id <externalId>', 'External identifier')
+        .option('--source-type <sourceType>', 'Source type (manual, import, api, connector)')
+        .option('--dry-run', 'Preview the operation without persisting')
+        .option('--apply-plan <planId>', 'Apply a previously validated plan')
+        .option('--plan-hash <hash>', 'Plan hash from dry-run (used with --apply-plan)')
+        .option('--idempotency-key <key>', 'Idempotency key for safe retries')
+        .option('--yes', 'Skip confirmation for direct execution')
+        .action(async (typeName, opts) => withErrorHandler(async () => {
+        const flags = getGlobalFlags(program);
+        const config = resolveConfig(flags);
+        const client = createDfClient(config);
+        const typeId = await resolveTypeId(client, typeName);
+        let data;
+        try {
+            data = JSON.parse(opts.data);
+        }
+        catch {
+            throw Object.assign(new Error('--data must be valid JSON'), { code: 'VALIDATION_ERROR', statusCode: 422 });
+        }
+        // Guards: mutual exclusion, plan safety, confirmation
+        validateRunGuards(opts);
+        const body = {
+            data,
+            externalId: opts.externalId,
+            sourceType: opts.sourceType,
+        };
+        if (opts.dryRun) {
+            // Attempt dry-run endpoint; fall back to local preview if unavailable
+            try {
+                const response = await client.transport.requestWithHeaders({
+                    method: 'POST',
+                    path: `/api/v1/object-types/${typeId}/instances/dry-run`,
+                    body,
+                });
+                const headerMeta = extractMetaFromHeaders(response.headers);
+                const meta = buildCliMeta({
+                    command: 'instance.create.dry-run',
+                    workspaceId: config.workspaceId,
+                    apiUrl: config.apiUrl,
+                    ...headerMeta,
+                });
+                output(response.data, meta, flags);
+            }
+            catch (err) {
+                if (err?.statusCode === 404 || err?.status === 404) {
+                    // Dry-run endpoint not available — simulate locally
+                    const plan = {
+                        action: 'create',
+                        typeId,
+                        typeName,
+                        body,
+                        note: 'Dry-run endpoint not available. This is a local preview of the request payload.',
+                    };
+                    const meta = buildCliMeta({
+                        command: 'instance.create.dry-run',
+                        workspaceId: config.workspaceId,
+                        apiUrl: config.apiUrl,
+                    });
+                    output(plan, meta, flags);
+                }
+                else {
+                    throw err;
+                }
+            }
+            process.exitCode = getExitCode("PRECONDITION_FAILED");
+            return;
+        }
+        // Apply-plan path: merge planId/planHash into body
+        if (opts.applyPlan) {
+            body.planId = opts.applyPlan;
+            if (opts.planHash)
+                body.planHash = opts.planHash;
+        }
+        try {
+            const response = await client.transport.requestWithHeaders({
+                method: 'POST',
+                path: `/api/v1/object-types/${typeId}/instances`,
+                body,
+                idempotencyKey: opts.idempotencyKey,
+            });
+            const headerMeta = extractMetaFromHeaders(response.headers);
+            const meta = buildCliMeta({
+                command: 'instance.create',
+                workspaceId: config.workspaceId,
+                apiUrl: config.apiUrl,
+                ...headerMeta,
+            });
+            output(response.data, meta, flags);
+        }
+        catch (err) {
+            rethrowMutationError(err);
+        }
+    }, getFormat)());
+    // -------------------------------------------------------------------------
+    // instance update <id>
+    // -------------------------------------------------------------------------
+    instance
+        .command('update <id>')
+        .description('Update an existing instance')
+        .requiredOption('--data <json>', 'Updated data as JSON string')
+        .option('--version <n>', 'Expected version for optimistic concurrency control')
+        .option('--dry-run', 'Preview the operation without persisting')
+        .option('--apply-plan <planId>', 'Apply a previously validated plan')
+        .option('--plan-hash <hash>', 'Plan hash from dry-run (used with --apply-plan)')
+        .option('--idempotency-key <key>', 'Idempotency key for safe retries')
+        .option('--yes', 'Skip confirmation for direct execution')
+        .action(async (id, opts) => withErrorHandler(async () => {
+        const flags = getGlobalFlags(program);
+        const config = resolveConfig(flags);
+        const client = createDfClient(config);
+        let data;
+        try {
+            data = JSON.parse(opts.data);
+        }
+        catch {
+            throw Object.assign(new Error('--data must be valid JSON'), { code: 'VALIDATION_ERROR', statusCode: 422 });
+        }
+        // Guards: mutual exclusion, plan safety, confirmation
+        validateRunGuards(opts);
+        const body = {
+            data,
+        };
+        if (opts.version != null) {
+            body.expectedVersion = Number(opts.version);
+        }
+        if (opts.dryRun) {
+            // Attempt dry-run endpoint; fall back to local preview if unavailable
+            try {
+                const response = await client.transport.requestWithHeaders({
+                    method: 'POST',
+                    path: `/api/v1/instances/${id}/dry-run`,
+                    body,
+                });
+                const headerMeta = extractMetaFromHeaders(response.headers);
+                const meta = buildCliMeta({
+                    command: 'instance.update.dry-run',
+                    workspaceId: config.workspaceId,
+                    apiUrl: config.apiUrl,
+                    ...headerMeta,
+                });
+                output(response.data, meta, flags);
+            }
+            catch (err) {
+                if (err?.statusCode === 404 || err?.status === 404) {
+                    // Dry-run endpoint not available — simulate locally
+                    const plan = {
+                        action: 'update',
+                        instanceId: id,
+                        body,
+                        note: 'Dry-run endpoint not available. This is a local preview of the update payload.',
+                    };
+                    const meta = buildCliMeta({
+                        command: 'instance.update.dry-run',
+                        workspaceId: config.workspaceId,
+                        apiUrl: config.apiUrl,
+                    });
+                    output(plan, meta, flags);
+                }
+                else {
+                    throw err;
+                }
+            }
+            process.exitCode = getExitCode("PRECONDITION_FAILED");
+            return;
+        }
+        // Apply-plan path: merge planId/planHash into body
+        if (opts.applyPlan) {
+            body.planId = opts.applyPlan;
+            if (opts.planHash)
+                body.planHash = opts.planHash;
+        }
+        try {
+            const response = await client.transport.requestWithHeaders({
+                method: 'PUT',
+                path: `/api/v1/instances/${id}`,
+                body,
+                idempotencyKey: opts.idempotencyKey,
+            });
+            const headerMeta = extractMetaFromHeaders(response.headers);
+            const meta = buildCliMeta({
+                command: 'instance.update',
+                workspaceId: config.workspaceId,
+                apiUrl: config.apiUrl,
+                ...headerMeta,
+            });
+            output(response.data, meta, flags);
+        }
+        catch (err) {
+            rethrowMutationError(err);
+        }
+    }, getFormat)());
+    // -------------------------------------------------------------------------
+    // instance delete <id>
+    // -------------------------------------------------------------------------
+    instance
+        .command('delete <id>')
+        .description('Delete an instance')
+        .option('--dry-run', 'Preview the operation without persisting')
+        .option('--apply-plan <planId>', 'Apply a previously validated plan')
+        .option('--plan-hash <hash>', 'Plan hash from dry-run (used with --apply-plan)')
+        .option('--idempotency-key <key>', 'Idempotency key for safe retries')
+        .option('--yes', 'Skip confirmation for direct execution')
+        .action(async (id, opts) => withErrorHandler(async () => {
+        const flags = getGlobalFlags(program);
+        const config = resolveConfig(flags);
+        const client = createDfClient(config);
+        // Guards: mutual exclusion, plan safety, confirmation
+        validateRunGuards(opts);
+        if (opts.dryRun) {
+            // Attempt dry-run endpoint; fall back to local preview if unavailable
+            try {
+                const response = await client.transport.requestWithHeaders({
+                    method: 'POST',
+                    path: `/api/v1/instances/${id}/delete/dry-run`,
+                });
+                const headerMeta = extractMetaFromHeaders(response.headers);
+                const meta = buildCliMeta({
+                    command: 'instance.delete.dry-run',
+                    workspaceId: config.workspaceId,
+                    apiUrl: config.apiUrl,
+                    ...headerMeta,
+                });
+                output(response.data, meta, flags);
+            }
+            catch (err) {
+                if (err?.statusCode === 404 || err?.status === 404) {
+                    const plan = {
+                        action: 'delete',
+                        instanceId: id,
+                        note: 'Dry-run endpoint not available. This is a local preview — the instance will be permanently deleted.',
+                    };
+                    const meta = buildCliMeta({
+                        command: 'instance.delete.dry-run',
+                        workspaceId: config.workspaceId,
+                        apiUrl: config.apiUrl,
+                    });
+                    output(plan, meta, flags);
+                }
+                else {
+                    throw err;
+                }
+            }
+            process.exitCode = getExitCode("PRECONDITION_FAILED");
+            return;
+        }
+        // Apply-plan or direct execution path
+        const body = opts.applyPlan
+            ? { planId: opts.applyPlan, ...(opts.planHash ? { planHash: opts.planHash } : {}) }
+            : undefined;
+        try {
+            const response = await client.transport.requestWithHeaders({
+                method: 'DELETE',
+                path: `/api/v1/instances/${id}`,
+                ...(body ? { body } : {}),
+                idempotencyKey: opts.idempotencyKey,
+            });
+            const headerMeta = extractMetaFromHeaders(response.headers);
+            const meta = buildCliMeta({
+                command: 'instance.delete',
+                workspaceId: config.workspaceId,
+                apiUrl: config.apiUrl,
+                ...headerMeta,
+            });
+            output(response.data ?? { ok: true, id }, meta, flags);
+        }
+        catch (err) {
+            rethrowMutationError(err);
+        }
+    }, getFormat)());
+}
+//# sourceMappingURL=instances.js.map

package/dist/commands/instances.js.map

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

package/dist/commands/keys.d.ts

@@ -0,0 +1,6 @@
+/**
+ * ontologie keys -- list, create, revoke API keys
+ */
+import { Command } from 'commander';
+export declare function registerKeys(program: Command): void;
+//# sourceMappingURL=keys.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../src/commands/keys.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwHnD"}

package/dist/commands/keys.js

@@ -0,0 +1,113 @@
+/**
+ * ontologie keys -- list, create, revoke API keys
+ */
+import { resolveConfig } from '../config.js';
+import { createDfClient } from '../client.js';
+import { buildCliMeta, extractMetaFromHeaders } from '../output/meta.js';
+import { output } from '../output/formatter.js';
+import { getExitCode } from '../output/errors.js';
+import { withErrorHandler } from './shared.js';
+export function registerKeys(program) {
+    const keys = program
+        .command('keys')
+        .description('API key operations');
+    keys
+        .command('list')
+        .description('List API keys')
+        .option('--ids-only', 'Output only IDs (one per line)')
+        .action(async (opts) => withErrorHandler(async () => {
+        const flags = program.opts();
+        const config = resolveConfig(flags);
+        const client = createDfClient(config);
+        const response = await client.transport.requestWithHeaders({
+            method: 'GET',
+            path: '/api/api-keys',
+        });
+        const items = response.data || [];
+        if (opts.idsOnly) {
+            for (const item of items) {
+                process.stdout.write(String(item.id) + '\n');
+            }
+            return;
+        }
+        const headerMeta = extractMetaFromHeaders(response.headers);
+        const meta = buildCliMeta({
+            command: 'keys.list',
+            workspaceId: config.workspaceId,
+            apiUrl: config.apiUrl,
+            ...headerMeta,
+        });
+        output(items, meta, flags, ['id', 'name', 'prefix', 'scopes', 'status', 'last_used_at', 'created_at']);
+    })());
+    keys
+        .command('create <name>')
+        .description('Create a new API key')
+        .option('--scopes <scopes>', 'Comma-separated scopes (e.g., schema.read,instances.read,actions.describe)')
+        .option('--expires <duration>', 'Expiration duration (e.g., 30d, 90d, 1y)')
+        .action(async (name, opts) => withErrorHandler(async () => {
+        const flags = program.opts();
+        const config = resolveConfig(flags);
+        const client = createDfClient(config);
+        const body = { name };
+        if (opts.scopes) {
+            body.permissions = opts.scopes.split(',').map((s) => s.trim());
+        }
+        if (opts.expires) {
+            body.expiresIn = opts.expires;
+        }
+        const response = await client.transport.requestWithHeaders({
+            method: 'POST',
+            path: '/api/api-keys',
+            body,
+        });
+        const result = response.data || {};
+        const headerMeta = extractMetaFromHeaders(response.headers);
+        const meta = buildCliMeta({
+            command: 'keys.create',
+            workspaceId: config.workspaceId,
+            apiUrl: config.apiUrl,
+            ...headerMeta,
+        });
+        output(result, meta, flags);
+        // The plaintext key is only returned once -- display it prominently on stderr
+        // so it is visible even when stdout is piped to a file or another tool.
+        if (result.key || result.plaintext || result.apiKey) {
+            const plaintext = String(result.key ?? result.plaintext ?? result.apiKey);
+            process.stderr.write('\n');
+            process.stderr.write('=========================================================\n');
+            process.stderr.write('  IMPORTANT: Save this API key now -- it will NOT be\n');
+            process.stderr.write('  shown again.\n');
+            process.stderr.write('\n');
+            process.stderr.write(`  ${plaintext}\n`);
+            process.stderr.write('=========================================================\n');
+            process.stderr.write('\n');
+        }
+    })());
+    keys
+        .command('revoke <id>')
+        .description('Revoke an API key')
+        .option('--force', 'Skip confirmation and revoke immediately')
+        .action(async (id, opts) => withErrorHandler(async () => {
+        const flags = program.opts();
+        const config = resolveConfig(flags);
+        const client = createDfClient(config);
+        if (!opts.force) {
+            process.stderr.write(`Warning: Revoking API key ${id} is irreversible.\n`);
+            process.stderr.write('Re-run with --force to confirm.\n');
+            process.exit(getExitCode('CONFIRMATION_REQUIRED'));
+        }
+        const response = await client.transport.requestWithHeaders({
+            method: 'DELETE',
+            path: `/api/api-keys/${id}`,
+        });
+        const headerMeta = extractMetaFromHeaders(response.headers);
+        const meta = buildCliMeta({
+            command: 'keys.revoke',
+            workspaceId: config.workspaceId,
+            apiUrl: config.apiUrl,
+            ...headerMeta,
+        });
+        output(response.data ?? { id, status: 'revoked' }, meta, flags);
+    })());
+}
+//# sourceMappingURL=keys.js.map

package/dist/commands/keys.js.map

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

package/dist/commands/knowledge.d.ts

@@ -0,0 +1,6 @@
+/**
+ * ontologie knowledge -- search and retrieve knowledge base documents
+ */
+import { Command } from 'commander';
+export declare function registerKnowledge(program: Command): void;
+//# sourceMappingURL=knowledge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.d.ts","sourceRoot":"","sources":["../../src/commands/knowledge.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA6ExD"}