{"id":34944196,"url":"https://github.com/codenlighten/lumen-sdk","last_synced_at":"2026-05-20T20:11:03.447Z","repository":{"id":326742117,"uuid":"1105448061","full_name":"codenlighten/lumen-sdk","owner":"codenlighten","description":null,"archived":false,"fork":false,"pushed_at":"2025-11-29T19:59:53.000Z","size":56,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-01T23:57:47.991Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/codenlighten.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-27T16:12:24.000Z","updated_at":"2025-11-30T23:00:52.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/codenlighten/lumen-sdk","commit_stats":null,"previous_names":["codenlighten/lumen-sdk"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/codenlighten/lumen-sdk","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codenlighten%2Flumen-sdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codenlighten%2Flumen-sdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codenlighten%2Flumen-sdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codenlighten%2Flumen-sdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/codenlighten","download_url":"https://codeload.github.com/codenlighten/lumen-sdk/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codenlighten%2Flumen-sdk/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33273744,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-20T15:12:43.734Z","status":"ssl_error","status_checked_at":"2026-05-20T15:12:42.300Z","response_time":356,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-12-26T19:45:09.831Z","updated_at":"2026-05-20T20:11:03.441Z","avatar_url":"https://github.com/codenlighten.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🌉 Lumen SDK \u0026 Project Factory\n\n[![License: Proprietary](https://img.shields.io/badge/License-Proprietary-red.svg)](./LICENSE)\n[![Node.js](https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen)](https://nodejs.org/)\n[![Lumen Bridge](https://img.shields.io/badge/Powered%20by-Lumen%20Bridge-blue)](https://lumenbridge.codenlighten.org)\n[![Patents Pending](https://img.shields.io/badge/Patents-Pending-orange.svg)](./LICENSE)\n\n**Build entire production-ready applications from natural language descriptions using AI agents.**\n\nThe Lumen SDK provides a powerful project factory that transforms your ideas into fully-structured, deployable codebases through an intelligent multi-agent workflow.\n\n---\n\n## 🚀 What Is This?\n\nThis repository contains:\n\n1. **LumenSDK.js** - A clean JavaScript SDK for interacting with [Lumen Bridge](https://lumenbridge.codenlighten.org), a self-aware agent platform\n2. **ProjectBuilder** - An intelligent project factory that uses AI agents to architect, plan, and generate complete applications\n3. **Example Projects** - Real, working applications generated entirely by AI agents\n\n### The Magic\n\n```javascript\nconst builder = new ProjectBuilder({\n    userId: \"your-user-id\",\n    outputDir: \"./my-awesome-app\"\n});\n\nawait builder.build(\"Create a real-time chat app with end-to-end encryption using ECIES\");\n```\n\n**That's it.** The system will:\n- ✨ Improve and clarify your prompt\n- 🏗️ Design the complete architecture\n- 📋 Create a chronological build plan\n- 💾 Generate production-ready code files\n- 🔧 Set up dependencies and configuration\n\n---\n\n## 🎯 Features\n\n### Intelligent Multi-Agent Workflow\n\n```\nYour Idea → PromptImprover → ProjectArchitect → ChronosPlanner → CodeGenerator → 📦 Complete Project\n```\n\n| Agent | Purpose |\n|-------|---------|\n| **PromptImprover** | Analyzes your idea, identifies core features, suggests tech stack, highlights challenges |\n| **ProjectArchitect** | Designs file structure, defines modules, specifies dependencies, plans data flow |\n| **ChronosPlanner** | Creates ordered build steps, handles dependencies, sequences file generation |\n| **CodeGenerator** | Produces production-ready code with best practices, tests, and documentation |\n\n### What Makes It Powerful\n\n- 🧠 **Context-Aware**: Understands complex, multi-paragraph requirements\n- 🏛️ **Architecture-First**: Plans before coding (files, modules, dependencies)\n- 📝 **Production-Ready**: Generates real, working code with error handling\n- 🧪 **Test-Included**: Unit tests generated alongside implementation\n- 🔄 **Reusable**: One class, infinite projects\n- 🎨 **Smart Patterns**: Follows best practices for each technology\n- 📦 **Dependency Management**: Automatically identifies and lists required packages\n\n---\n\n## 📦 Installation\n\n```bash\n# Clone the repository\ngit clone https://github.com/codenlighten/lumen-sdk.git\ncd lumen-sdk\n\n# Install dependencies\nnpm install\n\n# Add your Lumen Bridge user ID to BuildProject.js\n```\n\n### Prerequisites\n\n- Node.js v20+ (for native fetch support)\n- A Lumen Bridge account ([register here](https://lumenbridge.codenlighten.org))\n- Your Lumen Bridge `userId`\n\n---\n\n## 🎮 Quick Start\n\n### 1. Basic Usage\n\n```javascript\nimport { ProjectBuilder } from './BuildProject.js';\n\nconst builder = new ProjectBuilder({\n    userId: \"user-dev-01\",\n    outputDir: \"./my-project\"\n});\n\nconst projectIdea = `\nCreate a task management API with user authentication,\nproject workspaces, and real-time notifications.\n`;\n\nconst result = await builder.build(projectIdea);\n\nconsole.log(`Generated ${result.architecture.fileTree.length} files!`);\n```\n\n### 2. Run the Example\n\n```bash\n# Edit BuildProject.js to set your userId\n# Then run:\nnpm run build\n```\n\nThis will generate a complete project in the specified output directory.\n\n---\n\n## 🏗️ Example Projects\n\n### 1. ECIES Chat Application\n\n**Input**: \"An end-to-end encrypted chat app using ECIES and Bitcoin SV extended keys\"\n\n**Generated**:\n- 17 files across frontend/backend\n- User identity with BIP32 xpub\n- ECIES message encryption\n- WebSocket real-time delivery\n- Multi-device support\n- Voice message architecture\n\n📁 [`ecies-chat-app/`](./ecies-chat-app)\n\n### 2. AI Legal Document Analysis Platform\n\n**Input**: A complex, paragraph-length description with 30+ requirements\n\n**Generated**:\n- 29 files with TypeScript\n- OpenAI GPT-4 integration\n- Real-time collaboration (Socket.io)\n- OAuth2 + JWT authentication\n- Role-based access control\n- Document upload with OCR\n- Risk scoring visualization\n- Multi-tenant architecture\n- Stripe billing integration\n- 509 lines of production code\n\n📁 [`complex-ai-project/`](./complex-ai-project)\n\n---\n\n## 🔧 How It Works\n\n### The Four-Phase Workflow\n\n#### Phase 0: Prompt Improvement\n```\nYour idea → AI analysis → Enhanced technical specification\n```\n\nThe **PromptImprover** agent:\n- Identifies core features\n- Suggests appropriate tech stack\n- Highlights architectural considerations\n- Clarifies ambiguous requirements\n\n#### Phase 1: Architecture Design\n```\nEnhanced spec → System design → File structure + Modules\n```\n\nThe **ProjectArchitect** agent:\n- Designs complete file tree\n- Defines module interfaces (inputs/outputs)\n- Specifies dependencies\n- Plans data flow\n\n#### Phase 2: Build Planning\n```\nArchitecture → Ordered steps → Executable plan\n```\n\nThe **ChronosPlanner** agent:\n- Creates chronological steps\n- Handles dependency ordering\n- Generates install commands\n- Sequences file creation\n\n#### Phase 3: Code Generation\n```\nBuild plan → Code generation → Working files\n```\n\nThe **CodeGenerator** executes:\n- Creates directories\n- Generates code files\n- Writes configuration\n- Sets up package.json\n\n### Architecture Diagram\n\n```\n┌─────────────────────────────────────────────────────────┐\n│                    ProjectBuilder                        │\n├─────────────────────────────────────────────────────────┤\n│                                                          │\n│  ┌────────────┐  ┌──────────────┐  ┌──────────────┐   │\n│  │  Prompt    │→ │  Project     │→ │  Chronos     │   │\n│  │  Improver  │  │  Architect   │  │  Planner     │   │\n│  └────────────┘  └──────────────┘  └──────────────┘   │\n│         │                │                  │           │\n│         └────────────────┴──────────────────┘           │\n│                          ↓                               │\n│                  ┌──────────────┐                       │\n│                  │    Code      │                       │\n│                  │  Generator   │                       │\n│                  └──────────────┘                       │\n│                          ↓                               │\n└─────────────────────────┬────────────────────────────────┘\n                          ↓\n                   📦 Complete Project\n```\n\n---\n\n## 🎨 Advanced Usage\n\n### Custom Agent Configuration\n\n```javascript\nconst builder = new ProjectBuilder({\n    userId: \"your-id\",\n    outputDir: \"./output\"\n});\n\n// Agents are registered automatically\n// You can also register custom agents via LumenSDK\nawait builder.bridge.registerAgent(\n    \"MyCustomAgent\",\n    \"Specialized for XYZ tasks\",\n    \"Your custom prompt here...\"\n);\n```\n\n### Reusing the Builder\n\n```javascript\nconst builder = new ProjectBuilder({ userId: \"your-id\" });\n\n// Build multiple projects\nawait builder.build(\"Create a blog platform\");\nawait builder.build(\"Create an e-commerce API\");\nawait builder.build(\"Create a real-time dashboard\");\n```\n\n### Accessing Build Results\n\n```javascript\nconst result = await builder.build(projectIdea);\n\nconsole.log(result.improved);        // Enhanced prompt details\nconsole.log(result.architecture);    // File tree, modules, dependencies\nconsole.log(result.buildSteps);      // Execution steps\nconsole.log(result.outputDir);       // Where files were created\n```\n\n---\n\n## 📚 LumenSDK Reference\n\n### Core Methods\n\n```javascript\nimport { LumenBridge } from './LumenSDK.js';\n\nconst bridge = new LumenBridge({\n    userId: \"your-user-id\",\n    baseUrl: \"https://lumenbridge.codenlighten.org\" // optional\n});\n\n// System Agents\nawait bridge.terminal(task, shell);\nawait bridge.generateCode(prompt, language, framework);\nawait bridge.generateSchema(userPrompt);\n\n// User Agent Management\nawait bridge.registerAgent(name, description, prompt, metadata);\nawait bridge.updateAgent(name, updates);\nawait bridge.invokeUserAgent(agentName, context);\nawait bridge.getMyAgents();\nawait bridge.deleteAgent(agentName);\n```\n\n### Agent Responses\n\nAll agents return cryptographically signed responses with:\n- ✍️ BSV-ECDSA-DER signatures\n- 📊 LLM usage metrics (tokens, model, elapsed time)\n- 🔐 Verifiable authenticity\n\n---\n\n## 🌟 Real-World Examples\n\n### Example 1: Microservice API\n\n```javascript\nconst result = await builder.build(`\nCreate a RESTful microservice for user management with:\n- PostgreSQL database\n- JWT authentication\n- Role-based permissions\n- Password reset via email\n- Rate limiting\n- Docker deployment\n`);\n\n// Generated: 15 files, Express API, complete auth system\n```\n\n### Example 2: React Dashboard\n\n```javascript\nconst result = await builder.build(`\nBuild a React dashboard with:\n- TypeScript\n- Chart.js visualizations\n- Real-time updates via WebSocket\n- Dark mode\n- Responsive design\n- Redux state management\n`);\n\n// Generated: 23 files, complete React app with state management\n```\n\n### Example 3: Blockchain Integration\n\n```javascript\nconst result = await builder.build(`\nCreate a Bitcoin SV wallet interface with:\n- Key generation (BIP32/BIP39)\n- Transaction building\n- UTXO management\n- BSV price tracking\n- Transaction history\n- QR code support\n`);\n\n// Generated: 18 files, crypto utilities, wallet logic\n```\n\n---\n\n## 🔍 What Gets Generated?\n\n### Typical Project Structure\n\n```\nyour-project/\n├── src/                     # Frontend source\n│   ├── components/          # React components\n│   ├── services/            # API clients\n│   ├── utils/               # Helper functions\n│   └── hooks/               # Custom React hooks\n├── backend/                 # Backend source\n│   ├── controllers/         # Request handlers\n│   ├── models/              # Database models\n│   ├── routes/              # API routes\n│   ├── services/            # Business logic\n│   ├── middleware/          # Express middleware\n│   └── config/              # Configuration\n├── public/                  # Static assets\n├── tests/                   # Unit tests\n├── package.json             # Dependencies\n├── README.md                # Documentation\n└── .env.example             # Environment template\n```\n\n### Code Quality\n\nGenerated code includes:\n- ✅ Input validation\n- ✅ Error handling\n- ✅ Try/catch blocks\n- ✅ JSDoc comments\n- ✅ Type safety (when using TypeScript)\n- ✅ Unit test scaffolding\n- ✅ Best practices for chosen framework\n\n---\n\n## 🤖 Supported Technologies\n\n### Backend\n- Node.js / Express\n- Python / Django / Flask\n- MongoDB / PostgreSQL / MySQL\n- Redis / Bull (job queues)\n- WebSocket / Socket.io\n- GraphQL / REST APIs\n\n### Frontend\n- React / TypeScript\n- Vue.js / Angular\n- Next.js / Vite\n- Redux / Context API\n- Tailwind CSS\n- Chart.js / D3.js\n\n### DevOps \u0026 Tools\n- Docker / docker-compose\n- GitHub Actions (CI/CD)\n- Jest / Mocha (testing)\n- ESLint / Prettier\n- Nginx / Apache\n\n### Integrations\n- OpenAI API\n- Stripe payments\n- SendGrid emails\n- AWS S3\n- OAuth2 providers\n- BSV blockchain\n\n---\n\n## 📖 Documentation\n\n### Configuration Options\n\n```javascript\nnew ProjectBuilder({\n    userId: string,          // Required: Your Lumen Bridge user ID\n    outputDir: string,       // Optional: Default \"./generated-project\"\n})\n```\n\n### Environment Variables\n\nCreate a `.env` file:\n\n```env\nLUMEN_USER_ID=your-user-id\nOPENAI_API_KEY=sk-...        # If using OpenAI features\n```\n\n---\n\n## 🎯 Use Cases\n\n### Perfect For:\n\n- 🚀 **Rapid Prototyping**: Go from idea to working code in minutes\n- 🏗️ **Learning**: See how complete applications are structured\n- 💡 **Exploration**: Try different architectures without manual coding\n- 📚 **Boilerplate**: Generate starter projects with best practices\n- 🔬 **Experimentation**: Test architectural concepts quickly\n- 📝 **Documentation**: Generate well-documented code examples\n\n### Not Meant For:\n\n- Production deployment without review\n- Mission-critical systems without testing\n- Replacing software engineering expertise\n- Legal/medical/financial advice in generated code\n\n---\n\n## 🛠️ Troubleshooting\n\n### Common Issues\n\n**Error: \"Agent not found\"**\n```javascript\n// Solution: Agents are auto-registered on first build\n// If error persists, try:\nawait builder.registerAgents();\n```\n\n**Error: \"MODULE_NOT_FOUND\"**\n```bash\n# Ensure Node.js v20+\nnode --version\n\n# Reinstall dependencies\nrm -rf node_modules package-lock.json\nnpm install\n```\n\n**Error: \"Invalid user ID\"**\n```javascript\n// Register at https://lumenbridge.codenlighten.org\n// Get your userId from the dashboard\n```\n\n---\n\n## 🤝 Contributing\n\nContributions welcome! This is an experimental project showcasing AI-powered code generation.\n\n### Ways to Contribute:\n\n1. 🐛 Report bugs or issues\n2. 💡 Suggest new agent types\n3. 📝 Improve documentation\n4. 🎨 Share generated projects\n5. 🔧 Enhance the SDK\n\n---\n\n## 📜 License\n\n**Proprietary License** - All Rights Reserved\n\nThis software contains proprietary information and trade secrets. Patents pending.\n\nSee [LICENSE](LICENSE) file for complete terms and restrictions.\n\nFor licensing inquiries, contact via GitHub or Lumen Bridge.\n\n---\n\n## 🙏 Acknowledgments\n\n- **Lumen Bridge Platform**: Powering the intelligent agent system\n- **OpenAI**: GPT-4 model for code generation\n- **BSV Blockchain**: For cryptographic primitives and identity\n- **SmartLedger**: For inspiration on verifiable systems\n\n---\n\n## 📬 Contact \u0026 Author\n\n### 👨‍💻 Author\n\n**Gregory Ward (CodenLighten)**  \nChief Development Officer \u0026 Co-Founder  \n[github.com/codenlighten](https://github.com/codenlighten)\n\n**Organizations:**\n- [SmartLedger.Technology](https://smartledger.technology)\n- [Codenlighten.org](https://codenlighten.org)\n\n**Platform:**\n- 🌐 [Lumen Bridge Platform](https://lumenbridge.codenlighten.org)\n- 📧 Contact via Lumen Bridge\n\n---\n\n## 🌟 Star History\n\nIf this project helps you build faster, give it a ⭐!\n\n---\n\n## 🔮 Roadmap\n\n- [ ] Support for more languages (Python, Go, Rust)\n- [ ] Visual architecture diagrams generation\n- [ ] Interactive project customization\n- [ ] One-click deployment integrations\n- [ ] Version control integration\n- [ ] Cost estimation for infrastructure\n- [ ] Security audit agent\n- [ ] Performance optimization suggestions\n- [ ] API documentation generation\n- [ ] Mobile app generation (React Native)\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Built with ❤️ using AI Agents**\n\n*Transform ideas into reality, one build at a time.*\n\n[![Lumen Bridge](https://img.shields.io/badge/Try-Lumen%20Bridge-blue?style=for-the-badge)](https://lumenbridge.codenlighten.org)\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodenlighten%2Flumen-sdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodenlighten%2Flumen-sdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodenlighten%2Flumen-sdk/lists"}