@cleocode/cleo 2026.2.5

package/completions/bash-completion.sh

@@ -0,0 +1,362 @@
+#!/usr/bin/env bash
+#####################################################################
+# bash-completion.sh - Bash completion for cleo CLI
+#
+# Installation:
+#   # Add to ~/.bashrc or ~/.bash_profile:
+#   source ~/.cleo/completions/bash-completion.sh
+#
+#   # Or install system-wide:
+#   sudo cp ~/.cleo/completions/bash-completion.sh \
+#       /etc/bash_completion.d/cleo
+#
+# Part of: Hierarchy Enhancement Phase 2 (T347)
+#####################################################################
+
+_cleo_completions() {
+    local cur prev opts
+    COMPREPLY=()
+    cur="${COMP_WORDS[COMP_CWORD]}"
+    prev="${COMP_WORDS[COMP_CWORD-1]}"
+
+    # All available commands
+    local commands="add update complete list show focus session archive \
+        validate backup restore migrate stats deps blockers next analyze \
+        dash labels phases phase find search export init log sync tree \
+        history exists reparent promote research dig"
+
+    # All available options
+    local global_opts="--help --version --format --quiet"
+
+    # Command-specific completions
+    case "${COMP_WORDS[1]}" in
+        add|new)
+            case "$prev" in
+                --parent|-p)
+                    # Complete with parent-eligible tasks (epic and task types only)
+                    _complete_parent_tasks
+                    return 0
+                    ;;
+                --type|-t)
+                    COMPREPLY=($(compgen -W "epic task subtask" -- "$cur"))
+                    return 0
+                    ;;
+                --priority)
+                    COMPREPLY=($(compgen -W "critical high medium low" -- "$cur"))
+                    return 0
+                    ;;
+                --status)
+                    COMPREPLY=($(compgen -W "pending active blocked done" -- "$cur"))
+                    return 0
+                    ;;
+                --phase)
+                    _complete_phases
+                    return 0
+                    ;;
+                --size)
+                    COMPREPLY=($(compgen -W "small medium large" -- "$cur"))
+                    return 0
+                    ;;
+                --labels)
+                    _complete_labels
+                    return 0
+                    ;;
+                --depends)
+                    _complete_task_ids
+                    return 0
+                    ;;
+            esac
+            local add_opts="--parent --type --priority --status --phase --size \
+                --labels --depends --description --blocked-by --quiet --format"
+            COMPREPLY=($(compgen -W "$add_opts" -- "$cur"))
+            ;;
+
+        update|edit)
+            case "$prev" in
+                update|edit)
+                    _complete_task_ids
+                    return 0
+                    ;;
+                --parent|-p)
+                    _complete_parent_tasks
+                    return 0
+                    ;;
+                --type|-t)
+                    COMPREPLY=($(compgen -W "epic task subtask" -- "$cur"))
+                    return 0
+                    ;;
+                --priority)
+                    COMPREPLY=($(compgen -W "critical high medium low" -- "$cur"))
+                    return 0
+                    ;;
+                --status)
+                    COMPREPLY=($(compgen -W "pending active blocked done" -- "$cur"))
+                    return 0
+                    ;;
+                --phase)
+                    _complete_phases
+                    return 0
+                    ;;
+                --size)
+                    COMPREPLY=($(compgen -W "small medium large" -- "$cur"))
+                    return 0
+                    ;;
+            esac
+            local update_opts="--title --description --priority --status --labels \
+                --depends --notes --phase --parent --type --size --blocked-by \
+                --quiet --format"
+            COMPREPLY=($(compgen -W "$update_opts" -- "$cur"))
+            ;;
+
+        complete|done)
+            case "$prev" in
+                complete|done)
+                    _complete_task_ids "pending,active,blocked"
+                    return 0
+                    ;;
+            esac
+            local complete_opts="--notes --skip-notes --quiet --format"
+            COMPREPLY=($(compgen -W "$complete_opts" -- "$cur"))
+            ;;
+
+        list|ls)
+            case "$prev" in
+                --status)
+                    COMPREPLY=($(compgen -W "pending active blocked done" -- "$cur"))
+                    return 0
+                    ;;
+                --priority)
+                    COMPREPLY=($(compgen -W "critical high medium low" -- "$cur"))
+                    return 0
+                    ;;
+                --phase)
+                    _complete_phases
+                    return 0
+                    ;;
+                --label)
+                    _complete_labels
+                    return 0
+                    ;;
+                --type)
+                    COMPREPLY=($(compgen -W "epic task subtask" -- "$cur"))
+                    return 0
+                    ;;
+                --parent)
+                    _complete_parent_tasks
+                    return 0
+                    ;;
+                --format)
+                    COMPREPLY=($(compgen -W "text json jsonl markdown table" -- "$cur"))
+                    return 0
+                    ;;
+            esac
+            local list_opts="--status --priority --phase --label --type --parent \
+                --children --tree --group-priority --format --quiet --human"
+            COMPREPLY=($(compgen -W "$list_opts" -- "$cur"))
+            ;;
+
+        show)
+            case "$prev" in
+                show)
+                    _complete_task_ids
+                    return 0
+                    ;;
+            esac
+            local show_opts="--history --related --include-archive --format"
+            COMPREPLY=($(compgen -W "$show_opts" -- "$cur"))
+            ;;
+
+        focus)
+            case "$prev" in
+                focus)
+                    COMPREPLY=($(compgen -W "set show clear note next" -- "$cur"))
+                    return 0
+                    ;;
+                set)
+                    _complete_task_ids "pending,active"
+                    return 0
+                    ;;
+            esac
+            ;;
+
+        reparent)
+            case "$prev" in
+                reparent)
+                    _complete_task_ids
+                    return 0
+                    ;;
+                --to)
+                    _complete_parent_tasks
+                    return 0
+                    ;;
+            esac
+            local reparent_opts="--to --format --quiet"
+            COMPREPLY=($(compgen -W "$reparent_opts" -- "$cur"))
+            ;;
+
+        promote)
+            case "$prev" in
+                promote)
+                    _complete_task_ids
+                    return 0
+                    ;;
+            esac
+            local promote_opts="--no-type-update --format --quiet"
+            COMPREPLY=($(compgen -W "$promote_opts" -- "$cur"))
+            ;;
+
+        phase)
+            case "$prev" in
+                phase)
+                    COMPREPLY=($(compgen -W "show set advance complete list" -- "$cur"))
+                    return 0
+                    ;;
+                set)
+                    _complete_phases
+                    return 0
+                    ;;
+            esac
+            ;;
+
+        session)
+            case "$prev" in
+                session)
+                    COMPREPLY=($(compgen -W "start end status pause resume" -- "$cur"))
+                    return 0
+                    ;;
+            esac
+            ;;
+
+        deps)
+            case "$prev" in
+                deps)
+                    _complete_task_ids
+                    return 0
+                    ;;
+            esac
+            local deps_opts="tree --format"
+            COMPREPLY=($(compgen -W "$deps_opts" -- "$cur"))
+            ;;
+
+        validate|check)
+            local validate_opts="--fix --check-orphans --fix-orphans --format"
+            COMPREPLY=($(compgen -W "$validate_opts" -- "$cur"))
+            ;;
+
+        find|search)
+            local find_opts="--id --exact --status --field --format --include-archive"
+            COMPREPLY=($(compgen -W "$find_opts" -- "$cur"))
+            ;;
+
+        export)
+            case "$prev" in
+                --format)
+                    COMPREPLY=($(compgen -W "todowrite csv json markdown" -- "$cur"))
+                    return 0
+                    ;;
+            esac
+            local export_opts="--format --output --filter"
+            COMPREPLY=($(compgen -W "$export_opts" -- "$cur"))
+            ;;
+
+        *)
+            # Complete commands
+            if [[ ${COMP_CWORD} -eq 1 ]]; then
+                COMPREPLY=($(compgen -W "$commands" -- "$cur"))
+            else
+                COMPREPLY=($(compgen -W "$global_opts" -- "$cur"))
+            fi
+            ;;
+    esac
+}
+
+# Complete parent-eligible tasks (epic and task types only, not subtask)
+_complete_parent_tasks() {
+    local cur="${COMP_WORDS[COMP_CWORD]}"
+    local todo_file="${TODO_FILE:-.claude/todo.json}"
+
+    if [[ ! -f "$todo_file" ]]; then
+        return 0
+    fi
+
+    # Get tasks that can be parents (epic or task type, not subtask)
+    local tasks
+    tasks=$(jq -r '.tasks[] | select(.type != "subtask") | "\(.id) \(.title | .[0:40])"' "$todo_file" 2>/dev/null)
+
+    # If current word starts with T, complete task IDs
+    if [[ "$cur" == T* ]]; then
+        local ids
+        ids=$(echo "$tasks" | cut -d' ' -f1 | grep "^$cur")
+        COMPREPLY=($(compgen -W "$ids" -- "$cur"))
+    else
+        # Complete with "ID - Title" format
+        local formatted
+        formatted=$(echo "$tasks" | while read -r line; do
+            echo "$line" | awk '{print $1}'
+        done)
+        COMPREPLY=($(compgen -W "$formatted" -- "$cur"))
+    fi
+}
+
+# Complete all task IDs
+_complete_task_ids() {
+    local cur="${COMP_WORDS[COMP_CWORD]}"
+    local todo_file="${TODO_FILE:-.claude/todo.json}"
+    local status_filter="${1:-}"
+
+    if [[ ! -f "$todo_file" ]]; then
+        return 0
+    fi
+
+    local ids
+    if [[ -n "$status_filter" ]]; then
+        # Filter by status
+        ids=$(jq -r --arg statuses "$status_filter" '
+            ($statuses | split(",")) as $s |
+            .tasks[] | select(.status as $st | $s | index($st)) | .id
+        ' "$todo_file" 2>/dev/null)
+    else
+        ids=$(jq -r '.tasks[].id' "$todo_file" 2>/dev/null)
+    fi
+
+    COMPREPLY=($(compgen -W "$ids" -- "$cur"))
+}
+
+# Complete phases
+_complete_phases() {
+    local cur="${COMP_WORDS[COMP_CWORD]}"
+    local todo_file="${TODO_FILE:-.claude/todo.json}"
+
+    if [[ ! -f "$todo_file" ]]; then
+        COMPREPLY=($(compgen -W "setup core testing polish maintenance" -- "$cur"))
+        return 0
+    fi
+
+    local phases
+    phases=$(jq -r '.project.phases | keys[]' "$todo_file" 2>/dev/null)
+
+    if [[ -z "$phases" ]]; then
+        phases="setup core testing polish maintenance"
+    fi
+
+    COMPREPLY=($(compgen -W "$phases" -- "$cur"))
+}
+
+# Complete labels
+_complete_labels() {
+    local cur="${COMP_WORDS[COMP_CWORD]}"
+    local todo_file="${TODO_FILE:-.claude/todo.json}"
+
+    if [[ ! -f "$todo_file" ]]; then
+        return 0
+    fi
+
+    local labels
+    labels=$(jq -r '.tasks[].labels[]? // empty' "$todo_file" 2>/dev/null | sort -u)
+
+    COMPREPLY=($(compgen -W "$labels" -- "$cur"))
+}
+
+# Register completion for cleo and ct alias
+complete -F _cleo_completions cleo
+complete -F _cleo_completions ct

package/completions/zsh-completion.zsh

@@ -0,0 +1,305 @@
+#compdef cleo ct
+#####################################################################
+# zsh-completion.zsh - Zsh completion for cleo CLI
+#
+# Installation:
+#   # Copy to your fpath (e.g., ~/.zsh/completions/):
+#   mkdir -p ~/.zsh/completions
+#   cp ~/.cleo/completions/zsh-completion.zsh \
+#       ~/.zsh/completions/_cleo
+#
+#   # Add to ~/.zshrc:
+#   fpath=(~/.zsh/completions $fpath)
+#   autoload -Uz compinit && compinit
+#
+# Part of: Hierarchy Enhancement Phase 2 (T347)
+#####################################################################
+
+_cleo() {
+    local curcontext="$curcontext" state line
+    typeset -A opt_args
+
+    local -a commands
+    commands=(
+        'add:Create a new task'
+        'update:Update an existing task'
+        'complete:Mark a task as done'
+        'list:List tasks with filters'
+        'show:Show task details'
+        'focus:Manage task focus'
+        'session:Manage work sessions'
+        'archive:Archive completed tasks'
+        'validate:Validate data integrity'
+        'backup:Create backup'
+        'restore:Restore from backup'
+        'migrate:Run schema migrations'
+        'stats:Show statistics'
+        'deps:Show dependencies'
+        'blockers:Show blocked tasks'
+        'next:Suggest next task'
+        'analyze:Analyze task triage'
+        'dash:Project dashboard'
+        'labels:List labels'
+        'phases:Show phase progress'
+        'phase:Manage current phase'
+        'find:Search tasks'
+        'export:Export tasks'
+        'init:Initialize project'
+        'log:View audit log'
+        'sync:Sync with TodoWrite'
+        'tree:Show hierarchy tree'
+        'history:Show completion history'
+        'exists:Check if task exists'
+        'reparent:Move task to new parent'
+        'promote:Promote task to root level'
+        'research:Research and discover'
+    )
+
+    local -a global_opts
+    global_opts=(
+        '(-h --help)'{-h,--help}'[Show help]'
+        '--version[Show version]'
+        '--format[Output format]:format:(text json jsonl markdown table)'
+        '(-q --quiet)'{-q,--quiet}'[Minimal output]'
+    )
+
+    _arguments -C \
+        $global_opts \
+        '1: :->command' \
+        '*: :->args'
+
+    case $state in
+        command)
+            _describe -t commands 'cleo commands' commands
+            ;;
+        args)
+            case $words[2] in
+                add|new)
+                    _arguments \
+                        '--parent[Parent task ID]:parent task:_cleo_parent_tasks' \
+                        '--type[Task type]:type:(epic task subtask)' \
+                        '--priority[Priority level]:priority:(critical high medium low)' \
+                        '--status[Status]:status:(pending active blocked done)' \
+                        '--phase[Project phase]:phase:_cleo_phases' \
+                        '--size[Task size]:size:(small medium large)' \
+                        '--labels[Labels (comma-separated)]:labels:_cleo_labels' \
+                        '--depends[Dependencies]:depends:_cleo_task_ids' \
+                        '--description[Description]:description:' \
+                        '--blocked-by[Blocked reason]:reason:' \
+                        '(-q --quiet)'{-q,--quiet}'[Minimal output]' \
+                        '--format[Output format]:format:(text json)'
+                    ;;
+
+                update|edit)
+                    _arguments \
+                        '1:task id:_cleo_task_ids' \
+                        '--title[New title]:title:' \
+                        '--description[Description]:description:' \
+                        '--priority[Priority]:priority:(critical high medium low)' \
+                        '--status[Status]:status:(pending active blocked done)' \
+                        '--labels[Labels]:labels:_cleo_labels' \
+                        '--depends[Dependencies]:depends:_cleo_task_ids' \
+                        '--notes[Add note]:notes:' \
+                        '--phase[Phase]:phase:_cleo_phases' \
+                        '--parent[Parent task]:parent:_cleo_parent_tasks' \
+                        '--type[Task type]:type:(epic task subtask)' \
+                        '--size[Size]:size:(small medium large)' \
+                        '--blocked-by[Blocked reason]:reason:'
+                    ;;
+
+                complete|done)
+                    _arguments \
+                        '1:task id:_cleo_pending_tasks' \
+                        '--notes[Completion notes]:notes:' \
+                        '--skip-notes[Skip notes prompt]' \
+                        '(-q --quiet)'{-q,--quiet}'[Minimal output]' \
+                        '--format[Output format]:format:(text json)'
+                    ;;
+
+                list|ls)
+                    _arguments \
+                        '--status[Filter by status]:status:(pending active blocked done)' \
+                        '--priority[Filter by priority]:priority:(critical high medium low)' \
+                        '--phase[Filter by phase]:phase:_cleo_phases' \
+                        '--label[Filter by label]:label:_cleo_labels' \
+                        '--type[Filter by type]:type:(epic task subtask)' \
+                        '--parent[Filter by parent]:parent:_cleo_parent_tasks' \
+                        '--children[Show children of task]:task:_cleo_task_ids' \
+                        '--tree[Show as hierarchy tree]' \
+                        '--group-priority[Group by priority]' \
+                        '--format[Output format]:format:(text json jsonl markdown table)' \
+                        '(-q --quiet)'{-q,--quiet}'[Minimal output]' \
+                        '--human[Force human-readable output]'
+                    ;;
+
+                show)
+                    _arguments \
+                        '1:task id:_cleo_task_ids' \
+                        '--history[Include task history]' \
+                        '--related[Show related tasks]' \
+                        '--include-archive[Search archive]' \
+                        '--format[Output format]:format:(text json)'
+                    ;;
+
+                focus)
+                    local -a focus_cmds
+                    focus_cmds=(
+                        'set:Set focus on task'
+                        'show:Show current focus'
+                        'clear:Clear focus'
+                        'note:Set session note'
+                        'next:Set next action'
+                    )
+                    _arguments \
+                        '1:subcommand:((${(j: :)focus_cmds}))' \
+                        '2:task id:_cleo_pending_tasks'
+                    ;;
+
+                reparent)
+                    _arguments \
+                        '1:task id:_cleo_task_ids' \
+                        '--to[New parent (empty for root)]:parent:_cleo_parent_tasks' \
+                        '--format[Output format]:format:(text json)' \
+                        '(-q --quiet)'{-q,--quiet}'[Minimal output]'
+                    ;;
+
+                promote)
+                    _arguments \
+                        '1:task id:_cleo_task_ids' \
+                        '--no-type-update[Keep subtask type]' \
+                        '--format[Output format]:format:(text json)' \
+                        '(-q --quiet)'{-q,--quiet}'[Minimal output]'
+                    ;;
+
+                phase)
+                    local -a phase_cmds
+                    phase_cmds=(
+                        'show:Show current phase'
+                        'set:Set current phase'
+                        'advance:Advance to next phase'
+                        'complete:Complete current phase'
+                        'list:List all phases'
+                    )
+                    _arguments \
+                        '1:subcommand:((${(j: :)phase_cmds}))' \
+                        '2:phase:_cleo_phases'
+                    ;;
+
+                session)
+                    local -a session_cmds
+                    session_cmds=(
+                        'start:Start work session'
+                        'end:End work session'
+                        'status:Show session status'
+                        'pause:Pause session'
+                        'resume:Resume session'
+                    )
+                    _describe -t session 'session command' session_cmds
+                    ;;
+
+                deps)
+                    _arguments \
+                        '1:task id:_cleo_task_ids' \
+                        'tree:Show full dependency tree' \
+                        '--format[Output format]:format:(text json)'
+                    ;;
+
+                validate|check)
+                    _arguments \
+                        '--fix[Fix checksum issues]' \
+                        '--check-orphans[Check for orphaned tasks]' \
+                        '--fix-orphans[Fix orphaned tasks]:mode:(unlink delete)' \
+                        '--format[Output format]:format:(text json)'
+                    ;;
+
+                find|search)
+                    _arguments \
+                        '1:query:' \
+                        '--id[Search by ID prefix]:prefix:' \
+                        '--exact[Exact match mode]' \
+                        '--status[Filter by status]:status:(pending active blocked done)' \
+                        '--field[Search field]:field:(title description)' \
+                        '--include-archive[Include archived tasks]' \
+                        '--format[Output format]:format:(text json)'
+                    ;;
+
+                export)
+                    _arguments \
+                        '--format[Export format]:format:(todowrite csv json markdown)' \
+                        '--output[Output file]:file:_files' \
+                        '--filter[Filter expression]:filter:'
+                    ;;
+
+                *)
+                    _message "no more arguments"
+                    ;;
+            esac
+            ;;
+    esac
+}
+
+# Complete parent-eligible tasks (epic and task types)
+_cleo_parent_tasks() {
+    local todo_file="${TODO_FILE:-.claude/todo.json}"
+    if [[ ! -f "$todo_file" ]]; then
+        return
+    fi
+
+    local -a tasks
+    tasks=(${(f)"$(jq -r '.tasks[] | select(.type != "subtask") | "\(.id):\(.title | .[0:40])"' "$todo_file" 2>/dev/null)"})
+    _describe -t tasks 'parent task' tasks
+}
+
+# Complete all task IDs
+_cleo_task_ids() {
+    local todo_file="${TODO_FILE:-.claude/todo.json}"
+    if [[ ! -f "$todo_file" ]]; then
+        return
+    fi
+
+    local -a tasks
+    tasks=(${(f)"$(jq -r '.tasks[] | "\(.id):\(.title | .[0:40])"' "$todo_file" 2>/dev/null)"})
+    _describe -t tasks 'task' tasks
+}
+
+# Complete pending/active task IDs
+_cleo_pending_tasks() {
+    local todo_file="${TODO_FILE:-.claude/todo.json}"
+    if [[ ! -f "$todo_file" ]]; then
+        return
+    fi
+
+    local -a tasks
+    tasks=(${(f)"$(jq -r '.tasks[] | select(.status == "pending" or .status == "active" or .status == "blocked") | "\(.id):\(.title | .[0:40])"' "$todo_file" 2>/dev/null)"})
+    _describe -t tasks 'task' tasks
+}
+
+# Complete phases
+_cleo_phases() {
+    local todo_file="${TODO_FILE:-.claude/todo.json}"
+
+    local -a phases
+    if [[ -f "$todo_file" ]]; then
+        phases=(${(f)"$(jq -r '.project.phases | keys[]' "$todo_file" 2>/dev/null)"})
+    fi
+
+    if [[ ${#phases} -eq 0 ]]; then
+        phases=(setup core testing polish maintenance)
+    fi
+
+    _describe -t phases 'phase' phases
+}
+
+# Complete labels
+_cleo_labels() {
+    local todo_file="${TODO_FILE:-.claude/todo.json}"
+    if [[ ! -f "$todo_file" ]]; then
+        return
+    fi
+
+    local -a labels
+    labels=(${(f)"$(jq -r '.tasks[].labels[]? // empty' "$todo_file" 2>/dev/null | sort -u)"})
+    _describe -t labels 'label' labels
+}
+
+_cleo "$@"

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

@@ -0,0 +1,12 @@
+/**
+ * CLI add command.
+ * @task T4460
+ * @epic T4454
+ */
+import { Command } from 'commander';
+/**
+ * Register the add command.
+ * @task T4460
+ */
+export declare function registerAddCommand(program: Command): void;
+//# sourceMappingURL=add.d.ts.map

package/dist/cli/commands/add.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/add.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA8DzD"}