@loom-framework/core 0.1.0-alpha.19 → 0.1.0-alpha.191

package/builtin-skills/loom/references/eject.md

@@ -0,0 +1,111 @@
+# System Page Eject — 定制化参考
+
+系统管理页面默认以 npm 组件形式接入 App.tsx，不支持直接修改。Eject 机制将页面输出为本地 .tsx 文件，切换 import 来源，使页面可自由定制。
+
+## 页面类型
+
+| type         | 组件名              | npmComponent              | 接线方式      | 说明                              |
+|--------------|---------------------|---------------------------|---------------|-----------------------------------|
+| model        | ModelManagement     | ModelManagementPage       | sidebar-nav   | 系统配置子菜单                    |
+| skill        | SkillManagement     | SkillManagementPage       | sidebar-nav   | 系统配置子菜单                    |
+| user         | UserManagement      | UserManagementPage        | sidebar-nav   | 自动接入 AuthProvider             |
+| login        | Login               | LoginPage                 | auth-fallback | AuthGuard 的 fallback，无导航入口 |
+| process      | ProcessManagement   | ProcessManagementPage     | sidebar-nav   | 系统配置子菜单                    |
+| notification | NotificationCenter  | NotificationCenterPage    | skip-nav      | 通知铃铛触发，无导航入口          |
+
+notification eject 时同时生成 NotificationCenter + NotificationDetail 两个文件。
+
+## 命令
+
+```bash
+# eject: npm 组件 → 本地文件（可编辑）
+loom eject system-settings <type>
+
+# uneject: 本地文件 → npm 组件（已修改需 --force）
+loom uneject system-settings <type> [--force]
+
+# 接入 App.tsx（npm import 接线，init 时自动执行）
+loom generate system-settings <type>
+```
+
+## Eject/Uneject 对 App.tsx 的影响
+
+### eject 前
+
+```tsx
+import { ModelManagementPage } from '@loom-framework/frontend-antd';
+// ...
+case 'model-management': return <ModelManagementPage />;
+```
+
+### eject 后
+
+```tsx
+import ModelManagementPage from './components/pages/ModelManagement';
+// ...
+case 'model-management': return <ModelManagementPage />;
+```
+
+本地文件出现在 `frontend/src/components/pages/<PascalName>.tsx`。
+
+### uneject 后
+
+本地文件删除，import 恢复为 npm 路径。
+
+## 定制化操作指南
+
+### 修改页面布局或样式
+
+1. 执行 `loom eject system-settings <type>`
+2. 编辑 `frontend/src/components/pages/` 下的 .tsx 文件
+3. 运行 `loom dev` 查看效果
+
+### 使用框架子组件
+
+eject 后的文件 import 来自 `@loom-framework/frontend-antd`，可直接使用框架子组件：
+
+```tsx
+import { ProcessTree, ProcessOverview, ProcessLogs, ProcessMetrics } from '@loom-framework/frontend-antd';
+```
+
+可用的 hook：`useData`, `useSchema`, `useLocale`, `useModels`, `useChartData`。
+
+### 替换子组件
+
+将 import 替换为自定义实现：
+
+```tsx
+// 替换前
+import { ProcessTree } from '@loom-framework/frontend-antd';
+// 替换后
+import { MyCustomTree } from './MyCustomTree';
+```
+
+### 添加自定义管理页面
+
+内置的 6 种系统页面 type（model/skill/user/login/process/notification）由框架预定义，用户无法新增 type。如需框架未提供的管理页面，根据场景选择：
+
+**数据驱动页面**（对应一个数据模型，需要增删改查）→ 在 `loom.config.ts` 中添加模型定义，然后 `loom generate page <Name> --model <model>` 生成 CRUD 页面 + API + 导航
+
+**纯 UI 页面**（不对应数据模型，如审批流程、配置向导）→ 手动创建 `frontend/src/components/pages/MyPage.tsx`，然后在 App.tsx 中添加 import、导航项和路由
+
+## 安全机制
+
+- eject 时自动保存校验和到 `.loom/checksums/`
+- uneject 时校验：未修改可直接删除，已修改需 `--force`
+- 所有操作前自动备份到 `.loom/backup/`
+
+## WiringMode 说明
+
+- **sidebar-nav**: 添加到系统配置子菜单，有导航入口、switch case、breadcrumb
+- **auth-fallback**: 作为 `<AuthGuard fallback={<Login />}>` 注入，无导航入口
+- **skip-nav**: 无导航入口（通过其他 UI 触发），但有 switch case 和 breadcrumb
+
+## 构建时模板生成
+
+模板文件由 `pnpm build` 自动从 `frontend-antd/src/` 源码生成到 `templates/`。不需要手动运行 `pnpm generate-templates`（build 已自动调用）。
+
+- import 路径自动从 relative 转换为 `@loom-framework/frontend-antd` barrel import
+- `validateBarrelExports()` 自动校验模板中所有 import 在 `frontend-antd/src/index.ts` 中存在，缺失导出会导致构建失败
+- `validateCompleteness()` 自动校验 `template-source-mappings.ts` 与 `SYSTEM_PAGE_CONFIG` 一致，不一致会报错退出
+- 模板文件头部含版本号：`GENERATED by scripts/generate-templates.ts — v0.1.0-alpha.166 — DO NOT EDIT MANUALLY`

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":"AAAA;;;;;GAKG;AAIH,MAAM,OAAgB,WAAW;IAErB,OAAO,GAA6B,IAAI,GAAG,EAAE,CAAC;IAC9C,MAAM,CAAa;IAE7B,YAAY,MAAkB;QAC5B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACvC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IASD,mFAAmF;IACnF,KAAK,CAAC,KAAK,CAAC,KAAa,EAAE,OAA6E;QACtG,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QACpF,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YAAE,OAAO,MAAM,CAAC,MAAM,CAAC;QAChD,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,KAAa;QAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,UAAU;QACd,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,uBAAuB;IAEb,YAAY,CAAC,KAAa;QAClC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CACb,kBAAkB,KAAK,gBAAgB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACpF,CAAC;QACJ,CAAC;IACH,CAAC;IAES,UAAU;QAClB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3D,OAAO,OAAO,SAAS,IAAI,MAAM,EAAE,CAAC;IACtC,CAAC;IAED;;;OAGG;IACO,wBAAwB,CAAC,KAAa,EAAE,MAAkB,EAAE,gBAAgB,GAAG,KAAK;QAC5F,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC;QAExC,0CAA0C;QAC1C,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClC,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;gBACpE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC;YACrC,CAAC;QACH,CAAC;QAED,2BAA2B;QAC3B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClC,IAAI,gBAAgB,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI;gBAAE,SAAS;YACtD,IAAI,KAAK,CAAC,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;gBACvD,MAAM,IAAI,KAAK,CAAC,2BAA2B,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YAC3D,CAAC;QACH,CAAC;QAED,4BAA4B;QAC5B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClC,IAAI,KAAK,CAAC,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAW,CAAC,EAAE,CAAC;gBACzG,MAAM,IAAI,KAAK,CAAC,4BAA4B,KAAK,CAAC,IAAI,MAAM,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,qBAAqB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC9H,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

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"}