@unbrained/pm-cli 2026.6.13 → 2026.6.17

package/dist/cli/commands/schema.d.ts

@@ -1,8 +1,11 @@
 import { buildInvalidTypeHint, type ItemTypeDefinition } from "../../core/schema/item-types-file.js";
 import { type RuntimeStatusDefinition } from "../../core/schema/status-defs-file.js";
+import { type RuntimeFieldDefinition } from "../../core/schema/fields-file.js";
+import { type TypePresetName } from "../../core/schema/type-presets.js";
+import { type InferredTypeCandidate } from "../../core/schema/type-inference.js";
 import { type ResolvedItemTypeDefinition } from "../../core/item/type-registry.js";
 import type { GlobalOptions } from "../../core/shared/command-types.js";
-export declare const SCHEMA_SUBCOMMANDS: readonly ["add-type", "remove-type", "add-status", "remove-status", "list", "show", "show-status"];
+export declare const SCHEMA_SUBCOMMANDS: readonly ["add-type", "remove-type", "add-status", "remove-status", "add-field", "remove-field", "list-fields", "show-field", "apply-preset", "list", "show", "show-status"];
 export type SchemaSubcommand = (typeof SCHEMA_SUBCOMMANDS)[number];
 export interface SchemaAddTypeCommandOptions {
     description?: string;
@@ -74,6 +77,117 @@ export interface SchemaRemoveStatusResult {
     warnings: string[];
     generated_at: string;
 }
+export interface SchemaAddFieldCommandOptions {
+    type?: string;
+    commands?: string[];
+    description?: string;
+    cliFlag?: string;
+    alias?: string[];
+    required?: boolean;
+    requiredOnCreate?: boolean;
+    allowUnset?: boolean;
+    requiredTypes?: string[];
+    author?: string;
+    force?: boolean;
+}
+export interface SchemaRemoveFieldCommandOptions {
+    author?: string;
+    force?: boolean;
+}
+export interface SchemaApplyPresetCommandOptions {
+    author?: string;
+    force?: boolean;
+}
+export interface SchemaAddTypeInferCommandOptions {
+    minCount?: number;
+    apply?: boolean;
+    author?: string;
+    force?: boolean;
+}
+export interface SchemaFieldSummary {
+    key: string;
+    type: string;
+    commands: string[];
+    cli_flag: string;
+    cli_aliases: string[];
+    description?: string;
+    required: boolean;
+    required_on_create: boolean;
+    allow_unset: boolean;
+    required_types: string[];
+}
+export interface SchemaAddFieldResult {
+    action: "add-field";
+    registered: boolean;
+    replaced: boolean;
+    field: RuntimeFieldDefinition;
+    file: {
+        path: string;
+        fields: number;
+    };
+    warnings: string[];
+    generated_at: string;
+}
+export interface SchemaRemoveFieldResult {
+    action: "remove-field";
+    removed: boolean;
+    field?: RuntimeFieldDefinition;
+    file: {
+        path: string;
+        fields: number;
+    };
+    warnings: string[];
+    generated_at: string;
+}
+export interface SchemaListFieldsResult {
+    action: "list-fields";
+    fields: SchemaFieldSummary[];
+    counts: {
+        total: number;
+    };
+    file: {
+        path: string;
+    };
+    generated_at: string;
+}
+export interface SchemaShowFieldResult {
+    action: "show-field";
+    field: SchemaFieldSummary;
+    file: {
+        path: string;
+    };
+    generated_at: string;
+}
+export interface SchemaApplyPresetResult {
+    action: "apply-preset";
+    preset: TypePresetName;
+    registered: string[];
+    replaced: string[];
+    file: {
+        path: string;
+        definitions: number;
+    };
+    warnings: string[];
+    generated_at: string;
+}
+export interface SchemaAddTypeInferResult {
+    action: "infer-types";
+    applied: boolean;
+    min_count: number;
+    candidates: InferredTypeCandidate[];
+    registered: string[];
+    replaced: string[];
+    skipped: Array<{
+        name: string;
+        reason: string;
+    }>;
+    file: {
+        path: string;
+        definitions: number;
+    };
+    warnings: string[];
+    generated_at: string;
+}
 export interface SchemaTypeSummary {
     name: string;
     folder: string;
@@ -120,6 +234,12 @@ export interface SchemaListResult {
             total: number;
         };
     };
+    fields: {
+        custom: SchemaFieldSummary[];
+        counts: {
+            total: number;
+        };
+    };
     file: {
         path: string;
     };
@@ -141,14 +261,34 @@ export interface SchemaShowStatusResult {
     };
     generated_at: string;
 }
