squads-cli 0.5.0 → 0.6.0

package/dist/templates/seed/squads/research/research-eval.md

@@ -0,0 +1,20 @@
+---
+name: Research Evaluator
+role: evaluator
+model: haiku
+effort: medium
+---
+
+# Research Evaluator
+
+Evaluate research quality, relevance, and actionability.
+
+## Instructions
+
+1. Read research and analysis outputs
+2. Score on: accuracy (1-5), relevance (1-5), actionability (1-5)
+3. Record evaluation: `squads feedback add research <rating> "<feedback>"`
+
+## Output
+
+Evaluation scores via `squads feedback add`

package/dist/templates/seed/squads/research/researcher.md

@@ -0,0 +1,28 @@
+---
+name: Researcher
+role: lead
+model: sonnet
+effort: high
+tools:
+  - WebSearch
+  - WebFetch
+  - Write
+---
+
+# Researcher Agent
+
+Conduct market, competitor, and trend research relevant to the business focus.
+
+## Instructions
+
+1. Read business context from `.agents/BUSINESS_BRIEF.md`
+2. Research the market landscape:
+   - Key competitors and their positioning
+   - Market trends and emerging opportunities
+   - Industry benchmarks and best practices
+3. Save research notes to `.agents/memory/research/researcher/state.md`
+4. Record key findings: `squads memory write research "<finding>"`
+
+## Output
+
+Research notes in `.agents/memory/research/researcher/state.md`

package/dist/{terminal-JZSAQSN7.js → terminal-YKA4O5CX.js}

