@loom-framework/core 0.1.0-alpha.16 → 0.1.0-alpha.161

package/builtin-skills/loom/references/data-model.md

@@ -0,0 +1,191 @@
+# Data Model Reference
+
+Advanced configuration for `loom.config.ts`. Full type definitions from `packages/core/src/types.ts`.
+
+## FieldDefinition
+
+```typescript
+{
+  name: 'status',         // ^[a-zA-Z_][a-zA-Z0-9_]*$
+  type: 'string',         // 'string' | 'number' | 'boolean' | 'date' | 'string[]' | 'number[]' | 'json'
+  required: true,         // optional, default false
+  description: { 'zh-CN': '状态', 'en-US': 'Status' },  // optional: LocaleString, shown in generated forms
+  default: 'active',      // optional: auto-filled on write if not provided
+  enum: ['active', 'inactive', 'archived'],  // optional: restrict string field to allowed values (storage values)
+  enumLabels: {            // optional: display labels per locale for each enum value
+    active: { 'zh-CN': '激活', 'en-US': 'Active' },
+    inactive: { 'zh-CN': '停用', 'en-US': 'Inactive' },
+    archived: { 'zh-CN': '归档', 'en-US': 'Archived' },
+  },
+}
+```
+
+## ModelSchema
+
+```typescript
+{
+  name: 'orders',              // ^[a-zA-Z][a-zA-Z0-9_]*$, will be used as React component name
+  description: { 'zh-CN': '订单记录', 'en-US': 'Order Records' },  // optional: LocaleString, shown in page heading
+  fields: [...],
+  indexes?: [{ fields: ['userId', 'status'], unique: false }],
+  adapters?: {                  // optional: per-model adapter override
+    filesystem: { dir: 'orders', format: 'json' | 'yaml', datePattern: 'YYYY-MM' },  // datePattern: date-partitioned sub-directories using the model's first date field
+    sqlite: { table: 'orders' },
+  },
+  crud?: {                      // optional: control CRUD page features (all default to true when omitted)
+    batch: true,                // optional: enable batch selection and batch delete
+    export: true,               // optional: enable CSV export button
+    import: true,               // optional: enable CSV import button
+    deleteWithUndo: true,       // optional: delete-with-undo instead of confirm dialog; set false to use confirm dialog
+  },
+}
+```
+
+## AIButtonConfig
+
+```typescript
+aiButtons: [{
+  id: 'summarize',          // required: unique identifier
+  label: { 'zh-CN': '总结', 'en-US': 'Summarize' },  // required: LocaleString, button text
+  icon: 'FileTextOutlined', // optional: Ant Design icon component name
+  prompt: '请总结以下内容',   // required: supports {{var}} placeholders, replaced with current row field values
+  placement: 'wrong_questions',  // optional: limit to specific model pages, comma-separated; omit for all pages
+}]
+```
+
+## AIConfig
+
+```typescript
+ai: {
+  engine: 'claude-code',       // default 'claude-code'
+  claudeCode: {
+    path: '/usr/local/bin/claude',  // optional: custom claude binary path
+    pluginRoot: '.claude',          // optional: plugin root directory
+    timeout: 120000,                // optional: command timeout in ms
+    skipPermissions: false,         // optional: skip permission prompts (default: true in headless mode — Claude Code runs without interactive terminal, so permissions are skipped unless explicitly set to false)
+    models: [                       // optional: available AI models
+      {
+        name: 'GLM-5.1',           // required: model name, passed to --model flag
+        authToken: 'sk-xxx',       // optional: ANTHROPIC_AUTH_TOKEN, passed via --settings
+        baseUrl: 'https://api.example.com',  // optional: ANTHROPIC_BASE_URL, passed via --settings
+        isDefault: true,           // optional: default model for new chats
+      },
+    ],
+  },
+}
+```
+
+Models can be managed via the Model Management page (System Settings → Model Management) or by editing `loom.config.ts` directly. On `loom init`, the default model is auto-detected from `~/.claude/settings.json` (ANTHROPIC_MODEL, ANTHROPIC_AUTH_TOKEN, ANTHROPIC_BASE_URL).
+
+## ServerConfig
+
+```typescript
+server: {
+  port: 3000,              // default 3000
+  host: '0.0.0.0',
+  cors: true,              // default true
+  staticDir: './dist/frontend',
+}
+```
+
+## DataConfig
+
+```typescript
+data: {
+  defaultAdapter: 'filesystem' | 'sqlite',
+  models: [...],
+  sqlite: { filename: 'loom.db' },  // optional, default 'loom.db'
+}
+```
+
+## UIConfig
+
+```typescript
+ui: {
+  theme: {                       // optional: theme configuration
+    defaultMode: 'light',        // optional: 'light' | 'dark', default 'light'
+    token: { colorPrimary: '#1677ff' },  // optional: Ant Design token overrides
+  },
+  siderCollapsed: false,         // optional: sidebar collapsed by default on desktop
+  showHeader: true,              // optional: show header bar (breadcrumbs + theme toggle)
+  locale: 'zh-CN',              // optional: 'zh-CN' | 'en-US', default 'zh-CN'
+}
+```
+
+## RelationConfig
+
+```typescript
+relations: [{
+  name: 'question_reviews',            // required: unique relation identifier
+  label: { 'zh-CN': '复习记录', 'en-US': 'Review Records' },  // optional: LocaleString
+  from: 'wrong_questions',             // required: source model name
+  to: 'review_plans',                  // required: target model name
+  foreignKey: 'questionId',            // required: foreign key field in target model
+  type: 'hasMany',                     // required: 'hasOne' | 'hasMany' | 'manyToMany'
+  through: 'enrollments',              // optional: pivot model for manyToMany
+}]
+```
+
+Relations are displayed in the detail drawer of generated CRUD pages. `hasMany` and `manyToMany` relations show as a nested table.
+
+## DashboardConfig
+
+```typescript
+dashboards: [{
+  name: 'overview',           // ^[a-zA-Z][a-zA-Z0-9_]*$, same naming rules as model
+  description: { 'zh-CN': '数据概览', 'en-US': 'Overview' },  // optional: LocaleString, shown in sidebar
+  models: ['items'],          // required: data models included in this dashboard
+  defaultDateField: 'createdAt',  // optional: default date field for date range filtering across all widgets
+  filterDimensions: [             // optional: filter bar dimensions for interactive filtering (select only; use defaultDateField for date range)
+    {
+      field: 'status',            // required: field name to filter on
+      label: { 'zh-CN': '状态', 'en-US': 'Status' },  // required: LocaleString
+      type: 'select',             // required: 'select' (only type currently supported)
+      options: ['active', 'inactive'],  // optional: for 'select' type, auto-derived from data if omitted
+    },
+  ],
+  layout: [{                  // required: at least one row
+    row: [{                   // at least one widget per row
+      type: 'stat' | 'pie' | 'ring' | 'bar' | 'line' | 'area' | 'scatter' | 'radar' | 'funnel' | 'treemap' | 'gauge' | 'liquid' | 'heatmap' | 'stacked_bar' | 'grouped_bar',
+      title: { 'zh-CN': '任务总数', 'en-US': 'Total Tasks' },  // required: LocaleString, display title
+      model: 'items',         // required: data model name
+      span: 6,                // optional: Ant Design Grid Col span (1-24), auto-equal-split if omitted
+      groupBy: 'status',      // optional: group by field for aggregation
+      crossGroupBy: 'priority', // optional: second group-by for 2D charts (heatmap, stacked_bar, grouped_bar)
+      aggregate: 'count',     // optional: 'count' | 'sum' | 'avg' | 'min' | 'max' | 'ratio', default count
+      field: 'score',         // optional: numeric field for sum/avg/min/max
+      filter: { status: 'active' }, // optional: pre-aggregation filter
+      interval: 'month',      // optional: 'day' | 'week' | 'month' for date groupBy
+      dateField: 'createdAt', // optional: per-widget date field override (falls back to dashboard.defaultDateField)
+    }],
+  }],
+}]
+```
+
+## useSchema Runtime API
+
+Generated pages use `useSchema(model)` to fetch model schema and AI buttons at runtime. Schema is auto-resolved by current locale:
+
+```typescript
+const { schema, loading, error } = useSchema('items');
+// schema.fields — field definitions with resolved LocaleString (e.g. description is string, not LocaleString)
+// schema.fields[].enumLabels — resolved to { [enumValue]: displayLabel } for current locale
+// schema.aiButtons — AI buttons filtered by placement, label resolved to current locale
+
+// Convert schema enum to antd formats (uses resolved enumLabels):
+filterOptions(schema, 'status')  // → [{ text: '激活', value: 'active' }, ...]
+selectOptions(schema, 'status')  // → [{ label: '激活', value: 'active' }, ...]
+
+// Get display label for a single enum value:
+enumLabel(schema, 'status', 'active')  // → '激活'
+```
+
+## LocaleString
+
+All user-facing string fields support `LocaleString` format: `string | Record<string, string>`.
+
+- **Simple**: `description: '科目'` — same text for all locales
+- **Multi-locale**: `description: { 'zh-CN': '科目', 'en-US': 'Subject' }` — auto-translated on locale switch
+- **Fallback**: requested locale → `'zh-CN'` → first available value
+
+Supported fields: `project.description`, `ModelSchema.description`, `FieldDefinition.description`, `AIButtonConfig.label`, `DashboardConfig.description`, `DashboardWidget.title`, `RelationConfig.label`, `DashboardFilterDimension.label`

