Skip to content

Wave 3 — @netscript/plugin host (A4) [generator sub-branch]#15

Merged
rickylabs merged 55 commits into
feat/package-quality-wave3-pluginfrom
feat/package-quality-wave3-plugin-host
Jun 8, 2026
Merged

Wave 3 — @netscript/plugin host (A4) [generator sub-branch]#15
rickylabs merged 55 commits into
feat/package-quality-wave3-pluginfrom
feat/package-quality-wave3-plugin-host

Conversation

@rickylabs

@rickylabs rickylabs commented Jun 8, 2026

Copy link
Copy Markdown
Owner

Wave 3 generator sub-branch — @netscript/plugin (A4 plugin host) → umbrella #14

The working branch for the single Wave 3 unit. Targets the umbrella #14, not the track. Generator → PLAN-EVAL → Implement → IMPL-EVAL all happen here; merges into the umbrella once IMPL-EVAL returns PASS.

Status

IMPL-EVAL — PASS — Research (MEASURE-FIRST), Plan & Design, PLAN-EVAL, all 24 implementation slices, and the final IMPL-EVAL evaluator pass are complete. The Wave 3 host unit is merge-ready into the umbrella. The only remaining e2e:cli failure (behavior.triggers-healthlocalhost:8093/health) is the pre-locked LD-4 Wave 4 carry-forward, not host scope. Per harness rules the Close/merge step belongs to the supervisor.

Recent commits

  • IMPL-EVAL — record IMPL-EVAL PASS for @netscript/plugin host + fix builder LOC drift
  • 6f037a3 — docs(wave3): record slice 24 e2e carry-forward
  • 0458b4d — test(plugin): run merge readiness e2e cli
  • 10da21e — docs(wave3): record PLAN-EVAL PASS + lock LD-8 for @netscript/plugin host

Run docs

.llm/tmp/run/feat-package-quality-wave3-plugin--host/ (context-pack · research · plan · worklog · drift · commits · plan-eval · evaluate).

Archetype & gates

A4 — DSL/Builder (plugin host). F-1..F-12, F-14..F-18 (F-13 n/a) + required consumer-import validation + static gates.

Research findings (at base 89071df)

  • deno publish --dry-run: SUCCESS, 0 slow types (canonical 33 was stale)
  • Full-export deno doc --lint (all 8 entrypoints): 93 errors — 84 missing-jsdoc + 9 private-type-ref
  • deno check --unstable-kv all 8 entrypoints: PASS
  • README: 138 LOC / 12 sections

Implementation outcome (IMPL-EVAL re-verified)

  • Full-export deno doc --lint (all 8 entrypoints): 0 errors (93 → 0)
  • deno test --allow-all: 21 passed / 0 failed (added domain, adapter, watcher, and loader tests)
  • README expanded 138 → 165 LOC with Observability, Compatibility, and Required Permissions sections + aligned doctest fixture
  • Task hygiene: package-local lint/fmt tasks added; check enumerates all 8 entrypoints
  • deno publish --dry-run: SUCCESS, 0 slow types (documented unanalyzable-dynamic-import warning on the ./sdk manifest resolver)
  • LD-8: the 2 upstream-typed private-type-ref errors fixed with package-owned structural types (PluginManifestParser / PluginPayloadSchema in src/domain/schema-types.ts) — no upstream re-export; F-15 clean
  • Consumer-import validation: packages/cli and plugins/{sagas,streams,triggers,workers} compile against the updated surface
  • Arch-debt: closed the obsolete types.ts (1,005 LOC) entry; opened accepted F-1 debt for plugin-builder.ts (360 LOC after slice-4 JSDoc; 343 at base) with a pre-beta refactor target

rickylabs and others added 3 commits June 8, 2026 16:26
Seed run docs for the Wave 3 generator (Research -> Plan & Design): context-pack (points to umbrella deep-dive; MEASURE-FIRST; OQ-A..OQ-F), worklog, drift (stale-canonical + Wave-2 caveats), commits. Branch forked off umbrella 89071df; targets the umbrella PR.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…kpoint

- research.md: MEASURE-FIRST re-baseline at 89071df
  - dry-run: 0 slow types, SUCCESS
  - doc-lint: 93 errors (84 missing-jsdoc + 9 private-type-ref)
  - README: 138 LOC, 12 sections
  - tests: 4 files, 13 passing
