cleveragents/cleveragents-core
4
0
Fork 3
Code Issues 6.0k Pull Requests 115 Actions Packages Projects Releases Wiki Activity

docs(spec): add Milestone Plan navigation section #8195

Closed
HAL9000 wants to merge 8 commits from docs/milestone-plan-navigation into master
pull from: docs/milestone-plan-navigation
merge into: cleveragents:master
Conversation 18 Commits 8 Files Changed 5
+220 -1

8 Commits

Author SHA1 Message Date
HAL9000 0376538ffc fix(spec): add dedicated v3.8.0 heading to resolve BDD test assertion
CI / benchmark-publish (pull_request) Has been skipped
Details
CI / lint (pull_request) Failing after 47s
Details
CI / build (pull_request) Successful in 35s
Details
CI / push-validation (pull_request) Successful in 26s
Details
CI / quality (pull_request) Successful in 1m17s
Details
CI / helm (pull_request) Successful in 45s
Details
CI / typecheck (pull_request) Successful in 1m32s
Details
CI / security (pull_request) Successful in 1m31s
Details
CI / coverage (pull_request) Has been skipped
Details
CI / benchmark-regression (pull_request) Has been skipped
Details
CI / e2e_tests (pull_request) Successful in 3m43s
Details
CI / integration_tests (pull_request) Successful in 5m3s
Details
CI / unit_tests (pull_request) Successful in 7m9s
Details
CI / docker (pull_request) Has been skipped
Details
CI / status-check (pull_request) Failing after 4s
Details 
The Behave scenario asserts '### v3.8.0 — Server Mode + Cloud Integration'
but no such heading existed in the spec (only a navigation table row).

This adds a full milestone section mirroring v3.2.0–v3.7.0 format:
- Goal, Spec Coverage, Key ADRs
- Deliverables table with 12 items
- Key Architectural Constraints
- Definition of Done

Closes #8195 (fixing root cause of CI unit_tests failure)

ISSUES CLOSED: #8195
 2026-05-09 14:58:36 +00:00
HAL9000 bd4072c6cf fix(spec): resolve AmbiguousStep conflict in milestone navigation BDD tests
CI / benchmark-publish (pull_request) Has been skipped
Details
CI / helm (pull_request) Successful in 34s
Details
CI / build (pull_request) Successful in 44s
Details
CI / push-validation (pull_request) Successful in 29s
Details
CI / quality (pull_request) Successful in 1m6s
Details
CI / lint (pull_request) Failing after 1m8s
Details
CI / typecheck (pull_request) Successful in 1m18s
Details
CI / security (pull_request) Successful in 1m27s
Details
CI / coverage (pull_request) Has been skipped
Details
CI / benchmark-regression (pull_request) Has been skipped
Details
CI / e2e_tests (pull_request) Successful in 3m29s
Details
CI / integration_tests (pull_request) Failing after 4m7s
Details
CI / unit_tests (pull_request) Failing after 6m35s
Details
CI / docker (pull_request) Has been skipped
Details
CI / status-check (pull_request) Failing after 3s
Details 
Rename generic step 'the content should contain' to 'the spec should
contain' in the milestone plan navigation feature file and add the
corresponding step definition in milestone_plan_navigation_steps.py.

The previous fix removed the duplicate step definition from
milestone_plan_navigation_steps.py, but left the feature file using
the step from uko_ontology_registry_steps.py which reads from
context.ontology_ttl_content instead of context.spec_content. This
caused all milestone navigation scenarios to fail with an
AttributeError at runtime.

The new 'the spec should contain' step reads from context.spec_content
and is unique to the milestone navigation step file, eliminating the
AmbiguousStep conflict entirely.

ISSUES CLOSED: #7564
 2026-05-05 16:10:21 +00:00
HAL9000 a3d410618a fix: remove duplicate step definition and restore CONTRIBUTORS.md entries
CI / benchmark-publish (pull_request) Has been skipped
Details
CI / lint (pull_request) Successful in 1m13s
Details
CI / quality (pull_request) Successful in 1m0s
Details
CI / security (pull_request) Successful in 1m26s
Details
CI / typecheck (pull_request) Successful in 1m24s
Details
CI / helm (pull_request) Successful in 33s
Details
CI / push-validation (pull_request) Successful in 32s
Details
CI / build (pull_request) Successful in 39s
Details
CI / e2e_tests (pull_request) Successful in 3m39s
Details
CI / integration_tests (pull_request) Successful in 7m2s
Details
CI / unit_tests (pull_request) Failing after 8m55s
Details
CI / docker (pull_request) Has been skipped
Details
CI / coverage (pull_request) Successful in 11m21s
Details
CI / status-check (pull_request) Failing after 2s
Details
CI / benchmark-regression (pull_request) Failing after 1h3m48s
Details 
- Remove duplicate @then('the content should contain "{text}"') step from milestone_plan_navigation_steps.py — this step already exists in uko_ontology_registry_steps.py and caused AmbiguousStep errors in Behave (unit_tests CI failure)

- Restore HAL 9000 contribution entries that were accidentally removed from CONTRIBUTORS.md in a prior commit

