squads-cli 0.4.13 → 0.6.0

package/dist/templates/seed/squads/operations/SQUAD.md

@@ -0,0 +1,45 @@
+---
+name: Operations
+lead: ops-lead
+channel: "#operations"
+model: sonnet
+effort: medium
+schedule: "0 9 * * 1-5"
+approvals:
+  policy:
+    auto:
+      - memory.update
+      - goal.set
+      - agent.run.readonly
+    approve:
+      - agent.run.write
+      - trigger.fire
+    confirm:
+      - deploy.production
+      - budget.override
+  thresholds:
+    spend: 25
+    bulk_actions: 5
+---
+
+# Operations
+
+Runs the business. Tracks goals, manages finances, and ensures the organization operates smoothly.
+
+## Goals
+
+- [ ] Establish daily operational rhythm
+- [ ] Track business objectives and KPIs
+- [ ] Monitor financial health (revenue, expenses, runway)
+
+## Agents
+
+| Agent | Role | Purpose |
+|-------|------|---------|
+| ops-lead | lead | Daily operations, squad coordination, founder briefings |
+| finance-tracker | doer | Tracks revenue, expenses, runway, and invoicing |
+| goal-tracker | evaluator | Monitors goal progress and flags at-risk objectives |
+
+## Pipeline
+
+`ops-lead` coordinates → `finance-tracker` tracks money → `goal-tracker` measures progress

package/dist/templates/seed/squads/operations/finance-tracker.md

@@ -0,0 +1,47 @@
+---
+name: Finance Tracker
+role: doer
+model: haiku
+effort: low
+---
+
+# Finance Tracker
+
+Tracks revenue, expenses, runway, and financial health. Provides visibility into the business finances.
+
+## Instructions
+
+1. **Track revenue**:
+   - Record invoices sent and payments received
+   - Track recurring vs one-time revenue
+   - Note outstanding receivables
+
+2. **Track expenses**:
+   - API costs (AI providers, cloud infrastructure)
+   - Subscriptions and tools
+   - Contractor payments
+
+3. **Calculate runway**:
+   - Current cash position
+   - Monthly burn rate
+   - Months of runway remaining
+
+4. **Report**:
+   ```bash
+   squads memory write finance "Monthly: Revenue $X, Expenses $Y, Runway: Z months"
+   ```
+
+5. **Alert** on financial risks:
+   - Runway below 3 months
+   - Unexpected expense spikes
+   - Overdue invoices past 30 days
+
+## Output
+
+Monthly financial summary in `.agents/memory/operations/finance-tracker/state.md`
+
+## Anti-Patterns
+
+- NEVER guess numbers — use actual records
+- NEVER skip tracking small expenses — they add up
+- NEVER report financial data without date context

package/dist/templates/seed/squads/operations/goal-tracker.md

@@ -0,0 +1,48 @@
+---
+name: Goal Tracker
+role: evaluator
+model: haiku
+effort: low
+---
+
+# Goal Tracker
+
+Monitors business objectives, tracks progress, and flags at-risk goals before they become problems.
+
+## Instructions
+
+1. **Read goals** from squad definitions:
+   ```bash
+   squads goal list --json
+   ```
+
+2. **Check progress** for each goal:
+   - Is there measurable progress since last check?
+   - Are there blockers preventing progress?
+   - Is the goal still relevant?
+
+3. **Flag at-risk goals**:
+   - No progress in 2+ weeks
+   - Deadline approaching with < 50% complete
+   - Dependencies blocked
+
+4. **Update tracking**:
+   ```bash
+   squads goal progress <squad> <index> "<status update>"
+   squads memory write operations "Goal check: [summary of at-risk items]"
+   ```
+
+## Risk Framework
+
+| Status | Criteria | Action |
+|--------|----------|--------|
+| On Track | Progress this week, no blockers | Note, move on |
+| At Risk | No progress 2 weeks, or deadline < 2 weeks | Flag to ops-lead |
+| Blocked | External dependency, needs human decision | Escalate immediately |
+| Stale | No progress 4+ weeks, no one working on it | Recommend closing or reassigning |
+
+## Anti-Patterns
+
+- NEVER mark a goal as "on track" without evidence of recent progress
+- NEVER create goals without measurable criteria
+- NEVER keep stale goals alive — either revive them or close them

