@unlaxer/dde-toolkit 0.1.5 → 0.1.7

package/flows/quick.yaml

@@ -16,6 +16,10 @@ workflow:
     - id: scan_glossary
       display_name: "既存 glossary をスキャン"
       note: "docs/glossary/ の既存記事一覧を収集。相互リンク候補 + 抽出除外リストに使う"
+    - id: detect_template
+      display_name: "記事テンプレートを確定"
+      mode: confirm
+      note: ".dde-template.md があれば再利用。なければ既存記事の H2 を多数決で抽出 → ユーザー確認 → 保存"
     - id: select_docs
       display_name: "対象ドキュメント群を選択"
       mode: confirm

package/lib/markdown.js

@@ -85,6 +85,7 @@ export function processMarkdown(content, dictionary, lang = 'en', sourceFile = n
  * テキスト内で用語の置換箇所を検出する
  * - 段落ごとに 1 用語 1 回まで
  * - 最長一致（辞書はすでに降順ソート済み）
+ * - ASCII 用語は単語境界チェックを適用（複合語内マッチを防ぐ）
  */
 function findReplacements(text, dictionary, alreadyMatched, lang) {
   // 使用済み範囲を追跡（重複マッチ防止）
@@ -95,7 +96,20 @@ function findReplacements(text, dictionary, alreadyMatched, lang) {
     if (entry.lang !== lang && entry.lang !== 'en') continue;
     if (alreadyMatched.has(entry.term)) continue;
 
-    const idx = text.indexOf(entry.term);
+    // 単語境界チェックが必要な ASCII 用語は、条件を満たす最初の出現を探す
+    let idx = -1;
+    const needsBoundary = isAsciiTerm(entry.term);
+    let searchFrom = 0;
+    while (true) {
+      const found = text.indexOf(entry.term, searchFrom);
+      if (found === -1) break;
+      if (needsBoundary && !hasWordBoundary(text, found, found + entry.term.length)) {
+        searchFrom = found + 1;
+        continue;
+      }
+      idx = found;
+      break;
+    }
     if (idx === -1) continue;
 
     // 重複範囲チェック
@@ -113,6 +127,23 @@ function findReplacements(text, dictionary, alreadyMatched, lang) {
   return replacements;
 }
 
+/**
+ * 用語が ASCII 文字のみで構成されているか（日本語等は除外）
+ */
+function isAsciiTerm(term) {
+  return /^[\x00-\x7F]+$/.test(term);
+}
+
+/**
+ * text[start..end] の前後が単語文字（\w）でないか確認する
+ */
+function hasWordBoundary(text, start, end) {
+  const wordChar = /\w/;
+  if (start > 0 && wordChar.test(text[start - 1])) return false;
+  if (end < text.length && wordChar.test(text[end])) return false;
+  return true;
+}
+
 /**
  * テキストと置換リストから AST ノード配列を生成
  * @param {string} sourceFile - リンクを埋め込むファイルのパス（相対パス計算用）
@@ -185,7 +216,21 @@ export function findUnlinked(content, dictionary, lang = 'en') {
 
     for (const entry of dictionary) {
       if (entry.lang !== lang && entry.lang !== 'en') continue;
-      if (node.value.includes(entry.term)) {
+      const text = node.value;
+      const needsBoundary = isAsciiTerm(entry.term);
+      let found = false;
+      let searchFrom = 0;
+      while (true) {
+        const idx = text.indexOf(entry.term, searchFrom);
+        if (idx === -1) break;
+        if (needsBoundary && !hasWordBoundary(text, idx, idx + entry.term.length)) {
+          searchFrom = idx + 1;
+          continue;
+        }
+        found = true;
+        break;
+      }
+      if (found) {
         const key = entry.term;
         if (!unlinked.has(key)) {
           unlinked.set(key, { term: entry.term, file: entry.file, count: 0 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unlaxer/dde-toolkit",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "Document Deficit Extraction — find what's not understood in your docs",
   "license": "MIT",
   "type": "module",

package/skills/dde-session.md

@@ -67,10 +67,11 @@ DDE toolkit v0.1.3 — Document Deficit Extraction
 新規セッションの場合は skip。
 
 **0-C: 既存 glossary スキャン（MUST）**
-`docs/glossary/` の `.md` ファイル一覧を収集する。これを 2 つの目的に使う:
+`docs/glossary/` の `.md` ファイル一覧を収集する。これを 3 つの目的に使う:
 
 1. **抽出除外リスト** — 既存記事がある用語は抽出対象から除外（Step 6）
 2. **相互リンク候補リスト** — 「さらに学ぶために」で使えるリンク一覧（Step 7）
+3. **テンプレート抽出** — 既存記事の H2 構造を分析してフォーマットを確定（後述）
 
 ```
 既存 glossary: 12 記事
@@ -81,6 +82,72 @@ DDE toolkit v0.1.3 — Document Deficit Extraction
 
 ファイルが存在しない場合は空リストで OK（新規プロジェクト）。
 
+**0-D: 記事テンプレートの確定**
+
+まず `docs/glossary/.dde-template.md` が存在するか確認する。
+
+- **存在する場合**: そのテンプレートを使用（再分析不要。ユーザーに「既存テンプレートを使用します」と通知）
+- **存在しない場合**: 以下の手順でテンプレートを抽出する
+
+**テンプレート自動抽出手順:**
+1. 既存 `.md` ファイルから **EN 用と JA 用それぞれ** 3〜5 件をサンプリング（辞書順）
+2. 各ファイルの H2 見出し（`## ...`）を列挙
+3. **多数決**で共通パターンを確定（過半数のファイルに存在する見出しを採用）
+4. ユーザーに確認・修正を求める:
+
+```
+既存 glossary のセクション構造を検出しました:
+
+EN 記事テンプレート:
+  ## What is it?
+  ## Why does it matter?
+  ## How does it work?
+  ## How does [project] use it?
+  ## Common mistakes / attacks
+  ## Further reading
+
+JA 記事テンプレート:
+  ## これは何？
+  ## なぜ重要なのか？
+  ## どう動くのか？
+  ## [project] ではどう使われている？
+  ## よくある間違いと攻撃
+  ## さらに学ぶ
+
+このテンプレートで記事を生成します。修正しますか？
+1. このまま使う（推奨）
+2. 修正する
+3. デフォルト（DDE educational format）を使う
+```
+
+5. 確定後、`docs/glossary/.dde-template.md` に保存する（次回セッションで再利用）
+
+**`.dde-template.md` のフォーマット:**
+```markdown
+<!-- DDE auto-detected template — edit freely -->
+<!-- generated: 2024-01-15 from 5 sample articles -->
+
+## en
+
+## What is it?
+## Why does it matter?
+## How does it work?
+## How does [project] use it?
+## Common mistakes / attacks
+## Further reading
+
+---
+
+## ja
+
+## これは何？
+## なぜ重要なのか？
+## どう動くのか？
+## [project] ではどう使われている？
+## よくある間違いと攻撃
+## さらに学ぶ
+```
+
 **CRITICAL RULE — 相互リンク**:
 「さらに学ぶために」に書くリンクは、**記事生成時点で `docs/glossary/` に実在するファイルのみ**。
 存在しないファイルへのリンクは絶対に書かない。同一バッチで新規生成する記事同士は相互リンク可。
@@ -142,15 +209,14 @@ DDE toolkit v0.1.3 — Document Deficit Extraction
 
 **文字数ではなく「読んだ人にどうなってほしいか」で指定する。**
 
-Step 0-C で既存 glossary 記事が見つかった場合は、まずそのスタイルを分析して選択肢に追加する。
+Step 0-D で確定したテンプレートを使用する。既存 glossary 記事が見つかった場合は「既存に合わせる」が推奨。
 
 **既存記事がある場合の表示例:**
 ```
-既存 glossary のスタイルを分析しました:
-  → educational narrative（例え話・ASCIIダイアグラム・相互リンクあり）
+テンプレート: docs/glossary/.dde-template.md（5 件から抽出済み）
 
 記事のインテントを選んでください:
-1. 既存に合わせる（推奨）— 既存記事のスタイル・分量・構成を踏襲
+1. 既存に合わせる（推奨）— Step 0-D で確定したテンプレート構成を使用
 2. educational — 背景・動機・仕組みごと理解できる記事
                  例え話・図・なぜ？を含む。分量は目的に従って自然に決まる
 3. reference   — 定義と使い方を簡潔に。調べたい人向け

package/version.txt

@@ -1 +1 @@
-0.1.5
+0.1.7