- plan.md: 24 locked slices across Phase A-D
  - Phase A: doc-lint to zero (8 slices)
  - Phase B: README + docs (3 slices)
  - Phase C: task hygiene + testing (7 slices)
  - Phase D: debt + consumer + merge-readiness (6 slices)
- worklog.md: Design checkpoint with public surface, domain vocabulary,
  ports, constants, slices, deferred scope, contributor path, gate evidence
- drift.md: OQ-A..OQ-F resolved with evidence and locked decisions

Ready for PLAN-EVAL.
@rickylabs

Copy link
Copy Markdown
Owner Author

Plan & Design — READY FOR PLAN-EVAL

Research (MEASURE-FIRST) and Plan & Design are complete and committed.

Key findings:

  • deno publish --dry-run: SUCCESS, 0 slow types
  • Full-export deno doc --lint: 93 errors (84 missing-jsdoc + 9 private-type-ref) — target of Phase A
  • README: 138 LOC → expand to ≥150 in Phase B
  • Tests: 4 files / 13 passing → add domain, adapter, watcher tests in Phase C

Locked decisions (OQ-A..OQ-F):

  • Keep ./loader public; dynamic-import warning is in ./sdk
  • Accept rewrite vocabulary (no renames)
  • Accept plugin-builder.ts 343 LOC with debt (pre-beta refactor)
  • e2e:cli triggers-health is downstream Wave 4
  • ./testing exercised; add watcher cleanup test
  • inspectPlugin exported; fix private-type-ref via barrel re-exports

Deliverables:

  • research.md — re-baseline with real numbers
  • plan.md — 24 locked slices, Phase A–D
  • worklog.md — Design checkpoint (public surface, domain vocabulary, ports, contributor path, gate evidence)
  • drift.md — OQ resolutions recorded

Next step: PLAN-EVAL (separate session). Hard stop before any implementation slice.

@rickylabs

Copy link
Copy Markdown
Owner Author

@copilot use harness, run PLAN-EVAL

if surface of adjustments, improvement is not significant, proceed with them directly before giving your verdict to avoid useless back and forth

Copilot AI and others added 2 commits June 8, 2026 17:57
…host

Co-authored-by: rickylabs <129366361+rickylabs@users.noreply.github.com>
Co-authored-by: rickylabs <129366361+rickylabs@users.noreply.github.com>

Copilot AI commented Jun 8, 2026

Copy link
Copy Markdown
Contributor

@copilot use harness, run PLAN-EVAL

if surface of adjustments, improvement is not significant, proceed with them directly before giving your verdict to avoid useless back and forth...

PLAN-EVAL complete (harness, separate evaluator pass) → verdict: PASS. Written to plan-eval.md (commit 10da21e).

Full Plan-Gate checklist walked; load-bearing findings spot-checked against the tree (8 entrypoints, plugin-builder.ts 343 LOC, README 138 LOC, doc-lint 93 = 84 missing-jsdoc + 9 private-type-ref — all match). Gate set matches the Arch 4 matrix (F-1..F-12, F-14..F-18; F-13 n/a) + consumer-import; debt close/create plan is valid.

The evaluator open-decision sweep surfaced one rework-forcing gap the plan left implicit: 2 of the 9 private-type-ref errors are on upstream types in public signatures — z.ZodType (manifest-schema.ts:4) and StandardSchemaV1 (plugin-stream-topic-contribution.ts:11). The original slice 1 said to "export/re-export" them, which would violate F-15/AP-14 and contradict the plan's own F-15 "pass". Since the fix surface is small, I resolved it directly per your instruction rather than bouncing a FAIL_PLAN:

  • Locked LD-8 — fix the 2 upstream-typed errors with package-owned minimal structural types (precedent: packages/database/prisma-tracing.ts:37-63), not upstream re-export; barrel-export only the 7 package-owned types.
  • Amended slice 1, the research private-type-ref table, and the F-15 evidence row.

Implementation may begin (slice 1 carries LD-8). Per harness rules, the implement phase is a separate generator session.

rickylabs and others added 2 commits June 8, 2026 20:37
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@rickylabs

Copy link
Copy Markdown
Owner Author

Slice 1 code commit: private-type-ref cleanup

Commit: 0c1b2a1 fix(plugin): clear private type refs

  • Added package-owned structural schema contracts in packages/plugin/src/domain/schema-types.ts for LD-8.
  • Replaced public z.ZodType / StandardSchemaV1 annotations without re-exporting upstream types.
  • Re-exported package-owned referenced contracts through the relevant public entrypoints.

