@greenharness/greenrack-cli 0.0.0-stage → 7.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (125) hide show
  1. package/README.md +335 -2
  2. package/agents/design-system-lookup.md +59 -0
  3. package/dist/bin.d.ts +3 -0
  4. package/dist/bin.d.ts.map +1 -0
  5. package/dist/bin.js +145 -0
  6. package/dist/bin.js.map +1 -0
  7. package/dist/catalog.d.ts +13 -0
  8. package/dist/catalog.d.ts.map +1 -0
  9. package/dist/catalog.js +67 -0
  10. package/dist/catalog.js.map +1 -0
  11. package/dist/commands/context.d.ts +17 -0
  12. package/dist/commands/context.d.ts.map +1 -0
  13. package/dist/commands/context.js +110 -0
  14. package/dist/commands/context.js.map +1 -0
  15. package/dist/commands/doctor.d.ts +75 -0
  16. package/dist/commands/doctor.d.ts.map +1 -0
  17. package/dist/commands/doctor.js +1008 -0
  18. package/dist/commands/doctor.js.map +1 -0
  19. package/dist/commands/hook.d.ts +10 -0
  20. package/dist/commands/hook.d.ts.map +1 -0
  21. package/dist/commands/hook.js +323 -0
  22. package/dist/commands/hook.js.map +1 -0
  23. package/dist/commands/list.d.ts +4 -0
  24. package/dist/commands/list.d.ts.map +1 -0
  25. package/dist/commands/list.js +59 -0
  26. package/dist/commands/list.js.map +1 -0
  27. package/dist/commands/lookup.d.ts +13 -0
  28. package/dist/commands/lookup.d.ts.map +1 -0
  29. package/dist/commands/lookup.js +66 -0
  30. package/dist/commands/lookup.js.map +1 -0
  31. package/dist/commands/manifest.d.ts +5 -0
  32. package/dist/commands/manifest.d.ts.map +1 -0
  33. package/dist/commands/manifest.js +33 -0
  34. package/dist/commands/manifest.js.map +1 -0
  35. package/dist/commands/mcp.d.ts +159 -0
  36. package/dist/commands/mcp.d.ts.map +1 -0
  37. package/dist/commands/mcp.js +235 -0
  38. package/dist/commands/mcp.js.map +1 -0
  39. package/dist/commands/mockup.d.ts +80 -0
  40. package/dist/commands/mockup.d.ts.map +1 -0
  41. package/dist/commands/mockup.js +714 -0
  42. package/dist/commands/mockup.js.map +1 -0
  43. package/dist/commands/skill.d.ts +15 -0
  44. package/dist/commands/skill.d.ts.map +1 -0
  45. package/dist/commands/skill.js +398 -0
  46. package/dist/commands/skill.js.map +1 -0
  47. package/dist/disambiguation.d.ts +24 -0
  48. package/dist/disambiguation.d.ts.map +1 -0
  49. package/dist/disambiguation.js +56 -0
  50. package/dist/disambiguation.js.map +1 -0
  51. package/dist/extension-pointer.d.ts +7 -0
  52. package/dist/extension-pointer.d.ts.map +1 -0
  53. package/dist/extension-pointer.js +30 -0
  54. package/dist/extension-pointer.js.map +1 -0
  55. package/dist/format.d.ts +19 -0
  56. package/dist/format.d.ts.map +1 -0
  57. package/dist/format.js +213 -0
  58. package/dist/format.js.map +1 -0
  59. package/dist/hook-script.d.ts +73 -0
  60. package/dist/hook-script.d.ts.map +1 -0
  61. package/dist/hook-script.js +165 -0
  62. package/dist/hook-script.js.map +1 -0
  63. package/dist/index.d.ts +7 -0
  64. package/dist/index.d.ts.map +1 -0
  65. package/dist/index.js +6 -0
  66. package/dist/index.js.map +1 -0
  67. package/dist/legacy-names.d.ts +26 -0
  68. package/dist/legacy-names.d.ts.map +1 -0
  69. package/dist/legacy-names.js +26 -0
  70. package/dist/legacy-names.js.map +1 -0
  71. package/dist/manifest.d.ts +51 -0
  72. package/dist/manifest.d.ts.map +1 -0
  73. package/dist/manifest.js +229 -0
  74. package/dist/manifest.js.map +1 -0
  75. package/dist/registry-types.d.ts +106 -0
  76. package/dist/registry-types.d.ts.map +1 -0
  77. package/dist/registry-types.js +2 -0
  78. package/dist/registry-types.js.map +1 -0
  79. package/dist/registry.d.ts +52 -0
  80. package/dist/registry.d.ts.map +1 -0
  81. package/dist/registry.js +95 -0
  82. package/dist/registry.js.map +1 -0
  83. package/dist/scan.d.ts +19 -0
  84. package/dist/scan.d.ts.map +1 -0
  85. package/dist/scan.js +29 -0
  86. package/dist/scan.js.map +1 -0
  87. package/dist/search.d.ts +16 -0
  88. package/dist/search.d.ts.map +1 -0
  89. package/dist/search.js +75 -0
  90. package/dist/search.js.map +1 -0
  91. package/dist/skill-template.d.ts +24 -0
  92. package/dist/skill-template.d.ts.map +1 -0
  93. package/dist/skill-template.js +140 -0
  94. package/dist/skill-template.js.map +1 -0
  95. package/greenharness.toml +38 -0
  96. package/package.json +76 -3
  97. package/registry.json +12893 -0
  98. package/skills/colors/LICENSE +21 -0
  99. package/skills/colors/NOTICE.md +36 -0
  100. package/skills/colors/SKILL.md +101 -0
  101. package/skills/colors/color-formats.md +90 -0
  102. package/skills/colors/color-usage.md +109 -0
  103. package/skills/colors/contrast.md +70 -0
  104. package/skills/colors/palette-generation.md +108 -0
  105. package/skills/colors/palette-structure.md +72 -0
  106. package/skills/colors/token-naming.md +99 -0
  107. package/skills/greenrack-mockup/SKILL.md +115 -0
  108. package/skills/typography/LICENSE +21 -0
  109. package/skills/typography/NOTICE.md +36 -0
  110. package/skills/typography/SKILL.md +171 -0
  111. package/skills/typography/choosing-fonts.md +53 -0
  112. package/skills/typography/css-cheat-sheet.md +67 -0
  113. package/skills/typography/details-and-accessibility.md +84 -0
  114. package/skills/typography/spacing-and-sizing.md +87 -0
  115. package/skills/typography/variable-fonts-and-opentype.md +100 -0
  116. package/skills/typography/wrapping-and-punctuation.md +23 -0
  117. package/skills/ui/LICENSE +21 -0
  118. package/skills/ui/NOTICE.md +38 -0
  119. package/skills/ui/SKILL.md +141 -0
  120. package/skills/ui/animations.md +170 -0
  121. package/skills/ui/enter-exit.md +157 -0
  122. package/skills/ui/icon-transitions.md +72 -0
  123. package/skills/ui/icons.md +105 -0
  124. package/skills/ui/performance.md +63 -0
  125. package/skills/ui/surfaces.md +166 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,qBAAqB,CAAA;AAGjD,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAgBxD;AAED,oEAAoE;AACpE,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAOvE;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,WAAW,GAAG,QAAQ,CAAA;IAC5B,GAAG,EAAE,MAAM,CAAA;IACX,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,CAwCrE"}
