rob
/
CascadingDev
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

1st commit

This commit is contained in:
rob 2025-10-25 21:16:15 -03:00
parent 51a9bb0aa2
commit e4cf48b3ea
1 changed files with 8 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
DESIGN.md
View File

@ -126,6 +126,8 @@ Human → Git Commit → Pre-commit Hook → AI Generator → Markdown Artifact
``` ```
The sections below describe the meta-infrastructure of CascadingDev itself — how it builds and distributes the installer that generates user projects.
## Installation & Distribution Architecture ## Installation & Distribution Architecture
### Terminology (clarified) ### Terminology (clarified)
@ -135,6 +137,8 @@ Human → Git Commit → Pre-commit Hook → AI Generator → Markdown Artifact
### Repository Layout (authoritative) ### Repository Layout (authoritative)
Note: This section refers to the CascadingDev repository itself. For the structure of a user’s generated project, see “First-Run Flow” below.
```text ```text
CascadingDev/ CascadingDev/
├─ src/cascadingdev/ # core logic & optional dev CLI ├─ src/cascadingdev/ # core logic & optional dev CLI
@ -215,7 +219,7 @@ python3 tools/build_installer.py
# Output: install/cascadingdev-<version>/ # Output: install/cascadingdev-<version>/
``` ```
**6.3 Smoke test the bundle** **6.3 Smoke test the bundle** (verifies minimal Python+git system compatibility)
```bash ```bash
python3 install/cascadingdev-<version>/setup_cascadingdev.py --target /tmp/my-users-project --no-ramble python3 install/cascadingdev-<version>/setup_cascadingdev.py --target /tmp/my-users-project --no-ramble
# then again without --no-ramble once GUI deps are ready # then again without --no-ramble once GUI deps are ready
@ -276,7 +280,7 @@ python3 install/cascadingdev-<version>/setup_cascadingdev.py --target <path>
### Roadmap (post-v0.1) ### Roadmap (post-v0.1)
- Expand pre-commit checks (summary normalization, rule validation) - Expand pre-commit checks (summary normalization, rule validation)
- Add `automation/workflow.py --status` for repo health - CLI status report for current staged discussions and votes
- Provide a developer CLI (`cdev init …`) that reuses installer logic - Provide a developer CLI (`cdev init …`) that reuses installer logic
- Unit tests for scaffolding helpers (`src/cascadingdev/*`) - Unit tests for scaffolding helpers (`src/cascadingdev/*`)
- Template override mechanism (`--templates`) - Template override mechanism (`--templates`)
@ -2604,3 +2608,5 @@ Implementation Priority: Begin with Milestone M0 (process foundation) and procee
Document Version: 2.1 Document Version: 2.1
Last Updated: 2025-10-22 Last Updated: 2025-10-22
Status: READY_FOR_IMPLEMENTATION Status: READY_FOR_IMPLEMENTATION
Build Reference: This document (v2.1) applies to CascadingDev installer version matching VERSION in the repository root.