@agent-native/core 0.182.0 → 0.182.1-nightly-20260916195744

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 (60) hide show
  1. package/corpus/README.md +1 -1
  2. package/corpus/templates/analytics/.agents/skills/shadcn-ui/SKILL.md +65 -6
  3. package/corpus/templates/analytics/.mcp.json +8 -0
  4. package/corpus/templates/assets/.agents/skills/shadcn-ui/SKILL.md +65 -6
  5. package/corpus/templates/assets/.mcp.json +8 -0
  6. package/corpus/templates/brain/.agents/skills/shadcn-ui/SKILL.md +65 -6
  7. package/corpus/templates/brain/.mcp.json +8 -0
  8. package/corpus/templates/calendar/.agents/skills/shadcn-ui/SKILL.md +65 -6
  9. package/corpus/templates/calendar/.mcp.json +8 -0
  10. package/corpus/templates/chat/.agents/skills/shadcn-ui/SKILL.md +65 -6
  11. package/corpus/templates/chat/.mcp.json +8 -0
  12. package/corpus/templates/clips/.agents/skills/shadcn-ui/SKILL.md +65 -6
  13. package/corpus/templates/clips/.mcp.json +8 -0
  14. package/corpus/templates/clips/desktop/.mcp.json +8 -0
  15. package/corpus/templates/content/.agents/skills/shadcn-ui/SKILL.md +65 -6
  16. package/corpus/templates/content/.mcp.json +8 -0
  17. package/corpus/templates/crm/.agents/skills/shadcn-ui/SKILL.md +65 -6
  18. package/corpus/templates/crm/.mcp.json +8 -0
  19. package/corpus/templates/design/.agents/skills/shadcn-ui/SKILL.md +65 -6
  20. package/corpus/templates/design/.mcp.json +8 -0
  21. package/corpus/templates/dispatch/.agents/skills/shadcn-ui/SKILL.md +65 -6
  22. package/corpus/templates/dispatch/.mcp.json +8 -0
  23. package/corpus/templates/factory/.agents/skills/shadcn-ui/SKILL.md +65 -6
  24. package/corpus/templates/factory/.mcp.json +8 -0
  25. package/corpus/templates/forms/.agents/skills/shadcn-ui/SKILL.md +65 -6
  26. package/corpus/templates/forms/.mcp.json +8 -0
  27. package/corpus/templates/mail/.agents/skills/shadcn-ui/SKILL.md +65 -6
  28. package/corpus/templates/mail/.mcp.json +8 -0
  29. package/corpus/templates/plan/.agents/skills/shadcn-ui/SKILL.md +65 -6
  30. package/corpus/templates/plan/.mcp.json +8 -0
  31. package/corpus/templates/slides/.agents/skills/shadcn-ui/SKILL.md +65 -6
  32. package/corpus/templates/slides/.mcp.json +8 -0
  33. package/corpus/templates/tasks/.agents/skills/shadcn-ui/SKILL.md +65 -6
  34. package/corpus/templates/tasks/.mcp.json +8 -0
  35. package/dist/collab/routes.d.ts +1 -1
  36. package/dist/collab/struct-routes.d.ts +1 -1
  37. package/dist/mcp/screen-memory-stdio.d.ts +7 -7
  38. package/dist/notifications/routes.d.ts +4 -4
  39. package/dist/observability/routes.d.ts +8 -8
  40. package/dist/org/handlers.d.ts +1 -1
  41. package/dist/progress/routes.d.ts +1 -1
  42. package/dist/provider-api/actions/provider-api.d.ts +4 -4
  43. package/dist/resources/handlers.d.ts +1 -1
  44. package/dist/server/agent-engine-api-key-route.d.ts +1 -1
  45. package/dist/server/core-routes-plugin.d.ts +1 -1
  46. package/dist/templates/chat/.agents/skills/shadcn-ui/SKILL.md +65 -6
  47. package/dist/templates/chat/.mcp.json +8 -0
  48. package/dist/templates/default/.agents/skills/shadcn-ui/SKILL.md +65 -6
  49. package/dist/templates/default/.mcp.json +8 -0
  50. package/dist/templates/workspace-core/.agents/skills/shadcn-ui/SKILL.md +65 -6
  51. package/dist/templates/workspace-root/package.json +1 -1
  52. package/dist/templates/workspace-root/pnpm-workspace.yaml +18 -0
  53. package/package.json +1 -1
  54. package/src/templates/chat/.agents/skills/shadcn-ui/SKILL.md +65 -6
  55. package/src/templates/chat/.mcp.json +8 -0
  56. package/src/templates/default/.agents/skills/shadcn-ui/SKILL.md +65 -6
  57. package/src/templates/default/.mcp.json +8 -0
  58. package/src/templates/workspace-core/.agents/skills/shadcn-ui/SKILL.md +65 -6
  59. package/src/templates/workspace-root/package.json +1 -1
  60. package/src/templates/workspace-root/pnpm-workspace.yaml +18 -0