package/dist/search.js ADDED
@@ -0,0 +1,75 @@
1
+ import { lookupNames } from './registry.js';
2
+ export function levenshtein(a, b) {
3
+ const rows = a.length + 1;
4
+ const cols = b.length + 1;
5
+ const dist = Array.from({ length: rows }, (_, i) => {
6
+ const row = new Array(cols).fill(0);
7
+ row[0] = i;
8
+ return row;
9
+ });
10
+ for (let j = 0; j < cols; j++)
11
+ dist[0][j] = j;
12
+ for (let i = 1; i < rows; i++) {
13
+ for (let j = 1; j < cols; j++) {
14
+ const cost = a[i - 1].toLowerCase() === b[j - 1].toLowerCase() ? 0 : 1;
15
+ dist[i][j] = Math.min(dist[i - 1][j] + 1, dist[i][j - 1] + 1, dist[i - 1][j - 1] + cost);
16
+ }
17
+ }
18
+ return dist[a.length][b.length];
19
+ }
20
+ /** Closest names for "did you mean" — distance <= 2, best first. */
21
+ export function suggestions(registry, query) {
22
+ return lookupNames(registry)
23
+ .map((name) => ({ name, distance: levenshtein(query, name) }))
24
+ .filter(({ distance }) => distance <= 2)
25
+ .sort((a, b) => a.distance - b.distance)
26
+ .slice(0, 3)
27
+ .map(({ name }) => name);
28
+ }
29
+ /**
30
+ * Full-text need-search over metas: agents rarely know the name — they know
31
+ * the need, and whenToUse text is exactly need-phrased.
32
+ */
33
+ export function search(registry, query) {
34
+ const terms = query
35
+ .toLowerCase()
36
+ .split(/[^a-z0-9]+/)
37
+ .filter((term) => term.length > 2);
38
+ if (terms.length === 0)
39
+ return [];
40
+ const hits = [];
41
+ const score = (fields) => {
42
+ let total = 0;
43
+ for (const [text, weight] of fields) {
44
+ const haystack = text.toLowerCase();
45
+ for (const term of terms) {
46
+ if (haystack.includes(term))
47
+ total += weight;
48
+ }
49
+ }
50
+ return total;
51
+ };
52
+ for (const [key, entry] of Object.entries(registry.components)) {
53
+ if (!entry.meta)
54
+ continue;
55
+ const total = score([
56
+ [entry.name, 5],
57
+ [entry.meta.description, 3],
58
+ [entry.meta.whenToUse.join(' '), 2],
59
+ [entry.meta.whenNotToUse.join(' '), 1],
60
+ ]);
61
+ if (total > 0)
62
+ hits.push({ kind: 'component', key, description: entry.meta.description, score: total });
63
+ }
64
+ for (const [key, entry] of Object.entries(registry.recipes)) {
65
+ const total = score([
66
+ [entry.name, 5],
67
+ [entry.meta.description, 3],
68
+ [entry.meta.whenToUse.join(' '), 2],
69
+ ]);
70
+ if (total > 0)
71
+ hits.push({ kind: 'recipe', key, description: entry.meta.description, score: total });
72
+ }
73
+ return hits.sort((a, b) => b.score - a.score || (a.key < b.key ? -1 : 1)).slice(0, 8);
74
+ }
75
+ //# sourceMappingURL=search.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"search.js","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,24 @@
1
+ /**
2
+ * The generated Claude Code skill that runs a screen from mockup to PR
3
+ * without leaving the design system.
4
+ *
5
+ * Kept as data (not prose in a README) so `greenrack skill install` can write it
6
+ * and `greenrack skill install --check` can byte-compare it: every consuming repo
7
+ * runs the same workflow, and a change to it is a regenerate rather than
8
+ * N hand-edits. Repo-specific notes go in SKILL_NOTES_PATH, which the skill
9
+ * tells the agent to read and which regeneration never touches.
10
+ */
11
+ /** Repo-relative paths the install owns. */
12
+ export declare const SKILL_DIR = ".claude/skills/greenrack-mockup";
13
+ export declare const SKILL_PATH = ".claude/skills/greenrack-mockup/SKILL.md";
14
+ /** Repo-specific caveats, read by the skill and never touched by install. */
15
+ export declare const SKILL_NOTES_PATH = ".claude/greenrack-mockup.local.md";
16
+ /**
17
+ * Floor for the npx pin inside the skill. `greenrack mockup` landed in 3.0.0; it
18
+ * moves with the hook's floor to the release's own major (6.0.0), so a 6.x
19
+ * consumer runs a 6.x CLI. A floating pin keeps patch releases from showing
20
+ * up as --check drift.
21
+ */
22
+ export declare const SKILL_MIN_CLI = "7.0.0";
23
+ export declare const SKILL = "---\nname: greenrack-mockup\ndescription: Take a new screen from mockup directions to an implemented, verified PR without leaving the greenrack design system. Use whenever the user asks for a screen, a page, a UI proposal, mockups, or \"show me options\" in a repo that consumes @greenharness/greenrack-ui \u2014 and when planning (plan mode) a new screen or a material layout, hierarchy or interaction change there.\n---\n\n**Gate.** This skill applies only in a repository whose `package.json` depends on `@greenharness/greenrack-ui`, or on the old `@duro-app/ui` it replaces (a `workspace:` dependency counts). Anywhere else, stop: do not apply it.\n\n# greenrack-mockup\n\nGENERATED by `greenrack skill install` \u2014 do not hand-edit. Regenerate:\n`npx -y @greenharness/greenrack-cli@^7.0.0 skill install` (`--check` verifies it in CI). Repo-specific notes\nlive in `.claude/greenrack-mockup.local.md`; read it if it exists.\n\nStanding rule (fleet decision `ui.mockup-handoff`): a mockup is written in\nthe design system's own vocabulary, and the direction the user picks is a\ncontract. What binds: layout, hierarchy, states, the `data-gr` component\nmap and the token names, sizes and border widths included (ADR-0027). What\ndoes not bind: positions (top, left, inset, transform).\n\n**This overrides the `design` skill's step 0.** That skill says to lift\nresolved values from the real stylesheets. Here you never write a resolved\nvalue: every colour, spacing, radius, font, shadow and duration is a\n`var(--gr-*)` from the seeded token block, and every element a person can\nact on carries `data-gr=\"<Component>\"`. Everything this workflow needs ships\nwith the CLI: `mockup seed` writes the artboard, `mockup check` gates it and\n`mockup canvas` builds the page the person picks from.\n\n## Args\n\n- `propose <screen>` \u2014 seed 2\u20134 direction artboards, check them, publish the canvas.\n- `implement <screen> <direction>` \u2014 build the picked direction from its component map.\n- `prove <route>` \u2014 screenshot the built route and assemble the PR section.\n- no args \u2014 infer the stage from what exists under `docs/mockups/<screen>/`.\n\n## propose\n\n```bash\nnpx -y @greenharness/greenrack-cli@^7.0.0 mockup seed --out docs/mockups/<screen> --name Main # direction A\nnpx -y @greenharness/greenrack-cli@^7.0.0 mockup seed --out docs/mockups/<screen> --name <Direction> # B, C, \u2026\n```\n\n- `<screen>` is kebab-case (`approval-gates`). Artboards are committed with\n the PR \u2014 never leave them in a scratch directory; a session scratchpad is\n garbage-collected and the canvas URL would be the only surviving artefact.\n- Author each artboard inside the seeded `<style>` and root div. Colours,\n spacing, radii, sizes, border widths, type, shadows and motion come only\n from the token block (`var(--gr-size-*)`, `var(--gr-border-*)`);\n positions are yours, and the root keeps the seeded canvas size\n (`var(--gr-mockup-canvas-width)` / `-height`). A custom property you define\n outside the token block holds a token too (`--gap: var(--gr-spacing-md)`);\n `--gap: 12px` is the same raw value one `var()` away. Every button, row, chip, tab,\n input, link, table and dialog \u2014 whatever element it is drawn as \u2014 carries\n `data-gr=\"<Component>\"` or `data-gr=\"<Component>.<Part>\"`, using names\n from `npx -y @greenharness/greenrack-cli@^7.0.0 list components`. Notes for the implementer go after the\n name: `data-gr=\"Button variant=primary\"`.\n- Start from a recipe when one fits the screen shape (`npx -y @greenharness/greenrack-cli@^7.0.0 list recipes`\n \u2014 admin-detail-page, split-pane, page-with-sidenav, settings-page, \u2026) and\n say so in the artboard's header comment; a hand-rolled layout needs a reason.\n- Gate before publishing:\n\n```bash\nnpx -y @greenharness/greenrack-cli@^7.0.0 mockup check docs/mockups/<screen>/*.dc.html\n```\n\n Exit 1 lists `file:line rule: message`. Fix every finding; do not publish\n an artboard that fails. A note that `@greenharness/greenrack-ui` differs from the\n checker means an `unknown-component` may only be newer than the checker:\n rerun with the version the note names before changing the artboard.\n- Build the review page, one self-contained file with every direction under a\n letter (it refuses while any artboard fails the check):\n\n```bash\nnpx -y @greenharness/greenrack-cli@^7.0.0 mockup canvas docs/mockups/<screen>\n```\n\n Publish `docs/mockups/<screen>/canvas.html` as the Artifact (the\n `greenrack_mockup_canvas` MCP tool returns the same page from the artboards'\n HTML). Where Artifacts are unavailable, open it locally in the browser and\n say so; the pick does not wait on publishing.\n- Ask the user to pick a direction. Record the answer as\n `<canvas URL> \u00B7 direction <X>` \u2014 it goes in the PR.\n- Delete the directions that were not picked, rebuild the canvas, and commit\n the picked artboards: the files in `docs/mockups/` are the contract, the\n canvas is the review surface.\n\n## implement\n\n- Read the picked artboard. Its `data-gr` attributes ARE the component\n list: for each one, `npx -y @greenharness/greenrack-cli@^7.0.0 <Component>` (or the `greenrack_lookup` MCP\n tool) gives props and usage. Do not substitute a hand-rolled element for a\n named component; if a named component does not fit, say so and propose the\n design-system change rather than working around it.\n- Tokens map one to one: `var(--gr-spacing-md)` is `spacing.md` from\n `@greenharness/greenrack-tokens/tokens/spacing.css`, `--gr-color-bg-card` is\n `colors.bgCard`, `--gr-radius-sm` is `radii.sm`, `--gr-typography-*`\n and `--gr-type-scale-*` are `typography`/`typeScale`, `--gr-shadow-*`\n is `shadows`, `--gr-duration-*`/`--gr-easing-*` are `duration`/`easing`.\n A media query on `768px` is `breakpoints.md` from\n `@greenharness/greenrack-tokens/tokens/breakpoints.css`. The lint config refuses the raw\n value, so write the token the first time.\n- Layout comes from a recipe before a grid: `npx -y @greenharness/greenrack-cli@^7.0.0 <recipe> --source-only`.\n- Positions in the artboard are a sketch: match its hierarchy and states.\n Its sizes are tokens, so they bind like colours do; a size the artboard\n needs and no token has is added to `@greenharness/greenrack-tokens` first.\n\n## prove\n\n- Run the app, load the route in a real browser (Chrome MCP), and take a\n screenshot at the artboard's width (1120px) in the artboard's theme.\n- The PR body carries, under `## Mockup`: the canvas URL and direction, the\n path `docs/mockups/<screen>/`, and the artboard next to the live screenshot.\n A PR that touches no screen writes `Mockup: none` instead. CI checks for\n one or the other.\n- If the screenshot and the artboard disagree on hierarchy or states, that is\n a finding to fix, not a caption to write.\n";
24
+ //# sourceMappingURL=skill-template.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"skill-template.d.ts","sourceRoot":"","sources":["../src/skill-template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,4CAA4C;AAC5C,eAAO,MAAM,SAAS,oCAAoC,CAAA;AAC1D,eAAO,MAAM,UAAU,6CAA0B,CAAA;AACjD,6EAA6E;AAC7E,eAAO,MAAM,gBAAgB,sCAAsC,CAAA;AAEnE;;;;;GAKG;AACH,eAAO,MAAM,aAAa,UAAU,CAAA;AAIpC,eAAO,MAAM,KAAK,2wNAmHjB,CAAA"}
@@ -0,0 +1,140 @@
1
+ /**
2
+ * The generated Claude Code skill that runs a screen from mockup to PR
3
+ * without leaving the design system.
4
+ *
5
+ * Kept as data (not prose in a README) so `greenrack skill install` can write it
6
+ * and `greenrack skill install --check` can byte-compare it: every consuming repo
7
+ * runs the same workflow, and a change to it is a regenerate rather than
8
+ * N hand-edits. Repo-specific notes go in SKILL_NOTES_PATH, which the skill
9
+ * tells the agent to read and which regeneration never touches.
10
+ */
11
+ /** Repo-relative paths the install owns. */
12
+ export const SKILL_DIR = '.claude/skills/greenrack-mockup';
13
+ export const SKILL_PATH = `${SKILL_DIR}/SKILL.md`;
14
+ /** Repo-specific caveats, read by the skill and never touched by install. */
15
+ export const SKILL_NOTES_PATH = '.claude/greenrack-mockup.local.md';
16
+ /**
17
+ * Floor for the npx pin inside the skill. `greenrack mockup` landed in 3.0.0; it
18
+ * moves with the hook's floor to the release's own major (6.0.0), so a 6.x
19
+ * consumer runs a 6.x CLI. A floating pin keeps patch releases from showing
20
+ * up as --check drift.
21
+ */
22
+ export const SKILL_MIN_CLI = '7.0.0';
23
+ const CLI = `npx -y @greenharness/greenrack-cli@^${SKILL_MIN_CLI}`;
24
+ export const SKILL = `---
25
+ name: greenrack-mockup
26
+ description: Take a new screen from mockup directions to an implemented, verified PR without leaving the greenrack design system. Use whenever the user asks for a screen, a page, a UI proposal, mockups, or "show me options" in a repo that consumes @greenharness/greenrack-ui — and when planning (plan mode) a new screen or a material layout, hierarchy or interaction change there.
27
+ ---
28
+
29
+ **Gate.** This skill applies only in a repository whose \`package.json\` depends on \`@greenharness/greenrack-ui\`, or on the old \`@duro-app/ui\` it replaces (a \`workspace:\` dependency counts). Anywhere else, stop: do not apply it.
30
+
31
+ # greenrack-mockup
32
+
33
+ GENERATED by \`greenrack skill install\` — do not hand-edit. Regenerate:
34
+ \`${CLI} skill install\` (\`--check\` verifies it in CI). Repo-specific notes
35
+ live in \`${SKILL_NOTES_PATH}\`; read it if it exists.
36
+
37
+ Standing rule (fleet decision \`ui.mockup-handoff\`): a mockup is written in
38
+ the design system's own vocabulary, and the direction the user picks is a
39
+ contract. What binds: layout, hierarchy, states, the \`data-gr\` component
40
+ map and the token names, sizes and border widths included (ADR-0027). What
41
+ does not bind: positions (top, left, inset, transform).
42
+
43
+ **This overrides the \`design\` skill's step 0.** That skill says to lift
44
+ resolved values from the real stylesheets. Here you never write a resolved
45
+ value: every colour, spacing, radius, font, shadow and duration is a
46
+ \`var(--gr-*)\` from the seeded token block, and every element a person can
47
+ act on carries \`data-gr="<Component>"\`. Everything this workflow needs ships
48
+ with the CLI: \`mockup seed\` writes the artboard, \`mockup check\` gates it and
49
+ \`mockup canvas\` builds the page the person picks from.
50
+
51
+ ## Args
52
+
53
+ - \`propose <screen>\` — seed 2–4 direction artboards, check them, publish the canvas.
54
+ - \`implement <screen> <direction>\` — build the picked direction from its component map.
55
+ - \`prove <route>\` — screenshot the built route and assemble the PR section.
56
+ - no args — infer the stage from what exists under \`docs/mockups/<screen>/\`.
57
+
58
+ ## propose
59
+
60
+ \`\`\`bash
61
+ ${CLI} mockup seed --out docs/mockups/<screen> --name Main # direction A
62
+ ${CLI} mockup seed --out docs/mockups/<screen> --name <Direction> # B, C, …
63
+ \`\`\`
64
+
65
+ - \`<screen>\` is kebab-case (\`approval-gates\`). Artboards are committed with
66
+ the PR — never leave them in a scratch directory; a session scratchpad is
67
+ garbage-collected and the canvas URL would be the only surviving artefact.
68
+ - Author each artboard inside the seeded \`<style>\` and root div. Colours,
69
+ spacing, radii, sizes, border widths, type, shadows and motion come only
70
+ from the token block (\`var(--gr-size-*)\`, \`var(--gr-border-*)\`);
71
+ positions are yours, and the root keeps the seeded canvas size
72
+ (\`var(--gr-mockup-canvas-width)\` / \`-height\`). A custom property you define
73
+ outside the token block holds a token too (\`--gap: var(--gr-spacing-md)\`);
74
+ \`--gap: 12px\` is the same raw value one \`var()\` away. Every button, row, chip, tab,
75
+ input, link, table and dialog — whatever element it is drawn as — carries
76
+ \`data-gr="<Component>"\` or \`data-gr="<Component>.<Part>"\`, using names
77
+ from \`${CLI} list components\`. Notes for the implementer go after the
78
+ name: \`data-gr="Button variant=primary"\`.
79
+ - Start from a recipe when one fits the screen shape (\`${CLI} list recipes\`
80
+ — admin-detail-page, split-pane, page-with-sidenav, settings-page, …) and
81
+ say so in the artboard's header comment; a hand-rolled layout needs a reason.
82
+ - Gate before publishing:
83
+
84
+ \`\`\`bash
85
+ ${CLI} mockup check docs/mockups/<screen>/*.dc.html
86
+ \`\`\`
87
+
88
+ Exit 1 lists \`file:line rule: message\`. Fix every finding; do not publish
89
+ an artboard that fails. A note that \`@greenharness/greenrack-ui\` differs from the
90
+ checker means an \`unknown-component\` may only be newer than the checker:
91
+ rerun with the version the note names before changing the artboard.
92
+ - Build the review page, one self-contained file with every direction under a
93
+ letter (it refuses while any artboard fails the check):
94
+
95
+ \`\`\`bash
96
+ ${CLI} mockup canvas docs/mockups/<screen>
97
+ \`\`\`
98
+
99
+ Publish \`docs/mockups/<screen>/canvas.html\` as the Artifact (the
100
+ \`greenrack_mockup_canvas\` MCP tool returns the same page from the artboards'
101
+ HTML). Where Artifacts are unavailable, open it locally in the browser and
102
+ say so; the pick does not wait on publishing.
103
+ - Ask the user to pick a direction. Record the answer as
104
+ \`<canvas URL> · direction <X>\` — it goes in the PR.
105
+ - Delete the directions that were not picked, rebuild the canvas, and commit
106
+ the picked artboards: the files in \`docs/mockups/\` are the contract, the
107
+ canvas is the review surface.
108
+
109
+ ## implement
110
+
111
+ - Read the picked artboard. Its \`data-gr\` attributes ARE the component
112
+ list: for each one, \`${CLI} <Component>\` (or the \`greenrack_lookup\` MCP
113
+ tool) gives props and usage. Do not substitute a hand-rolled element for a
114
+ named component; if a named component does not fit, say so and propose the
115
+ design-system change rather than working around it.
116
+ - Tokens map one to one: \`var(--gr-spacing-md)\` is \`spacing.md\` from
117
+ \`@greenharness/greenrack-tokens/tokens/spacing.css\`, \`--gr-color-bg-card\` is
118
+ \`colors.bgCard\`, \`--gr-radius-sm\` is \`radii.sm\`, \`--gr-typography-*\`
119
+ and \`--gr-type-scale-*\` are \`typography\`/\`typeScale\`, \`--gr-shadow-*\`
120
+ is \`shadows\`, \`--gr-duration-*\`/\`--gr-easing-*\` are \`duration\`/\`easing\`.
121
+ A media query on \`768px\` is \`breakpoints.md\` from
122
+ \`@greenharness/greenrack-tokens/tokens/breakpoints.css\`. The lint config refuses the raw
123
+ value, so write the token the first time.
124
+ - Layout comes from a recipe before a grid: \`${CLI} <recipe> --source-only\`.
125
+ - Positions in the artboard are a sketch: match its hierarchy and states.
126
+ Its sizes are tokens, so they bind like colours do; a size the artboard
127
+ needs and no token has is added to \`@greenharness/greenrack-tokens\` first.
128
+
129
+ ## prove
130
+
131
+ - Run the app, load the route in a real browser (Chrome MCP), and take a
132
+ screenshot at the artboard's width (1120px) in the artboard's theme.
133
+ - The PR body carries, under \`## Mockup\`: the canvas URL and direction, the
134
+ path \`docs/mockups/<screen>/\`, and the artboard next to the live screenshot.
135
+ A PR that touches no screen writes \`Mockup: none\` instead. CI checks for
136
+ one or the other.
137
+ - If the screenshot and the artboard disagree on hierarchy or states, that is
138
+ a finding to fix, not a caption to write.
139
+ `;
140
+ //# sourceMappingURL=skill-template.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"skill-template.js","sourceRoot":"","sources":["../src/skill-template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,4CAA4C;AAC5C,MAAM,CAAC,MAAM,SAAS,GAAG,iCAAiC,CAAA;AAC1D,MAAM,CAAC,MAAM,UAAU,GAAG,GAAG,SAAS,WAAW,CAAA;AACjD,6EAA6E;AAC7E,MAAM,CAAC,MAAM,gBAAgB,GAAG,mCAAmC,CAAA;AAEnE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,OAAO,CAAA;AAEpC,MAAM,GAAG,GAAG,uCAAuC,aAAa,EAAE,CAAA;AAElE,MAAM,CAAC,MAAM,KAAK,GAAG;;;;;;;;;;IAUjB,GAAG;YACK,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;EA0B1B,GAAG;EACH,GAAG;;;;;;;;;;;;;;;WAeM,GAAG;;0DAE4C,GAAG;;;;;;EAM3D,GAAG;;;;;;;;;;;EAWH,GAAG;;;;;;;;;;;;;;;;0BAgBqB,GAAG;;;;;;;;;;;;gDAYmB,GAAG;;;;;;;;;;;;;;;CAelD,CAAA"}
@@ -0,0 +1,38 @@
1
+ # The greenrack design system as the `design` Green Harness extension (ADR-0048).
2
+ # grh manifest v1: docs/extension-manifest.md in the grh repository.
3
+ # `version` is written from the git tag by the release, beside package.json's.
4
+
5
+ [extension]
6
+ name = "design"
7
+ version = "7.0.1"
8
+ harness = ">=0.1"
9
+
10
+ [[skill]]
11
+ path = "skills/colors"
12
+
13
+ [[skill]]
14
+ path = "skills/typography"
15
+
16
+ [[skill]]
17
+ path = "skills/ui"
18
+
19
+ [[skill]]
20
+ path = "skills/greenrack-mockup"
21
+
22
+ [[agent]]
23
+ path = "agents/design-system-lookup.md"
24
+
25
+ [[mcp]]
26
+ name = "greenrack"
27
+ command = "npx"
28
+ args = ["-y", "-p", "@greenharness/greenrack-cli@^7", "-p", "@modelcontextprotocol/sdk", "greenrack", "mcp"]
29
+
30
+ # Quiet outside a greenrack consumer (on @greenharness/greenrack-* or, until
31
+ # the census, the old @duro-app/*); quiet too when a hook install (greenrack's,
32
+ # or the old duro one) already wired the catalog hook, so a session never gets
33
+ # the catalog twice.
34
+ [[session_context]]
35
+ command = "sh -c '[ -n \"$(find . -maxdepth 3 -name package.json -not -path \"*/node_modules/*\" -exec grep -l -e \"@greenharness/greenrack-\" -e \"@duro-app/\" {} + 2>/dev/null)\" ] || exit 0; [ -e .claude/hooks/greenrack-catalog.sh ] && exit 0; [ -e .claude/hooks/duro-catalog.sh ] && exit 0; exec npx -y @greenharness/greenrack-cli@^7 context'"
36
+
37
+ [[doctor]]
38
+ command = "sh -c '[ -n \"$(find . -maxdepth 3 -name package.json -not -path \"*/node_modules/*\" -exec grep -l -e \"@greenharness/greenrack-\" -e \"@duro-app/\" {} + 2>/dev/null)\" ] || exit 0; exec npx -y @greenharness/greenrack-cli@^7 doctor'"
package/package.json CHANGED
@@ -1,6 +1,79 @@
1
1
  {
2
2
  "name": "@greenharness/greenrack-cli",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
3
+ "version": "7.0.1",
4
+ "type": "module",
5
+ "license": "MIT",
6
+ "description": "Machine-queryable docs for the greenrack design system: components, props, recipes, tokens and rules as CLI output, JSON, or an MCP server.",
7
+ "keywords": [
8
+ "cli",
9
+ "design-system",
10
+ "documentation",
11
+ "mcp",
12
+ "react-strict-dom"
13
+ ],
14
+ "repository": {
15
+ "type": "git",
16
+ "url": "https://github.com/greenharness/greenrack",
17
+ "directory": "packages/cli"
18
+ },
19
+ "homepage": "https://github.com/greenharness/greenrack",
20
+ "bugs": {
21
+ "url": "https://github.com/greenharness/greenrack/issues"
22
+ },
23
+ "publishConfig": {
24
+ "access": "public"
25
+ },
26
+ "bin": {
27
+ "greenrack": "./dist/bin.js"
28
+ },
29
+ "main": "./dist/index.js",
30
+ "types": "./dist/index.d.ts",
31
+ "exports": {
32
+ ".": {
33
+ "types": "./dist/index.d.ts",
34
+ "import": "./dist/index.js",
35
+ "default": "./dist/index.js"
36
+ },
37
+ "./registry.json": "./registry.json"
38
+ },
39
+ "files": [
40
+ "dist",
41
+ "skills",
42
+ "agents",
43
+ "greenharness.toml",
44
+ "registry.json"
45
+ ],
46
+ "engines": {
47
+ "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
48
+ },
49
+ "dependencies": {
50
+ "@greenharness/greenrack-tokens": "^7.0.1"
51
+ },
52
+ "peerDependencies": {
53
+ "@modelcontextprotocol/sdk": ">=1.0.0",
54
+ "@greenharness/greenrack-ui": "^7.0.1"
55
+ },
56
+ "peerDependenciesMeta": {
57
+ "@greenharness/greenrack-ui": {
58
+ "optional": true
59
+ },
60
+ "@modelcontextprotocol/sdk": {
61
+ "optional": true
62
+ }
63
+ },
64
+ "devDependencies": {
65
+ "@modelcontextprotocol/sdk": "^1.12.0",
66
+ "@types/node": "^24.0.0",
67
+ "ts-morph": "^26.0.0",
68
+ "typescript": "^5.7.0",
69
+ "@greenharness/greenrack-eslint-plugin": "^7.0.1",
70
+ "@greenharness/greenrack-ui": "^7.0.1"
71
+ },
72
+ "scripts": {
73
+ "registry": "node scripts/build-registry.mjs",
74
+ "prebuild": "pnpm --filter @greenharness/greenrack-tokens run build && node scripts/build-registry.mjs --check",
75
+ "build": "tsc -p tsconfig.build.json",
76
+ "typecheck": "tsc --noEmit",
77
+ "skill:generate": "pnpm run build && node scripts/generate-mockup-skill.mjs"
78
+ }
6
79
  }