package/builtin-skills/yuque-reader/SKILL.md

@@ -0,0 +1,43 @@
+---
+name: yuque-reader
+description: "Read and extract content from Yuque (语雀) documents."
+---
+
+# Yuque Reader
+
+## Overview
+
+Fetch content from Yuque documents via the internal SDL API. Returns document data including title, content, and metadata as JSON.
+
+## Reading Documents
+
+### Using the bundled script
+
+Execute the fetch script for direct document retrieval:
+
+```bash
+# Fetch and display document
+python3 scripts/fetch_doc.py <yuque_url>
+
+# Save to file
+python3 scripts/fetch_doc.py <yuque_url> --output document.json
+
+# Use token argument instead of environment variable
+python3 scripts/fetch_doc.py <yuque_url> --token your_token_here
+```
+
+### Large content handling
+
+When document content exceeds 20,000 characters, ALWAYS write the content to `/tmp/<sanitized_title>.txt` instead of displaying in the response. The filename should use a sanitized version of the document title (replace spaces with underscores, remove special characters).
+
+When working with large saved files, use the Read tool with `offset` and `limit` parameters to read portions incrementally. This prevents flooding the context window and allows focused analysis of specific sections. Example: read first 100 lines to understand structure, then read relevant sections as needed.
+
+## Authentication setup
+
+See [references/config.md](references/config.md) for SDL_TOKEN configuration and API details.
+
+## Resources
+
+### scripts/fetch_doc.py
+
+Python script for fetching Yuque documents directly. Can be executed standalone or called from within other scripts.

