v 0.2 refactor (breaking changes)#56

Closed

monkeypants wants to merge 233 commits into

docs_architecture_domain

Commits on Dec 19, 2025

stub out doman model
Chris Gough
committed
create first-draft c4 module
Chris Gough
committed
fix: format code with black and fix ruff warnings
Chris Gough
committed
add tool annotations to HCD and C4 MCP servers
Chris Gough
committed
add pagination and response format to MCP list/get operations
Chris Gough
committed
MCP servers: add response models and enhanced error handling
Chris Gough
committed
Add MCP server CLI entry points and fix missing module exports
Chris Gough
committed
fix rst serialisation
Chris Gough
committed
lint
Chris Gough
committed
lint that one thing, grr
Chris Gough
committed

Commits on Dec 20, 2025

Add missing mcp dependency to fix CI test collection
Chris Gough
committed
Add RST repository backend with docutils parsing and Jinja2 templates
Chris Gough
committed
Add story migration script for Gherkin to RST conversion
Chris Gough
committed
lint (sigh)
Chris Gough
committed
and the other lint (deeper sigh)
Chris Gough
committed
Refine ADR 003: story lifecycle, document-first vs code-first entities
Chris Gough
committed
Add personas, reorganize docs/users with glob-based discovery
Chris Gough
committed
Add epics and accelerators, organize docs/domain
Chris Gough
committed
Add applications documentation and enable sphinx_hcd self-documentation
Chris Gough
committed
Add C4 architecture self-documentation for julee
Chris Gough
committed
Add define-persona and persona-index directives
Chris Gough
committed
Add enhancement proposal: C4 inference from clean architecture
Chris Gough
committed
Revise C4 inference proposal: unify HCD and C4 concepts
Chris Gough
committed
Add literate architecture idioms section to C4 proposal
Chris Gough
committed
Revise literate architecture: introspect existing types, no duplicative decorators
Chris Gough
committed
Refine literate architecture: decorators on implementations, not protocols
Chris Gough
committed

Commits on Dec 21, 2025

jiggle docs slightly more into domain-alignment
Chris Gough
committed
add dynamic system context diagram with HCD persona integration
Chris Gough
committed
start the screaming refactor
Chris Gough
committed
scream c4 too
Chris Gough
committed
refactor CEAP accelerator
Chris Gough
committed
push through the refactor
Chris Gough
committed
lint (again)
Chris Gough
committed
make c4 container diagram and page dynamic
Chris Gough
committed

Commits on Dec 22, 2025

fix doc build errors
Chris Gough
committed
lint after fixing build errors
Chris Gough
committed
Enable parallel Sphinx builds with env-backed HCD repositories
Chris Gough
committed

Commits on Dec 23, 2025

hearty refactoring, flatten the CEAP layer a bit, separate tests
Chris Gough
committed
horrendus monster commit
Chris Gough
committed

Commits on Dec 24, 2025

HACK HACK HACKETY HACK
Chris Gough
committed
...and lint
Chris Gough
committed
... and lint
Chris Gough
committed
centralise architecture conventions to contstants
Chris Gough
committed
LINT FFS
Chris Gough
committed
add initial doctrine for Pipelines
Chris Gough
committed
improve entity docstrings to improve julee-admin doctrine output
Chris Gough
committed
contrib.polling: refactor requests and responses into usecase package
Chris Gough
committed
refactor pipeline chaining to use a router mechanism
Chris Gough
committed
rename PipelineRoute* to avoid ambiguity (with other router types)
Chris Gough
committed
lint
Chris Gough
committed
fix pesky DTO language
Chris Gough
committed
create REDME for contrib/polling
Chris Gough
committed
aaaaaand lint
Chris Gough
committed
frob
Chris Gough
committed
accelerate test execution
Chris Gough
committed
prepair for moving all the file around
Chris Gough
committed
move hcd/domain/models -> hcd/entities
Chris Gough
committed
restructure c4 like we did for hcd
Chris Gough
committed
continue restructuring to the new pattern, and attack duplication
Chris Gough
committed
restructure julee/shared/ with new pattern
Chris Gough
committed
rename shared -> core
Chris Gough
committed
clean up and fix mess of recent refactors
Chris Gough
committed
refactor to consolidated memory repository mixin
Chris Gough
committed
fix broken __all__ re-exports
Chris Gough
committed
'finish' removing legacy/backwards-compatability cruft, start realigning tests with new structure
Chris Gough
committed
'finish' refactoring tests to align with the new layout
Chris Gough
committed
fix import bug in julee-admin cli
Chris Gough
committed
test the admin cli
Chris Gough
committed
move CEAP to contrib/
Chris Gough
committed