@@ -1,10 +1,9 @@
1
1
  ---
2
2
  name: shadcn-ui
3
3
  description: >-
4
- The shadcn CLI, component composition, theming, and registry workflow. Use
5
- when adding, replacing, upgrading, or debugging a shadcn/ui primitive itself,
6
- or when changing a theme or registry. Do not load it for ordinary edits to a
7
- file that happens to import a shadcn component.
4
+ Project-aware shadcn/ui components, registry MCP, theming, and design-system
5
+ lint feedback. Use when adding or changing React/Tailwind UI, a primitive,
6
+ theme, registry, or component contract in an Agent-Native app.
8
7
  scope: dev
9
8
  source: https://ui.shadcn.com/docs/skills
10
9
  local-changes: >-
@@ -16,11 +15,18 @@ metadata:
16
15
 
17
16
  # shadcn/ui
18
17
 
19
- This skill keeps shadcn/ui work project-aware. Components are source files in the app, so always inspect the local project before adding, importing, or rewriting them.
18
+ This skill keeps shadcn/ui work project-aware. Components are source files in the
19
+ app, so always inspect the local project before adding, importing, or rewriting
20
+ them. When `@shadcn/lint` is configured, treat its feedback as implementation
21
+ guidance, not cosmetic noise. The framework repository runs it through the root
22
+ Oxlint configuration; generated workspaces carry this skill and the MCP
23
+ workflow, but do not automatically inherit that repository-only lint setup.
20
24
 
21
25
  ## First Steps
22
26
 
23
- 1. Work from the app root that owns `components.json`.
27
+ 1. Work from the app root that owns `components.json`. In this monorepo, that is
28
+ the selected app/template directory (usually under `templates/`), not the
29
+ repository root.
24
30
  2. In an Agent-Native app, inspect `app/design-system.ts` and
25
31
  `ToolkitProvider` before choosing a primitive. A registered company design
26
32
  system takes precedence over the default shadcn adapter.
@@ -29,6 +35,59 @@ This skill keeps shadcn/ui work project-aware. Components are source files in th
29
35
  5. Check `app/components/ui/` or the resolved `ui` path before importing a component.
30
36
  6. For unfamiliar components, run `pnpm dlx shadcn@latest docs <component>` and read the returned docs or examples before coding.
31
37
 
38
+ ## MCP Registry Workflow
39
+
40
+ Each first-party app keeps the official shadcn MCP configuration in `.mcp.json`
41
+ next to its `components.json`. Start the agent from that app root so the MCP
42
+ server resolves the correct aliases, local UI directory, and Tailwind theme.
43
+ Do not add a single repository-root server: the root is a workspace, not a
44
+ shadcn project, and would make installs target the wrong project.
45
+
46
+ - Use the shadcn MCP to search, inspect, and install registry items when it is
47
+ connected. Prefer the app's configured registries over copied source.
48
+ - Use `pnpm dlx shadcn@latest info --json` for project context; the MCP has no
49
+ equivalent project-info tool.
50
+ - If the MCP is unavailable, use the equivalent `pnpm dlx shadcn@latest`
51
+ command from the same app root and continue following this skill.
52
+ - Keep registry URLs and aliases in that app's `components.json`. Never put
53
+ registry credentials in MCP config or checked-in source.
54
+
55
+ ## Design-System Lint Feedback
56
+
57
+ In the framework repository, `pnpm lint` runs Oxlint with `@shadcn/lint` for the
58
+ scoped template UI paths. Run it after UI changes and fix every `shadcn/*`
59
+ finding before handing off. Template packages use the workspace lint
60
+ configuration; do not create a second local lint configuration just for one
61
+ app.
62
+
63
+ Before claiming that shadcn lint ran in another workspace, inspect its root
64
+ `package.json` and `.oxlintrc.json`. The generic generated workspace currently
65
+ exposes `pnpm lint` as formatting-only and does not ship `@shadcn/lint` or the
66
+ framework repository's Oxlint config. In that scaffold, use this skill plus the
67
+ connected shadcn MCP (or the CLI fallback) for design-system guidance, and do
68
+ not report `shadcn/*` checks as having run. If the workspace owner adopts the
69
+ linter, add the dependency, scoped config, and lint script together.
70
+
71
+ The Plan template is intentionally excluded from this rollout. Its files remain
72
+ under `templates/plan/**`, but the root Oxlint ignore list keeps them out of the
73
+ shadcn checks until that template has a separate lint baseline.
74
+
75
+ - `no-restyle`: use the component's `variant`, `size`, and semantic props; put
76
+ layout on a parent and add a component variant only when the design system
77
+ genuinely needs a new treatment.
78
+ - `no-raw-colors`: use the theme tokens in the app's `global.css`, not raw
79
+ Tailwind palette classes or hard-coded color attributes.
80
+ - `no-arbitrary-values`: use the theme scale or a declared token instead of
81
+ one-off bracket values.
82
+ - `no-inline-styles`: use classes or CSS custom properties for dynamic layout;
83
+ keep intentional editor/export exceptions scoped to their owning subsystem.
84
+ - `no-unknown-classes` and `require-static-classes`: use classes Tailwind can
85
+ generate and keep class strings statically discoverable.
86
+
87
+ The local primitive source is the contract boundary. Product code should consume
88
+ its props and variants; update `packages/toolkit/src/ui/` or an app's
89
+ `components/ui/` only when the design-system contract itself changes.
90
+
32
91
  ## Agent-Native Adapter Rule