@@ -15,6 +15,7 @@ import {
   isAiCli,
   isColorEnabled,
   padEnd,
+  privacyHeader,
   progressBar,
   rgb,
   sparkline,
@@ -23,7 +24,7 @@ import {
   truncate,
   write,
   writeLine
-} from "./chunk-NA3IECJA.js";
+} from "./chunk-N7KDWU4W.js";
 import "./chunk-7OCVIDC7.js";
 export {
   ESC,
@@ -41,6 +42,7 @@ export {
   isAiCli,
   isColorEnabled,
   padEnd,
+  privacyHeader,
   progressBar,
   rgb,
   sparkline,
@@ -50,4 +52,4 @@ export {
   write,
   writeLine
 };
-//# sourceMappingURL=terminal-JZSAQSN7.js.map
+//# sourceMappingURL=terminal-YKA4O5CX.js.map

package/dist/{update-MAY6EXFQ.js → update-ALJKFFM7.js}

@@ -5,7 +5,8 @@ import {
   getCurrentVersion,
   performUpdate,
   refreshVersionCache
-} from "./chunk-HKWCBCEK.js";
+} from "./chunk-4CMAEQQY.js";
+import "./chunk-N7KDWU4W.js";
 import "./chunk-7OCVIDC7.js";
 export {
   autoUpdateOnStartup,
@@ -14,4 +15,4 @@ export {
   performUpdate,
   refreshVersionCache
 };
-//# sourceMappingURL=update-MAY6EXFQ.js.map
+//# sourceMappingURL=update-ALJKFFM7.js.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "squads-cli",
-  "version": "0.5.0",
-  "description": "Open source CLI for AI agent coordination and execution. Domain-aligned squads with persistent memory and goals.",
+  "version": "0.6.0",
+  "description": "Your AI workforce. Every user gets an AI manager that runs their team — finance, marketing, engineering, operations — for the cost of API calls.",
   "type": "module",
   "bin": {
     "squads": "./dist/cli.js"
@@ -16,17 +16,7 @@
   },
   "files": [
     "dist",
-    "templates",
-    "docker/docker-compose.yml",
-    "docker/docker-compose.engram.yml",
-    "docker/.env.example",
-    "docker/init-db.sql",
-    "docker/init-engram-db.sql",
-    "docker/init-langfuse-db.sh",
-    "docker/otel-collector.yaml",
-    "docker/README.md",
-    "docker/squads-bridge/",
-    "docker/telemetry-ping/"
+    "templates"
   ],
   "scripts": {
     "build": "tsup && cp -r templates dist/",
@@ -40,6 +30,9 @@
     "prepublishOnly": "npm run build"
   },
   "keywords": [
+    "ai-workforce",
+    "business-automation",
+    "ai-team",
     "claude",
     "claude-code",
     "anthropic",
@@ -71,28 +64,22 @@
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.71.2",
-    "@supabase/supabase-js": "^2.89.0",
-    "@types/blessed": "^0.1.27",
-    "blessed": "^0.1.81",
-    "blessed-contrib": "^4.11.0",
     "chalk": "^5.3.0",
     "chrono-node": "^2.9.0",
     "commander": "^12.1.0",
     "dotenv": "^17.2.3",
     "gray-matter": "^4.0.3",
     "inquirer": "^9.2.12",
-    "ioredis": "^5.9.2",
     "minimatch": "^10.1.1",
     "open": "^11.0.0",
-    "ora": "^8.0.1",
-    "pg": "^8.16.3"
+    "ora": "^8.0.1"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.2",
     "@types/node": "^20.19.27",
-    "@types/pg": "^8.16.0",
     "@typescript-eslint/eslint-plugin": "^8.51.0",
     "@typescript-eslint/parser": "^8.51.0",
+    "@vitest/coverage-v8": "^4.0.18",
     "eslint": "^9.39.2",
     "tsup": "^8.0.1",
     "typescript": "^5.3.0",

package/templates/seed/BUSINESS_BRIEF.md.template

@@ -0,0 +1,27 @@
+# Business Brief — {{BUSINESS_NAME}}
+
+## About
+
+{{BUSINESS_DESCRIPTION}}
+
+## Research Focus
+
+{{BUSINESS_FOCUS}}
+
+## Priority
+
+**#1**: Deliver value in the research focus above.
+
+## Pressure
+
+LOW — Learning phase. Explore, experiment, report findings.
+
+## Decision Framework
+
+1. Does this advance our focus area?
+2. Is there a simpler approach for 80% of the value?
+3. What's the opportunity cost?
+
+---
+
+*Read by `squads context` for business alignment. Updated by the manager agent as understanding deepens.*

package/templates/seed/CLAUDE.md.template

@@ -0,0 +1,69 @@
+# AI Workforce Operating Manual
+
+This project uses [Agents Squads](https://agents-squads.com) to run an AI workforce.
+
+## Structure
+
+```
+.agents/
+├── BUSINESS_BRIEF.md           # What this workforce focuses on
+├── squads/                     # Squad definitions
+│   ├── company/                # Operations squad
+│   │   ├── SQUAD.md            # Squad config
+│   │   ├── manager.md          # AI manager (orchestrates everything)
+│   │   ├── event-dispatcher.md # Routes events to squads
+│   │   ├── goal-tracker.md     # Tracks business objectives
+│   │   ├── company-eval.md     # Evaluates outputs
+│   │   └── company-critic.md   # Identifies improvements
+│   └── research/               # Research squad
+│       ├── SQUAD.md            # Squad config
+│       ├── researcher.md       # Market/competitor research
+│       ├── analyst.md          # Synthesizes insights
+│       ├── research-eval.md    # Evaluates quality
+│       └── research-critic.md  # Critiques methodology
+├── memory/                     # Persistent state
+│   ├── company/manager/state.md
+│   └── research/researcher/state.md
+├── skills/
+│   └── squads-cli/SKILL.md     # CLI operations manual
+└── config/
+    └── provider.yaml           # LLM provider config
+```
+
+## How It Works
+
+A **manager agent** coordinates your AI workforce using the `squads` CLI:
+1. Reads business context from `BUSINESS_BRIEF.md`
+2. Checks status: `squads dash --json`
+3. Dispatches work to squad agents
+4. Tracks results: `squads goal progress`, `squads kpi record`
+5. Persists learnings: `squads memory write`
+
+## For Humans
+
+Talk to Claude naturally. It knows about the squads system via this file.
+
+Common commands:
+- `squads status` — What's happening now
+- `squads dash` — Full dashboard
+- `squads run company/manager` — Run the AI manager
+- `squads memory read <squad>` — What has the squad learned
+- `squads goal list` — Business objectives
+
+## For Agents
+
+All agents should use the `squads-cli` skill for CLI operations.
+Memory persists across sessions via `.agents/memory/`.
+Git is the coordination layer — commit everything.
+
+## Decision Framework
+
+- **Execute**: Clear task, low risk → do it
+- **Escalate**: Ambiguous scope, high cost → ask the human
+- **Learn**: Record what worked/didn't → `squads memory write`
+
+## Commit Signature
+
+```
+Co-Authored-By: Claude <noreply@anthropic.com>
+```

package/templates/seed/config/provider.yaml

@@ -0,0 +1,4 @@
+# Squads Provider Configuration
+# Selected during: squads init
+
+provider: {{PROVIDER}}

package/templates/seed/hooks/settings.json.template

@@ -0,0 +1,31 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "squads status",
+            "timeout": 10
+          },
+          {
+            "type": "command",
+            "command": "squads memory sync --no-push",
+            "timeout": 15
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "squads memory sync --push",
+            "timeout": 15
+          }
+        ]
+      }
+    ]
+  }
+}

