Timwood0x10/ARES

ARES is an AI agent runtime framework that provides a structured environment for building, managing, and observing autonomous agents. It exposes a public API and SDK for initializing agents, defining tools, and orchestrating complex workflows such as DAGs and multi-agent peer routing. The system supports advanced capabilities including adaptive knowledge integration, vector embedding via Ollama, and resilience through chaos engineering and evolution feedback loops. It is designed with a focus on observability, persistence, and strict governance through automated quality gates and comprehensive testing.

This change introduces the foundational repository structure and developer experience tooling for the ARES project. It adds configuration files for code formatting and linting (\.editorconfig\, \.golangci.yml\, \.pre-commit-config.yaml\), establishes repository metadata and standards (\.gitattributes\, \LICENSE\, \CITATION.cff\, \CODE\_OF\_CONDUCT.md\, \CONTRIBUTING.md\), and provides the initial architectural documentation (\ARCHITECTURE.md\), changelog (\CHANGELOG.md\), and build automation (\Makefile\, \Dockerfile.demo\).

(repo-wide) · high confidence

Added a suite of new example fixtures under examples/\_fixtures (01-quickstart through 08-mcp-integration) that demonstrate core ARES capabilities: basic agent usage, tool calling, DAG workflows, multi-agent peer routing, evolution, chaos resilience, human-in-loop governance, and MCP integration. Each fixture includes a YAML configuration file and a Go main.go that loads the config, creates a Runtime, registers tools or agents, and runs tasks, providing concrete learning objectives and expected outputs for users.

_examples/\_fixtures, examples/\internal · high confidence

Added three new shell scripts in the scripts/docker directory to streamline the local development environment. The up.sh script initializes the local dev stack by starting PostgreSQL with pgvector and Ollama, pulling a default model (llama3.2), and providing connection details. The restart.sh script handles a full service restart, including stopping containers, waiting for database readiness, and running both test and production database migrations. The stop.sh script provides a simple way to shut down the Docker services while preserving data.

scripts/docker · high confidence

A new embedding service has been added to the platform, providing vector embeddings for AI agent workflows. The service supports two backends: Ollama for local inference (defaulting to the qwen3-embedding:0.6b model) and sentence-transformers. It includes a Python FastAPI application for the primary service and a lightweight Go-based bridge (\bridge.go\) that forwards requests to Ollama's embedding API with bounded request body limits to prevent memory exhaustion. The service features Redis-based caching for embeddings, configurable text normalization, and is packaged with Dockerfiles and shell scripts for easy setup and management.

services · high confidence

Three new shell scripts are added to the repository to support development workflows and quality gates. check\_convergence\_freeze.sh enforces directory structure rules by comparing the examples/ and internal/ directories against a manifest, preventing unauthorized additions. g1\_reachability\_gate.sh ensures that all internal Go packages are reachable from production entrypoints (cmd/ares, sdk, services) or are explicitly whitelisted, failing if unreachable packages are detected. stop\_interview\_demo.sh provides a convenient way to stop the interview-demo application and its associated SearXNG container.

scripts · high confidence

The \api\ package now exposes a public entry point for the ARES agent runtime, re-exporting core types (Runtime, Agent, Task, Result), configuration options (LLM providers, memory, knowledge, MCP), and utilities (tool registry, context cleaner, quality gates) from the internal \sdk\ package. This allows external consumers to initialize the runtime, create agents, and manage tools without importing internal implementation details. The package also includes a deprecated alias for the embedding service to maintain backward compatibility for existing external users.

api · high confidence

The SDK now assembles its core component graph through the shared Bootstrap kernel, reusing the same EventStore, Evolution, and System Runtime instances as the serve and start paths instead of building a parallel runtime graph. This unification ensures consistent behavior across SDK and production entry points, with a fallback to legacy SDK wiring only when specific configurations (like SQLite knowledge stores) are not supported by Bootstrap. Additionally, the SDK now automatically registers AKF (Adaptive Knowledge Fabric) knowledge tools—such as build\_graph, compile\_context, query\_knowledge, and distill\_memory—into the agent's tool registry, enabling agents to interact with the knowledge graph during their ReAct loops. The SDK also retains its own KnowledgeRuntime instance to ensure live memory search capabilities are available to these tools, binding the Bootstrap evolution system to this instance for patch execution.