Commits on Dec 26, 2025

Move workers and workflows to contrib apps with proper DI
Chris Gough
committed
Move CEAP services and temporal repos to contrib infrastructure
Chris Gough
committed
Update CEAP use case imports for service relocation
Chris Gough
committed
Refine doctrine: contrib is nested solution, not reserved word
Chris Gough
committed
Move CEAP API routers to contrib apps
Chris Gough
committed
Add generic CRUD use case base classes
Chris Gough
committed
Update CEAP API test imports
Chris Gough
committed
Consolidate src/julee/api into contrib/ceap/apps/api following BC pattern
Chris Gough
committed
Rename CEAP workflows to pipelines with doctrine compliance
Chris Gough
committed
ensure all service protocols strictly adhere to domain semantics
Chris Gough
committed
enforce service protocols bind 2+ entity types for transformation
Chris Gough
committed
update julee.core.entities docstrings to clarify doctrine
Chris Gough
committed
Eliminate SuggestionContextService by moving single-entity methods to repositories
Chris Gough
committed
Rename SystemInitializationService to SystemInitializer to avoid doctrine collision
Chris Gough
committed
consolidate C4 CRUD use cases using generic_crud pattern
Chris Gough
committed
fix ParameterInfo construction in pipeline AST parser
Chris Gough
committed
Add Application entity with discovery repository and doctrine tests
Chris Gough
committed
apply formatting cleanup
Chris Gough
committed
Fix REST-API doctrine test to detect DI pattern for UseCase injection
Chris Gough
committed
Add Solution entity with discovery repository and doctrine tests
Chris Gough
committed
Add Deployment entity as outermost Clean Architecture layer
Chris Gough
committed
derive reserved words from doctrine constants
Chris Gough
committed
Add app doctrine hierarchy: type doctrine and instance doctrine
Chris Gough
committed
Add scope support to doctrine CLI for app instance doctrine
Chris Gough
committed
Add Documentation entity and doctrine requiring docs/ with Sphinx config
Chris Gough
committed
Fix ceap use case tests with missing import and request arguments
Chris Gough
committed
Add @use_case decorator and delete unused util/ directory
Chris Gough
committed
Integrate request parameter type validation into @use_case decorator
Chris Gough
committed
Add documentation to SUPPORTING_MODELS for doctrine coverage
Chris Gough
committed
Add test organization doctrine with BC test requirements
Chris Gough
committed
Apply linter formatting to decorator and test files
Chris Gough
committed
Fix execute() call sites and apply formatting
Chris Gough
committed
Suppress pytest collection warnings for test fixture classes
Chris Gough
committed
Fix CI workflow to run all tests and include apps/ path
Chris Gough
committed
Remove dead code and fix unused imports
Chris Gough
committed
Refactor MCP apps into reusable framework with auto-discovery
Chris Gough
committed
Add core-mcp service for bounded context introspection
Chris Gough
committed
Rename MCP app directories to use underscores for valid Python modules
Chris Gough
committed
Apply linter formatting and remove unused imports
Chris Gough
committed
Add MCP doctrine tests and update app detection for framework
Chris Gough
committed
Experience the structure, don't hide it
Chris Gough
committed
Import AST parser from core directly in sphinx
Chris Gough
committed
Add solution, apps, and deployments commands to admin CLI
Chris Gough
committed
Add GetBoundedContextCodeUseCase for composite BC introspection
Chris Gough
committed
Enforce MUST requirement for use case Response classes
Chris Gough
committed
Fix C4 and HCD API imports to use direct submodules
Chris Gough
committed
Use execute_sync() for CLI use case calls
Chris Gough
committed
Refactor sphinx definition directives to use domain Create*UseCase with execute_sync
Chris Gough
committed
Update API docs autosummary to use correct module paths
Chris Gough
committed
Fix test failures in list filters and doctrine exclusions
Chris Gough
committed
Fix test warnings and add missing app filter/grouping methods
Chris Gough
committed
git ignore _generated
Chris Gough
committed
Add FilterableListUseCase for repository-driven list filtering
Chris Gough
committed
Add use case factories to Sphinx HCDContext and update directives to use filtered queries
Chris Gough
committed
Consolidate HCD CRUD use cases into single crud.py module
Chris Gough
committed
Remove stale plan files and update HCD use_cases docstring
Chris Gough
committed

