coulomb/markitect-main
4
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
markitect-main/markitect
History
tegwick 7b4bd461c9 feat(prompts): implement Phase 8 - Observability & Traceability (FR-11) 
Complete implementation of Phase 8, the final phase of prompt dependency
resolution infrastructure, adding full observability and traceability.

## Features (FR-11)

### FR-11.1: Complete Artifact Provenance Tracing
- TraceabilityService: composition layer for full artifact lineage
- Trace any artifact to producing PromptTemplate, input artifacts,
  generator runs, and quality validation results
- ProvenanceTrace model with complete dependency chain reconstruction
- RunSummary and ArtifactLineage models for structured trace output

### FR-11.2: Recomputation Query Infrastructure
- PromptQueryService: cross-service complex queries
- Run history queries with template and status filters
- Stale artifact detection via impact debt analysis
- Dependency graph statistics (nodes, edges, cycles, roots, leaves)
- Content-based artifact lookups by digest

### Visualization Support
- GraphExporter: DOT (Graphviz) and Mermaid format export
- Supports all edge types (requires, generates, includes)
- Handles isolated nodes, linear chains, diamonds, and complex graphs

### CLI Commands (prompt group)
- `prompt trace <artifact_id>` - Full provenance trace as JSON
- `prompt graph <artifact_id>` - Dependency graph (DOT/Mermaid)
- `prompt runs` - List execution runs with filters
- `prompt debt` - Show impact debt and stale artifacts
- `prompt stats` - Dependency graph statistics

## Implementation

Source files (8):
- markitect/prompts/traceability/models.py - Trace data models
- markitect/prompts/traceability/service.py - TraceabilityService
- markitect/prompts/visualization/graph.py - Graph export
- markitect/prompts/queries/operations.py - PromptQueryService
- markitect/prompts/cli.py - Click CLI commands
- Package __init__.py files (3)

Tests (64 total, all passing):
- tests/unit/prompts/test_traceability_service.py (21 tests)
- tests/unit/prompts/test_visualization.py (14 tests)
- tests/unit/prompts/test_query_operations.py (12 tests)
- tests/integration/prompts/test_traceability_workflow.py (7 tests)
- tests/integration/prompts/test_prompt_cli.py (10 tests)

## Architecture

TraceabilityService is a composition layer that delegates to:
- DependencyQueryService (transitive dependency lookups)
- QualityValidator (validation history)
- IncrementalExecutionEngine (impact debt queries)
- Direct repository access (artifacts, edges)

No duplicate data storage - all data comes from existing Phase 1-7
infrastructure (artifact repo, dependency repo, validation DB, debt DB).

## Verification

