@unbrained/pm-cli 2026.10.13 → 2026.10.15

package/dist/sdk/completion/shared.d.ts

@@ -3,101 +3,101 @@ export type CompletionShell = "bash" | "zsh" | "fish";
 /** Documents the completion result payload exchanged by command, SDK, and package integrations. */
 export interface CompletionResult {
 /** Value that configures or reports shell for this contract. */
-shell: CompletionShell;
+shell:CompletionShell;
 /** Value that configures or reports script for this contract. */
-script: string;
+script:string;
 /** Value that configures or reports setup hint for this contract. */
-setup_hint: string;
+setup_hint:string;
 }
 type CompletionFlagCommand = "list" | "create" | "update" | "update-many" | "search" | "calendar" | "context";
 /** Documents the completion runtime config payload exchanged by command, SDK, and package integrations. */
 export interface CompletionRuntimeConfig {
 /** Active package command paths whose namespace facets may be advertised. Legacy aliases are accepted. */
-namespace_commands?: readonly string[];
+namespace_commands?:readonly string[];
 /** Value that configures or reports item types for this contract. */
-item_types?: string[];
+item_types?:string[];
 /** Value that configures or reports statuses for this contract. */
-statuses?: string[];
+statuses?:string[];
 /** Value that configures or reports command flags for this contract. */
-command_flags?: Partial<Record<CompletionFlagCommand, string[]>>;
+command_flags?:Partial<Record<CompletionFlagCommand,string[]>>;
 }
-declare const HIDDEN_COMMAND_ALIASES: Set<string>;
-declare const ALL_COMMANDS: string[];
-declare const LIST_FLAGS: string;
-declare const AGGREGATE_FLAGS: string;
-declare const APPEND_FLAGS: string;
-declare const COPY_FLAGS: string;
-declare const RESTORE_INVOCATIONS: import("../flag-invocation-contracts.js").CliFlagInvocationContract[];
-declare const ATTEST_INVOCATIONS: import("../flag-invocation-contracts.js").CliFlagInvocationContract[];
-declare const FOCUS_FLAGS: string;
-declare const MEET_FLAGS: string;
-declare const REMIND_FLAGS: string;
-declare const CREATE_FLAGS: string;
-declare const GET_FLAGS: string;
-declare const UPDATE_FLAGS: string;
-declare const UPDATE_MANY_FLAGS: string;
-declare const CLOSE_MANY_FLAGS: string;
-declare const NAMESPACE_NOUNS: string[];
-declare const NAMESPACE_PREFIXES: string[];
-declare const HISTORY_LEAVES: string;
+declare const HIDDEN_COMMAND_ALIASES:Set<string>;
+declare const ALL_COMMANDS:string[];
+declare const LIST_FLAGS:string;
+declare const AGGREGATE_FLAGS:string;
+declare const APPEND_FLAGS:string;
+declare const COPY_FLAGS:string;
+declare const RESTORE_INVOCATIONS:import("../flag-invocation-contracts.js").CliFlagInvocationContract[];
+declare const ATTEST_INVOCATIONS:import("../flag-invocation-contracts.js").CliFlagInvocationContract[];
+declare const FOCUS_FLAGS:string;
+declare const MEET_FLAGS:string;
+declare const REMIND_FLAGS:string;
+declare const CREATE_FLAGS:string;
+declare const GET_FLAGS:string;
+declare const UPDATE_FLAGS:string;
+declare const UPDATE_MANY_FLAGS:string;
+declare const CLOSE_MANY_FLAGS:string;
+declare const NAMESPACE_NOUNS:string[];
+declare const NAMESPACE_PREFIXES:string[];
+declare const HISTORY_LEAVES:string;
 /** Advertise core namespace leaves plus facets supplied by the active package registry. */
