KNEL/TSYSDevStack-SupportStack-Cloudron
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: reconcile stale package counts across docs

Browse Source 
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
This commit is contained in:
mrcharles
2026-07-30 15:49:35 -05:00
parent cbb6c8c75c
commit c56e77c59c
3 changed files with 32 additions and 245 deletions
Download Patch File Download Diff File Expand all files Collapse all files
JOURNAL.md
+5 -5
View File
@@ -2,9 +2,9 @@
## Project Overview ## Project Overview
**Project**: TSYSDevStack-SupportStack-Cloudron **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 **Start Date**: 2025-01-24
**Current Status**: 5/58 packages completed (8.6%) **Current Status**: 7/~57 packages completed (~12%)
## Completed Packages ## Completed Packages
@@ -626,11 +626,11 @@ Dockerfile
## Repository Statistics ## Repository Statistics
- **Commits**: 6 packages committed to main branch - **Commits**: 7 packages committed to main branch
- **Pushes**: All pushed to remote repository - **Pushes**: All pushed to remote repository
- **Package directories**: Created in Package-Workspace/ - **Package directories**: Created in Package-Workspace/
- **Total packages completed**: 5/58 (8.6%) - **Total packages completed**: 7/~57 (~12%)
- **Remaining packages**: 53/58 (91.4%) - **Remaining packages**: ~50/~57 (~88%)
--- ---
README.md
+14 -11
View File
@@ -8,11 +8,12 @@ The Cloudron component focuses on packaging upstream free/libre/open application
### 📊 Current Progress ### 📊 Current Progress
- **Total Applications**: 58+ - **Total Applications**: ~57 (see [GitUrlList.txt](GitUrlList.txt))
- **Completed Packages**: 5/58 (8.6%) - **Completed Packages**: 7/~57 (~12%)
- **Quick Wins**: 6/6 (100%) ✅
- **Packaging Templates**: Created ✅ - **Packaging Templates**: Created ✅
- **Packages Committed & Pushed**: 6 ✅ - **Packages Committed & Pushed**: 7 ✅
> Living status is tracked in [STATUS.md](STATUS.md) (agent-maintained).
### ✅ Completed Packages ### ✅ 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 | | 4 | Review Board | Development | 1.29GB | 8080 | localstorage, postgresql | ✅ Committed |
| 5 | WireViz Web | Documentation-Tools | 378MB | 3005 | localstorage | ✅ Committed | | 5 | WireViz Web | Documentation-Tools | 378MB | 3005 | localstorage | ✅ Committed |
| 6 | Puter | Development | 361MB | 4100 | localstorage, postgresql | ✅ Committed | | 6 | Puter | Development | 361MB | 4100 | localstorage, postgresql | ✅ Committed |
| 7 | Corteza | Low-Code | 436MB | 80 | localstorage, postgresql | ✅ Committed |
### 📦 Packages in Development ### 📦 Packages in Development
@@ -31,7 +33,7 @@ None currently in development.
### 🔄 Next Steps ### 🔄 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) 2. Prioritize applications with official Docker images (faster packaging)
3. Apply established patterns from Package-Templates/ 3. Apply established patterns from Package-Templates/
4. Reference JOURNAL.md for learnings and best practices 4. Reference JOURNAL.md for learnings and best practices
@@ -40,9 +42,10 @@ None currently in development.
### 📚 Documentation & Resources ### 📚 Documentation & Resources
- **JOURNAL.md**: Detailed packaging journal with patterns, challenges, and insights - **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 - **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 ### 🏗 Cloudron Patterns Established
@@ -56,11 +59,11 @@ None currently in development.
### ⚡ Productivity Metrics ### ⚡ Productivity Metrics
- **Packages Completed**: 5/58 (8.6%) - **Packages Completed**: 7/~57 (~12%)
- **Average Package Time**: ~30 minutes - **Average Package Time**: ~30 minutes
- **Success Rate**: 100% (all packages built successfully) - **Success Rate**: 100% (all packages built successfully)
- **Commits Pushed**: 100% (all packages pushed to remote) - **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%) | | **Financial-Trading** | Trading and financial algorithm platforms | 1 | 0/1 (0%) |
| **Infrastructure** | Infrastructure and networking tools | 6 | 0/6 (0%) | | **Infrastructure** | Infrastructure and networking tools | 6 | 0/6 (0%) |
| **Legal** | Legal and compliance applications | 1 | 0/1 (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%) | | **Monitoring** | Monitoring and observability tools | 6 | 1/6 (17%) |
| **Project-Management** | Project management solutions | 1 | 0/1 (0%) | | **Project-Management** | Project management solutions | 1 | 0/1 (0%) |
| **Scientific-Computing** | Scientific and research computing | 2 | 0/2 (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 | | [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 | | [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 | | [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 | | [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 | | [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 | | [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 |
RESUME.md
+13 -229
View File
@@ -1,230 +1,14 @@
# TSYS Cloudron Project - Session Resume Guide # Session Resume Guide — SUPERSEDED
**Date**: 2025-01-24 > **This file is superseded by [`STATUS.md`](STATUS.md).**
**Session Type**: Orientation & Analysis >
**Status**: Ready for Packaging Phase > 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.
>
## 🎯 Current Project State > 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/...`)
### What Was Done This Session > that no longer exists — the project now lives at
- ✅ Oriented to project structure > `~/projects/TSYSDevStack-SupportStack-Cloudron`.
- ✅ Analyzed repository cloning status (56/59 successfully cloned) >
- ✅ Reviewed all documentation (README.md, AGENTS.md, GitUrlList.txt) > Do not update this file. Update [`STATUS.md`](STATUS.md) instead.
- ✅ 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/<Category>/<App>/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)