modscape 0.9.1 → 1.0.0

package/README.ja.md

@@ -20,26 +20,25 @@
 
 ## 主な機能
 
-- **YAML-as-Code**: データアーキテクチャ全体を人間が読みやすい単一のYAMLファイルで定義。Gitによる変更管理が可能。
-- **ローカルYAMLの即時可視化**: Modscapeのスキーマに従ったYAMLファイルを指定するだけで、即座にビジュアライズ。データベース接続やクラウド設定は一切不要で、すぐにモデリング結果を確認できます。
-- **データ分析特化のモデリング**: `fact`, `dimension`, `hub`, `link`, `satellite` などのエンティティタイプを標準サポート。
-- **サンプルデータ「ストーリー」**: エンティティに現実的なサンプルデータを紐付け、データの背後にある「物語」を解説。
+- **YAML-as-Code**: データアーキテクチャ全体を単一のYAMLファイルで定義。Gitによる変更管理が可能。
+- **統合プロフェッショナル・エディタ**: **CodeMirror 6** を内蔵。シンタックスハイライト対応のエディタをサイドバーで直接利用可能。
+- **統合 Undo/Redo & オートセーブ**: 
+  - ビジュアル操作（ドラッグ、リサイズ、編集）がエディタの履歴と同期。 `Ctrl+Z` で直前の操作を元に戻せます。
+  - **オートセーブ**をONにすれば、キャンバス上の変更が即座にローカルファイルに反映されます。
+- **ダーク/ライトモード対応**: 利用環境やドキュメント作成の用途に合わせて、ワンクリックでテーマを切り替え可能。
+- **データ分析特化のモデリング**: `fact`, `dimension`, `mart`, `hub`, `link`, `satellite` などのエンティティタイプを標準サポート。
 - **インタラクティブなビジュアルキャンバス**: 
-  - **ドラッグで接続**: カラム間のリレーションを直感的に作成。
-  - **自動レイアウト永続化**: キャンバス上の配置は、即座に元のYAMLファイルの座標情報として保存。
-  - **ドメイン・グルーピング**: テーブルをビジネスドメインごとに整理。
+  - **ドラッグで接続**: カラム間のリレーションを直感的に作成。吸着（Snapping）機能で快適な操作感。
+  - **データリネージ・モード**: データの流れをアニメーション付きの点線矢印で可視化。
+  - **ドメイン階層ナビゲーション**: テーブルをビジネスドメインごとに整理し、構造化されたサイドバーから素早くアクセス。
 - **分析メタデータ**: 
   - **ファクトテーブル・タイプ**: `transaction`, `periodic`, `accumulating`, `factless` といったデータの性質を定義。
-  - **SCD（徐変ディメンション）管理**: `SCD Type 2` などの履歴管理方式を可視化。
-  - **加算規則（Additivity）**: カラムが合計可能か（`fully`, `semi`, `non`）を明示し、BI開発をガイド。
-  - **メタデータ/監査追跡**: 監査用カラムを専用アイコンで識別。
+  - **SCD管理**: `SCD Type 2` などの履歴管理方式を可視化。
+  - **加算規則（Additivity）**: カラムが合計可能か（`fully`, `semi`, `non`）を明示 (Σ アイコン)。
 - **AIエージェント対応**: **Gemini, Claude, Codex** 用の雛形を内蔵。LLMを活用してモデリング作業を劇的に加速。
-- **ドキュメント・エクスポート**: 社内WikiやGitHub/GitLab Pagesで利用可能な、Mermaid図入りのMarkdownを生成。
 
 ## インストール
 
-npm経由でグローバルにインストールします：
-
 ```bash
 npm install -g modscape
 ```
@@ -49,107 +48,51 @@ npm install -g modscape
 ## はじめに
 
 ### A: AI駆動のモデリング（推奨）
-Gemini CLI, Claude Code, Codex などのAIアシスタントを活用してモデルを構築します。
-
-1.  **初期化**: 使用するAIエージェントに合わせてモデリングルールと手順書を生成します。
+1.  **初期化**: 使用するAIエージェントに合わせてモデリングルールを生成します。
     ```bash
-    # Gemini CLI の場合
-    modscape init --gemini
-
-    # Claude Code の場合
-    modscape init --claude
-
-    # Codex の場合
-    modscape init --codex
+    modscape init --gemini  # または --claude, --codex
     ```
 2.  **起動**: ビジュアライザーを起動します。
     ```bash
     modscape dev model.yaml
     ```
