You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@magpie.apache.org by "potiuk (via GitHub)" <gi...@apache.org> on 2026/07/19 03:38:28 UTC
[PR] docs(rfc): RFC-AI-0007 — selective (family-scoped) snapshot fetch [magpie]
potiuk opened a new pull request, #908:
URL: https://github.com/apache/magpie/pull/908
**RFC-AI-0007** — proposes making the non-marketplace (`/magpie-setup`) adoption fetch **only the chosen skill families** instead of the whole framework.
## The problem
The `.apache-magpie/` snapshot today pulls the whole repo — all 10 families, every tool, all of `docs/`, the `projects/` templates — even when an adopter opts into one or two families. Investigation showed skills reference outside `skills/` heavily (docs ×319, AGENTS.md ×202, tools ×186, projects ×116), so a naive "chosen skills only" fetch would dangle real runtime dependencies.
## The proposal (Phase A — design review)
- **git sparse-checkout + partial clone** fetches: chosen families' skills + always-on (`setup`, `utilities`) + the **runtime closure** they execute against (`AGENTS.md`, `PRINCIPLES.md`, `projects/_template/`, invoked `tools/`).
- **Runtime deps vs doc-links:** runtime deps are fetched; the ~319 `docs/…` prose links are rewritten to canonical `github.com/apache/magpie/blob/<ref>/…` URLs (deterministic at fetch time). A new `runtime_deps:` frontmatter, enforced by `skill-and-tool-validator`, keeps the closure from drifting.
- **Per-family** granularity (matches the existing opt-in prompt); per-skill rejected as fragile.
- **Lock** gains a `families:` list so `upgrade`/`verify` reproduce the sparse set.
- **`svn-zip`** stays a whole-release fetch (a signed zip can't be sparse); sparse applies to the git methods.
- No change to the symlink/override model or **PRINCIPLES §13**.
## Process
This is **Phase A** — the RFC is the review checkpoint. **Phase B** (wiring `setup` + `install-recipes.md` + the lock field + validator) follows on approval, per how RFC-AI-0006 (skill-sources) was staged.
Decisions baked in per request: runtime-only closure, per-family granularity, RFC-first.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: commits-unsubscribe@magpie.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] docs(rfc): RFC-AI-0007 — selective (family-scoped) snapshot fetch [magpie]
Posted by "potiuk (via GitHub)" <gi...@apache.org>.
potiuk commented on PR #908:
URL: https://github.com/apache/magpie/pull/908#issuecomment-5084776307
Looking for reviews here as well :)
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: commits-unsubscribe@magpie.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] docs(rfc): RFC-AI-0007 — selective (family-scoped) snapshot fetch [magpie]
Posted by "potiuk (via GitHub)" <gi...@apache.org>.
potiuk merged PR #908:
URL: https://github.com/apache/magpie/pull/908
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: commits-unsubscribe@magpie.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org