paput-mcp 4.2.23 → 4.2.27

package/dist/tool.js

@@ -1,10 +1,11 @@
 import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
 import { createApiClient } from './services/api/index.js';
 import { getGeneratedInputSchema, getToolInputZodSchema, } from './schemas/tool-input.js';
-import { createMemosTool, searchMemoTool, findSimilarMemosTool, backfillMemoEmbeddingsTool, getMemoTool, updateMemoTool, getCategoriesTool, createNoteTool, searchNotesTool, getNoteTool, updateNoteTool, getSkillSheetTool, updateSkillSheetBasicInfoTool, updateSkillSheetSelfPrTool, setSkillSheetSkillsTool, upsertSkillSheetProjectTool, deleteSkillSheetProjectTool, getSkillSheetProjectEpisodesContextTool, updateSkillSheetProjectEpisodesTool, listGoalsTool, createGoalTool, updateGoalTool, deleteGoalTool, getDashboardAnalysisTool, updateDashboardAnalysisTool, getDashboardAnalysisContextTool, getProjectContextTool, getProjectDocumentTool, addProjectDocumentTool, updateProjectDocumentTool, updateProjectInstructionsTool, discardProjectProposalTool, promoteProjectDocumentsTool, addKnowledgeCandidatesTool, listProcessedSessionsTool, markProcessedSessionTool, listPendingCandidatesTool, updatePendingCandidateTool, savePendingCandidateTool, discardPendingCandidateTool, getCapturePolicyTool, getDiscardPolicyContextTool, updateCapturePolicyTool, } from './handlers/index.js';
+import { createMemosTool, searchMemoTool, findSimilarMemosTool, backfillMemoEmbeddingsTool, getMemoTool, updateMemoTool, getCategoriesTool, createNoteTool, searchNotesTool, getNoteTool, updateNoteTool, getSkillSheetTool, updateSkillSheetBasicInfoTool, updateSkillSheetSelfPrTool, setSkillSheetSkillsTool, upsertSkillSheetProjectTool, deleteSkillSheetProjectTool, getSkillSheetProjectEpisodesContextTool, updateSkillSheetProjectEpisodesTool, updateSkillSheetFaqTool, listGoalsTool, createGoalTool, updateGoalTool, deleteGoalTool, getDashboardAnalysisTool, updateDashboardAnalysisTool, getDashboardAnalysisContextTool, getProjectContextTool, getProjectDocumentTool, searchProjectDocumentsTool, addProjectDocumentTool, updateProjectDocumentTool, updateProjectInstructionsTool, discardProjectProposalTool, promoteProjectDocumentsTool, addKnowledgeCandidatesTool, listProcessedSessionsTool, markProcessedSessionTool, listPendingCandidatesTool, updatePendingCandidateTool, savePendingCandidateTool, discardPendingCandidateTool, getCapturePolicyTool, getDiscardPolicyContextTool, updateCapturePolicyTool, } from './handlers/index.js';
 export function setupTool(server, apiUrl, accessToken, context = {}, registeredToolsOptions = {}) {
     const apiClient = createApiClient(apiUrl, accessToken);
-    const projectContextConfigured = Boolean(context.projectId);
+    // alias は未解決のまま渡る（実在確認はツール呼び出し時）ので、設定の有無だけで判定する。
+    const projectContextConfigured = Boolean(context.projectId ?? context.projectAlias);
     const tools = getRegisteredTools({
         ...registeredToolsOptions,
         projectContextConfigured,
@@ -106,6 +107,7 @@ export function getRegisteredTools(options = {}) {
         deleteSkillSheetProjectTool,
         getSkillSheetProjectEpisodesContextTool,
         updateSkillSheetProjectEpisodesTool,
+        updateSkillSheetFaqTool,
         listGoalsTool,
         createGoalTool,
         updateGoalTool,
@@ -115,6 +117,7 @@ export function getRegisteredTools(options = {}) {
         getDashboardAnalysisContextTool,
         getProjectContextTool,
         getProjectDocumentTool,
+        searchProjectDocumentsTool,
         addProjectDocumentTool,
         updateProjectDocumentTool,
         updateProjectInstructionsTool,
@@ -135,7 +138,7 @@ export function getRegisteredTools(options = {}) {
         .map(withToolAnnotations)
         .map((tool) => projectContextConfigured ? withConfiguredProjectContext(tool) : tool);
 }
-const PROJECT_CONTEXT_CONFIGURED_DESCRIPTION = 'Get the private project context (always-applied instructions and an index of accumulated project documents) for the configured project. The project is resolved automatically from the MCP URL project_alias, so call this with no arguments at session start. Document bodies are not included; fetch them on demand with paput_get_project_document.';
+const PROJECT_CONTEXT_CONFIGURED_DESCRIPTION = 'Get the private project context (always-applied instructions, pending skill proposals, and document counts by kind) for the configured project. The project is resolved automatically from the MCP URL project_alias, so call this with no arguments at session start. Before drafting a design decision, implementation plan, or refactor, search past decisions and rejected alternatives with paput_search_project_documents.';
 function withConfiguredProjectContext(tool) {
     if (tool.definition.name !== 'paput_get_project_context')
         return tool;

package/dist/tool.js.map

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

package/dist/types/constants.js

@@ -12,6 +12,14 @@ export const CATEGORY_TYPE = {
     3: 'Database',
     4: 'Infrastructure',
 };
+export const PROCESS = {
+    1: 'Requirements',
+    2: 'Basic design',
+    3: 'Detailed design',
+    4: 'Implementation',
+    5: 'Testing',
+    6: 'Maintenance',
+};
 export const SKILL_LEVEL = {
     A: 'A',
     B: 'B',

package/dist/types/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/types/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,CAAC,EAAE,MAAM;IACT,CAAC,EAAE,QAAQ;CACH,CAAC;AAEX,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,CAAC,EAAE,UAAU;IACb,CAAC,EAAE,UAAU;CACL,CAAC;AAEX,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,CAAC,EAAE,UAAU;IACb,CAAC,EAAE,WAAW;IACd,CAAC,EAAE,UAAU;IACb,CAAC,EAAE,gBAAgB;CACX,CAAC;AAEX,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,GAAG;CACE,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/types/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,CAAC,EAAE,MAAM;IACT,CAAC,EAAE,QAAQ;CACH,CAAC;AAEX,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,CAAC,EAAE,UAAU;IACb,CAAC,EAAE,UAAU;CACL,CAAC;AAEX,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,CAAC,EAAE,UAAU;IACb,CAAC,EAAE,WAAW;IACd,CAAC,EAAE,UAAU;IACb,CAAC,EAAE,gBAAgB;CACX,CAAC;AAEX,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,CAAC,EAAE,cAAc;IACjB,CAAC,EAAE,cAAc;IACjB,CAAC,EAAE,iBAAiB;IACpB,CAAC,EAAE,gBAAgB;IACnB,CAAC,EAAE,SAAS;IACZ,CAAC,EAAE,aAAa;CACR,CAAC;AAEX,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,GAAG;CACE,CAAC"}

package/docs/reviewer-guide.md

@@ -18,11 +18,11 @@ The connector exposes the following tools. All tools carry annotations
 
 - **Memos:** create, search, get, update, list categories
 - **Notes:** create, search, get, update
-- **Skill sheet:** get and update basic info, self PR, skills, projects, project achievements, and generated project episodes
+- **Skill sheet:** get and update basic info, self PR, skills, projects, project achievements, generated project episodes, and the user-authored Q&A (FAQ) section
 - **Goals:** list, create, update, delete
 - **Dashboard analysis:** get and update the user's dashboard analysis
 - **Knowledge capture:** add, list, update, save, discard pending candidates; manage processed session markers and capture policy
-- **Project documents:** get project context, read/add/update private project documents, manage project instructions and proposal promotion status
+- **Project documents:** get project context, search/read/add/update private project documents, manage project instructions and proposal promotion status
 
 ## Test account
 

package/docs/tools.md

@@ -18,6 +18,7 @@ Clients and assistants should follow these rules:
 - `paput_save_pending_candidate` requires explicit user approval because it creates a PaPut memo from a pending candidate.
 - `paput_delete_skill_sheet_project` should be used only when the user clearly intends to remove a project.
 - `paput_update_skill_sheet_project_episodes` should be used only after the MCP client AI model has drafted project episodes and the user intends to save them.
+- `paput_update_skill_sheet_faq` full-replaces the user-authored FAQ and should be used only after the user explicitly approves the FAQ content.
 - `paput_update_dashboard_analysis` should be used only after the MCP client AI model has generated dashboard analysis and the user intends to save it.
 - `paput_set_skill_sheet_skills` replaces the full skill list and should be used only when the complete desired final list is known.
 - `paput_discard_pending_candidate` removes a pending item from the save flow and should be confirmed when the candidate may still be useful.
@@ -65,16 +66,17 @@ the response reports `has_more: true`.
 
 ## Skill Sheet Tools
 
-| Tool                                            | Safety            | Use case                                                                                          |
-| ----------------------------------------------- | ----------------- | ------------------------------------------------------------------------------------------------- |
-| `paput_get_skill_sheet`                         | Read-only         | Read the user's PaPut skill sheet.                                                                |
-| `paput_update_skill_sheet_basic_info`           | Destructive/write | Update profile fields such as nearest station, gender, birth date, or years of experience.        |
-| `paput_update_skill_sheet_self_pr`              | Destructive/write | Update the self PR section.                                                                       |
-| `paput_set_skill_sheet_skills`                  | Destructive/write | Replace the full skill list with a known final state.                                             |
-| `paput_upsert_skill_sheet_project`              | Destructive/write | Add or update a skill sheet project by ID or exact title match, including optional achievements.  |
-| `paput_delete_skill_sheet_project`              | Destructive       | Delete a skill sheet project by ID.                                                               |
-| `paput_get_skill_sheet_project_episodes_context` | Read-only        | Get project information and public linked memo bodies for MCP client-side episode drafting.       |
-| `paput_update_skill_sheet_project_episodes`     | Destructive/write | Full-replace generated project episodes after explicit user approval.                             |
+| Tool                                             | Safety            | Use case                                                                                         |
+| ------------------------------------------------ | ----------------- | ------------------------------------------------------------------------------------------------ |
+| `paput_get_skill_sheet`                          | Read-only         | Read the user's PaPut skill sheet.                                                               |
+| `paput_update_skill_sheet_basic_info`            | Destructive/write | Update profile fields such as nearest station, gender, birth date, or years of experience.       |
+| `paput_update_skill_sheet_self_pr`               | Destructive/write | Update the self PR section.                                                                      |
+| `paput_set_skill_sheet_skills`                   | Destructive/write | Replace the full skill list with a known final state.                                            |
+| `paput_upsert_skill_sheet_project`               | Destructive/write | Add or update a skill sheet project by ID or exact title match, including optional achievements. |
+| `paput_delete_skill_sheet_project`               | Destructive       | Delete a skill sheet project by ID.                                                              |
+| `paput_get_skill_sheet_project_episodes_context` | Read-only         | Get project information and public linked memo bodies for MCP client-side episode drafting.      |
+| `paput_update_skill_sheet_project_episodes`      | Destructive/write | Full-replace generated project episodes after explicit user approval.                            |
+| `paput_update_skill_sheet_faq`                   | Destructive/write | Full-replace the user-authored Q&A (FAQ) section after explicit user approval.                   |
 
 `paput_get_skill_sheet_project_episodes_context` returns project information and
 public linked memo bodies in `structuredContent`; private linked memos are
@@ -87,6 +89,14 @@ episodes for a project. Pass `episodes: []` only when the user explicitly wants
 to clear them. The API filters supporting memo IDs to the user's own public
 memos and reports dropped IDs.
 
+`paput_update_skill_sheet_faq` full-replaces the FAQ section returned by
+`paput_get_skill_sheet`. Unlike project episodes, FAQ question and answer text
+are user-authored originals, not AI-generated, so a resolved `related_memos`
+list is an optional evidence badge rather than a requirement. Pass `faq: []`
+only when the user explicitly wants to clear all items. The API filters
+`related_memo_ids` to the user's own public memos and reports dropped IDs per
+item.
+
 ## Goal Tools
 
 | Tool                | Safety            | Use case                                                                            |
@@ -124,47 +134,53 @@ repeatable procedures. They are API-backed and available through Remote HTTP
 MCP. Project context and documents are private and are never exposed
 publicly.
 
-| Tool                                | Safety            | Use case                                                                                            |
-| ----------------------------------- | ----------------- | --------------------------------------------------------------------------------------------------- |
-| `paput_get_project_context`         | Read-only         | Get a project's always-applied instructions and document index by fuzzy name match. Call at session start. |
-| `paput_get_project_document`        | Read-only         | Read the full body of a project document by ID, using the index from `paput_get_project_context`.   |
-| `paput_add_project_document`        | Write             | Save a design decision, procedure, or skill candidate linked to a project, with same-kind dedup.    |
-| `paput_update_project_document`     | Destructive/write | Replace a document's title, summary, and body by ID. Fetch the current document first for partial edits. |
-| `paput_update_project_instructions` | Destructive/write | Overwrite a project's always-applied instructions (max 8000 chars). Requires explicit user approval. |
-| `paput_discard_project_proposal`    | Destructive       | Record that the user rejected a skill proposal so it is not raised again.                            |
-| `paput_promote_project_documents`   | Destructive       | Mark a skill proposal and its procedure documents as promoted after a skill is created.              |
+| Tool                                | Safety            | Use case                                                                                                                                      |
+| ----------------------------------- | ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
+| `paput_get_project_context`         | Read-only         | Get a project's always-applied instructions, pending skill proposals, and document counts by kind by fuzzy name match. Call at session start. |
+| `paput_get_project_document`        | Read-only         | Read the full body of a project document by ID, found via `paput_search_project_documents`.                                                   |
+| `paput_search_project_documents`    | Read-only         | Semantic search over private project documents (vector search). Use before drafting a decision or plan.                                       |
+| `paput_add_project_document`        | Write             | Save a design decision, procedure, or skill candidate linked to a project, with same-kind dedup.                                              |
+| `paput_update_project_document`     | Destructive/write | Replace a document's title, summary, and body by ID; optionally set status to active or archived.                                             |
+| `paput_update_project_instructions` | Destructive/write | Overwrite a project's always-applied instructions (max 8000 chars). Requires explicit user approval.                                          |
+| `paput_discard_project_proposal`    | Destructive       | Record that the user rejected a skill proposal so it is not raised again.                                                                     |
+| `paput_promote_project_documents`   | Destructive       | Mark a skill proposal and its procedure documents as promoted after a skill is created.                                                       |
 
 When `project_alias` is present in the MCP URL, `paput_get_project_context` is
 called with no arguments and the `project` argument is not exposed. Without a
 URL project context, provide `project` per call.
 
-`paput_get_project_context` returns the document index only (no bodies); fetch
-bodies on demand with `paput_get_project_document`. Save settled design
-decisions and repeatable procedures with `paput_add_project_document`; when
-similar procedure records repeat, the server may suggest turning them into a
-skill. After the user approves a skill proposal and the skill is created, call
+`paput_get_project_context` returns instructions, pending proposals, and
+document counts only (no document list or bodies). Before drafting a design
+decision, implementation plan, or refactor, search past decisions and rejected
+alternatives with `paput_search_project_documents`, then fetch bodies on demand
+with `paput_get_project_document`. Save settled design decisions and repeatable
+procedures with `paput_add_project_document`; when similar procedure records
+repeat, the server may suggest turning them into a skill. After the user
+approves a skill proposal and the skill is created, call
 `paput_promote_project_documents` with the proposal and related procedure IDs; if
 the user rejects it, call `paput_discard_project_proposal` with the reason.
 Because instructions are loaded in full at session start, change them only with
-`paput_update_project_instructions` after explicit user approval.
+`paput_update_project_instructions` after explicit user approval. Archive
+settled or superseded documents with `paput_update_project_document`'s
+`status` argument to exclude them from default search results.
 
 ## Knowledge Capture Tools
 
 Knowledge capture state is stored by the PaPut API and is available through
 Remote HTTP MCP.
 
-| Tool                               | Safety                       | Use case                                                                    |
-| ---------------------------------- | ---------------------------- | --------------------------------------------------------------------------- |
-| `paput_add_knowledge_candidates`   | Write to pending queue       | Add extracted reusable knowledge candidates before they are saved to PaPut. |
-| `paput_list_processed_sessions`    | Read-only                    | List Claude/Codex sessions already reviewed for knowledge capture.          |
-| `paput_mark_processed_session`     | Write                        | Mark a reviewed Claude/Codex session as processed when no candidates are added. |
-| `paput_list_pending_candidates`    | Read-only                    | List pending candidates for review.                                         |
-| `paput_update_pending_candidate`   | Write to pending queue       | Refine a pending candidate's fields before it is saved.                     |
-| `paput_save_pending_candidate`     | Write                        | Save an approved pending candidate as a PaPut memo.                         |
-| `paput_discard_pending_candidate`  | Destructive action           | Remove a pending candidate from the save flow.                              |
-| `paput_get_capture_policy`         | Read-only                    | Read the capture policy generated from discarded candidates.                |
-| `paput_get_discard_policy_context` | Read-only                    | Read discarded candidates and current policy for AI-side policy analysis.   |
-| `paput_update_capture_policy`      | Write                        | Save the capture policy generated by the AI.                                |
+| Tool                               | Safety                 | Use case                                                                        |
+| ---------------------------------- | ---------------------- | ------------------------------------------------------------------------------- |
+| `paput_add_knowledge_candidates`   | Write to pending queue | Add extracted reusable knowledge candidates before they are saved to PaPut.     |
+| `paput_list_processed_sessions`    | Read-only              | List Claude/Codex sessions already reviewed for knowledge capture.              |
+| `paput_mark_processed_session`     | Write                  | Mark a reviewed Claude/Codex session as processed when no candidates are added. |
+| `paput_list_pending_candidates`    | Read-only              | List pending candidates for review.                                             |
+| `paput_update_pending_candidate`   | Write to pending queue | Refine a pending candidate's fields before it is saved.                         |
+| `paput_save_pending_candidate`     | Write                  | Save an approved pending candidate as a PaPut memo.                             |
+| `paput_discard_pending_candidate`  | Destructive action     | Remove a pending candidate from the save flow.                                  |
+| `paput_get_capture_policy`         | Read-only              | Read the capture policy generated from discarded candidates.                    |
+| `paput_get_discard_policy_context` | Read-only              | Read discarded candidates and current policy for AI-side policy analysis.       |
+| `paput_update_capture_policy`      | Write                  | Save the capture policy generated by the AI.                                    |
 
 Capture policy workflow:
 

package/docs/usage-examples.md

@@ -204,3 +204,25 @@ If older memos never appear in similarity results, run
 `paput_backfill_memo_embeddings` and repeat while the response reports
 `has_more: true`. This is a one-time setup step; new and updated memos are
 embedded automatically.
+
+## 12. Source And Save Interview Q&A (FAQ)
+
+Prompt:
+
+```text
+Help me build out my PaPut FAQ from questions I've been asked in interviews and my memos, then save it after I approve it.
+```
+
+Expected tool flow:
+
+1. `paput_get_skill_sheet` to see the current `faq` and profile
+2. `paput_get_categories` and `paput_search_memo` to find decision/operation/principle clusters for memo-derived question candidates
+3. Web search (or, if unavailable, general model knowledge labeled as tentative) for general technical interview questions, filtered to the user's skills
+4. MCP client AI presents candidates from all three sources; the user adopts or rejects each one
+5. MCP client AI drafts a first-person answer for each adopted question
+6. `paput_get_skill_sheet` again, then `paput_update_skill_sheet_faq` with the merged full list, after the user approves the drafts. Check the per-item `dropped_ids` in that response.
+7. `paput_get_skill_sheet` to verify the saved result
+
+Use case: build the skill sheet's Q&A section from real interview questions,
+existing memo evidence, and general interview-question research, without
+locking the question set to a static list baked into the skill.

package/package.json

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