@construct-space/cli 1.0.6 → 1.1.0

package/dist/templates/space/actions.ts.tmpl

@@ -0,0 +1,35 @@
+/**
+ * Space Actions — exposed to the AI agent via space_run_action
+ *
+ * Define actions here and they'll be automatically available as agent tools.
+ * The agent calls: space_run_action(action: "action_id", payload: {...})
+ */
+
+// --- Graph SDK (data layer) ---
+// Uncomment after running `construct graph init` and defining models:
+//
+// import { useGraph } from '@construct-space/graph'
+// const graph = useGraph()
+//
+// Example action using Graph:
+// fetchItems: {
+//   description: 'Fetch items from the graph',
+//   params: {
+//     limit: { type: 'number', description: 'Max items to return', required: false },
+//   },
+//   run: async (p: any) => {
+//     const items = await graph.query('Item').limit(p.limit ?? 10).exec()
+//     return { items }
+//   },
+// },
+
+export const actions = {
+  // Example action:
+  // hello: {
+  //   description: 'Say hello',
+  //   params: {
+  //     name: { type: 'string', description: 'Name to greet', required: true },
+  //   },
+  //   run: (p: any) => ({ message: `Hello ${p.name}!` }),
+  // },
+}

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

@@ -4,14 +4,20 @@ name: {{.DisplayName}}
 category: space
 description: AI agent for the {{.DisplayName}} space
 maxIterations: 15
+tools: []
 canInvokeAgents: []
 ---
 
-You are Construct's {{.DisplayName}} agent. You help users work effectively within the {{.DisplayName}} space.
+You are Construct's {{.DisplayName}} agent. You help users work within the {{.DisplayName}} space.
+
+## Context
+
+Use space_list_actions to discover available actions for this space.
+Use space_run_action to execute actions.
+Do NOT call get_project_context — you work with space content, not project files.
 
 ## Behavior
 
-- Use get_project_context to understand the current project before acting
-- Read files before modifying them
-- Focus on tasks relevant to this space
+- Start by listing available actions to understand what you can do
 - Be concise and action-oriented
+- Focus on tasks relevant to this space

package/dist/templates/space/entry.ts.tmpl

@@ -0,0 +1,14 @@
+// Space entry — exports pages, widgets, and actions for the host loader.
+// `construct dev` regenerates this from space.manifest.json on changes.
+import IndexPage from './pages/index.vue'
+import { actions } from './actions'
+
+const spaceExport = {
+  pages: {
+    '': IndexPage,
+  },
+  widgets: {},
+  actions,
+}
+
+export default spaceExport

package/dist/templates/space/full/entry.ts.tmpl

@@ -0,0 +1,16 @@
+// Space entry — exports pages, widgets, and actions for the host loader.
+// `construct dev` regenerates this from space.manifest.json on changes.
+import IndexPage from './pages/index.vue'
+import SettingsPage from './pages/settings.vue'
+import { actions } from './actions'
+
+const spaceExport = {
+  pages: {
+    '': IndexPage,
+    'settings': SettingsPage,
+  },
+  widgets: {},
+  actions,
+}
+
+export default spaceExport

package/dist/templates/space/full/settings.vue.tmpl

@@ -0,0 +1,31 @@
+<script setup lang="ts">
+/**
+ * {{.DisplayName}} — Settings page
+ */
+import { ref } from 'vue'
+
+const autoSave = ref(true)
+const theme = ref<'system' | 'light' | 'dark'>('system')
+</script>
+
+<template>
+  <div class="h-full overflow-auto p-6">
+    <h1 class="text-xl font-bold text-[var(--app-foreground)] mb-6">Settings</h1>
+
+    <div class="space-y-4 max-w-md">
+      <label class="flex items-center justify-between">
+        <span class="text-sm text-[var(--app-foreground)]">Auto-save</span>
+        <input v-model="autoSave" type="checkbox" class="rounded" />
+      </label>
+
+      <label class="block">
+        <span class="text-sm text-[var(--app-foreground)] block mb-1">Theme</span>
+        <select v-model="theme" class="w-full rounded border border-[var(--app-border)] bg-[var(--app-background)] px-3 py-1.5 text-sm">
+          <option value="system">System</option>
+          <option value="light">Light</option>
+          <option value="dark">Dark</option>
+        </select>
+      </label>
+    </div>
+  </div>
+</template>

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

