@objectql/create 4.0.0 → 4.0.2

package/templates/hello-world/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @example/hello-world
 
+## 4.0.2
+
+### Patch Changes
+
+- Updated dependencies
+  - @objectql/core@4.0.2
+  - @objectql/driver-sql@4.0.2
+
+## 4.0.1
+
+### Patch Changes
+
+- Updated dependencies
+  - @objectql/core@4.0.1
+  - @objectql/driver-sql@4.0.1
+
 ## 3.0.1
 
 ### Patch Changes

package/templates/hello-world/README.md

@@ -1,11 +1,51 @@
 # Hello ObjectQL
 
-This is the simplest possible example of **ObjectQL**.
+This is the simplest possible example of **ObjectQL** following the **latest ObjectStack specification** (v4.0+).
 
-It demonstrates:
-1.  **Zero Config:** No YAML files or server setup required.
-2.  **In-Memory SQL:** Uses SQLite in memory, so no database installation is needed.
-3.  **Inline Schema:** Defines the data model directly in code.
+## What it demonstrates
+
+1.  **Zero Config:** No YAML files or server setup required
+2.  **In-Memory SQL:** Uses SQLite in memory, so no database installation is needed
+3.  **Inline Schema:** Defines the data model directly in code using programmatic API
+4.  **Latest Spec Compliance:**
+    - Label/value format for select options
+    - Explicit field labels for AI-friendly metadata
+    - Proper field type declarations
+
+## Key Concepts
+
+### Metadata Definition Approaches
+
+**Programmatic (This Example):**
+```typescript
+app.registerObject({
+  name: 'deal',  // Required when using code
+  fields: {
+    stage: { 
+      type: 'select',
+      options: [
+        { label: 'New', value: 'new' },  // ✅ Latest spec format
+        { label: 'Negotiation', value: 'negotiation' }
+      ]
+    }
+  }
+});
+```
+
+**YAML-based (Recommended for Production):**
+```yaml
+# File: deal.object.yml
+# NO 'name:' field needed - inferred from filename! ✅
+label: Deal
+fields:
+  stage:
+    type: select
+    options:
+      - label: New
+        value: new
+      - label: Negotiation
+        value: negotiation
+```
 
 ## How to Run
 
@@ -16,14 +56,37 @@ Since you are in the monorepo, simply run:
 pnpm install
 
 # Run the script
-cd examples/starters/hello-world
+cd examples/quickstart/hello-world
 pnpm start
 ```
 
 ## What you see
 
 The script will:
-1.  Initialize the ObjectQL engine.
-2.  Create a `deal` object definition on the fly.
-3.  Insert a record into the in-memory SQLite database.
-4.  Query it back and print the result.
+1.  Initialize the ObjectQL engine with an in-memory SQLite driver
+2.  Create a `deal` object definition programmatically
+3.  Insert a record into the database
+4.  Query it back and print the result
+
+## Expected Output
+
+```
+🚀 Starting ObjectQL Hello World...
+Creating a new Deal...
+✅ Deals found in database: [
+  {
+    _id: '...',
+    title: 'Enterprise Contract',
+    amount: 50000,
+    stage: 'new',
+    created_at: '...',
+    updated_at: '...'
+  }
+]
+```
+
+## Next Steps
+
+- See [Project Tracker Example](../../showcase/project-tracker/) for YAML-based metadata
+- Read the [Metadata Standard Spec](https://protocol.objectstack.ai) from @objectstack/spec
+- Explore the [ObjectQL Documentation](../../../content/docs/)

package/templates/hello-world/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@objectql/example-hello-world",
-  "version": "4.0.0",
+  "version": "4.0.2",
   "private": true,
   "repository": {
     "type": "git",

package/templates/hello-world/src/index.ts

@@ -26,14 +26,26 @@ async function main() {
     }
   });
   
-  // 3. Define Metadata Inline
+  // 3. Define Metadata Inline (Following Latest ObjectStack Specification)
+  // Note: When using registerObject(), the 'name' is required in code
+  // When using YAML files, the name is inferred from filename (e.g., deal.object.yml)
   app.registerObject({
-    name: 'deal',
+    name: 'deal',  // Required for programmatic registration
+    label: 'Deal',  // Human-readable label
     fields: {
-      title: { type: 'text', required: true },
-      amount: { type: 'currency' },
+      title: { 
+        type: 'text', 
+        required: true,
+        label: 'Deal Title'
+      },
+      amount: { 
+        type: 'currency',
+        label: 'Deal Amount'
+      },
       stage: { 
-        type: 'select', 
+        type: 'select',
+        label: 'Deal Stage',
+        // Options use label/value format (ObjectStack spec v4.0+)
         options: [
             { label: 'New', value: 'new' },
             { label: 'Negotiation', value: 'negotiation' },

package/templates/starter/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @objectql/starter-basic
 
+## 4.0.2
+
+### Patch Changes
+
+- Updated dependencies
+  - @objectql/core@4.0.2
+  - @objectql/driver-sql@4.0.2
+  - @objectql/platform-node@4.0.2
+  - @objectql/types@4.0.2
+
+## 4.0.1
+
+### Patch Changes
+
+- Updated dependencies
+  - @objectql/core@4.0.1
+  - @objectql/driver-sql@4.0.1
+  - @objectql/platform-node@4.0.1
+  - @objectql/types@4.0.1
+
 ## 3.0.1
 
 ### Patch Changes

package/templates/starter/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@objectql/example-project-tracker",
-  "version": "4.0.0",
+  "version": "4.0.2",
   "description": "ObjectQL Basic Example Project",
   "private": true,
   "keywords": [