Release v0.5.0

thrashr888 · claude · thrashr888 · commit ea43674ee440 · 2026-01-14T20:54:33.000-08:00
Major Features:
- Aiki Integration (Phases 1-3) for provenance linking
- Governance Epic: agent detection, policy framework, GitHub scanner, usage tracking
- TUI Contexts view with multi-org support
- ab onboard workflow for guided setup

Co-Authored-By: Claude Opus 4.5 &lt;noreply@anthropic.com&gt;
diff --git a/.claude-plugin/commands/agents.md b/.claude-plugin/commands/agents.md
@@ -0,0 +1,30 @@
+---
+description: Detect and track AI agent usage across repositories
+---
+
+Detect AI agents and track adoption metrics.
+
+Subcommands:
+- `allbeads agents detect` - Detect AI agents in current directory
+- `allbeads agents track --context <name> --path <path>` - Record scan to metrics
+- `allbeads agents stats` - View adoption statistics
+- `allbeads agents stats --days <n>` - Stats for specific time period
+- `allbeads agents stats --json` - Output as JSON
+
+Detects 14 AI agent types via config files:
+- Claude Code (CLAUDE.md, .claude/)
+- GitHub Copilot (.github/copilot-instructions.md)
+- Cursor (.cursorrules, .cursor/)
+- Aider (.aider.conf.yml)
+- Kiro (.kiro/)
+- And more...
+
+Detection confidence levels:
+- **High**: Primary config file found
+- **Medium**: Secondary indicators
+- **Low**: Indirect evidence
+
+Usage tracking stores metrics in SQLite for trend analysis:
+- Adoption rate over time
+- Agent distribution across repos
+- Scan history per repository
diff --git a/.claude-plugin/commands/governance.md b/.claude-plugin/commands/governance.md
@@ -0,0 +1,26 @@
+---
+description: Check and enforce governance policies for AI agent adoption
+---
+
+Manage governance policies for AI agent adoption across repositories.
+
+Subcommands:
+- `allbeads governance check` - Run policy checks against current repository
+- `allbeads governance status` - View loaded policies and exemptions
+- `allbeads governance violations` - List all policy violations
+- `allbeads governance exempt <repo> <policy> --reason "..."` - Exempt a repo
+- `allbeads governance unexempt <repo> <policy>` - Remove exemption
+
+Policy enforcement levels (HCP Terraform-inspired):
+- **Advisory**: Warn but don't block
+- **SoftMandatory**: Block unless exempted
+- **HardMandatory**: Always block, no exemptions
+
+Built-in policy checks:
+- `FileExists` - Required files (README, LICENSE, etc.)
+- `FileExistsAny` - At least one of several files
+- `OnboardingScore` - Minimum onboarding completeness
+- `AgentAllowlist` - Permitted/denied agent types
+- `PatternAbsent` - Ensure patterns don't exist in files
+
+Configure policies in `.beads/policies.yaml` or `~/.config/allbeads/policies.yaml`.
diff --git a/.claude-plugin/commands/scan.md b/.claude-plugin/commands/scan.md
@@ -0,0 +1,29 @@
+---
+description: Scan GitHub repositories for AI agent onboarding opportunities
+---
+
+Scan GitHub user or organization repositories to identify onboarding opportunities.
+
+Subcommands:
+- `allbeads scan user <username>` - Scan a user's repositories
+- `allbeads scan org <org-name>` - Scan an organization's repositories
+- `allbeads scan compare` - Compare scanned repos with managed contexts
+
+Options:
+- `--language <lang>` - Filter by programming language
+- `--min-stars <n>` - Minimum star count
+- `--include-archived` - Include archived repositories
+- `--include-forks` - Include forked repositories
+
+The scanner detects 14 AI agent types:
+- Claude Code, GitHub Copilot, Cursor, Aider, Kiro
+- OpenAI Codex, Google Gemini, Amazon CodeWhisperer
+- Tabnine, Codeium, Sourcegraph Cody, Replit AI
+- JetBrains AI, Windsurf
+
+Each repo is assigned an onboarding priority (High, Medium, Low, Skip) based on:
+- Number of stars and recent activity
+- Existing agent configurations
+- Language and project type
+
+Requires `GITHUB_TOKEN` environment variable for API access.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -7,6 +7,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.5.0] - 2026-01-14
+
 ### Added
 
 - **Aiki Integration (Phases 1-3)**: Foundation for linking AllBeads issues to Aiki provenance
@@ -25,7 +27,41 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
     - Support for review event types: `review_passed`, `review_failed`, `escalated`, `review_completed`
     - `ReviewIssue` structure with severity levels (info, warning, error, critical)
     - Aiki events displayed in TUI mail view with full detail
