@constructive-sdk/cli 0.12.7 → 0.12.8

package/esm/public/orm/input-types.d.ts

@@ -1792,25 +1792,6 @@ export interface OrgLimitDefault {
     /** Default maximum usage allowed for this limit */
     max?: number | null;
 }
-/** Registry of high-level semantic AST node types using domain-prefixed naming. These IR nodes compile to multiple targets (Postgres RLS, egress, ingress, etc.). */
-export interface NodeTypeRegistry {
-    /** PascalCase domain-prefixed node type name (e.g., AuthzDirectOwner, DataTimestamps, DataImmutableFields) */
-    name?: string | null;
-    /** snake_case slug for use in code and configuration (e.g., authz_direct_owner, data_timestamps) */
-    slug?: string | null;
-    /** Node type category: authz (authorization semantics), data (table-level behaviors), view (view query types), relation (relational structure between tables) */
-    category?: string | null;
-    /** Human-readable display name for UI */
-    displayName?: string | null;
-    /** Description of what this node type does */
-    description?: string | null;
-    /** JSON Schema defining valid parameters for this node type */
-    parameterSchema?: Record<string, unknown> | null;
-    /** Tags for categorization and filtering (e.g., ownership, membership, temporal, rls) */
-    tags?: string[] | null;
-    createdAt?: string | null;
-    updatedAt?: string | null;
-}
 /** Defines the different scopes of membership (e.g. App Member, Organization Member, Group Member) */
 export interface MembershipType {
     /** Integer identifier for the membership type (1=App, 2=Organization, 3=Group) */
@@ -1866,6 +1847,29 @@ export interface RlsModule {
     currentRole?: string | null;
     currentRoleId?: string | null;
 }
+/** Registry of high-level semantic AST node types using domain-prefixed naming. These IR nodes compile to multiple targets (Postgres RLS, egress, ingress, etc.). */
+export interface NodeTypeRegistry {
+    /** PascalCase domain-prefixed node type name (e.g., AuthzDirectOwner, DataTimestamps, DataImmutableFields) */
+    name?: string | null;
+    /** snake_case slug for use in code and configuration (e.g., authz_direct_owner, data_timestamps) */
+    slug?: string | null;
+    /** Node type category: authz (authorization semantics), data (table-level behaviors), view (view query types), relation (relational structure between tables) */
+    category?: string | null;
+    /** Human-readable display name for UI */
+    displayName?: string | null;
+    /** Description of what this node type does */
+    description?: string | null;
+    /** Casual, approachable marketing description for onboarding UIs. Explains what the node type does and when you would use it in plain language. */
+    summary?: string | null;
+    /** JSON Schema defining valid parameters for this node type */
+    parameterSchema?: Record<string, unknown> | null;
+    /** Machine-readable usage guidance: privilege recommendations, combination patterns, warnings, anti-patterns. All fields optional. Keys: recommended_privileges, privilege_note, standalone_ok, suggested_companions, combination_note, typical_pattern, status, status_note, alternatives, warnings, anti_patterns, performance_note, requires, decision_semantics, related_nodes, examples */
+    guidance?: Record<string, unknown> | null;
+    /** Tags for categorization and filtering (e.g., ownership, membership, temporal, rls) */
+    tags?: string[] | null;
+    createdAt?: string | null;
+    updatedAt?: string | null;
+}
 /** Default membership settings per entity, controlling initial approval and verification state for new members */
 export interface OrgMembershipDefault {
     id: string;
@@ -2522,8 +2526,6 @@ export interface AppLimitDefaultRelations {
 }
 export interface OrgLimitDefaultRelations {
 }
-export interface NodeTypeRegistryRelations {
-}
 export interface MembershipTypeRelations {
 }
 export interface CommitRelations {
@@ -2538,6 +2540,8 @@ export interface RlsModuleRelations {
     sessionsTable?: Table | null;
     usersTable?: Table | null;
 }
+export interface NodeTypeRegistryRelations {
+}
 export interface OrgMembershipDefaultRelations {
     entity?: User | null;
 }
@@ -2707,11 +2711,11 @@ export type RoleTypeWithRelations = RoleType & RoleTypeRelations;
 export type MigrateFileWithRelations = MigrateFile & MigrateFileRelations;
 export type AppLimitDefaultWithRelations = AppLimitDefault & AppLimitDefaultRelations;
 export type OrgLimitDefaultWithRelations = OrgLimitDefault & OrgLimitDefaultRelations;
-export type NodeTypeRegistryWithRelations = NodeTypeRegistry & NodeTypeRegistryRelations;
 export type MembershipTypeWithRelations = MembershipType & MembershipTypeRelations;
 export type CommitWithRelations = Commit & CommitRelations;
 export type AppMembershipDefaultWithRelations = AppMembershipDefault & AppMembershipDefaultRelations;
 export type RlsModuleWithRelations = RlsModule & RlsModuleRelations;
+export type NodeTypeRegistryWithRelations = NodeTypeRegistry & NodeTypeRegistryRelations;
 export type OrgMembershipDefaultWithRelations = OrgMembershipDefault & OrgMembershipDefaultRelations;
 export type SqlActionWithRelations = SqlAction & SqlActionRelations;
 export type UserWithRelations = User & UserRelations;
@@ -5143,17 +5147,6 @@ export type OrgLimitDefaultSelect = {
     name?: boolean;
     max?: boolean;
 };
-export type NodeTypeRegistrySelect = {
-    name?: boolean;
-    slug?: boolean;
-    category?: boolean;
-    displayName?: boolean;
-    description?: boolean;
-    parameterSchema?: boolean;
-    tags?: boolean;
-    createdAt?: boolean;
-    updatedAt?: boolean;
-};
 export type MembershipTypeSelect = {
     id?: boolean;
     name?: boolean;
@@ -5211,6 +5204,19 @@ export type RlsModuleSelect = {
         select: TableSelect;
     };
 };
+export type NodeTypeRegistrySelect = {
+    name?: boolean;
+    slug?: boolean;
+    category?: boolean;
+    displayName?: boolean;
+    description?: boolean;
+    summary?: boolean;
+    parameterSchema?: boolean;
+    guidance?: boolean;
+    tags?: boolean;
+    createdAt?: boolean;
+    updatedAt?: boolean;
+};
 export type OrgMembershipDefaultSelect = {
     id?: boolean;
     createdAt?: boolean;
@@ -9179,32 +9185,6 @@ export interface OrgLimitDefaultFilter {
     /** Negates the expression. */
     not?: OrgLimitDefaultFilter;
 }
-export interface NodeTypeRegistryFilter {
-    /** Filter by the object’s `name` field. */
-    name?: StringFilter;
-    /** Filter by the object’s `slug` field. */
-    slug?: StringFilter;
-    /** Filter by the object’s `category` field. */
-    category?: StringFilter;
-    /** Filter by the object’s `displayName` field. */
-    displayName?: StringFilter;
-    /** Filter by the object’s `description` field. */
-    description?: StringFilter;
-    /** Filter by the object’s `parameterSchema` field. */
-    parameterSchema?: JSONFilter;
-    /** Filter by the object’s `tags` field. */
-    tags?: StringListFilter;
-    /** Filter by the object’s `createdAt` field. */
-    createdAt?: DatetimeFilter;
-    /** Filter by the object’s `updatedAt` field. */
-    updatedAt?: DatetimeFilter;
-    /** Checks for all expressions in this list. */
-    and?: NodeTypeRegistryFilter[];
-    /** Checks for any expressions in this list. */
-    or?: NodeTypeRegistryFilter[];
-    /** Negates the expression. */
-    not?: NodeTypeRegistryFilter;
-}
 export interface MembershipTypeFilter {
     /** Filter by the object’s `id` field. */
     id?: IntFilter;
@@ -9311,6 +9291,36 @@ export interface RlsModuleFilter {
     /** Filter by the object’s `usersTable` relation. */
     usersTable?: TableFilter;
 }
+export interface NodeTypeRegistryFilter {
+    /** Filter by the object’s `name` field. */
+    name?: StringFilter;
+    /** Filter by the object’s `slug` field. */
+    slug?: StringFilter;
+    /** Filter by the object’s `category` field. */
+    category?: StringFilter;
+    /** Filter by the object’s `displayName` field. */
+    displayName?: StringFilter;
+    /** Filter by the object’s `description` field. */
+    description?: StringFilter;
+    /** Filter by the object’s `summary` field. */
+    summary?: StringFilter;
+    /** Filter by the object’s `parameterSchema` field. */
+    parameterSchema?: JSONFilter;
+    /** Filter by the object’s `guidance` field. */
+    guidance?: JSONFilter;
+    /** Filter by the object’s `tags` field. */
+    tags?: StringListFilter;
+    /** Filter by the object’s `createdAt` field. */
+    createdAt?: DatetimeFilter;
+    /** Filter by the object’s `updatedAt` field. */
+    updatedAt?: DatetimeFilter;
+    /** Checks for all expressions in this list. */
+    and?: NodeTypeRegistryFilter[];
+    /** Checks for any expressions in this list. */
+    or?: NodeTypeRegistryFilter[];
+    /** Negates the expression. */
+    not?: NodeTypeRegistryFilter;
+}
 export interface OrgMembershipDefaultFilter {
     /** Filter by the object’s `id` field. */
     id?: UUIDFilter;
@@ -9844,11 +9854,11 @@ export type RoleTypeOrderBy = 'NATURAL' | 'PRIMARY_KEY_ASC' | 'PRIMARY_KEY_DESC'
 export type MigrateFileOrderBy = 'NATURAL' | 'ID_ASC' | 'ID_DESC' | 'DATABASE_ID_ASC' | 'DATABASE_ID_DESC';
 export type AppLimitDefaultOrderBy = 'NATURAL' | 'PRIMARY_KEY_ASC' | 'PRIMARY_KEY_DESC' | 'ID_ASC' | 'ID_DESC' | 'NAME_ASC' | 'NAME_DESC';
 export type OrgLimitDefaultOrderBy = 'NATURAL' | 'PRIMARY_KEY_ASC' | 'PRIMARY_KEY_DESC' | 'ID_ASC' | 'ID_DESC' | 'NAME_ASC' | 'NAME_DESC';
-export type NodeTypeRegistryOrderBy = 'NATURAL' | 'PRIMARY_KEY_ASC' | 'PRIMARY_KEY_DESC' | 'NAME_ASC' | 'NAME_DESC' | 'SLUG_ASC' | 'SLUG_DESC' | 'CATEGORY_ASC' | 'CATEGORY_DESC';
 export type MembershipTypeOrderBy = 'NATURAL' | 'PRIMARY_KEY_ASC' | 'PRIMARY_KEY_DESC' | 'ID_ASC' | 'ID_DESC' | 'NAME_ASC' | 'NAME_DESC';
 export type CommitOrderBy = 'NATURAL' | 'PRIMARY_KEY_ASC' | 'PRIMARY_KEY_DESC' | 'ID_ASC' | 'ID_DESC' | 'DATABASE_ID_ASC' | 'DATABASE_ID_DESC';
 export type AppMembershipDefaultOrderBy = 'NATURAL' | 'PRIMARY_KEY_ASC' | 'PRIMARY_KEY_DESC' | 'ID_ASC' | 'ID_DESC' | 'CREATED_AT_ASC' | 'CREATED_AT_DESC' | 'UPDATED_AT_ASC' | 'UPDATED_AT_DESC' | 'CREATED_BY_ASC' | 'CREATED_BY_DESC' | 'UPDATED_BY_ASC' | 'UPDATED_BY_DESC';
 export type RlsModuleOrderBy = 'NATURAL' | 'PRIMARY_KEY_ASC' | 'PRIMARY_KEY_DESC' | 'ID_ASC' | 'ID_DESC' | 'DATABASE_ID_ASC' | 'DATABASE_ID_DESC';
+export type NodeTypeRegistryOrderBy = 'NATURAL' | 'PRIMARY_KEY_ASC' | 'PRIMARY_KEY_DESC' | 'NAME_ASC' | 'NAME_DESC' | 'SLUG_ASC' | 'SLUG_DESC' | 'CATEGORY_ASC' | 'CATEGORY_DESC';
 export type OrgMembershipDefaultOrderBy = 'NATURAL' | 'PRIMARY_KEY_ASC' | 'PRIMARY_KEY_DESC' | 'ID_ASC' | 'ID_DESC' | 'CREATED_AT_ASC' | 'CREATED_AT_DESC' | 'UPDATED_AT_ASC' | 'UPDATED_AT_DESC' | 'CREATED_BY_ASC' | 'CREATED_BY_DESC' | 'UPDATED_BY_ASC' | 'UPDATED_BY_DESC' | 'ENTITY_ID_ASC' | 'ENTITY_ID_DESC';
 export type SqlActionOrderBy = 'NATURAL' | 'ID_ASC' | 'ID_DESC' | 'NAME_ASC' | 'NAME_DESC' | 'DATABASE_ID_ASC' | 'DATABASE_ID_DESC' | 'DEPLOY_ASC' | 'DEPLOY_DESC' | 'CONTENT_ASC' | 'CONTENT_DESC' | 'REVERT_ASC' | 'REVERT_DESC' | 'VERIFY_ASC' | 'VERIFY_DESC' | 'CREATED_AT_ASC' | 'CREATED_AT_DESC' | 'ACTION_ASC' | 'ACTION_DESC' | 'ACTION_ID_ASC' | 'ACTION_ID_DESC' | 'ACTOR_ID_ASC' | 'ACTOR_ID_DESC';
 export type UserOrderBy = 'NATURAL' | 'PRIMARY_KEY_ASC' | 'PRIMARY_KEY_DESC' | 'ID_ASC' | 'ID_DESC' | 'USERNAME_ASC' | 'USERNAME_DESC' | 'CREATED_AT_ASC' | 'CREATED_AT_DESC' | 'UPDATED_AT_ASC' | 'UPDATED_AT_DESC' | 'SEARCH_TSV_RANK_ASC' | 'SEARCH_TSV_RANK_DESC' | 'DISPLAY_NAME_TRGM_SIMILARITY_ASC' | 'DISPLAY_NAME_TRGM_SIMILARITY_DESC' | 'SEARCH_SCORE_ASC' | 'SEARCH_SCORE_DESC';
@@ -12910,36 +12920,6 @@ export interface DeleteOrgLimitDefaultInput {
     clientMutationId?: string;
     id: string;
 }
-export interface CreateNodeTypeRegistryInput {
-    clientMutationId?: string;
-    nodeTypeRegistry: {
-        name: string;
-        slug: string;
-        category: string;
-        displayName?: string;
-        description?: string;
-        parameterSchema?: Record<string, unknown>;
-        tags?: string[];
-    };
-}
-export interface NodeTypeRegistryPatch {
-    name?: string | null;
-    slug?: string | null;
-    category?: string | null;
-    displayName?: string | null;
-    description?: string | null;
-    parameterSchema?: Record<string, unknown> | null;
-    tags?: string[] | null;
-}
-export interface UpdateNodeTypeRegistryInput {
-    clientMutationId?: string;
-    name: string;
-    nodeTypeRegistryPatch: NodeTypeRegistryPatch;
-}
-export interface DeleteNodeTypeRegistryInput {
-    clientMutationId?: string;
-    name: string;
-}
 export interface CreateMembershipTypeInput {
     clientMutationId?: string;
     membershipType: {
@@ -13054,6 +13034,40 @@ export interface DeleteRlsModuleInput {
     clientMutationId?: string;
     id: string;
 }
+export interface CreateNodeTypeRegistryInput {
+    clientMutationId?: string;
+    nodeTypeRegistry: {
+        name: string;
+        slug: string;
+        category: string;
+        displayName?: string;
+        description?: string;
+        summary?: string;
+        parameterSchema?: Record<string, unknown>;
+        guidance?: Record<string, unknown>;
+        tags?: string[];
+    };
+}
+export interface NodeTypeRegistryPatch {
+    name?: string | null;
+    slug?: string | null;
+    category?: string | null;
+    displayName?: string | null;
+    description?: string | null;
+    summary?: string | null;
+    parameterSchema?: Record<string, unknown> | null;
+    guidance?: Record<string, unknown> | null;
+    tags?: string[] | null;
+}
+export interface UpdateNodeTypeRegistryInput {
+    clientMutationId?: string;
+    name: string;
+    nodeTypeRegistryPatch: NodeTypeRegistryPatch;
+}
+export interface DeleteNodeTypeRegistryInput {
+    clientMutationId?: string;
+    name: string;
+}
 export interface CreateOrgMembershipDefaultInput {
     clientMutationId?: string;
     orgMembershipDefault: {
@@ -23943,51 +23957,6 @@ export type DeleteOrgLimitDefaultPayloadSelect = {
         select: OrgLimitDefaultEdgeSelect;
     };
 };
-export interface CreateNodeTypeRegistryPayload {
-    clientMutationId?: string | null;
-    /** The `NodeTypeRegistry` that was created by this mutation. */
-    nodeTypeRegistry?: NodeTypeRegistry | null;
-    nodeTypeRegistryEdge?: NodeTypeRegistryEdge | null;
-}
-export type CreateNodeTypeRegistryPayloadSelect = {
-    clientMutationId?: boolean;
-    nodeTypeRegistry?: {
-        select: NodeTypeRegistrySelect;
-    };
-    nodeTypeRegistryEdge?: {
-        select: NodeTypeRegistryEdgeSelect;
-    };
-};
-export interface UpdateNodeTypeRegistryPayload {
-    clientMutationId?: string | null;
-    /** The `NodeTypeRegistry` that was updated by this mutation. */
-    nodeTypeRegistry?: NodeTypeRegistry | null;
-    nodeTypeRegistryEdge?: NodeTypeRegistryEdge | null;
-}
-export type UpdateNodeTypeRegistryPayloadSelect = {
-    clientMutationId?: boolean;
-    nodeTypeRegistry?: {
-        select: NodeTypeRegistrySelect;
-    };
-    nodeTypeRegistryEdge?: {
-        select: NodeTypeRegistryEdgeSelect;
-    };
-};
-export interface DeleteNodeTypeRegistryPayload {
-    clientMutationId?: string | null;
-    /** The `NodeTypeRegistry` that was deleted by this mutation. */
-    nodeTypeRegistry?: NodeTypeRegistry | null;
-    nodeTypeRegistryEdge?: NodeTypeRegistryEdge | null;
-}
-export type DeleteNodeTypeRegistryPayloadSelect = {
-    clientMutationId?: boolean;
-    nodeTypeRegistry?: {
-        select: NodeTypeRegistrySelect;
-    };
-    nodeTypeRegistryEdge?: {
-        select: NodeTypeRegistryEdgeSelect;
-    };
-};
 export interface CreateMembershipTypePayload {
     clientMutationId?: string | null;
     /** The `MembershipType` that was created by this mutation. */
@@ -24168,6 +24137,51 @@ export type DeleteRlsModulePayloadSelect = {
         select: RlsModuleEdgeSelect;
     };
 };
+export interface CreateNodeTypeRegistryPayload {
+    clientMutationId?: string | null;
+    /** The `NodeTypeRegistry` that was created by this mutation. */
+    nodeTypeRegistry?: NodeTypeRegistry | null;
+    nodeTypeRegistryEdge?: NodeTypeRegistryEdge | null;
+}
+export type CreateNodeTypeRegistryPayloadSelect = {
+    clientMutationId?: boolean;
+    nodeTypeRegistry?: {
+        select: NodeTypeRegistrySelect;
+    };
+    nodeTypeRegistryEdge?: {
+        select: NodeTypeRegistryEdgeSelect;
+    };
+};
+export interface UpdateNodeTypeRegistryPayload {
+    clientMutationId?: string | null;
+    /** The `NodeTypeRegistry` that was updated by this mutation. */
+    nodeTypeRegistry?: NodeTypeRegistry | null;
+    nodeTypeRegistryEdge?: NodeTypeRegistryEdge | null;
+}
+export type UpdateNodeTypeRegistryPayloadSelect = {
+    clientMutationId?: boolean;
+    nodeTypeRegistry?: {
+        select: NodeTypeRegistrySelect;
+    };
+    nodeTypeRegistryEdge?: {
+        select: NodeTypeRegistryEdgeSelect;
+    };
+};
+export interface DeleteNodeTypeRegistryPayload {
+    clientMutationId?: string | null;
+    /** The `NodeTypeRegistry` that was deleted by this mutation. */
+    nodeTypeRegistry?: NodeTypeRegistry | null;
+    nodeTypeRegistryEdge?: NodeTypeRegistryEdge | null;
+}
+export type DeleteNodeTypeRegistryPayloadSelect = {
+    clientMutationId?: boolean;
+    nodeTypeRegistry?: {
+        select: NodeTypeRegistrySelect;
+    };
+    nodeTypeRegistryEdge?: {
+        select: NodeTypeRegistryEdgeSelect;
+    };
+};
 export interface CreateOrgMembershipDefaultPayload {
     clientMutationId?: string | null;
     /** The `OrgMembershipDefault` that was created by this mutation. */
@@ -25621,18 +25635,6 @@ export type OrgLimitDefaultEdgeSelect = {
         select: OrgLimitDefaultSelect;
     };
 };
-/** A `NodeTypeRegistry` edge in the connection. */
-export interface NodeTypeRegistryEdge {
-    cursor?: string | null;
-    /** The `NodeTypeRegistry` at the end of the edge. */
-    node?: NodeTypeRegistry | null;
-}
-export type NodeTypeRegistryEdgeSelect = {
-    cursor?: boolean;
-    node?: {
-        select: NodeTypeRegistrySelect;
-    };
-};
 /** A `MembershipType` edge in the connection. */
 export interface MembershipTypeEdge {
     cursor?: string | null;
@@ -25681,6 +25683,18 @@ export type RlsModuleEdgeSelect = {
         select: RlsModuleSelect;
     };
 };
+/** A `NodeTypeRegistry` edge in the connection. */
+export interface NodeTypeRegistryEdge {
+    cursor?: string | null;
+    /** The `NodeTypeRegistry` at the end of the edge. */
+    node?: NodeTypeRegistry | null;
+}
+export type NodeTypeRegistryEdgeSelect = {
+    cursor?: boolean;
+    node?: {
+        select: NodeTypeRegistrySelect;
+    };
+};
 /** A `OrgMembershipDefault` edge in the connection. */
 export interface OrgMembershipDefaultEdge {
     cursor?: string | null;

package/esm/public/orm/models/index.d.ts

@@ -99,11 +99,11 @@ export { RoleTypeModel } from './roleType';
 export { MigrateFileModel } from './migrateFile';
 export { AppLimitDefaultModel } from './appLimitDefault';
 export { OrgLimitDefaultModel } from './orgLimitDefault';
-export { NodeTypeRegistryModel } from './nodeTypeRegistry';
 export { MembershipTypeModel } from './membershipType';
 export { CommitModel } from './commit';
 export { AppMembershipDefaultModel } from './appMembershipDefault';
 export { RlsModuleModel } from './rlsModule';
+export { NodeTypeRegistryModel } from './nodeTypeRegistry';
 export { OrgMembershipDefaultModel } from './orgMembershipDefault';
 export { SqlActionModel } from './sqlAction';
 export { UserModel } from './user';

package/esm/public/orm/models/index.js

@@ -99,11 +99,11 @@ export { RoleTypeModel } from './roleType';
 export { MigrateFileModel } from './migrateFile';
 export { AppLimitDefaultModel } from './appLimitDefault';
 export { OrgLimitDefaultModel } from './orgLimitDefault';
-export { NodeTypeRegistryModel } from './nodeTypeRegistry';
 export { MembershipTypeModel } from './membershipType';
 export { CommitModel } from './commit';
 export { AppMembershipDefaultModel } from './appMembershipDefault';
 export { RlsModuleModel } from './rlsModule';
+export { NodeTypeRegistryModel } from './nodeTypeRegistry';
 export { OrgMembershipDefaultModel } from './orgMembershipDefault';
 export { SqlActionModel } from './sqlAction';
 export { UserModel } from './user';

package/objects/cli/commands/commit.js

@@ -19,7 +19,7 @@ const fieldSchema = {
     treeId: 'uuid',
     date: 'string',
 };
-const usage = '\ncommit <command>\n\nCommands:\n  list                  List all commit records\n  get                   Get a commit by ID\n  create                Create a new commit\n  update                Update an existing commit\n  delete                Delete a commit\n\n  --help, -h            Show this help message\n';
+const usage = '\ncommit <command>\n\nCommands:\n  list                  List commit records\n  find-first            Find first matching commit record\n  get                   Get a commit by ID\n  create                Create a new commit\n  update                Update an existing commit\n  delete                Delete a commit\n\nList Options:\n  --limit <n>           Max number of records to return (forward pagination)\n  --last <n>            Number of records from the end (backward pagination)\n  --after <cursor>      Cursor for forward pagination\n  --before <cursor>     Cursor for backward pagination\n  --offset <n>          Number of records to skip\n  --select <fields>     Comma-separated list of fields to return\n  --where.<field>.<op>  Filter (dot-notation, e.g. --where.name.equalTo foo)\n  --condition.<f>.<op>  Condition filter (dot-notation)\n  --orderBy <values>    Comma-separated ordering values (e.g. NAME_ASC,CREATED_AT_DESC)\n\nFind-First Options:\n  --select <fields>     Comma-separated list of fields to return\n  --where.<field>.<op>  Filter (dot-notation, e.g. --where.status.equalTo active)\n  --condition.<f>.<op>  Condition filter (dot-notation)\n\n  --help, -h            Show this help message\n';
 exports.default = async (argv, prompter, _options) => {
     if (argv.help || argv.h) {
         console.log(usage);
@@ -32,7 +32,7 @@ exports.default = async (argv, prompter, _options) => {
                 type: 'autocomplete',
                 name: 'subcommand',
                 message: 'What do you want to do?',
-                options: ['list', 'get', 'create', 'update', 'delete'],
+                options: ['list', 'find-first', 'get', 'create', 'update', 'delete'],
             },
         ]);
         return handleTableSubcommand(answer.subcommand, newArgv, prompter);
@@ -43,6 +43,8 @@ async function handleTableSubcommand(subcommand, argv, prompter) {
     switch (subcommand) {
         case 'list':
             return handleList(argv, prompter);
+        case 'find-first':
+            return handleFindFirst(argv, prompter);
         case 'get':
             return handleGet(argv, prompter);
         case 'create':
@@ -56,24 +58,22 @@ async function handleTableSubcommand(subcommand, argv, prompter) {
             process.exit(1);
     }
 }
-async function handleList(_argv, _prompter) {
+async function handleList(argv, _prompter) {
     try {
+        const defaultSelect = {
+            id: true,
+            message: true,
+            databaseId: true,
+            storeId: true,
+            parentIds: true,
+            authorId: true,
+            committerId: true,
+            treeId: true,
+            date: true,
+        };
+        const findManyArgs = (0, utils_1.parseFindManyArgs)(argv, defaultSelect);
         const client = (0, executor_1.getClient)();
-        const result = await client.commit
-            .findMany({
-            select: {
-                id: true,
-                message: true,
-                databaseId: true,
-                storeId: true,
-                parentIds: true,
-                authorId: true,
-                committerId: true,
-                treeId: true,
-                date: true,
-            },
-        })
-            .execute();
+        const result = await client.commit.findMany(findManyArgs).execute();
         console.log(JSON.stringify(result, null, 2));
     }
     catch (error) {
@@ -84,6 +84,32 @@ async function handleList(_argv, _prompter) {
         process.exit(1);
     }
 }
+async function handleFindFirst(argv, _prompter) {
+    try {
+        const defaultSelect = {
+            id: true,
+            message: true,
+            databaseId: true,
+            storeId: true,
+            parentIds: true,
+            authorId: true,
+            committerId: true,
+            treeId: true,
+            date: true,
+        };
+        const findFirstArgs = (0, utils_1.parseFindFirstArgs)(argv, defaultSelect);
+        const client = (0, executor_1.getClient)();
+        const result = await client.commit.findFirst(findFirstArgs).execute();
+        console.log(JSON.stringify(result, null, 2));
+    }
+    catch (error) {
+        console.error('Failed to find record.');
+        if (error instanceof Error) {
+            console.error(error.message);
+        }
+        process.exit(1);
+    }
+}
 async function handleGet(argv, prompter) {
     try {
         const answers = await prompter.prompt(argv, [

package/objects/cli/commands/get-all-record.js

@@ -12,7 +12,7 @@ const fieldSchema = {
     path: 'string',
     data: 'json',
 };
-const usage = '\nget-all-record <command>\n\nCommands:\n  list                  List all getAllRecord records\n  create                Create a new getAllRecord\n\n  --help, -h            Show this help message\n';
+const usage = '\nget-all-record <command>\n\nCommands:\n  list                  List getAllRecord records\n  find-first            Find first matching getAllRecord record\n  create                Create a new getAllRecord\n\nList Options:\n  --limit <n>           Max number of records to return (forward pagination)\n  --last <n>            Number of records from the end (backward pagination)\n  --after <cursor>      Cursor for forward pagination\n  --before <cursor>     Cursor for backward pagination\n  --offset <n>          Number of records to skip\n  --select <fields>     Comma-separated list of fields to return\n  --where.<field>.<op>  Filter (dot-notation, e.g. --where.name.equalTo foo)\n  --condition.<f>.<op>  Condition filter (dot-notation)\n  --orderBy <values>    Comma-separated ordering values (e.g. NAME_ASC,CREATED_AT_DESC)\n\nFind-First Options:\n  --select <fields>     Comma-separated list of fields to return\n  --where.<field>.<op>  Filter (dot-notation, e.g. --where.status.equalTo active)\n  --condition.<f>.<op>  Condition filter (dot-notation)\n\n  --help, -h            Show this help message\n';
 exports.default = async (argv, prompter, _options) => {
     if (argv.help || argv.h) {
         console.log(usage);
@@ -25,7 +25,7 @@ exports.default = async (argv, prompter, _options) => {
                 type: 'autocomplete',
                 name: 'subcommand',
                 message: 'What do you want to do?',
-                options: ['list', 'create'],
+                options: ['list', 'find-first', 'create'],
             },
         ]);
         return handleTableSubcommand(answer.subcommand, newArgv, prompter);
@@ -36,6 +36,8 @@ async function handleTableSubcommand(subcommand, argv, prompter) {
     switch (subcommand) {
         case 'list':
             return handleList(argv, prompter);
+        case 'find-first':
+            return handleFindFirst(argv, prompter);
         case 'create':
             return handleCreate(argv, prompter);
         default:
@@ -43,17 +45,15 @@ async function handleTableSubcommand(subcommand, argv, prompter) {
             process.exit(1);
     }
 }
-async function handleList(_argv, _prompter) {
+async function handleList(argv, _prompter) {
     try {
+        const defaultSelect = {
+            path: true,
+            data: true,
+        };
+        const findManyArgs = (0, utils_1.parseFindManyArgs)(argv, defaultSelect);
         const client = (0, executor_1.getClient)();
-        const result = await client.getAllRecord
-            .findMany({
-            select: {
-                path: true,
-                data: true,
-            },
-        })
-            .execute();
+        const result = await client.getAllRecord.findMany(findManyArgs).execute();
         console.log(JSON.stringify(result, null, 2));
     }
     catch (error) {
@@ -64,6 +64,25 @@ async function handleList(_argv, _prompter) {
         process.exit(1);
     }
 }
+async function handleFindFirst(argv, _prompter) {
+    try {
+        const defaultSelect = {
+            path: true,
+            data: true,
+        };
+        const findFirstArgs = (0, utils_1.parseFindFirstArgs)(argv, defaultSelect);
+        const client = (0, executor_1.getClient)();
+        const result = await client.getAllRecord.findFirst(findFirstArgs).execute();
+        console.log(JSON.stringify(result, null, 2));
+    }
+    catch (error) {
+        console.error('Failed to find record.');
+        if (error instanceof Error) {
+            console.error(error.message);
+        }
+        process.exit(1);
+    }
+}
 async function handleCreate(argv, prompter) {
     try {
         const rawAnswers = await prompter.prompt(argv, [