@simonfestl/husky-cli 0.8.2 → 0.9.0

package/dist/commands/explain.js

@@ -1,7 +1,7 @@
 import { Command } from "commander";
 export const explainCommand = new Command("explain")
     .description("Explain CLI commands for AI agents")
-    .argument("[command]", "Command to explain (task, project, idea, department, workflow, jules, vm, vm-config, process, settings, strategy, worktree, roadmap, changelog, config, agent)")
+    .argument("[command]", "Command to explain (task, roadmap, changelog, config, agent)")
     .action((command) => {
     if (!command) {
         printOverview();
@@ -23,42 +23,9 @@ export const explainCommand = new Command("explain")
             case "agent":
                 printAgentWorkflowHelp();
                 break;
-            case "project":
-                printProjectHelp();
-                break;
-            case "idea":
-                printIdeaHelp();
-                break;
-            case "department":
-                printDepartmentHelp();
-                break;
-            case "workflow":
-                printWorkflowHelp();
-                break;
-            case "jules":
-                printJulesHelp();
-                break;
-            case "vm":
-                printVMHelp();
-                break;
-            case "vm-config":
-                printVMConfigHelp();
-                break;
-            case "process":
-                printProcessHelp();
-                break;
-            case "settings":
-                printSettingsHelp();
-                break;
-            case "strategy":
-                printStrategyHelp();
-                break;
-            case "worktree":
-                printWorktreeHelp();
-                break;
             default:
                 console.log(`Unknown command: ${command}`);
-                console.log("Available: task, project, idea, department, workflow, jules, vm, vm-config, process, settings, strategy, worktree, roadmap, changelog, config, agent");
+                console.log("Available: task, roadmap, changelog, config, agent");
                 process.exit(1);
         }
     }
@@ -69,17 +36,6 @@ HUSKY CLI - AI Task Orchestration
 
 Available Commands:
   task       Task management (list, create, start, complete, qa)
-  project    Project & knowledge management
-  idea       Idea management & conversion to tasks
-  department Organization structure
-  workflow   Process automation & workflow steps
-  jules      Jules AI coding sessions
-  vm         VM sessions for agent execution
-  vm-config  VM configurations
-  process    Business processes
-  settings   Application settings
-  strategy   Business strategy (vision, mission, values, goals)
-  worktree   Git worktrees for isolated workspaces
   roadmap    Roadmap & feature planning
   changelog  Generate changelogs from commits
   config     Configure API URL and key
@@ -108,14 +64,9 @@ LIST TASKS
   husky task list
   husky task list --status backlog
   husky task list --status in_progress
-  husky task list --interactive
 
   Options:
     -s, --status <status>   Filter by status (backlog, in_progress, review, done)
-    -p, --page <num>        Page number (starts at 1)
-    -n, --per-page <num>    Items per page (default: all)
-    -i, --interactive       Interactive pagination with arrow keys
-    --json                  Output as JSON
 
 GET TASK DETAILS
   husky task get --id <id>
@@ -135,28 +86,6 @@ CREATE TASK
     --path <path>              Path in project
     -p, --priority <priority>  Priority: low, medium, high (default: medium)
 
-UPDATE TASK
-  husky task update <id> --title "New title"
-  husky task update <id> --status in_progress --priority high
-  husky task update <id> --assignee llm --project proj123
-
-  Options:
-    -t, --title <title>        New title
-    -d, --description <desc>   New description
-    --status <status>          New status (backlog, in_progress, review, done)
-    --priority <priority>      New priority (low, medium, high, urgent)
-    --assignee <assignee>      New assignee (human, llm, unassigned)
-    --project <projectId>      Link to project
-    --json                     Output as JSON
-
-DELETE TASK
-  husky task delete <id>
-  husky task delete <id> --force
-
-  Options:
-    --force    Skip confirmation prompt
-    --json     Output as JSON
-
 START TASK
   husky task start <id>
 
@@ -171,6 +100,16 @@ REPORT STATUS
 
   Use this to report progress during task execution.
 
+POST MESSAGE
+  husky task message <id> "Progress update message"
+
+  Posts a status message to a specific task. Use this when agents
+  need to add updates to tasks without the HUSKY_TASK_ID env var.
+
+  Example:
+    husky task message abc123 "Implemented API endpoint"
+    husky task message xyz789 "Fixed failing tests"
+
 SUBMIT PLAN
   husky task plan --summary "Implementation plan"
   husky task plan --file plan.md
@@ -480,525 +419,3 @@ Most commands use standard exit codes:
   2 = Timeout (for wait-approval)
 `);
 }
-function printProjectHelp() {
-    console.log(`
-HUSKY PROJECT COMMANDS
-
-Manage projects and project knowledge.
-
-LIST PROJECTS
-  husky project list
-  husky project list --archived
-  husky project list --work-status in_progress --json
-
-  Options:
-    --archived               Include archived projects
-    --work-status <status>   Filter: planning, in_progress, review, completed, on_hold
-    --json                   Output as JSON
-
-GET PROJECT
-  husky project get <id>
-  husky project get <id> --json
-
-CREATE PROJECT
-  husky project create "Project name"
-  husky project create "My App" -d "Description" --repo https://github.com/org/repo
-
-  Options:
-    -d, --description <desc>   Project description
-    --repo <url>               Git repository URL
-
-UPDATE PROJECT
-  husky project update <id> --name "New name"
-  husky project update <id> --status active --work-status in_progress
-
-  Options:
-    --name <name>            New name
-    -d, --description <desc> New description
-    --status <status>        Status: active, archived
-    --work-status <status>   Work status: planning, in_progress, review, completed, on_hold
-
-DELETE PROJECT
-  husky project delete <id> --force
-
-KNOWLEDGE MANAGEMENT
-  husky project add-knowledge <projectId> --type architecture --title "API Design" --content "..."
-  husky project list-knowledge <projectId> [--type <type>]
-  husky project delete-knowledge <projectId> <knowledgeId>
-
-  Knowledge types: architecture, patterns, decisions, learnings
-`);
-}
-function printIdeaHelp() {
-    console.log(`
-HUSKY IDEA COMMANDS
-
-Manage ideas and convert them to tasks.
-
-LIST IDEAS
-  husky idea list
-  husky idea list --status active --json
-
-  Options:
-    --status <status>   Filter: draft, active, archived, converted
-    --json              Output as JSON
-
-GET IDEA
-  husky idea get <id>
-  husky idea get <id> --json
-
-CREATE IDEA
-  husky idea create "Idea title"
-  husky idea create "New feature" -d "Description" --source customer_feedback
-
-  Options:
-    -d, --description <desc>   Idea description
-    --source <source>          Source of the idea
-
-UPDATE IDEA
-  husky idea update <id> --title "Updated title"
-  husky idea update <id> --status archived
-
-  Options:
-    --title <title>          New title
-    -d, --description <desc> New description
-    --status <status>        Status: draft, active, archived, converted
-
-DELETE IDEA
-  husky idea delete <id> --force
-
-CONVERT TO TASK
-  husky idea convert <id>
-  husky idea convert <id> --priority high --assignee llm
-
-  Options:
-    --priority <priority>   Task priority: low, medium, high
-    --assignee <assignee>   Assign to: human, llm, unassigned
-`);
-}
-function printDepartmentHelp() {
-    console.log(`
-HUSKY DEPARTMENT COMMANDS
-
-Manage organization departments.
-
-LIST DEPARTMENTS
-  husky department list
-  husky department list --json
-
-GET DEPARTMENT
-  husky department get <id>
-  husky department get <id> --json
-
-CREATE DEPARTMENT
-  husky department create "Department name"
-  husky department create "Engineering" -d "Software development team"
-
-  Options:
-    -d, --description <desc>   Department description
-
-UPDATE DEPARTMENT
-  husky department update <id> --name "New name"
-  husky department update <id> -d "Updated description"
-
-  Options:
-    --name <name>            New name
-    -d, --description <desc> New description
-
-DELETE DEPARTMENT
-  husky department delete <id> --force
-`);
-}
-function printWorkflowHelp() {
-    console.log(`
-HUSKY WORKFLOW COMMANDS
-
-Manage workflows and workflow steps for process automation.
-
-LIST WORKFLOWS
-  husky workflow list
-  husky workflow list --value-stream operations --status active --json
-
-  Options:
-    --value-stream <vs>   Filter by value stream
-    --status <status>     Filter: draft, active, paused, archived
-    --json                Output as JSON
-
-GET WORKFLOW
-  husky workflow get <id>
-  husky workflow get <id> --json
-
-CREATE WORKFLOW
-  husky workflow create "Workflow name"
-  husky workflow create "Order Processing" -d "Description" --department dept123
-
-  Options:
-    -d, --description <desc>     Workflow description
-    --department <departmentId>  Link to department
-
-UPDATE WORKFLOW
-  husky workflow update <id> --name "New name"
-  husky workflow update <id> --status active
-
-  Options:
-    --name <name>            New name
-    -d, --description <desc> New description
-    --status <status>        Status: draft, active, paused, archived
-
-DELETE WORKFLOW
-  husky workflow delete <id> --force
-
-WORKFLOW STEPS
-  husky workflow add-step <workflowId> --name "Step name" [--action <action>]
-  husky workflow update-step <workflowId> <stepId> --name "Updated"
-  husky workflow delete-step <workflowId> <stepId>
-  husky workflow list-steps <workflowId> --json
-
-  Action types: manual, semi_automated, fully_automated
-
-AI STEP GENERATION
-  husky workflow generate-steps <workflowId> --sop "Standard operating procedure document..."
-
-  Generates workflow steps from an SOP document using AI.
-`);
-}
-function printJulesHelp() {
-    console.log(`
-HUSKY JULES COMMANDS
-
-Manage Jules AI coding sessions for automated development.
-
-LIST SESSIONS
-  husky jules list
-  husky jules list --status executing --json
-
-  Options:
-    --status <status>   Filter: pending, planning, awaiting_approval, executing, completed, failed, cancelled
-    --json              Output as JSON
-
-GET SESSION
-  husky jules get <id>
-  husky jules get <id> --json
-
-CREATE SESSION
-  husky jules create --prompt "Implement user authentication"
-  husky jules create --prompt "Fix bug" --source src123 --branch feature/fix
-
-  Options:
-    --prompt <prompt>     Task prompt (required)
-    --source <sourceId>   Jules source ID (GitHub repo)
-    --branch <branch>     Git branch to work on
-    --task <taskId>       Link to Husky task
-    --workflow <id>       Link to workflow
-    --no-approval         Auto-approve plan without waiting
-
-UPDATE SESSION
-  husky jules update <id> --prompt "Updated prompt"
-  husky jules update <id> --status cancelled
-
-DELETE SESSION
-  husky jules delete <id> --force
-
-INTERACT WITH SESSION
-  husky jules message <id> --message "Please also add tests"
-  husky jules approve <id>
-  husky jules approve <id> --reject
-
-ACTIVITIES
-  husky jules activities <id>
-  husky jules activities <id> --sync --json
-
-  Options:
-    --sync   Fetch latest activities from Jules API
-    --json   Output as JSON
-
-LIST SOURCES
-  husky jules sources
-  husky jules sources --json
-
-  Lists available Jules sources (GitHub repositories).
-`);
-}
-function printVMHelp() {
-    console.log(`
-HUSKY VM COMMANDS
-
-Manage VM sessions for isolated agent execution.
-
-LIST SESSIONS
-  husky vm list
-  husky vm list --status running --json
-
-  Options:
-    --status <status>   Filter: pending, creating, running, completed, failed, terminated
-    --json              Output as JSON
-
-GET SESSION
-  husky vm get <id>
-  husky vm get <id> --json
-
-CREATE SESSION
-  husky vm create "session-name" --prompt "Implement feature X"
-  husky vm create "my-task" --prompt "..." --agent claude-code --config cfg123
-
-  Options:
-    --prompt <prompt>       Initial prompt for agent (required)
-    --agent <agent>         Agent type: claude-code, gemini-cli, aider, custom
-    --config <configId>     VM configuration to use
-    --machine-type <type>   GCP machine type (default: e2-medium)
-    --zone <zone>           GCP zone (default: us-central1-a)
-    --repo <repoUrl>        Git repository URL
-    --branch <branch>       Git branch
-    --task <taskId>         Link to Husky task
-
-UPDATE SESSION
-  husky vm update <id> --prompt "Updated prompt"
-  husky vm update <id> --status terminated
-
-DELETE SESSION
-  husky vm delete <id> --force
-
-VM LIFECYCLE
-  husky vm start <id>      Start/provision the VM
-  husky vm stop <id>       Stop the VM
-
-LOGS
-  husky vm logs <id>
-  husky vm logs <id> --follow --tail 100
-
-  Options:
-    --follow       Stream logs (poll for updates)
-    --tail <n>     Show last n log entries
-
-PLAN APPROVAL
-  husky vm approve <id>    Approve VM session plan
-  husky vm reject <id>     Reject VM session plan
-
-VM POOL (Admin)
-  husky vm pool status           Show pool status (HOT/COLD VMs)
-  husky vm pool init             Initialize the VM pool
-  husky vm pool suspend <id>     Suspend a pool VM
-  husky vm pool resume <id>      Resume a suspended pool VM
-  husky vm pool setup <id>       Start Claude subscription setup
-`);
-}
-function printVMConfigHelp() {
-    console.log(`
-HUSKY VM-CONFIG COMMANDS
-
-Manage VM configurations with GCP settings and resource limits.
-
-LIST CONFIGURATIONS
-  husky vm-config list
-  husky vm-config list --json
-
-GET CONFIGURATION
-  husky vm-config get <id>
-  husky vm-config get <id> --json
-
-CREATE CONFIGURATION
-  husky vm-config create "Config name"
-  husky vm-config create "High Performance" --machine-type e2-standard-4 --disk-size 50
-
-  Options:
-    --machine-type <type>    GCP machine type (default: e2-medium)
-    --zone <zone>            GCP zone (default: europe-west1-b)
-    --disk-size <size>       Disk size in GB (default: 20)
-    --max-runtime <minutes>  Max runtime in minutes (default: 60)
-    --max-concurrent <n>     Max concurrent VMs (default: 3)
-    --daily-budget <usd>     Daily budget in USD (default: 10)
-
-UPDATE CONFIGURATION
-  husky vm-config update <id> --machine-type e2-standard-2
-  husky vm-config update <id> --disk-size 40 --max-runtime 120
-
-  Options:
-    --machine-type <type>    GCP machine type
-    --zone <zone>            GCP zone
-    --disk-size <size>       Disk size in GB
-    --max-runtime <minutes>  Max runtime in minutes
-    --max-concurrent <n>     Max concurrent VMs
-    --daily-budget <usd>     Daily budget in USD
-
-DELETE CONFIGURATION
-  husky vm-config delete <id> --force
-`);
-}
-function printProcessHelp() {
-    console.log(`
-HUSKY PROCESS COMMANDS
-
-Manage business processes.
-
-LIST PROCESSES
-  husky process list
-  husky process list --status active --json
-
-  Options:
-    --status <status>   Filter by status
-    --json              Output as JSON
-
-GET PROCESS
-  husky process get <id>
-  husky process get <id> --json
-
-CREATE PROCESS
-  husky process create "Process name"
-  husky process create "Customer Onboarding" -d "Steps for new customers"
-
-  Options:
-    -d, --description <desc>   Process description
-
-UPDATE PROCESS
-  husky process update <id> --name "New name"
-  husky process update <id> --status archived
-
-  Options:
-    --name <name>            New name
-    -d, --description <desc> New description
-    --status <status>        Process status
-
-DELETE PROCESS
-  husky process delete <id> --force
-`);
-}
-function printSettingsHelp() {
-    console.log(`
-HUSKY SETTINGS COMMANDS
-
-Manage application settings.
-
-GET SETTINGS
-  husky settings get                Get all settings
-  husky settings get <key>          Get specific setting
-  husky settings get api-url --json
-
-  Options:
-    --json   Output as JSON
-
-SET SETTING
-  husky settings set <key> <value>
-  husky settings set theme dark
-  husky settings set features '{"darkMode": true}'
-
-  Values are automatically parsed:
-    - JSON objects/arrays: '{"key": "value"}' or '["a", "b"]'
-    - Booleans: true, false
-    - Numbers: 123, 45.67
-    - Strings: everything else
-
-COMMON SETTINGS
-  theme          UI theme (light, dark, system)
-  language       Interface language
-  notifications  Notification preferences (JSON)
-  features       Feature flags (JSON)
-`);
-}
-function printStrategyHelp() {
-    console.log(`
-HUSKY STRATEGY COMMANDS
-
-Manage business strategy (vision, mission, values, goals, personas).
-
-SHOW STRATEGY
-  husky strategy show
-  husky strategy show --json
-
-VISION & MISSION
-  husky strategy set-vision --vision "To be the leading..."
-  husky strategy set-mission --mission "We help businesses..."
-
-VALUES
-  husky strategy add-value --name "Innovation" -d "We embrace change"
-  husky strategy update-value <id> --name "Updated name"
-  husky strategy delete-value <id> --force
-
-  Options:
-    --name <name>            Value name
-    -d, --description <desc> Value description
-
-GOALS
-  husky strategy add-goal --name "Increase revenue" --status in_progress
-  husky strategy update-goal <id> --progress 75 --status completed
-  husky strategy delete-goal <id> --force
-
-  Options:
-    --name <name>         Goal name
-    -d, --description <d> Goal description
-    --status <status>     Status: not_started, in_progress, at_risk, completed
-    --progress <n>        Progress percentage (0-100)
-    --due <date>          Due date (ISO format: 2024-12-31)
-
-PERSONAS (Target Audience)
-  husky strategy add-persona --name "Enterprise CTO" -d "Technical decision maker"
-  husky strategy update-persona <id> --characteristics "tech-savvy,budget-conscious"
-  husky strategy delete-persona <id> --force
-
-  Options:
-    --name <name>                 Persona name
-    -d, --description <desc>      Persona description
-    --characteristics <list>      Comma-separated characteristics
-`);
-}
-function printWorktreeHelp() {
-    console.log(`
-HUSKY WORKTREE COMMANDS
-
-Manage Git worktrees for isolated agent workspaces.
-
-CREATE WORKTREE
-  husky worktree create <session-name>
-  husky worktree create my-feature --base-branch develop --project /path/to/repo
-
-  Options:
-    --base-branch <branch>   Base branch to create from (default: main/master)
-    --project <path>         Project directory (default: current directory)
-
-  Creates: .worktrees/<session-name>/ with branch husky/<session-name>
-
-LIST WORKTREES
-  husky worktree list
-  husky worktree list --json
-
-INFO
-  husky worktree info <session-name>
-  husky worktree info <session-name> --json
-
-  Shows path, branch, status, and changes.
-
-NAVIGATE
-  husky worktree cd <session-name>
-
-  Prints the worktree path. Use with: cd $(husky worktree cd my-feature)
-
-STATUS
-  husky worktree status                  Status of all worktrees
-  husky worktree status <session-name>   Status of specific worktree
-
-REMOVE WORKTREE
-  husky worktree remove <session-name>
-  husky worktree remove <session-name> --delete-branch --force
-
-  Options:
-    --delete-branch   Also delete the associated branch
-    --force           Force removal even with uncommitted changes
-
-MERGE BACK
-  husky worktree merge <session-name>
-  husky worktree merge <session-name> --no-commit --delete-after
-
-  Options:
-    --no-commit      Stage changes but don't commit
-    --delete-after   Remove worktree/branch after successful merge
-    --message <msg>  Custom merge commit message
-
-CLEANUP
-  husky worktree cleanup          Clean up stale worktrees and locks
-  husky worktree cleanup --all    Remove ALL worktrees (with confirmation)
-
-LIST BRANCHES
-  husky worktree branches
-
-  Lists all husky/* branches in the repository.
-`);
-}