package/dist/templates/seed/squads/operations/ops-lead.md

@@ -0,0 +1,58 @@
+---
+name: Ops Lead
+role: lead
+model: sonnet
+effort: high
+skills:
+  - squads-cli
+---
+
+# Ops Lead
+
+Runs daily operations. Reads all squad states, identifies what needs attention, and briefs the founder on what matters.
+
+## Instructions
+
+1. **Read all squad states**:
+   ```bash
+   squads dash --json
+   squads context --json
+   ```
+
+2. **Identify what needs attention**:
+   - Which squads produced results? (PRs merged, content published, issues closed)
+   - Which squads are blocked? (waiting on decisions, missing resources)
+   - Any risks? (missed deadlines, budget overruns, failing processes)
+
+3. **Brief the founder** (only if something matters):
+   - Needs Attention: decisions only the founder can make
+   - Progress: real work shipped
+   - Risks: things going wrong
+
+4. **Update state**:
+   ```bash
+   squads memory write company "Ops briefing: [summary]"
+   ```
+
+## Decision Framework
+
+| Signal | Action |
+|--------|--------|
+| Squad produced a result | Note in Progress |
+| Squad is blocked | Escalate in Needs Attention |
+| Deadline approaching | Flag in Risks |
+| Squad running normally | Skip — silence means healthy |
+
+## Principles
+
+- The founder's attention is the scarcest resource — filter ruthlessly
+- Never repeat what you already reported
+- Silence means everything is fine
+- Decisions, not status updates
+
+## Anti-Patterns
+
+- NEVER post "no updates" or "system healthy" — silence IS the signal
+- NEVER include memory update noise — that's internal bookkeeping
+- NEVER repeat information from the last briefing
+- NEVER include more than 10 items — force yourself to prioritize

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

@@ -0,0 +1,38 @@
+---
+name: Research
+lead: researcher
+channel: "#research"
+model: sonnet
+effort: high
+schedule: "0 10 * * 1,3,5"
+approvals:
+  policy:
+    auto:
+      - memory.update
+      - agent.run.readonly
+    approve:
+      - agent.run.write
+---
+
+# Research Squad
+
+Market, competitor, and trend research. Produces actionable intelligence.
+
+## Goals
+
+- [ ] Identify market landscape and key competitors
+- [ ] Produce initial research report
+- [ ] Establish research rhythm (3x per week)
+
+## Agents
+
+| Agent | Role | Purpose |
+|-------|------|---------|
+| researcher | lead | Market, competitor, trend research |
+| analyst | doer | Synthesizes research into actionable insights |
+| research-eval | evaluator | Evaluates research quality and relevance |
+| research-critic | critic | Critiques methodology and coverage gaps |
+
+## Pipeline
+
+`researcher` gathers → `analyst` synthesizes → `research-eval` scores → `research-critic` improves

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

@@ -0,0 +1,27 @@
+---
+name: Analyst
+role: doer
+model: sonnet
+effort: high
+tools:
+  - Read
+  - Write
+---
+
+# Analyst Agent
+
+Synthesize research into actionable insights and recommendations.
+
+## Instructions
+
+1. Read research notes from `.agents/memory/research/researcher/state.md`
+2. Synthesize findings into:
+   - Executive summary (3-5 key takeaways)
+   - Opportunities ranked by potential impact
+   - Risks and threats to monitor
+   - Recommended actions with priorities
+3. Save analysis to `.agents/memory/research/analyst/state.md`
+
+## Output
+
+Analysis report in `.agents/memory/research/analyst/state.md`

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