33
92
 
34
93
  Pages, routes, and domain components import controls through the app's local UI
@@ -0,0 +1,8 @@
1
+ {
2
+ "mcpServers": {
3
+ "shadcn": {
4
+ "command": "npx",
5
+ "args": ["shadcn@latest", "mcp"]
6
+ }
7
+ }
8
+ }
@@ -1,10 +1,9 @@
1
1
  ---
2
2
  name: shadcn-ui
3
3
  description: >-
4
- The shadcn CLI, component composition, theming, and registry workflow. Use
5
- when adding, replacing, upgrading, or debugging a shadcn/ui primitive itself,
6
- or when changing a theme or registry. Do not load it for ordinary edits to a
7
- file that happens to import a shadcn component.
4
+ Project-aware shadcn/ui components, registry MCP, theming, and design-system
5
+ lint feedback. Use when adding or changing React/Tailwind UI, a primitive,
6
+ theme, registry, or component contract in an Agent-Native app.
8
7
  scope: dev
9
8
  source: https://ui.shadcn.com/docs/skills
10
9
  local-changes: >-
@@ -16,11 +15,18 @@ metadata:
16
15
 
17
16
  # shadcn/ui
18
17
 
19
- This skill keeps shadcn/ui work project-aware. Components are source files in the app, so always inspect the local project before adding, importing, or rewriting them.
18
+ This skill keeps shadcn/ui work project-aware. Components are source files in the
19
+ app, so always inspect the local project before adding, importing, or rewriting
20
+ them. When `@shadcn/lint` is configured, treat its feedback as implementation
21
+ guidance, not cosmetic noise. The framework repository runs it through the root
22
+ Oxlint configuration; generated workspaces carry this skill and the MCP
23
+ workflow, but do not automatically inherit that repository-only lint setup.
20
24
 
21
25
  ## First Steps
22
26
 
23
- 1. Work from the app root that owns `components.json`.
27
+ 1. Work from the app root that owns `components.json`. In this monorepo, that is
28
+ the selected app/template directory (usually under `templates/`), not the
29
+ repository root.
24
30
  2. In an Agent-Native app, inspect `app/design-system.ts` and
25
31
  `ToolkitProvider` before choosing a primitive. A registered company design
26
32
  system takes precedence over the default shadcn adapter.
@@ -29,6 +35,59 @@ This skill keeps shadcn/ui work project-aware. Components are source files in th
29
35
  5. Check `app/components/ui/` or the resolved `ui` path before importing a component.
30
36
  6. For unfamiliar components, run `pnpm dlx shadcn@latest docs <component>` and read the returned docs or examples before coding.
31
37
 