package/builtin-skills/yuque-reader/references/config.md

@@ -0,0 +1,52 @@
+# Yuque Reader Configuration
+
+## Authentication
+
+Requires `SDL_TOKEN` environment variable for API authentication. This token must be provisioned through the internal SDL platform.
+
+API endpoint: `https://sdl.alipay.com/api/doc/getDocInfo.json`
+
+### Setting SDL_TOKEN
+
+Set token in environment (temporary, only for current session):
+```bash
+export SDL_TOKEN=your_token_here
+```
+
+Set token permanently (recommended):
+```bash
+# For macOS/Linux with zsh (default on macOS):
+echo 'export SDL_TOKEN=your_token_here' >> ~/.zshrc
+source ~/.zshrc
+
+# For macOS/Linux with bash:
+echo 'export SDL_TOKEN=your_token_here' >> ~/.bash_profile
+source ~/.bash_profile
+
+# Or manually edit the shell config file and add:
+# export SDL_TOKEN=your_token_here
+```
+
+## API Request Format
+
+```json
+{
+  "url": "<yuque_document_url>",
+  "containContent": true,
+  "fromPlatform": "YUQUE"
+}
+```
+
+## Response Format
+
+```json
+{
+  "success": true,
+  "data": {
+    "title": "Document Title",
+    "content": "Document content text...",
+    "url": "https://yuque.com/...",
+    "...": "additional metadata"
+  }
+}
+```

