From eaae8d5dbd8dd4a5dddf2ab2556ca7bf2d5ee80b Mon Sep 17 00:00:00 2001 From: Thomas Walker Lynch Date: Fri, 21 Nov 2025 11:35:26 +0000 Subject: [PATCH] derived -> made --- .../loadable => developer/derived}/.gitkeep | 0 document/Harmony/00_Project_Structure.org | 26 ++++++++++--------- .../01_Workflow_and_Build_Contract.org | 4 +-- release/made_tracked/.gitkeep | 0 .../.gitignore | 0 5 files changed, 16 insertions(+), 14 deletions(-) rename {release/loadable => developer/derived}/.gitkeep (100%) create mode 100644 release/made_tracked/.gitkeep rename release/{local_build => made_untracked}/.gitignore (100%) diff --git a/release/loadable/.gitkeep b/developer/derived/.gitkeep similarity index 100% rename from release/loadable/.gitkeep rename to developer/derived/.gitkeep diff --git a/document/Harmony/00_Project_Structure.org b/document/Harmony/00_Project_Structure.org index 568e798..1f7e0a0 100644 --- a/document/Harmony/00_Project_Structure.org +++ b/document/Harmony/00_Project_Structure.org @@ -9,9 +9,9 @@ The Harmony skeleton is **Prescriptive**; it defines the authoritative rules for * 1. Core Prescriptive Invariants The separation is based on **Provenance (Origin)** and **Transience (State)**. -** Provenance: Authored vs. Derived +** Provenance: Authored vs. Made - **Authored** (The Artist): Trees holding human-written intent. Tools must treat as *read-only*. -- **Derived** (The Factory): Trees holding machine-generated content. All writes happen here. +- **Made** (The Factory): Trees holding machine-generated content (output of a process). ** Property Schema (The Semantic Path) Directory names are properties bestowed upon their contents. The path is a descriptive sentence: @@ -23,24 +23,26 @@ Directory names are properties bestowed upon their contents. The path is a descr - **Invariant:** Primary Logic Source. - **Contents:** All human-written source code (C, Python, etc.). -** =developer/loadable/= -- **Invariant:** Architecture-Agnostic Entry Points (Shared Capability). -- **Contents:** Shared scripts, wrappers, and symlinks to authored code (e.g., Python entry points). +** =developer/made/= +- **Invariant:** Architecture-Agnostic Output. +- **Contents:** Shared scripts, wrappers, and symlinks to authored code (e.g., Python entry points) that are the **result of a setup process**. ** =developer/scratchpad/= - **Invariant:** Transient Workspace. -- **Contents:** Intermediate files, object files, dependency files. The entire contents are permanently Git-ignored. +- **Contents:** Intermediate files, object files, dependency files. + +** =developer/scratchpad/made/= +- **Invariant:** Machine-Made Binaries (Intermediate). +- **Contents:** Compiled binaries and libraries derived by the build system. The contents of =scratchpad/= are permanently Git-ignored. * 3. Release Structure (The Central Working Point) The =$REPO_HOME/release= directory holds candidates for testing and promotion. -** =release/loadable/= -- **Invariant:** Shared, Agnostic Entry Points. +** =release/made_tracked/= +- **Invariant:** Shared, Agnostic Output. - **Contents:** Architecture-agnostic final release candidates (TRACKED). -** =release/local_build/= -- **Invariant:** Local Action Required. +** =release/made_untracked/= +- **Invariant:** Local Action Required / Machine-Specific Output. - **Rule:** This directory is empty but **TRACKED** (by a committed =.gitignore=) to signal that a **local build must be performed** post-clone to populate it with executables. - **Contents:** Architecture-specific binaries (IGNORED). - - diff --git a/document/Harmony/01_Workflow_and_Build_Contract.org b/document/Harmony/01_Workflow_and_Build_Contract.org index 78184c2..2fc8f23 100644 --- a/document/Harmony/01_Workflow_and_Build_Contract.org +++ b/document/Harmony/01_Workflow_and_Build_Contract.org @@ -29,5 +29,5 @@ The release script must promote artifacts to these canonical locations: | Content Type | Developer Origin | Release Target | Invariant | | :--- | :--- | :--- | :--- | -| **Binaries/Kmod** | scratchpad/loadable | **release/local_build/** | Architecture-Specific (IGNORED) | -| **Agnostic Scripts** | developer/loadable | **release/loadable/** | Shared, TRACKED | +| **Binaries/Kmod** | scratchpad/made | **release/made_untracked/** | Architecture-Specific (IGNORED) | +| **Agnostic Scripts** | developer/made | **release/made_tracked/** | Shared, TRACKED | diff --git a/release/made_tracked/.gitkeep b/release/made_tracked/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/release/local_build/.gitignore b/release/made_untracked/.gitignore similarity index 100% rename from release/local_build/.gitignore rename to release/made_untracked/.gitignore -- 2.20.1