Skip to content

docs: make Aspire composition and external Prisma adapters pasteable - #1146

Merged
rickylabs merged 1 commit into
mainfrom
docs/aspire-db-cut
Aug 3, 2026
Merged

docs: make Aspire composition and external Prisma adapters pasteable#1146
rickylabs merged 1 commit into
mainfrom
docs/aspire-db-cut

Conversation

@rickylabs

@rickylabs rickylabs commented Aug 3, 2026

Copy link
Copy Markdown
Owner

Summary

  • replace the flagship composeAppHost sample with a complete production-shaped plugin contribution and host composition
  • document focused application imports, the supported public aggregate, and schema/editor generation
  • add an app-local Prisma libSQL/Turso path with explicit ownership boundaries and decision rules; dependency pinning and an exact emitted-sample type-check remain for docs(database): teach arbitrary Prisma driver adapters with a libSQL/Turso example #1101

Refs #1101
Closes #1107

Validation

  • deno test --allow-all packages/aspire/tests/ — 19 tests / 68 steps passed
  • scoped Aspire check — 45 files, zero errors
  • root scoped check — 2,541 files / 22 batches, zero errors
  • root lint/fmt wrappers — zero findings
  • deno task --cwd docs/site verify — 590 files; 29,669 links across 213 pages resolve; caveats valid
  • deno.lock unchanged; no AppHost, Docker, or external service started

Acceptance 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-libsql or type-check against a freshly generated client. Those unmet close gates remain tracked by #1101 in 0.0.5.

…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
@rickylabs

Copy link
Copy Markdown
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 @prisma/adapter-libsql add/pin step and the exact sample was not generated/type-checked against a fresh Prisma Deno client. The PR now uses Refs #1101; that issue moved to 0.0.5 with both boxes left unchecked. Its three genuinely supported ownership/decision criteria were checked.

@rickylabs
rickylabs merged commit 3c5cfce into main Aug 3, 2026
24 of 29 checks passed
@github-actions github-actions Bot added the canary:0.0.4-canary.1 Published NetScript prerelease 0.0.4-canary.1 label Aug 3, 2026
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
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>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:aspire area:database packages/database and adapters area:docs canary:0.0.4-canary.1 Published NetScript prerelease 0.0.4-canary.1 priority:p1 High status:impl-eval type:docs

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs(aspire): make AppHost composition examples import-correct and pasteable

1 participant