{"id":30390078,"url":"https://github.com/angelosdimakos/ideas_logger","last_synced_at":"2025-08-21T09:12:45.287Z","repository":{"id":288403837,"uuid":"952821361","full_name":"angelosdimakos/Ideas_Logger","owner":"angelosdimakos","description":"AI-powered code and idea assistant for developers: local-first, doc-aware, and fully test-automated.","archived":false,"fork":false,"pushed_at":"2025-08-09T18:55:49.000Z","size":99349,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-09T20:33:52.224Z","etag":null,"topics":["ai-assistant","automated-testing","cli-tool","code-quality","developer-tools","docstring-documentation","intelligent-logging","local-llm-integration","mkdocs","python","summarizer"],"latest_commit_sha":null,"homepage":"https://angelosdimakos.github.io/Ideas_Logger/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/angelosdimakos.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":"audit_backups/refactor_audit_20250419_073941.json","citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-03-22T00:17:15.000Z","updated_at":"2025-05-18T14:04:31.000Z","dependencies_parsed_at":"2025-08-09T20:32:50.424Z","dependency_job_id":null,"html_url":"https://github.com/angelosdimakos/Ideas_Logger","commit_stats":null,"previous_names":["angelosdimakos/ideas_logger"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/angelosdimakos/Ideas_Logger","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/angelosdimakos%2FIdeas_Logger","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/angelosdimakos%2FIdeas_Logger/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/angelosdimakos%2FIdeas_Logger/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/angelosdimakos%2FIdeas_Logger/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/angelosdimakos","download_url":"https://codeload.github.com/angelosdimakos/Ideas_Logger/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/angelosdimakos%2FIdeas_Logger/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271455362,"owners_count":24762703,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-21T02:00:08.990Z","response_time":74,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["ai-assistant","automated-testing","cli-tool","code-quality","developer-tools","docstring-documentation","intelligent-logging","local-llm-integration","mkdocs","python","summarizer"],"created_at":"2025-08-21T09:12:41.524Z","updated_at":"2025-08-21T09:12:45.274Z","avatar_url":"https://github.com/angelosdimakos.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# 🚀 Ideas Logger — From Thought to Engineering Artifact\n\n[![codecov](https://codecov.io/gh/angelosdimakos/Ideas_Logger/branch/main/graph/badge.svg?token=C49N6JTFXY)](https://codecov.io/gh/angelosdimakos/Ideas_Logger)\n[![License: APACHE](https://img.shields.io/badge/License-APACHE-yellow.svg)](LICENSE)\n[![CI Status](https://img.shields.io/badge/CI-Passing-brightgreen.svg)]()\n\n\u003e `python` • `ollama` • `faiss` • `streamlit` • `llm` • `semantic_search` • `ci_cd` • `knowledge_graph` • `refactoring_toolkit`\n\n---\n\n\u003e **Engineer Thought. Automate Refactoring. Visualize Knowledge.**\n\u003e Ideas Logger is a production-hardened, AI-augmented code and idea management ecosystem.\n\u003e **No cloud lock-in. Fully local-first. Extreme engineering discipline enforced.**\n\n---\n\n## 🌐 Platform Capabilities\n\nIdeas Logger is an intelligent, modular platform for managing ideas, analyzing codebases, and automating refactoring workflows.\n\nIt integrates:\n\n* 🤖 **Local LLM-Driven Summarization** (Ollama w/ fallback mechanisms)\n* 🔍 **FAISS-Powered Semantic Search** for raw logs and summaries\n* 📚 **Knowledge Graph Generation** from codebase relationships and docstrings\n* 🛠️ **Automated Prototype \u0026 Test Stub Generation** (Production-Scaffold Ready)\n* 📈 **Full CI Analyzer \u0026 Refactor Guard** with quality trend monitoring\n* 🖥️ **Streamlit Dashboards \u0026 Tkinter GUI** for visual exploration\n* 🔌 **Plugin-Ready Architecture** for mind maps, cognitive load diagrams, and trend visualizations\n\n\u003e *From a single thought to a validated engineering artifact — Ideas Logger connects the dots.*\n\n---\n\n## 🏗️ System Architecture\n\n### 🚧 Production Pipeline\n\n```mermaid\ngraph TD\nA[User Input / Logs] --\u003e|Summarization| B[LLM Pipeline]\nB --\u003e C[\"Semantic Indexing (FAISS)\"]\nC --\u003e D[Search \u0026 Retrieval]\nD --\u003e E[Prototype + Test Stub Generation]\nE --\u003e F[CI Analyzer / Refactor Guard]\n```\n\n### 🔬 Test \u0026 CI Workflow\n\n```mermaid\ngraph TD\nG[Generated Code Artifacts] --\u003e H[Test Stub Automation]\nH --\u003e I[Pytest / CI Validators]\nI --\u003e J[Streamlit Dashboard Audit]\nJ --\u003e K[Coverage \u0026 Complexity Reports]\n```\n\n---\n\n## ⚙️ Feature Highlights\n\n| Category                 | Feature Description                                              |\n| ------------------------ | ---------------------------------------------------------------- |\n| 🤖 AI Summarization      | LLM-powered entry and bulk summaries (Ollama + fallback)         |\n| 🔍 Semantic Search       | FAISS top-k vector retrieval for raw logs and summaries          |\n| 📚 Knowledge Graph       | Codebase graph visualization with cyclomatic complexity overlays |\n| 🛠️ Prototype Automation | Production-level scaffold generation + pytest stubs              |\n| 📈 CI Analyzer           | Severity audits, complexity metrics, and trend reporting         |\n| 🖥️ Multi-Interface      | Tkinter GUI, CLI Tools, Streamlit Dashboards                     |\n| 🔒 Security              | Mocked AI backends, isolated test configs, subprocess isolation  |\n\n---\n\n## 📦 Project Structure\n\n```plaintext\nscripts/\n├── core/            # Centralized Logging \u0026 Summarization Engines\n├── ai/              # LLM Integration, Prompt Management, Fallbacks\n├── gui/             # Tkinter GUI + Streamlit Dashboards\n├── config/          # Dynamic Config Manager (with Test Mode Override)\n├── indexers/        # FAISS Semantic Indexing Modules\n├── ci_analyzer/     # CI Audit \u0026 Trend Visualization Tools\n├── refactor/        # Complexity Analysis, Refactoring Toolkit, Quality Audits\n├── kg/              # Knowledge Graph Construction \u0026 Visualization\ntests/\n├── unit/            # Component-Level Unit Tests\n├── integration/     # End-to-End Workflow Tests\n├── mocks/           # LLM \u0026 Filesystem Mocks for CI Pipelines\n```\n\n---\n\n## 🧪 Engineering Discipline\n\n* ✅ Full Mocking of AI Dependencies (`ollama.generate`, `ollama.chat`)\n* ✅ Tkinter GUI Headless Testing via `xvfb` in CI Pipelines\n* ✅ Persistent JSON Artifacts: Lint Reports, Doc Summaries, Complexity Metrics\n* ✅ Diff-Based Audits with RefactorGuard + CI Analyzer\n* ✅ Prototype and Test Stub Auto-Generation Enforced via Code Quality Metrics\n* ✅ UTF-8 Subprocess Isolation to Eliminate Platform Drift\n\n\u003e *Result: Zero hidden dependencies. Fully portable. Fully testable. Verified at every stage.*\n\n---\n\n## 🔌 Extension Ready\n\n* 📊 Add Custom Plugins (LangChain Agents, Graph Visualizers, Mind Maps)\n* 📂 Extend Config Schemas for New Logging Paradigms\n* 🧠 Introduce Advanced LLM Prompt Personas for Specialized Summarization\n* 📅 Future-Proof with Gantt Chart Integration and Cognitive Load Visualizers\n\n---\n\n## 🚀 Quickstart\n\n```bash\ngit clone https://github.com/angelosdimakos/Ideas_Logger.git\ncd Ideas_Logger\npip install -r requirements.txt\npython scripts/main.py\n```\n\n\u003e ⚠️ Ensure [Ollama](https://ollama.com/) is installed and a model (e.g., `mistral`) is running:\n\u003e\n\u003e ```bash\n\u003e ollama run mistral\n\u003e ```\n\n---\n\n## 🌍 Roadmap\n\n* [x] AI Summarization with Local Fallbacks\n* [x] Semantic Indexing for Raw Logs and Summaries\n* [x] Knowledge Graph Generation from Codebase Structures\n* [x] Full CI Audit with Trend Visualization Dashboards\n* [x] Prototype + Test Stub Auto-Generation (Production-Scaffold Ready)\n* [ ] Gantt Timeline View for Process Visualization\n* [ ] Interactive Mind Map with Drag-and-Drop Thought Structuring\n* [ ] Plugin Marketplace for Community Extensions\n\n---\n\n## 🔒 License\n\nLicensed under the [APACHE License](LICENSE).\nBuild freely. Attribute respectfully.\n\n---\n\n## 🧙‍♂️ Final Word\n\n\u003e **Ideas Logger is not a note-taking app.**\n\u003e It’s a fully autonomous **Knowledge Engineering System**.\n\u003e Built for engineers, researchers, and visionaries who demand control, clarity, and uncompromising technical rigor over their thinking processes.\n\n\u003e **Structured Thought. Resilient Engineering. No Compromises.**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fangelosdimakos%2Fideas_logger","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fangelosdimakos%2Fideas_logger","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fangelosdimakos%2Fideas_logger/lists"}