diff --git a/docs/BACKLOG.md b/docs/BACKLOG.md index 7694c45323..7c268985c3 100644 --- a/docs/BACKLOG.md +++ b/docs/BACKLOG.md @@ -400,6 +400,7 @@ are closed (status: closed in frontmatter)._ - [ ] **[B-0840](backlog/P1/B-0840-thermal-forgetting-as-root-axiom-update-join-gated-memory-architecture-private-encryption-budget-exception-amara-aaron-2026-05-26.md)** thermal-forgetting = root-axiom-update + join-gated-memory architecture + private-encryption-budget exception (4-keeper-rule final form) — substrate-engineering work landing Amara's 2026-05-26 ratification of B-0839.3 reservoir-computing-as-framework-architecture (Aaron + Amara 2026-05-26) - [ ] **[B-0844](backlog/P1/B-0844-zflash-agent-mode-native-implementation-close-doc-vs-implementation-gap-aaron-2026-05-26.md)** zflash --agent flag — native agent-driven auto-type challenge implementation closing the docstring-vs-actual-implementation gap; empirical anchor from 2026-05-26 USB-re-flash session (Aaron 2026-05-26) - [ ] **[B-0853](backlog/P1/B-0853-sigstore-cosign-artifact-signing-free-stuff-iso-containers-tarballs-backed-by-fulcio-rekor-aaron-2026-05-27.md)** sigstore/cosign artifact signing — free-stuff coverage for ISO + containers + tarballs + Nix substitutes (Fulcio CA + Rekor transparency log; OIDC-keyless via GitHub Actions); commercial CAs deferred for proprietary OS surfaces (Aaron 2026-05-27) +- [ ] **[B-0854](backlog/P1/B-0854-zeta-install-sh-to-ace-install-zeta-migration-trajectory-package-json-style-declarative-manifest-like-scratch-and-sqlsharp-aaron-2026-05-27.md)** zeta-install.sh → `ace install zeta` migration trajectory — declarative `package.json`-style Ace manifest in Zeta repo (like `../scratch` and `../SQLSharp` already do); composes with B-0288 Ace CLI + B-0824 meta-PM + B-0816 ArgoCD-maximization + B-0742 distributable-POC pattern (Aaron 2026-05-27) ## P2 — research-grade diff --git a/docs/backlog/P1/B-0854-zeta-install-sh-to-ace-install-zeta-migration-trajectory-package-json-style-declarative-manifest-like-scratch-and-sqlsharp-aaron-2026-05-27.md b/docs/backlog/P1/B-0854-zeta-install-sh-to-ace-install-zeta-migration-trajectory-package-json-style-declarative-manifest-like-scratch-and-sqlsharp-aaron-2026-05-27.md new file mode 100644 index 0000000000..ad3bdfd325 --- /dev/null +++ b/docs/backlog/P1/B-0854-zeta-install-sh-to-ace-install-zeta-migration-trajectory-package-json-style-declarative-manifest-like-scratch-and-sqlsharp-aaron-2026-05-27.md @@ -0,0 +1,206 @@ +--- +id: B-0854 +priority: P1 +status: open +title: zeta-install.sh → `ace install zeta` migration trajectory — declarative `package.json`-style Ace manifest in Zeta repo (like `../scratch` and `../SQLSharp` already do); composes with B-0288 Ace CLI + B-0824 meta-PM + B-0816 ArgoCD-maximization + B-0742 distributable-POC pattern (Aaron 2026-05-27) +effort: L +ask: aaron 2026-05-27 +created: 2026-05-27 +last_updated: 2026-05-27 +depends_on: + - B-0288 +composes_with: + - B-0824 + - B-0816 + - B-0742 + - B-0821 + - B-0822 + - B-0777 + - B-0247 + - B-0852 + - B-0853 +tags: [ace-package-manager, zeta-on-ace, declarative-install, migration-trajectory, package-json, bunfig, install-graph, zeta-install-sh-replacement, scratch-sqlsharp-pattern, bootstrap-substrate] +--- + +## Operator framing (Aaron 2026-05-27) + +> *"are we still using zeta-install instead of install.sh can we move closer to that?"* +> +> (clarification) *"not zeta-install rename i mean using ace package manager that is the start like ../scratch and ../SQLSharp"* +> +> *"we just spoke about this earlier i thihnk you backloged some stuff"* + +Aaron is naming the trajectory from imperative-bash-installer (`zeta-install.sh`) toward declarative-package-manager-driven install (`ace install zeta`). Reference projects already operating this way in adjacent directories on the operator's machine: + +- `../scratch/` — has `package.json` + `bun.lock` + `bunfig.toml`; `bun` + Bun-as-package-manager toolchain +- `../SQLSharp/` — has `package.json` + `bunfig.toml` + `Directory.Build.props` + `global.json` + `tsconfig.json`; multi-toolchain declarative manifest + +The substrate-engineering shape: Zeta should have an equivalent declarative manifest (Ace package shape) so `ace install zeta` is the canonical install path, with `zeta-install.sh` becoming a thin bootstrap (or eventually retiring entirely). + +## What "backlogged some stuff" refers to + +Aaron's memory is correct about the BROADER Ace cluster being backlogged. The specific "zeta installs itself via ace install zeta" migration was NOT yet filed as its own row. Existing cluster substrate this row composes with: + +- **B-0288** (parent) — Ace DLC package manager CLI; status: in-progress; provides `ace install ` primitive +- **B-0824** — Ace as package-manager-of-package-managers; N-D dependency space; generate+join paradigm +- **B-0816** — Architectural principle: maximize ArgoCD scope; minimize NixOS native lock-in (this migration IS that principle applied to install scope) +- **B-0742** — k8s-local-stack as Ace's distributable POC; hats-as-negotiated-fork-structure +- **B-0821** — Zeta as dependency-graph + variable-passing layer on top of Helm +- **B-0822** — diamond-resolution-namespace-cardinality (multi-tenant 3rd dimension of dep-resolution) +- **B-0777** — industry-sharp-categories + per-persona ontology + Ace negotiation +- **B-0247** — original Ace lineage row +- `docs/agendas/ace-package-manager/AGENDA.md` — 13-stage lifecycle (OPERATOR-SELF-CLAIMED 2026-05-22) +- `docs/trajectories/ace-package-manager-skill-crystallization-pipeline/RESUME.md` + +This row is the OPERATIONAL bridge between "Ace exists as a CLI" (B-0288) + "Ace as meta-architecture" (B-0824) and "Ace can install Zeta itself" (this row). Without it, the Ace cluster builds primitives but doesn't dogfood them at the bootstrap scope. + +## Reference shape from `../scratch` and `../SQLSharp` + +What those projects ship that Zeta should mirror: + +```json +{ + "name": "...", + "private": true, + "type": "module", + "packageManager": "bun@1.3.12", + "engines": { "bun": ">=1.3.12" }, + "scripts": { + "setup:powershell": "...", + "test:docker": "bun run scripts/test/...", + "lint:typescript": "bunx eslint scripts/**/*.ts", + "typecheck:typescript": "tsc --noEmit" + } +} +``` + +Plus: + +- `bun.lock` — pinned dependency lockfile +- `bunfig.toml` — Bun configuration +- `Directory.Build.props` / `global.json` — .NET coordination (SQLSharp only; not all manifests need this) + +The declarative manifest names: package name + package manager + engine constraints + scripts (commands). Install is then `bun install` (for deps) + `bun run