promptkaizen-agent 0.2.0 → 0.3.0

package/dist/mcp/server.js

@@ -0,0 +1,240 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_RECALL_CHARS = exports.PK_RECALL_TOOL = exports.PK_EXECUTE_TOOL = exports.PK_FETCH_TOOL = exports.MAX_FULL_TEXT_CHARS = exports.SERVER_INFO = exports.PROTOCOL_VERSION = void 0;
+exports.runPkFetch = runPkFetch;
+exports.runPkRecall = runPkRecall;
+exports.dispatchRpc = dispatchRpc;
+const version_1 = require("../version");
+// =============================================
+// ローカル MCP サーバー — pk_fetch (#93 R1) / pk_execute (#94 R2)
+// =============================================
+//
+// stdio transport (1 行 1 JSON-RPC メッセージ) の最小実装で、
+// functions/src/mcp/protocol.ts (リモート MCP #71) と同じ部分集合を話す:
+//   initialize / notifications/* / ping / tools/list / tools/call
+// MCP SDK は導入しない (#71 と同方針: 依存を増やさずステートレス部分集合で足りる)。
+//
+// - pk_fetch:   R1 が退避したツール出力 (tool_output_refs) の取得 (マスク済み本文のみ)
+// - pk_execute: サンドボックス実行 (R2)。生データをコンテキストに入れず結果だけ返す
+//
+// セットアップ: docs/local-mcp-setup.md (claude mcp add / Codex config.toml)
+exports.PROTOCOL_VERSION = '2024-11-05';
+exports.SERVER_INFO = { name: 'promptkaizen-local', version: version_1.AGENT_VERSION };
+/** 全文取得時の上限文字数。超過分は切り詰めて query 絞り込みを促す。 */
+exports.MAX_FULL_TEXT_CHARS = 80_000;
+const ERR_INVALID_REQUEST = -32600;
+const ERR_METHOD_NOT_FOUND = -32601;
+const ERR_INVALID_PARAMS = -32602;
+const ERR_INTERNAL = -32603;
+function ok(id, result) {
+    return { jsonrpc: '2.0', id: id ?? null, result };
+}
+function err(id, code, message) {
+    return { jsonrpc: '2.0', id: id ?? null, error: { code, message } };
+}
+exports.PK_FETCH_TOOL = {
+    name: 'pk_fetch',
+    description: 'PromptKaizen が退避したツール出力を参照IDで取得する。' +
+        'query を指定すると該当行と前後の文脈だけを返す (大きな出力にはこちらを推奨)。' +
+        'ツール結果に「ref_id: pk-...」と表示されている場合に使用する。',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            ref_id: {
+                type: 'string',
+                description: '退避時にツール結果へ埋め込まれた参照ID (例: pk-1a2b3c4d5e6f)',
+            },
+            query: {
+                type: 'string',
+                description: '絞り込み検索語 (省略時は全文を返す)',
+            },
+        },
+        required: ['ref_id'],
+    },
+};
+/** pk_fetch の本体。store は呼び出しごとに開いた LocalStore を渡す。 */
+function runPkFetch(store, args) {
+    const refId = typeof args.ref_id === 'string' ? args.ref_id.trim() : '';
+    const query = typeof args.query === 'string' ? args.query.trim() : '';
+    if (!refId) {
+        return { content: [{ type: 'text', text: 'ref_id は必須です (例: pk-1a2b3c4d5e6f)' }], isError: true };
+    }
+    if (!query) {
+        const ref = store.getToolOutputRef(refId);
+        if (!ref) {
+            return {
+                content: [{ type: 'text', text: `ref_id ${refId} は見つかりません (期限切れ・別端末の可能性)` }],
+                isError: true,
+            };
+        }
+        let text = ref.body;
+        if (text.length > exports.MAX_FULL_TEXT_CHARS) {
+            text =
+                text.slice(0, exports.MAX_FULL_TEXT_CHARS) +
+                    `\n--- 出力が大きいため ${exports.MAX_FULL_TEXT_CHARS.toLocaleString()} 文字で切り詰めました。` +
+                    `query 引数で絞り込んでください ---`;
+        }
+        return { content: [{ type: 'text', text }] };
+    }
+    const result = store.queryToolOutputRef(refId, query);
+    if (!result) {
+        return {
+            content: [{ type: 'text', text: `ref_id ${refId} は見つかりません (期限切れ・別端末の可能性)` }],
+            isError: true,
+        };
+    }
+    if (result.totalMatches === 0 || result.excerpts.length === 0) {
+        return { content: [{ type: 'text', text: `"${query}" に一致する行はありませんでした` }] };
+    }
+    const header = `"${query}" に ${result.totalMatches} 行が一致 (先頭 ${result.excerpts.length} 件を行番号付きで表示):\n\n`;
+    return { content: [{ type: 'text', text: header + result.excerpts.join('\n---\n') }] };
+}
+exports.PK_EXECUTE_TOOL = {
+    name: 'pk_execute',
+    description: 'コードをローカルのサンドボックス制約付き (タイムアウト・プロジェクトルート固定・' +
+        '秘匿環境変数の遮断・組織ポリシー判定) で実行し stdout を返す。' +
+        '大きなファイル・ログ・APIレスポンスを処理する際は、cat 等で全文をコンテキストに' +
+        '読み込む代わりにこのツールでコードに処理させ、結果だけを受け取ること。',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            language: {
+                type: 'string',
+                enum: ['bash', 'node', 'python'],
+                description: '実行言語',
+            },
+            code: { type: 'string', description: '実行するコード' },
+            timeout: {
+                type: 'number',
+                description: 'タイムアウト秒 (省略時 30s、最大 300s)',
+            },
+        },
+        required: ['language', 'code'],
+    },
+};
+exports.PK_RECALL_TOOL = {
+    name: 'pk_recall',
+    description: '過去セッションの文脈 (会話・作業状態スナップショット) をローカル全文検索して必要な断片だけ返す。' +
+        'コンパクトやセッション再開で過去の作業内容が不明なとき、ファイルの再読込や再探索を行う前に' +
+        'まずこのツールで検索すること。日本語クエリ対応 (3 文字以上推奨)。',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            query: { type: 'string', description: '検索語 (日本語可)' },
+            scope: {
+                type: 'string',
+                enum: ['current_session', 'project', 'all'],
+                description: '検索範囲 (省略時 project = このプロジェクトの全セッション)',
+            },
+        },
+        required: ['query'],
+    },
+};
+/** pk_recall の応答上限 (復元目的の検索が逆にコンテキストを食わないように)。 */
+exports.MAX_RECALL_CHARS = 8_000;
+/** pk_recall 本体。マスク済みデータ (events / snapshots) のみが対象。 */
+function runPkRecall(store, args, projectRoot) {
+    const query = typeof args.query === 'string' ? args.query.trim() : '';
+    if (!query) {
+        return { content: [{ type: 'text', text: 'query は必須です' }], isError: true };
+    }
+    const scope = typeof args.scope === 'string' ? args.scope : 'project';
+    let sessionId;
+    let cwd;
+    if (scope === 'current_session') {
+        const sid = store.latestSessionIdForCwd(projectRoot);
+        if (!sid) {
+            return {
+                content: [{ type: 'text', text: 'このプロジェクトのセッションがまだ記録されていません (scope を project / all にして再試行できます)' }],
+            };
+        }
+        sessionId = sid;
+    }
+    else if (scope === 'project') {
+        cwd = projectRoot;
+    } // 'all' は無条件
+    const snapshots = store.searchSnapshots(query, { limit: 3, cwd });
+    const events = store.search(query, { limit: 10, sessionId, cwd });
+    if (snapshots.length === 0 && events.length === 0) {
+        return {
+            content: [
+                { type: 'text', text: `"${query}" に一致する過去文脈は見つかりませんでした (scope: ${scope})` },
+            ],
+        };
+    }
+    const parts = [];
+    if (snapshots.length > 0) {
+        parts.push('--- 作業状態スナップショット ---\n' +
+            snapshots
+                .map((s) => `[${s.createdAt} / session ${s.sessionId?.slice(0, 8) ?? '?'}]\n${s.summary}`)
+                .join('\n---\n'));
+    }
+    if (events.length > 0) {
+        parts.push('--- 会話・イベント (新しい順) ---\n' +
+            events
+                .map((e) => `[${e.ts ?? e.recordedAt} / ${e.type ?? '?'} / session ${e.sessionId?.slice(0, 8) ?? '?'}]\n` +
+                (e.body ?? '').slice(0, 600))
+                .join('\n---\n'));
+    }
+    let text = parts.join('\n\n');
+    if (text.length > exports.MAX_RECALL_CHARS) {
+        text = text.slice(0, exports.MAX_RECALL_CHARS) + '\n--- 上限により切り詰めました。query を絞ってください ---';
+    }
+    return { content: [{ type: 'text', text }] };
+}
+/** 1 件の JSON-RPC を処理する。通知 (id 無し) は null (応答しない)。 */
+async function dispatchRpc(req, deps) {
+    if (!req || req.jsonrpc !== '2.0' || typeof req.method !== 'string') {
+        return err(req?.id ?? null, ERR_INVALID_REQUEST, 'Invalid JSON-RPC request');
+    }
+    const isNotification = req.id === undefined || req.id === null;
+    switch (req.method) {
+        case 'initialize':
+            return ok(req.id, {
+                protocolVersion: exports.PROTOCOL_VERSION,
+                capabilities: { tools: { listChanged: false } },
+                serverInfo: exports.SERVER_INFO,
+            });
+        case 'notifications/initialized':
+        case 'notifications/cancelled':
+            return null;
+        case 'ping':
+            return ok(req.id, {});
+        case 'tools/list': {
+            const tools = [exports.PK_FETCH_TOOL, exports.PK_RECALL_TOOL];
+            if (deps.pkExecute)
+                tools.splice(1, 0, exports.PK_EXECUTE_TOOL);
+            return ok(req.id, { tools });
+        }
+        case 'tools/call': {
+            if (isNotification)
+                return null;
+            const name = req.params?.name;
+            const args = (req.params?.arguments ?? {});
+            if (typeof name !== 'string') {
+                return err(req.id, ERR_INVALID_PARAMS, 'tools/call requires params.name');
+            }
+            try {
+                if (name === exports.PK_FETCH_TOOL.name) {
+                    return ok(req.id, deps.withStore((store) => runPkFetch(store, args)));
+                }
+                if (name === exports.PK_RECALL_TOOL.name) {
+                    const root = deps.projectRoot ?? process.cwd();
+                    return ok(req.id, deps.withStore((store) => runPkRecall(store, args, root)));
+                }
+                if (name === exports.PK_EXECUTE_TOOL.name && deps.pkExecute) {
+                    return ok(req.id, await deps.pkExecute(args));
+                }
+                return err(req.id, ERR_METHOD_NOT_FOUND, `Unknown tool: ${name}`);
+            }
+            catch (e) {
+                return err(req.id, ERR_INTERNAL, e.message);
+            }
+        }
+        default:
+            if (isNotification)
+                return null;
+            return err(req.id, ERR_METHOD_NOT_FOUND, `Method not found: ${req.method}`);
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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

package/dist/onboarding-report.d.ts

@@ -0,0 +1,66 @@
+import type { EnvironmentDetection } from './env-detect';
+import type { ScanSummary } from './backfill/scanner';
+export interface OnboardingReport {
+    /** 実際にスキャンしたセッション数 (≒ filesScanned。1 jsonl = 1 セッション)。 */
+    sessionsAnalyzed: number;
+    /** 検出された履歴の総セッション数 (env-detect)。解析が頭打ちでも母数を示す。 */
+    sessionsTotal: number;
+    entriesScanned: number;
+    /** 🔴 秘密情報 (category=secret) の検知件数。 */
+    secret: number;
+    /** 🟡 機微情報 (category=pii / pii_jp) の検知件数。 */
+    sensitive: number;
+    /** 🟢 ポリシー (category=custom: 組織辞書) の検知件数。 */
+    policy: number;
+    /** 重大度別 (= ScanSummary.counts)。 */
+    severity: {
+        high: number;
+        medium: number;
+        low: number;
+    };
+    /** 秘密情報の露出があったセッション数 (filepath 単位)。 */
+    secretSessions: number;
+    /** セキュリティスコア 0–100 = 秘密露出のないセッション割合。 */
+    securityScore: number;
+    timedOut: boolean;
+    scanElapsedMs: number;
+    /** 'online' = クラウド連携あり (ダッシュボード可)。'local' = 完全ローカル。 */
+    mode: 'online' | 'local';
+    /** 詳細ダッシュボード URL (online のみ。local は null)。 */
+    dashboardUrl: string | null;
+}
+/** cloud functions エンドポイントからダッシュボード URL を導出する。online でなければ null。 */
+export declare function resolveDashboardUrl(apiEndpoint: string | undefined): string | null;
+/**
+ * バックフィル結果 + 環境検出から初回レポートを組み立てる。
+ * セキュリティスコア = 秘密情報の露出がないセッションの割合 (0 件解析時は 100)。
+ */
+export declare function buildOnboardingReport(summary: ScanSummary, env: EnvironmentDetection, opts: {
+    apiEndpoint?: string;
+}): OnboardingReport;
+export interface PostureVerdict {
+    level: 'clean' | 'attention' | 'action';
+    headline: string;
+    message: string;
+}
+/** レポートからポスチャー判定を導く。検出 0 件は「健全」を価値として提示する。 */
+export declare function postureVerdict(r: Pick<OnboardingReport, 'secret' | 'sensitive' | 'policy' | 'sessionsAnalyzed'>): PostureVerdict;
+/** ポスチャーに応じた推奨アクション (実行可能な次の一手)。 */
+export declare function recommendedActions(r: Pick<OnboardingReport, 'secret' | 'sensitive' | 'policy'>, platform?: NodeJS.Platform): string[];
+export interface DemoHit {
+    severity: 'high';
+    sessionLabel: string;
+    when: string;
+    ruleId: string;
+    maskedPreview: string;
+}
+/** デモ用のダミーヒット (マスク済みプレビューのみ。実在の値ではない)。 */
+export declare const DEMO_HIT: DemoHit;
+/**
+ * デモ用の代表的レポートを組み立てる (実スキャンしない)。
+ * 検知が「どう見えるか」を体感させるため、秘密 1 件を含む代表値を返す。
+ */
+export declare function buildDemoReport(opts?: {
+    apiEndpoint?: string;
+}): OnboardingReport;
+//# sourceMappingURL=onboarding-report.d.ts.map

package/dist/onboarding-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding-report.d.ts","sourceRoot":"","sources":["../src/onboarding-report.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAUrD,MAAM,WAAW,gBAAgB;IAC/B,0DAA0D;IAC1D,gBAAgB,EAAE,MAAM,CAAA;IACxB,kDAAkD;IAClD,aAAa,EAAE,MAAM,CAAA;IACrB,cAAc,EAAE,MAAM,CAAA;IACtB,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAA;IACd,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAA;IACjB,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAA;IACd,mCAAmC;IACnC,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;IACvD,uCAAuC;IACvC,cAAc,EAAE,MAAM,CAAA;IACtB,wCAAwC;IACxC,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,OAAO,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,uDAAuD;IACvD,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAA;IACxB,8CAA8C;IAC9C,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5B;AAED,oEAAoE;AACpE,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAelF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,WAAW,EACpB,GAAG,EAAE,oBAAoB,EACzB,IAAI,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7B,gBAAgB,CA2ClB;AASD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,OAAO,GAAG,WAAW,GAAG,QAAQ,CAAA;IACvC,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,8CAA8C;AAC9C,wBAAgB,cAAc,CAC5B,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,kBAAkB,CAAC,GAChF,cAAc,CAsBhB;AAED,oCAAoC;AACpC,wBAAgB,kBAAkB,CAChC,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC,EAC5D,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC3C,MAAM,EAAE,CAkBV;AAMD,MAAM,WAAW,OAAO;IACtB,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,aAAa,EAAE,MAAM,CAAA;CACtB;AAED,0CAA0C;AAC1C,eAAO,MAAM,QAAQ,EAAE,OAMtB,CAAA;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,gBAAgB,CAmBrF"}

package/dist/onboarding-report.js

@@ -0,0 +1,152 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEMO_HIT = void 0;
+exports.resolveDashboardUrl = resolveDashboardUrl;
+exports.buildOnboardingReport = buildOnboardingReport;
+exports.postureVerdict = postureVerdict;
+exports.recommendedActions = recommendedActions;
+exports.buildDemoReport = buildDemoReport;
+/** cloud functions エンドポイントからダッシュボード URL を導出する。online でなければ null。 */
+function resolveDashboardUrl(apiEndpoint) {
+    if (!apiEndpoint)
+        return null;
+    let host;
+    try {
+        host = new URL(apiEndpoint).host;
+    }
+    catch {
+        return null;
+    }
+    // 例: asia-northeast1-promptkaizen-stg.cloudfunctions.net → project = promptkaizen-stg
+    const m = host.match(/^[a-z0-9-]+-(promptkaizen[a-z0-9-]*)\.cloudfunctions\.net$/i);
+    const project = m?.[1];
+    if (!project)
+        return null;
+    // prod は独自ドメイン、それ以外は <project>.web.app。
+    if (project === 'promptkaizen-prod')
+        return 'https://promptkaizen.ai';
+    return `https://${project}.web.app`;
+}
+/**
+ * バックフィル結果 + 環境検出から初回レポートを組み立てる。
+ * セキュリティスコア = 秘密情報の露出がないセッションの割合 (0 件解析時は 100)。
+ */
+function buildOnboardingReport(summary, env, opts) {
+    let secret = 0;
+    let sensitive = 0;
+    let policy = 0;
+    const secretSessionKeys = new Set();
+    for (const hit of summary.hits) {
+        let hasSecret = false;
+        for (const d of hit.detections) {
+            if (d.category === 'secret') {
+                secret += d.count;
+                hasSecret = true;
+            }
+            else if (d.category === 'pii' || d.category === 'pii_jp') {
+                sensitive += d.count;
+            }
+            else if (d.category === 'custom') {
+                policy += d.count;
+            }
+        }
+        if (hasSecret)
+            secretSessionKeys.add(hit.filepath);
+    }
+    const sessionsAnalyzed = summary.filesScanned;
+    const secretSessions = secretSessionKeys.size;
+    const securityScore = sessionsAnalyzed > 0
+        ? Math.round(100 * (1 - secretSessions / sessionsAnalyzed))
+        : 100;
+    const dashboardUrl = resolveDashboardUrl(opts.apiEndpoint);
+    return {
+        sessionsAnalyzed,
+        sessionsTotal: env.tools.reduce((n, t) => n + t.sessions, 0),
+        entriesScanned: summary.entriesScanned,
+        secret,
+        sensitive,
+        policy,
+        severity: summary.counts,
+        secretSessions,
+        securityScore,
+        timedOut: summary.timedOut,
+        scanElapsedMs: summary.elapsedMs,
+        mode: dashboardUrl ? 'online' : 'local',
+        dashboardUrl,
+    };
+}
+/** レポートからポスチャー判定を導く。検出 0 件は「健全」を価値として提示する。 */
+function postureVerdict(r) {
+    if (r.secret > 0) {
+        return {
+            level: 'action',
+            headline: '🔴 要対応 — 秘密情報の露出が見つかりました',
+            message: '下記の推奨アクションで露出した秘密情報を無効化し、再発を防いでください。',
+        };
+    }
+    if (r.sensitive > 0 || r.policy > 0) {
+        return {
+            level: 'attention',
+            headline: '🟡 確認推奨 — 個人情報 / 組織ルール該当があります',
+            message: '露出はマスク済みで保存・送信されています。取り扱い範囲を確認してください。',
+        };
+    }
+    return {
+        level: 'clean',
+        headline: '✅ 異常なし（健全）',
+        message: `${r.sessionsAnalyzed.toLocaleString()} セッションを解析し、秘密情報・個人情報の露出は見つかりませんでした。` +
+            '「漏れていない」ことを確認できたこと自体が、ガバナンスの確かな成果です。',
+    };
+}
+/** ポスチャーに応じた推奨アクション (実行可能な次の一手)。 */
+function recommendedActions(r, platform = process.platform) {
+    const out = [];
+    if (r.secret > 0) {
+        out.push('🔴 露出した秘密情報はローテーション（再発行）してください。今後は環境変数 / シークレットマネージャ経由に。');
+        out.push('   `promptkaizen-agent install-hooks` で、秘密情報を含むツール実行を事前ブロックできます。');
+    }
+    if (r.sensitive > 0) {
+        out.push('🟡 個人情報・PII は保存・送信前にマスク済みです。共有範囲・保持方針を確認してください。');
+    }
+    if (r.policy > 0) {
+        out.push('🟢 組織ルール該当があります。ポリシー設定（ダッシュボード）で内容を確認してください。');
+    }
+    if (r.secret === 0 && r.sensitive === 0 && r.policy === 0) {
+        const installCmd = platform === 'linux' ? 'install-systemd' : platform === 'win32' ? 'install-task' : 'install-launchd';
+        out.push(`✅ 常駐監視を有効化すると、今後の貼り付けもリアルタイムで守れます: promptkaizen-agent ${installCmd}`);
+    }
+    return out;
+}
+/** デモ用のダミーヒット (マスク済みプレビューのみ。実在の値ではない)。 */
+exports.DEMO_HIT = {
+    severity: 'high',
+    sessionLabel: 'my-api-service · 3f9c1a2b',
+    when: '2026-06-10 14:23',
+    ruleId: 'anthropic_key',
+    maskedPreview: 'sk-a…Yx',
+};
+/**
+ * デモ用の代表的レポートを組み立てる (実スキャンしない)。
+ * 検知が「どう見えるか」を体感させるため、秘密 1 件を含む代表値を返す。
+ */
+function buildDemoReport(opts = {}) {
+    const sessionsAnalyzed = 12;
+    const secretSessions = 1;
+    const dashboardUrl = resolveDashboardUrl(opts.apiEndpoint);
+    return {
+        sessionsAnalyzed,
+        sessionsTotal: sessionsAnalyzed,
+        entriesScanned: 1843,
+        secret: 1,
+        sensitive: 3,
+        policy: 0,
+        severity: { high: 1, medium: 1, low: 2 },
+        secretSessions,
+        securityScore: Math.round(100 * (1 - secretSessions / sessionsAnalyzed)),
+        timedOut: false,
+        scanElapsedMs: 3200,
+        mode: dashboardUrl ? 'online' : 'local',
+        dashboardUrl,
+    };
+}
+//# sourceMappingURL=onboarding-report.js.map

package/dist/onboarding-report.js.map

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

package/dist/onboarding.d.ts

@@ -0,0 +1,55 @@
+export declare const DEFAULT_ONBOARDING_PATH: string;
+/** オンボーディング・ファネルのステージ (順序が離脱分析の軸)。 */
+export declare const ONBOARDING_STAGES: readonly ["init", "detect", "scan", "report", "enable"];
+export type OnboardingStage = (typeof ONBOARDING_STAGES)[number];
+/** 目標値 (#102 の PR 配信ゲート)。 */
+export declare const TTV_TARGET_MS = 120000;
+export declare const COMPLETION_TARGET_RATE = 0.8;
+/** レポート到達時に残す指標スナップショット (本文・生値は持たない)。 */
+export interface OnboardingReportSnapshot {
+    completedAt: string;
+    /** init からの経過 (ms)。init 起点が無ければ null。 */
+    ttvMs: number | null;
+    securityScore: number;
+    sessionsAnalyzed: number;
+    secret: number;
+    sensitive: number;
+    policy: number;
+    mode: 'online' | 'local';
+}
+interface StageRecord {
+    firstAt: string;
+    lastAt: string;
+    count: number;
+}
+export interface OnboardingState {
+    /** 現在の試行の init 開始時刻 (TTV 起点)。 */
+    startedAt: string | null;
+    /** 到達したステージごとの記録。 */
+    stages: Partial<Record<OnboardingStage, StageRecord>>;
+    /** 最新のレポート到達スナップショット (完走)。 */
+    report: OnboardingReportSnapshot | null;
+    agentVersion: string | null;
+    updatedAt: string;
+}
+export interface RecordStageOptions {
+    agentVersion?: string;
+    /** stage==='report' のとき残す指標 (ttvMs/completedAt はここで計算・付与)。 */
+    report?: Omit<OnboardingReportSnapshot, 'completedAt' | 'ttvMs'>;
+    /** テスト用の時計注入。 */
+    now?: () => Date;
+}
+/**
+ * ファネルのステージ到達を記録する (best-effort。失敗しても本処理は妨げない)。
+ * - init   : 新しい試行の起点。startedAt を now に設定し report をクリアする。
+ * - report : 指標スナップショットを残し、ttvMs = now - startedAt を計算する。
+ */
+export declare function recordStage(stage: OnboardingStage, opts?: RecordStageOptions, filePath?: string): Promise<void>;
+/** 計測ファイルを読む。無ければ null。 */
+export declare function readOnboardingState(filePath?: string): Promise<OnboardingState | null>;
+/** TTV (ms): レポート到達スナップショットに記録済みの値。未到達なら null。 */
+export declare function computeTtvMs(state: OnboardingState | null): number | null;
+/** このインストールがレポートに到達した (完走した) か。 */
+export declare function isCompleted(state: OnboardingState | null): boolean;
+export {};
+//# sourceMappingURL=onboarding.d.ts.map

package/dist/onboarding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding.d.ts","sourceRoot":"","sources":["../src/onboarding.ts"],"names":[],"mappings":"AAkBA,eAAO,MAAM,uBAAuB,QAA8D,CAAA;AAElG,sCAAsC;AACtC,eAAO,MAAM,iBAAiB,yDAA0D,CAAA;AACxF,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEhE,6BAA6B;AAC7B,eAAO,MAAM,aAAa,SAAU,CAAA;AACpC,eAAO,MAAM,sBAAsB,MAAM,CAAA;AAEzC,yCAAyC;AACzC,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAA;IACnB,yCAAyC;IACzC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;IACrB,gBAAgB,EAAE,MAAM,CAAA;IACxB,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAA;CACzB;AAED,UAAU,WAAW;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,iCAAiC;IACjC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,qBAAqB;IACrB,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,WAAW,CAAC,CAAC,CAAA;IACrD,8BAA8B;IAC9B,MAAM,EAAE,wBAAwB,GAAG,IAAI,CAAA;IACvC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,IAAI,CAAC,wBAAwB,EAAE,aAAa,GAAG,OAAO,CAAC,CAAA;IAChE,iBAAiB;IACjB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAA;CACjB;AAMD;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,eAAe,EACtB,IAAI,GAAE,kBAAuB,EAC7B,QAAQ,GAAE,MAAgC,GACzC,OAAO,CAAC,IAAI,CAAC,CAiCf;AAED,2BAA2B;AAC3B,wBAAsB,mBAAmB,CACvC,QAAQ,GAAE,MAAgC,GACzC,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAcjC;AAED,kDAAkD;AAClD,wBAAgB,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAEzE;AAED,mCAAmC;AACnC,wBAAgB,WAAW,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,GAAG,OAAO,CAElE"}

package/dist/onboarding.js

@@ -0,0 +1,98 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COMPLETION_TARGET_RATE = exports.TTV_TARGET_MS = exports.ONBOARDING_STAGES = exports.DEFAULT_ONBOARDING_PATH = void 0;
+exports.recordStage = recordStage;
+exports.readOnboardingState = readOnboardingState;
+exports.computeTtvMs = computeTtvMs;
+exports.isCompleted = isCompleted;
+const promises_1 = __importDefault(require("fs/promises"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+// =============================================
+// オンボーディング計測ファネル (Issue #106 完走記録 → #109 TTV/完走率)
+// =============================================
+//
+// PR 配信ゲート (#102/#49) の判定に使う 2 指標を計測する:
+//   - TTV   : init 開始 → 初回レポート表示 までの経過時間 (目標 120 秒)
+//   - 完走率: 初回起動 (init) → レポート到達 (report) の割合 (目標 80%)
+// さらにステージ別 (init/detect/scan/report/enable) の到達を記録し、離脱ポイントを特定する。
+//
+// プライバシー方針 (受け入れ条件): 計測は **このマシン内のローカル JSON に完結**し、
+// 自動送信はしない。生のプロンプトや検出値は持たず、件数・スコア・タイムスタンプのみ。
+// 将来クラウドへ集計送信する場合も、匿名化 (端末/ユーザーを特定しない集計値) の範囲を
+// 明示した上で同意制とする。詳細は agent/docs/onboarding-metrics.md。
+exports.DEFAULT_ONBOARDING_PATH = path_1.default.join(os_1.default.homedir(), '.promptkaizen', 'onboarding.json');
+/** オンボーディング・ファネルのステージ (順序が離脱分析の軸)。 */
+exports.ONBOARDING_STAGES = ['init', 'detect', 'scan', 'report', 'enable'];
+/** 目標値 (#102 の PR 配信ゲート)。 */
+exports.TTV_TARGET_MS = 120_000;
+exports.COMPLETION_TARGET_RATE = 0.8;
+function emptyState() {
+    return { startedAt: null, stages: {}, report: null, agentVersion: null, updatedAt: '' };
+}
+/**
+ * ファネルのステージ到達を記録する (best-effort。失敗しても本処理は妨げない)。
+ * - init   : 新しい試行の起点。startedAt を now に設定し report をクリアする。
+ * - report : 指標スナップショットを残し、ttvMs = now - startedAt を計算する。
+ */
+async function recordStage(stage, opts = {}, filePath = exports.DEFAULT_ONBOARDING_PATH) {
+    try {
+        const now = (opts.now?.() ?? new Date()).toISOString();
+        const state = (await readOnboardingState(filePath)) ?? emptyState();
+        if (stage === 'init') {
+            // 新しいオンボーディング試行の開始 → TTV 起点を更新し、前回の完走をクリア。
+            state.startedAt = now;
+            state.report = null;
+        }
+        const prev = state.stages[stage];
+        state.stages[stage] = {
+            firstAt: prev?.firstAt ?? now,
+            lastAt: now,
+            count: (prev?.count ?? 0) + 1,
+        };
+        if (stage === 'report' && opts.report) {
+            const ttvMs = state.startedAt
+                ? new Date(now).getTime() - new Date(state.startedAt).getTime()
+                : null;
+            state.report = { ...opts.report, completedAt: now, ttvMs: ttvMs !== null && ttvMs >= 0 ? ttvMs : null };
+        }
+        if (opts.agentVersion)
+            state.agentVersion = opts.agentVersion;
+        state.updatedAt = now;
+        await promises_1.default.mkdir(path_1.default.dirname(filePath), { recursive: true });
+        await promises_1.default.writeFile(filePath, JSON.stringify(state, null, 2), { mode: 0o600 });
+    }
+    catch {
+        // 計測記録は best-effort。
+    }
+}
+/** 計測ファイルを読む。無ければ null。 */
+async function readOnboardingState(filePath = exports.DEFAULT_ONBOARDING_PATH) {
+    try {
+        const parsed = JSON.parse(await promises_1.default.readFile(filePath, 'utf8'));
+        if (!parsed || typeof parsed !== 'object')
+            return null;
+        return {
+            startedAt: parsed.startedAt ?? null,
+            stages: parsed.stages ?? {},
+            report: parsed.report ?? null,
+            agentVersion: parsed.agentVersion ?? null,
+            updatedAt: parsed.updatedAt ?? '',
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/** TTV (ms): レポート到達スナップショットに記録済みの値。未到達なら null。 */
+function computeTtvMs(state) {
+    return state?.report?.ttvMs ?? null;
+}
+/** このインストールがレポートに到達した (完走した) か。 */
+function isCompleted(state) {
+    return Boolean(state?.report);
+}
+//# sourceMappingURL=onboarding.js.map