@unbrained/pm-cli 2026.3.9

package/dist/cli/commands/completion.js

@@ -0,0 +1,469 @@
+import { EXIT_CODE } from "../../core/shared/constants.js";
+import { PmCliError } from "../../core/shared/errors.js";
+const VALID_SHELLS = ["bash", "zsh", "fish"];
+const ALL_COMMANDS = [
+    "init",
+    "config",
+    "install",
+    "create",
+    "list",
+    "list-all",
+    "list-draft",
+    "list-open",
+    "list-in-progress",
+    "list-blocked",
+    "list-closed",
+    "list-canceled",
+    "get",
+    "search",
+    "reindex",
+    "history",
+    "activity",
+    "restore",
+    "update",
+    "close",
+    "delete",
+    "append",
+    "comments",
+    "files",
+    "docs",
+    "test",
+    "test-all",
+    "stats",
+    "health",
+    "gc",
+    "claim",
+    "release",
+    "beads",
+    "todos",
+    "completion",
+    "help",
+];
+const LIST_FLAGS = "--type --tag --priority --deadline-before --deadline-after --assignee --sprint --release --limit --json --quiet --path --no-extensions --profile --help";
+const CREATE_FLAGS = "-t --title -d --description --type -s --status -p --priority --tags -b --body --deadline --estimate --estimated-minutes --acceptance-criteria --ac --author --message --assignee --parent --reviewer --risk --confidence --sprint --release --blocked-by --blocked-reason --unblock-note --reporter --severity --environment --repro-steps --resolution --expected-result --actual-result --affected-version --fixed-version --component --regression --customer-impact --definition-of-ready --order --rank --goal --objective --value --impact --outcome --why-now --dep --comment --note --learning --file --test --doc --json --quiet --path --no-extensions --profile --help";
+const UPDATE_FLAGS = "-t --title -d --description -s --status -p --priority --type --tags --deadline --estimate --estimated-minutes --acceptance-criteria --ac --assignee --parent --reviewer --risk --confidence --sprint --release --blocked-by --blocked-reason --unblock-note --reporter --severity --environment --repro-steps --resolution --expected-result --actual-result --affected-version --fixed-version --component --regression --customer-impact --definition-of-ready --order --rank --goal --objective --value --impact --outcome --why-now --author --message --force --json --quiet --path --no-extensions --profile --help";
+const SEARCH_FLAGS = "--mode --include-linked --limit --type --tag --priority --deadline-before --deadline-after --json --quiet --path --no-extensions --profile --help";
+const MUTATION_FLAGS = "--author --message --force --json --quiet --path --no-extensions --profile --help";
+const GLOBAL_FLAGS = "--json --quiet --path --no-extensions --profile --version --help";
+export function generateBashScript() {
+    const cmds = ALL_COMMANDS.join(" ");
+    // Note: "${...}" inside regular (non-template) strings are literal characters,
+    // not JS interpolation. Only backtick template literals interpolate ${...}.
+    const compgen = (flags) => `$(compgen -W "${flags}" -- "$cur")`;
+    return [
+        "# bash completion for pm",
+        '# Source this file or add \'eval "$(pm completion bash)"\' to ~/.bashrc',
+        "",
+        "_pm_completion() {",
+        "  local cur prev words cword",
+        "  _init_completion 2>/dev/null || {",
+        '    cur="${COMP_WORDS[COMP_CWORD]}"',
+        '    prev="${COMP_WORDS[COMP_CWORD-1]}"',
+        "    cword=$COMP_CWORD",
+        "  }",
+        "",
+        "  if [[ $cword -eq 1 ]]; then",
+        `    COMPREPLY=(${compgen(cmds)})`,
+        "    return 0",
+        "  fi",
+        "",
+        '  local cmd="${COMP_WORDS[1]}"',
+        "",
+        '  case "$cmd" in',
+        "    list|list-all|list-draft|list-open|list-in-progress|list-blocked|list-closed|list-canceled)",
+        `      COMPREPLY=(${compgen(LIST_FLAGS)})`,
+        "      ;;",
+        "    create)",
+        `      COMPREPLY=(${compgen(CREATE_FLAGS)})`,
+        "      ;;",
+        "    update)",
+        `      COMPREPLY=(${compgen(UPDATE_FLAGS)})`,
+        "      ;;",
+        "    search)",
+        `      COMPREPLY=(${compgen(SEARCH_FLAGS)})`,
+        "      ;;",
+        "    reindex)",
+        `      COMPREPLY=(${compgen("--mode --json --quiet --path --no-extensions --profile --help")})`,
+        "      ;;",
+        "    config)",
+        `      COMPREPLY=(${compgen("--criterion --json --quiet --path --no-extensions --profile --help")})`,
+        "      ;;",
+        "    install)",
+        `      COMPREPLY=(${compgen("pi --project --global --json --quiet --path --no-extensions --profile --help")})`,
+        "      ;;",
+        "    comments)",
+        `      COMPREPLY=(${compgen("--add --limit --json --quiet --path --no-extensions --profile --help")})`,
+        "      ;;",
+        "    files|docs)",
+        `      COMPREPLY=(${compgen("--add --remove --json --quiet --path --no-extensions --profile --help")})`,
+        "      ;;",
+        "    test)",
+        `      COMPREPLY=(${compgen("--add --remove --run --timeout --json --quiet --path --no-extensions --profile --help")})`,
+        "      ;;",
+        "    test-all)",
+        `      COMPREPLY=(${compgen("--status --timeout --json --quiet --path --no-extensions --profile --help")})`,
+        "      ;;",
+        "    history|activity)",
+        `      COMPREPLY=(${compgen("--limit --json --quiet --path --no-extensions --profile --help")})`,
+        "      ;;",
+        "    claim|release|close|delete|append|restore)",
+        `      COMPREPLY=(${compgen(MUTATION_FLAGS)})`,
+        "      ;;",
+        "    beads)",
+        `      COMPREPLY=(${compgen("import")})`,
+        "      ;;",
+        "    todos)",
+        `      COMPREPLY=(${compgen("import export")})`,
+        "      ;;",
+        "    completion)",
+        `      COMPREPLY=(${compgen("bash zsh fish")})`,
+        "      ;;",
+        "    *)",
+        `      COMPREPLY=(${compgen(GLOBAL_FLAGS)})`,
+        "      ;;",
+        "  esac",
+        "  return 0",
+        "}",
+        "",
+        "complete -F _pm_completion pm",
+    ].join("\n");
+}
+export function generateZshScript() {
+    const cmds = ALL_COMMANDS.map((c) => `'${c}'`).join(" ");
+    return `#compdef pm
+# zsh completion for pm
+# Source this file or add 'eval "$(pm completion zsh)"' to ~/.zshrc
+
+_pm_commands() {
+  local -a commands
+  commands=(
+    'init:Initialize .agents/pm storage and settings'
+    'config:Read or update deterministic pm settings'
+    'install:Install supported integrations'
+    'create:Create a new item'
+    'list:List items with optional filters'
+    'list-all:List all items with optional filters'
+    'list-draft:List draft items'
+    'list-open:List open items'
+    'list-in-progress:List in-progress items'
+    'list-blocked:List blocked items'
+    'list-closed:List closed items'
+    'list-canceled:List canceled items'
+    'get:Get item details by id'
+    'search:Search items across keyword and optional semantic/hybrid modes'
+    'reindex:Rebuild deterministic search artifacts'
+    'history:Show item history'
+    'activity:Show recent activity'
+    'restore:Restore item to previous state'
+    'update:Update item fields'
+    'close:Close an item with required reason text'
+    'delete:Delete an item'
+    'append:Append text to item body'
+    'comments:List or append comments for an item'
+    'files:Manage linked files'
+    'docs:Manage linked docs'
+    'test:Manage linked tests and optionally run them'
+    'test-all:Run linked test commands across many items'
+    'stats:Show tracker statistics summary'
+    'health:Show tracker health checks summary'
+    'gc:Collect optional cache artifacts'
+    'claim:Claim ownership of an item'
+    'release:Release ownership of an item'
+    'beads:Built-in Beads extension commands'
+    'todos:Built-in todos extension commands'
+    'completion:Generate shell completion script'
+    'help:Display help for a command'
+  )
+  _describe 'command' commands
+}
+
+_pm() {
+  local context state line
+  _arguments -C \\
+    '--json[Output JSON instead of TOON]' \\
+    '--quiet[Suppress stdout output]' \\
+    '--path[Override PM path for this command]:path:_files -/' \\
+    '--no-extensions[Disable extension loading]' \\
+    '--profile[Print deterministic timing diagnostics]' \\
+    '(-V --version)--version[Output the version number]' \\
+    '(-h --help)--help[Display help]' \\
+    '1: :_pm_commands' \\
+    '*:: :->args' && return 0
+
+  case $state in
+    args)
+      case $line[1] in
+        list|list-all|list-draft|list-open|list-in-progress|list-blocked|list-closed|list-canceled)
+          _arguments \\
+            '--type[Filter by item type]:(Epic Feature Task Chore Issue)' \\
+            '--tag[Filter by tag]:tag' \\
+            '--priority[Filter by priority]:(0 1 2 3 4)' \\
+            '--deadline-before[Filter by deadline upper bound]:date' \\
+            '--deadline-after[Filter by deadline lower bound]:date' \\
+            '--assignee[Filter by assignee (use none for unassigned)]:assignee' \\
+            '--sprint[Filter by sprint]:sprint' \\
+            '--release[Filter by release]:release' \\
+            '--limit[Limit returned item count]:number' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]' \\
+            '--path[Override PM path]:path:_files -/'
+          ;;
+        create)
+          _arguments \\
+            '(-t --title)'{-t,--title}'[Item title]:title' \\
+            '(-d --description)'{-d,--description}'[Item description]:description' \\
+            '--type[Item type]:(Epic Feature Task Chore Issue)' \\
+            '(-s --status)'{-s,--status}'[Item status]:(draft open in_progress blocked)' \\
+            '(-p --priority)'{-p,--priority}'[Priority (0-4)]:(0 1 2 3 4)' \\
+            '--tags[Comma-separated tags]:tags' \\
+            '(-b --body)'{-b,--body}'[Item body]:body' \\
+            '--deadline[Deadline (ISO or relative +1d/+2w)]:deadline' \\
+            '--estimate[Estimated minutes]:minutes' \\
+            '--acceptance-criteria[Acceptance criteria]:criteria' \\
+            '--author[Mutation author]:author' \\
+            '--message[History message]:message' \\
+            '--assignee[Assignee (none to unset)]:assignee' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        update)
+          _arguments \\
+            '(-t --title)'{-t,--title}'[Item title]:title' \\
+            '(-d --description)'{-d,--description}'[Item description]:description' \\
+            '(-s --status)'{-s,--status}'[Item status]:(draft open in_progress blocked canceled)' \\
+            '(-p --priority)'{-p,--priority}'[Priority (0-4)]:(0 1 2 3 4)' \\
+            '--type[Item type]:(Epic Feature Task Chore Issue)' \\
+            '--tags[Comma-separated tags]:tags' \\
+            '--author[Mutation author]:author' \\
+            '--message[History message]:message' \\
+            '--force[Force override]' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        search)
+          _arguments \\
+            '--mode[Search mode]:(keyword semantic hybrid)' \\
+            '--include-linked[Include linked content in scoring]' \\
+            '--limit[Max results]:number' \\
+            '--type[Filter by type]:(Epic Feature Task Chore Issue)' \\
+            '--tag[Filter by tag]:tag' \\
+            '--priority[Filter by priority]:(0 1 2 3 4)' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        reindex)
+          _arguments \\
+            '--mode[Reindex mode]:(keyword semantic hybrid)' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        history|activity)
+          _arguments \\
+            '--limit[Max entries]:number' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        test-all)
+          _arguments \\
+            '--status[Filter by status]:(open in_progress)' \\
+            '--timeout[Default timeout seconds]:seconds' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        install)
+          _arguments \\
+            '--project[Install Pi extension into current project .pi/extensions]' \\
+            '--global[Install Pi extension into global PI_CODING_AGENT_DIR or ~/.pi/agent]' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]' \\
+            '1:target:(pi)'
+          ;;
+        completion)
+          _arguments '1:shell:(bash zsh fish)'
+          ;;
+        beads)
+          local -a beads_cmds
+          beads_cmds=('import:Import Beads JSONL records')
+          _describe 'beads command' beads_cmds
+          ;;
+        todos)
+          local -a todos_cmds
+          todos_cmds=('import:Import todos markdown files' 'export:Export todos markdown files')
+          _describe 'todos command' todos_cmds
+          ;;
+      esac
+      ;;
+  esac
+}
+
+compdef _pm pm`;
+}
+export function generateFishScript() {
+    const listCmds = [
+        "list",
+        "list-all",
+        "list-draft",
+        "list-open",
+        "list-in-progress",
+        "list-blocked",
+        "list-closed",
+        "list-canceled",
+    ].join(" ");
+    return `# Fish shell completion for pm
+# Save to ~/.config/fish/completions/pm.fish
+# or run: pm completion fish > ~/.config/fish/completions/pm.fish
+
+# Disable file completion by default
+complete -c pm -f
+
+# Global flags (available for all subcommands)
+complete -c pm -l json -d 'Output JSON instead of TOON'
+complete -c pm -l quiet -d 'Suppress stdout output'
+complete -c pm -l path -d 'Override PM path for this command' -r
+complete -c pm -l no-extensions -d 'Disable extension loading'
+complete -c pm -l profile -d 'Print deterministic timing diagnostics'
+complete -c pm -s V -l version -d 'Output the version number'
+complete -c pm -s h -l help -d 'Display help'
+
+# Helper: true when no subcommand has been given yet
+function __pm_no_subcommand
+  not __fish_seen_subcommand_from init config install create list list-all list-draft list-open list-in-progress list-blocked list-closed list-canceled get search reindex history activity restore update close delete append comments files docs test test-all stats health gc claim release beads todos completion help
+end
+
+# Subcommands
+complete -c pm -n __pm_no_subcommand -a init          -d 'Initialize .agents/pm storage and settings'
+complete -c pm -n __pm_no_subcommand -a config        -d 'Read or update deterministic pm settings'
+complete -c pm -n __pm_no_subcommand -a install       -d 'Install supported integrations'
+complete -c pm -n __pm_no_subcommand -a create        -d 'Create a new item'
+complete -c pm -n __pm_no_subcommand -a list          -d 'List items with optional filters'
+complete -c pm -n __pm_no_subcommand -a list-all      -d 'List all items with optional filters'
+complete -c pm -n __pm_no_subcommand -a list-draft    -d 'List draft items'
+complete -c pm -n __pm_no_subcommand -a list-open     -d 'List open items'
+complete -c pm -n __pm_no_subcommand -a list-in-progress -d 'List in-progress items'
+complete -c pm -n __pm_no_subcommand -a list-blocked  -d 'List blocked items'
+complete -c pm -n __pm_no_subcommand -a list-closed   -d 'List closed items'
+complete -c pm -n __pm_no_subcommand -a list-canceled -d 'List canceled items'
+complete -c pm -n __pm_no_subcommand -a get           -d 'Get item details by id'
+complete -c pm -n __pm_no_subcommand -a search        -d 'Search items across keyword and optional semantic/hybrid modes'
+complete -c pm -n __pm_no_subcommand -a reindex       -d 'Rebuild deterministic search artifacts'
+complete -c pm -n __pm_no_subcommand -a history       -d 'Show item history'
+complete -c pm -n __pm_no_subcommand -a activity      -d 'Show recent activity'
+complete -c pm -n __pm_no_subcommand -a restore       -d 'Restore item to previous state'
+complete -c pm -n __pm_no_subcommand -a update        -d 'Update item fields'
+complete -c pm -n __pm_no_subcommand -a close         -d 'Close an item with required reason text'
+complete -c pm -n __pm_no_subcommand -a delete        -d 'Delete an item'
+complete -c pm -n __pm_no_subcommand -a append        -d 'Append text to item body'
+complete -c pm -n __pm_no_subcommand -a comments      -d 'List or append comments for an item'
+complete -c pm -n __pm_no_subcommand -a files         -d 'Manage linked files'
+complete -c pm -n __pm_no_subcommand -a docs          -d 'Manage linked docs'
+complete -c pm -n __pm_no_subcommand -a test          -d 'Manage linked tests and optionally run them'
+complete -c pm -n __pm_no_subcommand -a test-all      -d 'Run linked test commands across many items'
+complete -c pm -n __pm_no_subcommand -a stats         -d 'Show tracker statistics summary'
+complete -c pm -n __pm_no_subcommand -a health        -d 'Show tracker health checks summary'
+complete -c pm -n __pm_no_subcommand -a gc            -d 'Collect optional cache artifacts'
+complete -c pm -n __pm_no_subcommand -a claim         -d 'Claim ownership of an item'
+complete -c pm -n __pm_no_subcommand -a release       -d 'Release ownership of an item'
+complete -c pm -n __pm_no_subcommand -a beads         -d 'Built-in Beads extension commands'
+complete -c pm -n __pm_no_subcommand -a todos         -d 'Built-in todos extension commands'
+complete -c pm -n __pm_no_subcommand -a completion    -d 'Generate shell completion script'
+
+# list* flags
+for list_cmd in ${listCmds}
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l type     -d 'Filter by item type' -r -a 'Epic Feature Task Chore Issue'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l tag      -d 'Filter by tag' -r
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l priority -d 'Filter by priority' -r -a '0 1 2 3 4'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l assignee -d 'Filter by assignee (none for unassigned)' -r
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l sprint   -d 'Filter by sprint' -r
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l release  -d 'Filter by release' -r
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l limit    -d 'Limit returned item count' -r
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l deadline-before -d 'Filter by deadline upper bound' -r
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l deadline-after  -d 'Filter by deadline lower bound' -r
+end
+
+# create flags
+complete -c pm -n '__fish_seen_subcommand_from create' -s t -l title              -d 'Item title' -r
+complete -c pm -n '__fish_seen_subcommand_from create' -s d -l description        -d 'Item description' -r
+complete -c pm -n '__fish_seen_subcommand_from create' -l type                    -d 'Item type' -r -a 'Epic Feature Task Chore Issue'
+complete -c pm -n '__fish_seen_subcommand_from create' -s s -l status             -d 'Item status' -r -a 'draft open in_progress blocked'
+complete -c pm -n '__fish_seen_subcommand_from create' -s p -l priority           -d 'Priority (0-4)' -r -a '0 1 2 3 4'
+complete -c pm -n '__fish_seen_subcommand_from create' -l tags                    -d 'Comma-separated tags' -r
+complete -c pm -n '__fish_seen_subcommand_from create' -s b -l body               -d 'Item body' -r
+complete -c pm -n '__fish_seen_subcommand_from create' -l deadline                -d 'Deadline (ISO or relative +1d/+2w)' -r
+complete -c pm -n '__fish_seen_subcommand_from create' -l estimate                -d 'Estimated minutes' -r
+complete -c pm -n '__fish_seen_subcommand_from create' -l acceptance-criteria     -d 'Acceptance criteria' -r
+complete -c pm -n '__fish_seen_subcommand_from create' -l author                  -d 'Mutation author' -r
+complete -c pm -n '__fish_seen_subcommand_from create' -l message                 -d 'History message' -r
+complete -c pm -n '__fish_seen_subcommand_from create' -l assignee                -d 'Assignee (none to unset)' -r
+
+# update flags
+complete -c pm -n '__fish_seen_subcommand_from update' -s t -l title              -d 'Item title' -r
+complete -c pm -n '__fish_seen_subcommand_from update' -s d -l description        -d 'Item description' -r
+complete -c pm -n '__fish_seen_subcommand_from update' -s s -l status             -d 'Item status' -r -a 'draft open in_progress blocked canceled'
+complete -c pm -n '__fish_seen_subcommand_from update' -s p -l priority           -d 'Priority (0-4)' -r -a '0 1 2 3 4'
+complete -c pm -n '__fish_seen_subcommand_from update' -l type                    -d 'Item type' -r -a 'Epic Feature Task Chore Issue'
+complete -c pm -n '__fish_seen_subcommand_from update' -l author                  -d 'Mutation author' -r
+complete -c pm -n '__fish_seen_subcommand_from update' -l message                 -d 'History message' -r
+complete -c pm -n '__fish_seen_subcommand_from update' -l force                   -d 'Force override'
+
+# search flags
+complete -c pm -n '__fish_seen_subcommand_from search' -l mode          -d 'Search mode' -r -a 'keyword semantic hybrid'
+complete -c pm -n '__fish_seen_subcommand_from search' -l include-linked -d 'Include linked content in scoring'
+complete -c pm -n '__fish_seen_subcommand_from search' -l limit          -d 'Max results' -r
+complete -c pm -n '__fish_seen_subcommand_from search' -l type           -d 'Filter by type' -r -a 'Epic Feature Task Chore Issue'
+complete -c pm -n '__fish_seen_subcommand_from search' -l tag            -d 'Filter by tag' -r
+complete -c pm -n '__fish_seen_subcommand_from search' -l priority       -d 'Filter by priority' -r -a '0 1 2 3 4'
+
+# reindex flags
+complete -c pm -n '__fish_seen_subcommand_from reindex' -l mode -d 'Reindex mode' -r -a 'keyword semantic hybrid'
+
+# history / activity flags
+complete -c pm -n '__fish_seen_subcommand_from history'  -l limit -d 'Max history entries' -r
+complete -c pm -n '__fish_seen_subcommand_from activity' -l limit -d 'Max activity entries' -r
+
+# test-all flags
+complete -c pm -n '__fish_seen_subcommand_from test-all' -l status  -d 'Filter by status' -r -a 'open in_progress'
+complete -c pm -n '__fish_seen_subcommand_from test-all' -l timeout -d 'Default timeout seconds' -r
+
+# completion shell argument
+complete -c pm -n '__fish_seen_subcommand_from completion' -a 'bash zsh fish' -d 'Shell type'
+
+# install target and flags
+complete -c pm -n '__fish_seen_subcommand_from install' -a 'pi' -d 'Install pm Pi extension'
+complete -c pm -n '__fish_seen_subcommand_from install' -l project -d 'Install into current project .pi/extensions'
+complete -c pm -n '__fish_seen_subcommand_from install' -l global -d 'Install into PI_CODING_AGENT_DIR or ~/.pi/agent'
+
+# beads subcommands
+complete -c pm -n '__fish_seen_subcommand_from beads' -a import -d 'Import Beads JSONL records'
+
+# todos subcommands
+complete -c pm -n '__fish_seen_subcommand_from todos' -a import -d 'Import todos markdown files'
+complete -c pm -n '__fish_seen_subcommand_from todos' -a export -d 'Export todos markdown files'`;
+}
+const SETUP_HINTS = {
+    bash: 'Add to ~/.bashrc or ~/.bash_profile: eval "$(pm completion bash)"',
+    zsh: 'Add to ~/.zshrc: eval "$(pm completion zsh)"',
+    fish: "Run: pm completion fish > ~/.config/fish/completions/pm.fish",
+};
+export function runCompletion(shell) {
+    const normalized = shell.trim().toLowerCase();
+    if (!VALID_SHELLS.includes(normalized)) {
+        throw new PmCliError(`Unknown shell: "${shell}". Supported shells: ${VALID_SHELLS.join(", ")}.`, EXIT_CODE.USAGE);
+    }
+    const validShell = normalized;
+    let script;
+    if (validShell === "bash") {
+        script = generateBashScript();
+    }
+    else if (validShell === "zsh") {
+        script = generateZshScript();
+    }
+    else {
+        script = generateFishScript();
+    }
+    return {
+        shell: validShell,
+        script,
+        setup_hint: SETUP_HINTS[validShell],
+    };
+}
+//# sourceMappingURL=completion.js.map

