@unbrained/pm-cli 2026.10.14 → 2026.10.15

package/dist/sdk/corpus-shape.d.ts

@@ -11,132 +11,132 @@ export type BuiltinCorpusShapeName = "scratch" | "representative" | "deep-graph"
 /** One weighted relationship kind in a generated corpus. */
 export interface CorpusShapeEdgeWeight {
 /** Registered pm relationship kind. */
-kind: string;
+kind:string;
 /** Relative deterministic selection weight. */
-weight: number;
+weight:number;
 }
 /** Portable declaration of the population behind a benchmark or evaluation. */
 export interface CorpusShape {
 /** Versioned schema identity. */
-schema: typeof PM_CORPUS_SHAPE_SCHEMA;
+schema:typeof PM_CORPUS_SHAPE_SCHEMA;
 /** Stable shape name used by CLIs and reports. */
-name: string;
+name:string;
 /** Human-readable intent and expected use. */
-description: string;
+description:string;
 /** Maximum generated parent-chain depth. */
-hierarchy_depth: number;
+hierarchy_depth:number;
 /** Target maximum number of children per generated parent. */
-hierarchy_fanout: number;
+hierarchy_fanout:number;
 /** Project time spanned by generated timestamps. */
-age_span_days: number;
+age_span_days:number;
 /** History entries generated for every item. */
-history_entries_per_item: number;
+history_entries_per_item:number;
 /** Evidence comments generated per hundred items. */
-comments_per_100_items: number;
+comments_per_100_items:number;
 /** Private notes generated per hundred items. */
-notes_per_100_items: number;
+notes_per_100_items:number;
 /** Durable learnings generated per hundred items. */
-learnings_per_100_items: number;
+learnings_per_100_items:number;
 /** Weighted typed relationship population. */
-edge_kind_mix: readonly CorpusShapeEdgeWeight[];
+edge_kind_mix:readonly CorpusShapeEdgeWeight[];
 /** Number of distinct mutation authors. */
-author_cardinality: number;
+author_cardinality:number;
 /** Number of disconnected hierarchy/relationship components. */
-component_count: number;
+component_count:number;
 /** Whether deterministic back-edges should exercise cyclic graph handling. */
-include_cycles: boolean;
+include_cycles:boolean;
 /** Custom item types registered before generation. */
-custom_types: readonly string[];
+custom_types:readonly string[];
 /** Custom lifecycle statuses registered before generation. */
-custom_statuses: readonly string[];
+custom_statuses:readonly string[];
 /** Custom statuses that should use terminal lifecycle semantics. */
-terminal_statuses: readonly string[];
+terminal_statuses:readonly string[];
 /** Custom metadata fields registered before generation. */
-custom_fields: readonly string[];
+custom_fields:readonly string[];
 }
 /** Deterministic SDK plan for one generated corpus item. */
 export interface CorpusShapeItemPlan {
 /** Zero-based item position. */
-index: number;
+index:number;
 /** Stable generated item identifier. */
-id: string;
+id:string;
 /** Optional generated parent identifier. */
-parent?: string;
+parent?:string;
 /** Component assigned by the shape. */
-component: number;
+component:number;
 /** Deterministic timestamp across the declared age span. */
-timestamp: string;
+timestamp:string;
 /** Deterministic author identity. */
-author: string;
+author:string;
 /** Number of history entries to materialize. */
-history_entry_count: number;
+history_entry_count:number;
 /** Relationship kinds selected for this item. */
-dependency_kinds: readonly string[];
+dependency_kinds:readonly string[];
 /** Whether the item receives an evidence comment. */
-has_comment: boolean;
+has_comment:boolean;
 /** Whether the item receives a private note. */
-has_note: boolean;
+has_note:boolean;
 /** Whether the item receives a durable learning. */
-has_learning: boolean;
+has_learning:boolean;
 /** Custom type selected for this item, when configured. */
-custom_type?: string;
+custom_type?:string;
 /** Custom status selected for this item, when configured. */
-custom_status?: string;
+custom_status?:string;
 }
 /** Measured population profile attached to generated-corpus evidence. */
 export interface CorpusShapeProfile {
 /** Shape declaration identity. */
-shape: string;
+shape:string;
 /** Generated item count. */
-item_count: number;
+item_count:number;
 /** Observed distinct author count. */
-author_count: number;
+author_count:number;
 /** Observed hierarchy component count. */
-component_count: number;
+component_count:number;
 /** Observed maximum parent-chain depth. */
-hierarchy_depth: number;
+hierarchy_depth:number;
 /** Observed maximum number of children assigned to one parent. */
-hierarchy_fanout: number;
+hierarchy_fanout:number;
 /** Observed minimum and maximum timestamps. */
-timestamp_range: {
-first: string | null;
-last: string | null;
+timestamp_range:{
+first:string | null;
+last:string | null;
 };
 /** Observed total history entries. */
-history_entry_count: number;
+history_entry_count:number;
 /** Observed annotation totals. */
-annotations: {
-comments: number;
-notes: number;
-learnings: number;
+annotations:{
+comments:number;
+notes:number;
+learnings:number;
 };
 /** Observed relationship-kind totals. */
-edge_kinds: Record<string, number>;
+edge_kinds:Record<string,number>;
 /** True when every declared invariant represented by the plan matches. */
-matches_declaration: boolean;
+matches_declaration:boolean;
 /** Actionable mismatches, empty for a conforming plan. */
-mismatches: readonly string[];
+mismatches:readonly string[];
 }
 /** Incremental corpus-profile measurement without retaining item plans. */
 export interface CorpusShapeMeasurement {
 /** Add one generated plan in generation order. */
-add(plan: CorpusShapeItemPlan): void;
+add(plan:CorpusShapeItemPlan):void;
 /** Finish the measurement and return its conformance profile. */
-finish(): CorpusShapeProfile;
+finish():CorpusShapeProfile;
 }
-type ExactCorpusShape<Shape extends CorpusShape> = Shape & Record<Exclude<keyof Shape, keyof CorpusShape>, never>;
+type ExactCorpusShape<Shape extends CorpusShape> = Shape & Record<Exclude<keyof Shape,keyof CorpusShape>,never>;
 /** Validate, detach, and deeply freeze a portable corpus-shape declaration. */
-export declare function defineCorpusShape<const Shape extends CorpusShape>(shape: ExactCorpusShape<Shape>): Readonly<Shape>;
+export declare function defineCorpusShape<const Shape extends CorpusShape>(shape:ExactCorpusShape<Shape>):Readonly<Shape>;
 /** Canonical built-in corpus shapes used by repository and downstream gates. */
-export declare const BUILTIN_CORPUS_SHAPES: Readonly<Record<BuiltinCorpusShapeName, Readonly<CorpusShape>>>;
+export declare const BUILTIN_CORPUS_SHAPES:Readonly<Record<BuiltinCorpusShapeName,Readonly<CorpusShape>>>;
 /** Return all built-in corpus-shape declarations in stable name order. */
-export declare function listBuiltinCorpusShapes(): readonly Readonly<CorpusShape>[];
+export declare function listBuiltinCorpusShapes():readonly Readonly<CorpusShape>[];
 /** Resolve one built-in corpus shape or reject an unknown name. */
-export declare function resolveBuiltinCorpusShape(name: string): Readonly<CorpusShape>;
+export declare function resolveBuiltinCorpusShape(name:string):Readonly<CorpusShape>;
 /** Build one deterministic corpus item plan without filesystem side effects. */
-export declare function buildCorpusShapeItemPlan(shape: Readonly<CorpusShape>, index: number, itemCount: number, seed?: number): CorpusShapeItemPlan;
+export declare function buildCorpusShapeItemPlan(shape:Readonly<CorpusShape>,index:number,itemCount:number,seed?:number):CorpusShapeItemPlan;
 /** Create an incremental measurement for a generated corpus population. */
-export declare function createCorpusShapeMeasurement(shape: Readonly<CorpusShape>): CorpusShapeMeasurement;
+export declare function createCorpusShapeMeasurement(shape:Readonly<CorpusShape>):CorpusShapeMeasurement;
 /** Measure a generated plan and fail closed when declared invariants drift. */
-export declare function measureCorpusShapePlan(shape: Readonly<CorpusShape>, plans: readonly CorpusShapeItemPlan[]): CorpusShapeProfile;
+export declare function measureCorpusShapePlan(shape:Readonly<CorpusShape>,plans:readonly CorpusShapeItemPlan[]):CorpusShapeProfile;
 export {};

package/dist/sdk/define.d.ts

@@ -32,15 +32,15 @@
  * non-generic signature lets TypeScript type the handler parameter from the
  * declared function type.
  */
-import type { AfterCommandHook, BeforeCommandHook, BeforeMutationHook, CommandDefinition, CommandOverride, Exporter, ExtensionManifest, FlagDefinition, Importer, OnIndexHook, OnReadHook, OnWriteHook, ParserOverride, PreflightOverride, ScopedPreflightOverrideDefinition, RendererOverride, ScopedRendererOverrideDefinition, SchemaFieldDefinition, SchemaItemTypeDefinition, SchemaMigrationDefinition, SearchProviderDefinition, ServiceOverride, ServiceOverrideDecision, VectorStoreAdapterDefinition } from "../core/extensions/loader.js";
+import type { AfterCommandHook,BeforeCommandHook,BeforeMutationHook,CommandDefinition,CommandOverride,Exporter,ExtensionManifest,FlagDefinition,Importer,OnIndexHook,OnReadHook,OnWriteHook,ParserOverride,PreflightOverride,ScopedPreflightOverrideDefinition,RendererOverride,ScopedRendererOverrideDefinition,SchemaFieldDefinition,SchemaItemTypeDefinition,SchemaMigrationDefinition,SearchProviderDefinition,ServiceOverride,ServiceOverrideDecision,VectorStoreAdapterDefinition } from "../core/extensions/loader.js";
 import type { ProjectProfileDefinition } from "../core/profile/profile-presets.js";
-type ExactDefinition<TDefinition, TContract> = TDefinition & Record<Exclude<keyof TDefinition, keyof TContract>, never>;
-type FlagAuthoringDefinition = Pick<FlagDefinition, "long" | "short" | "value_name" | "description" | "required" | "enabled" | "visible" | "value_type" | "type" | "list" | "default">;
-type ItemFieldAuthoringDefinition = Pick<SchemaFieldDefinition, "name" | "type" | "optional" | "default" | "values">;
-type ItemTypeAuthoringDefinition = Pick<SchemaItemTypeDefinition, "name" | "folder" | "aliases" | "required_create_fields" | "required_create_repeatables" | "command_option_policies" | "options" | "description" | "default_status" | "execution_role">;
-type MigrationAuthoringDefinition = Pick<SchemaMigrationDefinition, "id" | "description" | "status" | "mandatory" | "run">;
-type SearchProviderAuthoringDefinition = Pick<SearchProviderDefinition, "name" | "query" | "queryExpansion" | "query_expansion" | "rerank" | "embedBatch" | "embed_batch" | "embed">;
-type VectorStoreAdapterAuthoringDefinition = Pick<VectorStoreAdapterDefinition, "name" | "query" | "upsert" | "delete">;
+type ExactDefinition<TDefinition,TContract> = TDefinition & Record<Exclude<keyof TDefinition,keyof TContract>,never>;
+type FlagAuthoringDefinition = Pick<FlagDefinition,"long" | "short" | "value_name" | "description" | "required" | "enabled" | "visible" | "value_type" | "type" | "list" | "default">;
+type ItemFieldAuthoringDefinition = Pick<SchemaFieldDefinition,"name" | "type" | "optional" | "default" | "values">;
+type ItemTypeAuthoringDefinition = Pick<SchemaItemTypeDefinition,"name" | "folder" | "aliases" | "required_create_fields" | "required_create_repeatables" | "command_option_policies" | "options" | "description" | "default_status" | "execution_role">;
+type MigrationAuthoringDefinition = Pick<SchemaMigrationDefinition,"id" | "description" | "status" | "mandatory" | "run">;
+type SearchProviderAuthoringDefinition = Pick<SearchProviderDefinition,"name" | "query" | "queryExpansion" | "query_expansion" | "rerank" | "embedBatch" | "embed_batch" | "embed">;
+type VectorStoreAdapterAuthoringDefinition = Pick<VectorStoreAdapterDefinition,"name" | "query" | "upsert" | "delete">;
 /**
  * Type an extension's in-module manifest mirror (the `manifest` export / field).
  *
@@ -51,7 +51,7 @@ type VectorStoreAdapterAuthoringDefinition = Pick<VectorStoreAdapterDefinition,
  * {@link ./compose.js#deriveExtensionCapabilities | `deriveExtensionCapabilities`}
  * to keep `capabilities` matched to the surfaces the extension actually registers.
  */
-export declare function defineExtensionManifest<TManifest extends ExtensionManifest>(manifest: TManifest): TManifest;
+export declare function defineExtensionManifest<TManifest extends ExtensionManifest>(manifest:TManifest):TManifest;
 /**
  * Type a project-profile definition for the profile registry.
  *
@@ -64,7 +64,7 @@ export declare function defineExtensionManifest<TManifest extends ExtensionManif
  * typed at the definition site, mirroring {@link defineItemType}. It is the
  * authoring anchor a first-party or third-party profile package builds on.
  */
-export declare function defineProjectProfile<TProfile extends ProjectProfileDefinition>(profile: TProfile): TProfile;
+export declare function defineProjectProfile<TProfile extends ProjectProfileDefinition>(profile:TProfile):TProfile;
 /**
  * Type a command definition for `api.registerCommand(definition)`.
  *
@@ -73,7 +73,7 @@ export declare function defineProjectProfile<TProfile extends ProjectProfileDefi
  * types. Pass the result straight to `registerCommand`, or export it so the
  * command can be invoked in tests via `runRegisteredCommandForTest`.
  */
-export declare function defineCommand<TDefinition extends CommandDefinition>(definition: TDefinition): TDefinition;
+export declare function defineCommand<TDefinition extends CommandDefinition>(definition:TDefinition):TDefinition;
 /**
  * Type a single flag definition for a `api.registerFlags(command, flags)` array.
  *
@@ -82,14 +82,14 @@ export declare function defineCommand<TDefinition extends CommandDefinition>(def
  * per-flag contract checking — `value_type`, `list`, and `default` included —
  * instead of validating a loosely-typed literal array all at once.
  */
-export declare function defineFlag<TFlag extends FlagAuthoringDefinition>(flag: ExactDefinition<TFlag, FlagAuthoringDefinition>): TFlag;
+export declare function defineFlag<TFlag extends FlagAuthoringDefinition>(flag:ExactDefinition<TFlag,FlagAuthoringDefinition>):TFlag;
 /**
  * Type a custom item-type definition for `api.registerItemTypes([...])`.
  *
  * Preserves the literal `name`/`folder`/`aliases` so a project archetype's
  * domain types stay strongly typed where the definition is declared and reused.
  */
-export declare function defineItemType<TType extends ItemTypeAuthoringDefinition>(type: ExactDefinition<TType, ItemTypeAuthoringDefinition>): TType;
+export declare function defineItemType<TType extends ItemTypeAuthoringDefinition>(type:ExactDefinition<TType,ItemTypeAuthoringDefinition>):TType;
 /**
  * Type a custom item-metadata field definition for `api.registerItemFields([...])`.
  *
@@ -97,7 +97,7 @@ export declare function defineItemType<TType extends ItemTypeAuthoringDefinition
  * keeping the field's extra metadata (the contract carries an index signature)
  * intact.
  */
-export declare function defineItemField<TField extends ItemFieldAuthoringDefinition>(field: ExactDefinition<TField, ItemFieldAuthoringDefinition>): TField;
+export declare function defineItemField<TField extends ItemFieldAuthoringDefinition>(field:ExactDefinition<TField,ItemFieldAuthoringDefinition>):TField;
 /**
  * Type a schema migration definition for `api.registerMigration(definition)`.
  *
@@ -105,7 +105,7 @@ export declare function defineItemField<TField extends ItemFieldAuthoringDefinit
  * runner's context, so the same definition can be registered and later exercised
  * through `runRegisteredMigrationForTest`.
  */
-export declare function defineMigration<TMigration extends MigrationAuthoringDefinition>(migration: ExactDefinition<TMigration, MigrationAuthoringDefinition>): TMigration;
+export declare function defineMigration<TMigration extends MigrationAuthoringDefinition>(migration:ExactDefinition<TMigration,MigrationAuthoringDefinition>):TMigration;
 /**
  * Type a search-provider definition for `api.registerSearchProvider(provider)`.
  *
@@ -113,7 +113,7 @@ export declare function defineMigration<TMigration extends MigrationAuthoringDef
  * so a custom retrieval backend is type-checked at the definition site and
  * reusable in `runRegisteredSearchProviderForTest`.
  */
-export declare function defineSearchProvider<TProvider extends SearchProviderAuthoringDefinition>(provider: ExactDefinition<TProvider, SearchProviderAuthoringDefinition>): TProvider;
+export declare function defineSearchProvider<TProvider extends SearchProviderAuthoringDefinition>(provider:ExactDefinition<TProvider,SearchProviderAuthoringDefinition>):TProvider;
 /**
  * Type a vector-store adapter definition for `api.registerVectorStoreAdapter(adapter)`.
  *
@@ -121,7 +121,7 @@ export declare function defineSearchProvider<TProvider extends SearchProviderAut
  * its own semantic index storage gets contract checking before activation and a
  * definition it can drive through `runRegisteredVectorStoreAdapterForTest`.
  */
-export declare function defineVectorStoreAdapter<TAdapter extends VectorStoreAdapterAuthoringDefinition>(adapter: ExactDefinition<TAdapter, VectorStoreAdapterAuthoringDefinition>): TAdapter;
+export declare function defineVectorStoreAdapter<TAdapter extends VectorStoreAdapterAuthoringDefinition>(adapter:ExactDefinition<TAdapter,VectorStoreAdapterAuthoringDefinition>):TAdapter;
 /**
  * Type a command-override handler for `api.registerCommand(command, override)`.
  *
@@ -129,7 +129,7 @@ export declare function defineVectorStoreAdapter<TAdapter extends VectorStoreAda
  * `context` parameter from {@link CommandOverride}, so a bare arrow authored in
  * a `.js` package still gets a fully-typed argument.
  */
-export declare function defineCommandOverride(override: CommandOverride): CommandOverride;
+export declare function defineCommandOverride(override:CommandOverride):CommandOverride;
 /**
  * Type a parser-override handler for `api.registerParser(command, override)`.
  *
@@ -137,16 +137,16 @@ export declare function defineCommandOverride(override: CommandOverride): Comman
  * {@link ParserOverride} delta so an argument-rewriting override is checked
  * where it is written.
  */
-export declare function defineParserOverride(override: ParserOverride): ParserOverride;
+export declare function defineParserOverride(override:ParserOverride):ParserOverride;
 /**
  * Type a preflight-override handler for `api.registerPreflight(override)`.
  *
  * Contextually types the `context` parameter and the returned gate decision so a
  * package's pre-run validation override is checked at the definition site.
  */
-export declare function definePreflightOverride(override: PreflightOverride): PreflightOverride;
+export declare function definePreflightOverride(override:PreflightOverride):PreflightOverride;
 /** Type a scoped preflight definition while preserving literal command ownership. */
-export declare function definePreflightOverride<TDefinition extends ScopedPreflightOverrideDefinition>(override: ExactDefinition<TDefinition, ScopedPreflightOverrideDefinition>): TDefinition;
+export declare function definePreflightOverride<TDefinition extends ScopedPreflightOverrideDefinition>(override:ExactDefinition<TDefinition,ScopedPreflightOverrideDefinition>):TDefinition;
 /**
  * Type a service-override handler for `api.registerService(service, override)`.
  *
@@ -154,26 +154,26 @@ export declare function definePreflightOverride<TDefinition extends ScopedPrefli
  * package overriding a built-in service (output formatting, embeddings, and the
  * like) keeps its handler argument typed without an explicit annotation.
  */
-export declare function defineServiceOverride(override: ServiceOverride): ServiceOverride;
+export declare function defineServiceOverride(override:ServiceOverride):ServiceOverride;
 /** Explicitly claim a service payload and publish its replacement result. */
-export declare function handleServiceOverride<const TResult>(result: TResult): {
-handled: true;
-result: TResult;
+export declare function handleServiceOverride<const TResult>(result:TResult):{
+handled:true;
+result:TResult;
 };
 /** Explicitly decline a service payload so the next override or host handles it. */
-export declare function declineServiceOverride(): ServiceOverrideDecision;
+export declare function declineServiceOverride():ServiceOverrideDecision;
 /**
  * Type a renderer-override handler for `api.registerRenderer(format, renderer)`.
  *
  * Contextually types the `context` parameter and the `string | null | undefined`
  * return contract so a custom output renderer is checked where it is authored.
  */
-export declare function defineRendererOverride(renderer: RendererOverride): RendererOverride;
+export declare function defineRendererOverride(renderer:RendererOverride):RendererOverride;
 /**
  * Type a scoped renderer definition while preserving its command/result
  * ownership literals for declarative composition and static introspection.
  */
-export declare function defineRendererOverride<TDefinition extends ScopedRendererOverrideDefinition>(renderer: ExactDefinition<TDefinition, ScopedRendererOverrideDefinition>): TDefinition;
+export declare function defineRendererOverride<TDefinition extends ScopedRendererOverrideDefinition>(renderer:ExactDefinition<TDefinition,ScopedRendererOverrideDefinition>):TDefinition;
 /**
  * Type an importer handler for `api.registerImporter(name, importer, options)`.
  *
@@ -181,7 +181,7 @@ export declare function defineRendererOverride<TDefinition extends ScopedRendere
  * options, pm root) so the bridge from an external system into the pm context
  * graph is type-checked and reusable in `runRegisteredImporterForTest`.
  */
-export declare function defineImporter(importer: Importer): Importer;
+export declare function defineImporter(importer:Importer):Importer;
 /**
  * Type an exporter handler for `api.registerExporter(name, exporter, options)`.
  *
@@ -189,7 +189,7 @@ export declare function defineImporter(importer: Importer): Importer;
  * context graph out to an external system is checked at the definition site and
  * reusable in `runRegisteredExporterForTest`.
  */
-export declare function defineExporter(exporter: Exporter): Exporter;
+export declare function defineExporter(exporter:Exporter):Exporter;
 /**
  * Type a `before_command` hook for `api.hooks.beforeCommand(hook)`.
  *
@@ -197,9 +197,9 @@ export declare function defineExporter(exporter: Exporter): Exporter;
  * inspects or annotates a command before it runs keeps its argument typed when
  * authored as a standalone, exportable, testable value.
  */
-export declare function defineBeforeCommandHook(hook: BeforeCommandHook): BeforeCommandHook;
+export declare function defineBeforeCommandHook(hook:BeforeCommandHook):BeforeCommandHook;
 /** Type a fail-closed `before_mutation` guard for `api.hooks.beforeMutation(hook)`. */
-export declare function defineBeforeMutationHook(hook: BeforeMutationHook): BeforeMutationHook;
+export declare function defineBeforeMutationHook(hook:BeforeMutationHook):BeforeMutationHook;
 /**
  * Type an `after_command` hook for `api.hooks.afterCommand(hook)`.
  *
@@ -207,21 +207,21 @@ export declare function defineBeforeMutationHook(hook: BeforeMutationHook): Befo
  * `affected` items pm mutated — so the natural place to react to every change
  * ("project management = context management") is checked where it is written.
  */
-export declare function defineAfterCommandHook(hook: AfterCommandHook): AfterCommandHook;
+export declare function defineAfterCommandHook(hook:AfterCommandHook):AfterCommandHook;
 /**
  * Type an `on_write` hook for `api.hooks.onWrite(hook)`.
  *
  * Contextually types the {@link OnWriteHook} `context` so a hook reacting to
  * item persistence keeps its argument typed without an explicit annotation.
  */
-export declare function defineOnWriteHook(hook: OnWriteHook): OnWriteHook;
+export declare function defineOnWriteHook(hook:OnWriteHook):OnWriteHook;
 /**
  * Type an `on_read` hook for `api.hooks.onRead(hook)`.
  *
  * Contextually types the {@link OnReadHook} `context` so a hook augmenting items
  * as they are read is type-checked at the definition site.
  */
-export declare function defineOnReadHook(hook: OnReadHook): OnReadHook;
+export declare function defineOnReadHook(hook:OnReadHook):OnReadHook;
 /**
  * Type an `on_index` hook for `api.hooks.onIndex(hook)`.
  *
@@ -229,5 +229,5 @@ export declare function defineOnReadHook(hook: OnReadHook): OnReadHook;
  * in index/search refresh keeps its argument typed even without TypeScript
  * annotations.
  */
-export declare function defineOnIndexHook(hook: OnIndexHook): OnIndexHook;
+export declare function defineOnIndexHook(hook:OnIndexHook):OnIndexHook;
 export {};