sdk · high confidence

Comprehensive test coverage for the ARES control-plane HTTP handler; Introduces peer-to-peer IPC bus with collaboration observability; New integration test suite for event-driven, persistence, and runtime subsystems.

The Go module has been renamed from 'styleagent' to 'github.com/Timwood0x10/ares', and the Go version requirement is set to 1.26.1. The dependency graph has been significantly updated, introducing OpenTelemetry observability (v1.45.0), Prometheus metrics (v1.24.1), the PostgreSQL driver (jackc/pgx v5.10.0), and the SQLite embedded database (modernc.org/sqlite v1.56.0). Additionally, the embedding service now includes a formal Python dependency manifest (pyproject.toml) specifying FastAPI, Pydantic, and optional support for sentence-transformers and Redis.

(dependencies) · high confidence

Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

• CAI 53 → 66 (+12.8)
• Rubric changed (rubric-2026.08.19 → rubric-2026.09.15) — scores are not directly comparable.

• Code Health 71 → 83 (+12.1)
• Architecture 100 → 96 (-3.5)
• Maturity 82 → 77 (-4.9)
• Readiness 63 → 82 (+18.8)
• Security 37 → 55 (+18.4)
• Domain Modelling 64 → 69 (+5.2)
• Event Sourcing 100 → 100 (+0.0)
• Accessibility 64 → 74 (+10.4)

• (anonymous) (cognitive 18) (internal/dashboard/static/app.js)
• (anonymous) (cognitive 18) (internal/monitoring/static/app.js)
• (anonymous) (cognitive 19) (internal/monitoring/static/app.js)
• (anonymous) (cognitive 35) (internal/monitoring/static/app.js)
• (anonymous) (cyclomatic 16) (internal/monitoring/static/app.js)
• (anonymous) (cyclomatic 21) (internal/dashboard/static/app.js)
• (anonymous) (cyclomatic 21) (internal/monitoring/static/app.js)
• (anonymous) (cyclomatic 33) (internal/monitoring/static/app.js)
• AdaptiveDistribution.normalizeBoundedLocked (cognitive 43) (internal/ares_evolution/mutation/adaptive_distribution.go)
• AdaptiveDistribution.normalizeBoundedLocked (cyclomatic 16) (internal/ares_evolution/mutation/adaptive_distribution.go)
• Agent.Run (cognitive 54) (sdk/sdk.go)
• Agent.Run (cyclomatic 24) (sdk/sdk.go)
• Agent.buildMessages (cognitive 22) (sdk/sdk.go)
• Agent.buildMessages (cyclomatic 17) (sdk/sdk.go)
• ArenaAdapter.Execute (cognitive 25) (internal/api_impl/adapters.go)
• ArenaAdapter.Execute (cyclomatic 24) (internal/api_impl/adapters.go)
• ConfigFile.Validate (cognitive 38) (sdk/config.go)
• ConfigFile.Validate (cyclomatic 25) (sdk/config.go)
• ConfigFile.setDefaults (cognitive 16) (api/client/config.go)
• ConfigFile.setDefaults (cyclomatic 19) (api/client/config.go)
• …and 618 more