38
+ ## MCP Registry Workflow
39
+
40
+ Each first-party app keeps the official shadcn MCP configuration in `.mcp.json`
41
+ next to its `components.json`. Start the agent from that app root so the MCP
42
+ server resolves the correct aliases, local UI directory, and Tailwind theme.
43
+ Do not add a single repository-root server: the root is a workspace, not a
44
+ shadcn project, and would make installs target the wrong project.
45
+
46
+ - Use the shadcn MCP to search, inspect, and install registry items when it is
47
+ connected. Prefer the app's configured registries over copied source.
48
+ - Use `pnpm dlx shadcn@latest info --json` for project context; the MCP has no
49
+ equivalent project-info tool.
50
+ - If the MCP is unavailable, use the equivalent `pnpm dlx shadcn@latest`
51
+ command from the same app root and continue following this skill.
52
+ - Keep registry URLs and aliases in that app's `components.json`. Never put
53
+ registry credentials in MCP config or checked-in source.
54
+
55
+ ## Design-System Lint Feedback
56
+
57
+ In the framework repository, `pnpm lint` runs Oxlint with `@shadcn/lint` for the
58
+ scoped template UI paths. Run it after UI changes and fix every `shadcn/*`
59
+ finding before handing off. Template packages use the workspace lint
60
+ configuration; do not create a second local lint configuration just for one
61
+ app.
62
+
63
+ Before claiming that shadcn lint ran in another workspace, inspect its root
64
+ `package.json` and `.oxlintrc.json`. The generic generated workspace currently
65
+ exposes `pnpm lint` as formatting-only and does not ship `@shadcn/lint` or the
66
+ framework repository's Oxlint config. In that scaffold, use this skill plus the
67
+ connected shadcn MCP (or the CLI fallback) for design-system guidance, and do
68
+ not report `shadcn/*` checks as having run. If the workspace owner adopts the
69
+ linter, add the dependency, scoped config, and lint script together.
70
+
71
+ The Plan template is intentionally excluded from this rollout. Its files remain
72
+ under `templates/plan/**`, but the root Oxlint ignore list keeps them out of the
73
+ shadcn checks until that template has a separate lint baseline.
74
+
75
+ - `no-restyle`: use the component's `variant`, `size`, and semantic props; put
76
+ layout on a parent and add a component variant only when the design system
77
+ genuinely needs a new treatment.
78
+ - `no-raw-colors`: use the theme tokens in the app's `global.css`, not raw
79
+ Tailwind palette classes or hard-coded color attributes.
80
+ - `no-arbitrary-values`: use the theme scale or a declared token instead of
81
+ one-off bracket values.
82
+ - `no-inline-styles`: use classes or CSS custom properties for dynamic layout;
83
+ keep intentional editor/export exceptions scoped to their owning subsystem.
84
+ - `no-unknown-classes` and `require-static-classes`: use classes Tailwind can
85
+ generate and keep class strings statically discoverable.
86
+
87
+ The local primitive source is the contract boundary. Product code should consume
88
+ its props and variants; update `packages/toolkit/src/ui/` or an app's
89
+ `components/ui/` only when the design-system contract itself changes.
90
+
32
91
  ## Agent-Native Adapter Rule
33
92
 
34
93
  Pages, routes, and domain components import controls through the app's local UI
@@ -0,0 +1,8 @@
1
+ {
2
+ "mcpServers": {
3
+ "shadcn": {
4
+ "command": "npx",
5
+ "args": ["shadcn@latest", "mcp"]
6
+ }
7
+ }
8
+ }
@@ -1,10 +1,9 @@
1
1
  ---
2
2
  name: shadcn-ui
3
3
  description: >-
4
- The shadcn CLI, component composition, theming, and registry workflow. Use
5
- when adding, replacing, upgrading, or debugging a shadcn/ui primitive itself,
6
- or when changing a theme or registry. Do not load it for ordinary edits to a
7
- file that happens to import a shadcn component.
4
+ Project-aware shadcn/ui components, registry MCP, theming, and design-system
5
+ lint feedback. Use when adding or changing React/Tailwind UI, a primitive,
6
+ theme, registry, or component contract in an Agent-Native app.
8
7
  scope: dev
9
8
  source: https://ui.shadcn.com/docs/skills
10
9
  local-changes: >-
@@ -16,11 +15,18 @@ metadata:
16
15
 
17
16
  # shadcn/ui
18
17
 
19
- This skill keeps shadcn/ui work project-aware. Components are source files in the app, so always inspect the local project before adding, importing, or rewriting them.
18
+ This skill keeps shadcn/ui work project-aware. Components are source files in the
19
+ app, so always inspect the local project before adding, importing, or rewriting
20
+ them. When `@shadcn/lint` is configured, treat its feedback as implementation
21
+ guidance, not cosmetic noise. The framework repository runs it through the root
22
+ Oxlint configuration; generated workspaces carry this skill and the MCP
23
+ workflow, but do not automatically inherit that repository-only lint setup.
20
24
 