package/builtin-skills/yuque-reader/scripts/fetch_doc.py

@@ -0,0 +1,121 @@
+#!/usr/bin/env python3
+"""
+Yuque Document Fetcher
+
+Fetch Yuque document content via API. This script can be executed directly
+and provides a simple interface for retrieving Yuque documents.
+
+Usage:
+    python fetch_doc.py <yuque_url> --token <api_token>
+
+Environment:
+    Set SDL_TOKEN environment variable or use --token argument.
+"""
+
+import os
+import sys
+import json
+import re
+import random
+import requests
+from argparse import ArgumentParser
+
+
+def sanitize_filename(title: str) -> str:
+    """Sanitize document title for use as filename.
+
+    Args:
+        title: Document title
+
+    Returns:
+        Sanitized filename (safe for filesystem)
+    """
+    # Replace spaces with underscores, remove/special characters
+    sanitized = re.sub(r'[^\w\-_.]', '_', title)
+    sanitized = re.sub(r'_+', '_', sanitized).strip('_')
+    return sanitized if sanitized else 'document'
+
+
+def fetch_yuque_doc(url: str, token: str) -> dict:
+    """Fetch Yuque document content.
+
+    Args:
+        url: Yuque document URL
+        token: API token for authentication
+
+    Returns:
+        Document data as dictionary
+    """
+    headers = {
+        "Authorization": f"Bearer {token}",
+        "Content-Type": "application/json"
+    }
+
+    payload = {
+        "url": url,
+        "containContent": True,
+        "fromPlatform": "YUQUE"
+    }
+
+    # Note: This uses the internal SDL API endpoint
+    api_url = "https://sdl.alipay.com/api/doc/getDocInfo.json"
+
+    response = requests.post(api_url, headers=headers, json=payload)
+    response.raise_for_status()
+
+    data = response.json()
+    if data.get("success"):
+        return data.get("data", {})
+    else:
+        raise Exception(f"API error: {data.get('message', 'Unknown error')}")
+
+
+def main():
+    parser = ArgumentParser(description="Fetch Yuque document content")
+    parser.add_argument("url", help="Yuque document URL")
+    parser.add_argument("--token", "-t", help="API token (default: SDL_TOKEN env var)")
+    parser.add_argument("--output", "-o", help="Output file path (default: stdout)")
+
+    args = parser.parse_args()
+
+    # Get token from argument or environment
+    token = args.token or os.getenv("SDL_TOKEN")
+    if not token:
+        print("Error: SDL_TOKEN environment variable or --token argument required", file=sys.stderr)
+        sys.exit(1)
+
+    try:
+        data = fetch_yuque_doc(args.url, token)
+        content = data.get("content", "")
+        title = data.get("title", "Document")
+        result = json.dumps(data, ensure_ascii=False, indent=2)
+
+        if args.output:
+            # User specified output - use it directly
+            with open(args.output, "w", encoding="utf-8") as f:
+                f.write(result)
+            print(f"Document saved to {args.output}")
+        elif len(content) > 20000:
+            # Large content: write only the content to /tmp
+            sanitized_title = sanitize_filename(title)
+            if title == "Document":
+                # Add random number when title is default fallback
+                sanitized_title = f"{sanitized_title}_{random.randint(1000, 9999)}"
+            output_path = f"/tmp/{sanitized_title}.txt"
+            with open(output_path, "w", encoding="utf-8") as f:
+                f.write(content)
+            print(f"Content too large ({len(content)} chars), saved to {output_path}")
+            # Print metadata without full content
+            metadata = {k: v for k, v in data.items() if k != "content"}
+            print(json.dumps(metadata, ensure_ascii=False, indent=2))
+        else:
+            # Normal output
+            print(result)
+
+    except Exception as e:
+        print(f"Error: {e}", file=sys.stderr)
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

