No description
Find a file
Snider 4684ae725a feat(agent): go-store backing for dispatch state per RFC §15
Introduce an optional go-store persistence layer for the three state
groups described in RFC §15.3 — queue, concurrency, registry — plus
runtime_state and dispatch_history used by the sync pipeline.

- statestore.go lazily opens `.core/db.duckdb` via go-store when
  available; nil-safe helpers return cleanly so in-memory/file-based
  fallbacks survive when the store cannot open (graceful degradation,
  RFC §15.6)
- prep.go tracks the store reference on the subsystem and closes it on
  shutdown; hydrateWorkspaces now consults the registry group before
  the filesystem scan so ghost agents are marked failed across
  restarts, and TrackWorkspace mirrors updates back into the cache
- runtime_state.go persists backoff + fail-count snapshots into the
  go-store runtime group so dispatch backoff survives restarts even
  when the JSON file rotates
- commit.go writes the completed dispatch record into dispatch_history
  for RFC §16.3 sync push to drain without rescanning workspaces
- statestore_test.go covers lazy-once init, restore/delete round trip,
  ghost-agent failure marking, and runtime-state replay across
  subsystem instances

Co-Authored-By: Virgil <virgil@lethean.io>
2026-04-14 12:17:08 +01:00
.agents/skills feat: add Codex extension — agents, skills, rules, config 2026-03-22 06:20:59 +00:00
.claude-plugin feat: devops plugin, CLI commands, Codex dispatch fixes, AX sweep 2026-03-22 15:45:16 +00:00
.codex fix(dispatch): concurrency, queue runner, and path improvements 2026-03-29 20:40:20 +01:00
.core test(ax): add version example coverage 2026-03-30 18:13:30 +00:00
.github/workflows ci: add GitHub Actions workflow with Codecov 2026-03-21 13:53:57 +00:00
claude merge: integrate forge dispatch + mcp changes with AX compliance sweep 2026-04-13 09:39:41 +01:00
cmd/core-agent fix(agent): mcp.Register startup panic + test isolation + CLI test standard 2026-04-08 16:15:14 +01:00
codex refactor: AX compliance sweep — replace banned stdlib imports with core primitives 2026-04-13 09:32:00 +01:00
config feat(agent): unblock factory dispatch, runtime-aware containers, RFC gaps 2026-04-14 11:45:09 +01:00
docker refactor: AX compliance sweep — replace banned stdlib imports with core primitives 2026-04-13 09:32:00 +01:00
docs feat(agent): sync backoff + ledger + auto-flush loop 2026-04-14 12:06:04 +01:00
google refactor: AX compliance sweep — replace banned stdlib imports with core primitives 2026-04-13 09:32:00 +01:00
php refactor: AX compliance sweep — replace banned stdlib imports with core primitives 2026-04-13 09:32:00 +01:00
pkg feat(agent): go-store backing for dispatch state per RFC §15 2026-04-14 12:17:08 +01:00
scripts refactor: AX compliance sweep — replace banned stdlib imports with core primitives 2026-04-13 09:32:00 +01:00
tests feat(agent): unblock factory dispatch, runtime-aware containers, RFC gaps 2026-04-14 11:45:09 +01:00
ui refactor: AX compliance sweep — replace banned stdlib imports with core primitives 2026-04-13 09:32:00 +01:00
.DS_Store refactor: AX compliance sweep — replace banned stdlib imports with core primitives 2026-04-13 09:32:00 +01:00
.gitattributes feat: merge php-agentic into agent repo as src/php 2026-03-09 18:05:30 +00:00
.gitignore fix(ax): restore live agent reference paths 2026-03-29 20:24:58 +00:00
.mcp.json chore: add .mcp.json for Claude Code MCP integration 2026-03-17 18:35:29 +00:00
AGENTS.md fix(ax): remove proc.go wrapper layer 2026-03-30 15:48:21 +00:00
CLAUDE.md fix: CLAUDE.md stale module path — forge.lthn.ai → dappco.re/go/agent 2026-03-26 07:18:33 +00:00
CODEX.md fix(ax): remove proc.go wrapper layer 2026-03-30 15:48:21 +00:00
composer.json feat: merge php-agentic into agent repo as src/php 2026-03-09 18:05:30 +00:00
core-agent refactor: AX compliance sweep — replace banned stdlib imports with core primitives 2026-04-13 09:32:00 +01:00
core-agent.backup refactor: AX compliance sweep — replace banned stdlib imports with core primitives 2026-04-13 09:32:00 +01:00
go.mod feat(agent): go-store backing for dispatch state per RFC §15 2026-04-14 12:17:08 +01:00
go.sum feat(agent): go-store backing for dispatch state per RFC §15 2026-04-14 12:17:08 +01:00
llm.txt feat: add llm.txt — agent entry point for core/agent 2026-03-25 10:53:04 +00:00
Makefile fix(ax): move version injection to module root 2026-03-30 16:40:53 +00:00
README.md feat: add README and flesh out all plugins 2026-02-01 19:48:51 +00:00
repos.yaml feat: merge go-agent + go-agentic + php-devops into unified agent repo 2026-03-06 15:23:00 +00:00
setup.sh feat: merge go-agent + go-agentic + php-devops into unified agent repo 2026-03-06 15:23:00 +00:00
version.go fix(ax): remove remaining prose comments 2026-03-31 05:59:22 +00:00
version_example_test.go test(ax): add version example coverage 2026-03-30 18:13:30 +00:00