All 2250 tests pass with 0 regressions.
Phase 8 completes the full 8-phase implementation roadmap.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-09 20:32:18 +01:00
..
assets refactor: failed attempt at edit mode recovery and robustness implementation 2025-11-12 00:19:03 +01:00
core feat(spaces): implement Phase 0-1 of Information Space Service 2026-02-08 02:02:46 +01:00
explode_variants feat: complete Issue #150 - Advanced Packaging Features (.mdz, .mdt) 2025-10-13 23:09:18 +02:00
finance feat: reorganize tests by capability with separate test targets 2025-10-25 02:37:45 +02:00
graphql feat(spaces): implement Phase 6 API Layer 2026-02-08 12:29:11 +01:00
legacy feat: Complete Issue #39 - Database CLI Reorganization with Comprehensive Legacy Compatibility System 2025-09-30 17:28:39 +02:00
matter_contentmatter feat: Complete Issue #38 - Full MarkdownMatters CLI implementation with TDD8 methodology 2025-10-02 09:14:24 +02:00
matter_frontmatter feat: implement comprehensive front matter preservation and unicode handling 2025-10-13 20:26:08 +02:00
matter_tailmatter feat: Complete Issue #38 - Full MarkdownMatters CLI implementation with TDD8 methodology 2025-10-02 09:14:24 +02:00
packaging feat: complete Issue #150 - Advanced Packaging Features (.mdz, .mdt) 2025-10-13 23:09:18 +02:00
plugins feat: consolidate testdrive-jsui to capabilities and implement plugin self-declaration 2025-12-15 23:42:54 +01:00
production feat: complete Issue #145 - Phase 4: Production Readiness and Release 2025-10-14 18:15:26 +02:00
profile feat: implement comprehensive User Profile Management System (issue #107) 2025-10-04 01:53:31 +02:00
prompts feat(prompts): implement Phase 8 - Observability & Traceability (FR-11) 2026-02-09 20:32:18 +01:00
query_paradigms feat: reorganize tests by capability with separate test targets 2025-10-25 02:37:45 +02:00
schema feat(spaces): implement Phase 0-1 of Information Space Service 2026-02-08 02:02:46 +01:00
schemas feat: add changelog schema for Keep a Changelog validation 2026-01-06 13:31:02 +01:00
spaces feat(spaces): implement Phase 8 Git History Tracking 2026-02-08 18:03:35 +01:00
static/css feat: Complete Phase 4 - Remove legacy JavaScript files 2025-12-16 10:27:05 +01:00
storage feat(spaces): implement Phase 0-1 of Information Space Service 2026-02-08 02:02:46 +01:00
template feat: Complete Issue #65 Template Engine Foundation + Fix CLI Regression 2025-10-02 15:33:32 +02:00
templates fix: CSS injection and theme application bugs 2025-12-17 12:02:42 +01:00
themes feat: implement modular theme system with file-based theme organization 2025-11-10 11:43:25 +01:00
validators feat: add LinkValidator for semantic link validation (Phase 3) 2026-01-06 03:41:03 +01:00
__init__.py chore: gitignore and repo cleanup 2025-09-16 03:04:18 +02:00
__version__.py refactor: delegate version management to release-management capability 2025-11-09 10:41:28 +01:00
asset_commands.py feat: implement Issue #143 - CLI integration and user experience for asset management 2025-10-14 13:46:34 +02:00
associated_files.py feat: Complete Issue #40 - Associated Files Management with Interactive vs Automation Mode System 2025-09-30 13:09:37 +02:00
ast_cache.py feat: Strategic pivot to CLI implementation with comprehensive foundation 2025-09-24 01:14:27 +02:00
ast_service.py fix: Improve AST display content visibility for Issue #15 2025-09-27 09:31:47 +02:00
batch_processor.py feat: implement batch processing and recursive operations (issue #17) 2025-10-03 10:45:43 +02:00
cache_service.py feat: Complete logging standardization with context-aware system 2025-09-27 08:28:10 +02:00
clean_document_manager.py fix: CSS injection and theme application bugs 2025-12-17 12:02:42 +01:00
cli.py feat(prompts): implement Phase 8 - Observability & Traceability (FR-11) 2026-02-09 20:32:18 +01:00
cli_utils.py feat: implement Issue #143 - CLI integration and user experience for asset management 2025-10-14 13:46:34 +02:00
config_manager.py feat: optimize code quality with pylint analysis and critical fixes - Issue #130 2025-10-06 03:03:38 +02:00
database.py feat(spaces): implement Phase 0-1 of Information Space Service 2026-02-08 02:02:46 +01:00
document_manager.py feat(spaces): implement Phase 0-1 of Information Space Service 2026-02-08 02:02:46 +01:00
draft_generator.py refactor: enhance draft generator documentation and code quality 2025-10-03 10:35:16 +02:00
exceptions.py feat: optimize code quality with pylint analysis and critical fixes - Issue #130 2025-10-06 03:03:38 +02:00
frontmatter.py feat: optimize code quality with pylint analysis and critical fixes - Issue #130 2025-10-06 03:03:38 +02:00
legacy_compat.py feat: optimize code quality with pylint analysis and critical fixes - Issue #130 2025-10-06 03:03:38 +02:00
legacy_integration_example.py feat: Complete Issue #39 - Database CLI Reorganization with Comprehensive Legacy Compatibility System 2025-09-30 17:28:39 +02:00
metaschema.py feat: implement Phase 1 - Enhanced Schema Format with Classifications 2026-01-04 21:02:51 +01:00
parser.py feat(spaces): implement Phase 0-1 of Information Space Service 2026-02-08 02:02:46 +01:00
performance_tracker.py feat: optimize code quality with pylint analysis and critical fixes - Issue #130 2025-10-06 03:03:38 +02:00
schema_analyzer.py feat(spaces): implement Phase 0-1 of Information Space Service 2026-02-08 02:02:46 +01:00
schema_generator.py feat(spaces): implement Phase 0-1 of Information Space Service 2026-02-08 02:02:46 +01:00
schema_loader.py feat(spaces): implement Phase 0-1 of Information Space Service 2026-02-08 02:02:46 +01:00
schema_naming.py feat(spaces): implement Phase 0-1 of Information Space Service 2026-02-08 02:02:46 +01:00
schema_refiner.py feat(spaces): implement Phase 0-1 of Information Space Service 2026-02-08 02:02:46 +01:00
schema_validator.py feat(spaces): implement Phase 0-1 of Information Space Service 2026-02-08 02:02:46 +01:00
semantic_validator.py feat: complete schema-evolution topic with ADR schema and markdown support 2026-01-06 12:32:38 +01:00
serializer.py feat(spaces): implement Phase 0-1 of Information Space Service 2026-02-08 02:02:46 +01:00
stub_generator.py feat: optimize code quality with pylint analysis and critical fixes - Issue #130 2025-10-06 03:03:38 +02:00
validation_error.py feat: Complete Issue #8 - Detailed Validation Error Reporting and CLI Enhancements 2025-09-29 21:21:21 +02:00
workspace.py feat(spaces): implement Phase 0-1 of Information Space Service 2026-02-08 02:02:46 +01:00