paput-mcp 4.2.29 → 4.2.41

package/dist/services/api/onboarding.js

@@ -0,0 +1,19 @@
+const ONBOARDING_STATUS_TIMEOUT_MS = 3_000;
+export async function getOnboardingStatus(client) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), ONBOARDING_STATUS_TIMEOUT_MS);
+    let status;
+    try {
+        status = await client.get('/api/v1/mcp/onboarding-status', { signal: controller.signal });
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+    if (!status ||
+        typeof status.memo_count !== 'number' ||
+        typeof status.has_skill_sheet !== 'boolean') {
+        throw new Error('Invalid onboarding status response format');
+    }
+    return status;
+}
+//# sourceMappingURL=onboarding.js.map

package/dist/services/api/onboarding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding.js","sourceRoot":"","sources":["../../../src/services/api/onboarding.ts"],"names":[],"mappings":"AAGA,MAAM,4BAA4B,GAAG,KAAK,CAAC;AAE3C,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAiB;IAEjB,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,OAAO,GAAG,UAAU,CACxB,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EACxB,4BAA4B,CAC7B,CAAC;IACF,IAAI,MAAwB,CAAC;IAE7B,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CACvB,+BAA+B,EAC/B,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAC9B,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC;IAED,IACE,CAAC,MAAM;QACP,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ;QACrC,OAAO,MAAM,CAAC,eAAe,KAAK,SAAS,EAC3C,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/services/onboarding-nudge.js

@@ -0,0 +1,85 @@
+import { getOnboardingStatus } from './api/index.js';
+const GRADUATED_TTL_MS = 24 * 60 * 60 * 1000;
+const PENDING_TTL_MS = 10 * 60 * 1000;
+const NUDGE_COOLDOWN_MS = 30 * 60 * 1000;
+// エントリが最後に更新されてからこの期間再アクセスがなければ、スイープで削除する
+// （トークンローテーション後の古いトークンや卒業済みユーザーが二度と来ないケースで無限増加しないように）。
+// 起こりうる最大 TTL（GRADUATED_TTL_MS）を下限に設定し、アクティブなエントリは巻き込まない。
+const STALE_ENTRY_TTL_MS = GRADUATED_TTL_MS;
+const SWEEP_INTERVAL_MS = 60 * 60 * 1000;
+// キャッシュインスタンスごとのスイープ実施時刻。WeakMap にすることでキャッシュ自体の
+// ガベージコレクションを妨げず、複数キャッシュインスタンス（テスト等）を混同しない。
+const lastSweepAt = new WeakMap();
+export function createOnboardingNudgeCache() {
+    return new Map();
+}
+export function invalidateOnboardingNudgeCache(cache, accessToken) {
+    const entry = cache.get(accessToken);
+    if (!entry)
+        return;
+    // エントリ全体を削除すると lastNudgeAt も失われ、書き込み直後にクールダウンが
+    // リセットされて毎回ナッジが再表示されてしまう。status だけを次回アクセス時に
+    // 再フェッチさせ、クールダウンの起点は保つ。
+    entry.forceRefetch = true;
+}
+function pruneStaleEntries(cache, now) {
+    const previousSweep = lastSweepAt.get(cache);
+    if (previousSweep !== undefined && now - previousSweep < SWEEP_INTERVAL_MS) {
+        return;
+    }
+    lastSweepAt.set(cache, now);
+    for (const [key, entry] of cache) {
+        if (now - entry.fetchedAt > STALE_ENTRY_TTL_MS) {
+            cache.delete(key);
+        }
+    }
+}
+export async function getOnboardingNudgeText(cache, accessToken, apiClient) {
+    const now = Date.now();
+    pruneStaleEntries(cache, now);
+    let entry = cache.get(accessToken);
+    if (!entry || entry.forceRefetch || isExpired(entry, now)) {
+        let status;
+        try {
+            status = await getOnboardingStatus(apiClient);
+        }
+        catch {
+            // status 取得失敗はナッジなしで通常応答を維持する（本処理を壊さない）。
+            return null;
+        }
+        entry = { status, fetchedAt: now, lastNudgeAt: entry?.lastNudgeAt };
+        cache.set(accessToken, entry);
+    }
+    if (isGraduated(entry.status)) {
+        return null;
+    }
+    if (entry.lastNudgeAt !== undefined && now - entry.lastNudgeAt < NUDGE_COOLDOWN_MS) {
+        return null;
+    }
+    entry.lastNudgeAt = now;
+    return buildNudgeText(entry.status);
+}
+function isGraduated(status) {
+    return status.memo_count > 0 && status.has_skill_sheet;
+}
+function isExpired(entry, now) {
+    const ttl = isGraduated(entry.status) ? GRADUATED_TTL_MS : PENDING_TTL_MS;
+    return now - entry.fetchedAt > ttl;
+}
+function buildNudgeText(status) {
+    if (status.memo_count === 0 && !status.has_skill_sheet) {
+        return ('This PaPut account has no memos and no skill sheet yet. You can help ' +
+            'the user set both up: capture reusable knowledge as memos, and build ' +
+            'a skill sheet outline (basic info, skills, projects). In Claude Code, ' +
+            'the /paput:onboarding skill can run this setup end to end.');
+    }
+    if (!status.has_skill_sheet) {
+        return ('This PaPut account has memos but no skill sheet yet. You can help the ' +
+            'user build a skill sheet outline (basic info, skills, projects). In ' +
+            'Claude Code, the /paput:onboarding skill can help with this.');
+    }
+    return ('This PaPut account has a skill sheet but no memos yet. You can help the ' +
+        'user capture reusable knowledge as memos. In Claude Code, the ' +
+        '/paput:onboarding skill can help with this.');
+}
+//# sourceMappingURL=onboarding-nudge.js.map

package/dist/services/onboarding-nudge.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "paput-mcp",
-  "version": "4.2.29",
+  "version": "4.2.41",
   "description": "PaPut MCP Server",
   "main": "dist/index.js",
   "type": "module",