Public scan — anyone with this URL can view this analysis. Sign up to track your own repos privately, run scheduled re-scans, and get AI fix prompts via your dashboard.

bryansparks/armature

https://github.com/bryansparks/armature · scanned 2026-06-17 01:43 UTC (1 month, 1 week ago)

38 raw signals (0 security + 38 graph)

UNIFIED Repobility · multi-layer engine · AI coders

Complete repo analysis

Last scanned 1 month, 1 week ago · v2 · last Δ -19.7 (diff) · 32 actionable findings from 1 signal source. 6 repeated signals grouped for readability. Security checks, system graph analysis, and verified AI-agent feedback are merged into one review queue.

JSON
Severity distribution — click a segment to filter
Active filters: excluding tests × Reset all
Corpus Intelligence Cross-corpus context (cohort percentile, top patterns, fix plan) is shown only on repositories you own. Sign up and connect your repo to view it.
Scan summary Repository scanned at 57.0/100 with 88.9% coverage. It contains 2662 nodes across 11 cross-layer flows, written primarily in mixed languages. Engine surfaced 38 findings — concentrated in quality (18), software (11), cicd (4). Risk profile is high: 0 critical, 2 high, 5 medium. Recommended next step: open the quality layer findings first — that's where the highest-impact wins live.

Showing 32 of 32 actionable findings. 38 raw detector signals were grouped into reader-sized issues. Click TP / FP to vote on a finding's accuracy — votes adjust the confidence weighting and improve detection across the platform.

