dr-gen 0.1.2 → 0.1.4

package/README.md

@@ -1,9 +1,9 @@
 # decision-record-generator (dr-gen)
 
 Generate lightweight Decision Records (DRs) from `decision.yaml`.
-Built for fast-moving teams who need a small, reproducible “evidence trail” of decisions (why/rule) for handoffs, audits, and security questionnaires.
+Built for fast-moving teams who need a small, reproducible “evidence trail” of decisions (why/decision) for handoffs, audits, and security questionnaires.
 
-（日本語）引き継ぎ・監査対応・セキュリティに関する確認（質問対応）のために、意思決定（Why / Rule）を小さく・再現可能な形で残すDRジェネレーターです。`decision.yaml` から Markdown / JSON を生成し、`manifest.json` の SHA256 ハッシュで改ざん検知できます。
+日本語は下の「Japanese (日本語)」セクションにまとめています。
 
 **Outputs (4 files)**
 - `decision-record.md` (human-readable)
@@ -11,10 +11,54 @@ Built for fast-moving teams who need a small, reproducible “evidence trail”
 - `repro.md` (reproducibility notes)
 - `manifest.json` (SHA256 hashes for tamper detection)
 
+## Input (decision.yaml)
+
+All fields except `title` are optional. Empty strings are OK.
+
+```yaml
+title: "Use PostgreSQL for user data" # required
+date: "2024-01-15"                   # optional (YYYY-MM-DD)
+decider: "Alice (PM)"                # optional
+
+# ADR-style lifecycle (optional)
+status: "accepted"                   # optional: accepted | deprecated | superseded
+
+# Tip: dr-gen is designed for post-decision records. For drafts, use `dr-gen new --skip-generate` instead of managing a "proposed" lifecycle.
+
+# Linking DRs when a decision changes:
+# - Recommended (minimal): set `supersedes` on the newer DR.
+supersedes: ""                        # optional: link/id/path of the older DR (recommended)
+
+context: ""                           # optional
+why: ""                               # optional
+rule: ""                              # optional (the decision/policy; rendered as "Decision" in decision-record.md)
+alternatives: ""                      # optional
+consequences: ""                      # optional
+tags: []                               # optional
+```
+
+If a decision is reversed later, prefer creating a new DR and setting `supersedes` on the new DR (rather than rewriting history).
+
 ## Operations (Drive / Box)
 
