feat: add comprehensive view and widget schemas for ObjectStack UI

- Introduced `view.zod.ts` containing detailed schemas for view configurations, including data sources, filters, columns, pagination, and user actions.
- Added `widget.zod.ts` defining schemas for custom widget lifecycle hooks, events, properties, and manifest, enhancing widget integration and configuration capabilities.

Author: hotlong

.github/copilot-instructions.md

@@ -88,11 +88,11 @@ objectstack-ai/spec/
 │   └── plugin-bi/         # Plugin example: BI dashboard
 │
 ├── skills/                # 🤖 AI skill definitions (for Copilot/Cursor)
-│   ├── schema-design/
-│   ├── api-design/
-│   ├── ui-design/
-│   ├── automation-design/
-│   └── ai-agent-design/
+│   ├── objectstack-data/
+│   ├── objectstack-api/
+│   ├── objectstack-ui/
+│   ├── objectstack-automation/
+│   └── objectstack-ai/
 │
 └── content/docs/          # 📝 Documentation content
     ├── getting-started/
@@ -225,11 +225,11 @@ The `skills/` directory contains domain-specific AI skill definitions. When work
 
 | Skill | Path | Use When |
 |:---|:---|:---|
-| Schema Design | `skills/schema-design/SKILL.md` | Designing Objects, Fields, Relations |
-| API Design | `skills/api-design/SKILL.md` | Designing REST/GraphQL endpoints |
-| UI Design | `skills/ui-design/SKILL.md` | Designing Views, Dashboards, Apps |
-| Automation Design | `skills/automation-design/SKILL.md` | Designing Flows, Workflows, Triggers |
-| AI Agent Design | `skills/ai-agent-design/SKILL.md` | Designing Agents, Tools, RAG pipelines |
+| Data Design | `skills/objectstack-data/SKILL.md` | Designing Objects, Fields, Relations |
+| API Design | `skills/objectstack-api/SKILL.md` | Designing REST/GraphQL endpoints |
+| UI Design | `skills/objectstack-ui/SKILL.md` | Designing Views, Dashboards, Apps |
+| Automation Design | `skills/objectstack-automation/SKILL.md` | Designing Flows, Workflows, Triggers |
+| AI Agent Design | `skills/objectstack-ai/SKILL.md` | Designing Agents, Tools, RAG pipelines |
 
 ---
 

packages/spec/scripts/build-skill-references.ts

@@ -30,7 +30,7 @@ const SKILLS_DIR = path.resolve(REPO_ROOT, 'skills');
 // Paths are relative to packages/spec/src/ (category/file.zod.ts)
 
 const SKILL_MAP: Record<string, string[]> = {
-  'objectstack-schema': [
+  'objectstack-data': [
     'data/field.zod.ts',
     'data/object.zod.ts',
     'data/validation.zod.ts',
@@ -236,25 +236,37 @@ function main() {
     const allFiles = resolveAll(coreFiles);
     console.log(`   ${coreFiles.length} core + ${allFiles.length - coreFiles.length} deps = ${allFiles.length} files`);
 
-    // Target directory
-    const zodDir = path.resolve(skillDir, 'references/zod');
+    // Target directory — directly under references/ (no zod/ subdirectory)
+    const refsDir = path.resolve(skillDir, 'references');
 
-    // Clean previous output
-    if (fs.existsSync(zodDir)) {
-      fs.rmSync(zodDir, { recursive: true });
+    // Clean previous generated files (preserve directory, remove .zod.ts and _index.md)
+    if (fs.existsSync(refsDir)) {
+      // Remove old zod/ subdirectory if it exists (migration from previous structure)
+      const oldZodDir = path.resolve(refsDir, 'zod');
+      if (fs.existsSync(oldZodDir)) {
+        fs.rmSync(oldZodDir, { recursive: true });
+      }
+      // Remove generated category directories and _index.md
+      for (const entry of fs.readdirSync(refsDir)) {
+        const entryPath = path.resolve(refsDir, entry);
+        const stat = fs.statSync(entryPath);
+        if (stat.isDirectory() || entry === '_index.md') {
+          fs.rmSync(entryPath, { recursive: true });
+        }
+      }
     }
 
     // Copy files preserving directory structure
     for (const rel of allFiles) {
       const src = path.resolve(SPEC_SRC, rel);
-      const dest = path.resolve(zodDir, rel);
+      const dest = path.resolve(refsDir, rel);
       fs.mkdirSync(path.dirname(dest), { recursive: true });
       fs.copyFileSync(src, dest);
     }
 
     // Generate _index.md
     const indexContent = generateIndex(skillName, coreFiles, allFiles);
-    fs.writeFileSync(path.resolve(zodDir, '_index.md'), indexContent);
+    fs.writeFileSync(path.resolve(refsDir, '_index.md'), indexContent);
 
     totalFiles += allFiles.length;
   }

skills/objectstack-ai/SKILL.md

@@ -343,20 +343,13 @@ structuredOutput: {
 
 ## References
 
-### Zod Source Schemas (auto-copied)
-
-- [agent.zod.ts](./references/zod/ai/agent.zod.ts) — AgentSchema, model config, guardrails
-- [tool.zod.ts](./references/zod/ai/tool.zod.ts) — ToolSchema, categories, parameters
-- [skill.zod.ts](./references/zod/ai/skill.zod.ts) — SkillSchema, trigger conditions
-- [rag-pipeline.zod.ts](./references/zod/ai/rag-pipeline.zod.ts) — RAG, chunking, retrieval, embeddings
-- [model-registry.zod.ts](./references/zod/ai/model-registry.zod.ts) — LLM providers, model versioning
-- [conversation.zod.ts](./references/zod/ai/conversation.zod.ts) — Chat context, message history, turns
-- [mcp.zod.ts](./references/zod/ai/mcp.zod.ts) — MCP protocol, tool/resource/prompt schemas
-- [orchestration.zod.ts](./references/zod/ai/orchestration.zod.ts) — Multi-agent orchestration patterns
-- [nlq.zod.ts](./references/zod/ai/nlq.zod.ts) — Natural language query schemas
-- [Schema index](./references/zod/_index.md) — All bundled schemas with dependency tree
-
-### Quick Reference
-
-- [Agent & Skill Reference](./references/agent-skill-reference.md) — Compact property tables
-- [RAG Pipeline Reference](./references/rag-pipeline-reference.md) — Vector stores, strategies
+- [agent.zod.ts](./references/ai/agent.zod.ts) — AgentSchema, model config, guardrails
+- [tool.zod.ts](./references/ai/tool.zod.ts) — ToolSchema, categories, parameters
+- [skill.zod.ts](./references/ai/skill.zod.ts) — SkillSchema, trigger conditions
+- [rag-pipeline.zod.ts](./references/ai/rag-pipeline.zod.ts) — RAG, chunking, retrieval, embeddings
+- [model-registry.zod.ts](./references/ai/model-registry.zod.ts) — LLM providers, model versioning
+- [conversation.zod.ts](./references/ai/conversation.zod.ts) — Chat context, message history, turns
+- [mcp.zod.ts](./references/ai/mcp.zod.ts) — MCP protocol, tool/resource/prompt schemas
+- [orchestration.zod.ts](./references/ai/orchestration.zod.ts) — Multi-agent orchestration patterns
+- [nlq.zod.ts](./references/ai/nlq.zod.ts) — Natural language query schemas
+- [Schema index](./references/_index.md) — All bundled schemas with dependency tree