Validation:

  • deno check --unstable-kv across all 8 @netscript/plugin entrypoints: PASS
  • Full-export deno doc --lint: 0 private-type-ref matches; remaining errors are planned missing-jsdoc slices.

@rickylabs

Copy link
Copy Markdown
Owner Author

Slice 1 docs commit: run artifact update

Commit: 19f2915 docs(wave3): record slice 1 private-type-ref fix

  • Updated worklog.md with slice 1 gate evidence.
  • Updated context-pack.md with implementation status.
  • Updated commits.md with the slice 1 code/docs pair.

rickylabs and others added 2 commits June 8, 2026 20:40
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@rickylabs

Copy link
Copy Markdown
Owner Author

Slice 2 code commit: abstract contribution docs, part 1

Commit: 1a7e71e docs(plugin): document abstract contributions part one

  • Added public property JSDoc for Aspire, background processor, contract version, database schema, and e2e abstract contribution classes.
  • Kept the abstract contracts and contribution axes unchanged.

Validation:

  • deno check --unstable-kv across all 8 @netscript/plugin entrypoints: PASS
  • Full-export deno doc --lint: 0 private-type-ref matches; remaining doc-lint count reduced to 86.

@rickylabs

Copy link
Copy Markdown
Owner Author

Slice 2 docs commit: run artifact update

Commit: 2beed40 docs(wave3): record slice 2 abstract docs

  • Updated worklog.md with slice 2 validation evidence.
  • Updated context-pack.md with current implementation status.
  • Updated commits.md with the slice 2 code/docs pair.

rickylabs and others added 2 commits June 8, 2026 20:42
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@rickylabs

Copy link
Copy Markdown
Owner Author

Slice 3 code commit: abstract contribution docs, part 2

Commit: b598f3b docs(plugin): document abstract contributions part two

  • Added public property JSDoc for migration, runtime config topic, service, stream topic, telemetry, and the base contribution axis contract.
  • Kept the abstract hierarchy and public API behavior unchanged.

Validation:

  • deno check --unstable-kv across all 8 @netscript/plugin entrypoints: PASS
  • Full-export deno doc --lint: 0 private-type-ref matches; remaining doc-lint count reduced to 69.

@rickylabs

Copy link
Copy Markdown
Owner Author

Slice 3 docs commit: run artifact update

Commit: c4abbde docs(wave3): record slice 3 abstract docs

  • Updated worklog.md with slice 3 validation evidence.
  • Updated context-pack.md with current doc-lint progress.
  • Updated commits.md with the slice 3 code/docs pair.

rickylabs and others added 2 commits June 8, 2026 20:44
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@rickylabs

Copy link
Copy Markdown
Owner Author

Slice 4 code commit: builder, errors, and memory adapter docs

Commit: a308a2e docs(plugin): document builder errors and memory adapter

  • Added JSDoc for exported builder state fields and constructor.
  • Documented plugin error constructors.
  • Documented the in-memory file-system adapter public members.

Validation:

  • deno check --unstable-kv across all 8 @netscript/plugin entrypoints: PASS
  • Full-export deno doc --lint: 0 private-type-ref matches; remaining doc-lint count reduced to 48.

@rickylabs

Copy link
Copy Markdown
Owner Author

Slice 4 docs commit: run artifact update

Commit: 9cadaa4 docs(wave3): record slice 4 builder docs

  • Updated worklog.md with slice 4 validation evidence.
  • Updated context-pack.md with current doc-lint progress.
  • Updated commits.md with the slice 4 code/docs pair.

rickylabs and others added 2 commits June 8, 2026 20:47
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@rickylabs

Copy link
Copy Markdown
Owner Author

Slice 5 code commit: SDK discovery/runtime docs

Commit: d4262ad docs(plugin): document sdk discovery contracts

  • Added public JSDoc for SDK discovery ports, extractor/emitter/resolver members, source graph fields, watcher handle, walker pipeline options, and runtime bootstrap/bridge members.
  • Kept SDK behavior unchanged.

Validation:

  • deno check --unstable-kv across all 8 @netscript/plugin entrypoints: PASS
  • Full-export deno doc --lint: 0 private-type-ref matches; remaining doc-lint count reduced to 23.

@rickylabs

Copy link
Copy Markdown
Owner Author

Slice 5 docs commit: run artifact update

Commit: 02feec4 docs(wave3): record slice 5 sdk docs

  • Updated worklog.md with slice 5 validation evidence.
  • Updated context-pack.md with current doc-lint progress.
  • Updated commits.md with the slice 5 code/docs pair.