• AdaptiveDistribution.normalizeBoundedLocked (cognitive 43) (internal/runtime/ares_evolution/mutation/adaptive_distribution.go)
• AdaptiveDistribution.normalizeBoundedLocked (cyclomatic 16) (internal/runtime/ares_evolution/mutation/adaptive_distribution.go)
• Agent.composePrompt (cognitive 24) (sdk/agent.go)
• Agent.composePrompt (cyclomatic 18) (sdk/agent.go)
• Boundary-crossing change coupling: kernel.go ↔ config.go (cmd/ares/kernel.go)
• CapabilitySelector.Select (cognitive 18) (internal/tools/toolsource/capability_selector.go)
• CapabilitySelector.Select (cyclomatic 16) (internal/tools/toolsource/capability_selector.go)
• ClassTooLong: MutableDAG (internal/fabric/task/workflow/engine/mutable_dag.go)
• ClassTooLong: Population (internal/runtime/ares_evolution/genome/population.go)
• ClassTooLong: Service (internal/runtime/ares_evolution/service/service.go)
• ClassTooLong: memoryManager (internal/runtime/memory/manager_impl.go)
• Collector.handleMemoryDistilled (cognitive 19) (internal/runtime/observability/flight/collector.go)
• Collector.processEvent (cognitive 26) (internal/runtime/observability/flight/collector.go)
• Collector.processEvent (cyclomatic 21) (internal/runtime/observability/flight/collector.go)
• CompactableEventStore.Read (cognitive 17) (internal/ares_events/compactable_store.go)
• CompileCoordinator.CompileDAG (cognitive 19) (internal/fabric/planprojection/coordinator.go)
• CompileCoordinator.SubscribeGraphEvents (cognitive 17) (internal/fabric/planprojection/coordinator.go)
• CompileCoordinator.applyReplaceNode (cognitive 17) (internal/fabric/planprojection/coordinator.go)
• ConfigFile.validateKnowledge (cognitive 19) (sdk/config.go)
• ConfigFile.validateKnowledge (cyclomatic 17) (sdk/config.go)
• …and 865 more

• 98 commits — 75 feature/other, 23 fixes

• cmd/ares — 23 commits
• (root) — 14 commits
• internal/ares_bootstrap — 8 commits
• internal/agents — 6 commits
• internal/ares_skills — 4 commits
• internal/aresrecovery — 3 commits
• internal/evolution — 3 commits
• api/service — 2 commits
• docs/articles — 2 commits
• docs/bug@ques — 2 commits
• examples/15-llm-evolution-suite — 2 commits
• examples/aresos-demo — 2 commits
• internal/agentfabric — 2 commits
• internal/ares_memory — 2 commits
• internal/llm — 2 commits
• (repo) — 1 commit
• analysis-reports/README.md — 1 commit
• analysis-reports/dead-code-disposal-plan.md — 1 commit
• docs/analysis-reports — 1 commit
• docs/zh — 1 commit

• fix: chore: Clean up unused code and fix the wiring order for the monitoring plugin.
• fix: chore: aggregate various fixes and improvements across codebase
• fix: fix : conflicts
• fix: fix conflicts
• fix: fix(agentfabric): Implements P3 resource management and fixes null pointer exceptions in the memory provider.
• fix: fix(archive): scope round files per stream to prevent cross-stream overwrite
• fix: fix(ares_arena): Use precise t-distribution calculation instead of approximate p-values.
• fix: fix(ares_bootstrap): fix issue where the graph executor failed to take effect during live-DAG updates
• fix: fix(ares_evolution): fix the issue where the GA cycle score improvement was always 0
• fix: fix(ares_skills): Optimize task pattern matching and limit storage length.
• fix: fix(bootstrap): fix context ignoring on shutdown timeout, null pointer, and configuration gating
• fix: fix(eval): fix missing dimension flags causing lost failing dimensions
• fix: fix(kernel): fix issue where task results were lost during callback
• fix: fix(llm): Fix issue where the circuit breaker failed to re-open after a probe in the half-open state failed.
• fix: fix(serve): fix critical defects and provide multiple runtime loops
• fix: fix: Clean up dummy implementations and dead code; fix experience retrieval wiring.
• fix: fix: Fixed multiple defects in evidence storage, selection sorting, and evidence collection.
• fix: fix: Fixed multiple issues related to concurrency safety, data integrity, and logic.
• fix: fix: Handle release failures and checkpoint installation errors to prevent silent drops.
• fix: fix: Resolve flaky E2E tests and synchronize subscription events.
• …and 78 more

Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

Timwood0x10/ARES was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.