aboutsummaryrefslogtreecommitdiff
path: root/AGENTS
diff options
context:
space:
mode:
author_ov4 <ov4@ov4.org>2026-10-22 10:27:27 +0000
committer_ov4 <ov4@ov4.org>2026-10-22 10:27:27 +0000
commit273555f53458eb80d15c3d5c1910e57428818ee4 (patch)
tree4e50b42c9422232136e450ff8517ce9a47eb77f8 /AGENTS
parent0f3e8629c32b849291416411867141ded7bcaee0 (diff)
build(release): version compiler packages by their last source commit
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Diffstat (limited to 'AGENTS')
-rw-r--r--AGENTS/ARCH/INSTALL.md3
-rw-r--r--AGENTS/ARCH/LAYOUT.md1
2 files changed, 3 insertions, 1 deletions
diff --git a/AGENTS/ARCH/INSTALL.md b/AGENTS/ARCH/INSTALL.md
index 82c5059..a1624bd 100644
--- a/AGENTS/ARCH/INSTALL.md
+++ b/AGENTS/ARCH/INSTALL.md
@@ -21,7 +21,8 @@ the extracted executable, and sets its local runtime/data paths as needed. Syste
Pandoc remains the fallback.
`make -C build release` packages the executable, all manuals, installer and license
as `build/cpsc-VERSION-SYSTEM-ARCH.tar.xz`, retaining the configured execution mode.
-`cmake/Release.cmake` reads HEAD at packaging time; VERSION is the commit's UTC
+`cmake/Release.cmake` reads, at packaging time, the last commit that touched the paths
+listed in `cmake/CompilerPaths.txt`; VERSION is that commit's UTC
timestamp (`yyyymmdd-hhmmss`) followed by its short ID. Git is only required
for packaging; recipients can install the extracted archive using just the script.
diff --git a/AGENTS/ARCH/LAYOUT.md b/AGENTS/ARCH/LAYOUT.md
index a88c60b..2d8f2fd 100644
--- a/AGENTS/ARCH/LAYOUT.md
+++ b/AGENTS/ARCH/LAYOUT.md
@@ -35,6 +35,7 @@
| `cmake/BuildTools.cmake`, `cmake/LLVMDependencies.cmake` | Compiler/build tool selection and LLVM dependency discovery |
| `cmake/Manual.cmake`, `cmake/GenerateManual.cmake.in` | Optional manual generation with local-first Pandoc discovery |
| `install.sh`, `install.ps1`, `cmake/Install.cmake.in`, `cmake/Release.cmake` | Artifact installation and versioned binary release packaging |
+| `cmake/CompilerPaths.txt` | Plain list of compiler source paths; the last commit touching them versions release packages |
AST nodes live in `include/cps/AST.h` (+ `FunctionAST.h`, `FileAST.h`, `TypeAST.h`, `TemplateAST.h`);
they are pure data with virtual destructors only — no codegen/visitor methods.