@rickylabs

Copy link
Copy Markdown
Owner Author

Slice 20 docs commit: run artifact update

Commit: 3fac166 docs(wave3): record slice 20 evidence update

  • Updated context-pack.md with fitness-evidence status.
  • Updated commits.md with the slice 20 code/docs pair.

rickylabs and others added 2 commits June 8, 2026 21:18
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@rickylabs

Copy link
Copy Markdown
Owner Author

Slice 21 code commit: CLI consumer validation

Commit: 7a24d51 test(plugin): verify cli consumer imports

  • Empty verification commit for the locked slice 21 boundary.
  • Confirms packages/cli consumers compile against the updated @netscript/plugin surface.

Validation:

  • From packages/cli, deno check --unstable-kv mod.ts: PASS
  • From packages/cli, deno task check: PASS (bin/netscript.ts, bin/netscript-dev.ts, mod.ts, maintainer.ts, scaffolding.ts, testing.ts).

@rickylabs

Copy link
Copy Markdown
Owner Author

Slice 21 docs commit: run artifact update

Commit: 055b2d0 docs(wave3): record slice 21 cli consumer

  • Updated worklog.md with CLI consumer validation evidence.
  • Updated context-pack.md with consumer gate status.
  • Updated commits.md with the slice 21 code/docs pair.

rickylabs and others added 2 commits June 8, 2026 21:20
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@rickylabs

Copy link
Copy Markdown
Owner Author

Slice 22 code commit: plugin package consumer validation

Commit: c2c1eec test(plugin): verify plugin package consumers

  • Empty verification commit for the locked slice 22 boundary.
  • Confirms first-party plugin packages compile against the updated @netscript/plugin surface.

Validation:

  • plugins/sagas: deno task check PASS; explicit deno check --unstable-kv mod.ts services/src/main.ts PASS
  • plugins/streams: deno task check PASS
  • plugins/triggers: deno task check PASS
  • plugins/workers: deno task check PASS.

@rickylabs

Copy link
Copy Markdown
Owner Author

Slice 22 docs commit: run artifact update

Commit: b29969f docs(wave3): record slice 22 plugin consumers

  • Updated worklog.md with first-party plugin consumer validation evidence.
  • Updated context-pack.md with consumer gate status.
  • Updated commits.md with the slice 22 code/docs pair.

rickylabs and others added 2 commits June 8, 2026 21:22
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@rickylabs

Copy link
Copy Markdown
Owner Author

Slice 23 — final static gates

Commit: 9f96342 (test(plugin): verify final static gates)

Summary:

  • Recorded the final static gate sweep as an empty verification slice.
  • deno task publish:dry-run succeeded with 0 slow types.
  • The expected unanalyzable-dynamic-import warning remains documented for the SDK manifest resolver.
  • deno task check, deno task lint, deno task fmt --check, and full-export deno doc --lint all passed.

Gate status: PASS_WITH_DOCUMENTED_WARNING for publish dry-run; PASS for check/lint/fmt/doc-lint.

@rickylabs

Copy link
Copy Markdown
Owner Author

Slice 23 docs — static gate record

Commit: cd66346 (docs(wave3): record slice 23 static gates)

Summary:

  • Updated worklog.md with slice 23 phase, readiness, and implementation evidence.
  • Updated context-pack.md with the final static-gate status.
  • Updated commits.md with slice 22 docs and slice 23 commit entries.

Harness status: slice 23 ledger is current; proceeding to slice 24 merge-readiness e2e:cli.

rickylabs and others added 2 commits June 8, 2026 21:33
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@rickylabs

Copy link
Copy Markdown
Owner Author

Slice 24 — merge-readiness E2E

Commit: 0458b4d (test(plugin): run merge readiness e2e cli)

Summary:

  • Ran rtk proxy deno task e2e:cli once from the repo root, as required by the locked plan.
  • Suite result: 35 passed, 1 failed, 0 skipped.
  • The only failure was the locked LD-4 carry-forward: behavior.triggers-health failed to connect to http://localhost:8093/health.
  • Cleanup passed: cleanup.aspire-stop and suite-created Docker container pruning completed.

Gate status: ACCEPTED_CARRY_FORWARD. No Wave 3 implementation scope was added.

@rickylabs

Copy link
Copy Markdown
Owner Author

Slice 24 docs — implementation handoff

Commit: 6f037a3 (docs(wave3): record slice 24 e2e carry-forward)