-3.  **AIに指示**: AIエージェントにこう伝えてください： *" .modscape/rules.md のルールに従って、model.yaml に新しい 'Marketing' ドメインと 'campaign_performance' ファクトテーブルを追加して。"*
+3.  **AIに指示**: AIにこう伝えてください： *" .modscape/rules.md のルールに従って、model.yaml に新しい 'Marketing' ドメインを追加して。"*
 
 ### B: 手動モデリング
-詳細な設計コントロールを行いたい場合に最適です。
-
-1.  **YAML作成**: `model.yaml` ファイルを作成します（[YAMLリファレンス](#モデルの定義-yaml)を参照）。
+1.  **YAML作成**: `model.yaml` ファイルを作成します。
 2.  **起動**: ビジュアライザーを起動します。
     ```bash
     modscape dev model.yaml
     ```
-3.  **サンプルを試す**: 組み込みのパターンを確認できます：
-    ```bash
-    modscape dev samples/
-    ```
 
 ---
 
 ## モデルの定義 (YAML)
 
-Modscapeは、データ分析のコンテキストに最適化されたスキーマを採用しています。この単一のファイルが、論理および物理データアーキテクチャの「信頼できる唯一の情報源（SSOT）」として機能します。
-
 ```yaml
-# 1. Domains: 関連するテーブルをグループ化する視覚的なコンテナ
+# 1. Domains: 関連するテーブルをグループ化するコンテナ
 domains:
   - id: core_sales
     name: 主要売上
-    description: "ドメインの任意の説明"
-    color: "rgba(59, 130, 246, 0.05)" # コンテナの背景色
-    tables: [orders, products] # 所属するテーブルIDのリスト
+    color: "#3b82f6"
+    tables: [orders, products]
 
-# 2. Tables: マルチレイヤーのメタデータを持つエンティティ定義
+# 2. Tables: エンティティ定義
 tables:
   - id: orders
     name: ORDERS
     appearance:
-      type: fact    # fact | dimension | hub | link | satellite
-      # --- 分析メタデータ ---
-      sub_type: transaction # transaction | periodic | accumulating | factless
-      # (Dimension用SCDタイプ: type0 | type1 | type2 | type3 | type4 | type5 | type6 | type7)
-      icon: 📦      # カスタム絵文字や文字
-      color: "#f87171" # エンティティのテーマカラー
-    
-    conceptual:
-      description: "販売取引記録"
-      tags: ["WHO", "WHEN", "HOW MUCH"] # 粒度の識別子（BEAM*等）
-    
-    physical:
-      name: STG_ORDERS     # 実際のDBテーブル名
-      schema: ANALYTICS_DB # DBスキーマ/名前空間
-    
+      type: fact    # fact | dimension | mart | hub | link | satellite
+      sub_type: transaction
+      scd: type2
+      icon: 📦
     columns:
       - id: order_id
         logical:
           name: ORDER_ID
-          type: Int
-          description: "ユニークな識別子"
           isPrimaryKey: true
-          isForeignKey: false
-          isPartitionKey: false
-          # --- 分析メタデータ ---
-          isMetadata: false # 監査用カラム等に true を設定 (🕒 アイコン)
           additivity: fully # fully | semi | non (Σ アイコン)
-        physical:
-          name: O_ID
-          type: NUMBER(38,0)
-          constraints: ["NOT NULL"]
-      
-      - id: customer_id
-        logical: { name: CUSTOMER_ID, type: Int, isForeignKey: true }
-
-    # 3. Sample Data: データを通じたストーリーの提示
-    sampleData:
-      - [1001, 501]
-      - [1002, 502]
-
-# 4. Relationships: カラムレベルの接続
-relationships:
-  - from: { table: orders, column: customer_id }
-    to: { table: customers, column: id }
-    type: many-to-one # one-to-one | one-to-many | many-to-many
-
-# 5. Layout: 座標情報 (自動管理)
-layout:
-  orders: { x: 100, y: 100, width: 320, height: 400 }
+          isMetadata: false # 監査用カラム等 (🕒 アイコン)
 ```
 
 ---
@@ -157,39 +100,32 @@ layout:
 ## 使い方
 
 ### 開発モード (インタラクティブ)
-YAMLを編集し、エンティティを視覚的に配置します。
-
 ```bash
 modscape dev ./models
 ```
-- `http://localhost:5173` が開きます。
-- **永続化**: レイアウトやメタデータの変更は、直接ファイルに書き戻されます。
+- **永続化**: レイアウトやメタデータの変更は、直接ファイルに書き戻されます（オートセーブ対応）。
 
 ### ビルドモード (静的サイト)
-チーム共有用のスタンドアロンなドキュメントサイトを生成します。
-
 ```bash
 modscape build ./models -o docs-site
 ```
 
 ### エクスポートモード (Markdown)
-Mermaid図を含むMarkdownドキュメントを生成します。
-
 ```bash
 modscape export ./models -o docs/ARCHITECTURE.md
 ```
 
-## AIエージェントとの統合
-
-Modscapeは **AI-First** を掲げて設計されています。 `modscape init` を実行することで、 `.modscape/rules.md` を通じてAIエージェントと「契約」を結び、プロジェクト全体で一貫したモデリングパターン（命名規則、データ型など）を維持できます。
-
 ## クレジット
 
-Modscapeは以下のプロジェクトによって支えられています：
-- **React Flow**: インタラクティブなグラフエンジン。
-- **Lucide**: 一貫性のあるアイコンセット。
-- **Express**: ローカル開発サーバー。
-- **Commander**: CLIフレームワーク。
+Modscape は以下の素晴らしいオープンソースプロジェクトによって支えられています：
+
+- [React Flow](https://reactflow.dev/) - インタラクティブなグラフ UI フレームワーク。
+- [CodeMirror 6](https://codemirror.net/) - 次世代のウェブベース・コードエディタ。
+- [Lucide React](https://lucide.dev/) - シンプルで美しいアイコンセット。
+- [Zustand](https://github.com/pmndrs/zustand) - React 用の状態管理ライブラリ。
+- [Express](https://expressjs.com/) - Node.js 用のウェブフレームワーク。
+- [js-yaml](https://github.com/nodeca/js-yaml) - JavaScript 用 YAML パーサー。
+- [Commander.js](https://github.com/tj/commander.js) - CLI フレームワーク。
 
 ## ライセンス
 MIT

package/README.md

@@ -21,20 +21,22 @@ In modern data analysis platforms, data modeling is no longer just about drawing
 ## Key Features
 
 - **YAML-as-Code**: Define your entire data architecture in a single, human-readable YAML file. Track changes via Git.
-- **Instant Local Visualization**: Visualize your YAML models (following the Modscape schema) instantly on your machine. No database connections or cloud infrastructure required—just point to your file and start exploring.
-- **Specialized Modeling Types**: Native support for entity types like `fact`, `dimension`, `hub`, `link`, and `satellite`.
-- **Sample Data Stories**: Attach real-world data samples to your entities to explain the "Story" behind the data.
+- **Instant Local Visualization**: Visualize your YAML models instantly on your machine. No database connections or cloud infrastructure required—just point to your file and start exploring.
+- **Integrated Professional Editor**: Powered by **CodeMirror 6**, providing syntax highlighting and a rich YAML editing experience directly in the sidebar.
+- **Unified Undo/Redo & Auto-save**: 
+  - Visual actions (dragging, resizing, metadata edits) are synchronized with the editor's history. Undo your last action with `Ctrl+Z`.
+  - Optional **Auto-save** ensures your local YAML is always up-to-date with your visual changes.
+- **Dark/Light Mode Support**: Switch between themes seamlessly for better eye comfort or documentation exports.
+- **Specialized Modeling Types**: Native support for entity types like `fact`, `dimension`, `mart`, `hub`, `link`, and `satellite`.
 - **Interactive Visual Canvas**: 
-  - **Drag-to-Connect**: Create relationships between columns intuitively.
-  - **Auto-Layout Persistence**: Arrange nodes on the canvas; coordinates are saved directly back to your YAML.
-  - **Domain Grouping**: Organize tables into visual business domains.
+  - **Drag-to-Connect**: Create relationships between columns intuitively with "Magnetic Snapping".
+  - **Data Lineage Mode**: Visualize data flow with animated dashed arrows.
+  - **Domain-Grouped Navigation**: Organize tables into visual business domains and navigate them via a structured sidebar.
 - **Analytics Metadata**: 
   - **Fact Table Types**: Define `transaction`, `periodic`, `accumulating`, or `factless` grains.
   - **SCD Management**: Visualize `SCD Type 2` and other history-tracking dimensions.
-  - **Additivity Rules**: Mark columns as `fully`, `semi`, or `non-additive` to guide BI development.
-  - **Metadata/Audit Tracking**: Identify audit columns with specialized visual cues.
+  - **Additivity Rules**: Mark columns as `fully`, `semi`, or `non-additive` (Σ icon).
 - **AI-Agent Ready**: Built-in scaffolding for **Gemini, Claude, and Codex** to accelerate your modeling workflow using LLMs.
-- **Documentation Export**: Generate Mermaid-compatible Markdown for your internal wikis or GitHub/GitLab pages.
 
 ## Installation
 
@@ -76,80 +78,38 @@ Best for direct architectural control.
     ```bash
     modscape dev model.yaml
     ```
-3.  **Explore Samples**: Try the built-in patterns:
-    ```bash
-    modscape dev samples/
-    ```
 
 ---
 
 ## Defining Your Model (YAML)
 
-Modscape uses a schema designed for data analysis contexts. This single file acts as the **Single Source of Truth** for your logical and physical data architecture.
+Modscape uses a schema designed for data analysis contexts.
 
 ```yaml
 # 1. Domains: Visual containers for grouping business logic
 domains:
   - id: core_sales
     name: Core Sales
-    description: "Optional description of the domain"
-    color: "rgba(59, 130, 246, 0.05)" # Container background color
-    tables: [orders, products] # List of table IDs
+    color: "#3b82f6"
+    tables: [orders, products]
 
 # 2. Tables: Entity definitions with multi-layer metadata
 tables:
   - id: orders
     name: ORDERS
     appearance:
-      type: fact    # fact | dimension | hub | link | satellite
-      # --- Analytics Metadata ---
-      sub_type: transaction # transaction | periodic | accumulating | factless
-      # (Use sub_type for SCD types in Dimensions: type0 | type1 | type2 | type3 | type4 | type5 | type6 | type7)
-      icon: 📦      # Custom emoji or character
-      color: "#f87171" # Custom theme color for this entity
-    
-    conceptual:
-      description: "Sales transaction records"
-      tags: ["WHO", "WHEN", "HOW MUCH"] # BEAM* or Grain identifiers
-    
-    physical:
-      name: STG_ORDERS     # Actual table name in DB
-      schema: ANALYTICS_DB # DB schema/namespace
-    
+      type: fact    # fact | dimension | mart | hub | link | satellite
+      sub_type: transaction 
+      scd: type2
+      icon: 📦
     columns:
       - id: order_id
         logical:
           name: ORDER_ID
           type: Int
-          description: "Unique identifier"
           isPrimaryKey: true
-          isForeignKey: false
-          isPartitionKey: false
-          # --- Analytics Metadata ---
-          isMetadata: false # Set true for audit columns (🕒 icon)
           additivity: fully # fully | semi | non (Σ icon)
-        physical:
-          name: O_ID
-          type: NUMBER(38,0)
-          constraints: ["NOT NULL"]
-      
-      - id: customer_id
-        logical: { name: CUSTOMER_ID, type: Int, isForeignKey: true }
-
-    # 3. Sample Data: Storytelling through data
-    sampleData:
-      - [1001, 501]
-      - [1002, 502]
-
-# 4. Relationships: Column-level connectivity
-relationships:
-  - from: { table: orders, column: customer_id }
-    to: { table: customers, column: id }
-    type: many-to-one # one-to-one | one-to-many | many-to-many
-
-# 5. Layout: Visual coordinates (Auto-managed)
-layout:
-  orders: { x: 100, y: 100, width: 320, height: 400 }
+          isMetadata: false # audit column (🕒 icon)
 ```
 
 ---
@@ -157,39 +117,32 @@ layout:
 ## Usage
 
 ### Development Mode (Interactive)
-Edit your YAML and arrange entities visually.
-
 ```bash
 modscape dev ./models
 ```
-- Opens `http://localhost:5173`.
-- **Persistence**: Layout and metadata changes are saved directly to your files.
+- **Persistence**: Layout and metadata changes are saved directly to your files (supports Auto-save).
 
 ### Build Mode (Static Site)
-Generate a standalone documentation site for your team.
-
 ```bash
 modscape build ./models -o docs-site
 ```
 
 ### Export Mode (Markdown)
-Generate documentation with Mermaid diagrams.
-
 ```bash
 modscape export ./models -o docs/ARCHITECTURE.md
 ```
 
-## AI Agent Integration
-
-Modscape is designed to be **AI-First**. By running `modscape init`, you establish a contract with your AI agent via `.modscape/rules.md`, ensuring consistent modeling patterns (naming conventions, data types, etc.) across your entire project.
-
 ## Credits
 
-Modscape is built upon:
-- **React Flow**: Interactive graph engine.
-- **Lucide**: Consistent iconography.
-- **Express**: Local dev server.
-- **Commander**: CLI framework.
+Modscape is made possible by these incredible open-source projects:
+
+- [React Flow](https://reactflow.dev/) - Interactive node-based UI framework.
+- [CodeMirror 6](https://codemirror.net/) - Next-generation code editor for the web.
+- [Lucide React](https://lucide.dev/) - Beautifully simple pixel-perfect icons.
+- [Zustand](https://github.com/pmndrs/zustand) - Bear necessities for state management.
+- [Express](https://expressjs.com/) - Fast, unopinionated web framework for Node.js.
+- [js-yaml](https://github.com/nodeca/js-yaml) - JavaScript YAML parser and dumper.
+- [Commander.js](https://github.com/tj/commander.js) - CLI framework.
 
 ## License
 MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "modscape",
-  "version": "0.9.1",
+  "version": "1.0.0",
   "description": "Modscape: A YAML-driven data modeling visualizer CLI",
   "repository": {
     "type": "git",

package/src/dev.js

@@ -43,7 +43,7 @@ function scanFiles(inputPaths) {
 
 export async function startDevServer(paths, visualizerPath) {
   const app = express();
-  app.use(express.json());
+  app.use(express.json({ limit: '10mb' }));
 
   const inputPaths = Array.isArray(paths) ? paths : [paths];
   let modelMap = scanFiles(inputPaths);
@@ -93,30 +93,14 @@ export async function startDevServer(paths, visualizerPath) {
     }
   });
 
-  // API to save layout changes
-  app.post('/api/layout', (req, res) => {
-    const modelPath = getModelPath(req.query.model);
-    if (!modelPath) return res.status(404).json({ error: 'Model not found' });
-
-    try {
-      const layout = req.body;
-      const content = fs.readFileSync(modelPath, 'utf8');
-      const data = yaml.load(content);
-      data.layout = layout;
-      fs.writeFileSync(modelPath, yaml.dump(data, { indent: 2, lineWidth: -1 }), 'utf8');
-      res.json({ success: true });
-    } catch (e) {
-      res.status(500).json({ error: e.message });
-    }
-  });
-
   // API to save entire YAML content
-  app.post('/api/save-yaml', (req, res) => {
+  app.post('/api/save', (req, res) => {
     const modelPath = getModelPath(req.query.model);
     if (!modelPath) return res.status(404).json({ error: 'Model not found' });
 
     try {
       const { yaml: yamlContent } = req.body;
+      // Basic validation
       yaml.load(yamlContent);
       fs.writeFileSync(modelPath, yamlContent, 'utf8');
       res.json({ success: true });

package/src/index.js

@@ -14,8 +14,8 @@ const program = new Command();
 
 program
   .name('modscape')
-  .description('A YAML-driven data modeling visualizer CLI')
-  .version('0.9.1');
+  .description('Modscape: A YAML-driven data modeling visualizer CLI')
+  .version('1.0.0');
 
 program
   .command('init')

package/src/templates/rules.md

@@ -5,27 +5,25 @@
 - **Dimensional Modeling (Star Schema)**: Recommended for most analytical use cases. 
   - Use `appearance.type: fact` for central measurement tables.
   - Use `appearance.type: dimension` for descriptive attribute tables.
+  - Use `appearance.type: mart` for downstream reporting-ready tables (Data Marts).
 - **Data Vault 2.0**: For highly scalable enterprise data warehouses.
   - Use `appearance.type: hub`, `link`, or `satellite`.
 
 ## 2. Analytics Metadata
 Modscape supports attributes to communicate the "Story" and "Grain" of your data to humans and AI agents.
 
-### Fact Table Types / Dimension History (`appearance.sub_type`)
-- **For Fact Tables**:
-  - `transaction`: Standard fact table where one row = one event (e.g., an order).
-  - `periodic`: Snapshot fact table capturing state at set intervals (e.g., monthly inventory).
-  - `accumulating`: Fact table updated as a process moves through milestones (e.g., order → shipping → delivery).
-  - `factless`: Tables that record the occurrence of an event without numeric measures (e.g., event attendance).
-- **For Dimension Tables (SCD Types)**:
-  - `type0`: Fixed dimensions (no changes allowed).
-  - `type1`: Overwrite changes (no history maintained).
-  - `type2`: Add new row for changes (full history with timestamps).
-  - `type3`: Add new column for changes (partial history).
-  - `type4`: History table (separate table for history).
-  - `type5`: Hybrid (1 + 4).
-  - `type6`: Hybrid (1 + 2 + 3).
-  - `type7`: Hybrid (1 + 2).
+### Fact Table Types / Dimension History (`appearance.sub_type` and `appearance.scd`)
+Modscape separates a table's core nature from its history tracking method.
+
+- **`sub_type` (The "What")**:
+  - **For Fact Tables**: `transaction` (atomic event), `periodic` (state interval), `accumulating` (milestones), `factless` (occurrence only).
+  - **For Dimension Tables**: `conformed` (shared), `junk` (flags), `degenerate` (in-fact).
+- **`scd` (The "How it changes")**:
+  `type0` (fixed), `type1` (overwrite), `type2` (history row), `type3` (history col), `type4` (history table), `type5` (1+4), `type6` (1+2+3), `type7` (1+2).
+
+### Data Lineage (`lineage.upstream`)
+Explicitly define dependencies to communicate the data flow:
+- Use `lineage.upstream: [table_id1, table_id2]` to list source tables.
 
 ### Column Additivity (`logical.additivity`)
 - `fully`: Can be summed across all dimensions (e.g., sales amount). Displays as `Σ`.
@@ -37,7 +35,7 @@ Mark technical or audit columns (like `created_at`, `dbt_updated_at`) with `isMe
 
 ## 3. Naming Conventions
 - **Casing**: [Select one: snake_case / UPPER_SNAKE_CASE / camelCase]
-- **Prefixes**: (e.g., `f_` for facts, `d_` for dimensions)
+- **Prefixes**: (e.g., `f_` for facts, `d_` for dimensions, `m_` for marts)
 - **Suffixes**: (e.g., `_id` for primary keys, `_h` for history tables)
 
 ## 4. Standard Data Types
@@ -52,28 +50,36 @@ tables:
     name: Orders Fact
     appearance:
       type: fact
-      sub_type: transaction # transaction | periodic | accumulating | factless
+      sub_type: transaction
+      scd: type2 
     conceptual:
       description: "Records of customer purchases"
-      tags: ["WHO", "WHEN", "HOW MUCH"]
     columns:
       - id: order_id
         logical: { name: ID, type: Int, isPrimaryKey: true }
       - id: amount
-        logical: { name: Amount, type: Decimal, additivity: fully } # fully | semi | non
-      - id: updated_at
-        logical: { name: Updated At, type: Timestamp, isMetadata: true }
+        logical: { name: Amount, type: Decimal, additivity: fully } 
 
   - id: dim_customers
     name: Customers Dim
     appearance:
       type: dimension
-      sub_type: type2 # type0 | type1 | type2 | type3 | type6
+      sub_type: conformed
+      scd: type2
     columns:
       - id: customer_id
         logical: { name: ID, type: Int, isPrimaryKey: true }
-      - id: valid_from
-        logical: { name: Valid From, type: Timestamp, isMetadata: true }
+
+  - id: mart_daily_revenue
+    name: Daily Revenue Mart
+    appearance:
+      type: mart
+      sub_type: periodic
+    columns:
+      - id: report_date
+        logical: { name: Date, type: Date, isPrimaryKey: true }
+      - id: daily_amount
+        logical: { name: Revenue, type: Decimal, additivity: fully }
 ```
 
 ## 6. Layout Management
@@ -82,5 +88,5 @@ tables:
 
 ## 7. The Golden Rules
 - When updating `model.yaml`, always self-audit against these rules.
-- Set appropriate `appearance.type` and `sub_type` for new tables.
+- Set appropriate `appearance.type`, `sub_type`, and `scd` for new tables.
 - Use `additivity` for numeric measures to inform BI tools and analysts.

package/visualizer/package.json

@@ -1,7 +1,7 @@
 {
   "name": "visualizer",
   "private": true,
-  "version": "0.9.1",
+  "version": "1.0.0",
   "type": "module",
   "scripts": {
     "dev": "vite",
@@ -10,11 +10,15 @@
     "preview": "vite preview"
   },
   "dependencies": {
+    "@codemirror/lang-yaml": "^6.1.2",
+    "@codemirror/theme-one-dark": "^6.1.3",
     "@radix-ui/react-scroll-area": "^1.2.10",
     "@radix-ui/react-slot": "^1.2.4",
     "@radix-ui/react-tabs": "^1.1.13",
+    "@uiw/react-codemirror": "^4.25.7",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
+    "codemirror": "^6.0.2",
     "js-yaml": "^4.1.1",
     "lucide-react": "^0.575.0",
     "react": "^19.2.0",