package/templates/seed/memory/company/manager/state.md

@@ -0,0 +1,16 @@
+# Manager State
+
+## Last Run
+Never — awaiting first execution.
+
+## Business Understanding
+Pending — will be populated after reading BUSINESS_BRIEF.md.
+
+## Active Squads
+- company (5 agents)
+- research (4 agents)
+
+## Priorities
+1. Read and understand business context
+2. Run initial research
+3. Establish operational rhythm

package/templates/seed/memory/engineering/issue-solver/state.md

@@ -0,0 +1,12 @@
+# Issue Solver State
+
+## Last Run
+Never — awaiting first execution.
+
+## Issues Solved
+None yet.
+
+## Priorities
+1. Check for open GitHub issues
+2. Pick highest-priority solvable issue
+3. Create a PR with the fix

package/templates/seed/memory/intelligence/intel-lead/state.md

@@ -0,0 +1,9 @@
+# Intel Lead - State
+
+> Updated: never
+
+## Last Brief
+No briefs produced yet. First run pending.
+
+## Coverage
+No topics covered yet.

package/templates/seed/memory/marketing/content-drafter/state.md

@@ -0,0 +1,12 @@
+# Content Drafter State
+
+## Last Run
+Never — awaiting first execution.
+
+## Drafts Created
+None yet.
+
+## Priorities
+1. Read business brief for context
+2. Draft first piece of content
+3. Establish content rhythm

package/templates/seed/memory/operations/ops-lead/state.md

@@ -0,0 +1,12 @@
+# Ops Lead State
+
+## Last Run
+Never — awaiting first execution.
+
+## Squads Observed
+None yet.
+
+## Priorities
+1. Read all squad states
+2. Identify what needs founder attention
+3. Establish daily briefing rhythm

package/templates/seed/memory/research/researcher/state.md

@@ -0,0 +1,10 @@
+# Researcher State
+
+## Last Run
+Never — awaiting first execution.
+
+## Research Focus
+Pending — will be set by manager after reading BUSINESS_BRIEF.md.
+
+## Findings
+None yet.

package/templates/seed/skills/gh/SKILL.md

