throughline 0.3.18 → 0.3.19

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "throughline",
-  "version": "0.3.18",
+  "version": "0.3.19",
   "type": "module",
   "description": "Claude Code hooks plugin for structured context compression (/clear-safe persistent memory)",
   "keywords": [

package/src/vscode-task.mjs

@@ -161,6 +161,37 @@ function atomicWrite(targetPath, contents) {
   renameSync(tmp, targetPath);
 }
 
+/**
+ * tasks.json を「今まさに作成/マージした」瞬間にユーザー向けへ送る通知テキスト。
+ *
+ * SessionStart / UserPromptSubmit の stdout は Claude Code に additional context として
+ * 取り込まれる。<system-reminder> で包んで Claude に「これをユーザーに伝える」ことを
+ * 明示しておくことで、新規プロジェクト初回セットアップ直後にユーザーへ
+ * 「Reload Window が必要」を即時通知できる。
+ *
+ * 通知するのは action が 'created' か 'merged' の場合のみ。既に存在した場合は
+ * セットアップ済みのため沈黙する（冪等性）。
+ */
+export function buildSetupNotice(action) {
+  if (action !== 'created' && action !== 'merged') return null;
+  return (
+    '<system-reminder>\n' +
+    'Throughline: このプロジェクトに token-monitor の自動起動設定を追加しました (.vscode/tasks.json)。\n' +
+    '今すぐ monitor を起動するには、VSCode のコマンドパレット (Ctrl+Shift+P) から\n' +
+    '  Developer: Reload Window\n' +
+    'を実行してください。次回以降はフォルダを開いた瞬間に自動起動します。\n' +
+    '\n' +
+    'このお知らせは今このプロジェクトで初回セットアップが完了したためだけに 1 度だけ流れています。\n' +
+    '必ずユーザー（あなたの対話相手）に日本語でそのまま伝えてください。\n' +
+    '</system-reminder>\n'
+  );
+}
+
+function emitSetupNotice(action) {
+  const text = buildSetupNotice(action);
+  if (text) process.stdout.write(text);
+}
+
 function emitJsoncGuidanceOnce(vscodeDir) {
   const markerPath = join(vscodeDir, JSONC_MARKER_FILENAME);
   if (existsSync(markerPath)) return;
@@ -215,6 +246,7 @@ export function ensureMonitorTaskFile(opts = {}) {
     if (!existsSync(vscodeDir)) mkdirSync(vscodeDir, { recursive: true });
     const obj = { version: '2.0.0', tasks: [buildMonitorTask(bin)] };
     atomicWrite(tasksPath, JSON.stringify(obj, null, 2) + '\n');
+    emitSetupNotice('created');
     return { action: 'created', path: tasksPath };
   }
 
@@ -243,5 +275,6 @@ export function ensureMonitorTaskFile(opts = {}) {
     tasks: [...(Array.isArray(obj.tasks) ? obj.tasks : []), buildMonitorTask(bin)],
   };
   atomicWrite(tasksPath, JSON.stringify(nextObj, null, indent) + '\n');
+  emitSetupNotice('merged');
   return { action: 'merged', path: tasksPath };
 }

package/src/vscode-task.test.mjs

@@ -10,6 +10,7 @@ import {
   detectIndent,
   hasMonitorTask,
   buildMonitorTask,
+  buildSetupNotice,
 } from './vscode-task.mjs';
 
 const VSCODE_ENV = { TERM_PROGRAM: 'vscode' };
@@ -518,3 +519,60 @@ test('ensureMonitorTaskFile: parse_error for malformed JSON', () => {
     cleanup();
   }
 });
+
+// --- buildSetupNotice ---
+
+test('buildSetupNotice: returns notice text for created', () => {
+  const text = buildSetupNotice('created');
+  assert.ok(text && text.includes('<system-reminder>'));
+  assert.ok(text.includes('Reload Window'));
+  assert.ok(text.includes('tasks.json'));
+  assert.ok(text.includes('ユーザー'));
+});
+
+test('buildSetupNotice: returns notice text for merged', () => {
+  const text = buildSetupNotice('merged');
+  assert.ok(text && text.includes('<system-reminder>'));
+  assert.ok(text.includes('Reload Window'));
+});
+
+test('buildSetupNotice: returns null for already_present (silent idempotency)', () => {
+  assert.equal(buildSetupNotice('already_present'), null);
+});
+
+test('buildSetupNotice: returns null for skipped', () => {
+  assert.equal(buildSetupNotice('skipped'), null);
+});
+
+test('buildSetupNotice: ensureMonitorTaskFile writes notice to stdout on first creation', () => {
+  const { dir, cleanup } = mkTmpCwd();
+  const captured = [];
+  const origWrite = process.stdout.write.bind(process.stdout);
+  process.stdout.write = (chunk) => {
+    captured.push(typeof chunk === 'string' ? chunk : chunk.toString('utf8'));
+    return true;
+  };
+  try {
+    const r1 = ensureMonitorTaskFile({
+      cwd: dir,
+      env: VSCODE_ENV,
+      throughlineBin: FAKE_BIN,
+    });
+    assert.equal(r1.action, 'created');
+    const r2 = ensureMonitorTaskFile({
+      cwd: dir,
+      env: VSCODE_ENV,
+      throughlineBin: FAKE_BIN,
+    });
+    assert.equal(r2.action, 'already_present');
+  } finally {
+    process.stdout.write = origWrite;
+    cleanup();
+  }
+  const joined = captured.join('');
+  assert.ok(joined.includes('<system-reminder>'), 'notice should be written on created');
+  assert.ok(joined.includes('Reload Window'));
+  // 2 回目 (already_present) では notice は出ない = created 分の 1 回のみ
+  const count = (joined.match(/<system-reminder>/g) ?? []).length;
+  assert.equal(count, 1, 'notice should be emitted exactly once (idempotency)');
+});