Summary:

  • Updated worklog.md with slice 24 validation and final generator gate status.
  • Updated drift.md with the accepted Wave 4 behavior.triggers-health carry-forward.
  • Updated context-pack.md with the generator handoff status.
  • Updated commits.md through slice 24.

Handoff status: generator work is complete. Package-quality/static/consumer gates are complete; PR #15 is ready for the separate IMPL-EVAL session. Do not merge from this session.

@rickylabs

Copy link
Copy Markdown
Owner Author

@copilot use harness proceed with IMPL-EVAL

If surface of changes / improvements is not too broad proceed before giving verdict

@rickylabs
rickylabs marked this pull request as ready for review June 8, 2026 19:59
@augmentcode

augmentcode Bot commented Jun 8, 2026

Copy link
Copy Markdown
🤖 Augment PR Summary

Summary: This PR completes the Wave 3 package-quality run for @netscript/plugin (A4 plugin host) by bringing publishability, documentation linting, README coverage, tasks, and tests up to the harness gates.

Changes:

  • Eliminated deno doc --lint private-type-ref issues by re-exporting package-owned types and introducing package-owned structural schema contracts (avoiding upstream type re-exports).
  • Added JSDoc across exported builder/CLI/SDK/port/adapter surfaces to reach full-export doc-lint = 0 across all 8 entrypoints.
  • Expanded packages/plugin/README.md (Observability, Compatibility, Required Permissions) and aligned README fixture tests with the current quick-start chain.
  • Added package-local lint/fmt tasks and expanded tasks.check to type-check all 8 public entrypoints.
  • Added focused tests for domain errors/core constants, memory FS adapter conformance, watcher cleanup handles, and manifest loading behavior.
  • Updated harness debt registry (closed obsolete types.ts debt; recorded accepted builder-size debt) and checked in run artifacts/worklogs for the 24-slice plan.

Technical Notes: Publish dry-run succeeds with the documented SDK dynamic-import warning; merge-readiness e2e:cli remains a known Wave 4 triggers-health carry-forward.

🤖 Was this summary useful? React with 👍 or 👎

@augmentcode augmentcode Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review completed. 2 suggestions posted.

Fix All in Augment

Comment augment review to trigger a new review at any time.