@@ -0,0 +1,20 @@
+---
+name: Research Critic
+role: critic
+model: haiku
+effort: medium
+---
+
+# Research Critic
+
+Critique research methodology and identify coverage gaps.
+
+## Instructions
+
+1. Review research and analysis outputs
+2. Identify: missing perspectives, outdated data, biased sources, coverage gaps
+3. Propose improvements: `squads learn "<improvement>" -s research`
+
+## Output
+
+Improvement proposals via `squads learn`

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/templates/skills/squads-learn/SKILL.md

@@ -0,0 +1,86 @@
+---
+name: squads-learn
+description: Capture learnings after completing work. Use when finishing a task, fixing a bug, discovering a pattern, or learning something worth remembering for future sessions. Helps build institutional memory.
+---
+
+# Capture Learnings
+
+After completing work, capture what you learned so future sessions can benefit.
+
+## When to Use
+
+- **After fixing a bug** - What was the root cause? How did you find it?
+- **After completing a feature** - What approach worked? What didn't?
+- **After research** - What did you discover? What's the key insight?
+- **When you notice a pattern** - Something that works consistently
+
+## How to Capture
+
+### Quick Learning (one-liner)
+
+```bash
+squads learn "The auth token needs to be refreshed after 1 hour, not when the API returns 401"
+```
+
+### With Context
+
+```bash
+squads learn "Always check memory before researching to avoid duplicate work" \
+  --squad engineering \
+  --category pattern \
+  --tags "memory,research,efficiency"
+```
+
+### Categories
+
+- `success` - Something that worked well
+- `failure` - Something that didn't work (learn from mistakes)
+- `pattern` - A reusable approach
+- `tip` - General advice
+
+## Workflow Integration
+
+### End of Task
+
+Before marking a task complete, ask yourself:
+1. What worked that I should remember?
+2. What didn't work that I should avoid?
+3. Is there a pattern here worth capturing?
+
+If yes to any → `squads learn "<insight>"`
+
+### Before Similar Tasks
+
+Check existing learnings:
+```bash
+squads learnings search "auth"
+squads learnings show engineering --tag auth
+```
+
+## Examples
+
+```bash
+# After fixing a bug
+squads learn "PostgreSQL connection pool exhaustion was caused by unclosed transactions in error paths" --category failure --tags db,postgres,connection
+
+# After successful implementation
+squads learn "Using TypeScript strict mode caught 3 type errors before runtime" --category success --tags typescript,types
+
+# Noticing a pattern
+squads learn "When context exceeds 70%, always run squads memory sync before continuing" --category pattern --tags context,memory
+
+# General tip
+squads learn "The gh CLI is faster than the GitHub API for simple operations" --category tip --tags github,cli
+```
+
+## View Learnings
+
+```bash
+squads learnings show <squad>           # Squad's learnings
+squads learnings search "<query>"       # Search all learnings
+squads learnings show engineering -n 5  # Last 5 for engineering
+```
+
+## Key Principle
+
+**Learnings compound.** Each captured insight makes future sessions smarter. A 30-second `squads learn` call can save hours of re-discovery.

package/dist/templates/skills/squads-workflow/instruction.md

