@m16khb/llm-wiki 0.1.1 → 0.1.2

package/README.md

@@ -236,6 +236,10 @@ UserPromptSubmit  -> llm-wiki hook -> prompt keyword + project/tech terms로 wik
 Stop              -> llm-wiki hook -> assistant가 명시한 llm-wiki-capture block만 30-sessions/에 저장
 ```
 
+`SessionStart`/`UserPromptSubmit` hook은 `suppressOutput: true`로 transcript 출력을 숨긴다. 실제 context는
+`hookSpecificOutput.additionalContext`로 주입되지만, Codex/Claude transcript에 긴 `hook context:` 문자열이 빽빽하게
+보이지 않게 하기 위한 UX 안전장치다.
+
 `go.mod`가 있으면 Go/Golang을 감지하고, MCP SDK·SQLite·Gin·GORM·Redis 같은 dependency 신호, `package.json`/`bin` 기반 Node/npm/npx wrapper 신호, `swaggo` dependency나 `swagger.yaml`/`openapi.yaml` 같은 API spec 파일을 tech context로 별도 검색한다. 검색 결과는 현재 project와 맞는 문서를 우선하고, 다른 repository 전용 reference는 hook tech context에서 제외한다.
 
 공용 wrapper는 `scripts/hooks/llm-wiki-hook.sh`다. `LLM_WIKI_BIN`이 있으면 그 binary를 쓰고, 없으면 `llm-wiki` PATH, 마지막으로 이 repo를 `npx --package <repo>`로 실행한다.
@@ -293,7 +297,7 @@ tool_timeout_sec = 60
 
 `llm-wiki mcp`는 daemon을 거치지 않고 stdio MCP server가 직접 vault/service를 연다. stdio-only 환경의 비상/호환 경로이며, Claude Code와 Codex가 같은 daemon을 공유해야 하는 기본 운영에는 `mcp-autostart`를 사용한다.
 
-npx wrapper는 기존 `bin/llm-wiki`가 있으면 그대로 실행하고, 없으면 Go toolchain으로 CLI를 cache에 빌드한 뒤 실행한다. MCP stdio 안전을 위해 wrapper 자체는 stdout에 진단을 쓰지 않는다. `--prefix /tmp`는 이 repo처럼 현재 프로젝트의 `package.json` 이름이 `@m16khb/llm-wiki`와 같을 때 npx가 local package로 오인하는 것을 피하기 위한 안전장치다.
+npx wrapper는 기존 `bin/llm-wiki`가 있고 Go build input보다 최신이면 그대로 실행한다. bundled binary가 stale이거나 없으면 Go toolchain으로 CLI를 cache에 빌드한 뒤 실행한다. `LLM_WIKI_NPM_REBUILD=1`은 bundled/cache binary를 모두 무시하고 재빌드한다. MCP stdio 안전을 위해 wrapper 자체는 stdout에 진단을 쓰지 않는다. `--prefix /tmp`는 이 repo처럼 현재 프로젝트의 `package.json` 이름이 `@m16khb/llm-wiki`와 같을 때 npx가 local package로 오인하는 것을 피하기 위한 안전장치다.
 
 ## 개발 문서
 

package/cmd/llm-wiki/hook_test.go

@@ -0,0 +1,108 @@
+package main
+
+import (
+	"encoding/json"
+	"io"
+	"os"
+	"path/filepath"
+	"testing"
+)
+
+func TestContextHookSuppressesTranscriptOutput(t *testing.T) {
+	vaultRoot := t.TempDir()
+	writeTestFile(t, vaultRoot, "20-wiki/concepts/llm-wiki-hooks.md", `---
+title: LLM Wiki Hooks
+type: concept
+status: active
+created: 2026-05-23
+updated: 2026-05-23
+tags: [llm-wiki, hooks]
+domain: agent-memory
+---
+
+# LLM Wiki Hooks
+
+Hook context for llm-wiki.
+`)
+	projectRoot := filepath.Join(t.TempDir(), "llm-wiki")
+	writeTestFile(t, projectRoot, "go.mod", "module github.com/m16khb/llm-wiki\n")
+
+	stdout := captureRunHook(t, []string{"--vault", vaultRoot, "--limit", "5"}, `{
+		"hook_event_name": "UserPromptSubmit",
+		"cwd": "`+projectRoot+`",
+		"prompt": "hook output"
+	}`)
+
+	var payload struct {
+		SuppressOutput     bool `json:"suppressOutput"`
+		HookSpecificOutput struct {
+			HookEventName     string `json:"hookEventName"`
+			AdditionalContext string `json:"additionalContext"`
+		} `json:"hookSpecificOutput"`
+	}
+	if err := json.Unmarshal([]byte(stdout), &payload); err != nil {
+		t.Fatalf("hook output is not valid JSON: %v\n%s", err, stdout)
+	}
+	if !payload.SuppressOutput {
+		t.Fatalf("expected context hook to suppress transcript output, got:\n%s", stdout)
+	}
+	if payload.HookSpecificOutput.HookEventName != "UserPromptSubmit" {
+		t.Fatalf("unexpected event name: %q", payload.HookSpecificOutput.HookEventName)
+	}
+	if payload.HookSpecificOutput.AdditionalContext == "" {
+		t.Fatalf("expected additionalContext to remain available for model injection")
+	}
+}
+
+func captureRunHook(t *testing.T, args []string, stdin string) string {
+	t.Helper()
+
+	oldStdin := os.Stdin
+	oldStdout := os.Stdout
+	defer func() {
+		os.Stdin = oldStdin
+		os.Stdout = oldStdout
+	}()
+
+	inRead, inWrite, err := os.Pipe()
+	if err != nil {
+		t.Fatalf("pipe stdin: %v", err)
+	}
+	if _, err := inWrite.WriteString(stdin); err != nil {
+		t.Fatalf("write stdin: %v", err)
+	}
+	if err := inWrite.Close(); err != nil {
+		t.Fatalf("close stdin writer: %v", err)
+	}
+	defer inRead.Close()
+
+	outRead, outWrite, err := os.Pipe()
+	if err != nil {
+		t.Fatalf("pipe stdout: %v", err)
+	}
+	defer outRead.Close()
+
+	os.Stdin = inRead
+	os.Stdout = outWrite
+	runHook(args)
+	if err := outWrite.Close(); err != nil {
+		t.Fatalf("close stdout writer: %v", err)
+	}
+
+	data, err := io.ReadAll(outRead)
+	if err != nil {
+		t.Fatalf("read stdout: %v", err)
+	}
+	return string(data)
+}
+
+func writeTestFile(t *testing.T, root, rel, content string) {
+	t.Helper()
+	abs := filepath.Join(root, filepath.FromSlash(rel))
+	if err := os.MkdirAll(filepath.Dir(abs), 0o755); err != nil {
+		t.Fatalf("mkdir %s: %v", rel, err)
+	}
+	if err := os.WriteFile(abs, []byte(content), 0o644); err != nil {
+		t.Fatalf("write %s: %v", rel, err)
+	}
+}

package/cmd/llm-wiki/main.go

@@ -581,7 +581,13 @@ func runContextHook(vaultRoot, projectPath, query string, limit int, event strin
 		printHookJSON(map[string]any{})
 		return
 	}
-	printHookJSON(map[string]any{"hookSpecificOutput": map[string]any{"hookEventName": event, "additionalContext": sessionctx.FormatAdditionalContext(ctx)}})
+	printHookJSON(map[string]any{
+		"suppressOutput": true,
+		"hookSpecificOutput": map[string]any{
+			"hookEventName":     event,
+			"additionalContext": sessionctx.FormatAdditionalContext(ctx),
+		},
+	})
 }
 
 func runStopHook(vaultRoot, dbPath string, in hookInput) {

package/go.mod

@@ -1,6 +1,6 @@
 module github.com/m16khb/llm-wiki
 
-go 1.25.5
+go 1.26.3
 
 require github.com/modelcontextprotocol/go-sdk v1.6.0
 

package/npm/lib/runner.js

@@ -9,6 +9,9 @@ const SIGNAL_EXIT_CODES = {
   SIGTERM: 143,
 };
 
+const FINGERPRINT_INPUT_ENTRIES = ['go.mod', 'go.sum', 'package.json', 'cmd', 'internal'];
+const BINARY_INPUT_ENTRIES = ['go.mod', 'go.sum', 'cmd', 'internal'];
+
 function executableName(platform = process.platform) {
   return platform === 'win32' ? 'llm-wiki.exe' : 'llm-wiki';
 }
@@ -25,7 +28,9 @@ function isExecutable(file) {
 
 function findBundledBinary(packageRoot, platform = process.platform) {
   const candidate = path.join(packageRoot, 'bin', executableName(platform));
-  return isExecutable(candidate) ? candidate : '';
+  if (!isExecutable(candidate)) return '';
+  if (isBundledBinaryStale(packageRoot, candidate)) return '';
+  return candidate;
 }
 
 function readPackageVersion(packageRoot) {
@@ -38,7 +43,11 @@ function readPackageVersion(packageRoot) {
   }
 }
 
-function hashFile(hash, root, file) {
+function isBuildInput(file) {
+  return file.endsWith('.go') || ['go.mod', 'go.sum', 'package.json'].includes(path.basename(file));
+}
+
+function walkBuildInputs(root, file, visitor) {
   let stat;
   try {
     stat = fs.statSync(file);
@@ -49,14 +58,23 @@ function hashFile(hash, root, file) {
   if (stat.isDirectory()) {
     const entries = fs.readdirSync(file).sort();
     for (const entry of entries) {
-      hashFile(hash, root, path.join(file, entry));
+      walkBuildInputs(root, path.join(file, entry), visitor);
     }
     return;
   }
-  const isBuildInput = file.endsWith('.go') || ['go.mod', 'go.sum', 'package.json'].includes(path.basename(file));
-  if (!stat.isFile() || !isBuildInput) {
+  if (!stat.isFile() || !isBuildInput(file)) {
     return;
   }
+  visitor(file, stat);
+}
+
+function visitBuildInputs(packageRoot, entries, visitor) {
+  for (const entry of entries) {
+    walkBuildInputs(packageRoot, path.join(packageRoot, entry), visitor);
+  }
+}
+
+function hashFile(hash, root, file, stat) {
   hash.update(path.relative(root, file));
   hash.update('\0');
   hash.update(String(stat.size));
@@ -67,12 +85,30 @@ function hashFile(hash, root, file) {
 
 function sourceFingerprint(packageRoot) {
   const hash = crypto.createHash('sha256');
-  for (const entry of ['go.mod', 'go.sum', 'package.json', 'cmd', 'internal']) {
-    hashFile(hash, packageRoot, path.join(packageRoot, entry));
-  }
+  visitBuildInputs(packageRoot, FINGERPRINT_INPUT_ENTRIES, (file, stat) => hashFile(hash, packageRoot, file, stat));
   return hash.digest('hex').slice(0, 16);
 }
 
+function latestBuildInputMTime(packageRoot) {
+  let latest = 0;
+  visitBuildInputs(packageRoot, BINARY_INPUT_ENTRIES, (_file, stat) => {
+    if (stat.mtimeMs > latest) latest = stat.mtimeMs;
+  });
+  return latest;
+}
+
+function isBundledBinaryStale(packageRoot, binary) {
+  let binaryStat;
+  try {
+    binaryStat = fs.statSync(binary);
+  } catch (err) {
+    if (err && err.code === 'ENOENT') return true;
+    throw err;
+  }
+  const latestInput = latestBuildInputMTime(packageRoot);
+  return latestInput > binaryStat.mtimeMs;
+}
+
 function defaultCacheRoot(env = process.env) {
   if (env.LLM_WIKI_NPM_CACHE_DIR) return env.LLM_WIKI_NPM_CACHE_DIR;
   if (env.XDG_CACHE_HOME) return path.join(env.XDG_CACHE_HOME, 'llm-wiki', 'npm-wrapper');
@@ -110,8 +146,10 @@ function buildBinary(packageRoot, output, env = process.env) {
 function ensureBinary(options = {}) {
   const env = options.env || process.env;
   const packageRoot = options.packageRoot || env.LLM_WIKI_NPM_PACKAGE_ROOT || path.resolve(__dirname, '..', '..');
-  const bundled = findBundledBinary(packageRoot);
-  if (bundled) return bundled;
+  if (env.LLM_WIKI_NPM_REBUILD !== '1') {
+    const bundled = findBundledBinary(packageRoot);
+    if (bundled) return bundled;
+  }
 
   const cached = cacheBinaryPath(packageRoot, env);
   if (isExecutable(cached) && env.LLM_WIKI_NPM_REBUILD !== '1') return cached;
@@ -162,6 +200,8 @@ module.exports = {
   ensureBinary,
   executableName,
   findBundledBinary,
+  isBundledBinaryStale,
+  latestBuildInputMTime,
   run,
   sourceFingerprint,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@m16khb/llm-wiki",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "npx wrapper for the llm-wiki Go MCP server and CLI",
   "bin": {
     "llm-wiki": "npm/bin/llm-wiki.js"