🎲 Flatline Codex API

Rick's 4D Memoir Organization System

🔥 Most Used Endpoints:
GET /viz - Interactive 4D content explorer
GET /api/tesseract/memoir-readiness - Check memoir production status
GET /api/inload/mining-dashboard - View unprocessed content
GET /api/tags/consolidation-status - Tag cleanup progress

Visualization & Dashboard

GET /viz
Interactive bubble chart showing content across Structure × Transmission × Purpose × Terrain dimensions.
Example:
http://localhost:5050/viz
GET /viz-clusters
Cluster visualization showing natural content groupings by 4D coordinates with quality metrics.
Example:
http://localhost:5050/viz-clusters

Training Data Analysis

GET /api/training/summary
Overall training results from 30-file analysis including quality distributions and memoir potential.
Example:
curl http://localhost:5050/api/training/summary
GET /api/training/high-quality
Fetch chunks above quality threshold, optionally filtered by theme.
min_score (60), max_results (50), theme_filter (optional)
Example:
curl "http://localhost:5050/api/training/high-quality?min_score=80&max_results=20"
GET /api/training/chunks/search
Search training chunks with multiple filters: text, theme, quality, coordinates.
query, theme, min_score, coordinate, max_results (100)
Example:
curl "http://localhost:5050/api/training/chunks/search?query=recovery&min_score=50"

Tag Management

GET /api/tags/audit
Comprehensive tag analysis: total tags, instances, top 50, unique list.
Example:
curl http://localhost:5050/api/tags/audit
GET /api/tags/consolidation-status
Current tag consolidation status with completeness percentage and next steps.
Example:
curl http://localhost:5050/api/tags/consolidation-status
POST /api/tags/consolidate
Consolidate tags redundant with Tesseract coordinates.
dry_run (true)
Example (dry run):
curl -X POST "http://localhost:5050/api/tags/consolidate?dry_run=true"
Example (execute):
curl -X POST "http://localhost:5050/api/tags/consolidate?dry_run=false"
POST /api/tags/execute-technical-cleanup
Remove technical artifacts and standardize formats.
dry_run (true)
Example:
curl -X POST "http://localhost:5050/api/tags/execute-technical-cleanup?dry_run=true"

Tesseract 4D System

4D Dimensions:
X (Structure): archetype, protocol, shadowcast, expansion, summoning
Y (Transmission): narrative, text, reference, data
Z (Purpose): tell-story, help-addict, prevent-death, financial-amends, help-world
W (Terrain): obvious, complicated, complex, chaotic, confused
POST /api/tesseract/extract-coordinates
Map entire codex into 4D space with dimensional distributions and memoir spine candidates.
Example:
curl -X POST http://localhost:5050/api/tesseract/extract-coordinates
GET /api/tesseract/memoir-readiness
Comprehensive memoir readiness using 4D analysis with production recommendations.
Example:
curl http://localhost:5050/api/tesseract/memoir-readiness

Content Analysis

POST /api/analysis/content-fingerprint
Create content fingerprints: document archetypes, structural signatures, cross-references.
Example:
curl -X POST http://localhost:5050/api/analysis/content-fingerprint
GET /api/analysis/memoir-readiness
Assess memoir production readiness with content inventory and missing chapters.
Example:
curl http://localhost:5050/api/analysis/memoir-readiness

_inload Content Mining

GET /api/inload/mining-dashboard
Comprehensive _inload status: quality distribution, themes, processing recommendations.
Example:
curl http://localhost:5050/api/inload/mining-dashboard
POST /api/inload/scan-content
Scan all _inload directories with classifications: high_value, memoir_gold, recovery_threads.
Example:
curl -X POST http://localhost:5050/api/inload/scan-content
GET /api/inload/priority-files
Get priority files from category for manual review.
category (high_value), limit (20)
Example:
curl "http://localhost:5050/api/inload/priority-files?category=memoir_gold&limit=10"
POST /api/inload/batch-move
Batch move files with backup. Body: [{source_path, destination_path}]
Example:
curl -X POST http://localhost:5050/api/inload/batch-move \
  -H "Content-Type: application/json" \
  -d '{"moves":[{"source_path":"_inload/file1.md","destination_path":"memoir/file1.md"}]}'

Snippet Processing

POST /api/snippets/analyze
Analyze ChatGPT snippet quality and suggest reorganization.
quality_threshold (20)
Example:
curl -X POST "http://localhost:5050/api/snippets/analyze?quality_threshold=30"
GET /api/snippets/stats
Statistics on snippet extraction: efficiency metrics, quality distribution.
Example:
curl http://localhost:5050/api/snippets/stats

Common Patterns

Dry Run: Most POST endpoints default to dry_run=true for preview.

Backups: File operations auto-create backups unless disabled.

Quality: 80+ = memoir gold, 50+ = medium, <20 = low.

Flatline Codex API - Base: http://localhost:5050