From: Thomas Walker Lynch Date: Fri, 21 Nov 2025 11:35:26 +0000 (+0000) Subject: derived -> made X-Git-Url: https://git.reasoningtechnology.com/style/rt_dark_doc.css?a=commitdiff_plain;h=eaae8d5dbd8dd4a5dddf2ab2556ca7bf2d5ee80b;p=Harmony.git derived -> made --- diff --git a/developer/derived/.gitkeep b/developer/derived/.gitkeep new file mode 100644 index 0000000..e69de29 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/loadable/.gitkeep b/release/loadable/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/release/local_build/.gitignore b/release/local_build/.gitignore deleted file mode 100644 index bea49c8..0000000 --- a/release/local_build/.gitignore +++ /dev/null @@ -1,3 +0,0 @@ - -* -!/.gitignore \ No newline at end of file diff --git a/release/made_tracked/.gitkeep b/release/made_tracked/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/release/made_untracked/.gitignore b/release/made_untracked/.gitignore new file mode 100644 index 0000000..bea49c8 --- /dev/null +++ b/release/made_untracked/.gitignore @@ -0,0 +1,3 @@ + +* +!/.gitignore \ No newline at end of file