-export type SchemaInspectResult = SchemaListResult | SchemaShowResult | SchemaShowStatusResult;
+export type SchemaInspectResult = SchemaListResult | SchemaShowResult | SchemaShowStatusResult | SchemaListFieldsResult | SchemaShowFieldResult;
+declare function toAuthor(candidate: string | undefined, defaultAuthor: string): string;
 export declare function runSchemaAddType(name: string | undefined, options: SchemaAddTypeCommandOptions, global: GlobalOptions): Promise<SchemaAddTypeResult>;
+/**
+ * Returns the workflow role-slot names (open_status, close_status, ...) that
+ * currently point at `statusId` (normalized). Used to warn before removing a
+ * status that a workflow default still references.
+ */
+declare function workflowSlotsReferencing(workflow: {
+    draft_status?: string;
+    open_status?: string;
+    in_progress_status?: string;
+    blocked_status?: string;
+    close_status?: string;
+    canceled_status?: string;
+}, statusId: string): string[];
 export declare function runSchemaRemoveType(name: string | undefined, options: SchemaRemoveTypeCommandOptions, global: GlobalOptions): Promise<SchemaRemoveTypeResult>;
 export declare function runSchemaAddStatus(id: string | undefined, options: SchemaAddStatusCommandOptions, global: GlobalOptions): Promise<SchemaAddStatusResult>;
 export declare function runSchemaRemoveStatus(id: string | undefined, options: SchemaRemoveStatusCommandOptions, global: GlobalOptions): Promise<SchemaRemoveStatusResult>;
 export declare function runSchemaList(global: GlobalOptions): Promise<SchemaListResult>;
 export declare function runSchemaShow(name: string | undefined, global: GlobalOptions): Promise<SchemaShowResult>;
 export declare function runSchemaShowStatus(id: string | undefined, global: GlobalOptions): Promise<SchemaShowStatusResult>;
+export declare function runSchemaAddField(key: string | undefined, options: SchemaAddFieldCommandOptions, global: GlobalOptions): Promise<SchemaAddFieldResult>;
+export declare function runSchemaRemoveField(key: string | undefined, options: SchemaRemoveFieldCommandOptions, global: GlobalOptions): Promise<SchemaRemoveFieldResult>;
+export declare function runSchemaListFields(global: GlobalOptions): Promise<SchemaListFieldsResult>;
+export declare function runSchemaShowField(key: string | undefined, global: GlobalOptions): Promise<SchemaShowFieldResult>;
+export declare function runSchemaApplyPreset(preset: string | undefined, options: SchemaApplyPresetCommandOptions, global: GlobalOptions): Promise<SchemaApplyPresetResult>;
+export declare function runSchemaInferTypes(options: SchemaAddTypeInferCommandOptions, global: GlobalOptions): Promise<SchemaAddTypeInferResult>;
 export declare function formatSchemaAddTypeHuman(result: SchemaAddTypeResult): string;
 export declare function formatSchemaRemoveTypeHuman(result: SchemaRemoveTypeResult): string;
 export declare function formatSchemaAddStatusHuman(result: SchemaAddStatusResult): string;
@@ -156,8 +296,18 @@ export declare function formatSchemaRemoveStatusHuman(result: SchemaRemoveStatus
 export declare function formatSchemaListHuman(result: SchemaListResult): string;
 export declare function formatSchemaShowHuman(result: SchemaShowResult): string;
 export declare function formatSchemaShowStatusHuman(result: SchemaShowStatusResult): string;
+export declare function formatSchemaAddFieldHuman(result: SchemaAddFieldResult): string;
+export declare function formatSchemaRemoveFieldHuman(result: SchemaRemoveFieldResult): string;
+export declare function formatSchemaListFieldsHuman(result: SchemaListFieldsResult): string;
+export declare function formatSchemaShowFieldHuman(result: SchemaShowFieldResult): string;
+export declare function formatSchemaApplyPresetHuman(result: SchemaApplyPresetResult): string;
+export declare function formatSchemaInferTypesHuman(result: SchemaAddTypeInferResult): string;
 /**
  * Re-export so register-mutation can surface the hint in usage examples
  * without importing the core module directly.
  */
 export { buildInvalidTypeHint };
+export declare const _testOnlySchemaCommand: {
+    toAuthor: typeof toAuthor;
+    workflowSlotsReferencing: typeof workflowSlotsReferencing;
+};