Commits on Dec 27, 2025

Remove empty C4 use_cases subdirs and dead code from suggestions.py
Chris Gough
committed
Add generic_crud.generate() and convert HCD/C4 to use it
Chris Gough
committed
Add ADR 003 for workflow orchestration via handler services
Chris Gough
committed

Commits on Dec 28, 2025

Add handler service pattern for workflow orchestration (ADR 003)
Chris Gough
committed
Implement HCD story handlers with null implementations
Chris Gough
committed
Add NewDataHandler to polling for workflow orchestration
Chris Gough
committed
Add Polling-to-CEAP bridge handler for cross-BC orchestration
Chris Gough
committed
Update ADR 003 with implementation learnings
Chris Gough
committed
Wire story orchestration handler into HCD CRUD operations
Chris Gough
committed
Add ADR 004: Execution-Agnostic Use Cases
Chris Gough
committed
Add Epic and Journey orchestration handlers
Chris Gough
committed
Wire Epic and Journey orchestration handlers into dependencies
Chris Gough
committed
Add ClockService and ExecutionService protocols
Chris Gough
committed
Add Temporal adapters for ClockService and ExecutionService
Chris Gough
committed
Refactor CEAP use cases for execution-agnostic design
Chris Gough
committed
Wire Temporal adapters into CEAP application layer
Chris Gough
committed
Extract common node builders for sphinx HCD directives
Chris Gough
committed
Add repository factory and simplify SphinxEnv repos
Chris Gough
committed
Add Pydantic schema validation for sphinx_hcd config
Chris Gough
committed
Move service implementations from services/ to infrastructure/services/
Chris Gough
committed
Add handler pattern for placeholder resolution
Chris Gough
committed
Add generic placeholder base class and registry
Chris Gough
committed
Add use case factories for directive integration
Chris Gough
committed
Refactor C4 bridge to use use case and renderer pattern
Chris Gough
committed
Add handler support to RST repositories
Chris Gough
committed
Add SphinxEnv repositories and context for C4
Chris Gough
committed
Separate doctrine from policy (ADR 005)
Chris Gough
committed
Refactor doctrine CLI to use proper use cases with repository/service patterns
Chris Gough
committed
Add reflexive documentation directives (apps.sphinx.core)
Chris Gough
committed
Refactor sphinx core catalog directives to use proper DI pattern
Chris Gough
committed
Add policy protocols and SolutionPolicyConfig entity
Chris Gough
committed
Add policy infrastructure implementations
Chris Gough
committed
Move policy compliance tests to infrastructure
Chris Gough
committed
Organize use cases into domain-specific packages
Chris Gough
committed
Update admin CLI to use domain-organized use cases
Chris Gough
committed
Configure julee as a julee solution with policy skipping
Chris Gough
committed
Remove jinja2 re-exports from hcd/templates/__init__.py
Chris Gough
committed
Fix no-reexports test to only check module-level imports
Chris Gough
committed
Remove KnowledgeService re-exports from ceap infrastructure __init__.py
Chris Gough
committed
Remove jinja2 re-exports from core/templates/__init__.py
Chris Gough
committed
Remove fastmcp/types re-exports from core/infrastructure/mcp/__init__.py
Chris Gough
committed
Apply formatter changes to satisfy linter
Chris Gough
committed
Fix placeholder node attribute names for integration and contrib
Chris Gough
committed
Refactor CodeIntrospectionService to JuleeCodeRepository
Chris Gough
committed
hide the gratuitous world domination plans in plain sight
Chris Gough
committed
git ignore _generated docs
Chris Gough
committed
Migrate clean_architecture docs to code-outward documentation
Chris Gough
committed
Make sphinx extension modules self-documenting
Chris Gough
committed
Add code of conduct
Chris Gough
committed
Migrate framework.rst to julee module docstring
Chris Gough
committed
Migrate applications docs to Application entity docstring
Chris Gough
committed
Migrate solutions docs to entity docstrings
Chris Gough
committed
Add HCD entity commands to julee-admin CLI
Chris Gough
committed
Update contributing guide to reflect current project structure
Chris Gough
committed
Remove redundant contrib.rst, update solutions index
Chris Gough
committed
Add C4 index directives for listing architecture elements
Chris Gough
committed
Update docs/index.rst to link into API documentation
Chris Gough
committed
Remove __all__ exports, update C4 docstring with index directives
Chris Gough
committed
Add documentation doctrine test for redundant RST detection
Chris Gough
committed
Add Solution entity hub page with directives calling use cases
Chris Gough
committed
Add solution_slug scoping to HCD entities and directives
Chris Gough
committed
Add BC hub directive and enhance catalog directives for all-BCs mode
Chris Gough
committed
Replace direct repo access with use cases in accelerator and persona directives
Chris Gough
committed
Replace direct repo access with use cases in remaining HCD directives
Chris Gough
committed
Replace direct repo access in initialization and placeholder_resolution
Chris Gough
committed
Complete clean architecture rectification for apps layer
Chris Gough
committed
Refactor catalog and BC hub directives to template-driven pattern
Chris Gough
committed
Fix render_entity import path in migrate_stories.py
Chris Gough
committed
Remove stale test for MODELS_DIR constant
Chris Gough
committed
Add service-protocol-catalog directive and refactor directive_factory
Chris Gough
committed
Improve sphinx extension docstrings
Chris Gough
committed
Add generated directives framework with DocumentationRenderingService
Chris Gough
committed
Fix class body name shadowing in directive factory
Chris Gough
committed
Enhance autosummary templates with hub page sections
Chris Gough
committed
Update HCD generated directives with module-level placeholders
Chris Gough
committed
Remove dead index directive code after factory refactor
Chris Gough
committed
Fix Sphinx documentation build warnings
Chris Gough
committed
Add SPHINX-EXTENSION app type doctrine tests
Chris Gough
committed
Refactor C4 Sphinx extension to use use cases
Chris Gough
committed
Add app layer dependency rules to doctrine
Chris Gough
committed
Add documentation link integrity doctrine tests
Chris Gough
committed
Exclude slow doctrine tests by default, add --include-slow option
Chris Gough
committed
Add HCD entity templates and refactor directives to use templates
Chris Gough
committed
Remove dead process_*_placeholders functions from directive files
Chris Gough
committed
Consolidate _build_relative_uri to shared module
Chris Gough
committed
lint the doctrine refactor
Chris Gough
committed
Add Sphinx cross-reference roles and template improvements
Chris Gough
committed
Add configurable search_root and docs_root for foreign solutions
Chris Gough
committed