high System graph security security conf 1.00 Insecure pattern 'subprocess_shell_true' in armature/nodes/script.py:30
Found a known-risky pattern (subprocess_shell_true). Review and replace if possible.
armature/nodes/script.py:30 Subprocess shell true
high System graph security security conf 1.00 Insecure pattern 'subprocess_shell_true' in armature/registry/builtins.py:23
Found a known-risky pattern (subprocess_shell_true). Review and replace if possible.
armature/registry/builtins.py:23 Subprocess shell true
medium System graph quality Placeholder conf 1.00 Critical user flow still appears backed by mock or placeholder data
A payment/auth/admin/order/billing-style flow contains mock, fake, TODO, dummy, or placeholder markers in runtime source. In the Fable corpus this is a high-leverage completeness smell: the app can look finished while the money, identity, or tenant flow is still scaffolded.
Mock dataCritical flowGenerated repo pattern
medium System graph hardware Security conf 1.00 Dockerfile runs as root: templates/langgraph-sidecar/bot/Dockerfile
No non-root USER set. Containers running as root expand the blast radius of any vulnerability inside the image.
Container
medium System graph cicd CI/CD security conf 1.00 GitHub Action is tag-pinned rather than SHA-pinned
pypa/gh-action-pypi-publish@release/v1 can move without a code change in this repo. Pin third-party actions to a reviewed 40-character commit SHA.
.github/workflows/publish.yml:31 CI/CD securitySupply chainGithub actions
medium System graph cicd CI/CD security conf 1.00 GitHub Actions workflow grants broad write permissions
CI tokens with write permissions increase blast radius when an action, dependency, or PR workflow is compromised. Prefer job-level least-privilege permissions.
.github/workflows/publish.yml CI/CD securitySupply chainGithub actions
medium System graph quality Integrity conf 1.00 Network/subprocess call without timeout or try/except — armature/demo.py:162
`subprocess.run(...)` here lacks both a `timeout=` arg and an enclosing try/except. This is exactly the class of bug that took down our git-clone earlier (HTTP/2 stream cancel surfaced as a fatal). Add a `timeout=` and wrap in try/except, or use a wrapper that retries.
runtime safetyRobustness
low System graph quality Integrity conf 1.00 7 env vars used in code but missing from .env.example
Drift between code and config docs. The first few: `ARMATURE_URL`, `LANGFUSE_HOST`, `LANGFUSE_PUBLIC_KEY`, `LANGFUSE_SECRET_KEY`, `LANGSMITH_API_KEY`, `LANGSMITH_PROJECT`, `OLLAMA_API_KEY`. Add them (with a placeholder/comment) to .env.example so onboarding doesn't break.
config drift
low System graph quality Debug conf 1.00 Debug logging residue appears in source files
Found 30 console/debugger/print-style debug statements in non-test source. This is a common fast-generation residue before production cleanup.
CleanupRepo hardeningGenerated repo pattern
low System graph hardware Supply chain conf 1.00 Docker base image is tag-pinned but not digest-pinned: python:3.11-slim
Container tags can be retagged upstream. Pin production base images to a reviewed digest (`image@sha256:...`) when reproducibility and supply-chain integrity matter.
Dockerfile:2 containersPinned dependencies
low System graph hardware Supply chain conf 1.00 Docker base image is tag-pinned but not digest-pinned: python:3.11-slim
Container tags can be retagged upstream. Pin production base images to a reviewed digest (`image@sha256:...`) when reproducibility and supply-chain integrity matter.
templates/langgraph-sidecar/bot/Dockerfile:1 containersPinned dependencies
low System graph cicd CI/CD security conf 1.00 2 occurrences GitHub Action is tag-pinned rather than SHA-pinned
actions/setup-python@v5 can move without a code change in this repo. Pin third-party actions to a reviewed 40-character commit SHA.
2 files, 2 locations
.github/workflows/ci.yml:22
.github/workflows/publish.yml:20
CI/CD securitySupply chainGithub actions
low System graph quality Agent instructions conf 1.00 Multiple root agent instruction files without precedence
The repo has multiple top-level AI-coder instruction files. Without precedence rules, different agents may follow different policies.
Governance
low System graph quality Integrity conf 1.00 4 occurrences Near-duplicate function bodies in 2 places
Functions with the same first-5-line body hash: armature/cli.py:export_traces, armature/cli.py:export This is *the* AI-coder failure mode (4× more duplication in vibe-coded repos — see https://jw.hn/ai-code-hygiene). Consolidate or document why they're separate.
4 occurrences
repo-level (4 hits)
duplicatesduplication
low System graph quality Integrity conf 1.00 3 occurrences Near-duplicate function bodies in 3 places
Functions with the same first-5-line body hash: armature/sandbox/docker.py:handler, armature/sandbox/docker.py:handler, armature/sandbox/docker.py:handler This is *the* AI-coder failure mode (4× more duplication in vibe-coded repos — see https://jw.hn/ai-code-hygiene). Consolidate or document why …
3 occurrences
repo-level (3 hits)
duplicatesduplication
low System graph quality Integrity conf 1.00 Old/deprecated-named symbol `model_copy` in armature/optimizer/runner.py:210
Names with suffixes like `_old`, `_v1`, `_deprecated` usually indicate replaced-but-not-removed code (typical AI-coder leftover). Confirm and delete, or rename if it's the active version.
old markerDead code
low System graph quality Integrity conf 1.00 Old/deprecated-named symbol `model_copy` in tests/runtime/test_engine.py:60
Names with suffixes like `_old`, `_v1`, `_deprecated` usually indicate replaced-but-not-removed code (typical AI-coder leftover). Confirm and delete, or rename if it's the active version.
old markerDead code
low System graph quality Integrity conf 1.00 Old/deprecated-named symbol `test_messages_returns_copy` in tests/runtime/test_context.py:32
Names with suffixes like `_old`, `_v1`, `_deprecated` usually indicate replaced-but-not-removed code (typical AI-coder leftover). Confirm and delete, or rename if it's the active version.
old markerDead code
low System graph software Dead code conf 1.00 Possibly dead Python function: chitchat_node
No callers detected by AST scan in this repo. Could be exported for external callers or a framework handler.
templates/langgraph-sidecar/bot/nodes.py:66
low System graph software Dead code conf 1.00 Possibly dead Python function: classify_node
No callers detected by AST scan in this repo. Could be exported for external callers or a framework handler.
templates/langgraph-sidecar/bot/nodes.py:13
low System graph software Dead code conf 1.00 Possibly dead Python function: endpoint
No callers detected by AST scan in this repo. Could be exported for external callers or a framework handler.
armature/service/triggers.py:74
low System graph software Dead code conf 1.00 Possibly dead Python function: load_for_workflow
No callers detected by AST scan in this repo. Could be exported for external callers or a framework handler.
armature/state/evaluator.py:81
low System graph software Dead code conf 1.00 Possibly dead Python function: post_stage_hook
No callers detected by AST scan in this repo. Could be exported for external callers or a framework handler.
armature/service/app.py:166
low System graph software Dead code conf 1.00 Possibly dead Python function: pre_stage_hook
No callers detected by AST scan in this repo. Could be exported for external callers or a framework handler.
armature/service/app.py:162
low System graph software Dead code conf 1.00 Possibly dead Python function: research_node
No callers detected by AST scan in this repo. Could be exported for external callers or a framework handler.
templates/langgraph-sidecar/bot/nodes.py:30
low System graph software Dead code conf 1.00 Possibly dead Python function: respond_with_research_node
No callers detected by AST scan in this repo. Could be exported for external callers or a framework handler.
templates/langgraph-sidecar/bot/nodes.py:46
low System graph software Dead code conf 1.00 Possibly dead Python function: route_after_classify
No callers detected by AST scan in this repo. Could be exported for external callers or a framework handler.
templates/langgraph-sidecar/bot/nodes.py:74
low System graph software Dead code conf 1.00 Possibly dead Python function: safety_hook
No callers detected by AST scan in this repo. Could be exported for external callers or a framework handler.
armature/hooks/lifecycle.py:120
low System graph software Dead code conf 1.00 Possibly dead Python function: stream_workflow_events
No callers detected by AST scan in this repo. Could be exported for external callers or a framework handler.
templates/langgraph-sidecar/bot/armature_client.py:39
low System graph quality Integrity conf 1.00 Stub function `set_attribute` (body is just `pass`/`return`) — armature/telemetry/__init__.py:74
Likely an AI scaffold that was never filled in. Remove or implement.
Empty handlerDead code
low System graph quality Complexity conf 1.00 Very large file: armature/cli.py (1330 lines)
Files with >800 lines often hide complexity hotspots and discourage tests.
low System graph quality Complexity conf 1.00 Very large file: tests/synthesis/test_improve.py (1406 lines)
Files with >800 lines often hide complexity hotspots and discourage tests.
For AI agents: Voting guide (TP/FP) MCP manifest Stdio wrapper SARIF Integrate Findings queue Vote TP/FP on findings to calibrate the engine.
For AI agents + API integrations
Email me when this repo regresses
Free. We re-scan periodically; new criticals → your inbox. No signup required for the scan itself.
API access

This page is publicly accessible at: https://repobility.com/scan/93fac715-5a21-413d-8d4a-ad39820a5f54/

To check status programmatically (no auth required):

curl -s https://repobility.com/api/v1/public/scan/93fac715-5a21-413d-8d4a-ad39820a5f54/

Important — please don't re-submit the same URL repeatedly. The submission endpoint is idempotent: re-submitting the same git URL returns this same scan_token, not a new one. To re-scan this repo, sign up free and use the dashboard.