You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
The auto-install / bun zero-install documentation is out of sync across surfaces, found while dogfooding a fresh bun create webjs my-app (cli 0.10.26). The scaffolded app's AGENTS.md still carries the pre-#698 claim:
Under zero-install, deps resolve to their LATEST version: ranges and any bun.lock are ignored by the runtime auto-install (only an exact package.json pin is honored, via an onLoad rewrite). Run bun install when you want pinned, reproducible versions...
Wrong on two counts now:
feat: forward inline-safe ranges in the bun zero-install pin rewrite #698 (merged, released in server 0.8.37 / cli 0.10.26) made the onLoad rewrite forward inline-safe RANGES too, not just exact, so a caret/tilde/comparator range resolves to the highest match under zero-install (not absolute latest). "Only an exact pin is honored" is stale.
dogfood: bun zero-install bun run dev fails, cli can't resolve @webjsdev/server #709 (open): bun zero-install bun run dev currently FAILS for a fresh scaffold (the cli's bare import('@webjsdev/server') ENOENTs, bun's runtime auto-install does not reliably fetch it). So any doc that promises a Bun app "serves with no bun install" is currently OVER-PROMISING.
The main source surfaces were updated in #698/#700 (agent-docs/runtime.md, docs/app/docs/runtime/page.ts, root AGENTS.md, packages/cli/templates/AGENTS.md, packages/cli/lib/create.js banner), but these were MISSED and/or are now inaccurate given #709:
packages/cli/AGENTS.md L102-106 ("auto-install resolves deps and a Bun app serves with no bun install"), L134, L202 ("since webjs create auto-installs").
The PUBLISHED cli 0.10.26 artifact's template AGENTS.md is what the user actually scaffolded (the stale block above). Confirm whether the publish included the feat: forward inline-safe ranges in the bun zero-install pin rewrite #698 template fix or shipped stale, and whether a republish is needed.
Design / approach
One comprehensive pass (use the webjs-doc-sync skill's surface map) aligning EVERY auto-install / zero-install mention with the TRUE current behavior, gating the "it works" claims on #709:
Surfaces to audit (generative, run git ls-files + grep, not exhaustive): agent-docs/runtime.md, docs/app/docs/runtime/page.ts (+ getting-started/deployment), root AGENTS.md, packages/cli/AGENTS.md, packages/cli/templates/AGENTS.md + the per-agent rule files in packages/cli/templates/ (.cursorrules, .agents/rules/*, .github/copilot-instructions.md, CLAUDE.md, CONVENTIONS.md), packages/cli/lib/create.js (post-scaffold banner), website/app/page.ts, README.md, packages/*/README.md.
Grep seeds: "resolve to their LATEST", "ranges and any", "only an exact", "serves with no bun install", "auto-install", "zero-install", "absolute latest".
Landmine: the scaffolded app's AGENTS.md is generated from the template at the cli VERSION the user installed; a source fix only reaches users on the next cli publish. Confirm the next cli release carries the corrected template.
Problem
The auto-install / bun zero-install documentation is out of sync across surfaces, found while dogfooding a fresh
bun create webjs my-app(cli 0.10.26). The scaffolded app's AGENTS.md still carries the pre-#698 claim:Wrong on two counts now:
bun run devcurrently FAILS for a fresh scaffold (the cli's bareimport('@webjsdev/server')ENOENTs, bun's runtime auto-install does not reliably fetch it). So any doc that promises a Bun app "serves with nobun install" is currently OVER-PROMISING.The main source surfaces were updated in #698/#700 (agent-docs/runtime.md, docs/app/docs/runtime/page.ts, root AGENTS.md, packages/cli/templates/AGENTS.md, packages/cli/lib/create.js banner), but these were MISSED and/or are now inaccurate given #709:
packages/cli/AGENTS.mdL102-106 ("auto-install resolves deps and a Bun app serves with nobun install"), L134, L202 ("sincewebjs createauto-installs").Design / approach
One comprehensive pass (use the webjs-doc-sync skill's surface map) aligning EVERY auto-install / zero-install mention with the TRUE current behavior, gating the "it works" claims on #709:
bun run devmay currently fail to fetch the cli/server, so recommendbun installas the reliable path and qualify any "serves with no install" promise. Flip those to the working claim once dogfood: bun zero-install bun run dev fails, cli can't resolve @webjsdev/server #709 merges.Implementation notes (for the implementing agent)
git ls-files+ grep, not exhaustive):agent-docs/runtime.md,docs/app/docs/runtime/page.ts(+ getting-started/deployment), rootAGENTS.md,packages/cli/AGENTS.md,packages/cli/templates/AGENTS.md+ the per-agent rule files inpackages/cli/templates/(.cursorrules,.agents/rules/*,.github/copilot-instructions.md,CLAUDE.md,CONVENTIONS.md),packages/cli/lib/create.js(post-scaffold banner),website/app/page.ts,README.md,packages/*/README.md.bun install", "auto-install", "zero-install", "absolute latest".Acceptance criteria
bun install" while dogfood: bun zero-install bun run dev fails, cli can't resolve @webjsdev/server #709 is open (or this lands after dogfood: bun zero-install bun run dev fails, cli can't resolve @webjsdev/server #709 so the promise is true).Relates to #698, #700, #703, #705, #709.