core-agent

A monorepo of Claude Code plugins for the Host UK federated monorepo.

Plugins

Plugin Description Commands
code Core development - hooks, scripts, data collection /code:remember, /code:yes
review Code review automation /review:review, /review:security, /review:pr
verify Work verification before commit/push /verify:verify, /verify:ready
qa Quality assurance fix loops /qa:qa, /qa:fix, /qa:check
ci CI/CD integration /ci:ci, /ci:workflow, /ci:fix

Installation

# Install all plugins via marketplace
claude plugin add host-uk/core-agent

# Or install individual plugins
claude plugin add host-uk/core-agent/claude/code
claude plugin add host-uk/core-agent/claude/review
claude plugin add host-uk/core-agent/claude/qa

Quick Start

# Code review staged changes
/review:review

# Run QA and fix all issues
/qa:qa

# Verify work is ready to commit
/verify:verify

# Check CI status
/ci:ci

Core CLI Integration

These plugins enforce the core CLI for development commands:

Instead of... Use...
go test core go test
go build core build
golangci-lint core go lint
composer test core php test
./vendor/bin/pint core php fmt

Plugin Details

code

The core plugin with hooks and data collection skills:

  • Hooks: Auto-format, debug detection, dangerous command blocking
  • Skills: Data collection for archiving OSS projects (whitepapers, forums, market data)
  • Commands: /code:remember (persist facts), /code:yes (auto-approve mode)

review

Code review automation:

  • /review:review - Review staged changes or commit range
  • /review:security - Security-focused review
  • /review:pr [number] - Review a pull request

verify

Work verification:

  • /verify:verify - Full verification (tests, lint, format, debug check)
  • /verify:ready - Quick check if ready to commit

qa

Quality assurance:

  • /qa:qa - Run QA pipeline, fix all issues iteratively
  • /qa:fix <issue> - Fix a specific issue
  • /qa:check - Check without fixing

ci

CI/CD integration:

  • /ci:ci - Check CI status
  • /ci:workflow <type> - Generate GitHub Actions workflow
  • /ci:fix - Analyse and fix failing CI

Development

Adding a new plugin

  1. Create claude/<name>/.claude-plugin/plugin.json
  2. Add commands to claude/<name>/commands/
  3. Add hooks to claude/<name>/hooks.json (optional)
  4. Register in .claude-plugin/marketplace.json

Testing locally

claude plugin add /path/to/core-agent

License

EUPL-1.2