@manifesto-ai/core 0.2.0 → 0.3.0

package/README.md

@@ -20,14 +20,19 @@ import {
   createRuntime,
   defineDerived,
   defineAction,
+  defineSource,
   sequence,
   setState,
-  apiCall,
+  setValue,
   z
 } from '@manifesto-ai/core';
 
 // Define a domain
-const todosDomain = defineDomain('todos', {
+const todosDomain = defineDomain({
+  id: 'todos',
+  name: 'Todos',
+  description: 'Todo list management domain',
+
   dataSchema: z.object({
     items: z.array(z.object({
       id: z.string(),
@@ -37,44 +42,61 @@ const todosDomain = defineDomain('todos', {
   }),
 
   stateSchema: z.object({
-    filter: z.enum(['all', 'active', 'completed']).default('all'),
-    isLoading: z.boolean().default(false)
+    filter: z.enum(['all', 'active', 'completed']),
+    isLoading: z.boolean()
   }),
 
-  derived: {
-    'derived.activeCount': defineDerived(
-      { $size: { $filter: ['data.items', { $eq: ['$item.completed', false] }] } },
-      z.number()
-    ),
-    'derived.filteredItems': defineDerived(
-      {
-        $if: [
-          { $eq: [{ $get: 'state.filter' }, 'all'] },
-          { $get: 'data.items' },
-          { $filter: ['data.items', {
-            $eq: ['$item.completed', { $eq: [{ $get: 'state.filter' }, 'completed'] }]
-          }] }
-        ]
-      },
-      z.array(z.object({ id: z.string(), title: z.string(), completed: z.boolean() }))
-    )
+  initialState: {
+    filter: 'all',
+    isLoading: false
   },
 
-  actions: {
-    addTodo: defineAction({
-      precondition: { $gt: [{ $size: { $get: 'input.title' } }, 0] },
-      effect: setValue('data.items', {
-        $concat: [
-          { $get: 'data.items' },
-          [{ id: { $get: 'input.id' }, title: { $get: 'input.title' }, completed: false }]
-        ]
+  paths: {
+    sources: {
+      // Auto-prefixed: 'items' becomes 'data.items'
+      items: defineSource({
+        schema: z.array(z.object({
+          id: z.string(),
+          title: z.string(),
+          completed: z.boolean()
+        })),
+        defaultValue: [],
+        semantic: { type: 'list', description: 'Todo items' }
+      })
+    },
+    derived: {
+      // Auto-prefixed: 'activeCount' becomes 'derived.activeCount'
+      activeCount: defineDerived({
+        deps: ['data.items'],
+        expr: ['length', ['filter', ['get', 'data.items'], ['!', '$.completed']]],
+        semantic: { type: 'count', description: 'Number of active todos' }
       })
+    }
+  },
+
+  actions: {
+    // Set filter action
+    setFilter: defineAction({
+      deps: ['state.filter'],
+      input: z.object({ filter: z.enum(['all', 'active', 'completed']) }),
+      effect: setState('state.filter', ['get', 'input.filter'], 'Set filter'),
+      semantic: { type: 'action', verb: 'set', description: 'Set todo filter' }
+    }),
+
+    // Clear completed todos
+    clearCompleted: defineAction({
+      deps: ['data.items'],
+      effect: setValue('data.items',
+        ['filter', ['get', 'data.items'], ['!', '$.completed']],
+        'Clear completed todos'
+      ),
+      semantic: { type: 'action', verb: 'clear', description: 'Remove completed todos' }
     })
   }
 });
 
 // Create runtime
-const runtime = createRuntime(todosDomain);
+const runtime = createRuntime({ domain: todosDomain });
 
 // Use the runtime
 runtime.set('data.items', [
@@ -88,91 +110,130 @@ console.log(runtime.get('derived.activeCount')); // 1
 
 ### Domain Definition
 
-#### `defineDomain(name, config)`
+> **Note:** Keys in `sources`, `derived`, and `async` are auto-prefixed (`data.`, `derived.`, `async.` respectively). Keys with existing prefixes are preserved for backward compatibility. Both `activeCount` and `'derived.activeCount'` are valid.
+
+#### `defineDomain(options)`
 
 Creates a domain definition.
 
 ```typescript
-const domain = defineDomain('myDomain', {
+const domain = defineDomain({
+  id: 'myDomain',
+  name: 'My Domain',
+  description: 'Domain description for AI understanding',
   dataSchema: z.object({ ... }),      // Required: Source data schema
-  stateSchema: z.object({ ... }),     // Optional: UI state schema
-  derived: { ... },                    // Optional: Computed values
-  async: { ... },                      // Optional: Async data sources
-  actions: { ... }                     // Optional: Domain actions
+  stateSchema: z.object({ ... }),     // Required: UI state schema
+  initialState: { ... },               // Required: Initial state values
+  paths: {
+    sources: { ... },                  // Optional: Source definitions
+    derived: { ... },                  // Optional: Computed values
+    async: { ... },                    // Optional: Async data sources
+  },
+  actions: { ... },                    // Optional: Domain actions
+  meta: { ... }                        // Optional: Domain metadata
 });
 ```
 
-#### `defineSource(schema, meta?)`
+#### `defineSource(options)`
 
-Defines a source field with optional metadata.
+Defines a source field with semantic metadata.
 
 ```typescript
 const sources = {
-  'data.user': defineSource(
-    z.object({ name: z.string(), email: z.string() }),
-    { description: 'Current user information' }
-  )
+  // Auto-prefixed: 'user' becomes 'data.user'
+  user: defineSource({
+    schema: z.object({ name: z.string(), email: z.string() }),
+    defaultValue: { name: '', email: '' },
+    semantic: {
+      type: 'entity',
+      description: 'Current user information'
+    }
+  })
 };
 ```
 
-#### `defineDerived(expression, schema, meta?)`
+#### `defineDerived(options)`
 
-Defines a computed value.
+Defines a computed value with explicit dependencies.
 
 ```typescript
 const derived = {
-  'derived.fullName': defineDerived(
-    { $concat: [{ $get: 'data.firstName' }, ' ', { $get: 'data.lastName' }] },
-    z.string(),
-    { description: 'User full name' }
-  )
+  // Auto-prefixed: 'fullName' becomes 'derived.fullName'
+  fullName: defineDerived({
+    deps: ['data.firstName', 'data.lastName'],
+    expr: ['concat', ['get', 'data.firstName'], ' ', ['get', 'data.lastName']],
+    semantic: {
+      type: 'computed',
+      description: 'User full name'
+    }
+  })
 };
 ```
 
-#### `defineAsync(config, schema, meta?)`
+#### `defineAsync(options)`
 
-Defines an async data source.
+Defines an async data source with result paths.
 
 ```typescript
 const async = {
-  'async.userData': defineAsync(
-    {
-      fetch: { method: 'GET', url: '/api/user' },
-      dependencies: ['data.userId']
+  // Auto-prefixed: 'userData' becomes 'async.userData'
+  userData: defineAsync({
+    deps: ['data.userId'],
+    condition: ['!=', ['get', 'data.userId'], null],
+    debounce: 300,
+    effect: {
+      _tag: 'ApiCall',
+      method: 'GET',
+      endpoint: '/api/user',
+      description: 'Fetch user data'
     },
-    z.object({ name: z.string() })
-  )
+    resultPath: 'state.userData',
+    loadingPath: 'state.userLoading',
+    errorPath: 'state.userError',
+    semantic: {
+      type: 'async',
+      description: 'User data from API'
+    }
+  })
 };
 ```
 
-#### `defineAction(config)`
+#### `defineAction(options)`
 
 Defines a domain action with preconditions and effects.
 
 ```typescript
 const actions = {
   submit: defineAction({
-    precondition: { $and: [
-      { $gt: [{ $get: 'derived.total' }, 0] },
-      { $not: { $get: 'state.isSubmitting' } }
-    ]},
+    deps: ['derived.total', 'state.isSubmitting'],
+    preconditions: [
+      { path: 'derived.hasItems', expect: 'true', reason: 'Cart must have items' },
+      { path: 'state.isSubmitting', expect: 'false', reason: 'Already submitting' }
+    ],
     effect: sequence([
       setState('state.isSubmitting', true),
       apiCall({ method: 'POST', url: '/api/submit' }),
       setState('state.isSubmitting', false)
-    ])
+    ]),
+    semantic: {
+      type: 'action',
+      verb: 'submit',
+      description: 'Submit the order',
+      risk: 'medium'
+    }
   })
 };
 ```
 
 ### Runtime
 
-#### `createRuntime(domain, options?)`
+#### `createRuntime(options)`
 
 Creates a runtime instance for a domain.
 
 ```typescript
-const runtime = createRuntime(domain, {
+const runtime = createRuntime({
+  domain: myDomain,
   initialData: { count: 0 },
   initialState: { isLoading: false }
 });
@@ -215,77 +276,148 @@ const explanation = runtime.explain('derived.total');
 
 ### Expression DSL
 
-Manifesto uses a JSON-based DSL for declarative expressions.
+Manifesto uses a JSON-based DSL for declarative expressions. All expressions use **array format**: `['operator', ...args]`.
+
+#### Path Reference
+
+```typescript
+['get', 'data.user.name']     // Get value at path
+['get', 'state.isLoading']    // Get state value
+['get', 'derived.total']      // Get derived value
+
+// In predicates (filter, map, etc.)
+'$.price'                      // Current item's price field
+'$.completed'                  // Current item's completed field
+'$'                            // Current item itself
+```
 
 #### Comparison Operators
 
 ```typescript
-{ $eq: [a, b] }       // a === b
-{ $ne: [a, b] }       // a !== b
-{ $gt: [a, b] }       // a > b
-{ $gte: [a, b] }      // a >= b
-{ $lt: [a, b] }       // a < b
-{ $lte: [a, b] }      // a <= b
+['==', a, b]      // a === b
+['!=', a, b]      // a !== b
+['>', a, b]       // a > b
+['>=', a, b]      // a >= b
+['<', a, b]       // a < b
+['<=', a, b]      // a <= b
 ```
 
 #### Logical Operators
 
 ```typescript
-{ $and: [expr1, expr2, ...] }   // All true
-{ $or: [expr1, expr2, ...] }    // Any true
-{ $not: expr }                   // Negation
+['all', expr1, expr2, ...]    // All expressions must be true (AND)
+['any', expr1, expr2, ...]    // Any expression is true (OR)
+['!', expr]                    // Negation (NOT)
 ```
 
 #### Arithmetic Operators
 
 ```typescript
-{ $add: [a, b] }        // a + b
-{ $subtract: [a, b] }   // a - b
-{ $multiply: [a, b] }   // a * b
-{ $divide: [a, b] }     // a / b
-{ $modulo: [a, b] }     // a % b
+['+', a, b]       // a + b
+['-', a, b]       // a - b
+['*', a, b]       // a * b
 ```
 
 #### String Functions
 
 ```typescript
-{ $concat: [str1, str2, ...] }  // Concatenate strings
-{ $upper: str }                  // Uppercase
-{ $lower: str }                  // Lowercase
-{ $trim: str }                   // Trim whitespace
-{ $split: [str, delimiter] }     // Split string
-{ $includes: [str, search] }     // Contains substring
+['concat', str1, str2, ...]     // Concatenate strings
+['join', array, delimiter]       // Join array elements
+['includes', str, search]        // Contains substring
+['slice', str, start, end]       // Substring
 ```
 
 #### Array Functions
 
 ```typescript
-{ $size: array }                            // Array length
-{ $first: array }                           // First element
-{ $last: array }                            // Last element
-{ $filter: [array, predicate] }             // Filter elements
-{ $map: [array, transform] }                // Transform elements
-{ $find: [array, predicate] }               // Find first match
-{ $some: [array, predicate] }               // Any match
-{ $every: [array, predicate] }              // All match
-{ $sum: array }                             // Sum numbers
-{ $reduce: [array, reducer, initial] }      // Reduce array
+['length', array]                // Array length
+['at', array, index]             // Element at index (0 = first, -1 = last)
+['filter', array, predicate]     // Filter elements
+['map', array, transform]        // Transform elements
+['some', array, predicate]       // Any element matches
+['every', array, predicate]      // All elements match
+['concat', array1, array2]       // Concatenate arrays
+['includes', array, element]     // Array contains element
+['sort', array, key]             // Sort by key
+['slice', array, start, end]     // Slice array
+['indexOf', array, element]      // Find index of element
 ```
 
+> **Note:** There is no `find` operator. Use `['at', ['filter', array, predicate], 0]` instead.
+
 #### Conditional
 
 ```typescript
-{ $if: [condition, thenValue, elseValue] }
+// Case expression (if-else chain) - each condition-value pair is a tuple
+['case',
+  [condition1, value1],
+  [condition2, value2],
+  defaultValue
+]
+
+// Example: return 'large', 'medium', or 'small' based on total
+['case',
+  [['>', ['get', 'derived.total'], 100], 'large'],
+  [['>', ['get', 'derived.total'], 50], 'medium'],
+  'small'
+]
+
+// Match expression (pattern matching)
+['match', value,
+  [pattern1, result1],
+  [pattern2, result2],
+  defaultResult
+]
+
+// Coalesce (first non-null value)
+['coalesce', value1, value2, value3]
 ```
 
-#### Path Reference
+#### Object Operations
+
+```typescript
+['pick', object, ['key1', 'key2']]   // Pick specific keys
+['omit', object, ['key1', 'key2']]   // Omit specific keys
+```
+
+#### Examples
 
 ```typescript
-{ $get: 'data.user.name' }    // Get value at path
-'$item.price'                  // Current item in iteration
-'$index'                       // Current index in iteration
+// Filter active todos
+['filter', ['get', 'data.items'], ['!', '$.completed']]
+
+// Count completed items
+['length', ['filter', ['get', 'data.items'], '$.completed']]
+
+// Find first item by id (no find operator, use filter + at)
+['at', ['filter', ['get', 'data.items'], ['==', '$.id', ['get', 'input.id']]], 0]
+
+// Concatenate first and last name
+['concat', ['get', 'data.firstName'], ' ', ['get', 'data.lastName']]
+
+// Conditional value (each condition-value pair is a tuple)
+['case',
+  [['>', ['get', 'derived.total'], 100], 'large'],
+  [['>', ['get', 'derived.total'], 50], 'medium'],
+  'small'
+]
 ```
 
+#### Known Limitations
+
+1. **No object literal construction**: You cannot create new objects with dynamic values directly in expressions.
+   ```typescript
+   // ❌ This does NOT work
+   ['concat', ['get', 'data.items'], [{ id: ['get', 'input.id'], name: 'New' }]]
+
+   // ✅ Use pick/omit for existing objects, or handle in effect handlers
+   ['pick', '$', ['id', 'name']]
+   ```
+
+2. **No empty object literal**: `{}` is not a valid expression. Use `['coalesce']` or handle in application code.
+
+3. **No `find` operator**: Use `['at', ['filter', array, predicate], 0]` instead.
+
 ### Effect System
 
 Effects describe side effects as data.
@@ -295,7 +427,7 @@ Effects describe side effects as data.
 ```typescript
 // Set a value
 setValue('data.count', 10)
-setValue('data.count', { $add: [{ $get: 'data.count' }, 1] })
+setValue('data.count', ['+', ['get', 'data.count'], 1])
 
 // Set state
 setState('state.isLoading', true)
@@ -304,7 +436,7 @@ setState('state.isLoading', true)
 apiCall({
   method: 'POST',
   url: '/api/orders',
-  body: { $get: 'data.order' },
+  body: ['get', 'data.order'],
   headers: { 'Content-Type': 'application/json' }
 })
 
@@ -336,7 +468,7 @@ parallel([
 
 // Conditional execution
 conditional(
-  { $get: 'state.isPremium' },
+  ['get', 'state.isPremium'],
   apiCall({ method: 'GET', url: '/api/premium' }),
   apiCall({ method: 'GET', url: '/api/basic' })
 )
@@ -344,7 +476,7 @@ conditional(
 // Error handling
 catchEffect(
   apiCall({ method: 'POST', url: '/api/submit' }),
-  setState('state.error', { $get: 'error.message' })
+  setState('state.error', ['get', 'error.message'])
 )
 ```
 

package/dist/domain/define.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../../src/domain/define.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AACnC,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,kBAAkB,EACnB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,mBAAmB,CAAC,KAAK,EAAE,MAAM,IAAI;IAC/C,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAC3B,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC3C,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EACxC,OAAO,EAAE,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,GAC1C,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,CAgBhC;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,QAAQ,EAAE,YAAY,CAAC;CACxB,CAAC;AAEF,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,gBAAgB,CAW3E;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,YAAY,EAAE,CAAC;IACrB,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,YAAY,CAAC;CACxB,CAAC;AAEF,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,iBAAiB,CAU9E;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,YAAY,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,UAAU,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,YAAY,CAAC;IACzB,WAAW,EAAE,YAAY,CAAC;IAC1B,SAAS,EAAE,YAAY,CAAC;IACxB,QAAQ,EAAE,YAAY,CAAC;CACxB,CAAC;AAEF,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,eAAe,CAexE;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,YAAY,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,YAAY,EAAE,CAAC;IAC/B,QAAQ,EAAE,kBAAkB,CAAC;CAC9B,CAAC;AAEF,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,gBAAgB,CAc3E;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE;IACnC,YAAY,CAAC,EAAE,YAAY,EAAE,CAAC;IAC9B,YAAY,CAAC,EAAE,YAAY,EAAE,CAAC;IAC9B,YAAY,CAAC,EAAE,YAAY,EAAE,CAAC;CAC/B,GAAG,WAAW,CAEd;AAED;;GAEG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,YAAY,EAClB,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACvD,YAAY,CAMd"}
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../../src/domain/define.ts"],"names":[],"mappings":"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"}

package/dist/domain/define.js

@@ -1,3 +1,17 @@
+/**
+ * Adds namespace prefix to keys if not already present.
+ * Supports nested paths (e.g., 'user.name' → 'data.user.name').
+ */
+function prefixKeys(record, prefix) {
+    if (!record)
+        return {};
+    const result = {};
+    for (const [key, value] of Object.entries(record)) {
+        const prefixedKey = key.startsWith(`${prefix}.`) ? key : `${prefix}.${key}`;
+        result[prefixedKey] = value;
+    }
+    return result;
+}
 /**
  * 도메인 정의 헬퍼 함수
  */
@@ -10,9 +24,9 @@ export function defineDomain(options) {
         stateSchema: options.stateSchema,
         initialState: options.initialState,
         paths: {
-            sources: options.paths?.sources ?? {},
-            derived: options.paths?.derived ?? {},
-            async: options.paths?.async ?? {},
+            sources: prefixKeys(options.paths?.sources, 'data'),
+            derived: prefixKeys(options.paths?.derived, 'derived'),
+            async: prefixKeys(options.paths?.async, 'async'),
         },
         actions: options.actions ?? {},
         meta: options.meta,

package/dist/domain/define.js.map

@@ -1 +1 @@
-{"version":3,"file":"define.js","sourceRoot":"","sources":["../../src/domain/define.ts"],"names":[],"mappings":"AAiCA;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,OAA2C;IAE3C,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,KAAK,EAAE;YACL,OAAO,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,IAAI,EAAE;YACrC,OAAO,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,IAAI,EAAE;YACrC,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,KAAK,IAAI,EAAE;SAClC;QACD,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;QAC9B,IAAI,EAAE,OAAO,CAAC,IAAI;KACnB,CAAC;AACJ,CAAC;AAYD,MAAM,UAAU,YAAY,CAAC,OAA4B;IACvD,OAAO;QACL,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,QAAQ,EAAE;YACR,QAAQ,EAAE,IAAI;YACd,QAAQ,EAAE,IAAI;YACd,GAAG,OAAO,CAAC,QAAQ;SACpB;KACF,CAAC;AACJ,CAAC;AAWD,MAAM,UAAU,aAAa,CAAC,OAA6B;IACzD,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,QAAQ,EAAE;YACR,QAAQ,EAAE,IAAI;YACd,QAAQ,EAAE,KAAK;YACf,GAAG,OAAO,CAAC,QAAQ;SACpB;KACF,CAAC;AACJ,CAAC;AAgBD,MAAM,UAAU,WAAW,CAAC,OAA2B;IACrD,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,QAAQ,EAAE;YACR,QAAQ,EAAE,IAAI;YACd,QAAQ,EAAE,KAAK;YACf,GAAG,OAAO,CAAC,QAAQ;SACpB;KACF,CAAC;AACJ,CAAC;AAaD,MAAM,UAAU,YAAY,CAAC,OAA4B;IACvD,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,QAAQ,EAAE;YACR,QAAQ,EAAE,IAAI;YACd,QAAQ,EAAE,KAAK;YACf,IAAI,EAAE,MAAM;YACZ,UAAU,EAAE,KAAK;YACjB,GAAG,OAAO,CAAC,QAAQ;SACpB;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,OAI3B;IACC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CACvB,IAAkB,EAClB,OAAwD;IAExD,OAAO;QACL,IAAI;QACJ,MAAM,EAAE,OAAO,EAAE,MAAM,IAAI,MAAM;QACjC,MAAM,EAAE,OAAO,EAAE,MAAM;KACxB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"define.js","sourceRoot":"","sources":["../../src/domain/define.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@manifesto-ai/core",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "AI Native Semantic Layer for SaaS Business Logic",
   "type": "module",
   "main": "./dist/index.js",
@@ -17,14 +17,6 @@
     "README.md",
     "LICENSE"
   ],
-  "scripts": {
-    "build": "tsc",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage",
-    "typecheck": "tsc --noEmit",
-    "clean": "rm -rf dist"
-  },
   "keywords": [
     "manifesto",
     "ai",
@@ -54,5 +46,13 @@
     "@vitest/coverage-v8": "^2.1.9",
     "typescript": "^5.7.2",
     "vitest": "^2.1.9"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
   }
-}
+}