-  - Phase 4 (Future): Unified daemon deferred per SPEC-aiki-integration.md
+
+- **Governance Epic**: Complete governance framework for AI agent adoption
+  - **Agent Detection**: Detect 14 AI agent types in repositories
+    - Claude Code, GitHub Copilot, Cursor, Aider, Kiro, OpenAI Codex
+    - Google Gemini, Amazon CodeWhisperer, Tabnine, Codeium
+    - Sourcegraph Cody, Replit AI, JetBrains AI, Windsurf
+    - Detection via config files, directories, and marker files
+    - Confidence levels (High, Medium, Low) based on evidence
+  - **Repository Policy Framework**: HCP Terraform-inspired enforcement
+    - Enforcement levels: Advisory, SoftMandatory, HardMandatory
+    - Policy checks: FileExists, FileExistsAny, OnboardingScore, AgentAllowlist, PatternAbsent
+    - Exemption system with reason tracking
+    - `ab governance check/status/violations/exempt/unexempt` commands
+  - **GitHub Scanner**: Scan user/org repos for onboarding opportunities
+    - GitHub Search API for efficient cross-repo detection (~100x faster)
+    - Parallel batch processing with configurable concurrency
+    - Real-time progress output during scanning
+    - Onboarding priority scoring (High/Medium/Low/Skip)
+    - Compare scanned repos against managed contexts
+    - `ab scan user/org` commands
+  - **Usage Tracking**: SQLite-based adoption metrics
+    - Record agent detection history over time
+    - Usage stats with adoption rate calculations
+    - Daily trend aggregation
+    - `ab agents track/stats` commands
+
+- **TUI Contexts View**: Repository onboarding status dashboard
+  - Multi-organization support
+  - Real-time onboarding status per repository
+  - GitHub Actions workflow tracking
+
+- **Onboarding Workflow**: `ab onboard` command for guided setup
+  - Multi-stage workflow (detect → configure → verify)
+  - Agent-specific configuration generation
+  - Beads integration setup
 
 ### Changed
 
@@ -164,6 +200,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - `ab init --remote` for existing repositories
 - FederatedGraph for cross-repo dependency tracking
 
+[0.5.0]: https://github.com/thrashr888/AllBeads/compare/v0.4.0...v0.5.0
 [0.4.0]: https://github.com/thrashr888/AllBeads/compare/v0.3.1...v0.4.0
 [0.3.1]: https://github.com/thrashr888/AllBeads/compare/v0.3.0...v0.3.1
 [0.3.0]: https://github.com/thrashr888/AllBeads/compare/v0.2.0...v0.3.0
diff --git a/Cargo.lock b/Cargo.lock
diff --git a/Cargo.toml b/Cargo.toml
@@ -4,7 +4,7 @@ resolver = "2"
 
 [package]
 name = "allbeads"
-version = "0.4.0"
+version = "0.5.0"
 edition = "2021"
 authors = ["AllBeads Contributors"]
 license = "MIT"
diff --git a/README.md b/README.md
@@ -13,6 +13,7 @@ AllBeads implements the "Boss Repository" pattern - a control plane that:
 - **Visualizes cross-repo work** through a terminal-based dashboard
 - **Enables strategic coordination** between AI agents working across distributed codebases
 - **Provides agent-to-agent messaging** for distributed coordination
+- **Governs AI adoption** with policy enforcement, scanning, and onboarding workflows
 
 Think of it as a "meta-issue-tracker" that sits above your microservices, giving agents and architects a coherent view of work spanning 10, 20, or 50+ repositories.
 
@@ -55,6 +56,14 @@ External system adapters:
 - **GitHub**: GraphQL + REST API for issue management
 - **Plugin Architecture**: Extensible for Linear, Asana, etc.
 
+### 6. Governance Framework
+AI adoption management:
+- **Agent Detection**: Identifies 14 AI agent types (Claude, Copilot, Cursor, Aider, Kiro, etc.)
+- **Policy Engine**: HCP Terraform-inspired enforcement (Advisory, SoftMandatory, HardMandatory)
+- **GitHub Scanner**: Efficiently scan user/org repos for onboarding opportunities
+- **Usage Tracking**: SQLite-based metrics for adoption trends
+- **Onboarding Workflow**: Guided setup for new repositories
+
 See [DEMO.md](DEMO.md) for usage examples.
 
 ## Getting Started
@@ -313,6 +322,59 @@ allbeads agent sync
 
 # Preview agent configuration
 allbeads agent preview <agent>
+
+# Track agent usage (records scan to metrics DB)
+allbeads agents track --context mycontext --path /path/to/repo
+
+# View agent adoption statistics
+allbeads agents stats                    # Last 30 days
+allbeads agents stats --days 7           # Last 7 days
+allbeads agents stats --json             # JSON output
+```
+
+#### Governance
+
+```bash
+# Check policies against current repository
+allbeads governance check
+
+# View loaded policies and exemptions
+allbeads governance status
+
+# List policy violations
+allbeads governance violations
+
+# Exempt a repository from a policy
+allbeads governance exempt my-repo policy-name --reason "Legacy codebase"
+
+# Remove exemption
+allbeads governance unexempt my-repo policy-name
+```
+
+#### GitHub Scanning
+
+```bash
+# Scan your GitHub repositories for onboarding opportunities
+allbeads scan user <username>
+
+# Scan organization repositories
+allbeads scan org <org-name>
+
+# Filter by language, stars, or archived status
+allbeads scan user <username> --language rust --min-stars 10 --include-archived
+
+# Compare scanned repos with managed contexts
+allbeads scan compare
+```
+
+#### Onboarding
+
+```bash
+# Run guided onboarding workflow
+allbeads onboard
+
+# Onboard specific repository
+allbeads onboard /path/to/repo
 ```
 
 #### Sync
