@nyrra/prismantix-cli 0.0.3-next.3 → 0.0.3-next.31

package/README.md

@@ -10,14 +10,16 @@ prismantix ontology list
 prismantix object list healthcare
 prismantix object details deviations
 prismantix records pull --client NVO
-prismantix records generate --client NVO --ontology pharma
+prismantix records generate --client NVO --ontology operations
+prismantix records generate --client BSX --ontology medtech \
+  --object device-installations --object service-events --count 10
 prismantix records status <operation-id>
 prismantix records cancel <operation-id>
 ```
 
 Every command supports `--json`. JSON mode reserves stdout for one result; progress and diagnostics go to stderr. `--api-base` overrides `PRISMANTIX_API_BASE`, whose default is `https://api.prismantix.com`.
 
-`records generate` waits for completion by default with a 30-minute timeout. Use `--no-wait`, `--timeout`, and `--poll-interval` for operational control. A completed operation exits 0. A failed operation or an operation canceled while this command is waiting exits 1 with a typed error; an explicitly acknowledged `records cancel` request exits 0.
+`records generate` waits for completion by default with a 30-minute timeout. With no `--object` flags it preserves the complete-ontology defaults. For a targeted run, repeat `--object` with catalog object slugs and provide `--count` (1-100 records per selected object); prerequisites are resolved automatically and existing prerequisite records are reused. Use `--no-wait`, `--timeout`, and `--poll-interval` for operational control. Terminal output includes requested, persisted, rejected, and failed counts per object. A completed operation exits 0. A failed operation or an operation canceled while this command is waiting exits 1 with a typed error; an explicitly acknowledged `records cancel` request exits 0.
 
 `records pull` creates and waits for a CSV-bundle export, then writes `manifest.json` and its files under `./prismantix-exports/<canonical-client-id>/<export-id>/`. Use `--output`, repeatable `--table`, `--timeout`, and `--poll-interval` when needed.
 
@@ -29,6 +31,11 @@ Foundry import is intentionally not bundled with the anonymous public CLI. Autho
 npm login --scope=@shpitdev --registry=https://registry.npmjs.org
 prismantix plugins install @shpitdev/prismantix-ontology-interop
 prismantix foundry import --help