21
25
  ## First Steps
22
26
 
23
- 1. Work from the app root that owns `components.json`.
27
+ 1. Work from the app root that owns `components.json`. In this monorepo, that is
28
+ the selected app/template directory (usually under `templates/`), not the
29
+ repository root.
24
30
  2. In an Agent-Native app, inspect `app/design-system.ts` and
25
31
  `ToolkitProvider` before choosing a primitive. A registered company design
26
32
  system takes precedence over the default shadcn adapter.
@@ -29,6 +35,59 @@ This skill keeps shadcn/ui work project-aware. Components are source files in th
29
35
  5. Check `app/components/ui/` or the resolved `ui` path before importing a component.
30
36
  6. For unfamiliar components, run `pnpm dlx shadcn@latest docs <component>` and read the returned docs or examples before coding.
31
37
 
38
+ ## MCP Registry Workflow
39
+
40
+ Each first-party app keeps the official shadcn MCP configuration in `.mcp.json`
41
+ next to its `components.json`. Start the agent from that app root so the MCP
42
+ server resolves the correct aliases, local UI directory, and Tailwind theme.
43
+ Do not add a single repository-root server: the root is a workspace, not a
44
+ shadcn project, and would make installs target the wrong project.
45
+
46
+ - Use the shadcn MCP to search, inspect, and install registry items when it is
47
+ connected. Prefer the app's configured registries over copied source.
48
+ - Use `pnpm dlx shadcn@latest info --json` for project context; the MCP has no
49
+ equivalent project-info tool.
50
+ - If the MCP is unavailable, use the equivalent `pnpm dlx shadcn@latest`
51
+ command from the same app root and continue following this skill.
52
+ - Keep registry URLs and aliases in that app's `components.json`. Never put
53
+ registry credentials in MCP config or checked-in source.
54
+
55
+ ## Design-System Lint Feedback
56
+
57
+ In the framework repository, `pnpm lint` runs Oxlint with `@shadcn/lint` for the
58
+ scoped template UI paths. Run it after UI changes and fix every `shadcn/*`
59
+ finding before handing off. Template packages use the workspace lint
60
+ configuration; do not create a second local lint configuration just for one
61
+ app.
62
+
63
+ Before claiming that shadcn lint ran in another workspace, inspect its root
64
+ `package.json` and `.oxlintrc.json`. The generic generated workspace currently
65
+ exposes `pnpm lint` as formatting-only and does not ship `@shadcn/lint` or the
66
+ framework repository's Oxlint config. In that scaffold, use this skill plus the
67
+ connected shadcn MCP (or the CLI fallback) for design-system guidance, and do
68
+ not report `shadcn/*` checks as having run. If the workspace owner adopts the
69
+ linter, add the dependency, scoped config, and lint script together.
70
+
71
+ The Plan template is intentionally excluded from this rollout. Its files remain
72
+ under `templates/plan/**`, but the root Oxlint ignore list keeps them out of the
73
+ shadcn checks until that template has a separate lint baseline.
74
+
75
+ - `no-restyle`: use the component's `variant`, `size`, and semantic props; put
76
+ layout on a parent and add a component variant only when the design system
77
+ genuinely needs a new treatment.
78
+ - `no-raw-colors`: use the theme tokens in the app's `global.css`, not raw
79
+ Tailwind palette classes or hard-coded color attributes.
80
+ - `no-arbitrary-values`: use the theme scale or a declared token instead of
81
+ one-off bracket values.
82
+ - `no-inline-styles`: use classes or CSS custom properties for dynamic layout;
83
+ keep intentional editor/export exceptions scoped to their owning subsystem.
84
+ - `no-unknown-classes` and `require-static-classes`: use classes Tailwind can
85
+ generate and keep class strings statically discoverable.
86
+
87
+ The local primitive source is the contract boundary. Product code should consume
88
+ its props and variants; update `packages/toolkit/src/ui/` or an app's
89
+ `components/ui/` only when the design-system contract itself changes.
90
+
32
91
  ## Agent-Native Adapter Rule
33
92
 
34
93
  Pages, routes, and domain components import controls through the app's local UI
@@ -0,0 +1,8 @@
1
+ {
2
+ "mcpServers": {
3
+ "shadcn": {
4
+ "command": "npx",
5
+ "args": ["shadcn@latest", "mcp"]
6
+ }
7
+ }
8
+ }
@@ -1,10 +1,9 @@
1
1
  ---
2
2
  name: shadcn-ui