@@ -0,0 +1,18 @@
+---
+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 Management Skill
+
+This skill handles data operations for the {{.DisplayName}} space.
+
+## 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

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

@@ -0,0 +1,18 @@
+---
+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

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

@@ -0,0 +1,60 @@
+{
+  "id": "{{.ID}}",
+  "name": "{{.DisplayName}}",
+  "version": "0.1.0",
+  "description": "{{.DisplayName}} space for Construct",
+  "author": {
+    "name": "Your Name"
+  },
+  "icon": "i-lucide-box",
+  "scope": "both",
+  "minConstructVersion": "0.7.0",
+  "navigation": {
+    "label": "{{.DisplayName}}",
+    "icon": "i-lucide-box",
+    "to": "{{.ID}}",
+    "order": 100
+  },
+  "pages": [
+    {
+      "path": "",
+      "label": "Home",
+      "icon": "i-lucide-home",
+      "default": true
+    },
+    {
+      "path": "settings",
+      "label": "Settings",
+      "icon": "i-lucide-settings"
+    }
+  ],
+  "toolbar": [
+    {
+      "id": "{{.ID}}-new",
+      "icon": "i-lucide-plus",
+      "label": "New {{.DisplayName}}",
+      "action": "create{{.DisplayNameNoSpace}}"
+    }
+  ],
+  "keywords": ["{{.ID}}"],
+  "agent": "agent/config.md",
+  "skills": [
+    "agent/skills/default.md",
+    "agent/skills/data.md",
+    "agent/skills/ui.md"
+  ],
+  "actions": "src/actions.ts",
+  "widgets": [
+    {
+      "id": "summary",
+      "name": "{{.DisplayName}} Summary",
+      "description": "Quick summary widget for {{.DisplayName}}",
+      "icon": "i-lucide-box",
+      "defaultSize": "4x1",
+      "sizes": {
+        "2x1": "widgets/summary/2x1.vue",
+        "4x1": "widgets/summary/4x1.vue"
+      }
+    }
+  ]
+}

package/dist/templates/space/index.vue.tmpl

@@ -1,14 +1,20 @@
 <script setup lang="ts">
 /**
  * {{.DisplayName}} — Home page
+ *
+ * Host-provided packages (vue, pinia, @vueuse/core, @construct/sdk, etc.)
+ * are available as imports — they resolve to the host at runtime.
  */
+import { ref } from 'vue'
+
+const greeting = ref('Your space is ready. Start building!')
 </script>
 
 <template>
   <div class="h-full flex items-center justify-center">
     <div class="text-center">
       <h1 class="text-2xl font-bold text-[var(--app-foreground)] mb-2">{{.DisplayName}}</h1>
-      <p class="text-sm text-[var(--app-muted)]">Your space is ready. Start building!</p>
+      <p class="text-sm text-[var(--app-muted)]">{{ greeting }}</p>
     </div>
   </div>
 </template>

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

@@ -4,20 +4,24 @@
   "private": true,
   "type": "module",
   "scripts": {
+    "generate-entry": "construct build --entry-only",
     "build": "construct build",
     "dev": "construct dev",
-    "check": "construct check"
+    "check": "construct check",
+    "validate": "construct validate"
   },
   "peerDependencies": {
-    "vue": "^3.5.0"
-  },
-  "dependencies": {
-    "@construct-space/ui": "^0.3.5"
+    "vue": "^3.5.0",
+    "pinia": "^3.0.0",
+    "@vueuse/core": "^14.0.0"
   },
   "devDependencies": {
-    "vite": "^8.0.0",
+    "@construct-space/cli": "latest",
+    "@construct-space/sdk": "latest",
     "@vitejs/plugin-vue": "^5.2.3",
-    "typescript": "^6.0.0",
+    "lucide-vue-next": "^1.0.0",
+    "typescript": "^5.9.3",
+    "vite": "^6.3.5",
     "vue-tsc": "^3.2.5"
   }
 }

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