+prismantix foundry dbml --help
 ```
 
+`foundry import` writes three files into the output directory: `ontology.mts` (one self-contained `@osdk/maker` module), `diagnostics.json`, and `diagnostics.md`. Conversion is lossy, so read the diagnostics before treating `ontology.mts` as hand-authored OAC.
+
+`foundry dbml` reads the same Foundry export and writes exactly one standard `ontology.dbml` file that dbdiagram.io imports directly, for reviewing an export as an entity-relationship diagram.
+
 CI must use an npm token scoped to read restricted `@shpitdev` packages. Never commit a populated user `.npmrc`.

package/dist/api.d.ts

@@ -147,12 +147,14 @@ declare const RecordGenerationStatusSchema: Schema.Struct<{
         readonly issues: Schema.$Array<Schema.String>;
         readonly objectSlug: Schema.String;
         readonly persistedCount: Schema.Number;
+        readonly rejectedCount: Schema.Number;
         readonly requestedCount: Schema.Number;
         readonly state: Schema.Literals<readonly ["queued", "running", "completed", "failed", "canceled"]>;
     }>>;
     readonly totals: Schema.Struct<{
         readonly objectCount: Schema.Number;
         readonly persistedCount: Schema.Number;
+        readonly rejectedCount: Schema.Number;
         readonly requestedCount: Schema.Number;
     }>;
 }>;
@@ -183,7 +185,10 @@ type ApiClientError = ApiConfigurationError | ApiDecodeError | ApiHttpError | Ap
 interface PrismantixApiClientService {
     readonly cancelRecordGeneration: (operationId: string) => Effect.Effect<RecordGenerationStatus, ApiClientError>;
     readonly createExport: (clientId: string) => Effect.Effect<ExportCreated, ApiClientError>;
-    readonly createRecordGeneration: (clientId: string, ontologyId: string, idempotencyKey: string) => Effect.Effect<RecordGenerationCreated, ApiClientError>;
+    readonly createRecordGeneration: (clientId: string, ontologyId: string, idempotencyKey: string, objects?: readonly {
+        readonly count: number;
+        readonly objectSlug: string;
+    }[]) => Effect.Effect<RecordGenerationCreated, ApiClientError>;
     readonly getExportStatus: (exportId: string) => Effect.Effect<ExportStatus, ApiClientError>;
     readonly getFile: (exportId: string, tableName: string) => Effect.Effect<Response, ApiClientError>;
     readonly getManifest: (exportId: string) => Effect.Effect<ExportManifest, ApiClientError>;

package/dist/api.d.ts.map

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

package/dist/api.js

@@ -113,12 +113,14 @@ const RecordGenerationStatusSchema = Schema.Struct({
         issues: Schema.Array(Schema.String),
         objectSlug: Schema.String,
         persistedCount: Schema.Number,
+        rejectedCount: Schema.Number,
         requestedCount: Schema.Number,
         state: GenerationStateSchema,
     })),
     totals: Schema.Struct({
         objectCount: Schema.Number,
         persistedCount: Schema.Number,
+        rejectedCount: Schema.Number,
         requestedCount: Schema.Number,
     }),
 });
@@ -138,10 +140,10 @@ export class ApiDecodeError extends Schema.TaggedError()("ApiDecodeError", {
 export class PrismantixApiClient extends Context.Service()("@prismantix/cli/PrismantixApiClient") {
 }
 const apiConfig = (apiKeyOverride) => Config.all({
-    apiBaseUrl: Config.withDefault(Config.nonEmptyString("PRISMANTIX_API_BASE"), DEFAULT_API_BASE_URL),
+    apiBaseUrl: Config.withDefault(Config.NonEmptyString("PRISMANTIX_API_BASE"), DEFAULT_API_BASE_URL),
     apiKey: apiKeyOverride
         ? Config.succeed(Redacted.make(apiKeyOverride))
-        : Config.redacted("PRISMANTIX_API_KEY"),
+        : Config.Redacted("PRISMANTIX_API_KEY"),
 });
 export const makePrismantixApiClientLayer = (options = {}) => Layer.effect(PrismantixApiClient, Effect.gen(function* () {
     const config = yield* apiConfig(options.apiKey).pipe(Effect.mapError(() => new ApiConfigurationError({
@@ -161,8 +163,11 @@ export const makePrismantixApiClientLayer = (options = {}) => Layer.effect(Prism
     return PrismantixApiClient.of({
         cancelRecordGeneration: (operationId) => request("POST", `/v1/record-generations/${encodeURIComponent(operationId)}/cancel`, RecordGenerationStatusSchema, {}, true),
         createExport: (clientId) => request("POST", `/v1/clients/${encodeURIComponent(clientId)}/exports`, ExportCreatedSchema, { body: JSON.stringify({ output: { kind: "csv_bundle" } }) }),
-        createRecordGeneration: (clientId, ontologyId, idempotencyKey) => request("POST", `/v1/clients/${encodeURIComponent(clientId)}/record-generations`, RecordGenerationCreatedSchema, {
-            body: JSON.stringify({ ontologyId }),
+        createRecordGeneration: (clientId, ontologyId, idempotencyKey, objects) => request("POST", `/v1/clients/${encodeURIComponent(clientId)}/record-generations`, RecordGenerationCreatedSchema, {
+            body: JSON.stringify({
+                ...(objects === undefined ? {} : { objects }),
+                ontologyId,
+            }),
             headers: { "Idempotency-Key": idempotencyKey },
         }, true),
         getExportStatus: (exportId) => request("GET", `/v1/exports/${encodeURIComponent(exportId)}`, ExportStatusSchema, {}, true),

package/dist/commands/records/generate.d.ts

@@ -4,6 +4,8 @@ export default class RecordsGenerate extends Command {
     static flags: {
         client: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         ontology: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        object: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        count: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
         "poll-interval": import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
         timeout: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
         wait: import("@oclif/core/interfaces").BooleanFlag<boolean>;

package/dist/commands/records/generate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/commands/records/generate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAa7C,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,OAAO;IACnD,OAAgB,WAAW,SAAuE;IAClG,OAAgB,KAAK;;;;;;;;MAiBnB;IAEW,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA8BjC"}
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/commands/records/generate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAkD7C,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,OAAO;IACnD,OAAgB,WAAW,SACqE;IAChG,OAAgB,KAAK;;;;;;;;;;MAwBnB;IAEW,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA4CjC"}

package/dist/commands/records/generate.js

@@ -4,12 +4,49 @@ import { Effect } from "effect";
 import { apiFlags, failCommand, printResult, requireValue, runApiEffect, validatePositiveInteger, } from "../../command-support.js";
 import { DEFAULT_GENERATION_TIMEOUT_MS, DEFAULT_POLL_INTERVAL_MS } from "../../constants.js";
 import { createRecordGeneration, waitForRecordGeneration } from "../../generation.js";
+import { CliUserError } from "../../errors.js";
+const MAX_RECORDS_PER_OBJECT = 100;
+function requestedObjects(objects, count) {
+    if (!objects?.length) {
+        if (count !== undefined) {
+            throw new CliUserError("invalid_argument", "--count requires at least one --object.");
+        }
+        return undefined;
+    }
+    const requestedCount = requireRequestedObjectCount(count);
+    const normalized = uniqueObjectSlugs(objects);
+    return normalized.map((objectSlug) => ({ count: requestedCount, objectSlug }));
+}
+function requireRequestedObjectCount(count) {
+    if (count === undefined) {
+        throw new CliUserError("invalid_argument", "--count is required when --object is used.");
+    }
+    validatePositiveInteger(count, "--count");
+    if (count > MAX_RECORDS_PER_OBJECT) {
+        throw new CliUserError("invalid_argument", `--count must be ${MAX_RECORDS_PER_OBJECT} or less.`);
+    }
+    return count;
+}
+function uniqueObjectSlugs(objects) {
+    const normalized = objects.map((object) => requireValue(object, "--object").toLowerCase());
+    if (new Set(normalized).size !== normalized.length) {
+        throw new CliUserError("invalid_argument", "--object values must be unique.");
+    }
+    return normalized;
+}
 export default class RecordsGenerate extends Command {
-    static description = "Append a complete ontology-sized default record set for a client.";
+    static description = "Append generated records for selected ontology objects, or the complete ontology by default.";
     static flags = {
         ...apiFlags,
         client: Flags.string({ description: "Client ID.", required: true }),
         ontology: Flags.string({ description: "Registered ontology ID.", required: true }),
+        object: Flags.string({
+            description: "Ontology object slug to generate; repeat for multiple objects.",
+            multiple: true,
+        }),
+        count: Flags.integer({
+            description: "Records per selected object (1-100; requires --object).",
+        }),
         "poll-interval": Flags.integer({
             default: DEFAULT_POLL_INTERVAL_MS,
             description: "Polling interval in milliseconds.",
@@ -31,10 +68,11 @@ export default class RecordsGenerate extends Command {
             validatePositiveInteger(flags.timeout, "--timeout");
             const clientId = requireValue(flags.client, "--client");
             const ontologyId = requireValue(flags.ontology, "--ontology");
+            const objects = requestedObjects(flags.object, flags.count);
             const idempotencyKey = randomUUID();
             const printOperationId = (operationId) => this.logToStderr(operationId);
             const result = await runApiEffect(Effect.gen(function* () {
-                const created = yield* createRecordGeneration(clientId, ontologyId, idempotencyKey);
+                const created = yield* createRecordGeneration(clientId, ontologyId, idempotencyKey, objects);
                 yield* Effect.sync(() => printOperationId(created.operationId));
                 if (!flags.wait)
                     return created;
@@ -47,6 +85,13 @@ export default class RecordsGenerate extends Command {
                 this.log(`Record generation ${result.operationId}: ${result.status}`);
                 this.log(`Client: ${result.clientId}`);
                 this.log(`Ontology: ${result.ontologyId}`);
+                if ("steps" in result) {
+                    for (const step of result.steps) {
+                        this.log(`${step.objectSlug}: ${step.state}; persisted ${step.persistedCount}/${step.requestedCount}; rejected ${step.rejectedCount}`);
+                        for (const issue of step.issues)
+                            this.log(`  ${issue}`);
+                    }
+                }
             });
         }
         catch (error) {

package/dist/commands/records/status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/commands/records/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,OAAO,EAAE,MAAM,aAAa,CAAC;AAU5C,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,OAAO;IACjD,OAAgB,IAAI;;MAAoD;IACxE,OAAgB,WAAW,SAAyC;IACpE,OAAgB,KAAK;;;MAAY;IAEpB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAajC"}
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/commands/records/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,OAAO,EAAE,MAAM,aAAa,CAAC;AAU5C,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,OAAO;IACjD,OAAgB,IAAI;;MAAoD;IACxE,OAAgB,WAAW,SAAyC;IACpE,OAAgB,KAAK;;;MAAY;IAEpB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAmBjC"}

package/dist/commands/records/status.js

@@ -13,6 +13,11 @@ export default class RecordsStatus extends Command {
             printResult(this, result, flags.json, () => {
                 this.log(`Record generation ${result.operationId}: ${result.status}`);
                 this.log(`Persisted: ${result.totals.persistedCount}/${result.totals.requestedCount}`);
+                for (const step of result.steps) {
+                    this.log(`${step.objectSlug}: ${step.state}; persisted ${step.persistedCount}/${step.requestedCount}; rejected ${step.rejectedCount}`);
+                    for (const issue of step.issues)
+                        this.log(`  ${issue}`);
+                }
             });
         }
         catch (error) {

package/dist/generation.d.ts

@@ -6,7 +6,10 @@ export interface WaitForGenerationOptions {
     readonly sleep?: (milliseconds: number) => Promise<void>;
     readonly timeoutMs: number;
 }
-export declare function createRecordGeneration(clientId: string, ontologyId: string, idempotencyKey: string): Effect.Effect<RecordGenerationCreated, import("./api.js").ApiConfigurationError | import("./api.js").ApiHttpError | import("./api.js").ApiTransportError | import("./api.js").ApiDecodeError, PrismantixApiClient>;
+export declare function createRecordGeneration(clientId: string, ontologyId: string, idempotencyKey: string, objects?: readonly {
+    readonly count: number;
+    readonly objectSlug: string;
+}[]): Effect.Effect<RecordGenerationCreated, import("./api.js").ApiConfigurationError | import("./api.js").ApiHttpError | import("./api.js").ApiTransportError | import("./api.js").ApiDecodeError, PrismantixApiClient>;
 export declare function getRecordGeneration(operationId: string): Effect.Effect<RecordGenerationStatus, import("./api.js").ApiConfigurationError | import("./api.js").ApiHttpError | import("./api.js").ApiTransportError | import("./api.js").ApiDecodeError, PrismantixApiClient>;
 export declare function cancelRecordGeneration(operationId: string): Effect.Effect<RecordGenerationStatus, import("./api.js").ApiConfigurationError | import("./api.js").ApiHttpError | import("./api.js").ApiTransportError | import("./api.js").ApiDecodeError, PrismantixApiClient>;
 export declare function waitForRecordGeneration(created: RecordGenerationCreated, options: WaitForGenerationOptions): Effect.Effect<RecordGenerationStatus, unknown, PrismantixApiClient>;

package/dist/generation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generation.d.ts","sourceRoot":"","sources":["../src/generation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,MAAM,EAAgB,MAAM,QAAQ,CAAC;AACnE,OAAO,EACN,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,mBAAmB,EACnB,MAAM,UAAU,CAAC;AAKlB,MAAM,WAAW,wBAAwB;IACxC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,sBAAsB,CACrC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,sNAMtB;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,qNAKtD;AAED,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,qNAKzD;AAED,wBAAgB,uBAAuB,CACtC,OAAO,EAAE,uBAAuB,EAChC,OAAO,EAAE,wBAAwB,uEASjC"}
+{"version":3,"file":"generation.d.ts","sourceRoot":"","sources":["../src/generation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,MAAM,EAAgB,MAAM,QAAQ,CAAC;AACnE,OAAO,EACN,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,mBAAmB,EACnB,MAAM,UAAU,CAAC;AAKlB,MAAM,WAAW,wBAAwB;IACxC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,sBAAsB,CACrC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,SAAS;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,EAAE,sNAM5E;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,qNAKtD;AAED,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,qNAKzD;AAED,wBAAgB,uBAAuB,CACtC,OAAO,EAAE,uBAAuB,EAChC,OAAO,EAAE,wBAAwB,uEASjC"}

package/dist/generation.js

@@ -1,10 +1,10 @@
 import { Cause, Effect, Exit, Option } from "effect";
 import { PrismantixApiClient, } from "./api.js";
 import { CliUserError } from "./errors.js";
-export function createRecordGeneration(clientId, ontologyId, idempotencyKey) {
+export function createRecordGeneration(clientId, ontologyId, idempotencyKey, objects) {
     return Effect.gen(function* () {
         const api = yield* PrismantixApiClient;
-        return yield* api.createRecordGeneration(clientId, ontologyId, idempotencyKey);
+        return yield* api.createRecordGeneration(clientId, ontologyId, idempotencyKey, objects);
     });
 }
 export function getRecordGeneration(operationId) {
@@ -56,10 +56,23 @@ function requireCompletedGeneration(status) {
     if (status.status === "canceled") {
         throw new CliUserError("record_generation_canceled", `Record generation ${status.operationId} was canceled.`);
     }
+    throw new CliUserError("record_generation_failed", failedGenerationMessage(status));
+}
+function failedGenerationStepDetails(status) {
+    return status.steps
+        .filter((step) => step.state === "failed" || step.persistedCount !== step.requestedCount)
+        .map((step) => {
+        const issues = step.issues.length > 0 ? `; ${step.issues.join("; ")}` : "";
+        return `${step.objectSlug} persisted ${step.persistedCount}/${step.requestedCount}, rejected ${step.rejectedCount}${issues}`;
+    });
+}
+function failedGenerationMessage(status) {
     const failureDetails = status.failure
         ? `${status.failure.message} (${status.failure.code})`
         : "The API did not provide failure details.";
-    throw new CliUserError("record_generation_failed", `Record generation ${status.operationId} failed: ${failureDetails}`);
+    const stepDetails = failedGenerationStepDetails(status);
+    const failedObjects = stepDetails.length > 0 ? ` Failed objects: ${stepDetails.join(" | ")}.` : "";
+    return `Record generation ${status.operationId} failed: ${failureDetails}${failedObjects}`;
 }
 function throwIfTimedOut(operationId, elapsedMs, timeoutMs) {
     if (elapsedMs < timeoutMs)

package/oclif.manifest.json

@@ -82,6 +82,42 @@
         "list.js"
       ]
     },
+    "ontology:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List every registered PrismantiX ontology.",
+      "flags": {
+        "api-base": {
+          "description": "PrismantiX API base URL.",
+          "env": "PRISMANTIX_API_BASE",
+          "name": "api-base",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "json": {
+          "description": "Print one machine-readable JSON result to stdout.",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "ontology:list",
+      "pluginAlias": "@nyrra/prismantix-cli",
+      "pluginName": "@nyrra/prismantix-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "ontology",
+        "list.js"
+      ]
+    },
     "records:cancel": {
       "aliases": [],
       "args": {
@@ -126,7 +162,7 @@
     "records:generate": {
       "aliases": [],
       "args": {},
-      "description": "Append a complete ontology-sized default record set for a client.",
+      "description": "Append generated records for selected ontology objects, or the complete ontology by default.",
       "flags": {
         "api-base": {
           "description": "PrismantiX API base URL.",
@@ -158,6 +194,20 @@
           "multiple": false,
           "type": "option"
         },
+        "object": {
+          "description": "Ontology object slug to generate; repeat for multiple objects.",
+          "name": "object",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "count": {
+          "description": "Records per selected object (1-100; requires --object).",
+          "name": "count",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "poll-interval": {
           "description": "Polling interval in milliseconds.",
           "name": "poll-interval",
@@ -311,43 +361,7 @@
         "records",
         "status.js"
       ]
-    },
-    "ontology:list": {
-      "aliases": [],
-      "args": {},
-      "description": "List every registered PrismantiX ontology.",
-      "flags": {
-        "api-base": {
-          "description": "PrismantiX API base URL.",
-          "env": "PRISMANTIX_API_BASE",
-          "name": "api-base",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "json": {
-          "description": "Print one machine-readable JSON result to stdout.",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "ontology:list",
-      "pluginAlias": "@nyrra/prismantix-cli",
-      "pluginName": "@nyrra/prismantix-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "ontology",
-        "list.js"
-      ]
     }
   },
-  "version": "0.0.3-next.3"
+  "version": "0.0.3-next.31"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nyrra/prismantix-cli",
   "description": "PrismantiX API client CLI.",
-  "version": "0.0.3-next.3",
+  "version": "0.0.3-next.31",
   "author": "NYRRA Inc.",
   "bin": {
     "prismantix": "bin/run.js"
@@ -13,7 +13,7 @@
     "@oclif/core": "^4.11.14",
     "@oclif/plugin-help": "^6.2.53",
     "@oclif/plugin-plugins": "5.4.86",
-    "effect": "4.0.0-beta.106"
+    "effect": "4.0.0-rc.116"
   },
   "devDependencies": {
     "@oclif/test": "^4.1.20",