tools.bvs.technology — Structured catalog of BGC infrastructure tools (MTH-056)
| Tool ID | Name | Category | Language | Description | Usage | Prerequisites | Source Path |
|---|---|---|---|---|---|---|---|
session-artifact-cleanup |
Claude Session Artifact Cleanup | cleanup | python | MacBook-wide Claude artifact cleanup (MTH-056 PA-05/CA-05). 3-day retention. Recursive JSONL cleanup, stale .claude/tasks/, orphan .claude/ folders in non-BGC repos. Protects MEMORY.md and CLAUDE.md. | python further_more_tools/session-artifact-cleanup.py --dry-run |
None | 00-BGC-GROUP/Tools/further_more_tools/session-artifact-cleanup.py |
incident-aging-enforcer |
Incident Lifecycle Manager | compliance | python | Incident lifecycle management — 5-day escalation warning, 7-day auto-close, exemption support (BLOCKED/LEGAL_HOLD), audit logging. INC-031 PA-5. | python more_tools/incident_aging_enforcer.py --check |
Keychain: BVS_Forgejo_API_token_v2000_MD Python: requests Services: git.bvs.technology (Forgejo) |
00-BGC-GROUP/Tools/more_tools/incident_aging_enforcer.py |
convert-inc-json-to-md |
Incident JSON to Markdown Converter | converter | python | Converts INC JSON to unified Markdown format. Handles two JSON structures (top-level vs nested metadata). Standardizes INC-001 through INC-034. | python further_more_tools/convert_inc_json_to_md.py --input incidents/ --output md/ |
None | 00-BGC-GROUP/Tools/further_more_tools/convert_inc_json_to_md.py |
entity-converter |
Entity File Converter | converter | javascript | Converts BVS/BAS entity markdown to JSON. Context-aware domain reassignment (Risk Registers->RSK, Financial Checklists->FIN), COSO/ISO mapping. | node further_more_tools/BGC-INF-EXE-002-Entity_Converter-20260111.js |
System: node | 00-BGC-GROUP/Tools/further_more_tools/BGC-INF-EXE-002-Entity_Converter-20260111.js |
json2yaml |
JSON to YAML Converter | converter | python | Converts BGC schema JSON to YAML. Batch processing, policy/methodology selective conversion. Part of POL-016 format standardization. | python more_tools/json2yaml.py --input docs/ --output yaml/ |
Python: pyyaml | 00-BGC-GROUP/Tools/more_tools/json2yaml.py |
md-to-json-converter |
Markdown to JSON Converter | converter | javascript | Parses governance docs from Markdown to JSON (SCH-002 schema). Maps legacy domains (GOV->INF, ACC->FIN), injects COSO/ISO refs by type. | node further_more_tools/BGC-INF-EXE-001-MD_To_JSON_Converter-20260111.js |
System: node | 00-BGC-GROUP/Tools/further_more_tools/BGC-INF-EXE-001-MD_To_JSON_Converter-20260111.js |
shared-converter |
Shared Files Converter | converter | javascript | Converts 99-SHARED governance files from markdown to JSON. Domain mapping (BRD->OPS), markdown section parsing. | node further_more_tools/BGC-INF-EXE-004-Shared_Converter-20260111.js |
System: node | 00-BGC-GROUP/Tools/further_more_tools/BGC-INF-EXE-004-Shared_Converter-20260111.js |
toon2yaml |
TOON to YAML Converter | converter | python | Parses TOON format (pipe-delimited), converts to YAML. Batch processing, merge mode, archive legacy files. Mission: TOON MUST DIE. | python more_tools/toon2yaml.py --input docs/ --output yaml/ --archive |
Python: pyyaml | 00-BGC-GROUP/Tools/more_tools/toon2yaml.py |
forgejo-token |
Forgejo Token Helper | credential | shell | Retrieves Forgejo API token from macOS Keychain with fallback to old naming conventions (BVS_Forgejo_API_token_v2000_MD vs Forgejo-API-Token-v2000). | source more_tools/forgejo-token.sh && echo $FORGEJO_TOKEN |
Keychain: BVS_Forgejo_API_token_v2000_MD System: security |
00-BGC-GROUP/Tools/more_tools/forgejo-token.sh |
keychain |
Shared Credential Reader | credential | python | Shared credential reader for all BGC infrastructure tools. Provides forgejo_token(), bookstack_headers(), db1_jwt_secret(), read_password(). Zero hardcoded tokens. Used by all downstream Python tools. | from keychain import forgejo_token, bookstack_headers |
Keychain: BVS_Forgejo_API_token_v2000_MD, BVS_wiki_api_token, BVS_db1_jwt_secret System: security |
00-BGC-GROUP/Tools/more_tools/keychain.py |
rebuild-dta001 |
DTA-001 Rebuilder | data-sync | javascript | Scans for all JSON files with BGC naming convention, parses document IDs, reconstructs DTA-001 data model with paths, status, COSO/ISO refs. | node further_more_tools/BGC-INF-EXE-003-Rebuild_DTA001-20260111.js |
System: node | 00-BGC-GROUP/Tools/further_more_tools/BGC-INF-EXE-003-Rebuild_DTA001-20260111.js |
yaml-to-db1-sync |
YAML to db1 Sync Pipeline | data-sync | python | Syncs DTA-001 YAML shards into db1 PostgreSQL via PostgREST API. Reads Data/dta001/documents_sharded/*.yaml, transforms, deduplicates, INSERTs. Supports --dry-run and --verify modes. | python further_more_tools/yaml-to-db1-sync.py --verify |
Keychain: BVS_db1_jwt_secret Python: pyyaml, requests, pyjwt Services: db1.bvs.technology (PostgREST) |
00-BGC-GROUP/Tools/further_more_tools/yaml-to-db1-sync.py |
add-deprecation-heredoc |
Deprecation HEREDOC Injector | governance | python | Adds deprecation HEREDOC to legacy JSON/TOON files. References new YAML locations, points to migration documents. | python more_tools/add_deprecation_heredoc.py --input legacy/ --yaml-dir yaml/ |
None | 00-BGC-GROUP/Tools/more_tools/add_deprecation_heredoc.py |
create-gap-issues |
Wiki Gap Issue Creator | governance | python | Analyzes document coverage, creates milestone-mapped Forgejo issues for low-coverage doc types. Template for gap analysis. | python further_more_tools/create-gap-issues.py --analyze --create |
Keychain: BVS_Forgejo_API_token_v2000_MD, BVS_wiki_api_token Python: requests Services: git.bvs.technology (Forgejo), wiki.bvs.technology (BookStack) |
00-BGC-GROUP/Tools/further_more_tools/create-gap-issues.py |
forgejo-issue |
Forgejo Issue Operations | governance | python | Create, comment, close Forgejo issues. Supports batch close, file-based comments, labels, milestones. Auth via keychain.py. | python more_tools/forgejo-issue.py create --title 'Issue title' --body 'Description' |
Keychain: BVS_Forgejo_API_token_v2000_MD Python: requests Services: git.bvs.technology (Forgejo) |
00-BGC-GROUP/Tools/more_tools/forgejo-issue.py |
forgejo-milestone |
Forgejo Milestone Operations | governance | python | Create, update, list Forgejo milestones with state filtering. Supports append or replace descriptions. Auth via keychain.py. | python more_tools/forgejo-milestone.py list --state open |
Keychain: BVS_Forgejo_API_token_v2000_MD Python: requests Services: git.bvs.technology (Forgejo) |
00-BGC-GROUP/Tools/more_tools/forgejo-milestone.py |
hook-batch-verify |
Batch Update Awareness Hook | hooks | shell | Pre-commit hook: advisory check for batch updates (MTH-021). Per INC-034 PA-2. ADVISORY level. | Invoked automatically by pre-commit orchestrator. Bypass: SKIP_BATCH=1 |
System: git | 00-BGC-GROUP/Tools/hooks/BGC-INF-EXE-018-Batch_Verify_Hook-20260123.sh |
hook-binary-block |
Binary File Blocker Hook | hooks | shell | Pre-commit hook: blocks PDF, images, credentials from being committed. COSO-3 Control Activities. BLOCKING level. | Invoked automatically by pre-commit orchestrator. Bypass: SKIP_BINARY=1 |
System: git | 00-BGC-GROUP/Tools/hooks/BGC-INF-EXE-005-Binary_Block_Hook-20260111.sh |
hook-coso-compliance |
COSO Compliance Validator Hook | hooks | shell | Pre-commit hook: checks for required COSO refs in governance docs. ADVISORY level. | Invoked automatically by pre-commit orchestrator. Bypass: SKIP_COSO=1 |
System: git | 00-BGC-GROUP/Tools/hooks/BGC-INF-EXE-008-COSO_Compliance_Hook-20260112.sh |
hook-coso-naming |
COSO/ISO Naming Enforcer Hook | hooks | shell | Pre-commit hook: validates {ENTITY}-{MODULE}-{TYPE}-{SEQ}-{Descriptor}-{YYYYMMDD}.{ext} naming convention. BLOCKING level (upgraded from WARNING 10-Jan-2026). | Invoked automatically by pre-commit orchestrator. Bypass: SKIP_NAMING=1 |
System: git | 00-BGC-GROUP/Tools/hooks/BGC-INF-EXE-006-COSO_Naming_Hook-20260111.sh |
hook-cross-reference |
DTA Cross-Reference Validator Hook | hooks | shell | Pre-commit hook: ensures cross-refs between governance docs are bidirectional. ADVISORY level. | Invoked automatically by pre-commit orchestrator. Bypass: SKIP_XREF=1 |
System: git | 00-BGC-GROUP/Tools/hooks/BGC-INF-EXE-017-Cross_Reference_Hook-20260112.sh |
hook-folder-location |
Folder Location Validator Hook | hooks | shell | Pre-commit hook: ensures BGC/BVS/BAS files are in correct entity directories. BLOCKING level. | Invoked automatically by pre-commit orchestrator. Bypass: SKIP_FOLDER=1 |
System: git | 00-BGC-GROUP/Tools/hooks/BGC-INF-EXE-007-Folder_Location_Hook-20260112.sh |
hook-folder-structure |
DTA-003 Folder Structure Validator Hook | hooks | shell | Pre-commit hook: checks folder layout matches approved DTA-003 taxonomy. WARNING level. | Invoked automatically by pre-commit orchestrator. Bypass: SKIP_FOLDER_STRUCT=1 |
System: git | 00-BGC-GROUP/Tools/hooks/BGC-INF-EXE-016-Folder_Structure_Hook-20260112.sh |
hook-iso-compliance |
ISO Compliance Validator Hook | hooks | shell | Pre-commit hook: checks for required ISO refs in governance docs. ADVISORY level. | Invoked automatically by pre-commit orchestrator. Bypass: SKIP_ISO=1 |
System: git | 00-BGC-GROUP/Tools/hooks/BGC-INF-EXE-009-ISO_Compliance_Hook-20260112.sh |
hook-legacy-pattern |
Deprecated Pattern Checker Hook | hooks | shell | Pre-commit hook: blocks old naming schemes. BLOCKING level. | Invoked automatically by pre-commit orchestrator. Bypass: SKIP_LEGACY=1 |
System: git | 00-BGC-GROUP/Tools/hooks/BGC-INF-EXE-013-Legacy_Pattern_Hook-20260112.sh |
hook-migration-integrity |
Domain Migration Validator Hook | hooks | shell | Pre-commit hook: ensures domain migration (GOV->INF, etc.) is consistent. BLOCKING level. | Invoked automatically by pre-commit orchestrator. Bypass: SKIP_MIGRATION=1 |
System: git | 00-BGC-GROUP/Tools/hooks/BGC-INF-EXE-014-Migration_Integrity_Hook-20260112.sh |
hook-orchestrator |
Pre-Commit Orchestrator | hooks | shell | Master orchestrator for 13 modular pre-commit hooks. Runs hooks in sequence with individual bypass flags. Version 3.1.0 (23-Jan-2026). | Configured as git pre-commit hook. Bypass all: --no-verify |
System: git | 00-BGC-GROUP/Tools/hooks/BGC-INF-EXE-012-Pre_Commit_Orchestrator-20260111.sh |
hook-schema-validation |
SCH-002 Schema Validator Hook | hooks | shell | Pre-commit hook: validates JSON/YAML against governance schema. WARNING level. | Invoked automatically by pre-commit orchestrator. Bypass: SKIP_SCHEMA=1 |
System: git | 00-BGC-GROUP/Tools/hooks/BGC-INF-EXE-015-Schema_Validation_Hook-20260112.sh |
hook-session-reminder |
Session Reminder Hook | hooks | shell | Pre-commit hook: displays session context info. INFO level. | Invoked automatically by pre-commit orchestrator. |
System: git | 00-BGC-GROUP/Tools/hooks/BGC-INF-EXE-010-Session_Reminder_Hook-20260112.sh |
hook-vector-index |
DTA-001 Vector Index Validator Hook | hooks | shell | Pre-commit hook: verifies staged docs are in DTA-001 index. BLOCKING level. | Invoked automatically by pre-commit orchestrator. Bypass: SKIP_VECTOR=1 |
System: git | 00-BGC-GROUP/Tools/hooks/BGC-INF-EXE-011-Vector_Index_Hook-20260111.sh |
mcp-install |
MCP Server Installer | mcp | shell | Installs MCP server: creates venv, installs dependencies, sets permissions (CHMOD 444 on settings), validates Keychain credentials, registers with Claude Code. | bash bgc-claude-mcp/install.sh |
Keychain: BVS_Forgejo_API_token_v2000_MD, BVS_wiki_api_token System: python3 |
00-BGC-GROUP/Tools/bgc-claude-mcp/install.sh |
mcp-server |
BGC MCP Server | mcp | python | Model Context Protocol server providing credential-safe API tools for Claude AI agent. Implements stdio JSON-RPC transport with auth injection so the agent never sees raw credentials. | cd bgc-claude-mcp && python server.py |
Keychain: BVS_Forgejo_API_token_v2000_MD, BVS_wiki_api_token Python: mcp, httpx, pyyaml |
00-BGC-GROUP/Tools/bgc-claude-mcp/server.py |
mcp-uninstall |
MCP Server Uninstaller | mcp | shell | Uninstalls MCP server: removes venv and cleans up Claude Code registration. | bash bgc-claude-mcp/uninstall.sh |
None | 00-BGC-GROUP/Tools/bgc-claude-mcp/uninstall.sh |
media-gen |
Media Generation Pipeline | media | shell | Media generation pipeline — animated GIF, MP4, TTS narration, subtitles, combined narrated video. MTH-049/050 media methodology. | bash more_tools/media-gen.sh --gif --input slides/ --output media/ |
System: ffmpeg, convert, say | 00-BGC-GROUP/Tools/more_tools/media-gen.sh |
bgc-test |
Binary Readiness Gates | testing | shell | Binary pass/fail readiness gates for *.bvs.technology.bharath-apisolutions.com. SSH-verified against live servers. 6 layers (L1-L6), 4 phase gates (immediate/phase0/phase1/bvs-ready). JSON evidence artifacts. | bash bgc-test/bgc-test.sh --layer L1 --gate immediate |
Services: Staging server 164.52.215.5 SSH: ~/.ssh/id_e2e_staging System: ssh, jq, curl |
00-BGC-GROUP/Tools/bgc-test/bgc-test.sh |
bgc-test-evidence-sync |
Test Evidence Dual Sync | testing | python | Dual sync: bgc-test evidence to Forgejo AND db1. Commits output/*.json to bgc-test-standalone repo, POSTs to db1 test_evidence table via PostgREST. | python further_more_tools/bgc-test-evidence-sync.py --git-only |
Keychain: BVS_db1_jwt_secret Python: requests, pyjwt Services: db1.bvs.technology (PostgREST) System: git |
00-BGC-GROUP/Tools/further_more_tools/bgc-test-evidence-sync.py |
bookstack-page |
BookStack Page Operations | wiki | python | BookStack page/book/chapter/attachment operations — create books, chapters, pages, upload media, list contents. Supports HTML file input. Auth via keychain.py. | python more_tools/bookstack-page.py create-page --book-id 1 --name 'Page Title' --html ' |
Keychain: BVS_wiki_api_token Python: requests Services: wiki.bvs.technology (BookStack) |
00-BGC-GROUP/Tools/more_tools/bookstack-page.py |
wiki-orchestrator |
Wiki BookStack Orchestrator | wiki | python | Modular wiki orchestrator for page creation, Mermaid screening, BLOCK/REDACT scanning, metadata surveillance, compliance reporting. Commands: screen-mermaid, scan-redact, audit-wiki, audit-bulk, route, create-page, full-audit. | python wiki-bookstack-orchestrator/orchestrator.py full-audit |
Keychain: BVS_wiki_api_token, BVS_Forgejo_API_token_v2000_MD Python: requests, pyyaml Services: wiki.bvs.technology (BookStack), git.bvs.technology (Forgejo) |
00-BGC-GROUP/Tools/wiki-bookstack-orchestrator/orchestrator.py |
wiki-orchestrator-config |
Wiki Orchestrator Configuration | wiki | python | Configuration module for wiki orchestrator. BookStack API endpoints, Book ID routing table, BLOCK/REDACT pattern definitions for MTH-030 credential hiding. | Imported by orchestrator.py — not standalone |
None | 00-BGC-GROUP/Tools/wiki-bookstack-orchestrator/config.py |
wiki-publish-ready |
Wiki Publish-Ready Scanner | wiki | python | Publish documents to BookStack wiki with BLOCK/REDACT scanning, Mermaid routing, verification. Filters sensitive data (IPs, credentials, TOTP). MTH-030/043/044. | python further_more_tools/wiki-publish-ready.py --scan --publish |
Keychain: BVS_wiki_api_token Python: requests, pyyaml Services: wiki.bvs.technology (BookStack) |
00-BGC-GROUP/Tools/further_more_tools/wiki-publish-ready.py |
wiki-remediate |
Wiki Remediation Tool | wiki | python | Wiki remediation — repairs BookStack metadata, validates page hierarchy, cleans up orphaned pages. | python further_more_tools/wiki-remediate.py --audit --fix |
Keychain: BVS_wiki_api_token Python: requests Services: wiki.bvs.technology (BookStack) |
00-BGC-GROUP/Tools/further_more_tools/wiki-remediate.py |
incident-aging-enforcer-v2 DEPRECATED DUP OF incident-aging-enforcer |
Incident SLA Enforcer (Versioned) | compliance | python | Incident SLA enforcer with versioned naming (EXE-021). 5-day escalation, 7-day auto-close with exemptions (BLOCKED/PENDING_USER/LEGAL_HOLD/REGULATORY). Reversal tracking, audit logging. | python further_more_tools/BGC-INF-EXE-021-Incident_Aging_Enforcer-20260116.py |
Keychain: BVS_Forgejo_API_token_v2000_MD Python: requests Services: git.bvs.technology (Forgejo) |
00-BGC-GROUP/Tools/further_more_tools/BGC-INF-EXE-021-Incident_Aging_Enforcer-20260116.py |
bgc-test-standalone DEPRECATED DUP OF bgc-test |
Binary Readiness Gates (Standalone) | testing | shell | Standalone version of bgc-test for isolated testing without repo dependencies. Duplicate of bgc-test. Produces JSON evidence in output/. | bash bgc-test-standalone/bgc-test.sh |
Services: Staging server 164.52.215.5 SSH: ~/.ssh/id_e2e_staging System: ssh, jq, curl |
00-BGC-GROUP/Tools/bgc-test-standalone/bgc-test.sh |
BGC Tool Registry v1.0.0 — Source: MTH-056 v1.1.0 (Grounded Theory: Convenience Drift)