3
3
  description: >-
4
- The shadcn CLI, component composition, theming, and registry workflow. Use
5
- when adding, replacing, upgrading, or debugging a shadcn/ui primitive itself,
6
- or when changing a theme or registry. Do not load it for ordinary edits to a
7
- file that happens to import a shadcn component.
4
+ Project-aware shadcn/ui components, registry MCP, theming, and design-system
5
+ lint feedback. Use when adding or changing React/Tailwind UI, a primitive,
6
+ theme, registry, or component contract in an Agent-Native app.
8
7
  scope: dev
9
8
  source: https://ui.shadcn.com/docs/skills
10
9
  local-changes: >-
@@ -16,11 +15,18 @@ metadata:
16
15
 
17
16
  # shadcn/ui
18
17
 
19
- This skill keeps shadcn/ui work project-aware. Components are source files in the app, so always inspect the local project before adding, importing, or rewriting them.
18
+ This skill keeps shadcn/ui work project-aware. Components are source files in the
19
+ app, so always inspect the local project before adding, importing, or rewriting
20
+ them. When `@shadcn/lint` is configured, treat its feedback as implementation
21
+ guidance, not cosmetic noise. The framework repository runs it through the root
22
+ Oxlint configuration; generated workspaces carry this skill and the MCP
23
+ workflow, but do not automatically inherit that repository-only lint setup.
20
24
 
21
25
  ## First Steps
22
26
 
23
- 1. Work from the app root that owns `components.json`.
27
+ 1. Work from the app root that owns `components.json`. In this monorepo, that is
28
+ the selected app/template directory (usually under `templates/`), not the
29
+ repository root.
24
30
  2. In an Agent-Native app, inspect `app/design-system.ts` and
25
31
  `ToolkitProvider` before choosing a primitive. A registered company design
26
32
  system takes precedence over the default shadcn adapter.
@@ -29,6 +35,59 @@ This skill keeps shadcn/ui work project-aware. Components are source files in th
29
35
  5. Check `app/components/ui/` or the resolved `ui` path before importing a component.
30
36
  6. For unfamiliar components, run `pnpm dlx shadcn@latest docs <component>` and read the returned docs or examples before coding.
31
37
 
38
+ ## MCP Registry Workflow
39
+
40
+ Each first-party app keeps the official shadcn MCP configuration in `.mcp.json`
41
+ next to its `components.json`. Start the agent from that app root so the MCP
42
+ server resolves the correct aliases, local UI directory, and Tailwind theme.
43
+ Do not add a single repository-root server: the root is a workspace, not a
44
+ shadcn project, and would make installs target the wrong project.
45
+
46
+ - Use the shadcn MCP to search, inspect, and install registry items when it is
47
+ connected. Prefer the app's configured registries over copied source.
48
+ - Use `pnpm dlx shadcn@latest info --json` for project context; the MCP has no
49
+ equivalent project-info tool.
50
+ - If the MCP is unavailable, use the equivalent `pnpm dlx shadcn@latest`
51
+ command from the same app root and continue following this skill.
52
+ - Keep registry URLs and aliases in that app's `components.json`. Never put
53
+ registry credentials in MCP config or checked-in source.
54
+
55
+ ## Design-System Lint Feedback
56
+
57
+ In the framework repository, `pnpm lint` runs Oxlint with `@shadcn/lint` for the
58
+ scoped template UI paths. Run it after UI changes and fix every `shadcn/*`
59
+ finding before handing off. Template packages use the workspace lint
60
+ configuration; do not create a second local lint configuration just for one
61
+ app.
62
+
63
+ Before claiming that shadcn lint ran in another workspace, inspect its root
64
+ `package.json` and `.oxlintrc.json`. The generic generated workspace currently
65
+ exposes `pnpm lint` as formatting-only and does not ship `@shadcn/lint` or the
66
+ framework repository's Oxlint config. In that scaffold, use this skill plus the
67
+ connected shadcn MCP (or the CLI fallback) for design-system guidance, and do
68
+ not report `shadcn/*` checks as having run. If the workspace owner adopts the
69
+ linter, add the dependency, scoped config, and lint script together.
70
+
71
+ The Plan template is intentionally excluded from this rollout. Its files remain
72
+ under `templates/plan/**`, but the root Oxlint ignore list keeps them out of the
73
+ shadcn checks until that template has a separate lint baseline.
74
+
75
+ - `no-restyle`: use the component's `variant`, `size`, and semantic props; put
76
+ layout on a parent and add a component variant only when the design system
77
+ genuinely needs a new treatment.
78
+ - `no-raw-colors`: use the theme tokens in the app's `global.css`, not raw
79
+ Tailwind palette classes or hard-coded color attributes.
80
+ - `no-arbitrary-values`: use the theme scale or a declared token instead of
81
+ one-off bracket values.
82
+ - `no-inline-styles`: use classes or CSS custom properties for dynamic layout;
83
+ keep intentional editor/export exceptions scoped to their owning subsystem.
84
+ - `no-unknown-classes` and `require-static-classes`: use classes Tailwind can
85
+ generate and keep class strings statically discoverable.
86
+
87
+ The local primitive source is the contract boundary. Product code should consume
88
+ its props and variants; update `packages/toolkit/src/ui/` or an app's
89
+ `components/ui/` only when the design-system contract itself changes.
90
+
32
91
  ## Agent-Native Adapter Rule