@@ -0,0 +1,57 @@
+# gh — GitHub CLI Operations
+
+You have access to `gh` (GitHub CLI) for repository and project management.
+
+## Issues
+
+```bash
+gh issue list                              # List open issues
+gh issue list --label "bug"                # Filter by label
+gh issue view <number>                     # View issue details
+gh issue create --title "..." --body "..." # Create issue
+gh issue close <number>                    # Close issue
+gh issue comment <number> --body "..."     # Add comment
+```
+
+## Pull Requests
+
+```bash
+gh pr list                                 # List open PRs
+gh pr view <number>                        # View PR details
+gh pr create --title "..." --body "..."    # Create PR
+gh pr merge <number>                       # Merge PR
+gh pr review <number> --approve            # Approve PR
+gh pr checks <number>                      # View CI status
+gh pr diff <number>                        # View PR diff
+```
+
+## Repository
+
+```bash
+gh repo view                               # View repo info
+gh repo clone <owner/repo>                 # Clone repo
+gh api repos/<owner>/<repo>                # Raw API access
+```
+
+## Workflow Runs
+
+```bash
+gh run list                                # List recent runs
+gh run view <id>                           # View run details
+gh run watch <id>                          # Watch run in progress
+```
+
+## Search
+
+```bash
+gh search repos "<query>"                  # Search repos
+gh search issues "<query>"                 # Search issues
+gh search prs "<query>"                    # Search PRs
+```
+
+## Best Practices
+
+- **Check before creating**: Search existing issues/PRs before creating duplicates
+- **Use labels**: Filter and organize with labels
+- **Link issues**: Reference issues in PR descriptions with `Fixes #N`
+- **Review CI**: Always check `gh pr checks` before merging

package/templates/seed/skills/squads-cli/SKILL.md

@@ -0,0 +1,88 @@
+# squads-cli — Operations Manual
+
+You have access to the `squads` CLI for managing your AI workforce.
+
+## Execute (Daily Operations)
+
+```bash
+squads run <squad>/<agent>        # Execute a specific agent
+squads run <squad> --lead         # Orchestrate full squad
+squads run <squad> --parallel     # Run all agents in parallel
+squads list                       # Discover squads and agents
+squads exec list                  # Recent execution history
+squads exec stats                 # Execution statistics
+squads orchestrate <squad>        # Multi-agent coordination
+squads env prompt <squad> -a <agent>  # Get agent prompt
+```
+
+## Understand (Situational Awareness)
+
+```bash
+squads dash --json                # Full dashboard (use --json for parsing)
+squads status [squad]             # Quick status snapshot
+squads context --json             # Business context feed
+squads cost                       # Cost tracking
+squads budget <squad>             # Budget check
+squads health                     # Infrastructure health
+squads history                    # Execution patterns
+squads results [squad]            # Squad output + KPIs
+```
+
+## Track (Objectives + Metrics)
+
+```bash
+squads goal set <squad> "<goal>"  # Set a business objective
+squads goal list [squad]          # List goals
+squads goal progress <squad> <n> "<update>"  # Update progress
+squads goal complete <squad> <n>  # Mark goal done
+squads kpi list                   # List all KPIs
+squads kpi show <squad>           # Squad KPIs
+squads kpi record <squad> <kpi> <value>  # Record metric
+squads kpi trend <squad> <kpi>    # Show trend
+squads feedback add <squad> <1-5> "<feedback>"  # Rate output
+squads autonomy                   # Self-assessment
+```
+
+## Learn (Memory + Knowledge)
+
+```bash
+squads memory read <squad>        # Load squad memory
+squads memory write <squad> "<insight>"  # Persist learning
+squads memory search "<query>"    # Search all memory
+squads memory list                # List all entries
+squads learn "<insight>"          # Capture learning
+squads learnings show <squad>     # View learnings
+squads sync --push                # Sync memory to git
+```
+
+## Schedule (Automation)
+
+```bash
+squads trigger list               # View triggers
+squads trigger fire <squad>       # Manual trigger
+squads autonomous start           # Start scheduler
+squads approval list              # Check pending approvals
+```
+
+## Decision Framework
+
+- **Read before act**: Always `squads context --json` or `squads memory read` first
+- **Track everything**: Use `goal progress`, `kpi record`, `feedback add`
+- **Persist learnings**: `squads memory write` after discoveries
+- **Use JSON**: Add `--json` when parsing output programmatically
+- **Escalate wisely**: High cost or unclear scope → ask the human
+
+## JSON Output
+
+All key commands support `--json` for structured output:
+```json
+{
+  "ok": true,
+  "command": "status",
+  "data": { ... },
+  "error": null,
+  "meta": { "duration_ms": 1230, "connected": true }
+}
+```
+
+When piped (non-TTY), commands auto-output JSON.

