promptkaizen-agent 0.2.0 → 0.3.0

package/dist/hooks/platforms.js

@@ -0,0 +1,57 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isHookPlatform = isHookPlatform;
+exports.getPlatformConfig = getPlatformConfig;
+exports.platformAcceptsEvent = platformAcceptsEvent;
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+// Read / NotebookRead を含む (#110 R1.5): Read 出力の退避・再読込キャッシュ・連続Read検知の対象。
+// Edit 系は PreToolUse ブロック + 再読込キャッシュ無効化のため引き続き対象。
+const TOOL_MATCHER = 'Bash|Write|Edit|MultiEdit|NotebookEdit|Read|NotebookRead';
+const CLAUDE_CONFIG = {
+    id: 'claude-code',
+    events: ['PreToolUse', 'PostToolUse', 'UserPromptSubmit', 'SessionStart', 'PreCompact'],
+    denyOnly: false,
+    settingsFile: path_1.default.join(os_1.default.homedir(), '.claude', 'settings.json'),
+    commandMarker: 'promptkaizen-agent hook claude-code',
+    registrations: [
+        { event: 'PreToolUse', matcher: TOOL_MATCHER },
+        { event: 'PostToolUse', matcher: TOOL_MATCHER },
+        { event: 'UserPromptSubmit' },
+        { event: 'SessionStart' },
+        { event: 'PreCompact' },
+    ],
+};
+const CODEX_CONFIG = {
+    id: 'codex',
+    // Codex は PreCompact 非対応、代わりに Stop (ターン終了) を持つ。
+    events: ['PreToolUse', 'PostToolUse', 'UserPromptSubmit', 'SessionStart', 'Stop'],
+    denyOnly: true,
+    settingsFile: path_1.default.join(os_1.default.homedir(), '.codex', 'hooks.json'),
+    commandMarker: 'promptkaizen-agent hook codex',
+    registrations: [
+        { event: 'PreToolUse', matcher: TOOL_MATCHER },
+        { event: 'PostToolUse', matcher: TOOL_MATCHER },
+        { event: 'UserPromptSubmit' },
+        { event: 'SessionStart' },
+        { event: 'Stop' },
+    ],
+};
+const PLATFORMS = {
+    'claude-code': CLAUDE_CONFIG,
+    codex: CODEX_CONFIG,
+};
+function isHookPlatform(v) {
+    return v === 'claude-code' || v === 'codex';
+}
+function getPlatformConfig(platform) {
+    return PLATFORMS[platform];
+}
+/** プラットフォームがそのイベントを受理するか。 */
+function platformAcceptsEvent(platform, event) {
+    return PLATFORMS[platform].events.includes(event);
+}
+//# sourceMappingURL=platforms.js.map

package/dist/hooks/platforms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platforms.js","sourceRoot":"","sources":["../../src/hooks/platforms.ts"],"names":[],"mappings":";;;;;AA+EA,wCAEC;AAED,8CAEC;AAGD,oDAEC;AA1FD,4CAAmB;AACnB,gDAAuB;AAsCvB,wEAAwE;AACxE,kDAAkD;AAClD,MAAM,YAAY,GAAG,0DAA0D,CAAA;AAE/E,MAAM,aAAa,GAAmB;IACpC,EAAE,EAAE,aAAa;IACjB,MAAM,EAAE,CAAC,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,cAAc,EAAE,YAAY,CAAC;IACvF,QAAQ,EAAE,KAAK;IACf,YAAY,EAAE,cAAI,CAAC,IAAI,CAAC,YAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,eAAe,CAAC;IACjE,aAAa,EAAE,qCAAqC;IACpD,aAAa,EAAE;QACb,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE;QAC9C,EAAE,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,YAAY,EAAE;QAC/C,EAAE,KAAK,EAAE,kBAAkB,EAAE;QAC7B,EAAE,KAAK,EAAE,cAAc,EAAE;QACzB,EAAE,KAAK,EAAE,YAAY,EAAE;KACxB;CACF,CAAA;AAED,MAAM,YAAY,GAAmB;IACnC,EAAE,EAAE,OAAO;IACX,gDAAgD;IAChD,MAAM,EAAE,CAAC,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,CAAC;IACjF,QAAQ,EAAE,IAAI;IACd,YAAY,EAAE,cAAI,CAAC,IAAI,CAAC,YAAE,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,YAAY,CAAC;IAC7D,aAAa,EAAE,+BAA+B;IAC9C,aAAa,EAAE;QACb,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE;QAC9C,EAAE,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,YAAY,EAAE;QAC/C,EAAE,KAAK,EAAE,kBAAkB,EAAE;QAC7B,EAAE,KAAK,EAAE,cAAc,EAAE;QACzB,EAAE,KAAK,EAAE,MAAM,EAAE;KAClB;CACF,CAAA;AAED,MAAM,SAAS,GAAyC;IACtD,aAAa,EAAE,aAAa;IAC5B,KAAK,EAAE,YAAY;CACpB,CAAA;AAED,SAAgB,cAAc,CAAC,CAAU;IACvC,OAAO,CAAC,KAAK,aAAa,IAAI,CAAC,KAAK,OAAO,CAAA;AAC7C,CAAC;AAED,SAAgB,iBAAiB,CAAC,QAAsB;IACtD,OAAO,SAAS,CAAC,QAAQ,CAAC,CAAA;AAC5B,CAAC;AAED,6BAA6B;AAC7B,SAAgB,oBAAoB,CAAC,QAAsB,EAAE,KAAgB;IAC3E,OAAO,SAAS,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;AACnD,CAAC"}

package/dist/hooks/read-cache.d.ts

@@ -0,0 +1,71 @@
+import type { HookInput } from './claude-hook';
+import { type ReductionMeta } from './reduction';
+import type { StoredToolOutputRef } from '../store/local-store';
+/** Read 系ツール (出力の退避・キャッシュ対象)。 */
+export declare const READ_TOOLS: Set<string>;
+/** 編集系ツール (キャッシュ無効化のトリガ)。snapshot.ts:EDIT_TOOLS と同一集合。 */
+export declare const EDIT_TOOLS: Set<string>;
+/** Read/NotebookRead の対象ファイルパスを返す (それ以外・パス不明は null)。 */
+export declare function extractReadFilePath(input: HookInput): string | null;
+/** Edit/Write 系の対象ファイルパスを返す (それ以外・パス不明は null)。 */
+export declare function editedFilePath(input: HookInput): string | null;
+/** マスク後テキストの内容ハッシュ (再読込同一判定キー)。 */
+export declare function hashContent(maskedText: string): string;
+/** キャッシュヒントの差し替えテキストを組み立てる。 */
+export declare function buildCacheHintText(p: {
+    filePath: string;
+    refId: string;
+    originalTokens: number;
+}): string;
+/** キャッシュ判定の入力 (前回状態は呼び出し側が read_cache から取得して渡す)。 */
+export interface ReadCacheInput {
+    input: HookInput;
+    /** PostToolUse の tool_response から取り出したマスク後テキスト。 */
+    maskedContent: string;
+    /** 直前の同一 (session, file) の内容ハッシュ (未記録なら null)。 */
+    prevHash: string | null;
+    /** 直前の退避 ref_id (全文取得用。null ならヒントを出さない)。 */
+    prevRefId: string | null;
+    /** 直前が Edit/Write で無効化されているか。 */
+    invalidated: boolean;
+}
+/** キャッシュヒット時の結果 (差し替え + 削減メタ)。新規 ref は保存しない (前回 ref を指す)。 */
+export interface ReadCacheHit {
+    updatedToolOutput: unknown;
+    meta: ReductionMeta;
+}
+/**
+ * 再読込キャッシュヒットか判定する。ヒット条件:
+ *   前回ハッシュと一致 / 無効化されていない / 前回 ref_id がある / 削減になる。
+ * いずれか欠ければ null (= ミス。呼び出し側は全文を通し、退避 + キャッシュ seed する)。
+ * 副作用なし。
+ */
+export declare function planReadCacheHit(p: ReadCacheInput): ReadCacheHit | null;
+/**
+ * ③ 連続 Read 集約誘導 (#110)。transcript tail (JSONL) の末尾から連続する
+ * Read tool_use を数え、しきい値を「今ちょうど跨いだ」ときだけ advise=true を返す
+ * (跨いだ瞬間に 1 度だけ誘導を出し、以降の連続 Read では出さない)。
+ * 非 Read の tool_use が現れた時点で連続は途切れる。副作用なし。
+ */
+export declare function planBatchGuidance(transcriptTail: string, threshold: number): {
+    advise: boolean;
+    count: number;
+};
+/** 連続 Read 誘導の additionalContext テキスト。 */
+export declare function buildBatchGuidance(count: number): string;
+/**
+ * キャッシュミス時に保存する退避レコードを組み立てる (全文 body をマスク後で保持)。
+ * 退避は Read 全文 (サイズ問わず) を対象にし、次回の再読込をキャッシュヒットにできるようにする。
+ * 呼び出し側が LocalStore.recordToolOutputRef + upsertReadCache で保存する。
+ */
+export declare function buildReadCacheSeed(p: {
+    input: HookInput;
+    filePath: string;
+    maskedContent: string;
+    now: string;
+    refId?: string;
+}): {
+    ref: StoredToolOutputRef;
+    contentHash: string;
+};
+//# sourceMappingURL=read-cache.d.ts.map

package/dist/hooks/read-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-cache.d.ts","sourceRoot":"","sources":["../../src/hooks/read-cache.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAIL,KAAK,aAAa,EACnB,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAe/D,iCAAiC;AACjC,eAAO,MAAM,UAAU,aAAoC,CAAA;AAC3D,0DAA0D;AAC1D,eAAO,MAAM,UAAU,aAA0D,CAAA;AAOjF,wDAAwD;AACxD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CAKnE;AAED,kDAAkD;AAClD,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CAK9D;AAED,mCAAmC;AACnC,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,+BAA+B;AAC/B,wBAAgB,kBAAkB,CAAC,CAAC,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAMzG;AAED,oDAAoD;AACpD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,SAAS,CAAA;IAChB,mDAAmD;IACnD,aAAa,EAAE,MAAM,CAAA;IACrB,kDAAkD;IAClD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,4CAA4C;IAC5C,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,iCAAiC;IACjC,WAAW,EAAE,OAAO,CAAA;CACrB;AAED,6DAA6D;AAC7D,MAAM,WAAW,YAAY;IAC3B,iBAAiB,EAAE,OAAO,CAAA;IAC1B,IAAI,EAAE,aAAa,CAAA;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,cAAc,GAAG,YAAY,GAAG,IAAI,CAkBvE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,GAChB;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CA6BpC;AAED,0CAA0C;AAC1C,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMxD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE;IACpC,KAAK,EAAE,SAAS,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,aAAa,EAAE,MAAM,CAAA;IACrB,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,GAAG;IAAE,GAAG,EAAE,mBAAmB,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAqBpD"}

package/dist/hooks/read-cache.js