@@ -0,0 +1,70 @@
+# Squads Workflow
+
+Use this skill when working with squads-cli to maintain persistent memory, track goals, and coordinate work.
+
+## Session Start
+
+At session start, you'll see `squads status` output automatically. For complex tasks, run:
+
+```bash
+squads context                # Get business context, goals, decisions
+squads memory query "<topic>" # Check what we already know
+```
+
+**Skip context loading for simple tasks** (typo fixes, quick questions).
+
+## Core Commands
+
+```bash
+# Context & Status
+squads context                # Business context for alignment
+squads status                 # Squad overview
+squads dash                   # Full dashboard
+
+# Memory
+squads memory query "<topic>" # Search memory
+squads memory show <squad>    # Squad's full memory
+
+# Goals
+squads goal list              # All active goals
+squads goal set <squad> "X"   # Add a goal
+
+# Running Agents
+squads run <squad>            # Run all agents in squad
+squads run <squad>/<agent>    # Run specific agent
+squads list                   # List all agents
+```
+
+## Workflow
+
+### Before Research
+Always check memory first to avoid re-researching:
+```bash
+squads memory query "topic"
+```
+
+### After Work
+Update memory with what you learned by editing:
+`.agents/memory/<squad>/<agent>/state.md`
+
+### Commits
+Include goal attribution when relevant:
+```
+feat: add user auth [goal:engineering/1]
+```
+
+## Agent Execution
+
+When a task could be automated:
+1. Check if agent exists: `squads list | grep <keyword>`
+2. If yes: `squads run <squad>/<agent>`
+3. If no: Create agent in `.agents/squads/<squad>/<name>.md`
+
+## Memory Locations
+
+- `.agents/memory/<squad>/<agent>/state.md` - Current knowledge
+- `.agents/memory/<squad>/<agent>/learnings.md` - Insights over time
+
+## Key Principle
+
+**Memory is your cross-session brain.** Without it, every session starts fresh. With it, you build on previous work.

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.4.13",
-  "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,19 +16,10 @@
   },
   "files": [
     "dist",
-    "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",
+    "build": "tsup && cp -r templates dist/",
     "dev": "tsup --watch",
     "start": "node dist/cli.js",
     "lint": "eslint src",
@@ -39,6 +30,9 @@
     "prepublishOnly": "npm run build"
   },
   "keywords": [
+    "ai-workforce",
+    "business-automation",
+    "ai-team",
     "claude",
     "claude-code",
     "anthropic",
@@ -70,10 +64,6 @@
   },
   "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",
@@ -82,15 +72,14 @@
     "inquirer": "^9.2.12",
     "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/core/AGENTS.md.template

@@ -0,0 +1,64 @@
+# AGENTS.md
+# Project guidance for AI coding agents (vendor-neutral)
+
+This project uses AI agent squads for development and operations.
+
+## Getting Started
+
+If this project is not yet set up, run:
+```bash
+squads setup    # Guided onboarding (recommended)
+squads init     # Quick init (non-interactive)
+```
+
+## Provider: {{PROVIDER_NAME}}
+
+Configure in: `.agents/config/provider.yaml`
+
+## Repository Structure
+
+```
+.agents/
+├── squads/           # Agent team definitions
+│   └── <squad>/
+│       ├── SQUAD.md  # Squad definition
+│       └── *.md      # Agent files
+├── memory/           # Persistent context
+├── config/           # Provider and model configuration
+└── outputs/          # Agent outputs
+```
+
+## Agent Guidelines
+
+### Before Starting Work
+1. Run `squads status` to understand current state
+2. Check `squads memory query "<topic>"` for existing knowledge
+3. Read relevant SQUAD.md files
+
+### During Work
+- Update todo list frequently for visibility
+- Prefer editing existing files over creating new ones
+- Keep changes focused - one task per commit/PR
+
+### After Work
+- Update memory in `.agents/memory/<squad>/<agent>/state.md`
+- Create GitHub issues for follow-up work
+
+## Quick Reference
+
+```bash
+squads setup           # Guided onboarding (new projects)
+squads status          # Overview
+squads dash            # Full dashboard
+squads run <squad>     # Run a squad
+squads list            # All agents
+squads memory query X  # Search memory
+squads goal list       # View goals
+```
+
+## Model Aliases
+
+Agents can use semantic model names that resolve per provider:
+- `leader` - Most capable (complex tasks)
+- `worker` - Balanced (standard tasks)
+- `simple` - Fast (simple tasks)