This directory contains metadata, workflows, and configuration files for repository optimization and AI agent discoverability.
metadata.jsonld- JSON-LD structured metadata (Schema.org SoftwareSourceCode)seo_metadata.html- Open Graph and Twitter Card metadataQUICK_REFERENCE.md- Quick reference for repository optimization
auto-label-issues.yml- Automatically labels new issues based on contentreindex-embeddings.yml- Daily re-indexing of README/docs for vector searchrepo-maintenance.yml- Weekly repository maintenance and statistics
This directory supports the "Repository Beacon-Worm" initiative to make the LJV Visual Engine repository:
- Discoverable by human developers through SEO optimization
- Parseable by AI agents through structured metadata
- Maintained through automated workflows
- Shareable through social media metadata
Add these to GitHub → Settings → Secrets → Actions:
OPENAI_API_KEY=sk-...
PINEcone_API_KEY=...
PINEcone_ENVIRONMENT=us-west1-gcpAdd these topics to the repository:
music-visualization, lyric-video, audio-reactive, ffmpeg, python,
video-pipeline, music-production, whisper-asr, checkpoint-recovery
Automatically applies labels:
good first issue- Beginner-friendly contributionsdocumentation- Docs-related issuesexamples- Template and sample code issues
- Extracts text from README and documentation
- Generates OpenAI embeddings
- Stores in Pinecone vector database
- Collects repository statistics
- Marks stale issues/PRs
- Generates weekly report
For detailed information:
- Implementation Guide:
09_DOCS/REPOSITORY_OPTIMIZATION_GUIDE.md - Setup Checklist:
09_DOCS/BEACON_WORM_CHECKLIST.md - Quick Reference:
QUICK_REFERENCE.md
Repository metadata can be accessed programmatically:
# Run API server
python 05_SCRIPTS/tools/repo_api.py
# Access endpoints
curl http://localhost:8000/repo-info
curl http://localhost:8000/features
curl http://localhost:8000/metadata/jsonldSee CONTRIBUTING.md for contribution guidelines or open an issue for questions.