@longtable/provider-claude 0.1.43 → 0.1.44

package/dist/skills.js

@@ -64,7 +64,7 @@ function baseSkillSpecs(surface = "compact") {
                 "- Treat `.longtable/` state as the project source of truth when present.",
                 "- The compact visible shortcut set is methods, measure, theory, reviewer, and voice. Other roles remain available through this router when the request calls for them.",
                 "- Prefer natural language over asking the researcher to run shell role commands.",
-                "- For `$longtable-interview`, use natural-language turns for the interview and reserve structured options for final First Research Shape confirmation.",
+                "- For `$longtable-interview`, use natural-language turns for the interview and reserve structured options for final Research Specification confirmation, with First Research Shape kept as the shorter handle layer.",
                 "- Do not let unrelated pending Researcher Checkpoints interrupt the interview. Mention them only as separate unresolved checkpoints, and treat them as blocking only when the researcher is confirming, saving, or recording a research decision.",
                 "- If a Researcher Checkpoint is needed, ask a short structured question with meaningful options and wait for the researcher.",
                 "- If changing LongTable product language, README positioning, or checkpoint policy, ask a Meta-Decision Checkpoint first.",
@@ -97,7 +97,7 @@ function baseSkillSpecs(surface = "compact") {
         },
         {
             name: "longtable-interview",
-            description: "Use for `$longtable-interview`: create or continue a LongTable research-start interview inside Claude Code, then store a First Research Shape through MCP/state.",
+            description: "Use for `$longtable-interview`: create or continue a LongTable research-start interview inside Claude Code, then store a First Research Shape and Research Specification through MCP/state.",
             triggers: ["$longtable-interview", "longtable interview", "start research interview", "first research shape"],
             body: [
                 "## Purpose",
@@ -114,8 +114,11 @@ function baseSkillSpecs(surface = "compact") {
                 "6. Record turns with MCP `append_interview_turn` when available.",
                 "7. Continue until there is content-based readiness for a provisional `first_research_handle`; never stop merely because a fixed number of turns has passed.",
                 "8. Store the First Research Shape with MCP `summarize_interview`.",
-                "9. Use MCP `confirm_first_research_shape` for the final structured confirmation.",
-                "10. If the researcher explicitly cancels the interview, use MCP `cancel_interview` when available. Do not cancel durable state for a casual topic change unless the researcher says to cancel the interview.",
+                "9. Store the fuller Research Specification with MCP `summarize_research_specification` when the interview has enough detail.",
+                "10. Show the Research Specification Preview explicitly before asking for confirmation.",
+                "11. Use MCP `confirm_research_specification` for the final structured confirmation.",
+                "12. Use MCP `confirm_first_research_shape` only when the researcher wants to stop at the shorter shape layer.",
+                "13. If the researcher explicitly cancels the interview, use MCP `cancel_interview` when available. Do not cancel durable state for a casual topic change unless the researcher says to cancel the interview.",
                 "",
                 "## Opening",
                 "",
@@ -167,7 +170,23 @@ function baseSkillSpecs(surface = "compact") {
                 "- nextAction",
                 "- confidence",
                 "",
-                "Use structured options only for the final confirmation or true checkpoint boundaries. Show the options in the researcher's current language when possible, usually: save/confirm, ask one more question, revise, or keep open. If MCP is unavailable, continue in natural language but do not claim that state was written.",
+                "The First Research Shape is the short handle layer. It is useful for early resume context, but it is not the full research specification.",
+                "",
+                "## Research Specification",
+                "",
+                "Before ending a substantive interview, convert the First Research Shape into a fuller Research Specification when the conversation provides enough material:",
+                "",
+                "- title",
+                "- researchDirection: question, purpose, scope boundary, inclusion/exclusion criteria",
+                "- constructOntology: core constructs, distinctions, and terms that should not be collapsed",
+                "- theoryAndFraming: theory anchors, alternatives, and overreach risks",
+                "- measurementCoding: variables/constructs, evidence types, coding rules, and open standards",
+                "- methodAnalysis: design, analysis options, data sufficiency criteria, and unsettled choices",
+                "- evidenceAccess: required sources, access requirements, and evidence standards",
+                "- epistemicAlignment: researcher knowledge, project-state priority, AI inference limits, and the conflict-resolution rule",
+                "- protectedDecisions, openQuestions, nextActions, and confidence",
+                "",
+                "Show a clear `Research Specification Preview` in the researcher's current language before confirmation. Then call `confirm_research_specification`, whose structured options should usually be: save/confirm, ask one more question, revise a section, or keep open. If MCP is unavailable, continue in natural language but do not claim that state was written.",
                 "",
                 "If a confirmed First Research Shape already exists, do not reopen the interview automatically. Summarize the existing shape and ask whether to continue from it, revise it, or explicitly start a new interview."
             ]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@longtable/provider-claude",
-  "version": "0.1.43",
+  "version": "0.1.44",
   "private": false,
   "description": "Claude adapter surface for LongTable",
   "type": "module",
@@ -21,9 +21,9 @@
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },
   "dependencies": {
-    "@longtable/checkpoints": "0.1.43",
-    "@longtable/core": "0.1.43",
-    "@longtable/setup": "0.1.43"
+    "@longtable/checkpoints": "0.1.44",
+    "@longtable/core": "0.1.44",
+    "@longtable/setup": "0.1.44"
   },
   "devDependencies": {
     "typescript": "^5.6.0"