tractatus/scripts
TheFlow b38738fe3c feat: add script to deploy architectural overview document
This script adds the comprehensive architectural overview to the documentation
system with MongoDB integration and PDF generation.

## Purpose

Deploy architectural-overview.md to public-facing documentation at
https://agenticgovernance.digital/docs.html with PDF download.

## Implementation

**Script**: scripts/add-architectural-overview-doc.js

**Features**:
- Parses markdown into 18 sections
- Creates MongoDB document entry
- Generates professional PDF with Puppeteer
- Includes metadata (v1.0.0, 2025-10-11, Phase 5 Complete)
- Sets order: 1 (shows first in documentation)

**Document Structure**:
- Title: "Tractatus Agentic Governance Framework"
- Subtitle: "Architectural Overview & Research Status"
- Slug: architectural-overview-and-research-status
- Category: reference
- Sections: 18 (conceptual, technical, reference)
- Version: 1.0.0

**Sections Included**:
1. Document Control & Executive Summary
2. System Architecture
3. Core Services (Governance Layer)
4. Memory Architecture (Phase 5)
5. Research Phases & Progress
6. Instruction Persistence System
7. Test Coverage & Quality Assurance
8. Production Deployment
9. Security & Privacy
10. Performance & Scalability
11. Future Research Directions
12. Lessons Learned
13. Conclusion
+ 3 Appendices (Commands, File Structure, References)

**API Memory Observations**:
- First session using Anthropic's new API Memory system documented
- Session continuity, instruction loading mechanism clarified
- Architecture confirmed: MongoDB (required) + Anthropic API (optional)
- Integration stability and performance validated

## Deployment Steps

1. Commit this script
2. Deploy to production server
3. Run: `node scripts/add-architectural-overview-doc.js` on production
4. Document appears at /docs.html with PDF download link
5. PDF available at /downloads/architectural-overview-and-research-status.pdf

## Metadata

- Version: 1.0.0 (will be versioned and updated over time)
- Classification: Research Documentation
- Status: Production-Ready Research System
- Phase: Phase 5 Complete (100% integration)
- Inception: 2024-Q3

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-11 00:44:22 +13:00
..
monitoring fix: resolve grep count handling in log monitor 2025-10-10 05:30:36 +13:00
add-architectural-overview-doc.js feat: add script to deploy architectural overview document 2025-10-11 00:44:22 +13:00
add-sections-to-documents.js feat: fix documentation system - cards, PDFs, TOC, and navigation 2025-10-07 22:51:55 +13:00
audit-accessibility.js feat: complete Phase 2 - accessibility, performance, mobile polish 2025-10-08 13:29:26 +13:00
check-color-contrast.js feat: complete Phase 2 - accessibility, performance, mobile polish 2025-10-08 13:29:26 +13:00
check-session-pressure.js feat: session management + test improvements - 73.4% → 77.6% coverage 2025-10-07 09:11:13 +13:00
clean-test-db.js fix: add Jest test infrastructure and reduce test failures from 29 to 13 2025-10-09 20:37:45 +13:00
deploy-frontend.sh feat: fix documentation system - cards, PDFs, TOC, and navigation 2025-10-07 22:51:55 +13:00
deploy-full-project-SAFE.sh security: create deployment exclusion list and safe deployment script 2025-10-09 15:47:20 +13:00
deploy-koha-to-production.sh feat: add Koha pre-production deployment configuration 2025-10-08 21:00:54 +13:00
framework-watchdog.js feat(infra): semantic versioning and systemd service implementation 2025-10-09 09:16:22 +13:00
generate-pdfs.js feat: fix documentation system - cards, PDFs, TOC, and navigation 2025-10-07 22:51:55 +13:00
generate-single-pdf.js feat(infra): semantic versioning and systemd service implementation 2025-10-09 09:16:22 +13:00
import-technical-docs.js feat(infra): semantic versioning and systemd service implementation 2025-10-09 09:16:22 +13:00
init-db.js feat: add MongoDB systemd service and database initialization 2025-10-06 23:28:42 +13:00
init-koha.js feat: implement Koha donation system frontend (Phase 3) 2025-10-08 13:56:56 +13:00
install-mongodb-service.sh feat: add MongoDB systemd service and database initialization 2025-10-06 23:28:42 +13:00
install-systemd.sh feat(infra): semantic versioning and systemd service implementation 2025-10-09 09:16:22 +13:00
migrate-appendix-documents.js feat(infra): semantic versioning and systemd service implementation 2025-10-09 09:16:22 +13:00
migrate-documents.js feat(infra): semantic versioning and systemd service implementation 2025-10-09 09:16:22 +13:00
migrate-to-memory-proxy.js feat: Phase 5 PoC Week 3 - MemoryProxy integration with Tractatus services 2025-10-10 12:22:06 +13:00
mobile-audit.js feat: complete Phase 2 - accessibility, performance, mobile polish 2025-10-08 13:29:26 +13:00
mongodb-tractatus.service feat: add MongoDB systemd service and database initialization 2025-10-06 23:28:42 +13:00
performance-audit.js feat: complete Phase 2 - accessibility, performance, mobile polish 2025-10-08 13:29:26 +13:00
pre-action-check.js feat(infra): semantic versioning and systemd service implementation 2025-10-09 09:16:22 +13:00
recover-framework.js feat(infra): semantic versioning and systemd service implementation 2025-10-09 09:16:22 +13:00
security-audit.js feat(infra): semantic versioning and systemd service implementation 2025-10-09 09:16:22 +13:00
seed-admin.js feat: add API routes, controllers, and migration tools 2025-10-07 00:36:40 +13:00
session-init.js feat: comprehensive documentation improvements and GitHub integration 2025-10-09 14:33:14 +13:00
test-production-deployment.js docs: Phase 5 integration roadmap and production deployment test 2025-10-10 12:33:57 +13:00
test-session1-integration.js feat: Session 1 - Core services integration (InstructionPersistenceClassifier + CrossReferenceValidator) 2025-10-10 12:39:58 +13:00
test-session2-integration.js feat: Session 2 - Complete framework integration (6/6 services) 2025-10-10 12:49:37 +13:00
validate-document-security.js feat(infra): semantic versioning and systemd service implementation 2025-10-09 09:16:22 +13:00
validate-public-sync.js fix: update validation script to allow legitimate public info 2025-10-09 15:23:40 +13:00