decklens 0.1.0__tar.gz

decklens-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Maya Kachina
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

decklens-0.1.0/PKG-INFO

@@ -0,0 +1,192 @@
+Metadata-Version: 2.4
+Name: decklens
+Version: 0.1.0
+Summary: Engineering-aware semantic diff tool for CAE input files
+Author-email: Maya Kachina <pj.kachina@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/pj-kachina/DeckLens-Semantic-Diff-for-CAE
+Project-URL: Documentation, https://github.com/pj-kachina/DeckLens-Semantic-Diff-for-CAE#readme
+Project-URL: Repository, https://github.com/pj-kachina/DeckLens-Semantic-Diff-for-CAE.git
+Project-URL: Issues, https://github.com/pj-kachina/DeckLens-Semantic-Diff-for-CAE/issues
+Project-URL: Changelog, https://github.com/pj-kachina/DeckLens-Semantic-Diff-for-CAE/blob/main/CHANGELOG.md
+Keywords: CAE,FEA,diff,OpenRadioss,NASTRAN,LS-DYNA,semantic-diff,engineering,simulation,comparison
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Utilities
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: anthropic>=0.49.0
+Requires-Dist: click>=8.1
+Requires-Dist: rich>=13.0
+Requires-Dist: python-dotenv>=1.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-cov>=5.0; extra == "dev"
+Dynamic: license-file
+
+# DeckLens: Semantic Diff for CAE
+
+![VS Code Extension](https://img.shields.io/badge/extension-VS%20Code-blue)
+![License](https://img.shields.io/badge/license-MIT-green)
+
+**DeckLens** は CAE（計算力学）入力ファイルの**セマンティックdiff**ツールです。テキスト差分ではなく、エンジニアリング観点から「何が変わった」かを理解します。
+
+## 問題
+
+CAE検証チームの現状：
+- 型紙（テンプレート）から修正内容を手動確認 → ボトルネック
+- `grep` + テキストエディタで変更追跡 → ミスが多い
+- 厚さ変更は単なる％数値表示 → 剛性への影響が不明確
+- 境界条件削除が見落とされやすい
+
+## ソリューション
+
+```bash
+$ decklens diff before.rad after.rad
+
+─────────── DeckLens Semantic Diff ──────────
+  Before: before.rad
+  After:  after.rad
+
+┌─ Summary ─┐
+│ 2 CRITICAL, 4 WARNING │
+└────────────┘
+
+┌────────┬─────────┬────────────┬─────────────────────┐
+│ Sev    │ Type    │ Name       │ Field               │
+├────────┼─────────┼────────────┼─────────────────────┤
+│ [CRIT] │ PROP/SH │ OUTER_PNL  │ thickness           │
+│        │         │            │ (bend-stiffness     │
+│        │         │            │ +138%)              │
+│ [CRIT] │ CLOAD   │ FORCE_Z    │ Fscale_y: 1000→2000│
+│ [WARN] │ MAT/ELS │ STEEL      │ E: 210k→206k (-1.9%)
+│ [WARN] │ BCS     │ FIXED_SUP  │ RX: free→fixed      │
+└────────┴─────────┴────────────┴─────────────────────┘
+
+🤖 AI Engineering Analysis (Claude Opus 4.8)
+─────────────────────────────────────────
+曲げ剛性が +138% 増加（t³則）するため、座屈荷重が大幅に上昇。
+ただし Young の係数が -1.9% 低下しているため、相殺効果は限定的。
+回転拘束追加により、モーメント反力が発生可能性あり。
+負荷 2 倍は FOS に直結 — 応力状態の再確認推奨。
+```
+
+### 主な機能
+
+✅ **OpenRadioss パーサー**
+- `/PROP/SHELL`, `/MAT/ELAST`, `/MAT/PLAS_JOHNS`, `/PART`, `/BCS`, `/LOAD`, `/INTER` 対応
+- FORTRAN D-notation（`7.85D-9`）自動変換
+
+✅ **セマンティック差分エンジン**
+- 厚さ変更 → 曲げ剛性（EI ∝ t³）を自動計算・注釈
+- Young係数 → 剛性への影響を評価
+- 境界条件追加/削除 → 重大度を自動判定
+- 負荷 2 倍 → CRITICAL フラグ
+
+✅ **重大度自動判定**
+| 重大度 | 条件 |
+|--------|------|
+| CRITICAL | ≥20% 変化、または BC/PART 削除 |
+| WARNING | 5–20% 変化、または BC 追加 |
+| INFO | <5% 変化 |
+
+✅ **Claude AI 分析（オプション）**
+- `claude-opus-4-8` による自動解釈
+- 適応思考（adaptive thinking）で複雑な物理関係を推論
+- JSON 出力対応（CI/CD 統合）
+
+## インストール
+
+### PyPI（CLI ツール）
+
+```bash
+pip install decklens-semantic-diff
+```
+
+### VS Code 拡張機能
+
+1. VS Code Marketplace で「DeckLens」検索
+2. インストール
+3. `.env` に `ANTHROPIC_API_KEY` 設定（AI 分析有効化）
+
+## 使い方
+
+### CLI
+
+```bash
+# 基本的な diff
+decklens diff before.rad after.rad
+
+# AI 分析をスキップ
+decklens diff before.rad after.rad --no-ai
+
+# JSON 出力（CI/CD 連携）
+decklens diff before.rad after.rad --format json
+
+# 重大度フィルタ
+decklens diff before.rad after.rad --min-severity WARNING
+
+# 別の Claude モデル指定
+decklens diff before.rad after.rad --model claude-sonnet-4-6
+```
+
+### VS Code 拡張機能
+
+右クリック → **DeckLens: Compare with** → ファイル選択 → サイドパネルに結果表示
+
+## 対応フォーマット
+
+| フォーマット | サポート | ロードマップ |
+|------------|---------|-----------|
+| OpenRadioss (.rad) | ✅ | 本実装 |
+| NASTRAN (.bdf) | 🔜 | Q3 2026 |
+| LS-DYNA (.k) | 🔜 | Q3 2026 |
+
+## 技術仕様
+
+- **言語**: Python 3.11+（CLI）、TypeScript（VS Code 拡張）
+- **API**: Claude Opus 4.8、adaptive thinking、high effort
+- **出力**: Rich テーブル、Markdown、JSON
+- **ライセンス**: MIT
+
+## 必要な環境
+
+- Python 3.11+
+- VS Code 1.85+（拡張機能使用時）
+- ANTHROPIC_API_KEY（AI 分析機能使用時）
+
+## トラブルシューティング
+
+### Q: AI 分析が実行されない
+**A**: `.env` に `ANTHROPIC_API_KEY` が設定されているか確認。未設定なら `--no-ai` を付与。
+
+### Q: 出力が文字化けする（Windows）
+**A**: PowerShell で UTF-8 出力を有効化：
+```powershell
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+```
+
+## 開発
+
+```bash
+git clone https://github.com/YOUR_GITHUB_USERNAME/DeckLens-Semantic-Diff-for-CAE.git
+cd DeckLens-Semantic-Diff-for-CAE
+pip install -e ".[dev]"
+pytest -v
+```
+
+## フィードバック
+
+Issue や Discussion は [GitHub](https://github.com/YOUR_GITHUB_USERNAME/DeckLens-Semantic-Diff-for-CAE/issues) へ。
+
+---
+
+**Made with ❤️ by CAE engineers, for CAE engineers**

decklens-0.1.0/README.md

@@ -0,0 +1,158 @@
+# DeckLens: Semantic Diff for CAE
+
+![VS Code Extension](https://img.shields.io/badge/extension-VS%20Code-blue)
+![License](https://img.shields.io/badge/license-MIT-green)
+
+**DeckLens** は CAE（計算力学）入力ファイルの**セマンティックdiff**ツールです。テキスト差分ではなく、エンジニアリング観点から「何が変わった」かを理解します。
+
+## 問題
+
+CAE検証チームの現状：
+- 型紙（テンプレート）から修正内容を手動確認 → ボトルネック
+- `grep` + テキストエディタで変更追跡 → ミスが多い
+- 厚さ変更は単なる％数値表示 → 剛性への影響が不明確
+- 境界条件削除が見落とされやすい
+
+## ソリューション
+
+```bash
+$ decklens diff before.rad after.rad
+
+─────────── DeckLens Semantic Diff ──────────
+  Before: before.rad
+  After:  after.rad
+
+┌─ Summary ─┐
+│ 2 CRITICAL, 4 WARNING │
+└────────────┘
+
+┌────────┬─────────┬────────────┬─────────────────────┐
+│ Sev    │ Type    │ Name       │ Field               │
+├────────┼─────────┼────────────┼─────────────────────┤
+│ [CRIT] │ PROP/SH │ OUTER_PNL  │ thickness           │
+│        │         │            │ (bend-stiffness     │
+│        │         │            │ +138%)              │
+│ [CRIT] │ CLOAD   │ FORCE_Z    │ Fscale_y: 1000→2000│
+│ [WARN] │ MAT/ELS │ STEEL      │ E: 210k→206k (-1.9%)
+│ [WARN] │ BCS     │ FIXED_SUP  │ RX: free→fixed      │
+└────────┴─────────┴────────────┴─────────────────────┘
+
+🤖 AI Engineering Analysis (Claude Opus 4.8)
+─────────────────────────────────────────
+曲げ剛性が +138% 増加（t³則）するため、座屈荷重が大幅に上昇。
+ただし Young の係数が -1.9% 低下しているため、相殺効果は限定的。
+回転拘束追加により、モーメント反力が発生可能性あり。
+負荷 2 倍は FOS に直結 — 応力状態の再確認推奨。
+```
+
+### 主な機能
+
+✅ **OpenRadioss パーサー**
+- `/PROP/SHELL`, `/MAT/ELAST`, `/MAT/PLAS_JOHNS`, `/PART`, `/BCS`, `/LOAD`, `/INTER` 対応
+- FORTRAN D-notation（`7.85D-9`）自動変換
+
+✅ **セマンティック差分エンジン**
+- 厚さ変更 → 曲げ剛性（EI ∝ t³）を自動計算・注釈
+- Young係数 → 剛性への影響を評価
+- 境界条件追加/削除 → 重大度を自動判定
+- 負荷 2 倍 → CRITICAL フラグ
+
+✅ **重大度自動判定**
+| 重大度 | 条件 |
+|--------|------|
+| CRITICAL | ≥20% 変化、または BC/PART 削除 |
+| WARNING | 5–20% 変化、または BC 追加 |
+| INFO | <5% 変化 |
+
+✅ **Claude AI 分析（オプション）**
+- `claude-opus-4-8` による自動解釈
+- 適応思考（adaptive thinking）で複雑な物理関係を推論
+- JSON 出力対応（CI/CD 統合）
+
+## インストール
+
+### PyPI（CLI ツール）
+
+```bash
+pip install decklens-semantic-diff
+```
+
+### VS Code 拡張機能
+
+1. VS Code Marketplace で「DeckLens」検索
+2. インストール
+3. `.env` に `ANTHROPIC_API_KEY` 設定（AI 分析有効化）
+
+## 使い方
+
+### CLI
+
+```bash
+# 基本的な diff
+decklens diff before.rad after.rad
+
+# AI 分析をスキップ
+decklens diff before.rad after.rad --no-ai
+
+# JSON 出力（CI/CD 連携）
+decklens diff before.rad after.rad --format json
+
+# 重大度フィルタ
+decklens diff before.rad after.rad --min-severity WARNING
+
+# 別の Claude モデル指定
+decklens diff before.rad after.rad --model claude-sonnet-4-6
+```
+
+### VS Code 拡張機能
+
+右クリック → **DeckLens: Compare with** → ファイル選択 → サイドパネルに結果表示
+
+## 対応フォーマット
+
+| フォーマット | サポート | ロードマップ |
+|------------|---------|-----------|
+| OpenRadioss (.rad) | ✅ | 本実装 |
+| NASTRAN (.bdf) | 🔜 | Q3 2026 |
+| LS-DYNA (.k) | 🔜 | Q3 2026 |
+
+## 技術仕様
+
+- **言語**: Python 3.11+（CLI）、TypeScript（VS Code 拡張）
+- **API**: Claude Opus 4.8、adaptive thinking、high effort
+- **出力**: Rich テーブル、Markdown、JSON
+- **ライセンス**: MIT
+
+## 必要な環境
+
+- Python 3.11+
+- VS Code 1.85+（拡張機能使用時）
+- ANTHROPIC_API_KEY（AI 分析機能使用時）
+
+## トラブルシューティング
+
+### Q: AI 分析が実行されない
+**A**: `.env` に `ANTHROPIC_API_KEY` が設定されているか確認。未設定なら `--no-ai` を付与。
+
+### Q: 出力が文字化けする（Windows）
+**A**: PowerShell で UTF-8 出力を有効化：
+```powershell
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+```
+
+## 開発
+
+```bash
+git clone https://github.com/YOUR_GITHUB_USERNAME/DeckLens-Semantic-Diff-for-CAE.git
+cd DeckLens-Semantic-Diff-for-CAE
+pip install -e ".[dev]"
+pytest -v
+```
+
+## フィードバック
+
+Issue や Discussion は [GitHub](https://github.com/YOUR_GITHUB_USERNAME/DeckLens-Semantic-Diff-for-CAE/issues) へ。
+
+---
+
+**Made with ❤️ by CAE engineers, for CAE engineers**

decklens-0.1.0/decklens/__init__.py

@@ -0,0 +1,3 @@
+"""DeckLens Semantic Diff for CAE — OpenRadioss input file analysis."""
+
+__version__ = "0.1.0"

decklens-0.1.0/decklens/cli.py

@@ -0,0 +1,199 @@
+"""CLI entry point for DeckLens Semantic Diff."""
+
+from __future__ import annotations
+
+import json
+import sys
+from pathlib import Path
+
+import click
+from rich.columns import Columns
+from rich.console import Console
+from rich.panel import Panel
+from rich.table import Table
+from rich.text import Text
+
+from .diff.engine import Change, DiffEngine
+from .parsers.openradioss import parse_deck
+
+def _make_console() -> Console:
+    import sys
+    if sys.platform == "win32":
+        try:
+            sys.stdout.reconfigure(encoding="utf-8", errors="replace")  # type: ignore[attr-defined]
+            sys.stderr.reconfigure(encoding="utf-8", errors="replace")  # type: ignore[attr-defined]
+        except (AttributeError, Exception):
+            pass
+    return Console(highlight=False, safe_box=True)
+
+
+console = _make_console()
+
+_SEVERITY_STYLE = {
+    "CRITICAL": "bold red",
+    "WARNING":  "bold yellow",
+    "INFO":     "cyan",
+}
+_SEVERITY_LABEL = {
+    "CRITICAL": "CRIT",
+    "WARNING":  "WARN",
+    "INFO":     "INFO",
+}
+
+
+def _fmt_value(v, unit: str | None) -> str:
+    if v is None:
+        return "-"
+    u = f" {unit}" if unit else ""
+    if isinstance(v, float):
+        return f"{v:g}{u}"
+    return f"{v}{u}"
+
+
+def _pct_text(pct: float | None) -> Text:
+    if pct is None:
+        return Text("")
+    sign = "+" if pct > 0 else ""
+    color = "red" if abs(pct) >= 20 else "yellow" if abs(pct) >= 5 else "green"
+    return Text(f"{sign}{pct:.1f}%", style=color)
+
+
+def _build_table(changes: list[Change]) -> Table:
+    table = Table(
+        show_header=True,
+        header_style="bold white on dark_blue",
+        border_style="bright_black",
+        safe_box=True,
+    )
+    table.add_column("Sev",       style="bold",  no_wrap=True)
+    table.add_column("Category",  no_wrap=True)
+    table.add_column("Type / ID", no_wrap=True)
+    table.add_column("Name")
+    table.add_column("Field",     ratio=2)
+    table.add_column("Before",    justify="right", no_wrap=True)
+    table.add_column("After",     justify="right", no_wrap=True)
+    table.add_column("Change",    justify="right", no_wrap=True)
+
+    for ch in changes:
+        style = _SEVERITY_STYLE[ch.severity]
+        icon = Text("[" + _SEVERITY_LABEL[ch.severity] + "]", style=style)
+        table.add_row(
+            icon,
+            Text(ch.category, style="dim"),
+            Text(f"{ch.item_type}/{ch.item_id}", style="bright_white"),
+            Text(str(ch.item_name), style="white"),
+            Text(str(ch.field)),
+            Text(_fmt_value(ch.old_value, None)),
+            Text(_fmt_value(ch.new_value, ch.unit)),
+            _pct_text(ch.percent_change),
+        )
+
+    return table
+
+
+def _build_summary(changes: list[Change]) -> Panel:
+    counts = {"CRITICAL": 0, "WARNING": 0, "INFO": 0}
+    for ch in changes:
+        counts[ch.severity] += 1
+
+    parts = []
+    for sev in ("CRITICAL", "WARNING", "INFO"):
+        n = counts[sev]
+        style = _SEVERITY_STYLE[sev]
+        parts.append(Text(f"  {n} {sev}  ", style=style))
+
+    content = Text("").join(parts)
+    return Panel(content, title="[bold]Summary", expand=False)
+
+
+@click.group()
+@click.version_option(package_name="DeckLens-Semantic-Diff-for-CAE")
+def main() -> None:
+    """DeckLens: Semantic Diff for CAE input files."""
+
+
+@main.command()
+@click.argument("before", type=click.Path(exists=True, path_type=Path))
+@click.argument("after", type=click.Path(exists=True, path_type=Path))
+@click.option("--no-ai", is_flag=True, default=False, help="Skip Claude AI analysis.")
+@click.option(
+    "--format", "output_format",
+    type=click.Choice(["text", "json"], case_sensitive=False),
+    default="text",
+    help="Output format.",
+)
+@click.option("--model", default="claude-opus-4-8", show_default=True,
+              help="Claude model ID for AI analysis.")
+@click.option("--min-severity",
+              type=click.Choice(["INFO", "WARNING", "CRITICAL"], case_sensitive=False),
+              default="INFO", show_default=True,
+              help="Minimum severity level to display.")
+def diff(
+    before: Path,
+    after: Path,
+    no_ai: bool,
+    output_format: str,
+    model: str,
+    min_severity: str,
+) -> None:
+    """Compare two OpenRadioss deck files and show engineering-aware changes.
+
+    BEFORE and AFTER are paths to .rad input files.
+    """
+    _sev_rank = {"INFO": 0, "WARNING": 1, "CRITICAL": 2}
+    min_rank = _sev_rank[min_severity.upper()]
+
+    # Parse
+    with console.status("[bold green]Parsing decks...", spinner="dots"):
+        try:
+            deck_before = parse_deck(before)
+            deck_after = parse_deck(after)
+        except Exception as exc:
+            console.print(f"[red]Parse error: {exc}")
+            sys.exit(1)
+
+    # Diff
+    engine = DiffEngine()
+    all_changes = engine.diff(deck_before, deck_after)
+    changes = [ch for ch in all_changes if _sev_rank[ch.severity] >= min_rank]
+
+    if output_format == "json":
+        import dataclasses
+        click.echo(json.dumps([dataclasses.asdict(ch) for ch in changes], indent=2))
+        return
+
+    # Rich text output
+    console.print()
+    console.rule(f"[bold blue]DeckLens Semantic Diff")
+    console.print(f"  [dim]Before:[/dim] [white]{before}")
+    console.print(f"  [dim]After: [/dim] [white]{after}")
+    console.print()
+
+    if not changes:
+        console.print("[green]No changes found above the specified severity threshold.[/green]")
+        return
+
+    console.print(_build_summary(all_changes))
+    console.print()
+    console.print(_build_table(changes))
+
+    # AI analysis
+    if not no_ai:
+        try:
+            from dotenv import load_dotenv
+            load_dotenv()
+        except ImportError:
+            pass
+
+        import os
+        if not os.environ.get("ANTHROPIC_API_KEY"):
+            console.print(
+                "\n[yellow]Tip: Set ANTHROPIC_API_KEY in .env for AI analysis. "
+                "Use --no-ai to suppress this message.[/yellow]"
+            )
+            return
+
+        from .explainer.claude import ClaudeExplainer
+        with console.status("[bold green]Generating AI analysis...", spinner="dots"):
+            explainer = ClaudeExplainer(model=model)
+        explainer.explain(changes, str(before), str(after), console=console)

decklens-0.1.0/decklens/diff/__init__.py

@@ -0,0 +1,3 @@
+from .engine import Change, DiffEngine
+
+__all__ = ["Change", "DiffEngine"]