Plan MIL-007 and UC-002; AGPL-3.0 default only for a public GitHub project

- MIL-006: the AGPL-3.0 default needs GitHub and a public project
- MIL-007: fetch the framework's own submodules (qc); start through a command link; README usage
- UC-002 with SSD, DM, OC, SD and DCD; US-001.07 and US-002
- Reconcile the project DM, DCD, dictionary, use case diagram and traceability matrix
- Review records RC-022 to RC-028

docs/dcd.md

@@ -4,13 +4,13 @@
 | Key | Value |
 | --- | --- |
 | ID | DCD-002 |
-| CrossReference | [DCD-001], [DM-002], [UC-001], [OC-001], [SD-001], [DICT-001] |
+| CrossReference | [DCD-001], [DCD-003], [DM-002], [UC-001], [UC-002], [OC-001], [SD-001], [SD-002], [DICT-001] |
 
 ## Version History
 | Date | Status | Author | Reviewer | Change | Commit |
 | --- | --- | --- | --- | --- | --- |
-| 2026-10-06 | Accepted | Jens Tirsvad Nielsen | S02 | Added CredentialCollector, EnvFileWriter and EnvFile (from DCD-001) | [ded26a6] |
 | 2026-10-06 | Proposed | Jens Tirsvad Nielsen | S02 | ProjectRequest carries the license that applies (from DCD-001) | [d773fa9] |
+| 2026-10-07 | Proposed | Jens Tirsvad Nielsen | S02 | Added Launcher, Checkout and WorkingFolder; startProjectCreation takes the checkout and working folder (from DCD-003, UC-002) | pending |
 
 ---
 
@@ -33,7 +33,7 @@ enum Visibility {
 }
 
 class ProjectCreator <<controller>> {
-  +startProjectCreation() : PromptSet
+  +startProjectCreation(checkout : Checkout, workingFolder : WorkingFolder, configPath : Path [0..1], envPath : Path [0..1]) : PromptSet
   +provideProjectDetails(name : String, description : String, visibility : Visibility, giteaOwner : Owner, githubOwner : Owner [0..1], directory : Path, enablePlanGate : Boolean, writeEnvFile : Boolean) : Summary
 }
 class ConfigLoader {
@@ -80,6 +80,19 @@ class SummaryReport {
   +compose(request : ProjectRequest) : Summary
 }
 
+class Launcher {
+  +resolveCheckout(invocation : Path) : Checkout
+  +currentFolder() : WorkingFolder
+  +startFromWorkingFolder(configPath : Path [0..1], envPath : Path [0..1]) : PromptSet
+}
+class Checkout {
+  -path : Path
+  +configFile() : Path
+  +envFile() : Path
+}
+class WorkingFolder {
+  -path : Path
+}
 class Run {
   -isApply : Boolean
 }
@@ -170,6 +183,11 @@ class Summary {
   -nextSteps : String [0..*]
 }
 
+Launcher "1" --> "1" ProjectCreator : starts
+Launcher ..> Checkout : creates
+Launcher ..> WorkingFolder : creates
+Run "1" *-- "1" Checkout
+Run "1" *-- "1" WorkingFolder
 ProjectCreator ..> ConfigLoader : creates
 ProjectCreator ..> ToolChecker : creates
 ProjectCreator ..> CredentialCollector : creates
@@ -231,6 +249,9 @@ Repository "0..*" --> "1" Visibility
 
 | Class | Refines (Domain Model concept) | Responsibility | Attributes | Operations |
 | --- | --- | --- | --- | --- |
+| `Launcher` | Command Link (the object that follows it) | Follows the command link to the checkout, takes the folder the Maintainer stands in, and starts the run. | none | `resolveCheckout`, `currentFolder`, `startFromWorkingFolder` |
+| `Checkout` | Checkout | Names the folder that holds the script's own files and the default `config.env` and `.env`. | `path` | `configFile`, `envFile` |
+| `WorkingFolder` | Working Folder | Names the base of the default directory of the new project. | `path` | none |
 | `ProjectCreator` | none (controller for the system operations of [OC-001]) | Receives the two system operations, sequences the steps and stops on the first failure. | none | `startProjectCreation`, `provideProjectDetails` |
 | `ConfigLoader` | Configuration | Reads `config.env` and `.env` as plain text and validates every value, preset project details included. | none | `load` |
 | `CredentialCollector` | none (system concept) | Asks, without echo, for a credential that `.env` does not provide and validates it like one read from `.env`. | none | `collect` |
@@ -270,7 +291,9 @@ Repository "0..*" --> "1" Visibility
 
 | Method signature | Operation Contract / SD message |
 | --- | --- |
-| `ProjectCreator.startProjectCreation() : PromptSet` | [OC-001] `startProjectCreation`; [SD-001] `startProjectCreation()` |
+| `ProjectCreator.startProjectCreation(checkout, workingFolder, configPath, envPath) : PromptSet` | [OC-001] `startProjectCreation`; [SD-001] `startProjectCreation()`; [SD-002] `startProjectCreation(checkout, workingFolder, ...)` |
+| `Launcher.startFromWorkingFolder(configPath, envPath) : PromptSet` | [OC-002] `startFromWorkingFolder`; [SD-002] |
+| `Launcher.resolveCheckout(invocation) : Checkout`, `Launcher.currentFolder() : WorkingFolder` | [OC-002] P2, P3; [SD-002] |
 | `ProjectCreator.provideProjectDetails(name, description, visibility, giteaOwner, githubOwner, directory, enablePlanGate, writeEnvFile) : Summary` | [OC-001] `provideProjectDetails`; [SD-001] `provideProjectDetails(...)` |
 | `ConfigLoader.load(configFile, envFile) : Configuration` | [SD-001] `load(config.env, .env)`; [OC-001] `startProjectCreation` P2 |
 | `CredentialCollector.collect(configuration, kinds) : Configuration` | [SD-001] `collect(configuration, GITEA_TOKEN)` and `collect(configuration, GITHUB_PAT, GITHUB_USER)`; [OC-001] `startProjectCreation` P2 and the precondition of `provideProjectDetails` |
@@ -312,6 +335,7 @@ SOLID check: no class has more than one reason to change (one host API, one kind
 
 | Design class | Where it lives in `src/` |
 | --- | --- |
+| `Launcher` | `create-project.sh` (the start of `main`: where the script finds its own folder) |
 | `ProjectCreator` | `create-project.sh` (`main`), `lib/apply.sh` |
 | `ConfigLoader` | `lib/config.sh` (`load_configuration`), `lib/validate.sh` |
 | `ToolChecker` | `lib/tools.sh` |
@@ -328,11 +352,14 @@ SOLID check: no class has more than one reason to change (one host API, one kind
 ---
 
 [DCD-001]: ./uc-001/dcd.md
+[DCD-003]: ./uc-002/dcd.md
+[UC-002]: ./uc-002/uc.md
+[SD-002]: ./uc-002/sd.md
+[OC-002]: ./uc-002/oc.md
 [DM-002]: ./domain-model.md
 [UC-001]: ./uc-001/uc.md
 [OC-001]: ./uc-001/oc.md
 [SD-001]: ./uc-001/sd.md
 [MIL-005]: ./milestones/mil-005-credentials.md
 [DICT-001]: ./dictionary.md
-[ded26a6]: https://git.tirsystem.com/TirSystem-BashScript/repo_foundry/commit/ded26a658c666bf29d84093cb352e3635e07719b
 [d773fa9]: https://git.tirsystem.com/TirSystem-BashScript/repo_foundry/commit/d773fa91df5a54090254e12e074880fb6526a9ff