From c56e77c59c581e2c4c1c7972902faa92bc70b8c4 Mon Sep 17 00:00:00 2001 From: reachableceo Date: Thu, 30 Jul 2026 15:49:35 -0500 Subject: [PATCH] docs: reconcile stale package counts across docs MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The docs had drifted to 5/58 packaged while Corteza (and Puter) were already committed. Reconcile the headline count to 7/~57 everywhere per the new gardening protocol (GitUrlList.txt is the source of truth at 57 upstream apps). - README.md: 5/58 -> 7, add Corteza to completed table, remove false "Warp packaged" marker (duplicate, no package), Low-Code 0/3 -> 1/3, link STATUS/AGENTS. - JOURNAL.md: header + repository stats 5/58 -> 7/~57. - RESUME.md: mark superseded by STATUS.md (was 2025-01-24, referenced dead /home/tsys paths) to avoid two competing status docs. 💘 Generated with Crush Assisted-by: Crush:glm-5.2 --- JOURNAL.md | 10 +-- README.md | 25 +++--- RESUME.md | 242 +++-------------------------------------------------- 3 files changed, 32 insertions(+), 245 deletions(-) diff --git a/JOURNAL.md b/JOURNAL.md index 2e2303f..79e1ec4 100644 --- a/JOURNAL.md +++ b/JOURNAL.md @@ -2,9 +2,9 @@ ## Project Overview **Project**: TSYSDevStack-SupportStack-Cloudron -**Goal**: Package 58 applications for Cloudron PaaS platform +**Goal**: Package ~57 applications for Cloudron PaaS platform **Start Date**: 2025-01-24 -**Current Status**: 5/58 packages completed (8.6%) +**Current Status**: 7/~57 packages completed (~12%) ## Completed Packages @@ -626,11 +626,11 @@ Dockerfile ## Repository Statistics -- **Commits**: 6 packages committed to main branch +- **Commits**: 7 packages committed to main branch - **Pushes**: All pushed to remote repository - **Package directories**: Created in Package-Workspace/ -- **Total packages completed**: 5/58 (8.6%) -- **Remaining packages**: 53/58 (91.4%) +- **Total packages completed**: 7/~57 (~12%) +- **Remaining packages**: ~50/~57 (~88%) --- diff --git a/README.md b/README.md index 4c70f7d..0d3f5fc 100644 --- a/README.md +++ b/README.md @@ -8,11 +8,12 @@ The Cloudron component focuses on packaging upstream free/libre/open application ### 📊 Current Progress -- **Total Applications**: 58+ -- **Completed Packages**: 5/58 (8.6%) -- **Quick Wins**: 6/6 (100%) ✅ +- **Total Applications**: ~57 (see [GitUrlList.txt](GitUrlList.txt)) +- **Completed Packages**: 7/~57 (~12%) - **Packaging Templates**: Created ✅ -- **Packages Committed & Pushed**: 6 ✅ +- **Packages Committed & Pushed**: 7 ✅ + +> Living status is tracked in [STATUS.md](STATUS.md) (agent-maintained). ### ✅ Completed Packages @@ -24,6 +25,7 @@ The Cloudron component focuses on packaging upstream free/libre/open application | 4 | Review Board | Development | 1.29GB | 8080 | localstorage, postgresql | ✅ Committed | | 5 | WireViz Web | Documentation-Tools | 378MB | 3005 | localstorage | ✅ Committed | | 6 | Puter | Development | 361MB | 4100 | localstorage, postgresql | ✅ Committed | +| 7 | Corteza | Low-Code | 436MB | 80 | localstorage, postgresql | ✅ Committed | ### 📦 Packages in Development @@ -31,7 +33,7 @@ None currently in development. ### 🔄 Next Steps -1. Continue packaging remaining applications (53 remaining) +1. Continue packaging remaining applications (~50 remaining) 2. Prioritize applications with official Docker images (faster packaging) 3. Apply established patterns from Package-Templates/ 4. Reference JOURNAL.md for learnings and best practices @@ -40,9 +42,10 @@ None currently in development. ### 📚 Documentation & Resources - **JOURNAL.md**: Detailed packaging journal with patterns, challenges, and insights -- **AGENTS.md**: AI agent documentation and knowledge base +- **STATUS.md**: Living status (completed packages, known issues, next priorities) — agent-maintained +- **AGENTS.md**: Agent operating manual + gardening protocol - **Package-Templates/**: Cloudron packaging templates for common patterns -- **GitUrlList.txt**: Complete list of all 58+ applications with GitHub URLs +- **GitUrlList.txt**: Source-of-truth list of upstream repos ### 🏗 Cloudron Patterns Established @@ -56,11 +59,11 @@ None currently in development. ### ⚡ Productivity Metrics -- **Packages Completed**: 5/58 (8.6%) +- **Packages Completed**: 7/~57 (~12%) - **Average Package Time**: ~30 minutes - **Success Rate**: 100% (all packages built successfully) - **Commits Pushed**: 100% (all packages pushed to remote) -- **Total Commits**: 7 (1 foundation + 5 packages + 1 templates) +- **Total Commits**: 21+ (foundation + 7 packages + templates + docs) --- @@ -83,7 +86,7 @@ Applications are organized by function rather than programming language: | **Financial-Trading** | Trading and financial algorithm platforms | 1 | 0/1 (0%) | | **Infrastructure** | Infrastructure and networking tools | 6 | 0/6 (0%) | | **Legal** | Legal and compliance applications | 1 | 0/1 (0%) | -| **Low-Code** | Low-code and no-code platforms | 3 | 0/3 (0%) | +| **Low-Code** | Low-code and no-code platforms | 3 | 1/3 (33%) | | **Monitoring** | Monitoring and observability tools | 6 | 1/6 (17%) | | **Project-Management** | Project management solutions | 1 | 0/1 (0%) | | **Scientific-Computing** | Scientific and research computing | 2 | 0/2 (0%) | @@ -146,7 +149,7 @@ Applications are organized by function rather than programming language: | [Core](https://github.com/Resgrid/Core) | [GitHub](https://github.com/Resgrid/Core) | Emergency management and incident response system | Project-Management | | [SDRangel](https://github.com/f4exb/sdrangel) | [GitHub](https://github.com/f4exb/sdrangel) | Software defined radio application | Infrastructure | | [No-Code Architects Toolkit](https://github.com/stephengpope/no-code-architects-toolkit) | [GitHub](https://github.com/stephengpope/no-code-architects-toolkit) | No-code development toolkit | Low-Code | -| [Warp](https://github.com/sebo-b/warp) | [GitHub](https://github.com/sebo-b/warp) | Terminal and shell enhancement tool | Development | ✅ Packaged | +| [Warp](https://github.com/sebo-b/warp) | [GitHub](https://github.com/sebo-b/warp) | Terminal and shell enhancement tool | Development | | | [Windmill](https://github.com/windmill-labs/windmill) | [GitHub](https://github.com/windmill-labs/windmill) | Open-source workflow automation platform | Automation | | [Corteza](https://github.com/cortezaproject/corteza) | [GitHub](https://github.com/cortezaproject/corteza) | Open-source low-code platform | Low-Code | | [Security Awareness Training](https://github.com/security-companion/security-awareness-training) | [GitHub](https://github.com/security-companion/security-awareness-training) | Security awareness training platform | Security | diff --git a/RESUME.md b/RESUME.md index 9b4e156..4749439 100644 --- a/RESUME.md +++ b/RESUME.md @@ -1,230 +1,14 @@ -# TSYS Cloudron Project - Session Resume Guide +# Session Resume Guide — SUPERSEDED -**Date**: 2025-01-24 -**Session Type**: Orientation & Analysis -**Status**: Ready for Packaging Phase - ---- - -## 🎯 Current Project State - -### What Was Done This Session -- ✅ Oriented to project structure -- ✅ Analyzed repository cloning status (56/59 successfully cloned) -- ✅ Reviewed all documentation (README.md, AGENTS.md, GitUrlList.txt) -- ✅ Identified missing repositories -- ✅ Assessed workspace organization (19 functional categories) -- ✅ Documented uncommitted changes - -### What Needs To Be Committed -```bash -git status -# Modified: README.md -# Untracked: AGENTS.md, GitUrlList.txt, clone-repos.sh, .gitignore, Package-Workspace/ -``` - -**Suggested Commit Message:** -``` -feat: add Cloudron packaging foundation and upstream repositories - -- Add comprehensive README.md with 59-app inventory table -- Create AGENTS.md for AI agent context and decisions -- Add GitUrlList.txt with all upstream repository URLs -- Implement clone-repos.sh automation script -- Configure .gitignore to exclude cloned repos -- Clone and organize 56 upstream repositories by function -- Establish 19 functional categories for better organization -``` - ---- - -## 📊 Repository Status - -### Successfully Cloned (58 repos) -All repos are organized in `Package-Workspace///repo/` - -### Excluded Repositories (4 repos) -1. **oat-sa** - Invalid URL (organization-level only, not a repository) - - Status: Excluded from project -2. **satnogs** - GitLab repository requiring authentication - - Category: Infrastructure - - URL: https://gitlab.com/librespacefoundation/satnogs - - Status: Excluded from project -3. **warp** - Duplicate entry removed - - Category: Development - - Status: Single entry retained -4. **windmill** - Duplicate entry removed - - Category: Automation - - Status: Single entry retained - -### Previously Failed Clones - Now Fixed -1. **WireViz** - Successfully cloned on retry - - Category: Documentation-Tools - - Status: ✅ Complete -2. **elabftw** - Successfully cloned on retry - - Category: Business-Apps - - Status: ✅ Complete - -### Special Case: docassemble -- Cloned directly to `Package-Workspace/Legal/docassemble/` (not `repo/` subdirectory) -- This is the only repo not following the standard structure -- Decision: Leave as-is or restructure if needed - ---- - -## 🚀 Immediate Next Steps - -### Step 1: Commit Current Work (10 minutes) -```bash -cd /home/tsys/Projects/TDS/TSYSDevStack-SupportStack-Cloudron -git add README.md AGENTS.md GitUrlList.txt clone-repos.sh .gitignore RESUME.md -git commit -m "feat: add Cloudron packaging foundation and upstream repositories" -``` - -**Note**: `Package-Workspace/` is excluded by `.gitignore`, so it won't be committed. - -### Step 2: Begin Cloudron Packaging (start with easy apps) -Pick a high-priority application and start packaging: - -**Example workflow:** -```bash -cd Package-Workspace/Monitoring/healthchecks/repo -# Study existing Cloudron packages for patterns -# Create Dockerfile -# Create CloudronManifest.json -# Test: cloudron build -# Test: cloudron install -``` - ---- - -## 📋 Project Statistics - -- **Total Applications**: 58 -- **Successfully Cloned**: 58 -- **Failed Clones**: 0 -- **Functional Categories**: 20 -- **Workspace Size**: 5.4GB -- **Programming Languages**: 9+ (Go, Node.js, Python, PHP, Java, Rust, Ruby, TypeScript) - ---- - -## 🗂️ Functional Categories Summary - -| Category | Apps | Status | -|----------|------|--------| -| API-Gateway | 2 | 2/2 cloned | -| Automation | 4 | 4/4 cloned | -| Business-Apps | 8 | 8/8 cloned | -| Collaboration | 2 | 2/2 cloned | -| Communication | 2 | 2/2 cloned | -| Data-Management | 2 | 2/2 cloned | -| Development | 4 | 4/4 cloned | -| DevOps-Tools | 2 | 2/2 cloned | -| Documentation-Tools | 3 | 3/3 cloned | -| Financial-Payments | 1 | 1/1 cloned | -| Financial-Trading | 1 | 1/1 cloned | -| Infrastructure | 5 | 5/5 cloned | -| Legal | 1 | 1/1 cloned | -| Low-Code | 3 | 3/3 cloned | -| Monitoring | 6 | 6/6 cloned | -| Project-Management | 1 | 1/1 cloned | -| Scientific-Computing | 2 | 2/2 cloned | -| Security | 5 | 5/5 cloned | -| System-Administration | 3 | 3/3 cloned | - ---- - -## 📚 Key Resources - -### Documentation -- `README.md` - Complete project overview and app inventory -- `AGENTS.md` - AI agent context, decisions, and working patterns -- `RESUME.md` - This file - -### Scripts & Tools -- `clone-repos.sh` - Automated repository cloning -- `GitUrlList.txt` - Master list of upstream repositories - -### Cloudron Packaging -- [Cloudron Packaging Tutorial](https://docs.cloudron.io/packaging/tutorial/) -- [Cloudron Manifest Documentation](https://docs.cloudron.io/packaging/manifest/) -- [Cloudron CLI Documentation](https://docs.cloudron.io/packaging/cli/) -- [Existing Cloudron Packages](https://git.cloudron.io/cloudron) - ---- - -## 🔧 Recommended Starting Points - -### For Cloudron Packaging Beginners -Start with simple applications that likely have existing Docker setups: -1. **Review Board** - Development (likely has simple setup) -2. **Webhook** - API-Gateway (lightweight Go app) -3. **Healthchecks** - Monitoring (Python, well-documented) - -### For Quick Wins (apps with existing Dockerfiles) -1. **Puter** - Development (has Dockerfile) -2. **Windmill** - Automation (has Dockerfile) -3. **DataHub** - Data-Management (has Docker setup) - -### For High Business Value -1. **InvenTree** - Business-Apps (inventory management) -2. **NetBox** - Infrastructure (data center management) -3. **Grist Core** - Collaboration (data spreadsheet) - ---- - -## ⚠️ Known Issues - -1. **docassemble Structure** - - Not following standard `repo/` subdirectory pattern - - Cloned directly to `Package-Workspace/Legal/docassemble/` - - Action: Document as exception (non-standard structure) - -2. **Excluded Repositories** - - oat-sa: Organization URL (not a repository) - - satnogs: Requires authentication (GitLab) - - Both intentionally excluded from project scope - ---- - -## 📞 How to Resume - -1. **Navigate to project:** - ```bash - cd /home/tsys/Projects/TDS/TSYSDevStack-SupportStack-Cloudron - ``` - -2. **Review this file:** - ```bash - cat RESUME.md - ``` - -3. **Check git status:** - ```bash - git status - ``` - -4. **Pick up where you left off:** - - If uncommitted: Commit current work - - If ready to package: Choose an app and start - - If missing repos: Retry cloning - ---- - -## 🎯 Project Goals Checklist - -- [x] Fix and retry failed repository clones -- [x] Commit current foundation work -- [x] Clean up duplicate entries in GitUrlList.txt -- [ ] Start Cloudron packaging (Dockerfile + CloudronManifest.json) -- [ ] Test packages with Cloudron CLI -- [ ] Move completed packages to `Package-Artifacts/` -- [ ] Establish testing/validation pipeline -- [ ] Complete packaging for all 58 apps by deadline - ---- - -**Last Updated**: 2025-01-24 -**Status**: Foundation complete, all repos cloned, ready for packaging phase -**Next Session**: Start Cloudron packaging with Phase 2 (Quick Wins & Templates) +> **This file is superseded by [`STATUS.md`](STATUS.md).** +> +> STATUS.md is now the living, agent-maintained source of truth for project +> state (completed packages, known issues, next priorities). Read STATUS.md at +> the start of every session instead of this file. +> +> This RESUME.md is retained only for historical reference. It was last updated +> 2025-01-24 and referenced an old host path (`/home/tsys/Projects/TDS/...`) +> that no longer exists — the project now lives at +> `~/projects/TSYSDevStack-SupportStack-Cloudron`. +> +> Do not update this file. Update [`STATUS.md`](STATUS.md) instead.