@simonfestl/husky-cli 0.7.0 → 0.7.1

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, roadmap, changelog, config, agent)")
+    .argument("[command]", "Command to explain (task, project, idea, department, workflow, jules, vm, vm-config, process, settings, strategy, worktree, roadmap, changelog, config, agent)")
     .action((command) => {
     if (!command) {
         printOverview();
@@ -23,9 +23,42 @@ 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, roadmap, changelog, config, agent");
+                console.log("Available: task, project, idea, department, workflow, jules, vm, vm-config, process, settings, strategy, worktree, roadmap, changelog, config, agent");
                 process.exit(1);
         }
     }
@@ -36,6 +69,17 @@ 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
@@ -64,9 +108,14 @@ 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>
@@ -86,6 +135,28 @@ 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>
 
@@ -409,3 +480,525 @@ 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.
+`);
+}

package/dist/index.js

@@ -23,7 +23,7 @@ const program = new Command();
 program
     .name("husky")
     .description("CLI for Huskyv0 Task Orchestration with Claude Agent")
-    .version("0.6.0");
+    .version("0.7.1");
 program.addCommand(taskCommand);
 program.addCommand(configCommand);
 program.addCommand(agentCommand);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@simonfestl/husky-cli",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "CLI for Huskyv0 Task Orchestration with Claude Agent SDK",
   "type": "module",
   "bin": {