@longtable/provider-codex 0.1.42 → 0.1.44

package/dist/skills.js

@@ -67,6 +67,9 @@ function baseSkillSpecs(surface = "compact") {
                 "- 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.",
                 "- When research responsibility is about to shift, surface a Researcher Checkpoint before closure.",
                 "- When changing LongTable product language, README positioning, or checkpoint policy, surface a Meta-Decision Checkpoint first.",
+                "- Stop before acting when the request would change the research question/scope, theory frame, measurement/coding standard, method design, or analysis strategy.",
+                "- For low-risk reversible work, proceed with explicit assumptions instead of interrupting.",
+                "- For LongTable product, hook, setup, release, or documentation work, do not create research-state QuestionRecords.",
                 "",
                 "## Panel And Team Behavior",
                 "",
@@ -74,6 +77,15 @@ function baseSkillSpecs(surface = "compact") {
                 "- Use provider-native subagents only when the current Codex runtime makes them available and the user's request clearly calls for multi-agent work.",
                 "- If native subagents are unavailable, use LongTable's sequential panel fallback and make the fallback explicit in the technical record.",
                 "- Do not expose hidden reasoning, tool logs, or private chain-of-thought. Expose a structured deliberation record instead.",
+                "- A structured deliberation record must include: roles consulted, each role's main claim or objection, the disagreement map, the decision options, the recommended option when defensible, and the exact researcher-facing question.",
+                "- If the panel converges, explain what changed the disagreement; if it does not converge, preserve the unresolved conflict instead of collapsing it into one confident synthesis.",
+                "",
+                "## Question Ordering",
+                "",
+                "- Ask and stop when missing context would decide a high-risk research commitment.",
+                "- Continue with stated assumptions when the missing context is low-risk, reversible, or purely presentational.",
+                "- Rank questions by importance and risk; prefer one grouped high-leverage question over a long questionnaire.",
+                "- When human knowledge, AI inference, and project state conflict, make the conflict visible and ask for human clarity before treating the direction as settled.",
                 "",
                 "## Project State",
                 "",
@@ -82,7 +94,7 @@ function baseSkillSpecs(surface = "compact") {
                 "- If a Researcher Checkpoint is needed, ask a concise question with meaningful options and wait for the researcher.",
                 "- If a checkpoint allows `other`, make `other` visible instead of hiding it in state.",
                 "- Treat provider-native question UI as transport; LongTable state records are the source of truth.",
-                "- For `$longtable-interview`, use natural-language turns for the interview and reserve MCP option UI for the final research-facing First Research Shape checkpoint.",
+                "- For `$longtable-interview`, use natural-language turns for the interview and reserve MCP option UI for the final research-facing Research Specification checkpoint, 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.",
                 "- When the `mcp__longtable_state__.elicit_question` tool is available, use it first for researcher checkpoints so Codex can show the MCP elicitation UI and LongTable can record the answer as `mcp_elicitation`.",
                 "- Use `longtable question --print --provider codex --prompt \"...\"` only as a fallback when the MCP tool is unavailable, unsupported, declined, canceled, or blocked by the client.",
@@ -93,7 +105,7 @@ function baseSkillSpecs(surface = "compact") {
         },
         {
             name: "longtable-interview",
-            description: "Use for `$longtable-interview`: create or continue a LongTable research-start interview inside Codex, then store a First Research Shape through MCP/state.",
+            description: "Use for `$longtable-interview`: create or continue a LongTable research-start interview inside Codex, then store a First Research Shape and Research Specification through MCP/state.",
             body: [
                 "## Purpose",
                 "",
@@ -103,7 +115,7 @@ function baseSkillSpecs(surface = "compact") {
                 "",
                 "- The user invokes `$longtable-interview`.",
                 "- The user wants to start a LongTable research workspace from inside Codex.",
-                "- A workspace exists but `CURRENT.md` or `.longtable/state.json` lacks a usable First Research Shape.",
+                "- A workspace exists but `CURRENT.md` or `.longtable/state.json` lacks a usable First Research Shape or Research Specification.",
                 "",
                 "## Core Flow",
                 "",
@@ -115,8 +127,11 @@ function baseSkillSpecs(surface = "compact") {
                 "6. Record each turn 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 research-facing option UI checkpoint.",
-                "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 research-facing option UI checkpoint.",
+                "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 Questions",
                 "",
@@ -189,13 +204,29 @@ function baseSkillSpecs(surface = "compact") {
                 "- `nextAction`: one concrete next research move",
                 "- `confidence`: low, medium, or high",
                 "",
-                "The final structured options belong only at this confirmation point. Show the options in the researcher's current language when possible, usually: save/confirm, ask one more question, revise, or keep open. If MCP elicitation is unavailable, ask the same options in plain text and keep the state update explicit.",
+                "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`: working specification 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 elicitation is unavailable, ask the same options in plain text and keep the state update explicit.",
                 "",
                 "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.",
                 "",
                 "## Fallback",
                 "",
-                "If MCP tools are unavailable, continue the natural-language interview in Codex, but state that durable LongTable state could not be written. Do not pretend a checkpoint or First Research Shape was recorded."
+                "If MCP tools are unavailable, continue the natural-language interview in Codex, but state that durable LongTable state could not be written. Do not pretend a checkpoint, First Research Shape, or Research Specification was recorded."
             ]
         }
     ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@longtable/provider-codex",
-  "version": "0.1.42",
+  "version": "0.1.44",
   "private": false,
   "description": "Codex adapter surface for LongTable",
   "type": "module",
@@ -15,9 +15,9 @@
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },
   "dependencies": {
-    "@longtable/checkpoints": "0.1.42",
-    "@longtable/core": "0.1.42",
-    "@longtable/setup": "0.1.42"
+    "@longtable/checkpoints": "0.1.44",
+    "@longtable/core": "0.1.44",
+    "@longtable/setup": "0.1.44"
   },
   "devDependencies": {
     "@types/node": "^22.10.1",