[amankarki151]

Every pull request now gets analysed by the tool this repository builds. benchmark_repos/ is gitignored and absent from a fresh checkout, so this workflow runs RAAG against its own codebase rather than the local benchmark corpus — the self-analysis is the actual demo, not a compromise.

• Add a two-stage Dockerfile: compile the Sample Engine in a full build image, copy only the resulting binary into a slim Python runtime
• Add docker-compose.yml wiring the raag service to Qdrant by service name, never localhost, so it runs identically outside a developer's laptop
• Add scripts/format_pr_comment.py rendering --export-metrics output as a PR comment, exercising that JSON format as a real consumed contract
• Add .github/workflows/architecture.yml: builds the Sample Engine, parses the repository, runs the instability gate, posts or updates one PR comment per thread rather than one per push, uploads the full report as a build artifact

[github-actions]

❌ RAAG Architectural Analysis

61 files, 126 dependencies, 0 cycle(s).

359 imports: 129 resolved, 0 ambiguous, 230 external (35.9% internal)

4 error(s) push a core module's instability past the configured threshold (0.4), or introduce a dependency cycle. This blocks the merge.

	Rule	Module	Detail
🔴	instability	./master_engine/raag_master/pipeline.py	3 modules depend on this file, but it depends on 8 others (I=0.73, limit 0.40). Changes upstream can propagate through it to everything below.
🔴	instability	./cli/raag_cli/display.py	3 modules depend on this file, but it depends on 4 others (I=0.57, limit 0.40). Changes upstream can propagate through it to everything below.
🔴	instability	./master_engine/raag_master/indexer.py	4 modules depend on this file, but it depends on 5 others (I=0.56, limit 0.40). Changes upstream can propagate through it to everything below.
🔴	instability	./tune_engine/raag_tune/report.py	4 modules depend on this file, but it depends on 5 others (I=0.56, limit 0.40). Changes upstream can propagate through it to everything below.

10 warning(s)

Rule	Module	Detail
cohesion	./sample_engine/include/raag/ast_node.hpp::AstArena	9 methods form 9 unrelated groups: {reserve}, {empty}, {size}. This class may be doing 9 separate jobs.
cohesion	./sample_engine/include/raag/tree_sitter_parser.hpp::TreeSitterParser	7 methods form 7 unrelated groups: {language}, {has_tree}, {anonymous:70}. This class may be doing 7 separate jobs.
cohesion	./sample_engine/tests/test_snapshot.cpp::TempFile	7 methods form 7 unrelated groups: {anonymous:413}, {anonymous:412}, {anonymous:411}. This class may be doing 7 separate jobs.
cohesion	./sample_engine/include/raag/thread_pool.hpp::ThreadPool	5 methods form 5 unrelated groups: {thread_count}, {anonymous:61}, {ThreadPool}. This class may be doing 5 separate jobs.
cohesion	./master_engine/raag_master/vector_store.py::VectorStore	10 methods form 3 unrelated groups: {init, collection, count...}, {in_memory}, {connect}. This class may be doing 3 separate jobs.
cohesion	./master_engine/raag_master/chunking.py::CodeChunk	3 methods form 3 unrelated groups: {embedding_text}, {line_count}, {byte_length}. This class may be doing 3 separate jobs.
cohesion	./master_engine/raag_master/embeddings.py::Embedder	3 methods form 3 unrelated groups: {embed}, {name}, {dimensions}. This class may be doing 3 separate jobs.
cohesion	./tune_engine/raag_tune/ast_types.py::AstNode	3 methods form 3 unrelated groups: {byte_length}, {is_leaf}, {is_root}. This class may be doing 3 separate jobs.
cohesion	./tune_engine/raag_tune/report.py::MetricsReport	8 methods form 2 unrelated groups: {error_count, least_cohesive, most_depended_upon...}, {passed}. This class may be doing 2 separate jobs.
cohesion	./tune_engine/raag_tune/module_index.py::ModuleIndex	6 methods form 2 unrelated groups: {contains, len, _match_suffix...}, {from_paths}. This class may be doing 2 separate jobs.

_{Generated by RAAG — instability gated on modules with meaningful afferent coupling; isolated leaves are not flagged for being correctly unstable.}

[github-actions]

✅ RAAG Architectural Analysis

61 files, 126 dependencies, 0 cycle(s).

359 imports: 129 resolved, 0 ambiguous, 230 external (35.9% internal)

No error-severity violations. (10 warning(s) — not blocking.)

10 warning(s)

Rule	Module	Detail
cohesion	./sample_engine/include/raag/ast_node.hpp::AstArena	9 methods form 9 unrelated groups: {reserve}, {empty}, {size}. This class may be doing 9 separate jobs.
cohesion	./sample_engine/include/raag/tree_sitter_parser.hpp::TreeSitterParser	7 methods form 7 unrelated groups: {language}, {has_tree}, {anonymous:70}. This class may be doing 7 separate jobs.
cohesion	./sample_engine/tests/test_snapshot.cpp::TempFile	7 methods form 7 unrelated groups: {anonymous:413}, {anonymous:412}, {anonymous:411}. This class may be doing 7 separate jobs.
cohesion	./sample_engine/include/raag/thread_pool.hpp::ThreadPool	5 methods form 5 unrelated groups: {thread_count}, {anonymous:61}, {ThreadPool}. This class may be doing 5 separate jobs.
cohesion	./master_engine/raag_master/vector_store.py::VectorStore	10 methods form 3 unrelated groups: {init, collection, count...}, {in_memory}, {connect}. This class may be doing 3 separate jobs.
cohesion	./master_engine/raag_master/chunking.py::CodeChunk	3 methods form 3 unrelated groups: {embedding_text}, {line_count}, {byte_length}. This class may be doing 3 separate jobs.
cohesion	./master_engine/raag_master/embeddings.py::Embedder	3 methods form 3 unrelated groups: {embed}, {name}, {dimensions}. This class may be doing 3 separate jobs.
cohesion	./tune_engine/raag_tune/ast_types.py::AstNode	3 methods form 3 unrelated groups: {byte_length}, {is_leaf}, {is_root}. This class may be doing 3 separate jobs.
cohesion	./tune_engine/raag_tune/report.py::MetricsReport	8 methods form 2 unrelated groups: {error_count, least_cohesive, most_depended_upon...}, {passed}. This class may be doing 2 separate jobs.
cohesion	./tune_engine/raag_tune/module_index.py::ModuleIndex	6 methods form 2 unrelated groups: {contains, len, _match_suffix...}, {from_paths}. This class may be doing 2 separate jobs.

_{Generated by RAAG — instability gated on modules with meaningful afferent coupling; isolated leaves are not flagged for being correctly unstable.}