-If you store DRs in Drive / Box (common for non-developers), see:
-- [DRIVE_BOX_OPERATION_GUIDE.md](DRIVE_BOX_OPERATION_GUIDE.md)
+If you store DRs in Drive / Box (common for non-developers), see this guide (Japanese):
+- [DRIVE_BOX_OPERATION_GUIDE.md](https://github.com/Ineeza/decision-record-generator/blob/main/DRIVE_BOX_OPERATION_GUIDE.md)
+
+## Verify (integrity / tamper detection)
+
+To verify that generated files were not modified after generation, run:
+
+```bash
+dr-gen verify out/<date>__<title>__<id>/
+```
+
+Without installing globally:
+
+```bash
+npx dr-gen@latest verify out/<date>__<title>__<id>/
+```
+
+This checks `decision-record.md`, `summary.json`, and `repro.md` against hashes in `manifest.json`.
 
 ## Fastest try (npm)
 
@@ -33,7 +77,15 @@ If you don't want to write YAML by hand:
 dr-gen new
 ```
 
-This asks for the minimum useful info (Title + Why + Rule). Other fields are optional.
+Japanese prompts:
+
+```bash
+dr-gen new --lang ja
+```
+
+You can also set `DR_GEN_LANG=ja`.
+
+This asks for the minimum useful info (Title + Why + Decision). Other fields are optional.
 By default, `date` is set to today's date (YYYY-MM-DD). To disable this:
 
 ```bash
@@ -44,6 +96,14 @@ By default this creates:
 - `in/<date>__<title>__<id>/decision.yaml`
 - `out/<date>__<title>__<id>/` (generated files)
 
+If you want to fill more fields (status/alternatives/etc) before generating outputs, use:
+
+```bash
+dr-gen new --skip-generate
+```
+
+Then edit the generated `decision.yaml`, and run `dr-gen generate`.
+
 ## Quickstart
 
 ```bash
@@ -98,30 +158,127 @@ If you prefer a different base output directory:
 dr-gen generate decision.yaml --out-dir some-dir
 ```
 
-### 日本語の入力について
+## CLI
 
-- `decision.yaml` は UTF-8 を想定しています。値（title / why など）は日本語でも問題ありません。
-	生成される `decision-record.md` / `summary.json` / `repro.md` にも、そのまま出力されます。
-- 現時点では CLI のコマンド名・ヘルプ表示は英語です（ドキュメントで補足しています）。
-	需要があれば日本語表示（i18n）も検討します。
+```bash
+dr-gen generate decision.yaml
+```
 
-## CLI
+Other commands:
+
+```bash
+dr-gen new
+dr-gen verify out/<date>__<title>__<id>/
+dr-gen list --from 2026-01-01 --to 2026-01-31
+
+# Japanese report labels
+dr-gen list --from 2026-01-01 --to 2026-01-31 --lang ja
+
+# Optional: keep the Decision line on one terminal line
+dr-gen list --from 2026-01-01 --to 2026-01-31 --max-decision-len 60
+```
+
+---
+
+## Japanese (日本語)
+
+引き継ぎ・監査対応・セキュリティに関する確認（質問対応）のために、意思決定（Why / Decision）を小さく・再現可能な形で残すDRジェネレーターです。`decision.yaml` から Markdown / JSON を生成し、`manifest.json` の SHA256 ハッシュで改ざん検知できます。
+
+### 最速で試す（npm）
 
 ```bash
+npm install -g dr-gen
+
+# decision.yaml が無い場合はテンプレを作成します
 dr-gen generate decision.yaml
 ```
 
-## ライセンスについて
+### YAMLなし（対話形式）
+
+```bash
+dr-gen new
+```
+
+日本語で質問を表示する場合:
+
+```bash
+dr-gen new --lang ja
+```
+
+環境変数で指定することもできます（例: `DR_GEN_LANG=ja`）。
+
+Title / Why / Decision を中心に入力します（他は任意）。`--no-date` で日付自動入力を無効にできます。
+
+`status` / `alternatives` などを追記してから生成したい場合は、まず `decision.yaml` だけ作るのがおすすめです。
+
+```bash
+dr-gen new --skip-generate
+```
+
+その後、生成された `decision.yaml` を編集してから `dr-gen generate` を実行します。
+
+### 検証（改ざん検知）
+
+生成後のファイルが変更されていないか確認するには、`manifest.json` と照合します。
+
+```bash
+npx dr-gen@latest verify out/<date>__<title>__<id>/
+```
+
+### 一覧（レポート出力）
+
+期間を指定して、コピペしやすい Markdown レポートを標準出力に出します。
+
+```bash
+dr-gen list --from 2026-01-01 --to 2026-01-31
+
+# レポート文言を日本語にする
+dr-gen list --from 2026-01-01 --to 2026-01-31 --lang ja
+
+# 任意: Decision 行の文字数上限（デフォルト: 80）
+dr-gen list --from 2026-01-01 --to 2026-01-31 --max-decision-len 60
+```
+
+### Drive / Box 運用
+
+非エンジニアの運用で Drive / Box に保存する場合は、ガイドを参照してください。
+
+- [DRIVE_BOX_OPERATION_GUIDE.md](https://github.com/Ineeza/decision-record-generator/blob/main/DRIVE_BOX_OPERATION_GUIDE.md)
+
+### 入力（decision.yaml）
+
+`title` 以外はすべて任意です。空文字でもOKです。
+
+```yaml
+title: "ユーザーデータはPostgreSQLを使う" # 必須
+date: "2024-01-15"                      # 任意（YYYY-MM-DD）
+decider: "Alice (PM)"                   # 任意
+
+# ADR風のライフサイクル管理（任意）
+status: "accepted"                      # 任意: accepted | deprecated | superseded
+
+# Tip: dr-gen は「決定後に残す」用途がメインです。下書きは `dr-gen new --skip-generate` で YAML だけ作るのがおすすめです。
+
+# DRのリンク（判断が変わったとき）:
+# - 推奨（最小運用）: 新しいDRに `supersedes` を書く
+supersedes: ""                           # 任意: 以前のDRのリンク/ID/パス（推奨）
+
+context: ""                              # 任意
+why: ""                                  # 任意
+rule: ""                                 # 任意（決めたこと/方針。decision-record.md では "Decision" として表示）
+alternatives: ""                         # 任意
+consequences: ""                         # 任意
+tags: []                                  # 任意
+```
+
+後から判断が覆った場合は、既存DRを書き換えるよりも「新しいDRを作り、新DRに `supersedes` を書く」運用がおすすめです。
+
 
-本ソフトウェアは MIT License のもとで
-OSS として無料で提供しています。
+### ライセンスについて
 
-個人・法人を問わず利用可能です。
+本ソフトウェアは MIT License のもとで OSS として無料で提供しています（個人・法人を問わず利用可能です）。
 
-組織・チームでの利用において、
-サポート、利用条件の明確化、
-継続的な提供が必要な場合は、
-法人契約をご検討ください。
+組織・チームでの利用において、サポート、利用条件の明確化、継続的な提供が必要な場合は、法人契約をご検討ください。
 
 法人契約はこちら:
 https://www.ineeza.com/

package/dist/cli.js

@@ -10,7 +10,9 @@ import { decisionFolderName } from './naming.js';
 import { promptDecisionRecord } from './interactive.js';
 import { renderDecisionYaml } from './yaml.js';
 import { verifyOutDir } from './verify.js';
-import { generatedOutputLines, missingCoreFieldsLines, signatureIgnoredLines, templateCreatedLines, wroteInputLines } from './messages.js';
+import { areTitleAndRuleTooSimilar } from './text.js';
+import { listDecisions, renderListReportMarkdown } from './list.js';
+import { generatedOutputLines, missingCoreFieldsLines, signatureIgnoredLines, skippedGenerateLines, templateCreatedLines, titleRuleTooSimilarLines, wroteInputLines } from './messages.js';
 function getToolVersion() {
     try {
         const require = createRequire(import.meta.url);
@@ -21,6 +23,19 @@ function getToolVersion() {
         return undefined;
     }
 }
+function resolveLang(cliLangRaw) {
+    const cliLang = (cliLangRaw ?? '').trim().toLowerCase();
+    const envLang = (process.env.DR_GEN_LANG ?? '').trim().toLowerCase();
+    const candidate = cliLang.length > 0 ? cliLang : envLang;
+    if (candidate === 'ja' || candidate === 'jp' || candidate === 'japanese')
+        return 'ja';
+    if (candidate === 'en' || candidate === 'english')
+        return 'en';
+    const locale = `${process.env.LC_ALL ?? ''} ${process.env.LC_MESSAGES ?? ''} ${process.env.LANG ?? ''}`.toLowerCase();
+    if (locale.includes('ja'))
+        return 'ja';
+    return 'en';
+}
 async function fileExists(filePath) {
     try {
         await fs.stat(filePath);
@@ -77,6 +92,25 @@ function warnIfMissingCoreFields(record, inputPath) {
         }
     }
 }
+function warnIfTitleRuleTooSimilar(record, lang) {
+    const rule = record.rule ?? '';
+    if (areTitleAndRuleTooSimilar(record.title, rule)) {
+        for (const line of titleRuleTooSimilarLines(lang)) {
+            console.warn(line);
+        }
+    }
+}
+function parsePositiveIntOrThrow(value, label) {
+    const trimmed = value.trim();
+    if (trimmed.length === 0) {
+        throw new Error(`${label} must be a positive integer.`);
+    }
+    const n = Number.parseInt(trimmed, 10);
+    if (!Number.isFinite(n) || Number.isNaN(n) || n <= 0) {
+        throw new Error(`${label} must be a positive integer (got: ${value}).`);
+    }
+    return n;
+}
 async function main(argv) {
     const program = new Command();
     const toolVersion = getToolVersion();
@@ -107,6 +141,7 @@ async function main(argv) {
         }
         const record = await parseDecisionYaml(input);
         warnIfMissingCoreFields(record, input);
+        warnIfTitleRuleTooSimilar(record, resolveLang(undefined));
         const baseOutDir = options.outDir;
         const folder = decisionFolderName(record);
         const finalOutDir = await findAvailableDirPath(baseOutDir, folder);
@@ -134,10 +169,14 @@ async function main(argv) {
         .option('--in-dir <dir>', 'Base directory for inputs', 'in')
         .option('-p, --path <file>', 'Where to write decision.yaml (overrides --in-dir)', '')
         .option('-o, --out-dir <dir>', 'Output directory (created if missing)', 'out')
+        .option('--lang <lang>', 'Language for prompts (en|ja). Also supports DR_GEN_LANG env var.', '')
         .option('--no-date', 'Do not auto-fill date')
+        .option('--skip-generate', 'Only write decision.yaml and do not generate output files', false)
         .option('--force', 'Overwrite decision.yaml if it already exists', false)
         .action(async (options) => {
-        const record = await promptDecisionRecord({ includeDate: options.date });
+        const lang = resolveLang(options.lang);
+        const record = await promptDecisionRecord({ includeDate: options.date, lang });
+        warnIfTitleRuleTooSimilar(record, lang);
         const desiredFolder = decisionFolderName(record);
         const decisionDirName = await findAvailableDecisionDirName(options.inDir, options.outDir, desiredFolder);
         const yamlPath = options.path.trim().length > 0 ? options.path : path.join(options.inDir, decisionDirName, 'decision.yaml');
@@ -149,6 +188,12 @@ async function main(argv) {
         for (const line of wroteInputLines(yamlPath)) {
             console.log(line);
         }
+        if (options.skipGenerate) {
+            for (const line of skippedGenerateLines(yamlPath, options.outDir, lang)) {
+                console.log(line);
+            }
+            return;
+        }
         const finalOutDir = path.join(options.outDir, decisionDirName);
         const command = `dr-gen new${options.date ? '' : ' --no-date'} --in-dir ${options.inDir} --out-dir ${options.outDir}`;
         await generateDecisionRecordFiles(record, {
@@ -190,6 +235,30 @@ async function main(argv) {
         }
         process.exitCode = 2;
     });
+    program
+        .command('list')
+        .description('List generated decision records and print a copy-pasteable report')
+        .option('-o, --out-dir <dir>', 'Base output directory to scan', 'out')
+        .option('--from <YYYY-MM-DD>', 'Start date (inclusive) based on folder name prefix', '')
+        .option('--to <YYYY-MM-DD>', 'End date (inclusive) based on folder name prefix', '')
+        .option('--lang <lang>', 'Language for report labels (en|ja). Also supports DR_GEN_LANG env var.', '')
+        .option('--max-decision-len <n>', 'Max characters for the Decision line in the report (default: 80)', '80')
+        .action(async (options) => {
+        const from = options.from.trim().length > 0 ? options.from.trim() : undefined;
+        const to = options.to.trim().length > 0 ? options.to.trim() : undefined;
+        const maxDecisionLen = parsePositiveIntOrThrow(options.maxDecisionLen, '--max-decision-len');
+        const lang = resolveLang(options.lang);
+        const items = await listDecisions({ outDir: options.outDir, from, to });
+        const report = renderListReportMarkdown(items, {
+            outDir: options.outDir,
+            from,
+            to,
+            generatedAtIso: new Date().toISOString(),
+            maxDecisionLen,
+            lang
+        });
+        console.log(report);
+    });
     await program.parseAsync(argv);
 }
 main(process.argv).catch((error) => {

package/dist/generator.js

@@ -16,6 +16,10 @@ function renderRecordMarkdown(record) {
         meta.push(`**Date**: ${record.date}`);
     if (record.decider !== undefined && record.decider.length > 0)
         meta.push(`**Decider**: ${record.decider}`);
+    if (record.status !== undefined && record.status.length > 0)
+        meta.push(`**Status**: ${record.status}`);
+    if (record.supersedes !== undefined && record.supersedes.length > 0)
+        meta.push(`**Supersedes**: ${record.supersedes}`);
     if (meta.length > 0) {
         lines.push(meta.join('  \n'));
         lines.push('');
@@ -26,7 +30,7 @@ function renderRecordMarkdown(record) {
     lines.push('## Why');
     lines.push(record.why ?? '');
     lines.push('');
-    lines.push('## Rule');
+    lines.push('## Decision');
     lines.push(record.rule ?? '');
     lines.push('');
     lines.push('## Alternatives Considered');
@@ -148,6 +152,8 @@ export async function generateDecisionRecordFiles(record, options = {}) {
         title: record.title,
         date: record.date,
         decider: record.decider,
+        status: record.status,
+        supersedes: record.supersedes,
         tags: record.tags,
         files: {
             record: OUTPUT_FILES.record,

package/dist/interactive.js

@@ -8,10 +8,13 @@ function todayLocalIsoDate() {
     const day = String(now.getDate()).padStart(2, '0');
     return `${year}-${month}-${day}`;
 }
-function requiredNonEmpty(label, value) {
+function requiredNonEmpty(labelEn, labelJa, value, lang) {
     const trimmed = value.trim();
     if (trimmed.length === 0) {
-        throw new Error(`${label} is required (cannot be empty).`);
+        if (lang === 'ja') {
+            throw new Error(`${labelJa}は必須です（空欄不可）。`);
+        }
+        throw new Error(`${labelEn} is required (cannot be empty).`);
     }
     return trimmed;
 }
@@ -23,13 +26,13 @@ export async function promptDecisionRecord(options) {
     const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
     try {
         const todayIsoDate = todayLocalIsoDate();
-        for (const line of newIntroLines({ includeDate: options.includeDate, todayIsoDate })) {
+        for (const line of newIntroLines({ includeDate: options.includeDate, todayIsoDate }, options.lang)) {
             console.log(line);
         }
-        const title = requiredNonEmpty('Title', await rl.question(newTitlePrompt()));
-        const why = requiredNonEmpty('Why', await rl.question(newWhyPrompt()));
-        const rule = requiredNonEmpty('Rule', await rl.question(newRulePrompt()));
-        const context = optionalTrimmed(await rl.question(newContextPrompt()));
+        const title = requiredNonEmpty('Title', 'タイトル', await rl.question(newTitlePrompt(options.lang)), options.lang);
+        const why = requiredNonEmpty('Why', 'Why', await rl.question(newWhyPrompt(options.lang)), options.lang);
+        const rule = requiredNonEmpty('Rule', 'Rule', await rl.question(newRulePrompt(options.lang)), options.lang);
+        const context = optionalTrimmed(await rl.question(newContextPrompt(options.lang)));
         const date = options.includeDate ? todayIsoDate : undefined;
         return { title, date, why, rule, context };
     }

package/dist/list.js

@@ -0,0 +1,230 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+const ISO_DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+export function assertIsoDateOrThrow(value, label) {
+    if (!ISO_DATE_RE.test(value)) {
+        throw new Error(`${label} must be YYYY-MM-DD (got: ${value})`);
+    }
+}
+function extractFolderDate(folderName) {
+    // Folder naming is expected to start with YYYY-MM-DD__
+    if (folderName.length < 12)
+        return undefined;
+    const candidate = folderName.slice(0, 10);
+    if (!ISO_DATE_RE.test(candidate))
+        return undefined;
+    if (folderName.slice(10, 12) !== '__')
+        return undefined;
+    return candidate;
+}
+async function readSummaryJson(outDir) {
+    try {
+        const raw = await fs.readFile(path.join(outDir, 'summary.json'), 'utf8');
+        const parsed = JSON.parse(raw);
+        if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed))
+            return undefined;
+        const obj = parsed;
+        const asOptionalString = (v) => (typeof v === 'string' ? v : undefined);
+        return {
+            title: asOptionalString(obj.title),
+            date: asOptionalString(obj.date),
+            decider: asOptionalString(obj.decider),
+            status: asOptionalString(obj.status),
+            supersedes: asOptionalString(obj.supersedes)
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+function extractSectionFirstLine(markdown, header) {
+    const lines = markdown.split(/\r?\n/);
+    let inRule = false;
+    for (let i = 0; i < lines.length; i += 1) {
+        const line = lines[i] ?? '';
+        if (!inRule) {
+            if (line.trim() === header) {
+                inRule = true;
+            }
+            continue;
+        }
+        // Stop if next section starts.
+        if (line.startsWith('## '))
+            return undefined;
+        const trimmed = line.trim();
+        if (trimmed.length === 0)
+            continue;
+        // Keep the excerpt single-line.
+        return trimmed.replace(/\s+/g, ' ');
+    }
+    return undefined;
+}
+function extractDecisionExcerptFromRecordMarkdown(markdown) {
+    // Prefer the newer heading, but remain backward compatible.
+    return (extractSectionFirstLine(markdown, '## Decision') ??
+        extractSectionFirstLine(markdown, '## Rule'));
+}
+async function readRuleExcerpt(outDir) {
+    try {
+        const md = await fs.readFile(path.join(outDir, 'decision-record.md'), 'utf8');
+        return extractDecisionExcerptFromRecordMarkdown(md);
+    }
+    catch {
+        return undefined;
+    }
+}
+function withinRange(date, from, to) {
+    // ISO date strings compare lexicographically.
+    if (from !== undefined && date < from)
+        return false;
+    if (to !== undefined && date > to)
+        return false;
+    return true;
+}
+export async function listDecisions(options) {
+    const from = options.from?.trim();
+    const to = options.to?.trim();
+    if (from !== undefined && from.length > 0)
+        assertIsoDateOrThrow(from, '--from');
+    if (to !== undefined && to.length > 0)
+        assertIsoDateOrThrow(to, '--to');
+    const entries = await fs.readdir(options.outDir, { withFileTypes: true });
+    const dirs = entries
+        .filter((e) => e.isDirectory())
+        .map((e) => e.name);
+    const results = [];
+    for (const folderName of dirs) {
+        const dateFromFolder = extractFolderDate(folderName);
+        if (dateFromFolder !== undefined) {
+            if (!withinRange(dateFromFolder, from && from.length > 0 ? from : undefined, to && to.length > 0 ? to : undefined)) {
+                continue;
+            }
+        }
+        else {
+            // If the folder doesn't follow naming, skip it for date-range listing.
+            if ((from !== undefined && from.length > 0) || (to !== undefined && to.length > 0)) {
+                continue;
+            }
+        }
+        const fullOutDir = path.join(options.outDir, folderName);
+        const summary = await readSummaryJson(fullOutDir);
+        const ruleExcerpt = await readRuleExcerpt(fullOutDir);
+        results.push({
+            folderName,
+            outDir: fullOutDir,
+            dateFromFolder,
+            summary,
+            ruleExcerpt
+        });
+    }
+    // Sort newest first. If date is missing, sort last.
+    results.sort((a, b) => {
+        const ad = a.dateFromFolder ?? '';
+        const bd = b.dateFromFolder ?? '';
+        if (ad !== bd)
+            return bd.localeCompare(ad);
+        const at = a.summary?.title ?? '';
+        const bt = b.summary?.title ?? '';
+        return at.localeCompare(bt);
+    });
+    return results;
+}
+function mdEscape(value) {
+    // Keep it simple for copy/paste: escape pipes and newlines.
+    return value.replace(/\|/g, '\\|').replace(/\r?\n/g, ' ');
+}
+function truncateOneLine(value, maxChars) {
+    const normalized = value.replace(/\s+/g, ' ').trim();
+    const chars = [...normalized];
+    if (chars.length <= maxChars)
+        return normalized;
+    if (maxChars <= 1)
+        return '…';
+    return `${chars.slice(0, maxChars - 1).join('')}…`;
+}
+function extractFolderId(folderName) {
+    // Folder naming is expected to end with __<id>. If it doesn't, return the full name.
+    const parts = folderName.split('__');
+    const last = parts.at(-1) ?? folderName;
+    return /^[0-9a-f]{8}$/i.test(last) ? last : folderName;
+}
+function listLabels(lang) {
+    if (lang === 'ja') {
+        return {
+            reportTitle: '# 意思決定レポート',
+            outDir: '- 出力ディレクトリ',
+            period: '- 期間',
+            generatedAt: '- 生成日時',
+            decisionsSection: '## 一覧',
+            periodAll: '全て',
+            periodFrom: (from) => `開始 ${from}`,
+            periodTo: (to) => `終了 ${to}`,
+            id: 'ID',
+            date: '日付',
+            title: 'タイトル',
+            status: 'ステータス',
+            decider: '決定者',
+            decision: '決定事項'
+        };
+    }
+    return {
+        reportTitle: '# Decision Record Report',
+        outDir: '- Out dir',
+        period: '- Period',
+        generatedAt: '- Generated at',
+        decisionsSection: '## Decisions',
+        periodAll: 'all',
+        periodFrom: (from) => `from ${from}`,
+        periodTo: (to) => `to ${to}`,
+        id: 'ID',
+        date: 'Date',
+        title: 'Title',
+        status: 'Status',
+        decider: 'Decider',
+        decision: 'Decision'
+    };
+}
+export function renderListReportMarkdown(items, options) {
+    const lines = [];
+    const maxDecisionLen = options.maxDecisionLen ?? 80;
+    const lang = options.lang ?? 'en';
+    const labels = listLabels(lang);
+    lines.push(labels.reportTitle);
+    lines.push('');
+    const periodParts = [];
+    if (options.from !== undefined && options.from.trim().length > 0)
+        periodParts.push(labels.periodFrom(options.from));
+    if (options.to !== undefined && options.to.trim().length > 0)
+        periodParts.push(labels.periodTo(options.to));
+    const period = periodParts.length > 0 ? periodParts.join(' ') : labels.periodAll;
+    lines.push(`${labels.outDir}: ${options.outDir}`);
+    lines.push(`${labels.period}: ${period}`);
+    lines.push(`${labels.generatedAt}: ${options.generatedAtIso}`);
+    lines.push('');
+    lines.push(labels.decisionsSection);
+    lines.push('');
+    for (const item of items) {
+        const id = extractFolderId(item.folderName);
+        const date = item.summary?.date ?? item.dateFromFolder ?? '';
+        const title = item.summary?.title ?? '';
+        const status = item.summary?.status ?? '';
+        const decider = item.summary?.decider ?? '';
+        const rule = item.ruleExcerpt ?? '';
+        lines.push(`- ${labels.id}: ${mdEscape(id)}`);
+        if (date.length > 0)
+            lines.push(`  - ${labels.date}: ${mdEscape(date)}`);
+        if (title.length > 0)
+            lines.push(`  - ${labels.title}: ${mdEscape(title)}`);
+        if (status.length > 0)
+            lines.push(`  - ${labels.status}: ${mdEscape(status)}`);
+        if (decider.length > 0)
+            lines.push(`  - ${labels.decider}: ${mdEscape(decider)}`);
+        if (rule.length > 0) {
+            const clipped = truncateOneLine(rule, maxDecisionLen);
+            lines.push(`  - ${labels.decision}: ${mdEscape(clipped)}`);
+        }
+        // Add a blank line between entries for readability and safer copy/paste.
+        lines.push('');
+    }
+    return lines.join('\n');
+}

package/dist/messages.js

@@ -1,3 +1,21 @@
+export function titleRuleTooSimilarLines(lang = 'en') {
+    if (lang === 'ja') {
+        return [
+            'Warning: title と rule がほぼ同じ内容に見えます。',
+            'Tip: title は短い要約、rule は「全員が守るべきルール（行動・条件・例外）」を書くと役立ちます。',
+            'Example:',
+            '  title: "クラウド基盤は AWS を採用する"',
+            '  rule: "原則として新規の本番環境は AWS。例外が必要なら別DRで判断する"'
+        ];
+    }
+    return [
+        'Warning: title and rule look very similar.',
+        'Tip: title should be a short summary; rule should be an actionable rule (behavior/conditions/exceptions).',
+        'Example:',
+        '  title: "Choose AWS as our cloud provider"',
+        '  rule: "Default to AWS for new production. If an exception is needed, create a separate DR."'
+    ];
+}
 export function templateCreatedLines(inputPath) {
     return [
         `Created template: ${inputPath}`,
@@ -21,37 +39,86 @@ export function missingCoreFieldsLines(inputPath, missingFields) {
 export function wroteInputLines(inputPath) {
     return [`Wrote: ${inputPath}`];
 }
+export function skippedGenerateLines(inputPath, baseOutDir, lang = 'en') {
+    if (lang === 'ja') {
+        return [
+            'Note: --skip-generate が指定されているため、出力ファイルの生成はスキップしました。',
+            '次に、必要なら decision.yaml を追記・編集してください。',
+            `生成するには: dr-gen generate ${inputPath} --out-dir ${baseOutDir}`
+        ];
+    }
+    return [
+        'Note: outputs were not generated because --skip-generate was set.',
+        'Next: edit decision.yaml if needed.',
+        `To generate outputs: dr-gen generate ${inputPath} --out-dir ${baseOutDir}`
+    ];
+}
 export function generatedOutputLines(outDir) {
     return [`Generated: ${outDir}`];
 }
-export function newIntroLines(options) {
+export function newIntroLines(options, lang = 'en') {
     const lines = [];
-    lines.push('Answer a few questions. Short answers are OK.');
-    lines.push('Tip: Focus on the reason (Why) and the rule (Rule).');
+    if (lang === 'ja') {
+        lines.push('いくつか質問します。短い回答でOKです。');
+        lines.push('コツ: 理由（Why）とルール（Rule）に集中してください。');
+    }
+    else {
+        lines.push('Answer a few questions. Short answers are OK.');
+        lines.push('Tip: Focus on the reason (Why) and the rule (Rule).');
+    }
     if (options.includeDate) {
-        lines.push(`Date will be set to today (${options.todayIsoDate}). Use --no-date to disable.`);
+        if (lang === 'ja') {
+            lines.push(`日付は本日（${options.todayIsoDate}）に設定します。無効にするには --no-date を使ってください。`);
+        }
+        else {
+            lines.push(`Date will be set to today (${options.todayIsoDate}). Use --no-date to disable.`);
+        }
     }
     return lines;
 }
-export function newTitlePrompt() {
+export function newTitlePrompt(lang = 'en') {
+    if (lang === 'ja') {
+        return `タイトル（必須）
+何を決めましたか？（短い見出し・名詞句でもOK）
+例: 「定例会議の上限を30分にする」 / 「初動返信SLAを24時間以内にする」
+> `;
+    }
     return `Title (required)
 What did you decide? (one sentence)
 Examples: "Limit recurring meetings to 30 minutes" / "Set support reply time to within 24 hours"
 > `;
 }
-export function newWhyPrompt() {
+export function newWhyPrompt(lang = 'en') {
+    if (lang === 'ja') {
+        return `Why（必須）
+この決定をした理由・目的（なぜやるのか？）
+例: 「セキュリティ事故を防ぐ」 / 「請求をシンプルにする」 / 「長い会議を減らす」
+> `;
+    }
     return `Why (required)
 Reason / goal behind the decision (why are we doing this?).
 Examples: "Reduce security risk" / "Make billing simpler" / "Avoid long meetings"
 > `;
 }
-export function newRulePrompt() {
-    return `Rule (required)
-What rule should everyone follow from now on?
-Examples: "Recurring meetings are 30 minutes max" / "Reply within 24 hours on business days"
+export function newRulePrompt(lang = 'en') {
+    if (lang === 'ja') {
+        return `Decision / Rule（必須）
+今回の決定は何ですか？（方針・ルール・当面の優先順位など。行動・条件・例外まで書けると良い）
+例: 「優先開発は list と new --skip-generate。他は後回しにする」
+> `;
+    }
+    return `Decision / Rule (required)
+What did you decide? (policy/rule/priority; actions are OK)
+Examples: "Prioritize list + --skip-generate first; defer others" / "Default to AWS for new production"
 > `;
 }
-export function newContextPrompt() {
+export function newContextPrompt(lang = 'en') {
+    if (lang === 'ja') {
+        return `Context（任意）
+背景・制約（空欄でもOK）
+例: 「返信が遅いという声が増えた」 / 「スプレッドシートでパスワード共有していた」
+> `;
+    }
     return `Context (optional)
 Background / constraints (you can leave this empty).
 Examples: "Customers say replies are slow" / "We used to share passwords in a spreadsheet"

package/dist/parser.js

@@ -33,6 +33,8 @@ export async function parseDecisionYaml(filePath) {
         title,
         date: asOptionalString(loaded.date),
         decider: asOptionalString(loaded.decider),
+        status: asOptionalString(loaded.status),
+        supersedes: asOptionalString(loaded.supersedes),
         context: asOptionalString(loaded.context),
         why: asOptionalString(loaded.why),
         rule: asOptionalString(loaded.rule),

package/dist/template.js

@@ -3,6 +3,8 @@ export function decisionYamlTemplate() {
         'title: "TODO: Decision title"',
         'date: ""',
         'decider: ""',
+        'status: ""',
+        'supersedes: ""',
         'context: ""',
         'why: ""',
         'rule: ""',

package/dist/text.js

@@ -0,0 +1,24 @@
+export function normalizeComparable(value) {
+    return value
+        .normalize('NFKC')
+        .trim()
+        .toLowerCase()
+        // Remove whitespace and common punctuation so minor formatting differences don't matter.
+        .replace(/[\s\u3000]+/g, '')
+        .replace(/["'`“”‘’.,:;!?()\[\]{}<>|\\/\-_=+*~^$#@]+/g, '');
+}
+export function areTitleAndRuleTooSimilar(title, rule) {
+    const t = normalizeComparable(title);
+    const r = normalizeComparable(rule);
+    if (t.length === 0 || r.length === 0)
+        return false;
+    if (t === r)
+        return true;
+    // Heuristic: one contains the other and they're very close in length.
+    const shorter = t.length <= r.length ? t : r;
+    const longer = t.length <= r.length ? r : t;
+    if (!longer.includes(shorter))
+        return false;
+    const diff = longer.length - shorter.length;
+    return diff <= 8;
+}

package/dist/yaml.js

@@ -4,6 +4,8 @@ export function renderDecisionYaml(record) {
         title: record.title,
         date: record.date ?? '',
         decider: record.decider ?? '',
+        status: record.status ?? '',
+        supersedes: record.supersedes ?? '',
         context: record.context ?? '',
         why: record.why ?? '',
         rule: record.rule ?? '',

package/package.json

@@ -1,7 +1,15 @@
 {
   "name": "dr-gen",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Generate lightweight Decision Records from decision.yaml",
+  "homepage": "https://www.ineeza.com/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Ineeza/decision-record-generator.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Ineeza/decision-record-generator/issues"
+  },
   "license": "MIT",
   "type": "module",
   "bin": {