package/dist/adapter-base.d.ts

@@ -0,0 +1,31 @@
+/**
+ * BaseAdapter - Shared logic for DataAdapter implementations
+ *
+ * Extracts common validation, ID generation, and schema management
+ * used by both FileSystemAdapter and SQLiteAdapter.
+ */
+import type { DataAdapter, DataRecord, ModelSchema, LoomConfig } from './types.js';
+export declare abstract class BaseAdapter implements DataAdapter {
+    abstract readonly name: string;
+    protected schemas: Map<string, ModelSchema>;
+    protected config: LoomConfig;
+    constructor(config: LoomConfig);
+    abstract initialize(): Promise<void>;
+    abstract healthCheck(): Promise<boolean>;
+    abstract read(model: string, options?: import('./types.js').ReadOptions): Promise<DataRecord | DataRecord[] | null>;
+    abstract write(model: string, data: DataRecord): Promise<DataRecord>;
+    abstract update(model: string, id: string, data: DataRecord): Promise<DataRecord>;
+    abstract delete(model: string, id: string): Promise<void>;
+    /** Default count() — delegates to read(), overridden by adapters for efficiency */
+    count(model: string, options?: Omit<import('./types.js').ReadOptions, 'limit' | 'offset' | 'sort'>): Promise<number>;
+    getSchema(model: string): Promise<ModelSchema | undefined>;
+    listModels(): Promise<string[]>;
+    protected requireModel(model: string): void;
+    protected generateId(): string;
+    /**
+     * Validate required fields and apply defaults on a record.
+     * Returns the validated record with defaults applied.
+     */
+    protected validateAndApplyDefaults(model: string, record: DataRecord, skipIdValidation?: boolean): DataRecord;
+}
+//# sourceMappingURL=adapter-base.d.ts.map

package/dist/adapter-base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-base.d.ts","sourceRoot":"","sources":["../src/adapter-base.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEnF,8BAAsB,WAAY,YAAW,WAAW;IACtD,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAa;IACxD,SAAS,CAAC,MAAM,EAAE,UAAU,CAAC;gBAEjB,MAAM,EAAE,UAAU;IAO9B,QAAQ,CAAC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IACpC,QAAQ,CAAC,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IACxC,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,YAAY,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,GAAG,UAAU,EAAE,GAAG,IAAI,CAAC;IACnH,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACpE,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACjF,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAEzD,mFAAmF;IAC7E,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,OAAO,YAAY,EAAE,WAAW,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAMpH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAI1D,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAMrC,SAAS,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAQ3C,SAAS,CAAC,UAAU,IAAI,MAAM;IAM9B;;;OAGG;IACH,SAAS,CAAC,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,gBAAgB,UAAQ,GAAG,UAAU;CA2B5G"}

package/dist/adapter-base.js

