mirror of
https://github.com/nejimakibird/model-weave.git
synced 2026-07-22 06:51:24 +00:00
chore: prepare 0.1.19 release
This commit is contained in:
parent
37a342865e
commit
fd097d1fba
13 changed files with 91 additions and 27 deletions
18
README-ja.md
18
README-ja.md
|
|
@ -18,14 +18,14 @@ Model Weave は、構造化されたソフトウェアモデリングの機能
|
|||
* **アプリケーションロジック**: 業務フロー(App Process)、画面定義、ビジネスルール。
|
||||
* **影響分析**: 設計全体にわたる関係性や依存関係を自動的に検出。
|
||||
|
||||
## 0.1.18 の主な更新
|
||||
## 0.1.19 の主な更新
|
||||
|
||||
* Flow Diagram MVP として、画面、コンテキスト、プロセス、ストア、セッション、外部システム間の communication / data handoff flow を書く `type: flow_diagram` を追加しました。
|
||||
* Flow Diagram の edge は `kind`, `trigger`, `data`, `condition` による richer semantics と、node / edge label の hover details に対応しました。
|
||||
* Diagnostics は schema-driven な table header guidance、Flow endpoint の local object guidance、DFD / Flow Diagram `Flows.data` の Wikilink diagnostics を改善しました。
|
||||
* Color Scheme preview editing では、`fill`, `stroke`, `text` を swatch と native color picker controls で編集しやすくしました。
|
||||
* Applied Color Scheme は Details tab に compact な `Target | Kind | Preview | Notes | Source` table として表示されます。
|
||||
|
||||
* Details、Relationships、Diagnostics、Source Links、Mermaid 情報を整理する安定した lower panel tabs を追加しました。graph view と non-graph review view の両方で利用できます。
|
||||
* Diagnostics はカード表示、グループ化されたアクション、手動修正ガイダンス、一括 Markdown コピーに対応しました。
|
||||
* Quick Fix MVP として、frontmatter の `id` / `name` が不足している場合に、安全に導出できる値を挿入できます。`type` は自動修正しません。
|
||||
* 全セルが空白の Markdown テーブルデータ行は入力ノイズとして無視されます。一部のセルに値がある行は従来どおり必須項目の診断対象です。
|
||||
* renderer 切り替えや Business Flow direction 変更後も lower tabs が安定して維持されます。
|
||||
|
||||
## 基本の考え方
|
||||
|
||||
### 必要なところから使える
|
||||
|
|
@ -89,7 +89,7 @@ Obsidian のコマンドパレット(`Ctrl+P` / `Cmd+P`)を開き、`Model W
|
|||
|
||||
### レンダリングポリシー
|
||||
|
||||
* `render_mode`: 指定できる値はフォーマットにより異なります。たとえば class / ER 系は `custom`, `mermaid`, `mermaid-detail`、`dfd_diagram` は `mermaid`、`domains` / `domain_diagram` は `mindmap`, `area`, `tree` を使います。
|
||||
* `render_mode`: 指定できる値はフォーマットにより異なります。たとえば class / ER 系は `custom`, `mermaid`, `mermaid-detail`、`dfd_diagram` と `flow_diagram` は `mermaid`、`domains` / `domain_diagram` は `mindmap`, `area`, `tree` を使います。
|
||||
* 初期表示の優先順位: サポートされている Frontmatter `render_mode` > 設定画面のフォーマット別デフォルト > 組み込みフォールバック。
|
||||
* ツールバーのレンダラー切り替えは現在のビューだけの一時的な選択です。
|
||||
* 詳細は [V0.8 rendering policy](https://github.com/nejimakibird/model-weave/blob/main/docs/V0.8-rendering-policy.md) を参照してください。
|
||||
|
|
@ -97,7 +97,7 @@ Obsidian のコマンドパレット(`Ctrl+P` / `Cmd+P`)を開き、`Model W
|
|||
### 主要なフォーマット
|
||||
|
||||
* **安定版**: `class`, `er_entity`, `dfd_diagram`, `data_object` など。
|
||||
* **開発中**: `screen`, `app_process`, `rule`, `codeset` など。
|
||||
* **開発中**: `flow_diagram`, `screen`, `app_process`, `rule`, `codeset` など。
|
||||
|
||||
### インストール
|
||||
|
||||
|
|
|
|||
18
README.md
18
README.md
|
|
@ -18,14 +18,14 @@ It helps keep design assets human-readable, Git-friendly, and usable as structur
|
|||
* **Application logic**: App Process business flows, Screen definitions, and Business Rules.
|
||||
* **Impact analysis**: Automatically detect relationships and dependencies across the design.
|
||||
|
||||
## Recent updates in 0.1.18
|
||||
## Recent updates in 0.1.19
|
||||
|
||||
* Flow Diagram MVP adds `type: flow_diagram` for screen, context, process, store, session, and external communication/data handoff flows.
|
||||
* Flow Diagram edges support richer `kind`, `trigger`, `data`, and `condition` semantics, with hover details for nodes and edge labels.
|
||||
* Diagnostics now provide schema-driven table-header guidance, local Flow endpoint guidance, and Wikilink diagnostics for DFD / Flow Diagram `Flows.data`.
|
||||
* Color Scheme preview editing adds swatches and native color picker controls for `fill`, `stroke`, and `text`.
|
||||
* Applied Color Scheme now uses a compact Details-tab table with `Target | Kind | Preview | Notes | Source`.
|
||||
|
||||
* Stable lower panel tabs organize Details, Relationships, Diagnostics, Source Links, and Mermaid information across graph and non-graph review views.
|
||||
* Diagnostics now include clearer cards, grouped actions, manual-edit guidance, and bulk Markdown copy for all diagnostics, errors, warnings, or notes.
|
||||
* Quick Fix MVP can insert missing frontmatter `id` / `name` when a safe value can be derived; missing `type` is not auto-fixed.
|
||||
* Fully empty Markdown table data rows are ignored as editing noise, while partially filled rows still produce required-field diagnostics.
|
||||
* Renderer switching and Business Flow direction changes keep the lower tabs stable.
|
||||
|
||||
## Basic idea
|
||||
|
||||
### Start from what you need
|
||||
|
|
@ -91,7 +91,7 @@ Try these commands first:
|
|||
|
||||
### Rendering policy
|
||||
|
||||
* `render_mode`: supported values depend on the format. For example, class / ER formats support `custom`, `mermaid`, and `mermaid-detail`; `dfd_diagram` supports `mermaid`; `domains` and `domain_diagram` support `mindmap`, `area`, and `tree`.
|
||||
* `render_mode`: supported values depend on the format. For example, class / ER formats support `custom`, `mermaid`, and `mermaid-detail`; `dfd_diagram` and `flow_diagram` support `mermaid`; `domains` and `domain_diagram` support `mindmap`, `area`, and `tree`.
|
||||
* Initial priority: supported frontmatter `render_mode` > format-specific settings default > built-in fallback.
|
||||
* Toolbar renderer selection is temporary for the current view only.
|
||||
* See [V0.8 rendering policy](https://github.com/nejimakibird/model-weave/blob/main/docs/V0.8-rendering-policy.md) for details.
|
||||
|
|
@ -99,7 +99,7 @@ Try these commands first:
|
|||
### Main formats
|
||||
|
||||
* **Stable**: `class`, `er_entity`, `dfd_diagram`, `data_object`, and others.
|
||||
* **Evolving**: `screen`, `app_process`, `rule`, `codeset`, and others.
|
||||
* **Evolving**: `flow_diagram`, `screen`, `app_process`, `rule`, `codeset`, and others.
|
||||
|
||||
### Installation
|
||||
|
||||
|
|
|
|||
|
|
@ -27,6 +27,7 @@ Templates help you start new models with the correct frontmatter and section str
|
|||
- `Model Weave: Insert ER Diagram Template`: For ER diagrams.
|
||||
- `Model Weave: Insert DFD Object Template`: For DFD processes, stores, or external entities.
|
||||
- `Model Weave: Insert DFD Diagram Template`: For DFD diagrams (Mermaid-first).
|
||||
- `Model Weave: Insert Flow Diagram Template`: For screen communication and data handoff flows.
|
||||
|
||||
### Data Modeling
|
||||
- `Model Weave: Insert Data Object Template`: Use for **logical data structures** (e.g., API requests, responses, payloads, or internal application data).
|
||||
|
|
|
|||
|
|
@ -93,6 +93,7 @@ Current Color Scheme application:
|
|||
| `domain_diagram` Area / Tree | `target=domain`, `kind=<Domain.kind>` |
|
||||
| `dfd_diagram` objects | `target=dfd`, `kind=<Objects.kind>` |
|
||||
| `dfd_diagram` Domain subgraphs | `target=domain`, `kind=<Domain.kind>` |
|
||||
| `flow_diagram` Domain subgraphs | `target=domain`, `kind=<Objects.domain>` matching Domain kind rows |
|
||||
| `app_process` Business Flow | `target=app_process`, `kind=<Steps.kind>` |
|
||||
| Weave Map layer subgraphs | `target=weave_map`, `kind=ui / process / rule / rule_state / ui_message / data / mapping / implementation / data_flow / relationship / source / warning / other` |
|
||||
|
||||
|
|
@ -109,7 +110,7 @@ Currently not colorized:
|
|||
|
||||
Supported previews may show an Applied Color Scheme section.
|
||||
|
||||
This section shows active/effective rows as a kind dictionary for the current view so users can confirm which colors are in use.
|
||||
This section shows active/effective rows as a compact kind dictionary for the current view so users can confirm which colors are in use. It is display metadata only; the source `type: color_scheme` `## Colors` table keeps the `target | kind | fill | stroke | text | notes` format documented above.
|
||||
|
||||
PNG export preserves rendered colors where the current view supports colorized rendering.
|
||||
|
||||
|
|
|
|||
|
|
@ -76,12 +76,18 @@ Expected header:
|
|||
| id | from | to | kind | trigger | data | condition | notes |
|
||||
```
|
||||
|
||||
`Flows.from` and `Flows.to` refer to local `Objects.id` values. `Flows.kind` describes edge semantics, `Flows.trigger` describes the event or action that causes the flow, `Flows.data` describes the payload or model references, and `Flows.condition` describes a guard. Mermaid edge labels are assembled compactly from `trigger`, `kind`, and `data`. `data_object` references in `Flows.data` are allowed and do not become graph nodes by default.
|
||||
`Flows.from` and `Flows.to` refer to local `Objects.id` values. `Flows.kind` describes edge semantics, `Flows.trigger` describes the event or action that causes the flow, `Flows.data` describes the payload or model references, and `Flows.condition` describes a guard. `Flows.notes` is for human review context that should not be part of the edge label.
|
||||
|
||||
Plain `Flows.data` values are treated as Mermaid edge-label text. Wikilinks in `Flows.data` are resolved as Model Weave references; unresolved Wikilinks produce diagnostics. `data_object` references in `Flows.data` are allowed and do not become graph nodes by default.
|
||||
|
||||
Mermaid edge labels are assembled compactly from `trigger`, `kind`, and `data`.
|
||||
|
||||
## Rendering
|
||||
|
||||
The MVP uses Internal Detail View only and renders the raw Objects / Flows graph without projection, folding, or view selectors.
|
||||
|
||||
Surface View, Communication View, projection, context/process/store folding, transition coverage, and automatic generation from screen or app_process models are future work.
|
||||
|
||||
## AI Generation Notes
|
||||
|
||||
- Use `type: flow_diagram`.
|
||||
|
|
|
|||
|
|
@ -26,6 +26,7 @@ Model Weave のすべての機能は、Obsidian のコマンドパレットか
|
|||
- `Model Weave: Insert ER Diagram Template`: ER 図用。
|
||||
- `Model Weave: Insert DFD Object Template`: DFD のプロセス、データストア、または外部エンティティ用。
|
||||
- `Model Weave: Insert DFD Diagram Template`: DFD 図(Mermaid 優先)用。
|
||||
- `Model Weave: Insert Flow Diagram Template`: 画面連携や data handoff flow 用。
|
||||
|
||||
### データモデリング
|
||||
- **`Model Weave: Insert Data Object Template`**: API リクエスト、レスポンス、内部データ、インターフェースデータなどの**論理的なデータ構造**に使用します。
|
||||
|
|
|
|||
|
|
@ -93,6 +93,7 @@ ref が解決できない場合、または対象ファイルが `type: color_sc
|
|||
| `domain_diagram` Area / Tree | `target=domain`, `kind=<Domain.kind>` |
|
||||
| `dfd_diagram` objects | `target=dfd`, `kind=<Objects.kind>` |
|
||||
| `dfd_diagram` Domain subgraphs | `target=domain`, `kind=<Domain.kind>` |
|
||||
| `flow_diagram` Domain subgraphs | `target=domain`, `kind=<Objects.domain>` に対応する Domain kind rows |
|
||||
| `app_process` Business Flow | `target=app_process`, `kind=<Steps.kind>` |
|
||||
| Weave Map layer subgraphs | `target=weave_map`, `kind=ui / process / rule / rule_state / ui_message / data / mapping / implementation / data_flow / relationship / source / warning / other` |
|
||||
|
||||
|
|
@ -109,7 +110,7 @@ Weave Map のレイヤー色は target-specific です。レイヤー subgraph
|
|||
|
||||
対応する previews では Applied Color Scheme section が表示される場合があります。
|
||||
|
||||
この section は、現在の view に対して有効な rows を kind dictionary として表示し、どの色が使われるかを確認できるようにします。
|
||||
この section は、現在の view に対して有効な rows を compact な kind dictionary として表示し、どの色が使われるかを確認できるようにします。これは表示用 metadata であり、source である `type: color_scheme` の `## Colors` table は上記の `target | kind | fill | stroke | text | notes` format のままです。
|
||||
|
||||
PNG export は、現在の view が colorized rendering に対応している場合、描画された色を保持します。
|
||||
|
||||
|
|
|
|||
|
|
@ -76,12 +76,18 @@ MVPで対応する object kind:
|
|||
| id | from | to | kind | trigger | data | condition | notes |
|
||||
```
|
||||
|
||||
`Flows.from` と `Flows.to` はローカルの `Objects.id` を参照します。`Flows.kind` は edge semantics、`Flows.trigger` は flow を起こす event / action、`Flows.data` は payload や model reference、`Flows.condition` は guard を表します。Mermaid edge label は `trigger`、`kind`、`data` から compact に組み立てられます。`Flows.data` 内の `data_object` 参照は許容され、既定では graph node にはなりません。
|
||||
`Flows.from` と `Flows.to` はローカルの `Objects.id` を参照します。`Flows.kind` は edge semantics、`Flows.trigger` は flow を起こす event / action、`Flows.data` は payload や model reference、`Flows.condition` は guard を表します。`Flows.notes` は edge label に含めない人間向けの補足です。
|
||||
|
||||
通常の `Flows.data` 値は Mermaid edge label の文字列として扱います。`Flows.data` 内の Wikilink は Model Weave reference として解決され、未解決の Wikilink は診断されます。`Flows.data` 内の `data_object` 参照は許容され、既定では graph node にはなりません。
|
||||
|
||||
Mermaid edge label は `trigger`、`kind`、`data` から compact に組み立てられます。
|
||||
|
||||
## Rendering
|
||||
|
||||
MVPでは Internal Detail View のみを使います。Objects / Flows の raw graph を表示し、projection、folding、view selector は実装しません。
|
||||
|
||||
Surface View、Communication View、projection、context/process/store folding、transition coverage、screen や app_process からの自動生成は将来対応です。
|
||||
|
||||
## AI生成時の注意
|
||||
|
||||
- `type: flow_diagram` を使う。
|
||||
|
|
|
|||
47
docs/releases/v0.1.19.md
Normal file
47
docs/releases/v0.1.19.md
Normal file
|
|
@ -0,0 +1,47 @@
|
|||
# Model Weave v0.1.19
|
||||
|
||||
Model Weave v0.1.19 adds the Flow Diagram MVP, improves Diagnostics guidance, and makes Color Scheme editing and review easier.
|
||||
|
||||
## Highlights
|
||||
|
||||
### Flow Diagram MVP
|
||||
|
||||
- Added `type: flow_diagram` for communication and data handoff diagrams.
|
||||
- Supports screen, context, process, store, session, and external objects.
|
||||
- Uses `Objects.domain` to group nodes into Mermaid subgraphs.
|
||||
- Applies `target=domain` Color Scheme rows to Flow Diagram domain groups.
|
||||
- Uses richer Flow semantics with:
|
||||
|
||||
`id | from | to | kind | trigger | data | condition | notes`
|
||||
|
||||
- Renders edge labels using trigger / kind / data.
|
||||
- Adds rich hover interactions for Flow Diagram nodes and edge labels.
|
||||
- Resolved model/data references open Obsidian Page Preview.
|
||||
- Unresolved/plain references fall back to Model Weave detail cards or safe tooltips.
|
||||
- Adds diagnostics for unresolved Wikilinks in `Flows.data` while preserving plain text labels.
|
||||
|
||||
### Diagnostics improvements
|
||||
|
||||
- Improved schema-driven expected header guidance.
|
||||
- Shows expected headers only for malformed table-header diagnostics.
|
||||
- Suppresses cascading row-level diagnostics when table headers are malformed.
|
||||
- Distinguishes local Flow Diagram endpoints from external model references.
|
||||
- Treats structured malformed table headers as errors.
|
||||
- Improves Color Scheme and Source Links diagnostics.
|
||||
- Validates Wikilinks in `Flows.data` for DFD and Flow Diagram without requiring plain labels to resolve.
|
||||
|
||||
### Color Scheme improvements
|
||||
|
||||
- Added Color Scheme preview editing support with swatches and native color picker controls.
|
||||
- Makes `fill`, `stroke`, and `text` easier to edit in Color Scheme previews.
|
||||
- Compact Applied Color Scheme display now uses:
|
||||
|
||||
`Target | Kind | Preview | Notes | Source`
|
||||
|
||||
- Raw color codes remain available through accessibility metadata without duplicate native browser tooltips.
|
||||
|
||||
## Notes
|
||||
|
||||
- `flow_diagram` is an MVP and currently renders the Internal Detail View.
|
||||
- Surface View, Communication View, folding/projection, and transition coverage generation are planned for later versions.
|
||||
- Existing `dfd_diagram` format remains unchanged.
|
||||
|
|
@ -1,7 +1,7 @@
|
|||
{
|
||||
"id": "model-weave",
|
||||
"name": "Model Weave",
|
||||
"version": "0.1.18",
|
||||
"version": "0.1.19",
|
||||
"minAppVersion": "1.8.7",
|
||||
"description": "Manage text-first models, relationships, and diagrams in Markdown.",
|
||||
"author": "nejimakibird",
|
||||
|
|
|
|||
4
package-lock.json
generated
4
package-lock.json
generated
|
|
@ -1,12 +1,12 @@
|
|||
{
|
||||
"name": "obsidian-model-weave",
|
||||
"version": "0.1.18",
|
||||
"version": "0.1.19",
|
||||
"lockfileVersion": 3,
|
||||
"requires": true,
|
||||
"packages": {
|
||||
"": {
|
||||
"name": "obsidian-model-weave",
|
||||
"version": "0.1.18",
|
||||
"version": "0.1.19",
|
||||
"license": "MIT",
|
||||
"devDependencies": {
|
||||
"@eslint/js": "^10.0.1",
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
{
|
||||
"name": "obsidian-model-weave",
|
||||
"version": "0.1.18",
|
||||
"version": "0.1.19",
|
||||
"description": "An Obsidian plugin for managing text-first models, relationships, and diagrams in Markdown.",
|
||||
"main": "main.js",
|
||||
"scripts": {
|
||||
|
|
|
|||
|
|
@ -16,5 +16,6 @@
|
|||
"0.1.15": "1.7.2",
|
||||
"0.1.16": "1.8.7",
|
||||
"0.1.17": "1.8.7",
|
||||
"0.1.18": "1.8.7"
|
||||
"0.1.18": "1.8.7",
|
||||
"0.1.19": "1.8.7"
|
||||
}
|
||||
|
|
|
|||
Loading…
Reference in a new issue