attocode 0.1.8__tar.gz

attocode-0.1.8/.attocode/.mcp.json

@@ -0,0 +1,22 @@
+{
+  "mcpServers": {
+    "context7": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@upstash/context7-mcp@latest"
+      ],
+      "env": {}
+    },
+    "github": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@modelcontextprotocol/server-github"
+      ],
+      "env": {
+        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
+      }
+    }
+  }
+}

attocode-0.1.8/.attocode/mcp.json

@@ -0,0 +1,22 @@
+{
+  "servers": {
+    "context7": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@upstash/context7-mcp@latest"
+      ],
+      "env": {}
+    },
+    "github": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@modelcontextprotocol/server-github"
+      ],
+      "env": {
+        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
+      }
+    }
+  }
+}

attocode-0.1.8/.attocode/skills/swarm-verify/SKILL.md

@@ -0,0 +1,116 @@
+# /swarm-verify — Post-Run Trace Verification
+
+Verify the integrity of a hybrid swarm run by analysing its trace data.
+
+## Usage
+
+```
+/swarm-verify <run_dir>
+```
+
+Where `<run_dir>` is the path to a swarm run directory (e.g. `.agent/hybrid-swarm/run_abc123`).
+
+## Verification Procedure
+
+When invoked, follow these steps exactly:
+
+### Step 1 — Load Trace Data
+
+```python
+from tests.helpers.trace_verifier import TraceVerifier
+
+v = TraceVerifier("<run_dir>")
+```
+
+Report file counts:
+- Number of events in `swarm.events.jsonl`
+- Number of task files in `tasks/`
+- Current phase from `swarm.state.json`
+
+### Step 2 — Check for Poisoned Prompts
+
+```python
+result = v.assert_no_poisoned_prompts()
+```
+
+Poisoned markers: `[TASK_DONE]`, `[TASK_FAILED]`, `[HEARTBEAT]`, `[CONTROL]`, `[EXIT]`
+
+These should never appear in raw `agent.event` messages — they indicate the agent is echoing or injecting control signals.
+
+### Step 3 — Validate Task State Machine
+
+```python
+result = v.assert_correct_task_transitions()
+```
+
+Every `task.transition` event must follow the canonical FSM defined in `attoswarm.coordinator.loop.TRANSITIONS`. Report any illegal transitions.
+
+### Step 4 — Check Terminal Events
+
+```python
+result = v.assert_all_tasks_have_terminal_events()
+```
+
+Every task that reached `done` should have matching `agent.task.exit` and `agent.task.classified` events.
+
+### Step 5 — Check for Stuck Agents
+
+```python
+result = v.assert_no_stuck_agents()
+```
+
+No heartbeat gap > 30s between consecutive `agent.event` entries for the same agent.
+
+### Step 6 — Verify Budget Limits
+
+```python
+result = v.assert_budget_within_limits()
+```
+
+`tokens_used <= tokens_max` and `cost_used <= cost_max`.
+
+### Step 7 — Check Exit Code Propagation
+
+```python
+result = v.assert_exit_codes_propagated()
+```
+
+No tasks left in `running` status when the assigned agent has a non-null exit code.
+
+### Step 8 — Verify Coding Task Output
+
+```python
+result = v.assert_coding_tasks_produced_output()
+```
+
+Implement/test/integrate tasks that reached `done` should show evidence of file operations.
+
+### Step 9 — Run Screenshot Comparison (Optional)
+
+If baselines exist in `tests/snapshots/test_attoswarm_snapshots/`, optionally run:
+
+```bash
+.venv/bin/python -m pytest tests/unit/tui/test_attoswarm_snapshots.py -v
+```
+
+### Step 10 — Print Summary
+
+```python
+print(v.summary())
+```
+
+Format as a table showing each check with PASS/FAIL status and details.
+
+## Quick Run-All
+
+For a one-shot summary:
+
+```python
+from tests.helpers.trace_verifier import TraceVerifier
+print(TraceVerifier("<run_dir>").summary())
+```
+
+## Exit Criteria
+
+- All 7 checks pass: run is verified clean
+- Any check fails: report violations and suggest remediation

attocode-0.1.8/.attocode/swarm.hybrid.yaml.example

@@ -0,0 +1,72 @@
+version: 1
+run:
+  name: hybrid-demo
+  working_dir: .
+  run_dir: .agent/hybrid-swarm
+  poll_interval_ms: 250
+  max_runtime_seconds: 180
+
+roles:
+  - role_id: orchestrator
+    role_type: orchestrator
+    backend: claude
+    model: claude-opus-4-6
+    count: 1
+    write_access: false
+    workspace_mode: shared_ro
+    task_kinds: [analysis, planning]
+
+  - role_id: implementer
+    role_type: worker
+    backend: codex
+    model: o3
+    count: 2
+    write_access: true
+    workspace_mode: worktree
+    task_kinds: [implement, refactor, test]
+
+  - role_id: judge
+    role_type: judge
+    backend: aider
+    model: sonnet
+    count: 2
+    write_access: false
+    workspace_mode: shared_ro
+    task_kinds: [review, judge]
+
+  - role_id: researcher
+    role_type: researcher
+    backend: attocode
+    model: claude-sonnet-4-20250514
+    count: 1
+    write_access: false
+    workspace_mode: shared_ro
+    task_kinds: [research, analysis]
+
+  - role_id: merger
+    role_type: merger
+    backend: codex
+    model: o3
+    count: 1
+    write_access: true
+    workspace_mode: worktree
+    task_kinds: [merge, synthesize]
+
+budget:
+  max_tokens: 6000000
+  max_cost_usd: 30
+  reserve_ratio: 0.15
+  chars_per_token_fallback: 4.0
+
+merge:
+  authority_role: merger
+  judge_roles: [judge]
+  quality_threshold: 0.75
+  judge_policy: quorum
+  auto_apply_non_conflicting: true
+
+watchdog:
+  heartbeat_timeout_seconds: 45
+
+retries:
+  max_task_attempts: 2

attocode-0.1.8/.attocode/swarm.yaml.example

@@ -0,0 +1,42 @@
+# Attocode Swarm Configuration -- 2 Claude Workers
+# Copy to .attocode/swarm.yaml to use
+#
+# See docs/swarm-guide.md for a full walkthrough.
+
+# Orchestrator model (coordinates decomposition, wave review, synthesis)
+models:
+  orchestrator: anthropic/claude-sonnet-4-20250514
+
+# Worker definitions
+workers:
+  - name: coder
+    model: anthropic/claude-sonnet-4-20250514
+    capabilities: [code, test, refactor]
+    count: 1
+
+  - name: reviewer
+    model: anthropic/claude-sonnet-4-20250514
+    capabilities: [review, research]
+    count: 1
+
+# Budget limits
+budget:
+  totalTokens: 5000000       # 5M tokens across all workers + orchestrator
+  maxCost: 10.0              # Maximum spend in USD
+  maxConcurrency: 2          # Maximum workers running in parallel
+
+# Quality gates (score each task output 1-5, reject below threshold)
+quality:
+  enabled: true
+  # threshold: 3             # Minimum quality score (1-5)
+
+# Feature flags
+features:
+  planning: true             # LLM-assisted task decomposition
+  verification: true         # Run integration checks after all waves
+
+# Retry settings
+# retries:
+#   workerRetries: 2         # Max retries per task
+#   rateLimitRetries: 3      # Max retries on rate limit
+#   enableModelFailover: true