feat(extensions): establish canonical goal source (#54, #55)

2026-09-06 02:32:32 -05:00
parent 44f257cb06
commit d4696d09eb
43 changed files with 6845 additions and 0 deletions
@@ -0,0 +1,19 @@
+# Extensions
+
+This directory holds canonical Pi extension source owned by stack-v2.
+
+- `goal/` is the first accepted extension.
+- `mosaic-core/lib/` contains the supporting modules imported by goal. It has no extension entrypoint and does not activate Mosaic Core on its own.
+
+Develop here, not under `.pi/extensions/`. Run:
+
+```sh
+node --test extensions/goal/test/*.test.ts
+bash scripts/test-extension-package.sh
+scripts/sync-dev-extensions.sh --check
+python3 scripts/test-goal-native.py
+```
+
+`scripts/sync-dev-extensions.sh` creates the native development installation under `.pi/extensions/` with ordinary files. It records installed hashes and refuses to overwrite local drift. `scripts/goal-dev.sh` synchronizes first, then loads only the generated goal entrypoint.
+
+This is development packaging, not a published npm package or managed-runtime release. The Containerfile and runtime adapter still exclude these extensions. A later release increment must define its explicit artifact inventory, supported Pi version, image integration, policy gate, and rollback before activation.