package/dist/cli/commands/completion.js.map

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

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

@@ -0,0 +1,15 @@
+import type { GlobalOptions } from "../../core/shared/command-types.js";
+declare const CONFIG_SCOPE_VALUES: readonly ["project", "global"];
+type ConfigScope = (typeof CONFIG_SCOPE_VALUES)[number];
+export interface ConfigCommandOptions {
+    criterion?: string[];
+}
+export interface ConfigResult {
+    scope: ConfigScope;
+    key: "definition_of_done";
+    criteria: string[];
+    settings_path: string;
+    changed: boolean;
+}
+export declare function runConfig(scopeValue: string, actionValue: string, keyValue: string, options: ConfigCommandOptions, global: GlobalOptions): Promise<ConfigResult>;
+export {};

package/dist/cli/commands/config.js

@@ -0,0 +1,72 @@
+import { pathExists } from "../../core/fs/fs-utils.js";
+import { EXIT_CODE } from "../../core/shared/constants.js";
+import { PmCliError } from "../../core/shared/errors.js";
+import { getSettingsPath, resolveGlobalPmRoot, resolvePmRoot, } from "../../core/store/paths.js";
+import { readSettings, writeSettings } from "../../core/store/settings.js";
+const CONFIG_SCOPE_VALUES = ["project", "global"];
+const CONFIG_KEY_VALUES = ["definition-of-done", "definition_of_done"];
+function normalizeScope(value) {
+    if (CONFIG_SCOPE_VALUES.includes(value)) {
+        return value;
+    }
+    throw new PmCliError(`Invalid config scope "${value}". Allowed: ${CONFIG_SCOPE_VALUES.join(", ")}`, EXIT_CODE.USAGE);
+}
+function normalizeAction(value) {
+    if (value === "get" || value === "set") {
+        return value;
+    }
+    throw new PmCliError(`Invalid config action "${value}". Allowed: get, set`, EXIT_CODE.USAGE);
+}
+function normalizeKey(value) {
+    if (CONFIG_KEY_VALUES.includes(value)) {
+        return "definition_of_done";
+    }
+    throw new PmCliError(`Invalid config key "${value}". Supported: ${CONFIG_KEY_VALUES.join(", ")}`, EXIT_CODE.USAGE);
+}
+function normalizeCriteria(values) {
+    const normalized = [...new Set((values ?? []).map((value) => value.trim()).filter((value) => value.length > 0))].sort((left, right) => left.localeCompare(right));
+    if (normalized.length === 0) {
+        throw new PmCliError("Config set definition-of-done requires at least one non-empty --criterion value", EXIT_CODE.USAGE);
+    }
+    return normalized;
+}
+async function resolveSettingsTarget(scope, global) {
+    const cwd = process.cwd();
+    const pmRoot = scope === "project" ? resolvePmRoot(cwd, global.path) : resolveGlobalPmRoot(cwd);
+    const settingsPath = getSettingsPath(pmRoot);
+    if (scope === "project" && !(await pathExists(settingsPath))) {
+        throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
+    }
+    return { pmRoot, settingsPath };
+}
+export async function runConfig(scopeValue, actionValue, keyValue, options, global) {
+    const scope = normalizeScope(scopeValue);
+    const action = normalizeAction(actionValue);
+    const key = normalizeKey(keyValue);
+    const target = await resolveSettingsTarget(scope, global);
+    const settings = await readSettings(target.pmRoot);
+    if (action === "get") {
+        return {
+            scope,
+            key,
+            criteria: [...settings.workflow.definition_of_done],
+            settings_path: target.settingsPath,
+            changed: false,
+        };
+    }
+    const nextCriteria = normalizeCriteria(options.criterion);
+    const changed = nextCriteria.length !== settings.workflow.definition_of_done.length ||
+        nextCriteria.some((value, index) => value !== settings.workflow.definition_of_done[index]);
+    settings.workflow.definition_of_done = nextCriteria;
+    if (changed) {
+        await writeSettings(target.pmRoot, settings, "config:set:definition_of_done");
+    }
+    return {
+        scope,
+        key,
+        criteria: [...settings.workflow.definition_of_done],
+        settings_path: target.settingsPath,
+        changed,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/cli/commands/config.js.map

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

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

@@ -0,0 +1,60 @@
+import type { GlobalOptions } from "../../core/shared/command-types.js";
+import type { ItemFrontMatter } from "../../types/index.js";
+export interface CreateCommandOptions {
+    title: string;
+    description: string;
+    type: string;
+    status: string;
+    priority: string;
+    tags: string;
+    body: string;
+    deadline: string;
+    estimatedMinutes: string;
+    acceptanceCriteria: string;
+    definitionOfReady?: string;
+    order?: string;
+    rank?: string;
+    goal?: string;
+    objective?: string;
+    value?: string;
+    impact?: string;
+    outcome?: string;
+    whyNow?: string;
+    author: string;
+    message: string;
+    assignee: string;
+    parent?: string;
+    reviewer?: string;
+    risk?: string;
+    confidence?: string;
+    sprint?: string;
+    release?: string;
+    blockedBy?: string;
+    blockedReason?: string;
+    unblockNote?: string;
+    reporter?: string;
+    severity?: string;
+    environment?: string;
+    reproSteps?: string;
+    resolution?: string;
+    expectedResult?: string;
+    actualResult?: string;
+    affectedVersion?: string;
+    fixedVersion?: string;
+    component?: string;
+    regression?: string;
+    customerImpact?: string;
+    dep?: string[];
+    comment?: string[];
+    note?: string[];
+    learning?: string[];
+    file?: string[];
+    test?: string[];
+    doc?: string[];
+}
+export interface CreateResult {
+    item: ItemFrontMatter;
+    changed_fields: string[];
+    warnings: string[];
+}
+export declare function runCreate(options: CreateCommandOptions, global: GlobalOptions): Promise<CreateResult>;