33
92
 
34
93
  Pages, routes, and domain components import controls through the app's local UI
@@ -0,0 +1,8 @@
1
+ {
2
+ "mcpServers": {
3
+ "shadcn": {
4
+ "command": "npx",
5
+ "args": ["shadcn@latest", "mcp"]
6
+ }
7
+ }
8
+ }
@@ -26,8 +26,8 @@ export declare const getCollabState: import("h3").EventHandlerWithFetch<import("
26
26
  * Body: { update: string (base64), requestSource?: string }
27
27
  */
28
28
  export declare const postCollabUpdate: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
29
- error: string;
30
29
  ok?: undefined;
30
+ error: string;
31
31
  } | {
32
32
  error?: undefined;
33
33
  ok: boolean;
@@ -13,8 +13,8 @@
13
13
  * Body: { json: any, fieldName?: string, type?: "map"|"array", requestSource?: string }
14
14
  */
15
15
  export declare const postCollabJson: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
16
- ok?: undefined;
17
16
  error: string;
17
+ ok?: undefined;
18
18
  } | {
19
19
  error?: undefined;
20
20
  ok: boolean;
@@ -137,13 +137,13 @@ export declare function screenMemoryMcpToolDefinitions(): ({
137
137
  inputSchema: {
138
138
  type: string;
139
139
  properties: {
140
- count?: undefined;
141
140
  query?: undefined;
142
141
  minutes?: undefined;
143
142
  limit?: undefined;
144
143
  clientHint?: undefined;
145
144
  timestamp?: undefined;
146
145
  chapterId?: undefined;
146
+ count?: undefined;
147
147
  startAt?: undefined;
148
148
  endAt?: undefined;
149
149
  reason?: undefined;
@@ -159,7 +159,6 @@ export declare function screenMemoryMcpToolDefinitions(): ({
159
159
  inputSchema: {
160
160
  type: string;
161
161
  properties: {
162
- count?: undefined;
163
162
  query: {
164
163
  type: string;
165
164
  description: string;
@@ -175,6 +174,7 @@ export declare function screenMemoryMcpToolDefinitions(): ({
175
174
  clientHint?: undefined;
176
175
  timestamp?: undefined;
177
176
  chapterId?: undefined;
177
+ count?: undefined;
178
178
  startAt?: undefined;
179
179
  endAt?: undefined;
180
180
  reason?: undefined;
@@ -190,7 +190,6 @@ export declare function screenMemoryMcpToolDefinitions(): ({
190
190
  inputSchema: {
191
191
  type: string;
192
192
  properties: {
193
- count?: undefined;
194
193
  minutes: {
195
194
  type: string;
196
195
  description: string;
@@ -200,6 +199,7 @@ export declare function screenMemoryMcpToolDefinitions(): ({
200
199
  clientHint?: undefined;
201
200
  timestamp?: undefined;
202
201
  chapterId?: undefined;
202
+ count?: undefined;
203
203
  startAt?: undefined;
204
204
  endAt?: undefined;
205
205
  reason?: undefined;
@@ -216,7 +216,6 @@ export declare function screenMemoryMcpToolDefinitions(): ({
216
216
  type: string;
217
217
  required: string[];
218
218
  properties: {
219
- count?: undefined;
220
219
  query: {
221
220
  type: string;
222
221
  description: string;
@@ -235,6 +234,7 @@ export declare function screenMemoryMcpToolDefinitions(): ({
235
234
  };
236
235
  timestamp?: undefined;
237
236
  chapterId?: undefined;
237
+ count?: undefined;
238
238
  startAt?: undefined;
239
239
  endAt?: undefined;
240
240
  reason?: undefined;
@@ -250,7 +250,6 @@ export declare function screenMemoryMcpToolDefinitions(): ({
250
250
  type: string;
251
251
  required: string[];
252
252
  properties: {
253
- count?: undefined;
254
253
  query?: undefined;
255
254
  minutes?: undefined;
256
255
  limit?: undefined;
@@ -264,6 +263,7 @@ export declare function screenMemoryMcpToolDefinitions(): ({
264
263
  description: string;
265
264
  };
266
265
  chapterId?: undefined;
266
+ count?: undefined;
267
267
  startAt?: undefined;
268
268
  endAt?: undefined;
269
269
  includeMicrophone?: undefined;
@@ -314,13 +314,13 @@ export declare function screenMemoryMcpToolDefinitions(): ({
314
314
  type: string;
315
315
  required: string[];
316
316
  properties: {
317
- count?: undefined;
318
317
  query?: undefined;
319
318
  minutes?: undefined;
320
319
  limit?: undefined;
321
320
  clientHint?: undefined;
322
321
  timestamp?: undefined;
323
322
  chapterId?: undefined;
323
+ count?: undefined;
324
324
  startAt: {
325
325
  type: string;
326
326
  description: string;
@@ -349,13 +349,13 @@ export declare function screenMemoryMcpToolDefinitions(): ({
349
349
  type: string;
350
350
  required: string[];
351
351
  properties: {
352
- count?: undefined;
353
352
  query?: undefined;
354
353
  minutes?: undefined;
355
354
  limit?: undefined;
356
355
  clientHint?: undefined;
357
356
  timestamp?: undefined;
358
357
  chapterId?: undefined;
358
+ count?: undefined;
359
359
  startAt?: undefined;
360
360
  endAt?: undefined;
361
361
  reason?: undefined;
@@ -16,18 +16,18 @@ export declare function createNotificationsHandler(): import("h3").EventHandlerW
16
16
  error?: undefined;
17
17
  ok?: undefined;
18
18
  } | {
19
- count?: undefined;
20
19
  updated: number;
21
20
  error?: undefined;
22
21
  ok?: undefined;
23
- } | {
24
22
  count?: undefined;
23
+ } | {
25
24
  updated?: undefined;
26
25
  error: string;
27
26
  ok?: undefined;
28
- } | {
29
27
  count?: undefined;
28
+ } | {
30
29
  updated?: undefined;
31
- ok: boolean;
32
30
  error?: undefined;
31
+ ok: boolean;
32
+ count?: undefined;
33
33
  }>>;
@@ -41,27 +41,27 @@ export declare function createObservabilityHandler(): import("h3").EventHandlerW
41
41
  thumbsUpRate: number;
42
42
  avgEvalScore: number;
43
43
  } | {
44
- id?: undefined;
44
+ error?: undefined;
45
+ ok?: undefined;
45
46
  summary: import("./types.js").TraceSummary;
46
47
  spans: import("./types.js").TraceSpan[];
48
+ id?: undefined;
49
+ } | {
47
50
  error?: undefined;
48
51
  ok?: undefined;
49
- } | {
50
52
  summary?: undefined;
51
53
  spans?: undefined;
52
54
  id: string;
53
- error?: undefined;
54
- ok?: undefined;
55
55
  } | {
56
- id?: undefined;
56
+ ok?: undefined;
57
57
  summary?: undefined;
58
58
  spans?: undefined;
59
+ id?: undefined;
59
60
  error: any;
60
- ok?: undefined;
61
61
  } | {
62
- id?: undefined;
62
+ error?: undefined;
63
63
  summary?: undefined;
64
64
  spans?: undefined;
65
+ id?: undefined;
65
66
  ok: boolean;
66
- error?: undefined;
67
67
  }>>;
@@ -52,9 +52,9 @@ export declare const setWorkspaceAppDefaultVisibilityHandler: import("h3").Event
52
52
  }>>;
53
53
  /** POST /_agent-native/org — create a new organization */
54
54
  export declare const createOrgHandler: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
55
+ name?: undefined;
55
56
  success: boolean;
56
57
  id?: undefined;
57
- name?: undefined;
58
58
  role?: undefined;
59
59
  } | {
60
60
  success?: undefined;
@@ -15,6 +15,6 @@ export declare function createProgressHandler(): import("h3").EventHandlerWithFe
15
15
  error: string;
16
16
  ok?: undefined;
17
17
  } | {
18
- ok: boolean;
19
18
  error?: undefined;
19
+ ok: boolean;
20
20
  }>>;