/** Zod schema for plugin manifests. */
export const PluginManifestSchema: z.ZodType = z.object({
export const PluginManifestSchema: PluginManifestParser = z.object({

@augmentcode augmentcode Bot Jun 8, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

packages/plugin/src/config/validators/manifest-schema.ts:5 — Typing PluginManifestSchema as PluginManifestParser hides the Zod schema surface (e.g. safeParse) and also makes .parse() return unknown to TS consumers, which looks like a breaking type-level change vs the previous z.ZodType annotation.

Severity: medium

Fix This in Augment

🤖 Was this useful? React with 👍 or 👎, or 🚀 if it prevented an incident/outage.

const PLUGIN_TYPES = ['background-processor', 'api', 'frontend', 'utility'] as const;
type PluginType = typeof PLUGIN_TYPES[number];

const CONTRIBUTION_AXES = [

@augmentcode augmentcode Bot Jun 8, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

.llm/tmp/run/feat-package-quality-wave3-plugin--host/worklog.md:149 — The “Domain vocabulary” snippet’s CONTRIBUTION_AXES and LIFECYCLE_HOOK_NAMES values don’t match the actual exports in packages/plugin/src/domain/constants.ts, which could mislead anyone using this worklog as evidence/reference.

Severity: low

Fix This in Augment

🤖 Was this useful? React with 👍 or 👎, or 🚀 if it prevented an incident/outage.

Copilot AI and others added 2 commits June 8, 2026 20:03
…uilder LOC drift

Co-authored-by: rickylabs <129366361+rickylabs@users.noreply.github.com>
Co-authored-by: rickylabs <129366361+rickylabs@users.noreply.github.com>

Copilot AI commented Jun 8, 2026

Copy link
Copy Markdown
Contributor

@copilot use harness proceed with IMPL-EVAL

If surface of changes / improvements is not too broad proceed before giving verdict

IMPL-EVAL complete (harness, separate evaluator session) → verdict: PASS. Written to evaluate.md (commit eed130d). Wave 3 host unit is merge-ready into the umbrella.

I re-ran the gates independently rather than trusting the worklog:

  • Static: deno task check (8 entrypoints) ✅ · lint (Checked 104 files) ✅ · fmt --check (Checked 113 files) ✅ · full-export deno doc --lint = 0 errors (Checked 8 files, down from 93) ✅
  • Fitness: F-6 publish:dry-run SUCCESS, 0 slow types (only the documented unanalyzable-dynamic-import warning) · F-10 deno test --allow-all = 21 passed / 0 failed · F-1 builder is the only >300 LOC src file = accepted debt
  • LD-8 / F-15: confirmed z.ZodType/StandardSchemaV1 are gone from public signatures, replaced by package-owned PluginManifestParser/PluginPayloadSchema in src/domain/schema-types.ts; no zod/standard-schema re-export in any barrel
  • Consumer gate (required for A4): independently re-ran deno check --unstable-kv mod.ts from packages/cli (imports @netscript/plugin + /config + /sdk + /templates) → clean
  • Debt delta: well-formed — old types.ts 1,005 LOC entry closed with evidence, new plugin-builder.ts F-1 entry complete

One low-severity drift found and fixed in-line (per your "proceed if not too broad" note): the builder grew 343→360 LOC when slice 4 added JSDoc, but the debt entry/worklog still recorded 343. I corrected arch-debt.md + worklog.md to 360 with the cause. No verdict impact — still the only F-1 violation, still accepted debt.

The single e2e:cli failure (behavior.triggers-healthlocalhost:8093/health) is the pre-locked LD-4 Wave 4 carry-forward, not host-bootstrap scope. Per harness rules I did not merge — the Close/merge into the umbrella is the supervisor's step.

@rickylabs
rickylabs merged commit 565086d into feat/package-quality-wave3-plugin Jun 8, 2026
@rickylabs
rickylabs deleted the feat/package-quality-wave3-plugin-host branch June 22, 2026 21:34
rickylabs added a commit that referenced this pull request Jul 11, 2026
 #8 #9 #10 #15)

- reference/ai: explicit note that AI provider keys have no typed config
  surface; raw Deno.env.get is the supported path (#8).
- reference/queue + reference/kv: See-it-live link blocks to the queue-kv-cron
  how-to and data-persistence concept page (#9).
- reference/contracts + reference/sdk: showcase sentence per lede — contracts
  obviate manual req.json() validation; defineServices() wires the whole typed
  stack in one call (#10).
- durable-workflows/streams: one sentence reframing no in-process subscribe()
  as an intentional single HTTP/SSE surface (#15).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VifzAytcxBk5odEMaCXihM
rickylabs added a commit that referenced this pull request Jul 11, 2026
…-tos, auth example (#686)

* docs: clarify PORT/typed-config relationship across 8 pages (#660 #7)

Aspire injects PORT at runtime; netscript.config.ts services.<name>.port
(apps.<name>.port for Fresh apps) is the typed source of truth the scaffold
wires as the fallback default. One shared sentence at each first parseInt
occurrence so the raw-env read no longer reads as the canonical pattern.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VifzAytcxBk5odEMaCXihM

* docs: reference showcase ledes, see-it-live links, streams framing (#660 #8 #9 #10 #15)

- reference/ai: explicit note that AI provider keys have no typed config
  surface; raw Deno.env.get is the supported path (#8).
- reference/queue + reference/kv: See-it-live link blocks to the queue-kv-cron
  how-to and data-persistence concept page (#9).
- reference/contracts + reference/sdk: showcase sentence per lede — contracts
  obviate manual req.json() validation; defineServices() wires the whole typed
  stack in one call (#10).
- durable-workflows/streams: one sentence reframing no in-process subscribe()
  as an intentional single HTTP/SSE surface (#15).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VifzAytcxBk5odEMaCXihM

* docs: add runnable end-to-end blocks to three decision how-tos (#660 #11)

discover-services, choose-a-queue-provider, and add-a-task-runtime-adapter
each gain one copy-pasteable end-to-end block (resulting file + full command
sequence) at deploy-local-aspire density, demonstrating the pluggability the
pages previously only asserted. All commands/APIs grounded in package source.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VifzAytcxBk5odEMaCXihM

* docs: add complete route-protection example to better-auth-plugins (#660 #12)

A real Fresh routes/*.tsx handler gated on an active session and an admin role,
at sibling auth.md's depth: resolves the session via backend.sessions.getSession,
maps to a Principal with principalMapper, and fails closed on both checks.
Grounded in packages/auth-better-auth + @netscript/service/auth exports.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VifzAytcxBk5odEMaCXihM

* chore(run): docs-660b sweep worklog (#660)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VifzAytcxBk5odEMaCXihM

---------

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

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants