@longtable/provider-codex 0.1.41 → 0.1.43

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",
                 "",
@@ -83,6 +95,7 @@ function baseSkillSpecs(surface = "compact") {
                 "- 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.",
+                "- 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.",
                 "- If `CURRENT.md` shows a pending required checkpoint, ask the researcher for a selection and wait. Do not choose or record `longtable decide --question <id> --answer <value>` unless the researcher explicitly provides that value.",
@@ -112,9 +125,10 @@ function baseSkillSpecs(surface = "compact") {
                 "4. Ask one natural-language question at a time. Do not show a questionnaire.",
                 "5. After each answer, evaluate answer quality before classifying it.",
                 "6. Record each turn with MCP `append_interview_turn` when available.",
-                "7. Continue until there is enough context for a provisional `first_research_handle`.",
+                "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.",
                 "",
                 "## Opening Questions",
                 "",
@@ -131,8 +145,10 @@ function baseSkillSpecs(surface = "compact") {
                 "- Keep the visual frame minimal, using `LongTable hears:` and `Question:`.",
                 "- Reflect the answer before asking the next question.",
                 "- Ask one question only; wait for the researcher before continuing.",
+                "- Keep the follow-up focused on one main uncertainty. A sentence may name nearby tensions for context, but avoid bundling several answerable questions into a mini-questionnaire.",
                 "- If the answer is thin, ask for one more sentence instead of classifying it.",
                 "- Treat one-word or one-letter answers as `quality: thin` and request more context.",
+                "- Keep hook-added context out of normal replies unless it changes the next research action.",
                 "",
                 "Recommended frame:",
                 "",
@@ -152,6 +168,25 @@ function baseSkillSpecs(surface = "compact") {
                 "",
                 "Do not turn early answers into fixed categories. Let LongTable infer quietly in the background.",
                 "",
+                "## Turn Recording",
+                "",
+                "`append_interview_turn` records the durable interview trace in `.longtable/state.json`: the question asked, the researcher answer, a short reflection, answer quality, whether a follow-up is needed, and any content-based readiness rationale. If MCP tools are unavailable, continue the interview but say that this durable turn was not written.",
+                "",
+                "Do not set `readyToSummarize: true` because of turn count. Set it only when the answer history supports the closure-readiness criteria below.",
+                "",
+                "## Closure Readiness",
+                "",
+                "End the interview only when the conversation has enough material to support later research work:",
+                "",
+                "- research object: what kind of artifact or study decision LongTable is shaping",
+                "- focal uncertainty: what remains hard to name, justify, or inspect",
+                "- construct or boundary: what should count and what should not count",
+                "- evidence/material: where the first inspection will happen",
+                "- protected decision: what LongTable must not settle silently",
+                "- next action: the next concrete research move",
+                "",
+                "Some projects may need two turns; others may need ten or more. If these elements are still vague, ask another natural-language question instead of summarizing.",
+                "",
                 "## First Research Shape",
                 "",
                 "When ready, summarize:",
@@ -166,7 +201,9 @@ 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. If MCP elicitation is unavailable, ask the same options in plain text and keep the state update explicit.",
+                "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.",
+                "",
+                "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",
                 "",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@longtable/provider-codex",
-  "version": "0.1.41",
+  "version": "0.1.43",
   "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.41",
-    "@longtable/core": "0.1.41",
-    "@longtable/setup": "0.1.41"
+    "@longtable/checkpoints": "0.1.43",
+    "@longtable/core": "0.1.43",
+    "@longtable/setup": "0.1.43"
   },
   "devDependencies": {
     "@types/node": "^22.10.1",