docs: make Aspire composition and external Prisma adapters pasteable - #1146
Merged
Conversation
…r docs - Replace flagship composeAppHost snippet in docs/site/explanation/aspire.md with import-correct example using @netscript/aspire/application. - Add @netscript/aspire/public aggregate explanation and inventory in docs/site/reference/aspire/index.md and explanation/aspire.md. - Include generateAppSettingsJsonSchema editor workflow documentation. - Add complete libSQL/Turso PrismaLibSql example to docs/site/data-persistence/how-to/use-a-second-database.md. - Explicitly distinguish Prisma driver adapters from NetScript DatabaseAdapter wrappers and outline application-owned responsibilities (generation, env, lifecycle, health, tracing, permissions/FFI) and decision rules. - Add test coverage for @netscript/aspire/public aggregate and schema generator. Fixes #1101 Fixes #1107
5 tasks
Owner
Author
|
Independent acceptance review closes #1107 only: its six criteria are proven by the complete production-shaped composeAppHost example, focused/public entrypoint guidance, schema generation workflow, executable Aspire fixture, and focused tests/import checks. I refused #1101 criteria 1 and 5: the libSQL sample omits the required |
rickylabs
added a commit
that referenced
this pull request
Aug 3, 2026
…e, cut checklist, DoD The run artifact of #1120. Every gate carries its observed firing evidence and a stated did-not-run signature; the honesty rule (#1092/#1146 precedents) and the #1142 false-red trap are encoded. Role judgement stays in the orchestrator skill; canary schedule in canary-cadence.md; publish mechanics in netscript-release. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01ReZGc3KP8xvEuruz1io7Pq
23 tasks
rickylabs
added a commit
that referenced
this pull request
Aug 3, 2026
…ile, rolling canary cadence (#1161) * chore(harness): bootstrap milestone-orchestrator authoring run + locked outline Run dir + supervisor identity + plan of record for the three #1120 artifacts. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01ReZGc3KP8xvEuruz1io7Pq * docs(harness): rolling canary cadence — trigger, membership, D3 identity, note, drift gate The schedule artifact of #1120. Wave boundary as the canary point and content-derived membership are [observed] from the 0.0.4 trace; open questions stay [asserted] and owner-undecided. Wires to the shipped release:canary-label surface (#1121/#1122); publish mechanics remain with netscript-release; #1119's collision is disambiguated, not deepened. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01ReZGc3KP8xvEuruz1io7Pq * docs(harness): milestone-run profile — stage contracts, pre-merge gate, cut checklist, DoD The run artifact of #1120. Every gate carries its observed firing evidence and a stated did-not-run signature; the honesty rule (#1092/#1146 precedents) and the #1142 false-red trap are encoded. Role judgement stays in the orchestrator skill; canary schedule in canary-cadence.md; publish mechanics in netscript-release. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01ReZGc3KP8xvEuruz1io7Pq * feat(harness): agent-milestone-orchestrator skill + regenerated .claude/skills mirror The role artifact of #1120: clustering, wave sequencing, re-planning absorption, delegation judgement, merge authority, canary-point decisions, honesty rules, and supervision pitfalls — every rule marked [observed] (0.0.4 trace) or [asserted]. Gate lists, run artifacts, label mechanism, and routing are referenced, never restated. Mirror regenerated via agentic:sync-claude (incl. aspire and netscript-release mirrors that were stale on main); agentic:check-claude green. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01ReZGc3KP8xvEuruz1io7Pq * chore(harness): close out authoring run — S4 evidence + status flip recorded Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01ReZGc3KP8xvEuruz1io7Pq * fix(harness): apply Sol adversarial review findings C1-C9, M1-M6 Evidence-base definition widened with per-claim citations instead of silent promotion; note-accumulation and the #1142 mitigation downgraded to [asserted] with gaps stated; identity derivation re-anchored on the release-canary.yml wiring; drift-gate section reduced to its observable contract; quota/transport gates given a recorded-output proof form; stage-C operability wired to tooling.md/agent-handoff.md and codex-watch turn interception; D2 tension (#1153/#1155 pre-ratification merges) surfaced rather than claimed away. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01ReZGc3KP8xvEuruz1io7Pq * fix(harness): Sol cycle-2 — fix C3-residue/C10/M7, demonstrate C7+M4 gates; escalate C9, M1/M2 The two previously undemonstrated gates now carry real negative cases (gate-demos.md): check 3 fires RED on a synthetic new-ignore diff and stays GREEN on excluded-path quotes; the #1142 selection rule recovers PR #1155's true pre-merge verdict from a live rollup containing a post-merge FAILURE. D2 evidence box unticked pending the owner's ruling; the [observed] source-of-record dispute is recorded in drift.md for the owner. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01ReZGc3KP8xvEuruz1io7Pq * chore(harness): record owner rulings — D2 orchestrated-delivery reading; [observed] definition ratified Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01ReZGc3KP8xvEuruz1io7Pq * fix(harness): Sol cycle-3 residues — C10 tag-existence implication dropped, M8 stale acceptance row Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01ReZGc3KP8xvEuruz1io7Pq * chore(harness): record Sol cycle-4 PASS — eval loop closed green Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01ReZGc3KP8xvEuruz1io7Pq * chore(harness): note mirror/label event race; retrigger CI with ready-merge label present Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01ReZGc3KP8xvEuruz1io7Pq --------- Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
composeAppHostsample with a complete production-shaped plugin contribution and host compositionapplicationimports, the supportedpublicaggregate, and schema/editor generationRefs #1101
Closes #1107
Validation
deno test --allow-all packages/aspire/tests/— 19 tests / 68 steps passeddeno task --cwd docs/site verify— 590 files; 29,669 links across 213 pages resolve; caveats validdeno.lockunchanged; no AppHost, Docker, or external service startedAcceptance evidence
The focused fixture compiles and executes the same production entrypoints and composition shape shown in the flagship example. The database guidance accurately describes ownership and operational constraints, but the exact sample does not yet prove installation/pinning of
@prisma/adapter-libsqlor type-check against a freshly generated client. Those unmet close gates remain tracked by #1101 in 0.0.5.