@pugi/cli 1.0.0-alpha.241 → 1.0.0-alpha.242

package/skills/od-wireframe-sketch/NOTICE.md

@@ -0,0 +1,126 @@
+# Third-party skills vendored into the Pugi designer pack
+
+These skills are part of Sofia's (designer) skill pack. They help her go from a
+brief to a design system to the clickable HTML prototype that the customer
+approves at the plan gate (`.pugi/artifacts/prototype.html`, BACKLOG AO), and,
+since 2026-10-17, carry the craft rules every build turn is held to.
+
+The skill pack generator copies this file and `LICENSE-APACHE-2.0` into every
+vendored skill directory, so each one carries its attribution wherever it is
+baked.
+
+Both upstream projects are licensed under the Apache License, Version 2.0. The
+full licence text is in `LICENSE-APACHE-2.0` next to this file. The LICENSE file
+of each repository was checked before anything was copied (2026-10-04 and
+2026-10-17). Neither repository ships a NOTICE file, so this file is the
+attribution.
+
+## nexu-io/open-design
+
+- Source: https://github.com/nexu-io/open-design
+- Licence: Apache-2.0, "Copyright 2026 Open Design contributors"
+- The upstream `skills/README.md` says skills are Apache-2.0 unless their own
+  `LICENSE` says otherwise. No directory copied here has its own licence.
+- Commit 53231d40b778d88eba23f35547bf99485d3ae9fc (2026-09-30) for the two
+  prototype skills (re-checked unchanged at 3b0df90f and re-stamped);
+  commit 78d5637cb49da07e81314d1544b5fc6d37c95084 (v0.25.1, 2026-10-16) for
+  the craft rules and the two ports below; commit
+  3b0df90f305c8279e748c292accf336d02b924ef (2026-10-20) for the design
+  templates and design skills added 2026-10-21 (CEO: "Open Design inside
+  Pugi"). The LICENSE file of the repository was checked again on 2026-10-21.
+
+| Pugi skill | Upstream path | Files copied |
+|---|---|---|
+| `od-web-prototype` | `design-templates/web-prototype/` | `SKILL.md`, `assets/template.html`, `references/layouts.md`, `references/checklist.md` |
+| `od-reference-design-contract` | `skills/reference-design-contract/` | `SKILL.md`, `references/checklist.md` |
+| `od-craft` | `craft/` | all twelve documents, as `references/<name>.md`: `README.md`, `accessibility-baseline.md`, `animation-discipline.md`, `anti-ai-slop.md`, `color.md`, `form-validation.md`, `laws-of-ux.md`, `rtl-and-bidi.md`, `state-coverage.md`, `typography-hierarchy-editorial.md`, `typography-hierarchy.md`, `typography.md` |
+
+### Design templates (added 2026-10-21, commit 3b0df90f) — the "Start from" catalogue
+
+Each is `design-templates/<name>/` → `od-<name>/`, `SKILL.md` only unless noted.
+Apache-2.0, nexu-io/open-design contributors, except where a row says otherwise.
+
+| Pugi skill | Upstream path | Files copied / licence |
+|---|---|---|
+| `od-saas-landing`, `od-dashboard`, `od-mobile-onboarding`, `od-pricing-page`, `od-blog-post`, `od-docs-page`, `od-kanban-board`, `od-invoice`, `od-meeting-notes`, `od-contact-widget`, `od-email-marketing`, `od-social-carousel`, `od-wireframe-annotated`, `od-wireframe-greybox`, `od-wireframe-mobile-flow`, `od-wireframe-sketch`, `od-pm-spec`, `od-team-okrs`, `od-eng-runbook`, `od-finance-report`, `od-hr-onboarding`, `od-magazine-poster`, `od-webgl-experience` | `design-templates/<name>/` | `SKILL.md` |
+| `od-mobile-app` | `design-templates/mobile-app/` | `SKILL.md`, `assets/template.html`, `references/layouts.md`, `references/checklist.md` |
+| `od-waitlist-page` | `design-templates/waitlist-page/` | `SKILL.md`, `assets/template.html`, `references/checklist.md` |
+| `od-web-prototype-taste-soft`, `-editorial`, `-brutalist` | `design-templates/web-prototype-taste-*/` | `SKILL.md`; distilled by open-design from Leonxlnx/taste-skill (MIT, © 2026 Leonxlnx) — that MIT text is carried as `LICENSE-MIT-Leonxlnx` in each directory |
+| `od-login-flow` | `skills/login-flow/` | `SKILL.md`, `references/checklist.md` |
+| `od-faq-page` | `skills/faq-page/` | `SKILL.md` |
+
+### Design skills (added 2026-10-21, commit 3b0df90f)
+
+| Pugi skill | Upstream path | Files copied / licence |
+|---|---|---|
+| `od-design-brief` | `skills/design-brief/` | `SKILL.md` (Apache-2.0, nexu-io) |
+| `od-critique` | `design-templates/critique/` | `SKILL.md` (Apache-2.0, nexu-io) |
+| `od-frontend-design` | `skills/frontend-design/` | `SKILL.md`, `LICENSE.txt` (Apache-2.0; the skill is Anthropic's `frontend-design` as open-design redistributes it) |
+| `od-redesign-skill` | `skills/redesign-skill/` | `SKILL.md`, `LICENSE` (MIT, © 2026 Leonxlnx; upstream frontmatter name `redesign-existing-projects`) |
+| `od-web-design-guidelines` | `skills/web-design-guidelines/` | `SKILL.md`, `LICENSE`, `references/guidelines.md` (MIT, vercel-labs/web-interface-guidelines, as open-design redistributes it) |
+
+Looked at and left out on 2026-10-21 (no licence file in the open-design
+directory although the upstream is MIT/Apache; take later with the upstream
+text): `design-md`, `enhance-prompt` (google-labs-code/skills),
+`design-consultation`, `plan-design-review` (garrytan/gstack, MIT),
+`copywriting` (coreyhaines31/marketingskills, MIT), `impeccable-design-polish`
+(pbakaus/impeccable, Apache-2.0), `ui-skills` (ibelick/ui-skills, MIT),
+`emil-design-eng`, `animate`, `review-animations`, `stitch-skill`. Decks,
+video, live-artifact and `tweaks` templates are not Pugi surfaces.
+
+Upstream attributions kept inside those files: `craft/` is adapted from
+referodesign/refero_skill (MIT, © Refero Design); the "Adapted from" lines
+stay where upstream put them.
+
+### Ports (derivative works, Apache-2.0 §4), not copies
+
+| Pugi file | Upstream source | What changed |
+|---|---|---|
+| `packages/opencode/src/session/design-lint.ts` | `apps/daemon/src/lint-artifact.ts` | The seven P0 checks and the external-image advisory are kept; the finding shape is local; it runs over a workspace (source and `dist/`) rather than one artifact body; Tailwind utility-class forms of each sin are added; the deck, `data-od-id`, all-caps tracking and raw-hex checks are dropped; the sans-display check fires only when a serif display token is bound. The daemon's analytics were never in this file. |
+| `packages/opencode/src/scaffold/design-direction.ts` | `apps/daemon/src/prompts/directions.ts` | The five schools are kept as postures; labels no longer name other brands; palettes are hex; faces are the Google fonts the starters link; two directions added; no question form (the direction is decided by the model, never asked of the customer). |
+| `packages/plugin-pugi-personas/src/craft-digest.ts` | `craft/*.md` | A condensed summary written by Pugi from the twelve documents. |
+
+Nothing ported touches the network: open-design's PostHog / Langfuse telemetry
+lives in its apps, none of which were taken.
+
+## nexu-io/html-anything
+
+- Source: https://github.com/nexu-io/html-anything
+- Commit: 553ed98c283f9c0f489902d035416a972d6a9699 (2026-09-15)
+- Licence: Apache-2.0. The upstream copyright line is the unfilled template
+  ("Copyright [yyyy] [name of copyright owner]"), so the copyright belongs to
+  the html-anything contributors.
+
+| Pugi skill | Upstream path | Files copied |
+|---|---|---|
+| `ha-prototype-web` | `next/src/lib/templates/skills/prototype-web/` | `SKILL.md` |
+
+## Changes made by Pugi (Apache-2.0 §4(b))
+
+- The frontmatter `name` of every `SKILL.md` was prefixed (`od-`, `ha-`). Skill
+  names are permission patterns in Pugi, and upstream names such as
+  `web-prototype` would collide across the two sources.
+- One HTML comment was added under each frontmatter block. It names the source,
+  the commit and these changes.
+- `od-craft/SKILL.md` is written by Pugi (upstream has no skill wrapper for
+  `craft/`; its daemon injects the files per `od.craft.requires`). Each
+  `references/*.md` begins with one added HTML comment naming the source
+  commit and stating that the rest is verbatim; the text below it is
+  unchanged, including upstream's references to its own paths
+  (`apps/daemon/src/lint-artifact.ts`, `pnpm lint:craft`).
+- Example files (`example.html`, `example.md`) were not copied (the sanitised
+  example pages live under `scaffold/seeds/` with their own NOTICE).
+- The three `od-web-prototype-taste-*` directories and `od-redesign-skill`
+  carry the MIT licence of Leonxlnx next to the Apache-2.0 text, because the
+  upstream `skills/README.md` says a skill's own LICENSE prevails.
+- Every other byte of the copied files is unchanged.
+
+Where an upstream rule conflicts with the Pugi plan-gate prototype contract in
+Sofia's persona prompt, the Pugi contract wins.
+Two upstream rules conflict on purpose. The output file is
+`.pugi/artifacts/prototype.html`, not `index.html`. Photos are Pexels CDN URLs
+taken from Anvil `/v1/images`, not copies in the project, because the console
+renders the prototype from a single document.
+Where a craft rule names open-design's tokens (`var(--accent)`), the starter's
+own token scheme (`src/globals.css` bare HSL components, `src/theme.css`
+typefaces) wins.

package/skills/od-wireframe-sketch/SKILL.md

@@ -0,0 +1,98 @@
+---
+name: od-wireframe-sketch
+description: |
+  A hand-drawn wireframe exploration — graph-paper background, marker /
+  pencil tone, multiple tab labels for variants, sticky-note annotations,
+  scribbled chart placeholders, hatched fills. Reads like a designer's
+  whiteboard before any pixels are committed. Use when the brief asks for
+  "wireframe", "sketch wireframe", "hand-drawn", "lo-fi", "whiteboard",
+  "草稿", or "手绘原型".
+triggers:
+  - "wireframe"
+  - "sketch wireframe"
+  - "lo-fi mockup"
+  - "hand drawn"
+  - "whiteboard sketch"
+  - "low fidelity"
+  - "手绘原型"
+  - "草图"
+  - "线框图"
+od:
+  mode: prototype
+  platform: desktop
+  scenario: design
+  fidelity: wireframe
+  preview:
+    type: html
+    entry: index.html
+  design_system:
+    requires: false
+    sections: [color, typography, layout, components]
+  example_prompt: "Sketch a hand-drawn wireframe v0.1 for a portal — four tabbed variants on graph paper, marker headlines, sticky-note annotations, hatched chart placeholders."
+---
+<!-- Vendored from nexu-io/open-design@3b0df90f305c (design-templates/wireframe-sketch), Apache-2.0. Modified by Pugi: frontmatter `name` changed from `wireframe-sketch` to `od-wireframe-sketch`; example files omitted. See NOTICE.md in this directory. Where this skill conflicts with the Pugi plan-gate prototype contract in the designer persona prompt, the Pugi contract wins. -->
+
+# Wireframe Sketch Skill
+
+Produce a single hand-drawn wireframe page. The whole point is "this is a
+sketch" — looseness is the brand. Lean into pencil/marker tones, hatched
+fills, dashed borders, slight rotations.
+
+## Workflow
+
+1. **Skip the DESIGN.md** if it pushes for finished UI. This skill explicitly
+   wants a low-fidelity look. Only honor type tokens loosely (system serif
+   for headlines, mono for annotations, marker font fallback).
+2. **Pick the screen variants** from the brief — typically 3–4 tab labels
+   like "01 · A · ORGANIZED", "02 · B · DASHBOARD", etc. One is "active",
+   the rest are inactive sketch tabs.
+3. **Layout**, in order:
+   - **Page header** — bold serif title with a fake "WIREFRAME v0.1" tag
+     pinned next to it (dashed border, slight rotation). Below: one-line
+     subtitle in marker italic + a date / device / fidelity dateline on
+     the right in mono.
+   - **Tab strip** — 4–5 labels with marker check-square glyphs. The active
+     one has a highlighter swipe behind it (yellow / orange tint + slight
+     skew).
+   - **Sketch canvas** — a graph-paper card (background: 24px × 24px grid
+     drawn with `linear-gradient` lines), with a thick rounded border drawn
+     to look like a sharpie line.
+   - **Browser chrome row** — three sketched circles + a fake URL bar with
+     a hand-written-style URL.
+   - **Sidebar nav** — sketched checkbox + label for each nav item, marker
+     italic. One has a highlighter line through it (active).
+   - **KPI tiles** — 3–4 boxes, each with a chunky scribbled number in a
+     marker-style stroke, a tiny accent stamp, and a one-line label.
+   - **Chart placeholder** — a card with a hand-drawn axis and a wobbly
+     polyline. Add 3–4 dot markers.
+   - **Bar chart placeholder** — a card with hatched-fill rectangles of
+     varying heights.
+   - **Sticky notes** — 1–2 yellow / pink notes with marker text, taped
+     with a slightly rotated band, pinned over key regions to call out
+     "next step", "page-1", or "needs review".
+4. **Write** a single HTML document:
+   - `<!doctype html>` through `</html>`, CSS inline.
+   - Use the system's available "Caveat", "Patrick Hand", or "Architects
+     Daughter" fonts via Google Fonts; otherwise fall back to italic serif.
+   - Slight rotations everywhere (`transform: rotate(-0.6deg)`) to break
+     the grid and feel hand-drawn.
+   - `data-od-id` on header, tabs, sidebar, KPIs, chart, bar-chart,
+     sticky notes.
+5. **Self-check**:
+   - The page should *not* look pixel-perfect. If it does, you over-rendered.
+   - Marker / pencil + graph paper + hatched fills + sticky notes are all
+     present; if any is missing, add it.
+   - The active tab has the highlighter swipe; the others don't.
+
+## Output contract
+
+Emit between `<artifact>` tags:
+
+```
+<artifact identifier="wireframe-slug" type="text/html" title="Wireframe — Title">
+<!doctype html>
+<html>...</html>
+</artifact>
+```
+
+One sentence before the artifact, nothing after.