@@ -0,0 +1,69 @@
+/**
+ * BaseAdapter - Shared logic for DataAdapter implementations
+ *
+ * Extracts common validation, ID generation, and schema management
+ * used by both FileSystemAdapter and SQLiteAdapter.
+ */
+export class BaseAdapter {
+    schemas = new Map();
+    config;
+    constructor(config) {
+        this.config = config;
+        for (const model of config.data.models) {
+            this.schemas.set(model.name, model);
+        }
+    }
+    /** Default count() — delegates to read(), overridden by adapters for efficiency */
+    async count(model, options) {
+        const result = await this.read(model, { filter: options?.filter, id: options?.id });
+        if (Array.isArray(result))
+            return result.length;
+        return result ? 1 : 0;
+    }
+    async getSchema(model) {
+        return this.schemas.get(model);
+    }
+    async listModels() {
+        return Array.from(this.schemas.keys());
+    }
+    // ── Shared Helpers ──
+    requireModel(model) {
+        if (!this.schemas.has(model)) {
+            throw new Error(`Unknown model: ${model}. Available: ${Array.from(this.schemas.keys()).join(', ')}`);
+        }
+    }
+    generateId() {
+        const timestamp = Date.now().toString(36);
+        const random = Math.random().toString(36).substring(2, 10);
+        return `rec_${timestamp}_${random}`;
+    }
+    /**
+     * Validate required fields and apply defaults on a record.
+     * Returns the validated record with defaults applied.
+     */
+    validateAndApplyDefaults(model, record, skipIdValidation = false) {
+        const schema = this.schemas.get(model);
+        // Apply default values for missing fields
+        for (const field of schema.fields) {
+            if (record[field.name] === undefined && field.default !== undefined) {
+                record[field.name] = field.default;
+            }
+        }
+        // Validate required fields
+        for (const field of schema.fields) {
+            if (skipIdValidation && field.name === 'id')
+                continue;
+            if (field.required && record[field.name] === undefined) {
+                throw new Error(`Missing required field: ${field.name}`);
+            }
+        }
+        // Validate enum constraints
+        for (const field of schema.fields) {
+            if (field.enum && record[field.name] !== undefined && !field.enum.includes(record[field.name])) {
+                throw new Error(`Invalid value for field '${field.name}': ${record[field.name]}. Allowed values: ${field.enum.join(', ')}`);
+            }
+        }
+        return record;
+    }
+}
+//# sourceMappingURL=adapter-base.js.map

package/dist/adapter-base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-base.js","sourceRoot":"","sources":["../src/adapter-base.ts"],"names":[],"mappings":"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"}

package/dist/adapter-factory.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Adapter Factory
+ *
+ * Creates the appropriate DataAdapter based on LoomConfig.data.defaultAdapter.
+ */
+import type { LoomConfig, DataAdapter } from './types.js';
+export declare function createAdapter(config: LoomConfig, projectRoot: string): DataAdapter;
+//# sourceMappingURL=adapter-factory.d.ts.map

package/dist/adapter-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-factory.d.ts","sourceRoot":"","sources":["../src/adapter-factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE1D,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,WAAW,CAgBlF"}

package/dist/adapter-factory.js

@@ -0,0 +1,25 @@
+/**
+ * Adapter Factory
+ *
+ * Creates the appropriate DataAdapter based on LoomConfig.data.defaultAdapter.
+ */
+import path from 'path';
+import { FileSystemAdapter } from './adapter-filesystem.js';
+import { SQLiteAdapter } from './adapter-sqlite.js';
+export function createAdapter(config, projectRoot) {
+    const adapterType = config.data.defaultAdapter || 'filesystem';
+    switch (adapterType) {
+        case 'sqlite':
+            return new SQLiteAdapter({
+                dbPath: path.join(projectRoot, 'data', config.data.sqlite?.filename ?? 'loom.db'),
+                config,
+            });
+        case 'filesystem':
+        default:
+            return new FileSystemAdapter({
+                dataDir: path.join(projectRoot, 'data'),
+                config,
+            });
+    }
+}
+//# sourceMappingURL=adapter-factory.js.map

package/dist/adapter-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-factory.js","sourceRoot":"","sources":["../src/adapter-factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,MAAM,UAAU,aAAa,CAAC,MAAkB,EAAE,WAAmB;IACnE,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,cAAc,IAAI,YAAY,CAAC;IAE/D,QAAQ,WAAW,EAAE,CAAC;QACpB,KAAK,QAAQ;YACX,OAAO,IAAI,aAAa,CAAC;gBACvB,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,IAAI,SAAS,CAAC;gBACjF,MAAM;aACP,CAAC,CAAC;QACL,KAAK,YAAY,CAAC;QAClB;YACE,OAAO,IAAI,iBAAiB,CAAC;gBAC3B,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC;gBACvC,MAAM;aACP,CAAC,CAAC;IACP,CAAC;AACH,CAAC"}

