@simonfestl/husky-cli 0.8.2 → 0.9.0

package/README.md

@@ -1,8 +1,5 @@
 # Husky CLI
 
-[![CLI Tests](https://github.com/simon-sfxecom/huskyv0/actions/workflows/cli-tests.yml/badge.svg)](https://github.com/simon-sfxecom/huskyv0/actions/workflows/cli-tests.yml)
-[![codecov](https://codecov.io/gh/simon-sfxecom/huskyv0/branch/main/graph/badge.svg?flag=cli)](https://codecov.io/gh/simon-sfxecom/huskyv0)
-
 CLI for Huskyv0 Task Orchestration with Claude Agent SDK integration.
 
 **Part of the [huskyv0 monorepo](https://github.com/simon-sfxecom/huskyv0)**
@@ -42,8 +39,6 @@ husky
 husky task list                              # List all tasks
 husky task list --status in_progress         # Filter by status
 husky task list --json                       # JSON output
-husky task list -i                           # Interactive pagination
-husky task list --per-page 10 --page 2       # Paginated output
 husky task create "Fix login bug" --priority high
 husky task get <task-id>
 husky task start <task-id>
@@ -55,9 +50,7 @@ husky task delete <task-id>
 ### Project Management
 
 ```bash
-husky project list                           # List all projects
-husky project list -i                        # Interactive pagination
-husky project list --per-page 5 --page 1     # Paginated output
+husky project list
 husky project create "New Project" --description "..."
 husky project get <project-id>
 husky project update <project-id> --status active
@@ -70,9 +63,7 @@ husky project delete-knowledge <project-id> <knowledge-id>
 ### Workflow Management
 
 ```bash
-husky workflow list                          # List all workflows
-husky workflow list -i                       # Interactive pagination
-husky workflow list --per-page 5             # Paginated output
+husky workflow list
 husky workflow create "Onboarding" --department <id>
 husky workflow get <workflow-id>
 husky workflow update <workflow-id> --name "Updated"
@@ -87,9 +78,7 @@ husky workflow generate-mermaid <workflow-id>  # Mermaid diagram
 ### Idea Management
 
 ```bash
-husky idea list                              # List all ideas
-husky idea list -i                           # Interactive pagination
-husky idea list --per-page 10                # Paginated output
+husky idea list
 husky idea create "New feature idea" --category feature
 husky idea get <idea-id>
 husky idea update <idea-id> --status approved
@@ -171,8 +160,6 @@ husky roadmap create "Q1 2025" --description "..."
 husky roadmap update <roadmap-id> --name "Updated"
 husky roadmap delete <roadmap-id>
 husky roadmap add-phase <roadmap-id> --name "Phase 1"
-husky roadmap update-phase <roadmap-id> <phase-id> --name "Updated"
-husky roadmap delete-phase <roadmap-id> <phase-id> --force
 husky roadmap add-feature <roadmap-id> --phase <id> --title "Feature"
 husky roadmap list-features <roadmap-id>
 husky roadmap update-feature <roadmap-id> <feature-id> --status done
@@ -200,20 +187,6 @@ husky vm-config update <config-id> --machine-type e2-standard-2
 husky vm-config delete <config-id>
 ```
 
-### Git Worktree Management
-
-```bash
-husky worktree list                          # List all worktrees
-husky worktree create <session-name>         # Create worktree
-husky worktree info <session-name>           # Show details
-husky worktree status [session-name]         # Show status
-husky worktree cd <session-name>             # Print path
-husky worktree merge <session-name>          # Merge to base
-husky worktree remove <session-name>         # Remove worktree
-husky worktree branches                      # List husky/* branches
-husky worktree cleanup                       # Clean stale worktrees
-```
-
 ### Settings
 
 ```bash
@@ -248,35 +221,6 @@ husky completion zsh >> ~/.zshrc
 husky completion fish > ~/.config/fish/completions/husky.fish
 ```
 
-## Pagination
-
-List commands support pagination with two modes:
-
-### Interactive Pagination (`-i`)
-
-Navigate through results using arrow keys:
-
-```bash
-husky task list -i          # Interactive mode with arrow key navigation
-husky project list -i       # Works for projects, ideas, workflows
-```
-
-Features:
-- Use `↑`/`↓` to navigate items
-- `←` Previous page / `→` Next page
-- Press `Enter` to select and view details
-- Press `Esc` or select "Exit" to return
-
-### Static Pagination (`--page`, `--per-page`)
-
-For scripting or quick page views:
-
-```bash
-husky task list --per-page 10            # Show first 10 items
-husky task list --per-page 10 --page 2   # Show items 11-20
-husky idea list -n 5 -p 3                # Short form: 5 items, page 3
-```
-
 ## Environment Variables
 
 | Variable | Description |
@@ -339,22 +283,6 @@ husky --version
 
 ## Changelog
 
-### v0.6.2 (2026-01-06)
-- Added: Interactive pagination for list commands (`-i` flag)
-- Added: Static pagination (`--page`, `--per-page` flags)
-- Improved: Tasks, projects, ideas, workflows now support pagination
-
-### v0.6.1 (2026-01-06)
-- Added: Roadmap phase management (`update-phase`, `delete-phase`)
-- Fixed: Various bug fixes
-
-### v0.6.0 (2026-01-06)
-- Added: Git Worktree support for multi-agent isolation
-- Added: `husky worktree` commands (create, list, merge, remove, etc.)
-- Added: MergeLock mechanism for safe concurrent operations
-- Refactored: Interactive mode into modular components
-- Improved: Based on Auto-Claude's worktree architecture
-
 ### v0.5.0 (2026-01-06)
 - Full Dashboard feature parity (69 new commands)
 - Added: project, workflow, idea, department, vm, jules, process, strategy, settings, vm-config commands
@@ -381,47 +309,6 @@ husky --version
 - Configuration management
 - API key authentication
 
-## Development
-
-### Testing
-
-The CLI has comprehensive test coverage using Vitest:
-
-```bash
-# Run all tests
-npm test
-
-# Run tests in watch mode
-npm run test:watch
-
-# Run with coverage
-npm run test:coverage
-
-# Run specific test file
-npm test tests/unit/commands/config.test.ts
-```
-
-**Test Structure:**
-- `tests/setup.ts` - Global test configuration (MSW, memfs, mocks)
-- `tests/unit/` - Unit tests for individual modules
-- `tests/integration/` - Integration tests for workflows
-- `tests/helpers/` - Reusable mocking utilities
-
-**Current Coverage:**
-- Config Command: ~29% lines, 60% functions
-- Worktree Library: ~55% lines, 70% branches, 65% functions
-- Total: 29 tests across 4 test files
-
-### Building
-
-```bash
-# Build TypeScript
-npm run build
-
-# Watch mode for development
-npm run dev
-```
-
 ## License
 
 MIT

package/dist/commands/biz/customers.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Husky Biz Customers Command
+ *
+ * Access customer profiles via Billbee (from order data)
+ */
+import { Command } from "commander";
+export declare const customersCommand: Command;
+export default customersCommand;

package/dist/commands/biz/customers.js

@@ -0,0 +1,181 @@
+/**
+ * Husky Biz Customers Command
+ *
+ * Access customer profiles via Billbee (from order data)
+ */
+import { Command } from "commander";
+import { BillbeeClient } from "../../lib/biz/index.js";
+export const customersCommand = new Command("customers")
+    .description("Access customer profiles (Billbee)");
+// husky biz customers search <email>
+customersCommand
+    .command("search <email>")
+    .description("Search customers by email")
+    .option("--json", "Output as JSON")
+    .action(async (email, options) => {
+    try {
+        const client = BillbeeClient.fromConfig();
+        const result = await client.findCustomerByEmail(email);
+        if (!result) {
+            console.log(`\n  No customer found with email: ${email}\n`);
+            process.exit(0);
+        }
+        if (options.json) {
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        console.log(`\n  👤 Customer: ${email}`);
+        console.log("  " + "─".repeat(40));
+        const addr = result.address;
+        if (addr) {
+            console.log(`  Name:    ${addr.FirstName || ""} ${addr.LastName || ""}`);
+            if (addr.Company)
+                console.log(`  Company: ${addr.Company}`);
+            console.log(`  Address: ${addr.Street || ""} ${addr.HouseNumber || ""}`);
+            console.log(`           ${addr.Zip || ""} ${addr.City || ""}`);
+            if (addr.Phone)
+                console.log(`  Phone:   ${addr.Phone}`);
+        }
+        console.log(`\n  Orders: ${result.orders.length}`);
+        console.log("");
+    }
+    catch (error) {
+        console.error("Error:", error.message);
+        process.exit(1);
+    }
+});
+// husky biz customers history <email>
+customersCommand
+    .command("history <email>")
+    .description("Get order history for customer by email")
+    .option("-l, --limit <num>", "Max orders to show", "10")
+    .option("--json", "Output as JSON")
+    .action(async (email, options) => {
+    try {
+        const client = BillbeeClient.fromConfig();
+        const result = await client.findCustomerByEmail(email);
+        if (!result) {
+            console.log(`\n  No customer found with email: ${email}\n`);
+            process.exit(0);
+        }
+        const orders = result.orders.slice(0, parseInt(options.limit, 10));
+        if (options.json) {
+            console.log(JSON.stringify(orders, null, 2));
+            return;
+        }
+        const addr = result.address;
+        const name = addr ? `${addr.FirstName || ""} ${addr.LastName || ""}`.trim() : email;
+        console.log(`\n  📋 Order History for ${name} (${email})`);
+        console.log("  " + "─".repeat(60));
+        console.log(`\n  ${result.orders.length} total orders\n`);
+        if (orders.length === 0) {
+            console.log("  No orders found.");
+            return;
+        }
+        for (const order of orders) {
+            const date = order.CreatedAt ? new Date(order.CreatedAt).toLocaleDateString("de-DE") : "?";
+            const total = order.TotalCost?.toFixed(2) || "0.00";
+            console.log(`  #${(order.OrderNumber || "?").padEnd(12)} │ ${date} │ €${total}`);
+        }
+        console.log("");
+    }
+    catch (error) {
+        console.error("Error:", error.message);
+        process.exit(1);
+    }
+});
+// ============================================================================
+// PREBUILD COMMANDS
+// ============================================================================
+import { ZendeskClient } from "../../lib/biz/index.js";
+// husky biz customers 360 <email>
+customersCommand
+    .command("360 <email>")
+    .alias("full")
+    .description("[PREBUILD] Full customer view (Billbee orders + Zendesk tickets)")
+    .option("--json", "Output as JSON")
+    .action(async (email, options) => {
+    try {
+        const billbee = BillbeeClient.fromConfig();
+        const zendesk = ZendeskClient.fromConfig();
+        // Parallel fetch from both systems
+        console.log(`  Fetching customer data for ${email}...`);
+        const [customerResult, tickets] = await Promise.all([
+            billbee.findCustomerByEmail(email).catch(() => null),
+            zendesk.searchTickets(`requester:${email}`).catch(() => []),
+        ]);
+        const result = {
+            email,
+            billbee: customerResult ? {
+                name: customerResult.address
+                    ? `${customerResult.address.FirstName || ''} ${customerResult.address.LastName || ''}`.trim()
+                    : null,
+                company: customerResult.address?.Company || null,
+                phone: customerResult.address?.Phone || null,
+                orders: customerResult.orders.slice(0, 5),
+                totalOrders: customerResult.orders.length,
+                totalSpent: customerResult.orders.reduce((sum, o) => sum + (o.TotalCost || 0), 0),
+            } : null,
+            zendesk: {
+                tickets: tickets.slice(0, 5),
+                totalTickets: tickets.length,
+                openTickets: tickets.filter(t => ['new', 'open', 'pending'].includes(String(t.status))).length,
+            },
+        };
+        if (options.json) {
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        console.log(`\n  👤 Customer 360: ${email}`);
+        console.log("  " + "═".repeat(60));
+        // Billbee section
+        if (result.billbee) {
+            console.log(`\n  📦 ORDERS (Billbee)`);
+            console.log("  " + "─".repeat(40));
+            if (result.billbee.name)
+                console.log(`  Name:    ${result.billbee.name}`);
+            if (result.billbee.company)
+                console.log(`  Company: ${result.billbee.company}`);
+            if (result.billbee.phone)
+                console.log(`  Phone:   ${result.billbee.phone}`);
+            console.log(`  Total:   ${result.billbee.totalOrders} orders | €${result.billbee.totalSpent.toFixed(2)}`);
+            if (result.billbee.orders.length > 0) {
+                console.log(`\n  Recent orders:`);
+                for (const order of result.billbee.orders) {
+                    const date = order.CreatedAt ? new Date(order.CreatedAt).toLocaleDateString("de-DE") : "?";
+                    console.log(`    #${(order.OrderNumber || "?").padEnd(12)} │ ${date} │ €${(order.TotalCost || 0).toFixed(2)}`);
+                }
+            }
+        }
+        else {
+            console.log(`\n  📦 ORDERS: No Billbee data found`);
+        }
+        // Zendesk section
+        console.log(`\n  🎫 TICKETS (Zendesk)`);
+        console.log("  " + "─".repeat(40));
+        console.log(`  Total:   ${result.zendesk.totalTickets} tickets | ${result.zendesk.openTickets} open`);
+        if (result.zendesk.tickets.length > 0) {
+            console.log(`\n  Recent tickets:`);
+            for (const ticket of result.zendesk.tickets) {
+                const statusIcon = getStatusIcon(String(ticket.status));
+                console.log(`    ${statusIcon} #${String(ticket.id).padEnd(8)} │ ${String(ticket.status).padEnd(8)} │ ${String(ticket.subject).slice(0, 35)}`);
+            }
+        }
+        console.log("");
+    }
+    catch (error) {
+        console.error("Error:", error.message);
+        process.exit(1);
+    }
+});
+function getStatusIcon(status) {
+    switch (status) {
+        case "new": return "🆕";
+        case "open": return "📬";
+        case "pending": return "⏳";
+        case "solved": return "✅";
+        case "closed": return "🔒";
+        default: return "○";
+    }
+}
+export default customersCommand;

package/dist/commands/biz/orders.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Husky Biz Orders Command
+ *
+ * Manages orders via Billbee API
+ */
+import { Command } from "commander";
+export declare const ordersCommand: Command;
+export default ordersCommand;

package/dist/commands/biz/orders.js

@@ -0,0 +1,226 @@
+/**
+ * Husky Biz Orders Command
+ *
+ * Manages orders via Billbee API
+ */
+import { Command } from "commander";
+import { BillbeeClient, OrderStateLabels } from "../../lib/biz/index.js";
+export const ordersCommand = new Command("orders")
+    .description("Manage orders (Billbee)");
+// husky biz orders list
+ordersCommand
+    .command("list")
+    .description("List orders")
+    .option("-s, --status <status>", "Filter by status (ordered, paid, shipped, completed, etc.)")
+    .option("-l, --limit <num>", "Number of orders to show", "20")
+    .option("-p, --page <num>", "Page number", "1")
+    .option("--json", "Output as JSON")
+    .action(async (options) => {
+    try {
+        const client = BillbeeClient.fromConfig();
+        // Map status string to state ID
+        let orderStateId;
+        if (options.status) {
+            const statusLower = options.status.toLowerCase();
+            const stateEntry = Object.entries(OrderStateLabels).find(([, label]) => label === statusLower);
+            if (stateEntry) {
+                orderStateId = [parseInt(stateEntry[0], 10)];
+            }
+            else {
+                console.error(`Unknown status: ${options.status}`);
+                console.error("Available: ordered, paid, shipped, completed, cancelled, return, packing, ready");
+                process.exit(1);
+            }
+        }
+        const response = await client.listOrders({
+            page: parseInt(options.page, 10),
+            pageSize: parseInt(options.limit, 10),
+            orderStateId,
+            includePositions: true,
+        });
+        if (options.json) {
+            console.log(JSON.stringify(response, null, 2));
+            return;
+        }
+        console.log(`\n  📦 Orders (${response.Paging.TotalRows} total)\n`);
+        if (response.Data.length === 0) {
+            console.log("  No orders found.");
+            return;
+        }
+        for (const order of response.Data) {
+            const stateLabel = OrderStateLabels[order.State || 0] || "unknown";
+            const date = order.CreatedAt ? new Date(order.CreatedAt).toLocaleDateString("de-DE") : "?";
+            const customer = order.InvoiceAddress?.LastName || order.Buyer?.Email || "Unknown";
+            const total = order.TotalCost?.toFixed(2) || "0.00";
+            console.log(`  #${order.OrderNumber?.padEnd(12)} │ ${stateLabel.padEnd(10)} │ ${date} │ ${customer.slice(0, 20).padEnd(20)} │ €${total}`);
+        }
+        console.log(`\n  Page ${response.Paging.Page} of ${response.Paging.TotalPages}\n`);
+    }
+    catch (error) {
+        console.error("Error:", error.message);
+        process.exit(1);
+    }
+});
+// husky biz orders get <id>
+ordersCommand
+    .command("get <id>")
+    .description("Get order details")
+    .option("--json", "Output as JSON")
+    .action(async (id, options) => {
+    try {
+        const client = BillbeeClient.fromConfig();
+        const response = await client.getOrder(id);
+        const order = response.Data;
+        if (options.json) {
+            console.log(JSON.stringify(order, null, 2));
+            return;
+        }
+        const stateLabel = OrderStateLabels[order.State || 0] || "unknown";
+        console.log(`\n  Order #${order.OrderNumber}`);
+        console.log("  " + "─".repeat(50));
+        console.log(`  Billbee ID:  ${order.BillbeeId || order.Id}`);
+        console.log(`  Status:      ${stateLabel}`);
+        console.log(`  Created:     ${order.CreatedAt ? new Date(order.CreatedAt).toLocaleString("de-DE") : "?"}`);
+        console.log(`  Total:       €${order.TotalCost?.toFixed(2) || "0.00"}`);
+        console.log(`  Shipping:    €${order.ShippingCost?.toFixed(2) || "0.00"}`);
+        if (order.InvoiceNumber) {
+            console.log(`  Invoice:     ${order.InvoiceNumber}`);
+        }
+        // Customer
+        const addr = order.InvoiceAddress;
+        if (addr) {
+            console.log(`\n  Customer:`);
+            console.log(`    ${addr.FirstName || ""} ${addr.LastName || ""}`);
+            if (addr.Company)
+                console.log(`    ${addr.Company}`);
+            console.log(`    ${addr.Street || ""} ${addr.HouseNumber || ""}`);
+            console.log(`    ${addr.Zip || ""} ${addr.City || ""}`);
+            if (addr.Email)
+                console.log(`    ${addr.Email}`);
+        }
+        // Items
+        if (order.OrderItems && order.OrderItems.length > 0) {
+            console.log(`\n  Items:`);
+            for (const item of order.OrderItems) {
+                const sku = item.Product?.SKU || "-";
+                const title = item.Product?.Title?.slice(0, 35) || "Unknown";
+                console.log(`    ${item.Quantity}x ${sku.padEnd(15)} ${title} (€${item.TotalPrice.toFixed(2)})`);
+            }
+        }
+        console.log("");
+    }
+    catch (error) {
+        console.error("Error:", error.message);
+        process.exit(1);
+    }
+});
+// husky biz orders invoice <id>
+ordersCommand
+    .command("invoice <id>")
+    .description("Get invoice info for order")
+    .action(async (id) => {
+    try {
+        const client = BillbeeClient.fromConfig();
+        const response = await client.getOrder(id);
+        const order = response.Data;
+        if (order.InvoiceNumber) {
+            console.log(`\n  Invoice: ${order.InvoiceNumber}`);
+            if (order.InvoiceDate) {
+                console.log(`  Date:    ${new Date(order.InvoiceDate).toLocaleDateString("de-DE")}`);
+            }
+            console.log(`  Total:   €${order.TotalCost?.toFixed(2) || "0.00"}`);
+        }
+        else {
+            console.log("\n  No invoice generated for this order.");
+        }
+        console.log("");
+    }
+    catch (error) {
+        console.error("Error:", error.message);
+        process.exit(1);
+    }
+});
+// husky biz orders update <id>
+ordersCommand
+    .command("update <id>")
+    .description("Update order properties")
+    .option("--state <state>", "New state (paid, shipped, completed, etc.)")
+    .option("--comment <text>", "Add seller comment")
+    .action(async (id, options) => {
+    try {
+        const client = BillbeeClient.fromConfig();
+        const updates = {};
+        if (options.state) {
+            const stateEntry = Object.entries(OrderStateLabels).find(([, label]) => label === options.state.toLowerCase());
+            if (stateEntry) {
+                updates.State = parseInt(stateEntry[0], 10);
+            }
+            else {
+                console.error(`Unknown state: ${options.state}`);
+                process.exit(1);
+            }
+        }
+        if (options.comment) {
+            updates.SellerComment = options.comment;
+        }
+        if (Object.keys(updates).length === 0) {
+            console.error("Error: Provide --state or --comment");
+            process.exit(1);
+        }
+        const response = await client.updateOrder(id, updates);
+        console.log(`✓ Order #${response.Data.OrderNumber} updated`);
+    }
+    catch (error) {
+        console.error("Error:", error.message);
+        process.exit(1);
+    }
+});
+// husky biz orders add-tag <id> <tag>
+ordersCommand
+    .command("add-tag <id> <tag>")
+    .description("Add a tag to an order")
+    .action(async (id, tag) => {
+    try {
+        const client = BillbeeClient.fromConfig();
+        await client.addOrderTags(parseInt(id, 10), [tag]);
+        console.log(`✓ Tag "${tag}" added to order #${id}`);
+    }
+    catch (error) {
+        console.error("Error:", error.message);
+        process.exit(1);
+    }
+});
+// husky biz orders remove-tag <id> <tag>
+ordersCommand
+    .command("remove-tag <id> <tag>")
+    .description("Remove a tag from an order")
+    .action(async (id, tag) => {
+    try {
+        const client = BillbeeClient.fromConfig();
+        await client.removeOrderTags(parseInt(id, 10), [tag]);
+        console.log(`✓ Tag "${tag}" removed from order #${id}`);
+    }
+    catch (error) {
+        console.error("Error:", error.message);
+        process.exit(1);
+    }
+});
+// husky biz orders note <id>
+ordersCommand
+    .command("note <id>")
+    .description("Add seller comment/note to order")
+    .requiredOption("-m, --message <text>", "Note content")
+    .action(async (id, options) => {
+    try {
+        const client = BillbeeClient.fromConfig();
+        await client.updateOrder(id, {
+            SellerComment: options.message,
+        });
+        console.log(`✓ Note added to order #${id}`);
+    }
+    catch (error) {
+        console.error("Error:", error.message);
+        process.exit(1);
+    }
+});
+export default ordersCommand;

package/dist/commands/biz/products.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Husky Biz Products Command
+ *
+ * Manages products via Billbee API
+ */
+import { Command } from "commander";
+export declare const productsCommand: Command;
+export default productsCommand;