@construct-space/cli 1.9.0 → 1.9.2

package/dist/index.js

@@ -5450,7 +5450,9 @@ async function scaffold(nameArg, options) {
     join2(name, "src", "pages"),
     join2(name, "src", "components"),
     join2(name, "src", "composables"),
-    join2(name, "agent", "skills"),
+    join2(name, "scripts"),
+    join2(name, "references"),
+    join2(name, "assets"),
     join2(name, "agent", "hooks"),
     join2(name, "agent", "tools"),
     join2(name, "widgets", "summary")
@@ -5471,7 +5473,7 @@ async function scaffold(nameArg, options) {
     "style.css.tmpl": join2(name, "src", "style.css"),
     "index.vue.tmpl": join2(name, "src", "pages", "index.vue"),
     "config.md.tmpl": join2(name, "agent", "config.md"),
-    "skill.md.tmpl": join2(name, "agent", "skills", "default.md"),
+    "skill.md.tmpl": join2(name, "SKILL.md"),
     "safety.json.tmpl": join2(name, "agent", "hooks", "safety.json"),
     "tsconfig.json.tmpl": join2(name, "tsconfig.json"),
     "eslint.config.js.tmpl": join2(name, "eslint.config.js"),
@@ -5494,9 +5496,9 @@ async function scaffold(nameArg, options) {
   }
   if (isFull) {
     writeTemplate(templateDir, "full/settings.vue.tmpl", join2(name, "src", "pages", "settings.vue"), data);
-    writeTemplate(templateDir, "full/skill-data.md.tmpl", join2(name, "agent", "skills", "data.md"), data);
-    writeTemplate(templateDir, "full/skill-ui.md.tmpl", join2(name, "agent", "skills", "ui.md"), data);
-    console.log(source_default.blue("Full preset: settings page + extra skills added"));
+    writeTemplate(templateDir, "full/skill-data.md.tmpl", join2(name, "references", "data.md"), data);
+    writeTemplate(templateDir, "full/skill-ui.md.tmpl", join2(name, "references", "ui.md"), data);
+    console.log(source_default.blue("Full preset: settings page + references/data.md + references/ui.md"));
   }
   if (options?.withTests) {
     mkdirSync(join2(name, "e2e"), { recursive: true });
@@ -11698,7 +11700,7 @@ function graphFork(newSpaceID) {
 // package.json
 var package_default = {
   name: "@construct-space/cli",
-  version: "1.9.0",
+  version: "1.9.2",
   description: "Construct CLI \u2014 scaffold, build, develop, and publish spaces",
   type: "module",
   bin: {

package/dist/templates/space/full/skill-data.md.tmpl

@@ -1,18 +1,14 @@
----
-id: {{.ID}}-data
-name: {{.DisplayName}} Data Management
-description: Skill for managing {{.DisplayName}} data and content
-trigger: {{.ID}} data|content|manage
-category: space
-tools: [read_file, list_dir, glob, grep, write_file]
----
+# {{.DisplayName}} — data
 
-# {{.DisplayName}} Data Management Skill
+Reference doc for the agent when working with {{.DisplayName}} data.
 
-This skill handles data operations for the {{.DisplayName}} space.
+## Storage model
 
-## Instructions
-- Help users create, read, update, and delete content
-- Validate data before writing
-- Use the space actions API when available
-- Prefer batch operations for bulk changes
+Describe where {{.DisplayName}} data lives (Graph models, local storage, server API…). Edit this section to match the actual model.
+
+## CRUD conventions
+
+- Validate inputs before writing
+- Prefer the space's actions API over raw file or DB writes
+- Batch bulk changes when possible
+- Read existing rows before modifying — changes should be additive when in doubt

package/dist/templates/space/full/skill-ui.md.tmpl

@@ -1,18 +1,23 @@
----
-id: {{.ID}}-ui
-name: {{.DisplayName}} UI Customization
-description: Skill for customizing the {{.DisplayName}} user interface
-trigger: {{.ID}} ui|layout|design|style
-category: space
-tools: [read_file, write_file, glob]
----
-
-# {{.DisplayName}} UI Customization Skill
-
-This skill helps customize the {{.DisplayName}} space interface.
-
-## Instructions
-- Help users adjust layout and styling
-- Use Construct CSS variables (--app-foreground, --app-background, --app-accent, etc.)
-- Follow the host design system conventions
-- Suggest accessible color combinations
+# {{.DisplayName}} — UI
+
+Reference doc for the agent when adjusting {{.DisplayName}}'s UI.
+
+## Design tokens
+
+Use Construct CSS variables instead of hardcoded values:
+
+- `--app-foreground`, `--app-background`
+- `--app-accent`, `--app-accent-fg`
+- `--app-border`, `--app-muted`
+
+## Layout
+
+- Live inside the host shell — avoid full-bleed layouts that conflict with the sidebar/header
+- Use the `@construct-space/ui` primitives (`Card`, `Button`, `Badge`, …) for consistency
+- Prefer flex/grid over absolute positioning
+
+## Accessibility
+
+- Maintain 4.5:1 contrast for body text
+- Visible focus rings on every interactive element
+- Don't rely on color alone for state

package/dist/templates/space/full/space.manifest.json.tmpl

@@ -39,11 +39,7 @@
   ],
   "keywords": ["{{.ID}}"],
   "agent": "agent/config.md",
-  "skills": [
-    "agent/skills/default.md",
-    "agent/skills/data.md",
-    "agent/skills/ui.md"
-  ],
+  "skills": ["SKILL.md"],
   "actions": "src/actions.ts",
   "widgets": [
     {

package/dist/templates/space/skill.md.tmpl

@@ -1,17 +1,31 @@
 ---
-id: {{.ID}}-default
-name: {{.DisplayName}} Basics
-description: Default skill for {{.DisplayName}} space
-trigger: {{.ID}}|help
+name: {{.ID}}
+description: Help the user with tasks inside the {{.DisplayName}} space. Use when the user is working in {{.DisplayName}}, mentions {{.ID}}-related concepts, or asks what this space can do.
+allowed-tools: Read Glob Grep
 category: space
-tools: [read_file, list_dir, glob, grep]
+scope: any
 ---
 
-# {{.DisplayName}} Space Skill
+# {{.DisplayName}}
 
-This skill provides default behavior for the {{.DisplayName}} space.
+Help the user with tasks inside the {{.DisplayName}} space.
+
+## When to use
+
+- The user is inside the {{.DisplayName}} space
+- The user types `{{.ID}}` or asks about {{.DisplayName}}-related work
+- The user invokes a {{.DisplayName}} action
 
 ## Instructions
-- Assist with {{.DisplayName}}-related tasks
-- Follow project conventions
-- Read relevant files before making suggestions
+
+- Read existing files in the space before suggesting changes
+- Prefer space actions (see `src/actions.ts`) over generic file edits
+- Surface the space's conventions when proposing new code
+
+## Resources
+
+The agent loads these on demand:
+
+- `references/` — domain-specific docs (data model, UI conventions, …)
+- `scripts/` — supporting executables
+- `assets/` — templates and static resources

package/dist/templates/space/space.manifest.json.tmpl

@@ -34,7 +34,7 @@
   ],
   "keywords": ["{{.ID}}"],
   "agent": "agent/config.md",
-  "skills": ["agent/skills/default.md"],
+  "skills": ["SKILL.md"],
   "actions": "src/actions.ts",
   "widgets": [
     {

package/dist/templates/space/vite.config.ts.tmpl

@@ -7,7 +7,16 @@ import { resolve } from 'path'
  * Host-provided externals — these are supplied by Construct at runtime
  * via window.__CONSTRUCT__. Do NOT bundle them; they must stay external.
  *
- * Full list lives in: construct-app/frontend/lib/spaceHost.ts
+ * Source of truth: construct-app/frontend/lib/spaceHost.ts
+ *
+ * IMPORTANT — only add a package here AFTER confirming spaceHost.ts
+ * actually puts it on window.__CONSTRUCT__. Externalising a package the
+ * host doesn't expose silently substitutes `undefined`; you'll see
+ * "X is not a function" at runtime. When in doubt, bundle it (omit from
+ * this list) — bundle bloat is cheaper than a broken space.
+ *
+ * Notably NOT externalised:
+ *   @construct-space/graph — host does not expose this. Bundle it.
  */
 const hostExternals = [
   'vue',
@@ -21,8 +30,6 @@ const hostExternals = [
   'zod',
   '@construct-space/ui',
   '@construct-space/sdk',
-  '@construct-space/graph',
-  '@construct/sdk',           // legacy alias — keep during cutover
 ]
 
 function makeGlobals(externals: string[]): Record<string, string> {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@construct-space/cli",
-  "version": "1.9.0",
+  "version": "1.9.2",
   "description": "Construct CLI — scaffold, build, develop, and publish spaces",
   "type": "module",
   "bin": {

package/templates/space/full/skill-data.md.tmpl

@@ -1,18 +1,14 @@
----
-id: {{.ID}}-data
-name: {{.DisplayName}} Data Management
-description: Skill for managing {{.DisplayName}} data and content
-trigger: {{.ID}} data|content|manage
-category: space
-tools: [read_file, list_dir, glob, grep, write_file]
----
+# {{.DisplayName}} — data
 
-# {{.DisplayName}} Data Management Skill
+Reference doc for the agent when working with {{.DisplayName}} data.
 
-This skill handles data operations for the {{.DisplayName}} space.
+## Storage model
 
-## Instructions
-- Help users create, read, update, and delete content
-- Validate data before writing
-- Use the space actions API when available
-- Prefer batch operations for bulk changes
+Describe where {{.DisplayName}} data lives (Graph models, local storage, server API…). Edit this section to match the actual model.
+
+## CRUD conventions
+
+- Validate inputs before writing
+- Prefer the space's actions API over raw file or DB writes
+- Batch bulk changes when possible
+- Read existing rows before modifying — changes should be additive when in doubt

package/templates/space/full/skill-ui.md.tmpl

@@ -1,18 +1,23 @@
----
-id: {{.ID}}-ui
-name: {{.DisplayName}} UI Customization
-description: Skill for customizing the {{.DisplayName}} user interface
-trigger: {{.ID}} ui|layout|design|style
-category: space
-tools: [read_file, write_file, glob]
----
-
-# {{.DisplayName}} UI Customization Skill
-
-This skill helps customize the {{.DisplayName}} space interface.
-
-## Instructions
-- Help users adjust layout and styling
-- Use Construct CSS variables (--app-foreground, --app-background, --app-accent, etc.)
-- Follow the host design system conventions
-- Suggest accessible color combinations
+# {{.DisplayName}} — UI
+
+Reference doc for the agent when adjusting {{.DisplayName}}'s UI.
+
+## Design tokens
+
+Use Construct CSS variables instead of hardcoded values:
+
+- `--app-foreground`, `--app-background`
+- `--app-accent`, `--app-accent-fg`
+- `--app-border`, `--app-muted`
+
+## Layout
+
+- Live inside the host shell — avoid full-bleed layouts that conflict with the sidebar/header
+- Use the `@construct-space/ui` primitives (`Card`, `Button`, `Badge`, …) for consistency
+- Prefer flex/grid over absolute positioning
+
+## Accessibility
+
+- Maintain 4.5:1 contrast for body text
+- Visible focus rings on every interactive element
+- Don't rely on color alone for state

package/templates/space/full/space.manifest.json.tmpl

@@ -39,11 +39,7 @@
   ],
   "keywords": ["{{.ID}}"],
   "agent": "agent/config.md",
-  "skills": [
-    "agent/skills/default.md",
-    "agent/skills/data.md",
-    "agent/skills/ui.md"
-  ],
+  "skills": ["SKILL.md"],
   "actions": "src/actions.ts",
   "widgets": [
     {

package/templates/space/skill.md.tmpl

@@ -1,17 +1,31 @@
 ---
-id: {{.ID}}-default
-name: {{.DisplayName}} Basics
-description: Default skill for {{.DisplayName}} space
-trigger: {{.ID}}|help
+name: {{.ID}}
+description: Help the user with tasks inside the {{.DisplayName}} space. Use when the user is working in {{.DisplayName}}, mentions {{.ID}}-related concepts, or asks what this space can do.
+allowed-tools: Read Glob Grep
 category: space
-tools: [read_file, list_dir, glob, grep]
+scope: any
 ---
 
-# {{.DisplayName}} Space Skill
+# {{.DisplayName}}
 
-This skill provides default behavior for the {{.DisplayName}} space.
+Help the user with tasks inside the {{.DisplayName}} space.
+
+## When to use
+
+- The user is inside the {{.DisplayName}} space
+- The user types `{{.ID}}` or asks about {{.DisplayName}}-related work
+- The user invokes a {{.DisplayName}} action
 
 ## Instructions
-- Assist with {{.DisplayName}}-related tasks
-- Follow project conventions
-- Read relevant files before making suggestions
+
+- Read existing files in the space before suggesting changes
+- Prefer space actions (see `src/actions.ts`) over generic file edits
+- Surface the space's conventions when proposing new code
+
+## Resources
+
+The agent loads these on demand:
+
+- `references/` — domain-specific docs (data model, UI conventions, …)
+- `scripts/` — supporting executables
+- `assets/` — templates and static resources

package/templates/space/space.manifest.json.tmpl

@@ -34,7 +34,7 @@
   ],
   "keywords": ["{{.ID}}"],
   "agent": "agent/config.md",
-  "skills": ["agent/skills/default.md"],
+  "skills": ["SKILL.md"],
   "actions": "src/actions.ts",
   "widgets": [
     {

package/templates/space/vite.config.ts.tmpl

@@ -7,7 +7,16 @@ import { resolve } from 'path'
  * Host-provided externals — these are supplied by Construct at runtime
  * via window.__CONSTRUCT__. Do NOT bundle them; they must stay external.
  *
- * Full list lives in: construct-app/frontend/lib/spaceHost.ts
+ * Source of truth: construct-app/frontend/lib/spaceHost.ts
+ *
+ * IMPORTANT — only add a package here AFTER confirming spaceHost.ts
+ * actually puts it on window.__CONSTRUCT__. Externalising a package the
+ * host doesn't expose silently substitutes `undefined`; you'll see
+ * "X is not a function" at runtime. When in doubt, bundle it (omit from
+ * this list) — bundle bloat is cheaper than a broken space.
+ *
+ * Notably NOT externalised:
+ *   @construct-space/graph — host does not expose this. Bundle it.
  */
 const hostExternals = [
   'vue',
@@ -21,8 +30,6 @@ const hostExternals = [
   'zod',
   '@construct-space/ui',
   '@construct-space/sdk',
-  '@construct-space/graph',
-  '@construct/sdk',           // legacy alias — keep during cutover
 ]
 
 function makeGlobals(externals: string[]): Record<string, string> {