package/dist/adapter-filesystem.d.ts

@@ -3,30 +3,44 @@
  *
  * Stores data as JSON files, organized by model.
  * Default adapter for development and small deployments.
+ * Supports date-pattern sub-directories (e.g. 'YYYY-MM') for time-partitioned data.
  */
-import type { DataAdapter, ModelSchema, ReadOptions, LoomConfig } from './types.js';
+import type { DataRecord, ReadOptions, LoomConfig } from './types.js';
+import { BaseAdapter } from './adapter-base.js';
 export interface FileSystemAdapterOptions {
     dataDir: string;
     config: LoomConfig;
 }
-export declare class FileSystemAdapter implements DataAdapter {
+export declare class FileSystemAdapter extends BaseAdapter {
     readonly name = "filesystem";
     private dataDir;
-    private config;
-    private schemas;
     constructor(options: FileSystemAdapterOptions);
     initialize(): Promise<void>;
     healthCheck(): Promise<boolean>;
-    read(model: string, options?: ReadOptions): Promise<unknown>;
-    write(model: string, data: Record<string, unknown>): Promise<unknown>;
-    update(model: string, id: string, data: Record<string, unknown>): Promise<unknown>;
+    read(model: string, options?: ReadOptions): Promise<DataRecord | DataRecord[] | null>;
+    write(model: string, data: DataRecord): Promise<DataRecord>;
+    update(model: string, id: string, data: DataRecord): Promise<DataRecord>;
     delete(model: string, id: string): Promise<void>;
-    getSchema(model: string): Promise<ModelSchema | undefined>;
-    listModels(): Promise<string[]>;
-    private requireModel;
+    count(model: string, options?: Omit<ReadOptions, 'limit' | 'offset' | 'sort'>): Promise<number>;
     private getModelDir;
+    /** Get datePattern for a model, if configured */
+    private getDatePattern;
+    /**
+     * Get record file path.
+     * When datePattern is set, records are stored in date-partitioned sub-directories.
+     * The date is derived from the first date field in the record data.
+     */
     private getRecordPath;
+    /**
+     * Find a record's actual file path by searching date-partitioned sub-directories.
+     * Returns null if not found.
+     */
+    private findRecordPath;
+    /**
+     * Collect all .json file paths from a directory.
+     * When recursive is true, also scans immediate sub-directories (for date-partitioned data).
+     */
+    private collectJsonFiles;
     private matchesFilter;
-    private generateId;
 }
 //# sourceMappingURL=adapter-filesystem.d.ts.map

package/dist/adapter-filesystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter-filesystem.d.ts","sourceRoot":"","sources":["../src/adapter-filesystem.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEpF,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,qBAAa,iBAAkB,YAAW,WAAW;IACnD,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,OAAO,CAAuC;gBAE1C,OAAO,EAAE,wBAAwB;IAUvC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAU3B,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAS/B,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAmC5D,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAwBrE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAmBlF,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWhD,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAI1D,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAMrC,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,UAAU;CAMnB"}
+{"version":3,"file":"adapter-filesystem.d.ts","sourceRoot":"","sources":["../src/adapter-filesystem.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAsBhD,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,qBAAa,iBAAkB,SAAQ,WAAW;IAChD,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,wBAAwB;IAKvC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAU3B,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAS/B,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,GAAG,UAAU,EAAE,GAAG,IAAI,CAAC;IAmErF,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAc3D,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAsBxE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAchD,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAyCrG,OAAO,CAAC,WAAW;IAOnB,iDAAiD;IACjD,OAAO,CAAC,cAAc;IAKtB;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAsBrB;;;OAGG;YACW,cAAc;IAiC5B;;;OAGG;YACW,gBAAgB;IA6B9B,OAAO,CAAC,aAAa;CAoBtB"}