@@ -8,7 +8,7 @@
   },
   "icon": "i-lucide-box",
   "scope": "both",
-  "minConstructVersion": "0.2.0",
+  "minConstructVersion": "0.7.0",
   "navigation": {
     "label": "{{.DisplayName}}",
     "icon": "i-lucide-box",
@@ -34,6 +34,7 @@
   "keywords": ["{{.ID}}"],
   "agent": "agent/config.md",
   "skills": ["agent/skills/default.md"],
+  "actions": "src/actions.ts",
   "widgets": [
     {
       "id": "summary",

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

@@ -9,18 +9,13 @@
     "esModuleInterop": true,
     "skipLibCheck": true,
     "paths": {
-      "@construct/sdk": ["../construct-sdk/src/index.ts"]
+      "@/*": ["./src/*"],
+      "@construct/sdk": ["./node_modules/@construct-space/sdk/src/index.ts"]
     }
   },
   "include": [
     "src/**/*.ts",
-    "pages/**/*.vue",
-    "components/**/*.vue",
-    "composables/**/*.ts",
-    "utils/**/*.ts",
-    "types/**/*.ts",
-    "types.ts",
-    "auto-imports.d.ts",
-    "components.d.ts"
+    "src/**/*.vue",
+    "widgets/**/*.vue"
   ]
 }

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

@@ -2,6 +2,49 @@ import { defineConfig } from 'vite'
 import vue from '@vitejs/plugin-vue'
 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
+ */
+const hostExternals = [
+  'vue',
+  'vue-router',
+  'pinia',
+  '@vueuse/core',
+  '@vueuse/integrations',
+  '@tauri-apps/api',
+  '@tauri-apps/api/core',
+  '@tauri-apps/api/path',
+  '@tauri-apps/api/event',
+  '@tauri-apps/api/webview',
+  '@tauri-apps/plugin-fs',
+  '@tauri-apps/plugin-shell',
+  '@tauri-apps/plugin-dialog',
+  '@tauri-apps/plugin-process',
+  'lucide-vue-next',
+  'date-fns',
+  'dexie',
+  'zod',
+  '@construct-space/ui',
+  '@construct/sdk',
+  '@construct-space/sdk',
+]
+
+function makeGlobals(externals: string[]): Record<string, string> {
+  const globals: Record<string, string> = {}
+  for (const ext of externals) {
+    // Simple ids use dot access, scoped/slashed ids use bracket access
+    if (/^[a-z]+$/.test(ext)) {
+      globals[ext] = `window.__CONSTRUCT__.${ext}`
+    } else {
+      globals[ext] = `window.__CONSTRUCT__["${ext}"]`
+    }
+  }
+  return globals
+}
+
 export default defineConfig({
   plugins: [vue()],
   build: {
@@ -12,14 +55,9 @@ export default defineConfig({
       formats: ['iife'],
     },
     rollupOptions: {
-      external: ['vue', 'vue-router', 'pinia', '@vueuse/core'],
+      external: hostExternals,
       output: {
-        globals: {
-          vue: 'window.__CONSTRUCT__.vue',
-          'vue-router': 'window.__CONSTRUCT__["vue-router"]',
-          pinia: 'window.__CONSTRUCT__.pinia',
-          '@vueuse/core': 'window.__CONSTRUCT__["@vueuse/core"]',
-        },
+        globals: makeGlobals(hostExternals),
       },
     },
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@construct-space/cli",
-  "version": "1.0.6",
+  "version": "1.1.0",
   "description": "Construct CLI — scaffold, build, develop, and publish spaces",
   "type": "module",
   "bin": {
@@ -18,6 +18,7 @@
   "scripts": {
     "build": "bun build src/index.ts --outdir dist --target node --format esm && cp -r templates dist/",
     "dev": "bun run src/index.ts",
+    "test": "bun test",
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
@@ -25,10 +26,10 @@
     "@inquirer/prompts": "^8.3.2",
     "chalk": "^5.6.2",
     "ora": "^9.3.0",
-    "chokidar": "^4.0.3"
+    "chokidar": "^5.0.0"
   },
   "devDependencies": {
-    "@types/node": "^22.15.17",
+    "@types/node": "^25.5.0",
     "typescript": "^6.0.2"
   },
   "keywords": [

package/templates/space/actions.ts.tmpl

@@ -0,0 +1,35 @@
+/**
+ * Space Actions — exposed to the AI agent via space_run_action
+ *
+ * Define actions here and they'll be automatically available as agent tools.
+ * The agent calls: space_run_action(action: "action_id", payload: {...})
+ */
+
+// --- Graph SDK (data layer) ---
+// Uncomment after running `construct graph init` and defining models:
+//
+// import { useGraph } from '@construct-space/graph'
+// const graph = useGraph()
+//
+// Example action using Graph:
+// fetchItems: {
+//   description: 'Fetch items from the graph',
+//   params: {
+//     limit: { type: 'number', description: 'Max items to return', required: false },
+//   },
+//   run: async (p: any) => {
+//     const items = await graph.query('Item').limit(p.limit ?? 10).exec()
+//     return { items }
+//   },
+// },
+
+export const actions = {
+  // Example action:
+  // hello: {
+  //   description: 'Say hello',
+  //   params: {
+  //     name: { type: 'string', description: 'Name to greet', required: true },
+  //   },
+  //   run: (p: any) => ({ message: `Hello ${p.name}!` }),
+  // },
+}

package/templates/space/config.md.tmpl

@@ -4,14 +4,20 @@ name: {{.DisplayName}}
 category: space
 description: AI agent for the {{.DisplayName}} space
 maxIterations: 15
+tools: []
 canInvokeAgents: []
 ---
 
-You are Construct's {{.DisplayName}} agent. You help users work effectively within the {{.DisplayName}} space.
+You are Construct's {{.DisplayName}} agent. You help users work within the {{.DisplayName}} space.
+
+## Context
+
+Use space_list_actions to discover available actions for this space.
+Use space_run_action to execute actions.
+Do NOT call get_project_context — you work with space content, not project files.
 
 ## Behavior
 
-- Use get_project_context to understand the current project before acting
-- Read files before modifying them
-- Focus on tasks relevant to this space
+- Start by listing available actions to understand what you can do
 - Be concise and action-oriented
+- Focus on tasks relevant to this space

package/templates/space/entry.ts.tmpl

@@ -0,0 +1,14 @@
+// Space entry — exports pages, widgets, and actions for the host loader.
+// `construct dev` regenerates this from space.manifest.json on changes.
+import IndexPage from './pages/index.vue'
+import { actions } from './actions'
+
+const spaceExport = {
+  pages: {
+    '': IndexPage,
+  },
+  widgets: {},
+  actions,
+}
+
+export default spaceExport

package/templates/space/full/entry.ts.tmpl

@@ -0,0 +1,16 @@
+// Space entry — exports pages, widgets, and actions for the host loader.
+// `construct dev` regenerates this from space.manifest.json on changes.
+import IndexPage from './pages/index.vue'
+import SettingsPage from './pages/settings.vue'
+import { actions } from './actions'
+
+const spaceExport = {
+  pages: {
+    '': IndexPage,
+    'settings': SettingsPage,
+  },
+  widgets: {},
+  actions,
+}
+
+export default spaceExport

package/templates/space/full/settings.vue.tmpl

@@ -0,0 +1,31 @@
+<script setup lang="ts">
+/**
+ * {{.DisplayName}} — Settings page
+ */
+import { ref } from 'vue'
+
+const autoSave = ref(true)
+const theme = ref<'system' | 'light' | 'dark'>('system')
+</script>
+
+<template>
+  <div class="h-full overflow-auto p-6">
+    <h1 class="text-xl font-bold text-[var(--app-foreground)] mb-6">Settings</h1>
+
+    <div class="space-y-4 max-w-md">
+      <label class="flex items-center justify-between">
+        <span class="text-sm text-[var(--app-foreground)]">Auto-save</span>
+        <input v-model="autoSave" type="checkbox" class="rounded" />
+      </label>
+
+      <label class="block">
+        <span class="text-sm text-[var(--app-foreground)] block mb-1">Theme</span>
+        <select v-model="theme" class="w-full rounded border border-[var(--app-border)] bg-[var(--app-background)] px-3 py-1.5 text-sm">
+          <option value="system">System</option>
+          <option value="light">Light</option>
+          <option value="dark">Dark</option>
+        </select>
+      </label>
+    </div>
+  </div>
+</template>

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

@@ -0,0 +1,18 @@
+---
+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 Management Skill
+
+This skill handles data operations for the {{.DisplayName}} space.
+
+## 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

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

@@ -0,0 +1,18 @@
+---
+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

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

@@ -0,0 +1,60 @@
+{
+  "id": "{{.ID}}",
+  "name": "{{.DisplayName}}",
+  "version": "0.1.0",
+  "description": "{{.DisplayName}} space for Construct",
+  "author": {
+    "name": "Your Name"
+  },
+  "icon": "i-lucide-box",
+  "scope": "both",
+  "minConstructVersion": "0.7.0",
+  "navigation": {
+    "label": "{{.DisplayName}}",
+    "icon": "i-lucide-box",
+    "to": "{{.ID}}",
+    "order": 100
+  },
+  "pages": [
+    {
+      "path": "",
+      "label": "Home",
+      "icon": "i-lucide-home",
+      "default": true
+    },
+    {
+      "path": "settings",
+      "label": "Settings",
+      "icon": "i-lucide-settings"
+    }
+  ],
+  "toolbar": [
+    {
+      "id": "{{.ID}}-new",
+      "icon": "i-lucide-plus",
+      "label": "New {{.DisplayName}}",
+      "action": "create{{.DisplayNameNoSpace}}"
+    }
+  ],
+  "keywords": ["{{.ID}}"],
+  "agent": "agent/config.md",
+  "skills": [
+    "agent/skills/default.md",
+    "agent/skills/data.md",
+    "agent/skills/ui.md"
+  ],
+  "actions": "src/actions.ts",
+  "widgets": [
+    {
+      "id": "summary",
+      "name": "{{.DisplayName}} Summary",
+      "description": "Quick summary widget for {{.DisplayName}}",
+      "icon": "i-lucide-box",
+      "defaultSize": "4x1",
+      "sizes": {
+        "2x1": "widgets/summary/2x1.vue",
+        "4x1": "widgets/summary/4x1.vue"
+      }
+    }
+  ]
+}

package/templates/space/index.vue.tmpl

@@ -1,14 +1,20 @@
 <script setup lang="ts">
 /**
  * {{.DisplayName}} — Home page
+ *
+ * Host-provided packages (vue, pinia, @vueuse/core, @construct/sdk, etc.)
+ * are available as imports — they resolve to the host at runtime.
  */
+import { ref } from 'vue'
+
+const greeting = ref('Your space is ready. Start building!')
 </script>
 
 <template>
   <div class="h-full flex items-center justify-center">
     <div class="text-center">
       <h1 class="text-2xl font-bold text-[var(--app-foreground)] mb-2">{{.DisplayName}}</h1>
-      <p class="text-sm text-[var(--app-muted)]">Your space is ready. Start building!</p>
+      <p class="text-sm text-[var(--app-muted)]">{{ greeting }}</p>
     </div>
   </div>
 </template>