@pugi/cli 1.0.0-alpha.156 → 1.0.0-alpha.158

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pugi/cli",
-  "version": "1.0.0-alpha.156",
+  "version": "1.0.0-alpha.158",
   "description": "Pugi CLI - terminal-native software execution system",
   "license": "MIT",
   "homepage": "https://pugi.io",
@@ -40,11 +40,11 @@
     "LICENSE"
   ],
   "optionalDependencies": {
-    "@pugi/cli-darwin-arm64": "1.0.0-alpha.156",
-    "@pugi/cli-darwin-x64": "1.0.0-alpha.156",
-    "@pugi/cli-linux-arm64": "1.0.0-alpha.156",
-    "@pugi/cli-linux-x64": "1.0.0-alpha.156",
-    "@pugi/cli-windows-arm64": "1.0.0-alpha.156",
-    "@pugi/cli-windows-x64": "1.0.0-alpha.156"
+    "@pugi/cli-darwin-arm64": "1.0.0-alpha.158",
+    "@pugi/cli-darwin-x64": "1.0.0-alpha.158",
+    "@pugi/cli-linux-arm64": "1.0.0-alpha.158",
+    "@pugi/cli-linux-x64": "1.0.0-alpha.158",
+    "@pugi/cli-windows-arm64": "1.0.0-alpha.158",
+    "@pugi/cli-windows-x64": "1.0.0-alpha.158"
   }
 }

package/skills/css-tailwind/SKILL.md

@@ -17,6 +17,11 @@ Refactors CSS to Tailwind, fixes spacing rhythm, ensures dark/light parity.
 - Both themes are shipped. A colour that only reads on the dark ground is a bug on the light one; take colour from variables so the theme decides.
 
 
+## Known failure modes
+
+Read `quirks.md` in this directory BEFORE writing code in this domain. It records 5 failures that reached a customer build, each with the symptom, the cause, and the check that tells them apart.
+
+
 ## Grounding
 
 This skill retrieves from the Anvil RAG workspace `ui_registry`. Ask grounded questions in that domain before inventing answers.

package/skills/css-tailwind/quirks.md

@@ -0,0 +1,56 @@
+<!-- GENERATED by pugi-core packages/opencode/script/generate-persona-skill-pack.ts — do not hand-edit. -->
+
+# Tailwind Polish — known failure modes
+
+Each entry below reached a customer build. The symptom is what you will
+actually observe; the build succeeds in every one of these cases.
+
+## v3-directives-under-v4
+
+**Symptom.** The build succeeds and the page renders with NO styling at all — plain black text on white, browser default fonts.
+
+**Cause.** The stylesheet still opens with the v3 directives `@tailwind base/components/utilities` while package.json pins tailwindcss v4. Those directives do not exist in v4, so PostCSS emits no utility classes and reports no error.
+
+**Check.** Read the tailwindcss version in package.json, then the first lines of src/index.css. v4 must open with `@import "tailwindcss";`.
+
+**Fix.** Replace the three directives with `@import "tailwindcss";`, or put tailwindcss back on ^3 and use `tailwindcss: {}` in postcss.config.js instead of `@tailwindcss/postcss`. The two halves must agree.
+
+## palette-in-root-without-theme
+
+**Symptom.** Layout works — spacing, flex, max-width all apply — but every colour is missing: no backgrounds, no surfaces, text is default black.
+
+**Cause.** The palette is declared as `--color-*` variables inside `:root`. v4 turns a variable into a utility class only when it is declared inside an `@theme` block, and it ignores tailwind.config.js unless the stylesheet asks with `@config`.
+
+**Check.** If `:root` contains `--color-` and the file has neither `@theme` nor `@config`, the token classes generate nothing. Confirm by grepping the BUILT css for one token class, e.g. `bg-background`.
+
+**Fix.** Move the palette into an `@theme` block, or add `@config "./tailwind.config.js";`. Then grep the built css for the classes the components use before reporting done.
+
+## unlayered-global-reset
+
+**Symptom.** Colours and borders are correct but the page has no rhythm — `px-4` computes to 0px, `mx-auto` does not centre, nothing has margins.
+
+**Cause.** A global `* { margin: 0; padding: 0 }` sits outside any `@layer`. v4 puts its utilities in cascade layers, and unlayered css beats layered css regardless of specificity, so one rule overrides every spacing utility at once.
+
+**Check.** Search the stylesheet for a `*` selector setting margin or padding that is not inside `@layer`. Then inspect a padded element in the browser and read the computed padding.
+
+**Fix.** Wrap the reset in `@layer base { ... }`, or delete it — Tailwind's own preflight already does this job.
+
+## v4-entry-under-v3
+
+**Symptom.** The build succeeds and the page renders unstyled, the mirror image of the first quirk.
+
+**Cause.** The stylesheet uses the v4 entry `@import "tailwindcss"` while package.json pins tailwindcss v3, which does not understand it.
+
+**Check.** Compare the pinned major in package.json against the stylesheet entry line. They must agree.
+
+**Fix.** Use the v3 directives for a v3 pin, or move the pin to v4. Do not mix the two dialects.
+
+## dev-script-not-at-root
+
+**Symptom.** The app builds and runs, but the hosted preview shows nothing or a 503 — the runner reports it found no dev command.
+
+**Cause.** In a monorepo the dev script lives in a workspace package (apps/web, packages/web, client, frontend) or is named `dev:web` rather than `dev`, and a root-only lookup misses it.
+
+**Check.** Read the root package.json scripts, then the workspace package's own scripts before concluding there is no dev command.
+
+**Fix.** Declare the runnable script at the root, or make sure the app directory is the one handed to the runner. State the app directory explicitly rather than letting it be guessed.