Skip to content

v0.0.9

Latest

Choose a tag to compare

@rickylabs rickylabs released this 03 Nov 05:09
· 13 commits to main since this release
9aac52a

NetScript 0.0.9 revamps the Fresh UI design system and the generated application experience, with Studio Utility components, tokens v2, installable themes, and an opt-in Northwind showcase. It also strengthens workers, sagas, streams, queues, authentication, telemetry, and agent documentation. The 0.0.9 milestone records 71 closed issues and 48 merged pull requests. The release was qualified by 0.0.9-canary.4 on d0f53933 and by 0.0.9-canary.5 on the final merge commit, with both JSR publication and production end-to-end verification green against the exact published packages.

Highlights

Fresh UI and the design system

  • Studio Utility styling across shipped components, scaffold chrome, and generated pages (#2503, #2572, #2586).
  • Tokens v2, application overrides, Theme B presets, contrast audits, and the contrast exclusion burn-down (#2435, #2495, #2507).
  • Component contracts and consistent variant attributes, plus registry v2 publishing and CLI parity (#2467, #2468, #2488).
  • Theme builds, generated component documentation, a theme gallery, and Figma variable round trips with URL theme installation (#2437, #2504, #2560).
  • Consolidated Utility CSS with enforced size budgets (#2558).

Generated apps and the Northwind showcase

  • An opt-in Northwind commerce showcase through netscript init --from showcase, demonstrating services, workers, sagas, streams, AI chat, and MCP (#2595).
  • Real sample records and page projections, record activity linked to streams, and the documented post-seed job lifecycle (#2583, #2589, #2592).
  • Installed plugins reach linked web apps with the generated wiring they need (#2582).
  • Presets are validated before scaffolding, URL themes require HTTPS, and preset/theming follow-ups are complete (#2518, #2559).
  • AI providers stay outside scaffold Vite browser graphs (#2594).

Durable runtime and observability

  • Worker handler retry policies and dead-letter handling, recovered listener restart budgets, and Redis listener concurrency (#2481, #2482, #2496).
  • Atomic saga replay markers and transitions, command outbox schema, bounded retention, and canonical query statuses (#2487, #2499, #2522).
  • Persisted stream producer epochs, opt-in generated storage, and caller-header forwarding (#2510, #2520, #2423).
  • Redis queue claim leasing and reclamation, ordered KV pagination, and atomic watch notifications (#2483, #2505, #2502).
  • File-watch event identity and native-only watcher support, plus crash-loop detection for background children (#2479, #2484, #2542).
  • Isolated worker-job and trigger-delivery traces with structured lifecycle log levels (#2399, #2511).

Services, agents, and documentation

  • CORS response authority and health authentication enforcement; unknown and retired contract procedures return explicit 404/410 outcomes (#2422, #2492).
  • Authentication database contributions follow the selected backend, and malformed foreign cookies no longer discard the entire cookie header (#2519, #2498).
  • Agent documentation retrieves and cites the full published corpus, while telemetry analysis binds to the selected AppHost (#2529, #2521).
  • Installed design guidance is derived and pinned; builder payloads and component guidance are more focused (#2573, #2574).
  • The docs site is rebuilt in NetScript Utility with shared file trees, GitHub alerts, readable code content, and application comparisons (#2439, #2469, #2459, #2473).

Upgrade notes

  • Fresh UI component contracts, variant attributes, tokens, and themes changed. Review the component and theming guides when upgrading authored UI (#2467, #2435, #2554, #2555).
  • Review service CORS and health-route authentication policies when upgrading existing services (#2422).
  • The Northwind showcase is opt-in through init --from showcase; review its generated configuration and sample data before adapting it for an application.
  • The toolchain remains pinned to Deno 2.9.7.

Known open items

The remaining S3 phase 3 promotions, S6b, Code Connect, S4 sign-off, Figma passes, and the Northwind showcase follow-ups in #2597 are deferred to 0.0.10. See #2474 for the release qualification record and deferred scope.

What's Changed

⚠️ Breaking changes

  • feat(streams): forward caller headers in Fresh and workers by @rickylabs in #2423

🚀 Features

  • feat(cli): render the scaffold chrome on every page and link ui:add pages by @rickylabs in #2407
  • feat(plugins): expose native workers and streams host policies by @rickylabs in #2421
  • feat(cli): install canonical design guidance for app agents by @rickylabs in #2456

🐛 Fixes

  • fix: patch Better Auth and qualify native Windows DB graphs by @rickylabs in #2426
  • fix(telemetry): isolate worker job and trigger delivery traces by @rickylabs in #2399
  • fix(service): enforce CORS response authority and health authentication by @rickylabs in #2422
  • fix(cli): wire the documented post-seed scaffold lifecycle by @rickylabs in #2592

📚 Documentation

  • docs: milestones are the next release plus themes by @rickylabs in #2442
  • docs(design-system): Utility keeps its chrome monochrome and its content in semantic colour by @rickylabs in #2457
  • docs(design-system): every theme language is a style over one component contract by @rickylabs in #2463
  • chore(design-system): add the Figma component library handoff by @rickylabs in #2486
  • chore(design-system): re-export the Figma variables with Theme B and Theme set by @rickylabs in #2493
  • chore(design-system): re-export the Figma variables after the contrast value pass by @rickylabs in #2506
  • chore(design-system): add the locked theme renders to the design handoff by @rickylabs in #2508
  • docs(design-system): say the locked renders predate the contrast pass by @rickylabs in #2513
  • docs(web-layer): theme your app with Studio Utility and tokens v2 by @rickylabs in #2554
  • docs(fresh-ui): connect app theming recipes and generated guidance by @rickylabs in #2555

🧰 Maintenance

Other changes

  • fix(fresh-ui): repair token pipeline and add design browser harness by @rickylabs in #2432
  • feat(docs): generate the design system section and theme gallery by @rickylabs in #2437
  • feat(docs): rebuild the docs site in NetScript Utility by @rickylabs in #2439
  • feat(fresh-ui): deliver tokens v2 and app overrides by @rickylabs in #2435
  • fix(docs): bound Pages snippet checks and build duration by @rickylabs in #2458
  • fix(docs-site): add semantic colour and readable code content by @rickylabs in #2459
  • fix(triggers): preserve scheduled work across processor restarts by @rickylabs in #2477
  • fix(docs-site): narrow parsed Markdown fixture elements safely by @rickylabs in #2480
  • fix(telemetry): bound instrumentation and freeze PostgreSQL fixtures by @rickylabs in #2476
  • feat(workers): honor handler retry policies and dead-letter exhausted jobs by @rickylabs in #2481
  • feat(fresh-ui): define component contracts and migrate variant attributes by @rickylabs in #2467
  • feat(watchers): recover trigger watches and support native-only strategy by @rickylabs in #2484
  • fix(database): refuse duplicate PostgreSQL connection options by @rickylabs in #2485
  • feat(fresh-ui): add registry v2 publishing and CLI parity by @rickylabs in #2468
  • fix(queue): reclaim Redis claims with fenced visibility leases by @rickylabs in #2483
  • docs(cli): use installed names for plugin updates by @rickylabs in #2489
  • feat(commands): ship outbox schema and bounded saga retention by @rickylabs in #2487
  • fix(service): distinguish missing and retired contract procedures by @rickylabs in #2492
  • fix(triggers): deduplicate file changes only while in flight by @rickylabs in #2479
  • perf(queue): honor Redis listener concurrency and bound dispatch latency by @rickylabs in #2496
  • feat(fresh-ui): resolve Theme B presets and audit token contrast by @rickylabs in #2495
  • fix(auth-kv-oauth): tolerate undecodable foreign cookie values by @rickylabs in #2498
  • fix(plugins): allow modules to opt out of generated registries by @rickylabs in #2497
  • fix(kv): defer memory atomic watch notifications until commit by @rickylabs in #2502
  • fix(fresh-ui): finish the contrast exclusion burn-down by @rickylabs in #2507
  • fix(kv): order Redis list pages and exclude cursor bounds by @rickylabs in #2505
  • docs(workflows): reconcile worker saga trigger and stream guidance by @rickylabs in #2494
  • fix(sagas): commit replay markers and transitions atomically by @rickylabs in #2499
  • fix(streams): support persisted producer epochs across restarts by @rickylabs in #2510
  • fix(workers): replenish listener restart budgets after recovery by @rickylabs in #2482
  • test(sagas): prove compensation retries after persistence failure by @rickylabs in #2512
  • docs(command): publish executable command and relay guides by @rickylabs in #2514
  • fix(workers): honor structured lifecycle log levels by @rickylabs in #2511
  • fix(aspire): replace database completion polling with a follow stream by @rickylabs in #2515
  • fix(plugins): support installed plugins with empty registries by @rickylabs in #2509
  • feat(figma): round-trip variables and install URL themes by @rickylabs in #2504
  • fix(sagas): preserve business state and use direct instance lookups by @rickylabs in #2517
  • fix(sagas): persist canonical Prisma instance statuses by @rickylabs in #2522
  • fix(logging): forward plugin service request and response levels by @rickylabs in #2523
  • fix(mcp): bind telemetry analysis to the selected AppHost by @rickylabs in #2521
  • fix(kv): seed bridge state when adapters omit initial events by @rickylabs in #2525
  • fix(sagas): discover explicitly declared runtime modules by @rickylabs in #2526
  • test(kv): observe debounce abort completion without latency budgets by @rickylabs in #2528
  • fix(auth): select database contributions by backend by @rickylabs in #2519
  • fix(cli): validate presets before scaffolding and require HTTPS by @rickylabs in #2518
  • fix(streams): provision opt-in storage in generated AppHosts by @rickylabs in #2520
  • feat(cli): report skipped and divergent browser-auth files by @rickylabs in #2530
  • test(cli): keep PostgreSQL health fixture inside the locked graph by @rickylabs in #2532
  • fix(ai): preserve busy provider failures and retry metadata by @rickylabs in #2527
  • fix(mcp): retrieve and cite the full published docs corpus by @rickylabs in #2529
  • test(sagas): investigate projected receipt flow across restarts by @rickylabs in #2534
  • fix(cli): retry transient JSR plugin requests by @rickylabs in #2533
  • test(cli): verify published generated-surface checks on Windows and Linux by @rickylabs in #2537
  • test(fresh): verify published native chat persistence and replay by @rickylabs in #2541
  • fix(plugins): detect crash-looping background child processes by @rickylabs in #2542
  • fix(cli): support and prove KV-only plugin consumers by @rickylabs in #2535
  • fix(fresh): preserve authored page route bindings by @rickylabs in #2536
  • feat(fresh-ui): adopt Studio Utility for shipped components and scaffolds by @rickylabs in #2503
  • fix(cli): restore deterministic offline docs manifest provenance by @rickylabs in #2546
  • fix(fresh-ui): coordinate registry dependency release pins by @rickylabs in #2549
  • perf(fresh-ui): consolidate Utility CSS and enforce size budgets by @rickylabs in #2558
  • feat(design-system): build themes and generate component docs by @rickylabs in #2560
  • feat(tooling): mirror acceptance evidence after merge by @rickylabs in #2564
  • feat(cli): redesign scaffold pages around Utility capabilities by @rickylabs in #2572
  • fix(cli): deliver installed plugins to linked web apps by @rickylabs in #2582
  • feat(cli): seed rich sample records and expose page projections by @rickylabs in #2583
  • feat(fresh-ui): complete contracts and core component gaps by @rickylabs in #2488
  • feat(cli): build real-data Utility scaffold pages by @rickylabs in #2586
  • fix(cli): connect record activity and seeded sample execution by @rickylabs in #2589
  • fix(cli): keep AI providers outside scaffold Vite graphs by @rickylabs in #2594
  • fix(cli): complete preset and theming follow-ups by @rickylabs in #2559
  • fix(docs): reduce builder payload and narrow component guidance by @rickylabs in #2573
  • fix(cli): derive and pin installed design guidance by @rickylabs in #2574
  • feat(cli): compose an opt-in Northwind showcase by @rickylabs in #2595

Full Changelog: v0.0.8...v0.0.9

Closed Issues

  • #2431 [design-system S9] Ship the design guidelines and theme skills to agents through the CLI
  • #2566 [cli] Scaffold home page shows a stale theme name and a CRUD card when no service is scaffolded
  • #2436 [design-system S8b] Docs Design system section: guidelines, theme gallery and generated theme pages
  • #2430 [design-system S8] Docs site UI revamp in NetScript Utility: layouts, components, search and mobile
  • #2587 [cli] Scaffold pages polish: chart, red usage, real activity, job progress, health false gap
  • #2591 [cli] Documented scaffold steps leave the post-seed job idle and activity unlinked from streams
  • #2593 fix(release): published scaffold Vite build fails on npm: specifiers from @netscript/ai (0.0.9-canary.2 red)
  • #2451 [design-system] Docs site follow-ups from the #2439 review
  • #2415 [design-system S2] Registry v2 and CLI parity with shadcn
  • #2552 [fresh-ui] docs: theme chain and app-wide recipe for Studio Utility and tokens v2 (from #2406)
  • #2396 feat(plugins): expose host auth, CORS and listener options for workers/streams startup
  • #2144 feat(workers): per-handler retry policy with backoff, and a dead-letter queue for jobs
  • #2187 fix(triggers): file-watch events dedup by payload hash for 24 h, so a second modify of the same path is dropped
  • #2406 web: new pages miss the scaffold nav and app-wide theme; agent guidance doesn't cover it (0.0.8)
  • #2470 [docs] Land the renderer, content pass and comparison refresh
  • #2413 [design-system S0] Token pipeline hygiene and a browser test harness
  • #2411 ai: chat client drops a provider's 429/503 status and Retry-After; withRetryingChatClient never retries it
  • #2409 fresh(route): page-binding pass adds a second .withRoute to pages that already bind a route
  • #2393 telemetry: shared workers grow one trace per worker (52k spans), not one per job run
  • #2392 workers: lifecycle messages bypass the structured logger and log levels
  • #2379 fix(cli): retry transient JSR errors when installing plugins (a 502 fails the install)
  • #2338 fix(streams): stable producer IDs acknowledge new documents as duplicates after restart
  • #2375 test(deps): the combined CLI/database suite adds npm:pg@^8.21.0 to the root lock
  • #2160 fix(sagas): keep business state in the read model and look one instance up directly
  • #2132 kv: RedisKvAdapter.list start is inclusive and pages are not globally ordered (SCAN batches sorted individually), unlike Deno KV
  • #1367 fix(streams): STREAMS_DATA_DIR is set by nothing the framework generates, so "durable streams" is always in-memory
  • #2068 fresh/ai: createNetScriptChatConnection.send narrows UIMessages to text, blocking adoption of the #1583 single-subscriber fix
  • #2547 fix(release): canary prep leaves 0.0.8 residue in Fresh UI registry v2 artifacts
  • #2233 refactor(tooling): make generated carriers deterministic and line-mergeable
  • #2268 fix(mcp): performance and status tools return zero samples instead of a binding error when not bound to the live AppHost
  • #2159 fix(sagas): persist the applied key, the transition and its effects atomically, and dispatch effects recoverably
  • #1366 fix(plugins): every declareHealthChecks returns only the API resource — a crash-looping background child leaves the declared health surface green
  • #2185 ci(e2e): make scaffold.runtime tiers robust to slow container image pulls and Aspire convergence on GitHub runners
  • #2108 feat(plugins): a supported KV-only install for workers, sagas and triggers
  • #2373 test(kv): Redis debounce-abort contract test uses a 150 ms wall-clock budget and flakes under load
  • #2149 fix(auth): the kv-oauth backend should not install the better-auth tables
  • #1912 feat(cli): expose non-mutating plugin and Aspire generated-surface parity
  • #2390 investigate(sagas/workers): canary.8 projected atomic saga stalls after background receipt publication failure
  • #2384 feat(cli): report skipped and divergent browser-auth files during reconciliation
  • #2269 docs(mcp): get_doc misses KV, telemetry, workers and streams pages; find_guidance routes read-model intents to unrelated pages
  • #2374 fix(sagas): discover explicitly declared self-composing saga modules instead of silently omitting factory exports
  • #2394 logging: plugin service entrypoints do not forward requestLevel/responseLevel
  • #2377 fix(kv): WatchableKvBridge needs an initial state when the wrapped adapter ignores initial
  • #2382 fix(sagas): the Prisma projection lists compensating, compensated and failed instances as running
  • #2162 fix(cli): generate plugins refuses an installed sagas plugin with an empty registry (--no-samples)
  • #2401 Aspire 13.5.3: every CLI call leaks two resource watches in the AppHost server, so CLI polling grows it without bound
  • #1491 [command C10] Publish command and relay guides with executable examples
  • #2383 fix(sagas): a write failure on a non-atomic store can strand an instance in compensating
  • #2400 plugin-workers: listener restart count never resets, so a transient KV outage fails listeners permanently
  • #2155 docs: contradictions found while mapping a production app onto workers, sagas, triggers and streams
  • #2267 fix(kv): MemoryKvAdapter.atomic exposes partial commits between awaited mutations
  • #2161 fix(plugins): triggers/workers registries load every *.ts in triggers/ and workers/jobs/ with no way to exclude a factory module
  • #2115 auth-kv-oauth: parseCookieHeader throws on one undecodable foreign cookie and loses the whole header
  • #2351 perf(workers): honor Redis listener concurrency and expose bounded dispatch latency
  • #2290 service/auth: an unknown or retired contract procedure answers 403 no-contract-procedure; clients cannot tell a retired version from a permission denial
  • #2369 feat(commands): ship outbox Prisma schema and bounded saga replay/outbox retention
  • #2385 docs(cli): plugin update guide uses rejected package-specifier syntax
  • #2395 queue: Redis adapter has no visibility timeout, stranded processing claims never return
  • #2367 database: refuse duplicate or aliased PostgreSQL connection-string keys before normalization
  • #2151 feat(watchers): a native-only strategy without silent polling fallback
  • #2438 deps(telemetry): OpenTelemetry API 1.10 / instrumentation 0.300 breaks command-postgres on main
  • #2478 fix(docs-site): Code quality red on main since #2469 (unsafe-cast in markdown-render-fixture)
  • #2165 fix(triggers): scheduled event ids restart at scheduled_1 per process, so runs are dropped as duplicates for 24 h after a restart
  • #1364 docs(orchestration-runtime): outbound webhook delivery has no recipe or template — triggers ship inbound ingress only, so every product hand-rolls signing, retry and dead-lettering
  • #1668 chore(mcp): export-surface corpus is stale on main and no branch can see it
  • #1667 test(queue): eliminate typed-queue DLQ timing flake
  • #2455 [design-system S8c] Docs site: syntax colours, status-tone callouts, kind tags and contrast
  • #2454 [docs] Pages build can hang for hours on the snippet check and block every later deploy
  • #2414 [design-system S1] Tokens v2: three tiers, resolver modes, Style Dictionary as the output engine
  • #2250 deps: decide on major upgrades (preact 11, vite 8, workos 11, ioredis 6, kvdex 4, rou3 1.0)
  • #2098 feat(streams): stream retention seam (create-time TTL, delete/head admin port) in plugin-streams-core
  • #2103 0.0.8 milestone run: orchestrated delivery of milestone 25
  • #2011 Delegation matrix: feature and complex implementation_evaluation have no affordable evaluator until 2026-10-04
  • #2391 docs(workers): document task stdin and bounded output at canary.8
  • #2156 chore(mcp): the embedded docs corpus lacks the background-processing and durable-workflows pages
  • #1386 fix(service): the default CORS policy is origin: '*', which makes credentialed browser calls impossible on every generated and plugin service

JSR Packages