agent-sin 0.1.11 → 0.1.15

package/dist/core/obsidian-vault.js

@@ -0,0 +1,477 @@
+import { mkdir, readFile, readlink, stat, symlink, unlink, writeFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { l } from "./i18n.js";
+export function defaultObsidianVaultDir() {
+    return path.join(os.homedir(), "Obsidian", "Agent-Sin");
+}
+export function resolvedObsidianVaultDir(config) {
+    const raw = config.obsidian_vault_dir;
+    if (raw === undefined)
+        return defaultObsidianVaultDir();
+    const trimmed = raw.trim();
+    return trimmed;
+}
+const HOME_TEMPLATE_JA = `---
+tags: [moc, home]
+---
+
+# Agent-Sin Vault
+
+Agent-Sin が扱う記憶・メモを Obsidian で読み書きしやすくしたビューです。実体は \`~/.agent-sin/\` 配下にあり、ここからはシンボリックリンクで参照しています。**ファイルを移動・リネームすると Agent-Sin 側の動作に影響する**ため、編集は本文の追記・修正に留めてください。
+
+## プロフィール（長期記憶）
+
+- [[01 Profile/user|user.md]] — 固定プロフィール
+- [[01 Profile/soul|soul.md]] — Agent-Sin 自身の姿勢メモ
+- [[01 Profile/memory|memory.md]] — 嗜好・価値観・コミュニケーション傾向
+
+## 日次メモリ（会話の要約）
+
+\`02 Daily Memory/YYYY/MM/YYYY-MM-DD.md\` に日次で Agent-Sin との会話が整形保存されています。生の jsonl ログは Vault 外（\`~/.agent-sin/logs/conversations/\`）にあります。
+
+## ノート
+
+\`03 Notes/memo/{タイトル}.md\` 形式で 1メモ=1ファイル として保存されます。AIが自動でタイトルを付与し、同じタイトルで保存すると本文末尾に追記されます。最新メモはファイルエクスプローラーを「更新日時の新しい順」に並べると上から見えます。旧 \`YYYY/MM/YYYY-MM-DD.md\` 形式のファイルは \`03 Notes/legacy/\` 配下に退避済みです。
+
+会話で添付した画像は Vault 外の \`~/.agent-sin/memory/attachments/\` に保存され、daily memory の md から絶対パスで参照されます（md を開けば画像も表示されます）。どこからも参照されなくなった画像は 7 日経過後に自動削除されます。
+
+## トピック知識（JSON・閲覧専用）
+
+\`04 Topics/topics/*.json\` に Agent-Sin が夜間に蒸留したトピック別の長期知識が入っています。Obsidian 上では読み取り中心で扱ってください（書き換えると Agent-Sin 側で上書きされる可能性があります）。
+
+## ToDo
+
+\`05 ToDo/todos.md\` に未完了/完了の ToDo が一覧表示されます。Obsidian 上でチェックを切ったり、行を追加・削除すると、次回の todo スキル実行時に Agent-Sin 側へ取り込まれます（Obsidian 優先）。\`^id-xxxx\` のアンカーは触らないでください。
+
+## スキル成果物
+
+\`06 Skills/<スキル名>/\` 配下に、各スキルが書き出したユーザー閲覧前提の md（マーケログ、SNS下書き、買い物リスト、健康ログ等）が並びます。ファイル名はスキルが用途名で付け、日付ディレクトリは作りません。**読む・本文を編集するのは OK** ですが、ファイル名や置き場所を変えるとスキル側の追記処理が当たらなくなるので、リネームは控えてください。スキル内部の状態（ユーザーに見せないもの）はここではなく、スキルのメモリや SQLite に置かれます。
+
+## 編集ルール
+
+- **触ってよい**: profile 配下の \`.md\` 本文、\`03 Notes/memo/\` 配下のファイル追加・編集、daily memory の加筆メモ、\`05 ToDo/todos.md\` のチェック・追加・削除、\`06 Skills/\` 配下の本文編集
+- **触らない**: \`04 Topics\` 配下の JSON、\`02 Daily Memory\` のタイムスタンプ見出し、\`03 Notes/legacy/\` 配下
+- **してはいけない**: シンボリックリンクの削除・リネーム、フォルダの場所変更、\`06 Skills/\` 配下のファイル名・配置変更
+`;
+const HOME_TEMPLATE_EN = `---
+tags: [moc, home]
+---
+
+# Agent-Sin Vault
+
+A human-readable Obsidian view over the memory and notes that Agent-Sin manages. The real files live under \`~/.agent-sin/\` and are exposed here through symlinks. **Do not move or rename the linked folders** — Agent-Sin reads/writes them directly.
+
+## Profile (long-term memory)
+
+- [[01 Profile/user|user.md]] — fixed profile
+- [[01 Profile/soul|soul.md]] — Agent-Sin's posture notes
+- [[01 Profile/memory|memory.md]] — preferences, values, communication patterns
+
+## Daily Memory
+
+\`02 Daily Memory/YYYY/MM/YYYY-MM-DD.md\` holds Agent-Sin's formatted conversation memory per day. Raw jsonl logs stay outside the vault under \`~/.agent-sin/logs/conversations/\`.
+
+## Notes
+
+\`03 Notes/memo/{title}.md\` stores one memo per file. The title is generated by AI; saving the same title appends to the existing file. Sort the file explorer by "Modified time (newest)" to see the latest memos at the top. Older daily-style files (\`YYYY/MM/YYYY-MM-DD.md\`) have been moved to \`03 Notes/legacy/\`.
+
+Image attachments uploaded in chat are stored outside the vault under \`~/.agent-sin/memory/attachments/\` and referenced from daily memory md files by absolute path (clicking through the md renders the image). Images that nothing references anymore are pruned 7 days after they go stale.
+
+## Topic knowledge (JSON, read-only)
+
+\`04 Topics/topics/*.json\` stores per-topic long-term knowledge distilled by Agent-Sin nightly. Treat as read-only; Agent-Sin will overwrite manual edits.
+
+## ToDo
+
+\`05 ToDo/todos.md\` lists open and completed ToDos. Toggling a checkbox or adding/removing a line here is picked up by Agent-Sin on the next todo skill run (Obsidian wins). Do not edit the \`^id-xxxx\` block anchors.
+
+## Skill outputs
+
+\`06 Skills/<skill-id>/\` is where each skill writes user-visible markdown (marketing logs, SNS drafts, shopping lists, health logs, etc.). Filenames are chosen by the skill (no date subfolders). **Reading and editing the body is safe**, but do not rename or move the files — the skill's append/merge logic relies on the path. Internal state that the user shouldn't see is stored in skill memory or SQLite instead, not here.
+
+## Editing rules
+
+- **Safe to edit**: profile \`.md\` bodies, files under \`03 Notes/memo/\`, daily memory annotations, \`05 ToDo/todos.md\` (check/add/remove), file bodies under \`06 Skills/\`
+- **Do not edit**: JSON under \`04 Topics\`, timestamp headers in \`02 Daily Memory\`, files under \`03 Notes/legacy/\`
+- **Never**: delete or rename the symlinked folders, rename or move files under \`06 Skills/\`
+`;
+// 旧テンプレ (attachments を 03 Notes/attachments/ で案内していた頃の 06 Skills あり版)。
+const LEGACY_HOME_TEMPLATE_JA_V3 = `---
+tags: [moc, home]
+---
+
+# Agent-Sin Vault
+
+Agent-Sin が扱う記憶・メモを Obsidian で読み書きしやすくしたビューです。実体は \`~/.agent-sin/\` 配下にあり、ここからはシンボリックリンクで参照しています。**ファイルを移動・リネームすると Agent-Sin 側の動作に影響する**ため、編集は本文の追記・修正に留めてください。
+
+## プロフィール（長期記憶）
+
+- [[01 Profile/user|user.md]] — 固定プロフィール
+- [[01 Profile/soul|soul.md]] — Agent-Sin 自身の姿勢メモ
+- [[01 Profile/memory|memory.md]] — 嗜好・価値観・コミュニケーション傾向
+
+## 日次メモリ（会話の要約）
+
+\`02 Daily Memory/YYYY/MM/YYYY-MM-DD.md\` に日次で Agent-Sin との会話が整形保存されています。生の jsonl ログは Vault 外（\`~/.agent-sin/logs/conversations/\`）にあります。
+
+## ノート
+
+\`03 Notes/memo/{タイトル}.md\` 形式で 1メモ=1ファイル として保存されます。AIが自動でタイトルを付与し、同じタイトルで保存すると本文末尾に追記されます。最新メモはファイルエクスプローラーを「更新日時の新しい順」に並べると上から見えます。旧 \`YYYY/MM/YYYY-MM-DD.md\` 形式のファイルは \`03 Notes/legacy/\` 配下に退避済みです。添付画像は \`03 Notes/attachments/\` 配下です。
+
+## トピック知識（JSON・閲覧専用）
+
+\`04 Topics/topics/*.json\` に Agent-Sin が夜間に蒸留したトピック別の長期知識が入っています。Obsidian 上では読み取り中心で扱ってください（書き換えると Agent-Sin 側で上書きされる可能性があります）。
+
+## ToDo
+
+\`05 ToDo/todos.md\` に未完了/完了の ToDo が一覧表示されます。Obsidian 上でチェックを切ったり、行を追加・削除すると、次回の todo スキル実行時に Agent-Sin 側へ取り込まれます（Obsidian 優先）。\`^id-xxxx\` のアンカーは触らないでください。
+
+## スキル成果物
+
+\`06 Skills/<スキル名>/\` 配下に、各スキルが書き出したユーザー閲覧前提の md（マーケログ、SNS下書き、買い物リスト、健康ログ等）が並びます。ファイル名はスキルが用途名で付け、日付ディレクトリは作りません。**読む・本文を編集するのは OK** ですが、ファイル名や置き場所を変えるとスキル側の追記処理が当たらなくなるので、リネームは控えてください。スキル内部の状態（ユーザーに見せないもの）はここではなく、スキルのメモリや SQLite に置かれます。
+
+## 編集ルール
+
+- **触ってよい**: profile 配下の \`.md\` 本文、\`03 Notes/memo/\` 配下のファイル追加・編集、daily memory の加筆メモ、\`05 ToDo/todos.md\` のチェック・追加・削除、\`06 Skills/\` 配下の本文編集
+- **触らない**: \`04 Topics\` 配下の JSON、\`02 Daily Memory\` のタイムスタンプ見出し、\`03 Notes/legacy/\` 配下
+- **してはいけない**: シンボリックリンクの削除・リネーム、フォルダの場所変更、\`06 Skills/\` 配下のファイル名・配置変更
+`;
+const LEGACY_HOME_TEMPLATE_EN_V3 = `---
+tags: [moc, home]
+---
+
+# Agent-Sin Vault
+
+A human-readable Obsidian view over the memory and notes that Agent-Sin manages. The real files live under \`~/.agent-sin/\` and are exposed here through symlinks. **Do not move or rename the linked folders** — Agent-Sin reads/writes them directly.
+
+## Profile (long-term memory)
+
+- [[01 Profile/user|user.md]] — fixed profile
+- [[01 Profile/soul|soul.md]] — Agent-Sin's posture notes
+- [[01 Profile/memory|memory.md]] — preferences, values, communication patterns
+
+## Daily Memory
+
+\`02 Daily Memory/YYYY/MM/YYYY-MM-DD.md\` holds Agent-Sin's formatted conversation memory per day. Raw jsonl logs stay outside the vault under \`~/.agent-sin/logs/conversations/\`.
+
+## Notes
+
+\`03 Notes/memo/{title}.md\` stores one memo per file. The title is generated by AI; saving the same title appends to the existing file. Sort the file explorer by "Modified time (newest)" to see the latest memos at the top. Older daily-style files (\`YYYY/MM/YYYY-MM-DD.md\`) have been moved to \`03 Notes/legacy/\`. Attachments live under \`03 Notes/attachments/\`.
+
+## Topic knowledge (JSON, read-only)
+
+\`04 Topics/topics/*.json\` stores per-topic long-term knowledge distilled by Agent-Sin nightly. Treat as read-only; Agent-Sin will overwrite manual edits.
+
+## ToDo
+
+\`05 ToDo/todos.md\` lists open and completed ToDos. Toggling a checkbox or adding/removing a line here is picked up by Agent-Sin on the next todo skill run (Obsidian wins). Do not edit the \`^id-xxxx\` block anchors.
+
+## Skill outputs
+
+\`06 Skills/<skill-id>/\` is where each skill writes user-visible markdown (marketing logs, SNS drafts, shopping lists, health logs, etc.). Filenames are chosen by the skill (no date subfolders). **Reading and editing the body is safe**, but do not rename or move the files — the skill's append/merge logic relies on the path. Internal state that the user shouldn't see is stored in skill memory or SQLite instead, not here.
+
+## Editing rules
+
+- **Safe to edit**: profile \`.md\` bodies, files under \`03 Notes/memo/\`, daily memory annotations, \`05 ToDo/todos.md\` (check/add/remove), file bodies under \`06 Skills/\`
+- **Do not edit**: JSON under \`04 Topics\`, timestamp headers in \`02 Daily Memory\`, files under \`03 Notes/legacy/\`
+- **Never**: delete or rename the symlinked folders, rename or move files under \`06 Skills/\`
+`;
+// さらに古い旧テンプレ (memo/legacy 区分が入った版。06 Skills 追加前)。
+// writeIfMissingOrPristine がこれと完全一致するときだけ新版に自動更新する。
+const LEGACY_HOME_TEMPLATE_JA_V2 = `---
+tags: [moc, home]
+---
+
+# Agent-Sin Vault
+
+Agent-Sin が扱う記憶・メモを Obsidian で読み書きしやすくしたビューです。実体は \`~/.agent-sin/\` 配下にあり、ここからはシンボリックリンクで参照しています。**ファイルを移動・リネームすると Agent-Sin 側の動作に影響する**ため、編集は本文の追記・修正に留めてください。
+
+## プロフィール（長期記憶）
+
+- [[01 Profile/user|user.md]] — 固定プロフィール
+- [[01 Profile/soul|soul.md]] — Agent-Sin 自身の姿勢メモ
+- [[01 Profile/memory|memory.md]] — 嗜好・価値観・コミュニケーション傾向
+
+## 日次メモリ（会話の要約）
+
+\`02 Daily Memory/YYYY/MM/YYYY-MM-DD.md\` に日次で Agent-Sin との会話が整形保存されています。生の jsonl ログは Vault 外（\`~/.agent-sin/logs/conversations/\`）にあります。
+
+## ノート
+
+\`03 Notes/memo/{タイトル}.md\` 形式で 1メモ=1ファイル として保存されます。AIが自動でタイトルを付与し、同じタイトルで保存すると本文末尾に追記されます。最新メモはファイルエクスプローラーを「更新日時の新しい順」に並べると上から見えます。旧 \`YYYY/MM/YYYY-MM-DD.md\` 形式のファイルは \`03 Notes/legacy/\` 配下に退避済みです。添付画像は \`03 Notes/attachments/\` 配下です。
+
+## トピック知識（JSON・閲覧専用）
+
+\`04 Topics/topics/*.json\` に Agent-Sin が夜間に蒸留したトピック別の長期知識が入っています。Obsidian 上では読み取り中心で扱ってください（書き換えると Agent-Sin 側で上書きされる可能性があります）。
+
+## ToDo
+
+\`05 ToDo/todos.md\` に未完了/完了の ToDo が一覧表示されます。Obsidian 上でチェックを切ったり、行を追加・削除すると、次回の todo スキル実行時に Agent-Sin 側へ取り込まれます（Obsidian 優先）。\`^id-xxxx\` のアンカーは触らないでください。
+
+## 編集ルール
+
+- **触ってよい**: profile 配下の \`.md\` 本文、\`03 Notes/memo/\` 配下のファイル追加・編集、daily memory の加筆メモ、\`05 ToDo/todos.md\` のチェック・追加・削除
+- **触らない**: \`04 Topics\` 配下の JSON、\`02 Daily Memory\` のタイムスタンプ見出し、\`03 Notes/legacy/\` 配下
+- **してはいけない**: シンボリックリンクの削除・リネーム、フォルダの場所変更
+`;
+const LEGACY_HOME_TEMPLATE_EN_V2 = `---
+tags: [moc, home]
+---
+
+# Agent-Sin Vault
+
+A human-readable Obsidian view over the memory and notes that Agent-Sin manages. The real files live under \`~/.agent-sin/\` and are exposed here through symlinks. **Do not move or rename the linked folders** — Agent-Sin reads/writes them directly.
+
+## Profile (long-term memory)
+
+- [[01 Profile/user|user.md]] — fixed profile
+- [[01 Profile/soul|soul.md]] — Agent-Sin's posture notes
+- [[01 Profile/memory|memory.md]] — preferences, values, communication patterns
+
+## Daily Memory
+
+\`02 Daily Memory/YYYY/MM/YYYY-MM-DD.md\` holds Agent-Sin's formatted conversation memory per day. Raw jsonl logs stay outside the vault under \`~/.agent-sin/logs/conversations/\`.
+
+## Notes
+
+\`03 Notes/memo/{title}.md\` stores one memo per file. The title is generated by AI; saving the same title appends to the existing file. Sort the file explorer by "Modified time (newest)" to see the latest memos at the top. Older daily-style files (\`YYYY/MM/YYYY-MM-DD.md\`) have been moved to \`03 Notes/legacy/\`. Attachments live under \`03 Notes/attachments/\`.
+
+## Topic knowledge (JSON, read-only)
+
+\`04 Topics/topics/*.json\` stores per-topic long-term knowledge distilled by Agent-Sin nightly. Treat as read-only; Agent-Sin will overwrite manual edits.
+
+## ToDo
+
+\`05 ToDo/todos.md\` lists open and completed ToDos. Toggling a checkbox or adding/removing a line here is picked up by Agent-Sin on the next todo skill run (Obsidian wins). Do not edit the \`^id-xxxx\` block anchors.
+
+## Editing rules
+
+- **Safe to edit**: profile \`.md\` bodies, files under \`03 Notes/memo/\`, daily memory annotations, \`05 ToDo/todos.md\` (check/add/remove)
+- **Do not edit**: JSON under \`04 Topics\`, timestamp headers in \`02 Daily Memory\`, files under \`03 Notes/legacy/\`
+- **Never**: delete or rename the symlinked folders
+`;
+// さらに古いテンプレ（メモが日付ベースで保存されていた頃の版）。
+const LEGACY_HOME_TEMPLATE_JA = `---
+tags: [moc, home]
+---
+
+# Agent-Sin Vault
+
+Agent-Sin が扱う記憶・メモを Obsidian で読み書きしやすくしたビューです。実体は \`~/.agent-sin/\` 配下にあり、ここからはシンボリックリンクで参照しています。**ファイルを移動・リネームすると Agent-Sin 側の動作に影響する**ため、編集は本文の追記・修正に留めてください。
+
+## プロフィール（長期記憶）
+
+- [[01 Profile/user|user.md]] — 固定プロフィール
+- [[01 Profile/soul|soul.md]] — Agent-Sin 自身の姿勢メモ
+- [[01 Profile/memory|memory.md]] — 嗜好・価値観・コミュニケーション傾向
+
+## 日次メモリ（会話の要約）
+
+\`02 Daily Memory/YYYY/MM/YYYY-MM-DD.md\` に日次で Agent-Sin との会話が整形保存されています。生の jsonl ログは Vault 外（\`~/.agent-sin/logs/conversations/\`）にあります。
+
+## ノート
+
+\`03 Notes/YYYY/MM/YYYY-MM-DD.md\` 形式でメモやスキル出力が保存されます。添付画像は \`03 Notes/attachments/\` 配下です。
+
+## トピック知識（JSON・閲覧専用）
+
+\`04 Topics/topics/*.json\` に Agent-Sin が夜間に蒸留したトピック別の長期知識が入っています。Obsidian 上では読み取り中心で扱ってください（書き換えると Agent-Sin 側で上書きされる可能性があります）。
+
+## ToDo
+
+\`05 ToDo/todos.md\` に未完了/完了の ToDo が一覧表示されます。Obsidian 上でチェックを切ったり、行を追加・削除すると、次回の todo スキル実行時に Agent-Sin 側へ取り込まれます（Obsidian 優先）。\`^id-xxxx\` のアンカーは触らないでください。
+
+## 編集ルール
+
+- **触ってよい**: profile 配下の \`.md\` 本文、notes 配下の追記、daily memory の加筆メモ、\`05 ToDo/todos.md\` のチェック・追加・削除
+- **触らない**: \`04 Topics\` 配下の JSON、\`02 Daily Memory\` のタイムスタンプ見出し
+- **してはいけない**: シンボリックリンクの削除・リネーム、フォルダの場所変更
+`;
+const LEGACY_HOME_TEMPLATE_EN = `---
+tags: [moc, home]
+---
+
+# Agent-Sin Vault
+
+A human-readable Obsidian view over the memory and notes that Agent-Sin manages. The real files live under \`~/.agent-sin/\` and are exposed here through symlinks. **Do not move or rename the linked folders** — Agent-Sin reads/writes them directly.
+
+## Profile (long-term memory)
+
+- [[01 Profile/user|user.md]] — fixed profile
+- [[01 Profile/soul|soul.md]] — Agent-Sin's posture notes
+- [[01 Profile/memory|memory.md]] — preferences, values, communication patterns
+
+## Daily Memory
+
+\`02 Daily Memory/YYYY/MM/YYYY-MM-DD.md\` holds Agent-Sin's formatted conversation memory per day. Raw jsonl logs stay outside the vault under \`~/.agent-sin/logs/conversations/\`.
+
+## Notes
+
+\`03 Notes/YYYY/MM/YYYY-MM-DD.md\` is where memo and skill output is written. Attachments live under \`03 Notes/attachments/\`.
+
+## Topic knowledge (JSON, read-only)
+
+\`04 Topics/topics/*.json\` stores per-topic long-term knowledge distilled by Agent-Sin nightly. Treat as read-only; Agent-Sin will overwrite manual edits.
+
+## ToDo
+
+\`05 ToDo/todos.md\` lists open and completed ToDos. Toggling a checkbox or adding/removing a line here is picked up by Agent-Sin on the next todo skill run (Obsidian wins). Do not edit the \`^id-xxxx\` block anchors.
+
+## Editing rules
+
+- **Safe to edit**: profile \`.md\` bodies, notes additions, daily memory annotations, \`05 ToDo/todos.md\` (check/add/remove)
+- **Do not edit**: JSON under \`04 Topics\`, timestamp headers in \`02 Daily Memory\`
+- **Never**: delete or rename the symlinked folders
+`;
+const OBSIDIAN_APP_JSON = `${JSON.stringify({
+    showUnsupportedFiles: true,
+    newFileLocation: "current",
+    attachmentFolderPath: "./",
+    alwaysUpdateLinks: false,
+    useMarkdownLinks: false,
+    promptDelete: true,
+}, null, 2)}\n`;
+const OBSIDIAN_APPEARANCE_JSON = `${JSON.stringify({
+    showInlineTitle: true,
+    showViewHeader: true,
+}, null, 2)}\n`;
+export async function ensureObsidianVault(config) {
+    const vaultDir = resolvedObsidianVaultDir(config);
+    if (!vaultDir) {
+        return {
+            enabled: false,
+            vaultDir: "",
+            created: false,
+            links: [],
+            homeCreated: false,
+            configCreated: false,
+        };
+    }
+    const alreadyExisted = await pathExists(vaultDir);
+    await mkdir(vaultDir, { recursive: true });
+    await mkdir(path.join(vaultDir, ".obsidian"), { recursive: true });
+    const linkSpecs = [
+        { name: "01 Profile", target: path.join(config.memory_dir, "profile") },
+        { name: "02 Daily Memory", target: path.join(config.memory_dir, "daily") },
+        { name: "03 Notes", target: config.notes_dir },
+        { name: "04 Topics", target: path.join(config.memory_dir, "topic-knowledge") },
+        { name: "05 ToDo", target: path.join(config.workspace, "todo") },
+        { name: "06 Skills", target: config.skill_outputs_dir },
+    ];
+    const links = [];
+    let symlinkError;
+    for (const spec of linkSpecs) {
+        const linkPath = path.join(vaultDir, spec.name);
+        const existing = await readSymlinkTarget(linkPath);
+        if (existing !== null) {
+            // 既存リンクが正しい場所を指していればそのまま
+            if (existing === spec.target) {
+                links.push({ name: spec.name, target: spec.target, created: false, ok: true });
+                continue;
+            }
+            // 別の場所を指していて、その先が dangling なら作り直す。生きている場合は触らない (ユーザーが意図して張り替えた可能性あり)
+            if (!(await pathExists(existing))) {
+                try {
+                    await unlink(linkPath);
+                }
+                catch {
+                    // unlink 失敗時は下のフォールバックに任せる
+                }
+            }
+            else {
+                links.push({ name: spec.name, target: spec.target, created: false, ok: false });
+                continue;
+            }
+        }
+        else if (await pathExists(linkPath)) {
+            // 同名の実体（ディレクトリ等）があれば触らない
+            links.push({ name: spec.name, target: spec.target, created: false, ok: false });
+            continue;
+        }
+        try {
+            // make sure the target dir exists so the link is not dangling
+            await mkdir(spec.target, { recursive: true });
+            await symlink(spec.target, linkPath, "dir");
+            links.push({ name: spec.name, target: spec.target, created: true, ok: true });
+        }
+        catch (error) {
+            symlinkError = error instanceof Error ? error.message : String(error);
+            links.push({ name: spec.name, target: spec.target, created: false, ok: false });
+        }
+    }
+    const todoDir = path.join(config.workspace, "todo");
+    await mkdir(todoDir, { recursive: true });
+    await writeIfMissing(path.join(todoDir, "todos.md"), l("# ToDo\n\n_(no ToDos yet)_\n", "# ToDo\n\n_(まだ ToDo はありません)_\n"));
+    const homePath = path.join(vaultDir, "Home.md");
+    const homeTemplate = l(HOME_TEMPLATE_EN, HOME_TEMPLATE_JA);
+    const homeCreated = await writeIfMissingOrPristine(homePath, homeTemplate, [
+        HOME_TEMPLATE_EN,
+        HOME_TEMPLATE_JA,
+        LEGACY_HOME_TEMPLATE_EN_V3,
+        LEGACY_HOME_TEMPLATE_JA_V3,
+        LEGACY_HOME_TEMPLATE_EN_V2,
+        LEGACY_HOME_TEMPLATE_JA_V2,
+        LEGACY_HOME_TEMPLATE_EN,
+        LEGACY_HOME_TEMPLATE_JA,
+    ]);
+    const appJsonPath = path.join(vaultDir, ".obsidian", "app.json");
+    const appearancePath = path.join(vaultDir, ".obsidian", "appearance.json");
+    const appCreated = await writeIfMissing(appJsonPath, OBSIDIAN_APP_JSON);
+    const appearanceCreated = await writeIfMissing(appearancePath, OBSIDIAN_APPEARANCE_JSON);
+    return {
+        enabled: true,
+        vaultDir,
+        created: !alreadyExisted,
+        links,
+        homeCreated,
+        configCreated: appCreated || appearanceCreated,
+        symlinkError,
+    };
+}
+async function readSymlinkTarget(file) {
+    try {
+        return await readlink(file);
+    }
+    catch {
+        return null;
+    }
+}
+async function pathExists(file) {
+    try {
+        await stat(file);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function writeIfMissing(file, content) {
+    try {
+        await stat(file);
+        return false;
+    }
+    catch {
+        await writeFile(file, content, "utf8");
+        return true;
+    }
+}
+// 既存ファイルが「過去のデフォルトテンプレ」のままなら、現ロケールの版に差し替える。
+// ユーザーが手で編集していれば触らない。
+async function writeIfMissingOrPristine(file, desired, pristineTemplates) {
+    let existing = null;
+    try {
+        existing = await readFile(file, "utf8");
+    }
+    catch {
+        await writeFile(file, desired, "utf8");
+        return true;
+    }
+    if (existing === desired)
+        return false;
+    const isPristine = pristineTemplates.some((tpl) => tpl === existing);
+    if (!isPristine)
+        return false;
+    await writeFile(file, desired, "utf8");
+    return true;
+}

package/dist/core/operating-model.d.ts

@@ -0,0 +1,2 @@
+export type AgentSinOperatingMode = "chat" | "builder";
+export declare function agentSinOperatingModelLines(mode: AgentSinOperatingMode): string[];

package/dist/core/operating-model.js

@@ -0,0 +1,15 @@
+export function agentSinOperatingModelLines(mode) {
+    const lines = [
+        "Agent-Sin operating model:",
+        "- Visible reply text informs the user; by itself, it does not execute actions, change modes, write files, restart services, register commands, or run tests.",
+        "- Agent-Sin can act only through the structured mechanisms that the host consumes for the current mode. Choose one of those mechanisms when action is intended.",
+        "- Before replying, decide whether the user needs an answer, an executable action, implementation work, or a clarifying question. Then emit the matching structured output instead of narrating an internal intention.",
+    ];
+    if (mode === "chat") {
+        lines.push("- In conversation mode, executable skill actions happen through skill_calls. If you intend to run a registered skill, include the skill call; do not merely say that you will run it.", "- In conversation mode, implementation handoff happens through build_suggestion. If a skill should be created or edited now, include build_suggestion; do not merely say that you are switching, handing off, or passing the task to build mode.", "- If no registered skill or build_suggestion matches the user's intent, answer the user or ask the smallest useful question. Do not promise an action that Agent-Sin cannot perform from the current mode.", "- Build mode is a host-managed state. The user-visible words 'I will switch to build mode' are not a mode transition unless the response also includes the build_suggestion structure.");
+    }
+    else {
+        lines.push("- In build mode, file blocks are the write mechanism. If you intend to create or edit a skill, emit the required file blocks; do not only write a completion report.", "- A completion report tells the user what is now possible, but it does not run the new skill, restart Agent-Sin, register slash commands, or modify host settings.", "- If a follow-up host action is needed after implementation, describe the next user-visible step briefly. Do not imply that the report text itself performed the action.");
+    }
+    return lines;
+}

package/dist/core/output-writer.d.ts

@@ -8,6 +8,7 @@ export interface SavedOutput {
     append: boolean;
     show_saved: boolean;
 }
+export type MergeMode = "overwrite" | "append" | "update_or_append";
 export declare function writeSkillOutputs(config: AppConfig, manifest: SkillManifest, result: SkillResult, date?: Date): Promise<SavedOutput[]>;
-export declare function resolveOutputFile(config: AppConfig, output: SkillOutputDefinition, date: Date): string;
-export declare function renderTemplate(template: string, date: Date): string;
+export declare function resolveOutputFile(config: AppConfig, output: SkillOutputDefinition, date: Date, overrideFilename?: string): string;
+export declare function renderTemplate(template: string, date: Date, vars?: Record<string, string>): string;