- Add new CONTRIBUTORS.md entry for the Milestone Plan Navigation section (PR #8195 / issue #7564)
 2026-05-02 21:20:41 +00:00
HAL9000 ee39b33700 fix: add missing step definition for generic content contains assertion
CI / lint (pull_request) Failing after 25s
Details
CI / typecheck (pull_request) Successful in 1m13s
Details
CI / security (pull_request) Successful in 54s
Details
CI / quality (pull_request) Successful in 30s
Details
CI / coverage (pull_request) Has been skipped
Details
CI / build (pull_request) Successful in 24s
Details
CI / helm (pull_request) Successful in 35s
Details
CI / e2e_tests (pull_request) Successful in 3m37s
Details
CI / push-validation (pull_request) Successful in 22s
Details
CI / unit_tests (pull_request) Failing after 6m37s
Details
CI / docker (pull_request) Has been skipped
Details
CI / integration_tests (pull_request) Successful in 9m29s
Details
CI / status-check (pull_request) Failing after 1s
Details
CI / benchmark-publish (pull_request) Has been skipped
Details
CI / benchmark-regression (pull_request) Has been skipped
Details
2026-04-17 08:15:47 +00:00
HAL9000 9549897ef3 fix: remove update_spec.py utility script from repository
CI / lint (pull_request) Successful in 17s
Details
CI / typecheck (pull_request) Successful in 32s
Details
CI / security (pull_request) Successful in 33s
Details
CI / unit_tests (pull_request) Has been cancelled
Details
CI / e2e_tests (pull_request) Has been cancelled
Details
CI / integration_tests (pull_request) Has been cancelled
Details
CI / build (pull_request) Has been cancelled
Details
CI / benchmark-regression (pull_request) Has been cancelled
Details
CI / benchmark-publish (pull_request) Has been cancelled
Details
CI / docker (pull_request) Has been cancelled
Details
CI / helm (pull_request) Has been cancelled
Details
CI / push-validation (pull_request) Has been cancelled
Details
CI / status-check (pull_request) Has been cancelled
Details
CI / quality (pull_request) Has been cancelled
Details
CI / coverage (pull_request) Has been cancelled
Details
2026-04-17 07:22:05 +00:00
HAL9000 b3547e7692 fix: resolve lint and duplicate step definition issues in milestone plan navigation tests
CI / benchmark-publish (pull_request) Has been skipped
Details
CI / build (pull_request) Successful in 22s
Details
CI / lint (pull_request) Successful in 25s
Details
CI / push-validation (pull_request) Successful in 27s
Details
CI / helm (pull_request) Successful in 27s
Details
CI / quality (pull_request) Successful in 39s
Details
CI / typecheck (pull_request) Successful in 54s
Details
CI / security (pull_request) Successful in 56s
Details
CI / e2e_tests (pull_request) Successful in 4m3s
Details
CI / integration_tests (pull_request) Successful in 4m6s
Details
CI / unit_tests (pull_request) Failing after 5m39s
Details
CI / docker (pull_request) Has been skipped
Details
CI / coverage (pull_request) Successful in 12m35s
Details
CI / status-check (pull_request) Failing after 1s
Details
CI / benchmark-regression (pull_request) Successful in 57m27s
Details 
- Fix import ordering: move pathlib before typing, add blank line before third-party imports
- Remove unnecessary 'r' mode argument from open() call (defaults to read mode)
- Remove duplicate step definition for 'the content should contain' that already exists in uko_ontology_registry_steps.py
- Keep only unique step definitions specific to milestone plan navigation

This resolves the CI failures:
- ruff I001 import block unsorted error
- ruff UP015 unnecessary mode argument error
- behave AmbiguousStep duplicate step definition error
 2026-04-14 22:40:11 +00:00
HAL9000 1aa0c2a499 fix(spec): align Behave test expectation with specification text
CI / benchmark-publish (pull_request) Has been skipped
Details
CI / lint (pull_request) Failing after 30s
Details
CI / security (pull_request) Successful in 52s
Details
CI / typecheck (pull_request) Successful in 1m2s
Details
CI / quality (pull_request) Successful in 45s
Details
CI / coverage (pull_request) Has been skipped
Details
CI / benchmark-regression (pull_request) Has been skipped
Details
CI / build (pull_request) Successful in 18s
Details
CI / helm (pull_request) Successful in 29s
Details
CI / push-validation (pull_request) Successful in 25s
Details
CI / e2e_tests (pull_request) Successful in 3m32s
Details
CI / integration_tests (pull_request) Successful in 5m10s
Details
CI / unit_tests (pull_request) Failing after 8m16s
Details
CI / docker (pull_request) Has been skipped
Details
CI / status-check (pull_request) Failing after 2s
Details 
The test was expecting 'Milestone Plan Navigation section provides a quick reference'
but the specification contains 'This navigation section provides a quick reference'.
Updated the test to match the actual specification content.
 2026-04-14 05:45:12 +00:00
HAL9000 a3b01ef785 docs(spec): add Milestone Plan navigation section
CI / push-validation (pull_request) Successful in 18s
Details
CI / helm (pull_request) Successful in 23s
Details
CI / build (pull_request) Successful in 24s
Details
CI / lint (pull_request) Failing after 39s
Details
CI / security (pull_request) Successful in 54s
Details
CI / typecheck (pull_request) Successful in 1m16s
Details
CI / quality (pull_request) Successful in 3m39s
Details
CI / coverage (pull_request) Has been skipped
Details
CI / unit_tests (pull_request) Failing after 4m0s
Details
CI / docker (pull_request) Has been skipped
Details
CI / e2e_tests (pull_request) Successful in 4m25s
Details
CI / integration_tests (pull_request) Successful in 4m38s
Details
CI / status-check (pull_request) Failing after 1s
Details
CI / benchmark-publish (pull_request) Has been skipped
Details
CI / benchmark-regression (pull_request) Has been skipped
Details 
Add comprehensive Milestone Plan Navigation section to specification mapping
milestones v3.2.0 through v3.8.0 to their key architectural features and
specification coverage areas. Includes Navigation by Feature index for
cross-milestone lookups. Extends milestone coverage to v3.8.0 (Server Mode +
Cloud Integration). Improves specification navigability.

Also add BDD test suite to verify Milestone Plan Navigation documentation
exists and is properly formatted.

ISSUES CLOSED: #7564
 2026-04-13 04:24:01 +00:00