memd-cli 1.1.0 → 1.2.0

package/main.js

@@ -102,7 +102,7 @@ function shouldUsePager(text, options) {
 function spawnPager(text, options) {
   // Respect $PAGER environment variable (like glow, bat, mdcat)
   const pagerCmd = process.env.PAGER || 'less';
-  const pagerArgs = pagerCmd === 'less' ? ['-R'] : [];
+  const pagerArgs = pagerCmd === 'less' ? ['-R', ...(options.mouse !== false ? ['--mouse'] : [])] : [];
 
   const pager = spawn(pagerCmd, pagerArgs, {
     stdio: ['pipe', 'inherit', 'inherit']
@@ -133,6 +133,7 @@ async function main() {
     .description('Render markdown with mermaid diagrams to terminal output')
     .argument('[files...]', 'markdown file(s) to render')
     .option('--no-pager', 'disable pager (less)')
+    .option('--no-mouse', 'disable mouse scroll in pager')
     .option('--no-color', 'disable colored output')
     .option('--no-highlight', 'disable syntax highlighting')
     .option('--width <number>', 'terminal width override', Number)

package/package.json

@@ -1,21 +1,32 @@
 {
   "name": "memd-cli",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "type": "module",
   "main": "main.js",
   "bin": {
     "memd": "main.js"
   },
+  "scripts": {
+    "test": "vitest run"
+  },
   "dependencies": {
     "beautiful-mermaid": "^0.1.3",
     "cli-highlight": "^2.1.11",
     "commander": "^14.0.3",
-    "marked": "^15.0.12",
+    "marked": "^17.0.3",
     "marked-terminal": "^7.3.0"
   },
   "repository": {
     "type": "git",
     "url": "https://github.com/ktrysmt/memd.git"
   },
-  "license": "MIT"
+  "license": "MIT",
+  "packageManager": "pnpm@10.15.1",
+  "devDependencies": {
+    "tuistory": "^0.0.16",
+    "vitest": "^4.0.18"
+  },
+  "pnpm": {
+    "onlyBuiltDependencies": ["esbuild", "node-pty"]
+  }
 }

package/plan.md

@@ -0,0 +1,283 @@
+# memd TUI Outline Sidebar 設計案
+
+## 背景
+
+memd は現在 `less` (または `$PAGER`) をフルスクリーンページャーとして使用している。
+Markdown の見出し構造をサイドバーにアウトラインとして表示し、ナビゲーション可能にする機能を追加する。
+
+## TUI ライブラリ選定
+
+| ライブラリ | 判定 | 理由 |
+|---|---|---|
+| blessed-contrib | 不採用 | 放棄済み (最終更新4年前)、未修正の Prototype Pollution 脆弱性 |
+| Ink | 保留 | 最も活発だが React 依存が重い。軽量 CLI には過剰 |
+| terminal-kit | 採用 | Node 18/20/22 対応、純 JS、既知脆弱性修正済み、ドキュメント良好 |
+
+リスク: メンテナ1名、更新頻度低下傾向、79件のオープンイシュー積み残し。
+terminal-kit 依存は `lib/tui.js` に閉じ込め、将来の差し替えに備える。
+
+## ディレクトリ構成
+
+```
+memd/
+  main.js              # エントリーポイント (CLI 解析 + モード分岐のみ)
+  lib/
+    markdown.js         # Markdown 処理 (既存ロジックの抽出)
+    outline.js          # 見出し抽出・アウトラインデータ生成
+    pager.js            # 既存の less/pager ロジック
+    tui.js              # terminal-kit TUI モード (新規)
+  test/
+    test1.md
+    test2.md
+  package.json
+```
+
+## モジュール設計
+
+### main.js -- エントリーポイント
+
+CLI 解析 (commander) とモード分岐のみ。
+
+```
+CLI 解析
+  |
+  +-- --outline あり & TTY  --> tui.js (TUI モード)
+  +-- パイプ / --no-pager / 短い出力 --> stdout 直接出力
+  +-- 長い出力              --> pager.js (less モード)
+```
+
+追加オプション:
+
+```js
+.option('--outline', 'show outline sidebar (TUI mode)')
+```
+
+分岐ロジック:
+
+```js
+if (options.outline && process.stdout.isTTY) {
+  launchTui(markdown, renderedText, options);
+} else if (shouldUsePager(renderedText, options)) {
+  spawnPager(renderedText, options);
+} else {
+  process.stdout.write(renderedText);
+}
+```
+
+### lib/markdown.js -- Markdown 処理
+
+既存の `main.js` から抽出する pure function 群。
+
+```js
+export function readMarkdownFile(filePath)
+// 現在の readMarkdownFile と同一
+
+export function configureMarked(options)
+// marked.use(...) の設定を集約
+
+export function convertMermaidToAscii(markdown, options)
+// 現在と同一
+
+export function renderToString(markdown, options)
+// 現在と同一
+
+export function readStdin()
+// 現在と同一
+```
+
+### lib/outline.js -- アウトライン抽出
+
+terminal-kit に依存しない pure function。テスト容易。
+
+```js
+/**
+ * Markdown ソースから見出しを抽出
+ * @param {string} markdown - 生の Markdown テキスト
+ * @returns {Array<{level: number, text: string, line: number}>}
+ *
+ * 例: [
+ *   { level: 1, text: "Hello", line: 0 },
+ *   { level: 2, text: "Section A", line: 15 },
+ *   { level: 3, text: "Subsection A-1", line: 28 },
+ * ]
+ */
+export function extractHeadings(markdown)
+
+/**
+ * レンダリング済みテキスト内で各見出しが何行目に対応するか算出
+ * (スクロール位置ジャンプに使用)
+ * @param {string} renderedText - marked で変換済みの ANSI 文字列
+ * @param {Array} headings - extractHeadings の結果
+ * @returns {Array<{...heading, renderedLine: number}>}
+ */
+export function mapHeadingsToRenderedLines(renderedText, headings)
+```
+
+### lib/pager.js -- Pager 処理
+
+```js
+export function shouldUsePager(text, options)
+// 現在と同一
+
+export function spawnPager(text, options)
+// 現在と同一
+```
+
+### lib/tui.js -- TUI モード (新規コア)
+
+terminal-kit 依存はこのファイルに閉じ込める。
+`--outline` 指定時のみ動的 import で読み込み、通常利用時のロード時間に影響しない。
+
+```js
+import termkit from 'terminal-kit';
+
+/**
+ * TUI モードを起動
+ * @param {string} markdown - 生の Markdown ソース
+ * @param {string} renderedText - レンダリング済みテキスト
+ * @param {object} options - CLI オプション
+ */
+export function launchTui(markdown, renderedText, options)
+```
+
+内部関数:
+
+```
+launchTui(markdown, renderedText, options)
+  |
+  +-- createLayout(term)
+  |     ターミナル幅を取得し、左右のカラム幅を決定
+  |     左: サイドバー (幅の 25%, 最小 20, 最大 40)
+  |     右: コンテンツ (残り)
+  |     戻り値: { sidebarWidth, contentWidth, height }
+  |
+  +-- renderSidebar(term, headings, selectedIndex, scrollOffset, layout)
+  |     アウトラインを左カラムに描画
+  |     選択中の見出しをハイライト
+  |     インデント: level に応じて 2*(level-1) スペース
+  |
+  +-- renderContent(term, lines, scrollOffset, layout)
+  |     レンダリング済みテキストを右カラムに描画
+  |     contentWidth に合わせて行を切り詰め
+  |
+  +-- renderStatusBar(term, state, layout)
+  |     最下行にステータス表示
+  |     "[q]quit  [j/k]navigate  [Enter]jump  [Tab]toggle sidebar"
+  |
+  +-- setupKeyBindings(term, state)
+        キー入力ハンドラ登録
+```
+
+キーバインド:
+
+| キー | 動作 |
+|---|---|
+| j / Down | 次の見出し |
+| k / Up | 前の見出し |
+| Enter | 選択した見出しの位置にコンテンツをスクロール |
+| g / G | 先頭 / 末尾 |
+| Ctrl+D / Ctrl+U | 半ページスクロール |
+| Tab | サイドバーフォーカス切替 |
+| q / Ctrl+C | 終了 |
+
+## 画面レイアウト
+
+```
++-- Outline (25%) --+-- Content (75%) --------------------------+
+| # Hello           | # Hello                                   |
+|   ## Section A    |                                            |
+|   ## Section B    | This is **markdown** printed in the        |
+| > ## Section C  < | `terminal`.                                |
+|     ### C-1       |                                            |
+|     ### C-2       | ## Section C                               |
+|   ## Section D    |                                            |
+|                   | Lorem ipsum dolor sit amet...              |
+|                   | ...                                        |
++-------------------+--------------------------------------------+
+  [q]quit [j/k]move [Enter]jump [Tab]focus       Section C  3/6
+```
+
+## データフロー
+
+```
+                  markdown (raw)
+                       |
+          +------------+------------+
+          |                         |
+   extractHeadings()         configureMarked()
+          |                  renderToString()
+          |                         |
+       headings[]            renderedText
+          |                         |
+   mapHeadingsToRenderedLines()     |
+          |                         |
+    headings[] with                 |
+    renderedLine                    |
+          |                         |
+          +-------+  +--------------+
+                  |  |
+              launchTui()
+              or spawnPager()
+              or stdout.write()
+```
+
+## 設計上のポイント
+
+1. **既存モードへの影響ゼロ** -- `--outline` なしなら従来通り `less` または stdout。TUI は `--outline` 時のみ動的ロードする
+2. **モジュール分割は最小限** -- `tui.js` + `outline.js` の 2 ファイル追加のみ。`main.js` の既存ロジック (markdown 処理, pager) はそのまま残す。小さな CLI に不要な分割はしない
+3. **outline.js は pure function** -- TUI ライブラリに依存しない。単体テスト可能
+4. **TUI 依存は tui.js に閉じ込める** -- 将来別ライブラリに差し替える場合も tui.js だけ書き換えればよい
+
+## レビュー指摘事項 (2026-03-07)
+
+### terminal-kit 選定リスクの再評価
+
+メンテナ1名 + 79件のオープンイシュー積み残しは「リスク」ではなく「既に問題化」に近い。
+memd の TUI は比較的シンプル (2カラムレイアウト + キー入力) なので、以下の代替案も検討する:
+
+- **案A: terminal-kit 採用** (現行案) -- 機能は豊富だがメンテナンス不安
+- **案B: 自前 ANSI 実装** -- `process.stdout.write` + ANSI エスケープ + `readline` rawMode で実現。依存ゼロ。memd の TUI 要件 (2カラム描画, キー入力, カーソル制御) は Node.js 標準 API で十分カバー可能
+
+### mapHeadingsToRenderedLines の実装方針
+
+ANSI エスケープ付きレンダリング済みテキストから見出し位置を特定する必要がある。
+marked-terminal の出力には以下の複雑性がある:
+
+- ANSI カラーコード
+- reflowText による折り返し
+- テーブル・コードブロックの展開
+
+実装方針: レンダリング後テキストを `strip-ansi` して各行を走査し、見出しテキスト (extractHeadings の結果) と前方一致でマッチさせる。
+完全一致が困難な場合は、marked のレンダリング時にカスタム renderer で見出し行にマーカー文字列を埋め込み、レンダリング後にマーカーで検索する方式をフォールバックとする。
+
+### コンテンツ描画時の ANSI 対応
+
+- 行の切り詰め (truncate) 時に ANSI エスケープシーケンスの途中で切断すると表示が崩れる
+- `strip-ansi` + `string-width` を利用して表示幅を正確に算出し、ANSI シーケンスを壊さない切り詰め処理が必要
+- TUI モードでは marked-terminal の `width` オプションをコンテンツカラム幅に合わせて設定する (全幅ではなく右カラム幅)
+
+### ターミナルリサイズ対応
+
+`process.stdout.on('resize', ...)` (SIGWINCH) でリサイズイベントを検知し、レイアウトを再計算して再描画する。
+
+### Tab フォーカス切替時の UX 定義
+
+- サイドバーフォーカス時: j/k で見出し間を移動、Enter でコンテンツをジャンプ
+- コンテンツフォーカス時: j/k で 1 行単位スクロール、g/G で先頭/末尾
+
+## モジュール分割方針 (修正)
+
+`main.js` の既存ロジック (readMarkdownFile, convertMermaidToAscii, renderToString, readStdin, shouldUsePager, spawnPager) はそのまま残す。
+新規追加は以下の 2 ファイルのみ:
+
+```
+memd/
+  main.js              # エントリーポイント (既存 + --outline 分岐追加)
+  lib/
+    outline.js          # 見出し抽出・アウトラインデータ生成 (pure function, 新規)
+    tui.js              # TUI モード (新規)
+  test/
+    test1.md
+    test2.md
+  package.json
+```

package/planb.md

@@ -0,0 +1,186 @@
+# 案B: 自前 ANSI 実装による TUI モード設計
+
+## 方針
+
+terminal-kit を使わず、Node.js 標準 API + ANSI エスケープシーケンスのみで TUI を実装する。
+memd の TUI 要件 (2カラム描画 + キー入力 + スクロール) は限定的であり、外部依存なしで実現可能。
+
+## 使用する Node.js 標準 API
+
+| 用途 | API |
+|---|---|
+| 画面描画 | `process.stdout.write` + ANSI エスケープシーケンス |
+| キー入力 | `readline.emitKeypressEvents` + `process.stdin.setRawMode(true)` |
+| 画面サイズ | `process.stdout.columns` / `process.stdout.rows` |
+| リサイズ検知 | `process.stdout.on('resize', ...)` |
+
+外部依存は `strip-ansi` と `string-width` のみ (いずれも marked-terminal の transitive dep として既存)。
+
+## ANSI エスケープの基本操作
+
+```js
+const ESC = '\x1b[';
+const cursor = {
+  moveTo: (x, y) => `${ESC}${y + 1};${x + 1}H`,
+  hide: `${ESC}?25l`,
+  show: `${ESC}?25h`,
+  clearScreen: `${ESC}2J`,
+  clearLine: `${ESC}2K`,
+};
+const style = {
+  reverse: `${ESC}7m`,
+  reset: `${ESC}0m`,
+  dim: `${ESC}2m`,
+  bold: `${ESC}1m`,
+};
+```
+
+## モジュール構成
+
+```
+memd/
+  main.js              # エントリーポイント (既存 + --outline 分岐追加)
+  lib/
+    outline.js          # 見出し抽出・アウトラインデータ生成 (pure function, 新規)
+    tui.js              # TUI モード (新規, 自前 ANSI 実装)
+  test/
+    test1.md
+    test2.md
+  package.json
+```
+
+## tui.js の内部構造
+
+```
+launchTui(markdown, renderedText, headings, options)
+  |
+  +-- state = {
+  |     sidebarFocused: true,
+  |     selectedHeading: 0,
+  |     contentScroll: 0,
+  |     sidebarScroll: 0,
+  |     layout: computeLayout(),
+  |   }
+  |
+  +-- computeLayout()
+  |     cols = process.stdout.columns
+  |     rows = process.stdout.rows
+  |     sidebarWidth = clamp(Math.floor(cols * 0.25), 20, 40)
+  |     contentWidth = cols - sidebarWidth - 1  // 1 for separator
+  |     height = rows - 1  // 1 for status bar
+  |
+  +-- render(state)
+  |     buf = ''
+  |     buf += cursor.hide
+  |     buf += renderSidebar(state)
+  |     buf += renderSeparator(state)
+  |     buf += renderContent(state)
+  |     buf += renderStatusBar(state)
+  |     process.stdout.write(buf)  // 1回の write でフリッカー軽減
+  |
+  +-- renderSidebar(state)
+  |     各見出しを sidebarWidth 内に収めて描画
+  |     選択行は reverse video で表示
+  |     level に応じて 2*(level-1) スペースでインデント
+  |
+  +-- renderSeparator(state)
+  |     縦線 '|' を各行の sidebarWidth 位置に描画
+  |
+  +-- renderContent(state)
+  |     renderedText を行分割済み配列として保持
+  |     contentScroll から height 行分を描画
+  |     各行を contentWidth でスライス (ANSI 対応)
+  |
+  +-- renderStatusBar(state)
+  |     最下行にキーバインドヘルプ + 現在位置表示
+  |
+  +-- handleKeypress(key, state)
+        keypress イベントから state を更新し render() を呼ぶ
+```
+
+## キー入力の実装
+
+```js
+import readline from 'readline';
+
+readline.emitKeypressEvents(process.stdin);
+process.stdin.setRawMode(true);
+process.stdin.on('keypress', (str, key) => {
+  if (key.name === 'q' || (key.ctrl && key.name === 'c')) {
+    cleanup();
+    process.exit(0);
+  }
+  handleKeypress(key, state);
+  render(state);
+});
+```
+
+### キーバインド
+
+| キー | サイドバーフォーカス時 | コンテンツフォーカス時 |
+|---|---|---|
+| j / Down | 次の見出し | 1行下スクロール |
+| k / Up | 前の見出し | 1行上スクロール |
+| Enter | 選択した見出しの位置にコンテンツをスクロール | -- |
+| g / G | 先頭 / 末尾 | 先頭 / 末尾 |
+| Ctrl+D / Ctrl+U | -- | 半ページスクロール |
+| Tab | コンテンツへフォーカス移動 | サイドバーへフォーカス移動 |
+| q / Ctrl+C | 終了 | 終了 |
+
+## フリッカー対策
+
+- 毎フレーム `clearScreen` せず、各行を `moveTo` + `clearLine` + 描画で上書き
+- 全描画内容を文字列バッファに溜めてから1回の `process.stdout.write(buf)` で出力
+
+## ANSI 対応の行スライス
+
+コンテンツ行を `contentWidth` に切り詰める際の処理:
+
+```js
+function sliceAnsiLine(line, maxWidth) {
+  // 1. ANSI エスケープを位置情報付きで分離
+  // 2. 表示文字の幅を string-width で計測しながら maxWidth まで切り詰め
+  // 3. 切り詰め後に開いたままの ANSI シーケンスを reset で閉じる
+}
+```
+
+## cleanup 処理
+
+```js
+function cleanup() {
+  process.stdout.write(cursor.show);
+  process.stdout.write(cursor.clearScreen);
+  process.stdout.write(cursor.moveTo(0, 0));
+  process.stdin.setRawMode(false);
+}
+// 異常終了時もクリーンアップ
+process.on('exit', cleanup);
+process.on('SIGINT', () => { cleanup(); process.exit(0); });
+```
+
+## ターミナルリサイズ対応
+
+```js
+process.stdout.on('resize', () => {
+  state.layout = computeLayout();
+  render(state);
+});
+```
+
+## mapHeadingsToRenderedLines の実装方針
+
+ANSI 付きレンダリング済みテキストから見出し位置を特定する:
+
+1. レンダリング後テキストを `strip-ansi` して各行を走査
+2. `extractHeadings` の結果と前方一致でマッチさせる
+3. フォールバック: marked のカスタム renderer で見出し行にマーカー文字列を埋め込み、レンダリング後にマーカーで検索
+
+## 案A (terminal-kit) との比較
+
+| | 案A (terminal-kit) | 案B (自前 ANSI) |
+|---|---|---|
+| 外部依存 | +1 (terminal-kit, ~2MB) | +0 (strip-ansi, string-width は既存 transitive dep) |
+| 実装量 | 少ない (API 呼ぶだけ) | 中程度 (~200行の描画コード) |
+| メンテリスク | メンテナ1名、更新頻度低下 | 自前なので自己責任 |
+| 機能カバー | 豊富 (使わない機能も多い) | 必要最小限 |
+| インストール速度 | native module なし、影響軽微 | 影響なし |

package/test/memd.test.js

@@ -0,0 +1,117 @@
+import { describe, it, expect } from 'vitest'
+import { launchTerminal } from 'tuistory'
+import path from 'path'
+import { fileURLToPath } from 'url'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const MAIN = path.join(__dirname, '..', 'main.js')
+
+async function run(args, { waitFor = null } = {}) {
+  const session = await launchTerminal({
+    command: 'node',
+    args: [MAIN, ...args],
+    cols: 80,
+    rows: 30,
+    waitForData: false,
+  })
+  const waitText = waitFor ?? (t => t.trim().length > 0)
+  const output = await session.text({ waitFor: waitText, timeout: 8000 })
+  return output.trim()
+}
+
+describe('memd CLI', () => {
+  it('--version', async () => {
+    const output = await run(['-v'])
+    expect(output).toContain('1.1.1')
+  })
+
+  it('--help', async () => {
+    const output = await run(['--help'])
+    expect(output).toContain('Usage: memd')
+    expect(output).toContain('--no-pager')
+    expect(output).toContain('--no-color')
+    expect(output).toContain('--ascii')
+  })
+
+  it('renders test1.md (basic markdown + mermaid)', async () => {
+    const output = await run(
+      ['--no-pager', '--no-color', '--width', '80', 'test/test1.md'],
+      { waitFor: t => t.includes('More text.') },
+    )
+    expect(output).toMatchInlineSnapshot(`
+      "# Hello
+
+      This is markdown with mermaid:
+
+          ┌───┐     ┌───┐
+          │   │     │   │
+          │ A ├────►│ B │
+          │   │     │   │
+          └───┘     └───┘
+      More text."
+    `)
+  })
+
+  it('renders test2.md (complex mermaid diagram)', async () => {
+    const output = await run(
+      ['--no-pager', '--no-color', '--width', '80', 'test/test2.md'],
+      { waitFor: t => t.includes('More text after the diagram.') },
+    )
+    expect(output).toContain('Start')
+    expect(output).toContain('Decision?')
+    expect(output).toContain('Action')
+    expect(output).toContain('End')
+    expect(output).toContain('More text after the diagram.')
+  })
+
+  it('--ascii renders ASCII-only diagram', async () => {
+    const output = await run(
+      ['--no-pager', '--no-color', '--width', '80', '--ascii', 'test/test1.md'],
+      { waitFor: t => t.includes('More text.') },
+    )
+    expect(output).toContain('+---+')
+    expect(output).toContain('---->')
+    expect(output).not.toContain('┌')
+    expect(output).not.toContain('►')
+  })
+
+  it('--no-color strips ANSI escape codes', async () => {
+    const output = await run(
+      ['--no-pager', '--no-color', '--width', '80', 'test/test1.md'],
+      { waitFor: t => t.includes('More text.') },
+    )
+    // eslint-disable-next-line no-control-regex
+    expect(output).not.toMatch(/\x1b\[[\d;]*m/)
+  })
+
+  it('error on missing file', async () => {
+    const session = await launchTerminal({
+      command: 'node',
+      args: [MAIN, '--no-pager', 'test/nonexistent.md'],
+      cols: 80,
+      rows: 10,
+      waitForData: false,
+    })
+    const output = (await session.text({
+      waitFor: t => t.includes('Error'),
+      timeout: 8000,
+    })).trim()
+    expect(output).toContain('Error reading file')
+    expect(output).toContain('nonexistent.md')
+  })
+
+  it('reads markdown from stdin via shell', async () => {
+    const session = await launchTerminal({
+      command: 'sh',
+      args: ['-c', `echo '# stdin test' | node ${MAIN} --no-pager --no-color`],
+      cols: 80,
+      rows: 10,
+      waitForData: false,
+    })
+    const output = (await session.text({
+      waitFor: t => t.includes('stdin test'),
+      timeout: 8000,
+    })).trim()
+    expect(output).toContain('stdin test')
+  })
+})

package/.claude/settings.json

@@ -1,7 +0,0 @@
-{
-  "permissions": {
-    "deny": [
-      "Read(./.entire/metadata/**)"
-    ]
-  }
-}

package/.claude/settings.local.json

@@ -1,12 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(npx:*)",
-      "Bash(npmwhoami)",
-      "Bash(LINES=20 node main.js:*)",
-      "Bash(LINES=10 node:*)",
-      "Bash(1)",
-      "Bash(DEBUG=1 node main.js:*)"
-    ]
-  }
-}

package/.serena/memories/project_overview.md

@@ -1,31 +0,0 @@
-# termaid Project Overview
-
-## Purpose
-termaid is a CLI tool that renders Mermaid diagrams in markdown files to ASCII art for terminal display. It converts ```mermaid code blocks to terminal-friendly ASCII diagrams.
-
-## Tech Stack
-- Runtime: Node.js (ES modules)
-- Markdown parser: marked + marked-terminal
-- Mermaid rendering: beautiful-mermaid
-
-## Key Files
-- main.js - Entry point (ESM module)
-- package.json - Project metadata and dependencies
-- test/ - Test markdown files
-
-## Project Structure
-```
-├── main.js           # Main CLI entry point
-├── package.json
-├── test/
-│   ├── test1.md      # Basic flowchart test
-│   ├── test2.md      # Decision flowchart test
-│   └── test3.md      # Complex diagrams (sequence, class, state)
-├── README.md
-└── .gitignore
-```
-
-## Code Style
-- ES modules (`import`/`export`)
-- No TypeScript types (has `// @ts-nocheck`)
-- Simple, functional approach

package/.serena/memories/publishing_to_npm.md

@@ -1,111 +0,0 @@
-# Publishing to npm
-
-## Current Status
-- Package name: `@ktrysmt/termaid` (Scoped package under ktrysmt org)
-- Version: 1.0.3 (from package.json)
-- Status: NOT YET published (E404 when checking registry)
-
-## Prerequisites
-
-### 1. npm Account
-- Create an account at https://www.npmjs.com/
-- Login with: `npm login`
-
-### 2. Package Name Considerations
-- `@ktrysmt/termaid` requires write access to the `ktrysmt` scope
-- If you don't have access, you can:
-  - Use a different scope: `@yourname/termaid`
-  - Use an unscoped package: `termaid` (check availability first)
-
-## Publish Steps
-
-### Step 1: Verify package.json
-Check these fields:
-```json
-{
-  "name": "@ktrysmt/termaid",
-  "version": "1.0.3",
-  "main": "main.js",
-  "bin": {
-    "termaid": "main.js"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/ktrysmt/termaid.git"
-  }
-}
-```
-
-### Step 2: Login to npm
-```bash
-npm login
-# Follow prompts for username, password, email
-```
-
-### Step 3: Check Package Access
-```bash
-npm access ls-collaborators @ktrysmt/termaid
-```
-
-### Step 4: Publish
-```bash
-npm publish
-```
-
-### Step 5: Verify
-```bash
-npm view @ktrysmt/termaid
-npm install -g @ktrysmt/termaid
-```
-
-## Version Management
-
-### Bump version before publish:
-```bash
-# Patch (bug fixes): 1.0.2 -> 1.0.3
-npm version patch
-
-# Minor (new features): 1.0.2 -> 1.1.0
-npm version minor
-
-# Major (breaking changes): 1.0.2 -> 2.0.0
-npm version major
-```
-
-### Or manually edit package.json, then:
-```bash
-git add .
-git commit -m "chore: bump version"
-git tag v1.0.3  # or new version
-git push && git push --tags
-npm publish
-```
-
-## Private vs Public
-
-### Public (default):
-```bash
-npm publish
-# Accessible to everyone
-```
-
-### Private (requires paid plan):
-```bash
-npm publish --access restricted
-# Only accessible to collaborators
-```
-
-### Public with scoped package (free):
-```bash
-npm publish --access public
-# Works for scoped packages under free plan
-```
-
-## Common Issues
-
-| Issue | Solution |
-|-------|----------|
-| E403 Forbidden | You don't have access to this scope |
-| E409 Conflict | Version already exists, bump version |
-| ENEEDAUTH | Run `npm login` first |
-| EMISSINGARG | Missing name/version in package.json |

package/.serena/memories/suggested_commands.md

@@ -1,19 +0,0 @@
-# Suggested Commands for termaid
-
-## Testing
-- `node main.js test/test1.md` - Test with test1.md
-- `node main.js test/test2.md` - Test with test2.md
-- `echo '# Hello\n\n```mermaid\nflowchart LR\n    A --> B\n```' | node main.js` - Test with stdin
-
-## Version Management
-- Check current version: `node main.js -v`
-
-## Development
-- Install dependencies: `npm install`
-- Run with a markdown file: `node main.js <file.md>`
-
-## Publishing (to npm)
-1. Check current version in package.json
-2. Update version (e.g., `npm version patch` or `npm version minor`)
-3. Login: `npm login`
-4. Publish: `npm publish`

package/.serena/project.yml

@@ -1,115 +0,0 @@
-
-# whether to use the project's gitignore file to ignore files
-# Added on 2025-04-07
-ignore_all_files_in_gitignore: true
-# list of additional paths to ignore
-# same syntax as gitignore, so you can use * and **
-# Was previously called `ignored_dirs`, please update your config if you are using that.
-# Added (renamed) on 2025-04-07
-ignored_paths: []
-
-# whether the project is in read-only mode
-# If set to true, all editing tools will be disabled and attempts to use them will result in an error
-# Added on 2025-04-18
-read_only: false
-
-
-# list of tool names to exclude. We recommend not excluding any tools, see the readme for more details.
-# Below is the complete list of tools for convenience.
-# To make sure you have the latest list of tools, and to view their descriptions, 
-# execute `uv run scripts/print_tool_overview.py`.
-#
-#  * `activate_project`: Activates a project by name.
-#  * `check_onboarding_performed`: Checks whether project onboarding was already performed.
-#  * `create_text_file`: Creates/overwrites a file in the project directory.
-#  * `delete_lines`: Deletes a range of lines within a file.
-#  * `delete_memory`: Deletes a memory from Serena's project-specific memory store.
-#  * `execute_shell_command`: Executes a shell command.
-#  * `find_referencing_code_snippets`: Finds code snippets in which the symbol at the given location is referenced.
-#  * `find_referencing_symbols`: Finds symbols that reference the symbol at the given location (optionally filtered by type).
-#  * `find_symbol`: Performs a global (or local) search for symbols with/containing a given name/substring (optionally filtered by type).
-#  * `get_current_config`: Prints the current configuration of the agent, including the active and available projects, tools, contexts, and modes.
-#  * `get_symbols_overview`: Gets an overview of the top-level symbols defined in a given file.
-#  * `initial_instructions`: Gets the initial instructions for the current project.
-#     Should only be used in settings where the system prompt cannot be set,
-#     e.g. in clients you have no control over, like Claude Desktop.
-#  * `insert_after_symbol`: Inserts content after the end of the definition of a given symbol.
-#  * `insert_at_line`: Inserts content at a given line in a file.
-#  * `insert_before_symbol`: Inserts content before the beginning of the definition of a given symbol.
-#  * `list_dir`: Lists files and directories in the given directory (optionally with recursion).
-#  * `list_memories`: Lists memories in Serena's project-specific memory store.
-#  * `onboarding`: Performs onboarding (identifying the project structure and essential tasks, e.g. for testing or building).
-#  * `prepare_for_new_conversation`: Provides instructions for preparing for a new conversation (in order to continue with the necessary context).
-#  * `read_file`: Reads a file within the project directory.
-#  * `read_memory`: Reads the memory with the given name from Serena's project-specific memory store.
-#  * `remove_project`: Removes a project from the Serena configuration.
-#  * `replace_lines`: Replaces a range of lines within a file with new content.
-#  * `replace_symbol_body`: Replaces the full definition of a symbol.
-#  * `restart_language_server`: Restarts the language server, may be necessary when edits not through Serena happen.
-#  * `search_for_pattern`: Performs a search for a pattern in the project.
-#  * `summarize_changes`: Provides instructions for summarizing the changes made to the codebase.
-#  * `switch_modes`: Activates modes by providing a list of their names
-#  * `think_about_collected_information`: Thinking tool for pondering the completeness of collected information.
-#  * `think_about_task_adherence`: Thinking tool for determining whether the agent is still on track with the current task.
-#  * `think_about_whether_you_are_done`: Thinking tool for determining whether the task is truly completed.
-#  * `write_memory`: Writes a named memory (for future reference) to Serena's project-specific memory store.
-excluded_tools: []
-
-# initial prompt for the project. It will always be given to the LLM upon activating the project
-# (contrary to the memories, which are loaded on demand).
-initial_prompt: ""
-# the name by which the project can be referenced within Serena
-project_name: "termaid"
-
-# list of mode names to that are always to be included in the set of active modes
-# The full set of modes to be activated is base_modes + default_modes.
-# If the setting is undefined, the base_modes from the global configuration (serena_config.yml) apply.
-# Otherwise, this setting overrides the global configuration.
-# Set this to [] to disable base modes for this project.
-# Set this to a list of mode names to always include the respective modes for this project.
-base_modes:
-
-# list of mode names that are to be activated by default.
-# The full set of modes to be activated is base_modes + default_modes.
-# If the setting is undefined, the default_modes from the global configuration (serena_config.yml) apply.
-# Otherwise, this overrides the setting from the global configuration (serena_config.yml).
-# This setting can, in turn, be overridden by CLI parameters (--mode).
-default_modes:
-
-# list of tools to include that would otherwise be disabled (particularly optional tools that are disabled by default)
-included_optional_tools: []
-
-# fixed set of tools to use as the base tool set (if non-empty), replacing Serena's default set of tools.
-# This cannot be combined with non-empty excluded_tools or included_optional_tools.
-fixed_tools: []
-
-# the encoding used by text files in the project
-# For a list of possible encodings, see https://docs.python.org/3.11/library/codecs.html#standard-encodings
-encoding: utf-8
-
-
-# list of languages for which language servers are started; choose from:
-#   al                  bash                clojure             cpp                 csharp
-#   csharp_omnisharp    dart                elixir              elm                 erlang
-#   fortran             fsharp              go                  groovy              haskell
-#   java                julia               kotlin              lua                 markdown
-#   matlab              nix                 pascal              perl                php
-#   php_phpactor        powershell          python              python_jedi         r
-#   rego                ruby                ruby_solargraph     rust                scala
-#   swift               terraform           toml                typescript          typescript_vts
-#   vue                 yaml                zig
-#   (This list may be outdated. For the current list, see values of Language enum here:
-#   https://github.com/oraios/serena/blob/main/src/solidlsp/ls_config.py
-#   For some languages, there are alternative language servers, e.g. csharp_omnisharp, ruby_solargraph.)
-# Note:
-#   - For C, use cpp
-#   - For JavaScript, use typescript
-#   - For Free Pascal/Lazarus, use pascal
-# Special requirements:
-#   Some languages require additional setup/installations.
-#   See here for details: https://oraios.github.io/serena/01-about/020_programming-languages.html#language-servers
-# When using multiple languages, the first language server that supports a given file will be used for that file.
-# The first language is the default language and the respective language server will be used as a fallback.
-# Note that when using the JetBrains backend, language servers are not used and this list is correspondingly ignored.
-languages:
-- typescript