Files
cleveragents-core/docs/adr
freemo 05310391c1
CI / benchmark-publish (pull_request) Has been skipped
CI / lint (pull_request) Successful in 14s
CI / build (pull_request) Successful in 15s
CI / quality (pull_request) Successful in 17s
CI / security (pull_request) Successful in 30s
CI / typecheck (pull_request) Successful in 33s
CI / integration_tests (pull_request) Successful in 2m46s
CI / unit_tests (pull_request) Successful in 12m45s
CI / docker (pull_request) Successful in 9s
CI / benchmark-regression (pull_request) Successful in 21m45s
CI / coverage (pull_request) Successful in 48m39s
CI / lint (push) Successful in 14s
CI / build (push) Successful in 14s
CI / quality (push) Successful in 15s
CI / security (push) Successful in 30s
CI / typecheck (push) Successful in 38s
CI / benchmark-regression (push) Has been skipped
CI / integration_tests (push) Successful in 2m44s
CI / benchmark-publish (push) Successful in 12m32s
CI / unit_tests (push) Successful in 12m43s
CI / docker (push) Successful in 38s
CI / coverage (push) Successful in 47m56s
docs(spec): add devcontainer integration and resource type inheritance
Created ADR-042 (Resource Type Inheritance) defining single-inheritance
`inherits` field on resource type definitions with field resolution,
collection merging, handler inheritance, polymorphic tool binding,
auto-discovery, and DAG query matching. Max depth 5, single inheritance.

Created ADR-043 (Devcontainer Integration) defining devcontainer-instance
as a subtype of container-instance with lazy activation lifecycle,
devcontainer.json parsing, three container-project association patterns
(auto-detect, explicit mount, clone-into), and execution environment
routing with a 6-level precedence chain.

Specification updates across 20+ sections:
- Glossary: Resource Type Inheritance, Devcontainer, Execution Environment
- Resource type YAML schema: `inherits` field with structure reference
- Handler, sandbox strategy, and coherence tables: devcontainer-instance
- Auto-discovery: devcontainer detection subsection with WBS diagram
- Tool capability metadata: structured environment subfields
- Technology stack: devcontainer CLI row
- Project model: execution environment subsection with YAML example
- CLI agents resource add: --mount, --clone-into flags + 4 new examples
- CLI agents plan use: --execution-environment, --execution-env-priority
- CLI agents project context set: same execution environment flags
- Command synopsis block: updated for all new flags
- Execution environment routing section with precedence table + algorithm
- Resource type YAML Example 6: Devcontainer Instance (inherited type)
- End-to-end Example 16: Devcontainer-Driven Development
- End-to-end Example 17: Explicit Container with Directory Mount
- End-to-end Example 18: Container with Remote Repo Clone

Also fixed ADR index: added missing ADR-036 through ADR-040 entries,
updated next ADR number to 044.

CONTRIBUTING.md fixes backported from sister project:
- Fixed State label capitalization (State/In Progress -> State/In progress,
  State/In Review -> State/In review) to match label definitions.
- Subtasks section: changed from optional to required, with exception
  clause for trivially simple issues.
- Parent links: updated to use Forgejo dependency system instead of
  textual references in issue descriptions.
- Fixed nox session flag typos: nox -e -> nox -s (7 occurrences).
- Replaced "Epics and Legendaries" section with comprehensive "Ticket
  Type Hierarchy" defining the three-tier hierarchy (Issue -> Epic ->
  Legendary) with formal criteria tables, cross-cutting rules for
  hierarchy enforcement, completion semantics, promotion/demotion, and
  milestone relationship rules.
- Fixed broken internal links referencing old "Epics and Legendaries"
  anchor to use "Ticket Type Hierarchy" (3 occurrences).
- Traceability example: replaced project-specific code reference with
  generic example.
- Removed stray horizontal rule before Project-Specific Guidelines.

ISSUES CLOSED: #491
2026-03-01 20:04:10 +00:00
..