-declare function completionNamespaceLeaves(runtime: CompletionRuntimeConfig): Record<string, string>;
-declare const HISTORY_OPERATION_FLAGS: {
-flags: string;
-alias: string;
-canonical: string;
-canonical_argv: readonly string[];
-lifecycle: import("../cli-contracts.js").PmCommandAliasLifecycle;
-hidden: boolean;
-registration: import("../cli-contracts.js").PmCommandAliasRegistration;
-owner: string;
+declare function completionNamespaceLeaves(runtime:CompletionRuntimeConfig):Record<string,string>;
+declare const HISTORY_OPERATION_FLAGS:{
+flags:string;
+alias:string;
+canonical:string;
+canonical_argv:readonly string[];
+lifecycle:import("../cli-contracts.js").PmCommandAliasLifecycle;
+hidden:boolean;
+registration:import("../cli-contracts.js").PmCommandAliasRegistration;
+owner:string;
 }[];
-declare const HISTORY_FLAGS: string;
-declare const HISTORY_AUTHOR_ACKNOWLEDGE_FLAGS: string;
-declare const EVENTS_FLAGS: string;
-declare const CALENDAR_FLAGS: string;
-declare const CONTEXT_FLAGS: string;
-declare const NEXT_FLAGS: string;
-declare const DEPS_FLAGS: string;
-declare const DUPLICATES_FLAGS: string;
-declare const GRAPH_FLAGS: string;
-declare const GUIDE_FLAGS: string;
-declare const SEARCH_FLAGS: string;
-declare const STATS_FLAGS: string;
-declare const HEALTH_FLAGS: string;
-declare const INIT_FLAGS: string;
-declare const CONTRACTS_FLAGS: string;
-declare const PLAN_FLAGS: string;
-declare const SCHEMA_SUBCOMMAND_CHOICES: string;
+declare const HISTORY_FLAGS:string;
+declare const HISTORY_AUTHOR_ACKNOWLEDGE_FLAGS:string;
+declare const EVENTS_FLAGS:string;
+declare const CALENDAR_FLAGS:string;
+declare const CONTEXT_FLAGS:string;
+declare const NEXT_FLAGS:string;
+declare const DEPS_FLAGS:string;
+declare const DUPLICATES_FLAGS:string;
+declare const GRAPH_FLAGS:string;
+declare const GUIDE_FLAGS:string;
+declare const SEARCH_FLAGS:string;
+declare const STATS_FLAGS:string;
+declare const HEALTH_FLAGS:string;
+declare const INIT_FLAGS:string;
+declare const CONTRACTS_FLAGS:string;
+declare const PLAN_FLAGS:string;
+declare const SCHEMA_SUBCOMMAND_CHOICES:string;
 declare const PLAN_SUBCOMMANDS_LIST = "create show add-step update-step complete-step block-step reorder-step remove-step link unlink decision discovery validation resume approve materialize";
-declare const COMPLETION_SHELL_CHOICES: string;
-declare const GUIDE_TOPIC_CHOICES: string;
+declare const COMPLETION_SHELL_CHOICES:string;
+declare const GUIDE_TOPIC_CHOICES:string;
 declare const EXTENSION_LIFECYCLE_ACTIONS = "init scaffold install uninstall explore manage describe reload doctor catalog adopt adopt-all activate deactivate migrate";
 declare const PACKAGE_LIFECYCLE_ACTIONS = "init scaffold install uninstall explore manage describe reload doctor catalog adopt adopt-all activate deactivate migrate upgrade";
-declare const EXTENSION_LIFECYCLE_FLAGS: string;
-declare const PACKAGE_LIFECYCLE_FLAGS: string;
-declare const UPGRADE_FLAGS: string;
+declare const EXTENSION_LIFECYCLE_FLAGS:string;
+declare const PACKAGE_LIFECYCLE_FLAGS:string;
+declare const UPGRADE_FLAGS:string;
 declare const MUTATION_FLAGS = "--author --message --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help";
 declare const DELETE_MUTATION_FLAGS = "--dry-run --author --message --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help";
-declare const CLOSE_MUTATION_FLAGS: string;
-declare const CLOSE_TASK_MUTATION_FLAGS: string;
-declare const RELEASE_MUTATION_FLAGS: string;
-declare const CLAIM_MUTATION_FLAGS: string;
-declare const COMMAND_COMPLETION_DESCRIPTIONS: readonly [readonly ["workspace", "Workspace initialization, customization, state and snapshots"], readonly ["init", "Initialize pm storage for the current workspace"], readonly ["config", "Read or update pm settings"], readonly ["package", "Manage package lifecycle operations"], readonly ["packages", "Alias for package"], readonly ["create", "Create a new project management item"], readonly ["item", "Manage item evidence, links, tests, and duplication"], readonly ["copy", "Copy an existing item to a new ID"], readonly ["focus", "Set/clear/show the session focused parent for new items"], readonly ["list", "List active items with optional filters"], readonly ["aggregate", "Aggregate grouped item counts and numeric stats for governance queries"], readonly ["duplicates", "Find bounded duplicate clusters across lifecycle statuses"], readonly ["guide", "Browse local progressive-disclosure guides"], readonly ["calendar", "Show calendar views for deadlines and reminders"], readonly ["cal", "Alias for calendar"], readonly ["context", "Show a token-efficient project context snapshot"], readonly ["ctx", "Alias for context"], readonly ["get", "Show item details by ID"], readonly ["next", "Recommend the next actionable (unblocked, ready) work item"], readonly ["search", "Search items with keyword, semantic, or hybrid modes"], readonly ["reindex", "Rebuild search artifacts"], readonly ["history", "Show item history entries"], readonly ["history-compact", "Compact history streams into a synthetic baseline + retained tail"], readonly ["history-redact", "Redact sensitive literals/patterns and recompute history hashes"], readonly ["history-repair", "Re-anchor a drifted history chain so pm health/validate report ok"], readonly ["schema", "Manage custom item types and statuses in .agents/pm/schema/*.json"], readonly ["profile", "List, show, apply, and lint project profiles (archetype schema/config/template/package bundles)"], readonly ["plan", "Agent-optimized Plan item workflow (create/show/add-step/update-step/complete-step/link/approve/materialize)"], readonly ["activity", "Show recent activity across items"], readonly ["restore", "Restore an item to an earlier state"], readonly ["update", "Update item fields and metadata"], readonly ["update-many", "Bulk-update matched items with dry-run and rollback checkpoints"], readonly ["close", "Close an item (reason requirement follows governance settings)"], readonly ["close-many", "Bulk-close matched items with an optional shared reason and rollback checkpoint"], readonly ["delete", "Delete an item and record the change"], readonly ["append", "Append text to an item body"], readonly ["comments", "List or add comments for an item"], readonly ["notes", "List or add notes for an item"], readonly ["learnings", "List or add learnings for an item"], readonly ["files", "Manage linked files"], readonly ["docs", "Manage linked docs"], readonly ["deps", "Show dependency relationships for an item"], readonly ["graph", "Bounded graph traversal, analytics, and governance-audit queries"], readonly ["test", "Manage linked tests and optionally run them"], readonly ["test-all", "Run linked tests across matching items"], readonly ["test-runs", "Manage background linked-test runs"], readonly ["stats", "Show project tracker statistics"], readonly ["health", "Show project tracker health checks"], readonly ["validate", "Run standalone validation checks"], readonly ["gc", "Clean optional cache artifacts"], readonly ["contracts", "Show machine-readable command and schema contracts"], readonly ["claim", "Claim an item for active work"], readonly ["release", "Release the active claim for an item"], readonly ["start-task", "Lifecycle alias to claim and set in_progress"], readonly ["pause-task", "Lifecycle alias to reopen and release claim"], readonly ["close-task", "Lifecycle alias to close and release claim"], readonly ["meet", "Shortcut to create a Meeting with scheduling defaults"], readonly ["event", "Shortcut to create an Event with scheduling defaults"], readonly ["remind", "Shortcut to create a Reminder from a point in time"], readonly ["templates", "Manage reusable create templates"], readonly ["completion", "Generate shell completion"], readonly ["help", "Display help for a command"]];
-declare const GLOBAL_FLAGS: string;
-declare const GLOBAL_COMPLETION_VALUE_PATTERNS: string;
-declare const GLOBAL_COMPLETION_INLINE_PATTERNS: string;
-declare const GLOBAL_COMPLETION_SWITCH_PATTERNS: string;
+declare const CLOSE_MUTATION_FLAGS:string;
+declare const CLOSE_TASK_MUTATION_FLAGS:string;
+declare const RELEASE_MUTATION_FLAGS:string;
+declare const CLAIM_MUTATION_FLAGS:string;
+declare const COMMAND_COMPLETION_DESCRIPTIONS:readonly [readonly ["workspace","Workspace initialization, customization, state and snapshots"],readonly ["init","Initialize pm storage for the current workspace"],readonly ["config","Read or update pm settings"],readonly ["package","Manage package lifecycle operations"],readonly ["packages","Alias for package"],readonly ["create","Create a new project management item"],readonly ["item","Manage item evidence, links, tests, and duplication"],readonly ["copy","Copy an existing item to a new ID"],readonly ["focus","Set/clear/show the session focused parent for new items"],readonly ["list","List active items with optional filters"],readonly ["aggregate","Aggregate grouped item counts and numeric stats for governance queries"],readonly ["duplicates","Find bounded duplicate clusters across lifecycle statuses"],readonly ["guide","Browse local progressive-disclosure guides"],readonly ["calendar","Show calendar views for deadlines and reminders"],readonly ["cal","Alias for calendar"],readonly ["context","Show a token-efficient project context snapshot"],readonly ["ctx","Alias for context"],readonly ["get","Show item details by ID"],readonly ["next","Recommend the next actionable (unblocked, ready) work item"],readonly ["search","Search items with keyword, semantic, or hybrid modes"],readonly ["reindex","Rebuild search artifacts"],readonly ["history","Show item history entries"],readonly ["history-compact","Compact history streams into a synthetic baseline + retained tail"],readonly ["history-redact","Redact sensitive literals/patterns and recompute history hashes"],readonly ["history-repair","Re-anchor a drifted history chain so pm health/validate report ok"],readonly ["schema","Manage custom item types and statuses in .agents/pm/schema/*.json"],readonly ["profile","List, show, apply, and lint project profiles (archetype schema/config/template/package bundles)"],readonly ["plan","Agent-optimized Plan item workflow (create/show/add-step/update-step/complete-step/link/approve/materialize)"],readonly ["activity","Show recent activity across items"],readonly ["restore","Restore an item to an earlier state"],readonly ["update","Update item fields and metadata"],readonly ["update-many","Bulk-update matched items with dry-run and rollback checkpoints"],readonly ["close","Close an item (reason requirement follows governance settings)"],readonly ["close-many","Bulk-close matched items with an optional shared reason and rollback checkpoint"],readonly ["delete","Delete an item and record the change"],readonly ["append","Append text to an item body"],readonly ["comments","List or add comments for an item"],readonly ["notes","List or add notes for an item"],readonly ["learnings","List or add learnings for an item"],readonly ["files","Manage linked files"],readonly ["docs","Manage linked docs"],readonly ["deps","Show dependency relationships for an item"],readonly ["graph","Bounded graph traversal, analytics, and governance-audit queries"],readonly ["test","Manage linked tests and optionally run them"],readonly ["test-all","Run linked tests across matching items"],readonly ["test-runs","Manage background linked-test runs"],readonly ["stats","Show project tracker statistics"],readonly ["health","Show project tracker health checks"],readonly ["validate","Run standalone validation checks"],readonly ["gc","Clean optional cache artifacts"],readonly ["contracts","Show machine-readable command and schema contracts"],readonly ["claim","Claim an item for active work"],readonly ["release","Release the active claim for an item"],readonly ["start-task","Lifecycle alias to claim and set in_progress"],readonly ["pause-task","Lifecycle alias to reopen and release claim"],readonly ["close-task","Lifecycle alias to close and release claim"],readonly ["meet","Shortcut to create a Meeting with scheduling defaults"],readonly ["event","Shortcut to create an Event with scheduling defaults"],readonly ["remind","Shortcut to create a Reminder from a point in time"],readonly ["templates","Manage reusable create templates"],readonly ["completion","Generate shell completion"],readonly ["help","Display help for a command"]];
+declare const GLOBAL_FLAGS:string;
+declare const GLOBAL_COMPLETION_VALUE_PATTERNS:string;
+declare const GLOBAL_COMPLETION_INLINE_PATTERNS:string;
+declare const GLOBAL_COMPLETION_SWITCH_PATTERNS:string;
 /** Deduplicate, sort and join non-empty completion choices for deterministic output. */
-declare function joinCompletionValues(values: string[]): string;
+declare function joinCompletionValues(values:string[]):string;
 /** Escape shell interpolation characters before embedding a value in a double-quoted resolver fallback. */
-declare function shellDoubleQuote(value: string): string;
+declare function shellDoubleQuote(value:string):string;
 /** Choose explicit, runtime or built-in item types while retaining their configured order. */
-declare function completionTypeValues(itemTypes: string[], runtime: CompletionRuntimeConfig): string;
+declare function completionTypeValues(itemTypes:string[],runtime:CompletionRuntimeConfig):string;
 /** Choose runtime or built-in statuses and normalize them into deterministic completion choices. */
-declare function completionStatusValues(runtime: CompletionRuntimeConfig): string;
+declare function completionStatusValues(runtime:CompletionRuntimeConfig):string;
 /** Merge contract-derived flags with runtime schema flags without duplicates. */
-declare function mergeFlagStrings(baseFlags: string, runtimeFlags: string[] | undefined): string;
+declare function mergeFlagStrings(baseFlags:string,runtimeFlags:string[] | undefined):string;
 /** Normalize contributed long flags to dashed completion spellings and stable order. */
-declare function normalizeRuntimeCompletionFlags(runtimeFlags: string[] | undefined): string[];
-export { AGGREGATE_FLAGS, ALL_COMMANDS, APPEND_FLAGS, ATTEST_INVOCATIONS, CALENDAR_FLAGS, CLAIM_MUTATION_FLAGS, CLOSE_MANY_FLAGS, CLOSE_MUTATION_FLAGS, CLOSE_TASK_MUTATION_FLAGS, COMMAND_COMPLETION_DESCRIPTIONS, COMPLETION_SHELL_CHOICES, CONTEXT_FLAGS, CONTRACTS_FLAGS, COPY_FLAGS, CREATE_FLAGS, DELETE_MUTATION_FLAGS, DEPS_FLAGS, DUPLICATES_FLAGS, EVENTS_FLAGS, EXTENSION_LIFECYCLE_ACTIONS, EXTENSION_LIFECYCLE_FLAGS, FOCUS_FLAGS, GET_FLAGS, GLOBAL_COMPLETION_INLINE_PATTERNS, GLOBAL_COMPLETION_SWITCH_PATTERNS, GLOBAL_COMPLETION_VALUE_PATTERNS, GLOBAL_FLAGS, GRAPH_FLAGS, GUIDE_FLAGS, GUIDE_TOPIC_CHOICES, HEALTH_FLAGS, HIDDEN_COMMAND_ALIASES, HISTORY_AUTHOR_ACKNOWLEDGE_FLAGS, HISTORY_FLAGS, HISTORY_LEAVES, HISTORY_OPERATION_FLAGS, INIT_FLAGS, LIST_FLAGS, MEET_FLAGS, MUTATION_FLAGS, NAMESPACE_NOUNS, NAMESPACE_PREFIXES, NEXT_FLAGS, PACKAGE_LIFECYCLE_ACTIONS, PACKAGE_LIFECYCLE_FLAGS, PLAN_FLAGS, PLAN_SUBCOMMANDS_LIST, RELEASE_MUTATION_FLAGS, REMIND_FLAGS, RESTORE_INVOCATIONS, SCHEMA_SUBCOMMAND_CHOICES, SEARCH_FLAGS, STATS_FLAGS, UPDATE_FLAGS, UPDATE_MANY_FLAGS, UPGRADE_FLAGS, completionNamespaceLeaves, completionStatusValues, completionTypeValues, joinCompletionValues, mergeFlagStrings, normalizeRuntimeCompletionFlags, shellDoubleQuote };
+declare function normalizeRuntimeCompletionFlags(runtimeFlags:string[] | undefined):string[];
+export { AGGREGATE_FLAGS,ALL_COMMANDS,APPEND_FLAGS,ATTEST_INVOCATIONS,CALENDAR_FLAGS,CLAIM_MUTATION_FLAGS,CLOSE_MANY_FLAGS,CLOSE_MUTATION_FLAGS,CLOSE_TASK_MUTATION_FLAGS,COMMAND_COMPLETION_DESCRIPTIONS,COMPLETION_SHELL_CHOICES,CONTEXT_FLAGS,CONTRACTS_FLAGS,COPY_FLAGS,CREATE_FLAGS,DELETE_MUTATION_FLAGS,DEPS_FLAGS,DUPLICATES_FLAGS,EVENTS_FLAGS,EXTENSION_LIFECYCLE_ACTIONS,EXTENSION_LIFECYCLE_FLAGS,FOCUS_FLAGS,GET_FLAGS,GLOBAL_COMPLETION_INLINE_PATTERNS,GLOBAL_COMPLETION_SWITCH_PATTERNS,GLOBAL_COMPLETION_VALUE_PATTERNS,GLOBAL_FLAGS,GRAPH_FLAGS,GUIDE_FLAGS,GUIDE_TOPIC_CHOICES,HEALTH_FLAGS,HIDDEN_COMMAND_ALIASES,HISTORY_AUTHOR_ACKNOWLEDGE_FLAGS,HISTORY_FLAGS,HISTORY_LEAVES,HISTORY_OPERATION_FLAGS,INIT_FLAGS,LIST_FLAGS,MEET_FLAGS,MUTATION_FLAGS,NAMESPACE_NOUNS,NAMESPACE_PREFIXES,NEXT_FLAGS,PACKAGE_LIFECYCLE_ACTIONS,PACKAGE_LIFECYCLE_FLAGS,PLAN_FLAGS,PLAN_SUBCOMMANDS_LIST,RELEASE_MUTATION_FLAGS,REMIND_FLAGS,RESTORE_INVOCATIONS,SCHEMA_SUBCOMMAND_CHOICES,SEARCH_FLAGS,STATS_FLAGS,UPDATE_FLAGS,UPDATE_MANY_FLAGS,UPGRADE_FLAGS,completionNamespaceLeaves,completionStatusValues,completionTypeValues,joinCompletionValues,mergeFlagStrings,normalizeRuntimeCompletionFlags,shellDoubleQuote };

package/dist/sdk/completion/zsh.d.ts

@@ -1,3 +1,3 @@
 import type { CompletionRuntimeConfig } from "./shared.js";
 /** Implements generate zsh script for the public runtime surface of this module. */
-export declare function generateZshScript(itemTypes?: string[], tags?: string[], eagerTagExpansion?: boolean, runtime?: CompletionRuntimeConfig): string;
+export declare function generateZshScript(itemTypes?:string[],tags?:string[],eagerTagExpansion?:boolean,runtime?:CompletionRuntimeConfig):string;

package/dist/sdk/completion.d.ts

@@ -1,7 +1,7 @@
-import type { CompletionResult, CompletionRuntimeConfig } from "./completion/shared.js";
+import type { CompletionResult,CompletionRuntimeConfig } from "./completion/shared.js";
 /** Implements run completion for the public runtime surface of this module. */
-export declare function runCompletion(shell: string, itemTypes?: string[], tags?: string[], eagerTagExpansion?: boolean, runtime?: CompletionRuntimeConfig): CompletionResult;
+export declare function runCompletion(shell:string,itemTypes?:string[],tags?:string[],eagerTagExpansion?:boolean,runtime?:CompletionRuntimeConfig):CompletionResult;
 export { generateBashScript } from "./completion/bash.js";
 export { generateFishScript } from "./completion/fish.js";
-export type { CompletionResult, CompletionRuntimeConfig, CompletionShell } from "./completion/shared.js";
+export type { CompletionResult,CompletionRuntimeConfig,CompletionShell } from "./completion/shared.js";
 export { generateZshScript } from "./completion/zsh.js";