Commits on Dec 29, 2025

Add SemanticRelation entity for declaring cross-layer relationships
Chris Gough
committed
BC discovery: detect nested solutions dynamically
Chris Gough
committed
Doctrine tests: use dynamic search_root fixture
Chris Gough
committed
Fix BC doctrine tests: use local constant for synthetic tests
Chris Gough
committed
Add compositional semantic relations for HCD entities
Chris Gough
committed
Handle skipped tests in doctrine verification
Chris Gough
committed
Add RelationTraversal service for semantic relation infrastructure
Chris Gough
committed
Add entity-graph directive for visualizing semantic relations
Chris Gough
committed

Commits on Dec 30, 2025

Add more semantic relations, use string type references
Chris Gough
committed

Commits on Dec 31, 2025

Add unified-links directive for automatic bidirectional documentation
Chris Gough
committed
Move Accelerator to supply_chain bounded context
Chris Gough
committed
Remove Accelerator from HCD bounded context
Chris Gough
committed
Group semantic links by bounded context, document Entity as ontological root
Chris Gough
committed
Fix lint errors and docs build issue
Chris Gough
committed
Add contrib/untp projection layer for UNTP vocabulary mapping
Chris Gough
committed
Add Party entity to supply_chain and complete UNTP semantic relations
Chris Gough
committed

Commits on Jan 7, 2026

Update admin CLI imports for Accelerator move to supply_chain
Chris Gough
committed
fix: use string annotations for Pipeline return types
Chris Gough
committed

Commits on Feb 12, 2026

Use model_validate() instead of model_copy() in UpdateUseCase
Chris Gough
committed

Commits on Feb 15, 2026

Add architecture overview synthesising all ADRs and design docs
Chris Gough
committed