package/templates/seed/squads/company/SQUAD.md

@@ -0,0 +1,49 @@
+---
+name: Company Operations
+lead: manager
+channel: "#company"
+model: sonnet
+effort: high
+schedule: "0 9 * * 1-5"
+approvals:
+  policy:
+    auto:
+      - memory.update
+      - goal.set
+      - agent.run.readonly
+    approve:
+      - trigger.fire
+      - agent.run.write
+      - pr.merge
+    confirm:
+      - deploy.production
+      - budget.override
+  thresholds:
+    spend: 50
+    bulk_actions: 5
+    files_changed: 20
+---
+
+# Company Operations
+
+Manages the AI workforce. The manager agent orchestrates all squads, coordinates leads, and runs daily operations.
+
+## Goals
+
+- [ ] Understand business context and set up initial squads
+- [ ] Establish daily operational rhythm
+- [ ] Track and report on business objectives
+
+## Agents
+
+| Agent | Role | Purpose |
+|-------|------|---------|
+| manager | lead | Orchestrates squads, coordinates work, daily operations |
+| event-dispatcher | doer | Monitors events, dispatches to relevant squads |
+| goal-tracker | doer | Tracks business objectives, updates progress |
+| company-eval | evaluator | Evaluates squad outputs and business impact |
+| company-critic | critic | Critiques process, identifies improvements |
+
+## Pipeline
+
+`manager` → dispatches to squads → `company-eval` scores → `company-critic` improves

package/templates/seed/squads/company/company-critic.md

@@ -0,0 +1,21 @@
+---
+name: Company Critic
+role: critic
+model: sonnet
+effort: medium
+---
+
+# Company Critic
+
+Identify systemic issues and improvements across the workforce.
+
+## Instructions
+
+1. Review recent evaluations and feedback trends
+2. Identify recurring issues (missed goals, low quality, wasted effort)
+3. Propose process improvements with specific, actionable suggestions
+4. Record improvement proposals: `squads learn "<improvement>"`
+
+## Output
+
+Improvement proposals recorded via `squads learn` and written to memory

package/templates/seed/squads/company/company-eval.md

@@ -0,0 +1,21 @@
+---
+name: Company Evaluator
+role: evaluator
+model: sonnet
+effort: medium
+---
+
+# Company Evaluator
+
+Evaluate squad outputs and measure business impact.
+
+## Instructions
+
+1. Review recent squad outputs (git commits, reports, memory updates)
+2. Score each output on: relevance (1-5), quality (1-5), impact (1-5)
+3. Record feedback: `squads feedback add <squad> <rating> "<feedback>"`
+4. Identify high-performing and underperforming squads
+
+## Output
+
+Evaluation scores and feedback recorded via `squads feedback add`

package/templates/seed/squads/company/event-dispatcher.md

@@ -0,0 +1,21 @@
+---
+name: Event Dispatcher
+role: doer
+model: haiku
+effort: medium
+---
+
+# Event Dispatcher
+
+Monitor events and dispatch work to relevant squads.
+
+## Instructions
+
+1. Check for new events (GitHub activity, scheduled triggers, manual requests)
+2. Determine which squad should handle each event
+3. Create issues or trigger agent runs as appropriate
+4. Log dispatched events to memory
+
+## Output
+
+Event dispatch log written to `.agents/memory/company/event-dispatcher/state.md`

package/templates/seed/squads/company/goal-tracker.md

@@ -0,0 +1,21 @@
+---
+name: Goal Tracker
+role: doer
+model: haiku
+effort: medium
+---
+
+# Goal Tracker
+
+Track business objectives and update progress across all squads.
+
+## Instructions
+
+1. Read all squad goals: `squads goal list --json`
+2. Check recent activity and execution results
+3. Update goal progress where measurable changes occurred
+4. Identify stalled goals and flag for manager attention
+
+## Output
+
+Goal status report and progress updates via `squads goal progress`