@@ -0,0 +1,166 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EDIT_TOOLS = exports.READ_TOOLS = void 0;
+exports.extractReadFilePath = extractReadFilePath;
+exports.editedFilePath = editedFilePath;
+exports.hashContent = hashContent;
+exports.buildCacheHintText = buildCacheHintText;
+exports.planReadCacheHit = planReadCacheHit;
+exports.planBatchGuidance = planBatchGuidance;
+exports.buildBatchGuidance = buildBatchGuidance;
+exports.buildReadCacheSeed = buildReadCacheSeed;
+const crypto_1 = require("crypto");
+const reduction_1 = require("./reduction");
+// =============================================
+// Read 再読込キャッシュ + 連続Read検知 (Issue #110 / Epic #91 R1.5) — 純粋ロジック
+// =============================================
+//
+// ① 同一 file_path の 2 回目以降の Read を、内容ハッシュで前回と同一判定し、
+//    全文の代わりに「前回と同一・ref_id」のキャッシュヒントに差し替える。
+//    内容は既にセッション履歴 (コンテキスト) に居るため、再掲を省くのは純粋削減
+//    (pk_fetch の取り戻し相殺がかからない) — レポート上限値割引の対象外。
+// ③ 連続 Read を検知し pk_execute での一括読みへ誘導する (ガイダンス注入)。
+//
+// 不変条件: ハッシュ・退避 body は **マスク後テキスト** を対象にする (生 PII を残さない)。
+// I/O (SQLite・stdout) は cli/hook.ts が担い、本モジュールは判断のみ。
+/** Read 系ツール (出力の退避・キャッシュ対象)。 */
+exports.READ_TOOLS = new Set(['Read', 'NotebookRead']);
+/** 編集系ツール (キャッシュ無効化のトリガ)。snapshot.ts:EDIT_TOOLS と同一集合。 */
+exports.EDIT_TOOLS = new Set(['Edit', 'Write', 'MultiEdit', 'NotebookEdit']);
+function toolInput(input) {
+    const ti = input.tool_input;
+    return ti && typeof ti === 'object' ? ti : {};
+}
+/** Read/NotebookRead の対象ファイルパスを返す (それ以外・パス不明は null)。 */
+function extractReadFilePath(input) {
+    if (typeof input.tool_name !== 'string' || !exports.READ_TOOLS.has(input.tool_name))
+        return null;
+    const ti = toolInput(input);
+    const fp = ti.file_path ?? ti.notebook_path;
+    return typeof fp === 'string' && fp.length > 0 ? fp : null;
+}
+/** Edit/Write 系の対象ファイルパスを返す (それ以外・パス不明は null)。 */
+function editedFilePath(input) {
+    if (typeof input.tool_name !== 'string' || !exports.EDIT_TOOLS.has(input.tool_name))
+        return null;
+    const ti = toolInput(input);
+    const fp = ti.file_path;
+    return typeof fp === 'string' && fp.length > 0 ? fp : null;
+}
+/** マスク後テキストの内容ハッシュ (再読込同一判定キー)。 */
+function hashContent(maskedText) {
+    return (0, crypto_1.createHash)('sha256').update(maskedText, 'utf8').digest('hex');
+}
+/** キャッシュヒントの差し替えテキストを組み立てる。 */
+function buildCacheHintText(p) {
+    return [
+        `[PromptKaizen R1.5] ${p.filePath} はこのセッションで前回読み込んだ内容と同一です (約 ${p.originalTokens.toLocaleString()} tokens)。`,
+        `再掲を省略しました。内容は会話履歴に既にあります。`,
+        `全文を再取得する場合: pk_fetch(ref_id: "${p.refId}")`,
+    ].join('\n');
+}
+/**
+ * 再読込キャッシュヒットか判定する。ヒット条件:
+ *   前回ハッシュと一致 / 無効化されていない / 前回 ref_id がある / 削減になる。
+ * いずれか欠ければ null (= ミス。呼び出し側は全文を通し、退避 + キャッシュ seed する)。
+ * 副作用なし。
+ */
+function planReadCacheHit(p) {
+    const filePath = extractReadFilePath(p.input);
+    if (!filePath)
+        return null;
+    if (p.invalidated || !p.prevHash || !p.prevRefId)
+        return null;
+    if (hashContent(p.maskedContent) !== p.prevHash)
+        return null;
+    const originalTokens = (0, reduction_1.estimateTokensFromText)(p.maskedContent);
+    const hint = buildCacheHintText({ filePath, refId: p.prevRefId, originalTokens });
+    const replacedTokens = (0, reduction_1.estimateTokensFromText)(hint);
+    const savedTokens = originalTokens - replacedTokens;
+    if (savedTokens <= 0)
+        return null;
+    const extracted = (0, reduction_1.extractToolResponse)(p.input);
+    if (!extracted)
+        return null;
+    return {
+        updatedToolOutput: extracted.wrap(hint),
+        meta: { kind: 'cache_hit', refId: p.prevRefId, originalTokens, replacedTokens, savedTokens },
+    };
+}
+/**
+ * ③ 連続 Read 集約誘導 (#110)。transcript tail (JSONL) の末尾から連続する
+ * Read tool_use を数え、しきい値を「今ちょうど跨いだ」ときだけ advise=true を返す
+ * (跨いだ瞬間に 1 度だけ誘導を出し、以降の連続 Read では出さない)。
+ * 非 Read の tool_use が現れた時点で連続は途切れる。副作用なし。
+ */
+function planBatchGuidance(transcriptTail, threshold) {
+    const lines = transcriptTail.split('\n');
+    let total = 0;
+    let lastTurnReads = 0;
+    let turnsSeen = 0;
+    for (let i = lines.length - 1; i >= 0; i--) {
+        const line = lines[i].trim();
+        if (!line)
+            continue;
+        let d;
+        try {
+            d = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        if (d.type !== 'assistant')
+            continue;
+        const content = d.message?.content;
+        if (!Array.isArray(content))
+            continue;
+        const toolUses = content.filter((b) => !!b && typeof b === 'object' && b.type === 'tool_use');
+        if (toolUses.length === 0)
+            continue; // text のみのターンは連続を途切れさせない
+        const allRead = toolUses.every((b) => typeof b.name === 'string' && exports.READ_TOOLS.has(b.name));
+        if (!allRead)
+            break;
+        total += toolUses.length;
+        if (turnsSeen === 0)
+            lastTurnReads = toolUses.length;
+        turnsSeen++;
+    }
+    const prev = total - lastTurnReads;
+    return { advise: prev < threshold && total >= threshold, count: total };
+}
+/** 連続 Read 誘導の additionalContext テキスト。 */
+function buildBatchGuidance(count) {
+    return [
+        `[PromptKaizen R1.5] 直近 ${count} 連続で個別の Read を実行しています。`,
+        `複数ファイルをまとめて読むと、ツール往復とコンテキスト消費を削減できます。`,
+        `pk_execute での一括読み込み (例: 必要ファイルを 1 スクリプトでまとめて出力) を検討してください。`,
+    ].join('\n');
+}
+/**
+ * キャッシュミス時に保存する退避レコードを組み立てる (全文 body をマスク後で保持)。
+ * 退避は Read 全文 (サイズ問わず) を対象にし、次回の再読込をキャッシュヒットにできるようにする。
+ * 呼び出し側が LocalStore.recordToolOutputRef + upsertReadCache で保存する。
+ */
+function buildReadCacheSeed(p) {
+    const refId = p.refId ?? (0, reduction_1.generateRefId)();
+    const tokens = (0, reduction_1.estimateTokensFromText)(p.maskedContent);
+    return {
+        contentHash: hashContent(p.maskedContent),
+        ref: {
+            refId,
+            sessionId: typeof p.input.session_id === 'string' ? p.input.session_id : null,
+            toolName: typeof p.input.tool_name === 'string' ? p.input.tool_name : null,
+            cwd: typeof p.input.cwd === 'string' ? p.input.cwd : null,
+            createdAt: p.now,
+            originalBytes: Buffer.byteLength(p.maskedContent, 'utf8'),
+            originalTokens: tokens,
+            replacedTokens: tokens, // seed 時点では差し替えていない (削減は cache_hit/offload 側で計上)
+            savedTokens: 0,
+            body: p.maskedContent,
+            filePath: p.filePath,
+            contentHash: hashContent(p.maskedContent),
+            kind: 'offload',
+        },
+    };
+}
+//# sourceMappingURL=read-cache.js.map

package/dist/hooks/read-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-cache.js","sourceRoot":"","sources":["../../src/hooks/read-cache.ts"],"names":[],"mappings":"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"}

package/dist/hooks/reduction.d.ts

@@ -0,0 +1,78 @@
+import type { HookInput } from './claude-hook';
+import type { StoredToolOutputRef } from '../store/local-store';
+/** ParsedEntry.reduction / cloud 送信に載せる削減実績メタ (#92 actualSavings 互換)。 */
+export interface ReductionMeta {
+    /**
+     * #92 ReductionEvent.kind と同値。
+     * R1=退避(r1_offload) / R2=サンドボックス実行 / R3=復元 /
+     * R1.5 Read 特化 (#110): cache_hit=再読込キャッシュ / batch=連続Read集約誘導。
+     */
+    kind: 'r1_offload' | 'r2_execute' | 'r3_recall' | 'cache_hit' | 'batch';
+    refId: string;
+    /** 退避前のツール出力の推定トークン (マスク後本文基準)。 */
+    originalTokens: number;
+    /** 差し替え後テキストの推定トークン。 */
+    replacedTokens: number;
+    /** 実際に削減したトークン (original - replaced)。 */
+    savedTokens: number;
+}
+export interface ReductionOutcome {
+    /**
+     * Claude Code に返す差し替え値 (hookSpecificOutput.updatedToolOutput)。
+     * 元の tool_response と同じ shape (string ならば string、{stdout,...} ならば
+     * stdout だけ差し替えた object)。shape が一致しないと Claude Code 側で
+     * 黙って棄却される (2.1.176 実機確認)。
+     */
+    updatedToolOutput: unknown;
+    /** 退避レコード (呼び出し側が LocalStore.recordToolOutputRef で保存する)。 */
+    ref: StoredToolOutputRef;
+    meta: ReductionMeta;
+}
+/**
+ * 文字数からのトークン概算 (英数 4 文字 / 非 ASCII 1 文字 ≒ 1 token)。
+ * extension/src/core/stream-parser.ts・functions/src/org/orgSavings.ts と同一式。
+ * agent は @promptkaizen/shared を runtime 依存に持たないためここに移植。
+ */
+export declare function estimateTokensFromText(text: string): number;
+/** tool_response からの抽出結果。wrap は差し替えテキストを元の shape に包み直す。 */
+export interface ExtractedToolResponse {
+    text: string;
+    wrap: (replacement: string) => unknown;
+}
+/**
+ * PostToolUse の tool_response から退避対象テキストを取り出す。
+ * Claude Code は updatedToolOutput を元のツール出力と同じ shape か検証し、
+ * 不一致なら適用せず原文を通す (2.1.176 実機確認 — #93 dogfooding)。そのため
+ * - string はそのまま差し替え
+ * - Bash 等の { stdout: string, ... } は stdout のみ退避し、他フィールドを
+ *   保持したまま同じ object 形に包み直す
+ * - shape 不明な object は無介入 (差し替えても棄却されるだけのため)
+ */
+export declare function extractToolResponse(input: HookInput): ExtractedToolResponse | null;
+/** 参照ID (置換テキストと SQLite を突き合わせるキー)。 */
+export declare function generateRefId(): string;
+/** 差し替えテキストを組み立てる。previewText はマスク済みであること。 */
+export declare function buildReplacementText(p: {
+    refId: string;
+    originalTokens: number;
+    originalBytes: number;
+    totalLines: number;
+    previewText: string;
+}): string;
+export interface PlanReductionInput {
+    input: HookInput;
+    /** マスキング前置パイプライン。退避 body・プレビューは必ずこれを通す。 */
+    maskText: (text: string) => string;
+    thresholdBytes: number;
+    headChars: number;
+    now?: string;
+    /** テスト注入用。省略時は generateRefId()。 */
+    refId?: string;
+}
+/**
+ * 退避すべきか判定し、退避レコード + 差し替えテキスト + 削減メタを組み立てる。
+ * 閾値未満・テキスト不在・削減にならない場合は null (完全に無介入)。
+ * 副作用なし — SQLite への保存と stdout 出力は呼び出し側が行う。
+ */
+export declare function planReduction(p: PlanReductionInput): ReductionOutcome | null;
+//# sourceMappingURL=reduction.d.ts.map

package/dist/hooks/reduction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reduction.d.ts","sourceRoot":"","sources":["../../src/hooks/reduction.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAiB/D,yEAAyE;AACzE,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,IAAI,EAAE,YAAY,GAAG,YAAY,GAAG,WAAW,GAAG,WAAW,GAAG,OAAO,CAAA;IACvE,KAAK,EAAE,MAAM,CAAA;IACb,mCAAmC;IACnC,cAAc,EAAE,MAAM,CAAA;IACtB,wBAAwB;IACxB,cAAc,EAAE,MAAM,CAAA;IACtB,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,iBAAiB,EAAE,OAAO,CAAA;IAC1B,4DAA4D;IAC5D,GAAG,EAAE,mBAAmB,CAAA;IACxB,IAAI,EAAE,aAAa,CAAA;CACpB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAS3D;AAED,2DAA2D;AAC3D,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAA;CACvC;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,GAAG,qBAAqB,GAAG,IAAI,CAQlF;AAED,uCAAuC;AACvC,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,8CAA8C;AAC9C,wBAAgB,oBAAoB,CAAC,CAAC,EAAE;IACtC,KAAK,EAAE,MAAM,CAAA;IACb,cAAc,EAAE,MAAM,CAAA;IACtB,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;CACpB,GAAG,MAAM,CAYT;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,SAAS,CAAA;IAChB,2CAA2C;IAC3C,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;IAClC,cAAc,EAAE,MAAM,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;IACjB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,kBAAkB,GAAG,gBAAgB,GAAG,IAAI,CAyC5E"}

package/dist/hooks/reduction.js

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.estimateTokensFromText = estimateTokensFromText;
+exports.extractToolResponse = extractToolResponse;
+exports.generateRefId = generateRefId;
+exports.buildReplacementText = buildReplacementText;
+exports.planReduction = planReduction;
+const crypto_1 = require("crypto");
+/**
+ * 文字数からのトークン概算 (英数 4 文字 / 非 ASCII 1 文字 ≒ 1 token)。
+ * extension/src/core/stream-parser.ts・functions/src/org/orgSavings.ts と同一式。
+ * agent は @promptkaizen/shared を runtime 依存に持たないためここに移植。
+ */
+function estimateTokensFromText(text) {
+    if (!text)
+        return 0;
+    let ascii = 0;
+    let nonAscii = 0;
+    for (const ch of text) {
+        if (ch.codePointAt(0) < 128)
+            ascii++;
+        else
+            nonAscii++;
+    }
+    return Math.ceil(ascii / 4 + nonAscii);
+}
+/**
+ * PostToolUse の tool_response から退避対象テキストを取り出す。
+ * Claude Code は updatedToolOutput を元のツール出力と同じ shape か検証し、
+ * 不一致なら適用せず原文を通す (2.1.176 実機確認 — #93 dogfooding)。そのため
+ * - string はそのまま差し替え
+ * - Bash 等の { stdout: string, ... } は stdout のみ退避し、他フィールドを
+ *   保持したまま同じ object 形に包み直す
+ * - shape 不明な object は無介入 (差し替えても棄却されるだけのため)
+ */
+function extractToolResponse(input) {
+    const v = input.tool_response;
+    if (typeof v === 'string')
+        return { text: v, wrap: (r) => r };
+    if (v && typeof v === 'object' && typeof v.stdout === 'string') {
+        const obj = v;
+        return { text: obj.stdout, wrap: (r) => ({ ...obj, stdout: r }) };
+    }
+    return null;
+}
+/** 参照ID (置換テキストと SQLite を突き合わせるキー)。 */
+function generateRefId() {
+    return `pk-${(0, crypto_1.randomBytes)(6).toString('hex')}`;
+}
+/** 差し替えテキストを組み立てる。previewText はマスク済みであること。 */
+function buildReplacementText(p) {
+    const kb = (p.originalBytes / 1024).toFixed(1);
+    return [
+        `[PromptKaizen R1] このツール出力 (約 ${p.originalTokens.toLocaleString()} tokens / ${kb} KB / ${p.totalLines} 行) は閾値超過のためローカルへ退避されました。`,
+        `ref_id: ${p.refId}`,
+        `取り出し方法: MCP ツール pk_fetch を使用してください。`,
+        `  - 全文: pk_fetch(ref_id: "${p.refId}")`,
+        `  - 絞り込み (推奨): pk_fetch(ref_id: "${p.refId}", query: "検索語") — 該当行と前後の文脈を返します`,
+        `--- 先頭プレビュー (マスク済み) ---`,
+        p.previewText,
+        `--- プレビューここまで ---`,
+    ].join('\n');
+}
+/**
+ * 退避すべきか判定し、退避レコード + 差し替えテキスト + 削減メタを組み立てる。
+ * 閾値未満・テキスト不在・削減にならない場合は null (完全に無介入)。
+ * 副作用なし — SQLite への保存と stdout 出力は呼び出し側が行う。
+ */
+function planReduction(p) {
+    const extracted = extractToolResponse(p.input);
+    if (!extracted || !extracted.text)
+        return null;
+    const text = extracted.text;
+    // 閾値判定は生テキストのバイト長 (マスクは超過時のみ実行してコストを抑える)。
+    if (Buffer.byteLength(text, 'utf8') <= p.thresholdBytes)
+        return null;
+    const masked = p.maskText(text);
+    const originalBytes = Buffer.byteLength(masked, 'utf8');
+    const originalTokens = estimateTokensFromText(masked);
+    const refId = p.refId ?? generateRefId();
+    const now = p.now ?? new Date().toISOString();
+    const replacementText = buildReplacementText({
+        refId,
+        originalTokens,
+        originalBytes,
+        totalLines: masked.split('\n').length,
+        previewText: masked.slice(0, p.headChars),
+    });
+    const replacedTokens = estimateTokensFromText(replacementText);
+    const savedTokens = originalTokens - replacedTokens;
+    // 差し替えで削減にならないなら介入しない (閾値が極端に小さい場合の保険)。
+    if (savedTokens <= 0)
+        return null;
+    return {
+        updatedToolOutput: extracted.wrap(replacementText),
+        ref: {
+            refId,
+            sessionId: typeof p.input.session_id === 'string' ? p.input.session_id : null,
+            toolName: typeof p.input.tool_name === 'string' ? p.input.tool_name : null,
+            cwd: typeof p.input.cwd === 'string' ? p.input.cwd : null,
+            createdAt: now,
+            originalBytes,
+            originalTokens,
+            replacedTokens,
+            savedTokens,
+            body: masked,
+        },
+        meta: { kind: 'r1_offload', refId, originalTokens, replacedTokens, savedTokens },
+    };
+}
+//# sourceMappingURL=reduction.js.map

package/dist/hooks/reduction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reduction.js","sourceRoot":"","sources":["../../src/hooks/reduction.ts"],"names":[],"mappings":"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"}

package/dist/hooks/settings-merge.d.ts

@@ -0,0 +1,32 @@
+import type { HookRegistration } from './platforms';
+/** PromptKaizen hook command の既定識別子 (Claude Code、後方互換)。 */
+export declare const HOOK_COMMAND_MARKER = "promptkaizen-agent hook claude-code";
+/** 既定の登録 (Claude Code)。PreToolUse/PostToolUse は Bash 等のツール実行に限定。 */
+export declare const HOOK_REGISTRATIONS: HookRegistration[];
+interface HookCommand {
+    type: 'command';
+    command: string;
+    timeout?: number;
+}
+interface HookMatcherGroup {
+    matcher?: string;
+    hooks: HookCommand[];
+}
+interface Settings {
+    hooks?: Record<string, HookMatcherGroup[]>;
+    [k: string]: unknown;
+}
+/**
+ * settings に PromptKaizen の hooks をマージする (既存は保持)。
+ * 同一イベントに当社 hook が既にあれば command/matcher を最新に更新し重複を作らない。
+ */
+export declare function mergeHooks(settings: Settings, registrations?: HookRegistration[], marker?: string): Settings;
+/**
+ * settings から PromptKaizen の hooks のみ除去する (他の hooks は保持)。
+ * 当社 hook を除いた結果 matcher group が空になったイベントキーは削除する。
+ */
+export declare function removeHooks(settings: Settings, marker?: string): Settings;
+/** settings に当社 hook が登録済みか。 */
+export declare function hasOurHooks(settings: Settings, marker?: string): boolean;
+export {};
+//# sourceMappingURL=settings-merge.d.ts.map

package/dist/hooks/settings-merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-merge.d.ts","sourceRoot":"","sources":["../../src/hooks/settings-merge.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAEnD,2DAA2D;AAC3D,eAAO,MAAM,mBAAmB,wCAAwC,CAAA;AAExE,oEAAoE;AACpE,eAAO,MAAM,kBAAkB,EAAE,gBAAgB,EAMhD,CAAA;AAED,UAAU,WAAW;IACnB,IAAI,EAAE,SAAS,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AACD,UAAU,gBAAgB;IACxB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,WAAW,EAAE,CAAA;CACrB;AACD,UAAU,QAAQ;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAA;IAC1C,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CACrB;AAMD;;;GAGG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,QAAQ,EAClB,aAAa,GAAE,gBAAgB,EAAuB,EACtD,MAAM,GAAE,MAA4B,GACnC,QAAQ,CAeV;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAE,MAA4B,GAAG,QAAQ,CAW9F;AAED,gCAAgC;AAChC,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAE,MAA4B,GAAG,OAAO,CAE7F"}

package/dist/hooks/settings-merge.js

@@ -0,0 +1,74 @@
+"use strict";
+// =============================================
+// settings/hooks.json への hooks 登録/解除 (Issue #67 Claude / #70 Codex) — 純粋ロジック
+// =============================================
+//
+// Claude Code (~/.claude/settings.json) と Codex CLI (~/.codex/hooks.json) は同構造で、
+// hooks をイベント名ごとの配列で持つ:
+//   { "hooks": { "PreToolUse": [ { "matcher": "Bash", "hooks": [ {type,command} ] } ] } }
+//
+// ファイル I/O から切り離した純粋関数で既存設定を壊さずにマージ/除去する (テスト容易性)。
+// PromptKaizen の hook は command に固定マーカー (commandMarker) を持たせ、解除時はその
+// マーカーを含む entry だけを取り除く (他の hooks を破壊しない)。プラットフォーム差は
+// marker / registrations を引数で渡すことで吸収する (既定は Claude Code、後方互換)。
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HOOK_REGISTRATIONS = exports.HOOK_COMMAND_MARKER = void 0;
+exports.mergeHooks = mergeHooks;
+exports.removeHooks = removeHooks;
+exports.hasOurHooks = hasOurHooks;
+/** PromptKaizen hook command の既定識別子 (Claude Code、後方互換)。 */
+exports.HOOK_COMMAND_MARKER = 'promptkaizen-agent hook claude-code';
+/** 既定の登録 (Claude Code)。PreToolUse/PostToolUse は Bash 等のツール実行に限定。 */
+exports.HOOK_REGISTRATIONS = [
+    { event: 'PreToolUse', matcher: 'Bash|Write|Edit|MultiEdit|NotebookEdit|Read|NotebookRead' },
+    { event: 'PostToolUse', matcher: 'Bash|Write|Edit|MultiEdit|NotebookEdit|Read|NotebookRead' },
+    { event: 'UserPromptSubmit' },
+    { event: 'SessionStart' },
+    { event: 'PreCompact' },
+];
+function isOurGroup(group, marker) {
+    return group.hooks?.some((h) => typeof h.command === 'string' && h.command.includes(marker));
+}
+/**
+ * settings に PromptKaizen の hooks をマージする (既存は保持)。
+ * 同一イベントに当社 hook が既にあれば command/matcher を最新に更新し重複を作らない。
+ */
+function mergeHooks(settings, registrations = exports.HOOK_REGISTRATIONS, marker = exports.HOOK_COMMAND_MARKER) {
+    const next = { ...settings };
+    const hooks = { ...(settings.hooks ?? {}) };
+    for (const reg of registrations) {
+        const existing = (hooks[reg.event] ?? []).filter((g) => !isOurGroup(g, marker)); // 当社分は一旦除去
+        const ourGroup = {
+            ...(reg.matcher ? { matcher: reg.matcher } : {}),
+            hooks: [{ type: 'command', command: `${marker} ${reg.event}`, timeout: 10 }],
+        };
+        hooks[reg.event] = [...existing, ourGroup];
+    }
+    next.hooks = hooks;
+    return next;
+}
+/**
+ * settings から PromptKaizen の hooks のみ除去する (他の hooks は保持)。
+ * 当社 hook を除いた結果 matcher group が空になったイベントキーは削除する。
+ */
+function removeHooks(settings, marker = exports.HOOK_COMMAND_MARKER) {
+    const next = { ...settings };
+    if (!settings.hooks)
+        return next;
+    const hooks = {};
+    for (const [event, groups] of Object.entries(settings.hooks)) {
+        const kept = (groups ?? []).filter((g) => !isOurGroup(g, marker));
+        if (kept.length > 0)
+            hooks[event] = kept;
+    }
+    if (Object.keys(hooks).length > 0)
+        next.hooks = hooks;
+    else
+        delete next.hooks;
+    return next;
+}
+/** settings に当社 hook が登録済みか。 */
+function hasOurHooks(settings, marker = exports.HOOK_COMMAND_MARKER) {
+    return Object.values(settings.hooks ?? {}).some((groups) => groups.some((g) => isOurGroup(g, marker)));
+}
+//# sourceMappingURL=settings-merge.js.map

package/dist/hooks/settings-merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-merge.js","sourceRoot":"","sources":["../../src/hooks/settings-merge.ts"],"names":[],"mappings":"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"}