@longtable/cli 0.1.9 → 0.1.10

package/dist/cli.js

@@ -1,17 +1,20 @@
 #!/usr/bin/env node
 import { existsSync, readFileSync, statSync } from "node:fs";
 import { mkdtemp, rm } from "node:fs/promises";
+import { execSync } from "node:child_process";
 import { emitKeypressEvents } from "node:readline";
 import { createInterface } from "node:readline/promises";
 import { stdin as input, stdout as output, cwd, exit } from "node:process";
 import { dirname, resolve } from "node:path";
 import { homedir } from "node:os";
-import { buildProviderChoices, buildQuickSetupFlow, createPersistedSetupOutput, installRuntimeConfigFromStoredSetup, loadSetupOutput, renderInstallSummary, renderSetupSummary, resolveDefaultRuntimeConfigPath, resolveDefaultSetupPath, saveSetupAndRuntimeConfig, serializeSetupOutput } from "@longtable/setup";
-import { buildCodexThinWrappedPrompt, runCodexThinWrapper } from "@longtable/provider-codex";
+import { buildProviderChoices, buildQuickSetupFlow, createPersistedSetupOutput, installRuntimeConfigFromStoredSetup, loadSetupOutput, renderInstallSummary, renderSetupSummary, resolveDefaultRuntimeConfigPath, resolveDefaultSetupPath, saveSetupAndRuntimeConfig, serializeSetupOutput, writeRuntimeConfig } from "@longtable/setup";
+import { buildCodexSkillSpecs, buildCodexThinWrappedPrompt, installCodexSkills, listInstalledCodexSkills, renderQuestionRecordPrompt, removeCodexSkills, resolveCodexSkillsDir, runCodexThinWrapper } from "@longtable/provider-codex";
+import { buildClaudeSkillSpecs, installClaudeSkills, listInstalledClaudeSkills, renderQuestionRecordInput, removeClaudeSkills, resolveClaudeSkillsDir } from "@longtable/provider-claude";
 import { installCodexPromptAliases, listInstalledCodexPromptAliases, removeCodexPromptAliases, resolveCodexPromptsDir } from "./prompt-aliases.js";
 import { buildPersonaGuidance, parseInvocationDirective } from "./persona-router.js";
-import { PERSONA_DEFINITIONS } from "./personas.js";
-import { createOrUpdateProjectWorkspace, loadProjectContextFromDirectory, renderProjectWorkspaceSummary, syncCurrentWorkspaceView } from "./project-session.js";
+import { PERSONA_DEFINITIONS, listRoleDefinitions } from "./personas.js";
+import { buildPanelFallback, renderPanelSummary } from "./panel.js";
+import { appendInvocationRecordToWorkspace, assertWorkspaceNotBlocked, answerWorkspaceQuestion, createWorkspaceQuestion, createOrUpdateProjectWorkspace, inspectProjectWorkspace, loadProjectContextFromDirectory, renderProjectWorkspaceSummary, syncCurrentWorkspaceView } from "./project-session.js";
 const VALID_MODES = new Set([
     "explore",
     "review",
@@ -69,28 +72,40 @@ function usage() {
         "  Run `longtable ...` in your terminal, not inside the Codex chat box.",
         "  After `longtable start`, move into the created project directory and open `codex` there.",
         "",
-        "  longtable init [--flow quickstart|interview] [--provider codex|claude] [--field <field>] [--career-stage <stage>] [--experience novice|intermediate|advanced] [--checkpoint low|balanced|high] [--authorship-signal <text>] [--entry-mode explore|review|critique|draft|commit] [--weakest-domain theory|methodology|measurement|analysis|writing] [--panel-preference synthesis_only|show_on_conflict|always_visible] [--json] [--no-install] [--install-prompts]",
+        "  longtable init [--flow quickstart|interview] [--provider codex|claude] [--field <field>] [--career-stage <stage>] [--experience novice|intermediate|advanced] [--checkpoint low|balanced|high] [--authorship-signal <text>] [--entry-mode explore|review|critique|draft|commit] [--weakest-domain theory|methodology|measurement|analysis|writing] [--panel-preference synthesis_only|show_on_conflict|always_visible] [--json] [--no-install] [--install-skills] [--install-prompts]",
         "  longtable start [--path <dir>] [--name <project>] [--goal <text>] [--blocker <text>] [--perspectives <role[,role]>] [--disagreement synthesis_only|show_on_conflict|always_visible] [--setup <path>] [--json]",
         "  longtable resume [--cwd <path>] [--json]",
+        "  longtable doctor [--cwd <path>] [--fix] [--json] [--codex-dir <path>] [--claude-dir <path>] [--codex-prompts-dir <path>] [--codex-runtime-path <file>] [--claude-runtime-path <file>]",
+        "  longtable status [--cwd <path>] [--fix] [--json] [--codex-dir <path>] [--claude-dir <path>] [--codex-prompts-dir <path>] [--codex-runtime-path <file>] [--claude-runtime-path <file>]",
         "  longtable roles [--json]",
         "  longtable show [--json] [--path <file>]",
         "  longtable install [--json] [--path <file>] [--runtime-path <file>]",
         "  longtable ask [--prompt <text>] [--print] [--json] [--setup <path>] [--cwd <path>]",
+        "  longtable question --prompt <decision-context> [--title <text>] [--text <question>] [--provider codex|claude] [--required|--advisory] [--print] [--cwd <path>] [--json]",
+        "  longtable panel [--prompt <text>] [--role <role[,role]>] [--mode review|critique|draft|commit] [--visibility synthesis_only|show_on_conflict|always_visible] [--print] [--json] [--setup <path>] [--cwd <path>]",
+        "  longtable decide [--question <id>] --answer <value-or-text> [--rationale <text>] [--provider codex|claude] [--cwd <path>] [--json]",
         "  longtable explore|review|critique|draft|commit|submit [--prompt <text>] [--role <role[,role]>] [--panel] [--show-conflicts] [--show-deliberation] [--print] [--json] [--stage <stage>] [--setup <path>] [--cwd <path>]",
-        "  longtable codex persist-init [--answers-json <json> | --stdin | full setup flags] [--install-prompts] [--json]",
+        "  longtable codex persist-init [--answers-json <json> | --stdin | full setup flags] [--install-skills] [--install-prompts] [--json]",
+        "  longtable codex install-skills [--dir <path>]",
+        "  longtable codex remove-skills [--dir <path>]",
         "  longtable codex install-prompts [--dir <path>]",
         "  longtable codex remove-prompts [--dir <path>]",
         "  longtable codex status [--dir <path>] [--json]",
+        "  longtable claude install-skills [--dir <path>]",
+        "  longtable claude remove-skills [--dir <path>]",
+        "  longtable claude status [--dir <path>] [--json]",
         "",
         "Examples:",
-        "  longtable init --flow interview --install-prompts",
+        "  longtable init --flow interview --provider codex --install-skills",
         "  longtable start",
         "  longtable start --path ~/Research/My-Project --name \"AI Adoption Meta-Analysis\" --goal \"Narrow the review question\"",
         "  cd \"<project-path>\" && codex",
+        "  longtable doctor",
         "  longtable roles",
         "  longtable ask --prompt \"연구를 시작하고 싶어. 지금 어디서부터 좁혀야 할지 모르겠어.\"",
-        "  printf '{\"provider\":\"codex\",...}' | longtable codex persist-init --stdin --install-prompts",
-        "  longtable codex install-prompts"
+        "  printf '{\"provider\":\"codex\",...}' | longtable codex persist-init --stdin --install-skills",
+        "  longtable codex install-skills",
+        "  longtable claude install-skills"
     ].join("\n");
 }
 function parseArgs(argv) {
@@ -98,13 +113,13 @@ function parseArgs(argv) {
     const values = {};
     let subcommand = maybeSubcommand;
     const modeCommand = command && VALID_MODES.has(command);
-    const directCommand = command && ["init", "start", "resume", "roles", "show", "install", "codex", "ask"].includes(command);
+    const directCommand = command && ["init", "start", "resume", "doctor", "status", "roles", "show", "install", "codex", "claude", "ask", "question", "panel", "decide"].includes(command);
     let startIndex = 1;
     if (modeCommand) {
         subcommand = undefined;
         startIndex = 1;
     }
-    else if (command === "codex") {
+    else if (command === "codex" || command === "claude") {
         startIndex = 2;
     }
     else if (directCommand) {
@@ -667,9 +682,11 @@ async function runInit(args) {
     const json = args.json === true;
     const installRuntime = args["no-install"] !== true;
     const installPrompts = args["install-prompts"] === true;
+    const installSkills = args["install-skills"] === true;
     const customPath = typeof args.path === "string" ? args.path : undefined;
     const runtimePath = typeof args["runtime-path"] === "string" ? args["runtime-path"] : undefined;
     const promptsDir = typeof args.dir === "string" ? args.dir : undefined;
+    const skillsDir = typeof args["skills-dir"] === "string" ? args["skills-dir"] : promptsDir;
     const { flow, provider, answers } = hasCompleteFlagInput(args)
         ? {
             flow: resolveSetupFlow(args),
@@ -686,8 +703,23 @@ async function runInit(args) {
     if (provider === "codex" && installPrompts) {
         installedPrompts = await installCodexPromptAliases(promptsDir);
     }
+    let installedSkills = [];
+    if (provider === "codex" && installSkills) {
+        installedSkills = await installCodexSkills(listRoleDefinitions(), skillsDir);
+    }
+    if (provider === "claude" && installSkills) {
+        installedSkills = await installClaudeSkills(listRoleDefinitions(), skillsDir);
+    }
     if (json) {
-        console.log(serializeSetupOutput(outputValue));
+        if (installedPrompts.length === 0 && installedSkills.length === 0) {
+            console.log(serializeSetupOutput(outputValue));
+            return;
+        }
+        console.log(JSON.stringify({
+            setup: outputValue,
+            installedPrompts: installedPrompts.map((prompt) => prompt.name),
+            installedSkills: installedSkills.map((skill) => skill.name)
+        }, null, 2));
         return;
     }
     console.log(renderSetupSummary(outputValue));
@@ -699,18 +731,33 @@ async function runInit(args) {
         console.log("");
         console.log("Installed Codex prompt files:");
         for (const prompt of installedPrompts) {
-            console.log(`- /prompts:${prompt.name}`);
+            console.log(`- ${prompt.name}`);
+        }
+        console.log("  Note: prompt files are legacy and may not be exposed by your Codex build.");
+    }
+    if (installedSkills.length > 0) {
+        console.log("");
+        console.log(`Installed ${provider === "codex" ? "Codex" : "Claude"} skill files:`);
+        for (const skill of installedSkills) {
+            console.log(`- ${skill.name}`);
         }
-        console.log("  Note: whether Codex exposes these as slash commands depends on your Codex build.");
+        console.log("  Use these by naming LongTable naturally, e.g. `lt panel: ...`.");
     }
     if (provider === "codex") {
         console.log("");
         console.log("Next step:");
         console.log("- Start here: `longtable start`.");
         console.log("- If you want a direct natural-language entry: `longtable ask --prompt \"...\"`.");
-        console.log("- Codex prompt files are available as an experimental integration, not the primary path.");
+        console.log("- Codex skills are the preferred native surface. Prompt files are legacy and may not expose slash commands.");
         console.log("- Suggested next action: create a project workspace and let LongTable interview the current session.");
     }
+    if (provider === "claude") {
+        console.log("");
+        console.log("Next step:");
+        console.log("- Start here: `longtable start`.");
+        console.log("- In Claude Code, use natural language such as `lt explore: ...` or `lt panel: ...`.");
+        console.log("- Claude skills are adapter output from LongTable roles, not the source of truth.");
+    }
 }
 async function runShow(args) {
     const outputValue = await loadSetupOutput(typeof args.path === "string" ? args.path : undefined);
@@ -731,6 +778,300 @@ async function runInstall(args) {
     }
     console.log(renderInstallSummary(result));
 }
+function commandOnPath(command) {
+    try {
+        execSync(`command -v ${command}`, { stdio: "ignore" });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function missingNames(expected, installed) {
+    const installedSet = new Set(installed);
+    return expected.filter((name) => !installedSet.has(name));
+}
+function setupForProvider(setup, provider) {
+    return {
+        ...setup,
+        providerSelection: provider === "claude"
+            ? {
+                provider,
+                checkpointProtocol: "native_structured",
+                supportsStructuredQuestions: true
+            }
+            : {
+                provider,
+                checkpointProtocol: "numbered",
+                supportsStructuredQuestions: false
+            }
+    };
+}
+async function collectDoctorStatus(args) {
+    const roles = listRoleDefinitions();
+    const setupOverride = typeof args.setup === "string"
+        ? args.setup
+        : typeof args.path === "string"
+            ? args.path
+            : undefined;
+    const setupPath = resolveDefaultSetupPath(setupOverride).path;
+    const codexRuntimeOverride = typeof args["codex-runtime-path"] === "string"
+        ? args["codex-runtime-path"]
+        : undefined;
+    const claudeRuntimeOverride = typeof args["claude-runtime-path"] === "string"
+        ? args["claude-runtime-path"]
+        : undefined;
+    const codexDir = typeof args["codex-dir"] === "string"
+        ? args["codex-dir"]
+        : typeof args.dir === "string"
+            ? args.dir
+            : undefined;
+    const codexPromptsDir = typeof args["codex-prompts-dir"] === "string"
+        ? args["codex-prompts-dir"]
+        : typeof args["prompts-dir"] === "string"
+            ? args["prompts-dir"]
+            : typeof args.dir === "string"
+                ? args.dir
+                : undefined;
+    const claudeDir = typeof args["claude-dir"] === "string"
+        ? args["claude-dir"]
+        : typeof args.dir === "string"
+            ? args.dir
+            : undefined;
+    const codexRuntimePath = resolveDefaultRuntimeConfigPath("codex", codexRuntimeOverride).path;
+    const claudeRuntimePath = resolveDefaultRuntimeConfigPath("claude", claudeRuntimeOverride).path;
+    const expectedCodexSkills = buildCodexSkillSpecs(roles).map((skill) => skill.name);
+    const expectedClaudeSkills = buildClaudeSkillSpecs(roles).map((skill) => skill.name);
+    const [codexSkills, claudeSkills, codexAliases, workspace] = await Promise.all([
+        listInstalledCodexSkills(roles, codexDir),
+        listInstalledClaudeSkills(roles, claudeDir),
+        listInstalledCodexPromptAliases(codexPromptsDir),
+        inspectProjectWorkspace(typeof args.cwd === "string" ? args.cwd : cwd())
+    ]);
+    const installedCodexSkills = codexSkills.map((skill) => skill.name);
+    const installedClaudeSkills = claudeSkills.map((skill) => skill.name);
+    return {
+        setupPath,
+        setupExists: existsSync(setupPath),
+        providers: {
+            codex: {
+                command: "codex",
+                commandOnPath: commandOnPath("codex"),
+                runtimePath: codexRuntimePath,
+                runtimeExists: existsSync(codexRuntimePath),
+                skillsDir: resolveCodexSkillsDir(codexDir),
+                expectedSkills: expectedCodexSkills,
+                installedSkills: installedCodexSkills,
+                missingSkills: missingNames(expectedCodexSkills, installedCodexSkills),
+                promptsDir: resolveCodexPromptsDir(codexPromptsDir),
+                legacyPromptFilesInstalled: codexAliases.map((alias) => alias.name)
+            },
+            claude: {
+                command: "claude",
+                commandOnPath: commandOnPath("claude"),
+                runtimePath: claudeRuntimePath,
+                runtimeExists: existsSync(claudeRuntimePath),
+                skillsDir: resolveClaudeSkillsDir(claudeDir),
+                expectedSkills: expectedClaudeSkills,
+                installedSkills: installedClaudeSkills,
+                missingSkills: missingNames(expectedClaudeSkills, installedClaudeSkills)
+            }
+        },
+        workspace
+    };
+}
+function renderProviderDoctorBlock(label, provider) {
+    const expectedCount = provider.expectedSkills.length;
+    const installedCount = provider.installedSkills.length;
+    return [
+        `${label}:`,
+        `- command: ${provider.commandOnPath ? "present" : "missing"} (${provider.command})`,
+        `- runtime artifact: ${provider.runtimeExists ? "present" : "missing"} (${provider.runtimePath})`,
+        `- skills: ${installedCount}/${expectedCount} installed (${provider.skillsDir})`,
+        ...(provider.missingSkills.length > 0
+            ? [`- missing skills: ${provider.missingSkills.join(", ")}`]
+            : ["- missing skills: none"])
+    ];
+}
+function renderDoctorStatus(status) {
+    const lines = [
+        "LongTable doctor",
+        `- setup: ${status.setupExists ? "present" : "missing"} (${status.setupPath})`,
+        "",
+        ...renderProviderDoctorBlock("Codex", status.providers.codex),
+        `- legacy prompt files: ${status.providers.codex.legacyPromptFilesInstalled.length}`,
+        ...(status.providers.codex.legacyPromptFilesInstalled.length > 0
+            ? [`- legacy prompt names: ${status.providers.codex.legacyPromptFilesInstalled.join(", ")}`]
+            : []),
+        "",
+        ...renderProviderDoctorBlock("Claude", status.providers.claude),
+        "",
+        "Workspace:"
+    ];
+    if (!status.workspace.found) {
+        lines.push("- project: not found from current directory");
+    }
+    else {
+        const workspace = status.workspace;
+        lines.push(`- project: ${workspace.project?.name ?? "unknown"}`, `- root: ${workspace.rootPath ?? "unknown"}`, `- goal: ${workspace.session?.currentGoal ?? "unknown"}`, `- invocations: ${workspace.counts?.invocations ?? 0}`, `- questions: ${workspace.counts?.questions ?? 0} (${workspace.counts?.pendingQuestions ?? 0} pending, ${workspace.counts?.answeredQuestions ?? 0} answered)`, `- decisions: ${workspace.counts?.decisions ?? 0}`);
+        if ((workspace.recentInvocations ?? []).length > 0) {
+            lines.push("- recent invocations:");
+            for (const invocation of workspace.recentInvocations ?? []) {
+                const roles = invocation.roles.length > 0 ? invocation.roles.join(",") : "auto";
+                lines.push(`  - ${invocation.kind}/${invocation.mode} via ${invocation.surface}: ${roles} (${invocation.status})`);
+            }
+        }
+        if ((workspace.pendingQuestions ?? []).length > 0) {
+            lines.push("- pending questions:");
+            for (const question of workspace.pendingQuestions ?? []) {
+                lines.push(`  - ${question.id}: ${question.question} (${question.options.join("/")})`);
+            }
+        }
+    }
+    const nextActions = [];
+    const canFix = status.providers.codex.missingSkills.length > 0 ||
+        status.providers.claude.missingSkills.length > 0 ||
+        status.providers.codex.legacyPromptFilesInstalled.length > 0 ||
+        (status.setupExists &&
+            (!status.providers.codex.runtimeExists || !status.providers.claude.runtimeExists));
+    if (canFix) {
+        nextActions.push("longtable doctor --fix");
+    }
+    if (!status.setupExists) {
+        nextActions.push("longtable init --flow interview --provider codex --install-skills");
+    }
+    if (!status.workspace.found) {
+        nextActions.push("longtable start");
+    }
+    const firstQuestion = status.workspace.pendingQuestions?.[0];
+    if (firstQuestion) {
+        nextActions.push(`longtable decide --question ${firstQuestion.id} --answer <value>`);
+    }
+    if (nextActions.length > 0) {
+        lines.push("", "Next actions:");
+        for (const action of nextActions) {
+            lines.push(`- ${action}`);
+        }
+    }
+    return lines.join("\n");
+}
+function renderRepairSummary(repair) {
+    const lines = ["LongTable doctor repair"];
+    if (repair.installedCodexSkills.length > 0) {
+        lines.push(`- installed Codex skills: ${repair.installedCodexSkills.length}`);
+    }
+    if (repair.installedClaudeSkills.length > 0) {
+        lines.push(`- installed Claude skills: ${repair.installedClaudeSkills.length}`);
+    }
+    if (repair.removedLegacyPromptFiles.length > 0) {
+        lines.push(`- removed legacy prompt files: ${repair.removedLegacyPromptFiles.length}`);
+    }
+    if (repair.writtenRuntimeConfigs.length > 0) {
+        lines.push("- wrote runtime configs:");
+        for (const target of repair.writtenRuntimeConfigs) {
+            lines.push(`  - ${target.provider}: ${target.path}`);
+        }
+    }
+    if (repair.skipped.length > 0) {
+        lines.push("- skipped:");
+        for (const item of repair.skipped) {
+            lines.push(`  - ${item}`);
+        }
+    }
+    if (lines.length === 1) {
+        lines.push("- no repairs needed");
+    }
+    return lines.join("\n");
+}
+async function repairDoctorStatus(args, status) {
+    const roles = listRoleDefinitions();
+    const codexDir = typeof args["codex-dir"] === "string"
+        ? args["codex-dir"]
+        : typeof args.dir === "string"
+            ? args.dir
+            : undefined;
+    const codexPromptsDir = typeof args["codex-prompts-dir"] === "string"
+        ? args["codex-prompts-dir"]
+        : typeof args["prompts-dir"] === "string"
+            ? args["prompts-dir"]
+            : typeof args.dir === "string"
+                ? args.dir
+                : undefined;
+    const claudeDir = typeof args["claude-dir"] === "string"
+        ? args["claude-dir"]
+        : typeof args.dir === "string"
+            ? args.dir
+            : undefined;
+    const setupOverride = typeof args.setup === "string"
+        ? args.setup
+        : typeof args.path === "string"
+            ? args.path
+            : undefined;
+    const codexRuntimeOverride = typeof args["codex-runtime-path"] === "string"
+        ? args["codex-runtime-path"]
+        : undefined;
+    const claudeRuntimeOverride = typeof args["claude-runtime-path"] === "string"
+        ? args["claude-runtime-path"]
+        : undefined;
+    const repair = {
+        installedCodexSkills: [],
+        installedClaudeSkills: [],
+        removedLegacyPromptFiles: [],
+        writtenRuntimeConfigs: [],
+        skipped: []
+    };
+    if (status.providers.codex.missingSkills.length > 0) {
+        repair.installedCodexSkills = (await installCodexSkills(roles, codexDir)).map((skill) => skill.name);
+    }
+    if (status.providers.claude.missingSkills.length > 0) {
+        repair.installedClaudeSkills = (await installClaudeSkills(roles, claudeDir)).map((skill) => skill.name);
+    }
+    if (status.providers.codex.legacyPromptFilesInstalled.length > 0) {
+        repair.removedLegacyPromptFiles = await removeCodexPromptAliases(codexPromptsDir);
+    }
+    if (!status.setupExists) {
+        repair.skipped.push("runtime configs require a researcher setup; run `longtable init --flow interview --provider codex` first");
+        return repair;
+    }
+    const setup = await loadSetupOutput(setupOverride);
+    if (!status.providers.codex.runtimeExists) {
+        const target = await writeRuntimeConfig(setupForProvider(setup, "codex"), status.setupPath, codexRuntimeOverride);
+        repair.writtenRuntimeConfigs.push({
+            provider: target.provider,
+            path: target.path,
+            format: target.format
+        });
+    }
+    if (!status.providers.claude.runtimeExists) {
+        const target = await writeRuntimeConfig(setupForProvider(setup, "claude"), status.setupPath, claudeRuntimeOverride);
+        repair.writtenRuntimeConfigs.push({
+            provider: target.provider,
+            path: target.path,
+            format: target.format
+        });
+    }
+    return repair;
+}
+async function runDoctor(args) {
+    const status = await collectDoctorStatus(args);
+    if (args.fix === true) {
+        const repair = await repairDoctorStatus(args, status);
+        const updatedStatus = await collectDoctorStatus(args);
+        if (args.json === true) {
+            console.log(JSON.stringify({ repair, status: updatedStatus }, null, 2));
+            return;
+        }
+        console.log(renderRepairSummary(repair));
+        console.log("");
+        console.log(renderDoctorStatus(updatedStatus));
+        return;
+    }
+    if (args.json === true) {
+        console.log(JSON.stringify(status, null, 2));
+        return;
+    }
+    console.log(renderDoctorStatus(status));
+}
 async function runCodexPersistInit(args) {
     const { flow, provider, answers } = await readPersistAnswers(args);
     const outputValue = createPersistedSetupOutput(answers, provider, flow);
@@ -742,11 +1083,16 @@ async function runCodexPersistInit(args) {
     if (provider === "codex" && args["install-prompts"] === true) {
         installedPrompts = await installCodexPromptAliases(typeof args.dir === "string" ? args.dir : undefined);
     }
+    let installedSkills = [];
+    if (provider === "codex" && args["install-skills"] === true) {
+        installedSkills = await installCodexSkills(listRoleDefinitions(), typeof args.dir === "string" ? args.dir : undefined);
+    }
     if (args.json === true) {
         console.log(JSON.stringify({
             setup: outputValue,
             install: result,
-            installedPrompts: installedPrompts.map((prompt) => prompt.name)
+            installedPrompts: installedPrompts.map((prompt) => prompt.name),
+            installedSkills: installedSkills.map((skill) => skill.name)
         }, null, 2));
         return;
     }
@@ -757,16 +1103,24 @@ async function runCodexPersistInit(args) {
         console.log("");
         console.log("Installed Codex prompt files:");
         for (const prompt of installedPrompts) {
-            console.log(`- /prompts:${prompt.name}`);
+            console.log(`- ${prompt.name}`);
+        }
+        console.log("  Note: prompt files are legacy and may not be exposed by your Codex build.");
+    }
+    if (installedSkills.length > 0) {
+        console.log("");
+        console.log("Installed Codex skill files:");
+        for (const skill of installedSkills) {
+            console.log(`- ${skill.name}`);
         }
-        console.log("  Note: whether Codex exposes these as slash commands depends on your Codex build.");
+        console.log("  Use these inside Codex by naming LongTable naturally, e.g. `lt panel: ...`.");
     }
     if (provider === "codex") {
         console.log("");
         console.log("Next step:");
         console.log("- Start here: `longtable start`.");
         console.log("- If you want a direct natural-language entry: `longtable ask --prompt \"...\"`.");
-        console.log("- Codex prompt files are available as an experimental integration, not the primary path.");
+        console.log("- Codex skills are the preferred native surface. Prompt files are legacy and may not expose slash commands.");
         console.log("- Suggested next action: create a project workspace and let LongTable interview the current session.");
     }
 }
@@ -828,6 +1182,20 @@ function inferModeFromPrompt(prompt) {
     }
     return "explore";
 }
+function parsePanelVisibility(value) {
+    if (value === "synthesis_only" ||
+        value === "show_on_conflict" ||
+        value === "always_visible") {
+        return value;
+    }
+    return undefined;
+}
+function parsePanelMode(value) {
+    if (value && VALID_MODES.has(value) && value !== "explore" && value !== "submit") {
+        return value;
+    }
+    return "review";
+}
 async function loadOptionalSetup(path) {
     try {
         return await loadSetupOutput(path);
@@ -864,6 +1232,10 @@ async function runModeCommand(mode, args) {
         throw new Error(`Invalid stage: ${stage}`);
     }
     const setup = await loadOptionalSetup(typeof args.setup === "string" ? args.setup : undefined);
+    const projectContext = await loadProjectContextFromDirectory(workingDirectory);
+    if (projectContext) {
+        await assertWorkspaceNotBlocked(projectContext);
+    }
     const projectAware = await buildProjectAwarePrompt(prompt, workingDirectory);
     const panelPreference = setup?.profileSeed.panelPreference;
     const panelRequested = args.panel === true ||
@@ -898,6 +1270,125 @@ async function runModeCommand(mode, args) {
     });
     exit(exitCode);
 }
+async function runPanelCommand(args) {
+    const workingDirectory = typeof args.cwd === "string" ? args.cwd : cwd();
+    const prompt = await resolvePrompt(typeof args.prompt === "string" ? args.prompt : undefined);
+    if (!prompt) {
+        throw new Error("A prompt is required.");
+    }
+    const setup = await loadOptionalSetup(typeof args.setup === "string" ? args.setup : undefined);
+    const existingContext = await loadProjectContextFromDirectory(workingDirectory);
+    if (existingContext) {
+        await assertWorkspaceNotBlocked(existingContext);
+    }
+    const projectAware = await buildProjectAwarePrompt(prompt, workingDirectory);
+    const provider = setup?.providerSelection.provider;
+    const visibility = parsePanelVisibility(typeof args.visibility === "string" ? args.visibility : undefined) ??
+        parsePanelVisibility(setup?.profileSeed.panelPreference) ??
+        "always_visible";
+    const mode = parsePanelMode(typeof args.mode === "string" ? args.mode : undefined);
+    const fallback = buildPanelFallback({
+        prompt: projectAware.prompt,
+        mode,
+        roleFlag: typeof args.role === "string" ? args.role : undefined,
+        provider,
+        visibility
+    });
+    if (projectAware.projectContextFound) {
+        const context = await loadProjectContextFromDirectory(workingDirectory);
+        if (context) {
+            await appendInvocationRecordToWorkspace(context, fallback.invocationRecord, [fallback.questionRecord]);
+        }
+    }
+    if (args.json === true) {
+        console.log(JSON.stringify({
+            intent: fallback.intent,
+            plan: fallback.plan,
+            result: fallback.result,
+            invocationRecord: fallback.invocationRecord,
+            questionRecord: fallback.questionRecord,
+            execution: {
+                status: "planned",
+                stableSurface: "sequential_fallback",
+                nativeParallel: "not_required_for_option_a",
+                projectContextFound: projectAware.projectContextFound,
+                invocationLogged: projectAware.projectContextFound
+            },
+            fallbackPrompt: fallback.prompt
+        }, null, 2));
+        return;
+    }
+    if (args.print === true) {
+        console.log(fallback.prompt);
+        return;
+    }
+    console.log(renderPanelSummary(fallback.plan));
+    console.log("");
+    const exitCode = await runCodexThinWrapper({
+        prompt: fallback.prompt,
+        mode,
+        setupPath: typeof args.setup === "string" ? args.setup : undefined,
+        workingDirectory,
+        json: false
+    });
+    exit(exitCode);
+}
+async function runQuestion(args) {
+    const workingDirectory = typeof args.cwd === "string" ? args.cwd : cwd();
+    const prompt = await resolvePrompt(typeof args.prompt === "string" ? args.prompt : undefined);
+    if (!prompt) {
+        throw new Error("A decision context is required. Pass --prompt <text>.");
+    }
+    const context = await loadProjectContextFromDirectory(workingDirectory);
+    if (!context) {
+        throw new Error("No LongTable project workspace was found here. Run this inside a project or pass --cwd.");
+    }
+    const provider = args.provider === "claude" ? "claude" : args.provider === "codex" ? "codex" : undefined;
+    const required = args.required === true ? true : args.advisory === true ? false : undefined;
+    const result = await createWorkspaceQuestion({
+        context,
+        prompt,
+        title: typeof args.title === "string" ? args.title : undefined,
+        question: typeof args.text === "string" ? args.text : undefined,
+        provider,
+        required
+    });
+    const transport = provider === "claude"
+        ? renderQuestionRecordInput(result.question)
+        : renderQuestionRecordPrompt(result.question);
+    if (args.json === true) {
+        console.log(JSON.stringify({
+            question: result.question,
+            transport,
+            files: {
+                state: context.stateFilePath,
+                current: context.currentFilePath
+            },
+            nextAction: `longtable decide --question ${result.question.id} --answer <value>`
+        }, null, 2));
+        return;
+    }
+    if (args.print === true) {
+        if (provider === "claude") {
+            console.log(JSON.stringify(transport, null, 2));
+        }
+        else {
+            console.log("prompt" in transport ? transport.prompt : JSON.stringify(transport, null, 2));
+        }
+        return;
+    }
+    const optionValues = [
+        ...result.question.prompt.options.map((option) => option.value),
+        ...(result.question.prompt.allowOther ? ["other"] : [])
+    ];
+    console.log(result.question.prompt.required ? "LongTable required Researcher Checkpoint recorded" : "LongTable advisory Researcher Checkpoint recorded");
+    console.log(`- question: ${result.question.id}`);
+    console.log(`- checkpoint: ${result.question.prompt.checkpointKey ?? "manual"}`);
+    console.log(`- prompt: ${result.question.prompt.question}`);
+    console.log(`- options: ${optionValues.join("/")}`);
+    console.log(`- answer: longtable decide --question ${result.question.id} --answer <value>`);
+    console.log(`- current: ${context.currentFilePath}`);
+}
 async function runAsk(args) {
     const prompt = await resolvePrompt(typeof args.prompt === "string" ? args.prompt : undefined);
     if (!prompt) {
@@ -907,7 +1398,7 @@ async function runAsk(args) {
     const effectivePrompt = directive.cleanedPrompt;
     const inferred = directive.mode ?? inferModeFromPrompt(effectivePrompt);
     if (inferred === "status") {
-        await runCodexSubcommand("status", args);
+        await runDoctor(args);
         return;
     }
     const mode = inferred === "panel" ? "review" : inferred;
@@ -918,18 +1409,60 @@ async function runAsk(args) {
     if (directive.roles.length > 0 && typeof delegatedArgs.role !== "string") {
         delegatedArgs.role = directive.roles.join(",");
     }
-    if ((inferred === "panel" || directive.panel) && delegatedArgs.panel !== true) {
-        delegatedArgs.panel = true;
-        delegatedArgs["show-conflicts"] = true;
+    if (inferred === "panel" || directive.panel || delegatedArgs.panel === true) {
+        await runPanelCommand({
+            ...delegatedArgs,
+            visibility: "always_visible"
+        });
+        return;
     }
     await runModeCommand(mode, delegatedArgs);
 }
+async function runDecide(args) {
+    const workingDirectory = typeof args.cwd === "string" ? args.cwd : cwd();
+    const answer = typeof args.answer === "string" ? args.answer.trim() : "";
+    if (!answer) {
+        throw new Error("A decision answer is required. Pass --answer <value-or-text>.");
+    }
+    const context = await loadProjectContextFromDirectory(workingDirectory);
+    if (!context) {
+        throw new Error("No LongTable project workspace was found here. Run this inside a project or pass --cwd.");
+    }
+    const provider = args.provider === "claude" ? "claude" : args.provider === "codex" ? "codex" : undefined;
+    const result = await answerWorkspaceQuestion({
+        context,
+        questionId: typeof args.question === "string" ? args.question : undefined,
+        answer,
+        rationale: typeof args.rationale === "string" ? args.rationale : undefined,
+        provider
+    });
+    if (args.json === true) {
+        console.log(JSON.stringify({
+            question: result.question,
+            decision: result.decision,
+            files: {
+                state: context.stateFilePath,
+                current: context.currentFilePath
+            }
+        }, null, 2));
+        return;
+    }
+    console.log("LongTable decision recorded");
+    console.log(`- question: ${result.question.id}`);
+    console.log(`- decision: ${result.decision.id}`);
+    console.log(`- answer: ${result.decision.selectedOption ?? answer}`);
+    console.log(`- state: ${context.stateFilePath}`);
+    console.log(`- current: ${context.currentFilePath}`);
+}
 async function runRoles(args) {
     const payload = PERSONA_DEFINITIONS.map((persona) => ({
         key: persona.key,
         label: persona.label,
         description: persona.shortDescription,
         triggerMode: persona.triggerMode,
+        defaultPanelMember: persona.defaultPanelMember,
+        checkpointSensitivity: persona.checkpointSensitivity,
+        supportedModes: persona.supportedModes,
         exampleTriggers: persona.synonyms.slice(0, 4)
     }));
     if (args.json === true) {
@@ -944,6 +1477,8 @@ async function runRoles(args) {
         console.log(`- ${persona.label} (${persona.key})`);
         console.log(`  ${persona.description}`);
         console.log(`  Trigger: ${persona.triggerMode === "auto-callable" ? "auto-callable when your language strongly implies it" : "explicit request only"}`);
+        console.log(`  Panel: ${persona.defaultPanelMember ? "default member" : "contextual member"}`);
+        console.log(`  Checkpoint sensitivity: ${persona.checkpointSensitivity}`);
         console.log(`  Examples: ${persona.exampleTriggers.join(", ")}`);
     }
 }
@@ -1027,12 +1562,28 @@ async function runResume(args) {
 }
 async function runCodexSubcommand(subcommand, args) {
     const customDir = typeof args.dir === "string" ? args.dir : undefined;
+    const roles = listRoleDefinitions();
+    if (subcommand === "install-skills") {
+        const installed = await installCodexSkills(roles, customDir);
+        console.log(`Installed ${installed.length} LongTable Codex skills in ${resolveCodexSkillsDir(customDir)}`);
+        console.log("Use them inside Codex with natural-language triggers such as `lt explore: ...` or `lt panel: ...`.");
+        console.log("If you want an explicit trigger, use `$longtable` when your Codex build exposes skills that way.");
+        for (const skill of installed) {
+            console.log(`- ${skill.name}`);
+        }
+        return;
+    }
+    if (subcommand === "remove-skills") {
+        const removed = await removeCodexSkills(roles, customDir);
+        console.log(`Removed ${removed.length} LongTable Codex skills from ${resolveCodexSkillsDir(customDir)}`);
+        return;
+    }
     if (subcommand === "install-prompts") {
         const installed = await installCodexPromptAliases(customDir);
-        console.log(`Installed ${installed.length} LongTable prompt aliases in ${resolveCodexPromptsDir(customDir)}`);
-        console.log("Note: prompt-file discovery depends on the Codex build. Treat this as an experimental integration.");
+        console.log(`Installed ${installed.length} legacy LongTable prompt files in ${resolveCodexPromptsDir(customDir)}`);
+        console.log("Note: current Codex builds may not expose these files as slash commands. Prefer `longtable codex install-skills`.");
         for (const prompt of installed) {
-            console.log(`- /prompts:${prompt.name}`);
+            console.log(`- ${prompt.name}`);
         }
         return;
     }
@@ -1042,11 +1593,12 @@ async function runCodexSubcommand(subcommand, args) {
     }
     if (subcommand === "remove-prompts") {
         const removed = await removeCodexPromptAliases(customDir);
-        console.log(`Removed ${removed.length} LongTable prompt aliases from ${resolveCodexPromptsDir(customDir)}`);
+        console.log(`Removed ${removed.length} legacy LongTable prompt files from ${resolveCodexPromptsDir(customDir)}`);
         return;
     }
     if (subcommand === "status") {
         const aliases = await listInstalledCodexPromptAliases(customDir);
+        const skills = await listInstalledCodexSkills(roles, customDir);
         const setupPath = resolveDefaultSetupPath(typeof args.path === "string" ? args.path : undefined).path;
         const runtimePath = resolveDefaultRuntimeConfigPath("codex", typeof args["runtime-path"] === "string" ? args["runtime-path"] : undefined).path;
         const status = {
@@ -1054,8 +1606,10 @@ async function runCodexSubcommand(subcommand, args) {
             setupExists: existsSync(setupPath),
             runtimePath,
             runtimeExists: existsSync(runtimePath),
+            skillsDir: resolveCodexSkillsDir(customDir),
+            skillsInstalled: skills.map((skill) => skill.name),
             promptsDir: resolveCodexPromptsDir(customDir),
-            promptAliasesInstalled: aliases.map((alias) => alias.name)
+            legacyPromptFilesInstalled: aliases.map((alias) => alias.name)
         };
         if (args.json === true) {
             console.log(JSON.stringify(status, null, 2));
@@ -1064,21 +1618,81 @@ async function runCodexSubcommand(subcommand, args) {
         console.log("LongTable Codex status");
         console.log(`- setup: ${status.setupExists ? "present" : "missing"} (${setupPath})`);
         console.log(`- codex runtime artifact: ${status.runtimeExists ? "present" : "missing"} (${runtimePath})`);
+        console.log(`- skills dir: ${status.skillsDir}`);
+        if (skills.length === 0) {
+            console.log("- skills: none");
+        }
+        else {
+            console.log("- skills:");
+            for (const skill of skills) {
+                console.log(`  - ${skill.name}`);
+            }
+        }
         console.log(`- prompt aliases dir: ${status.promptsDir}`);
-        console.log("- prompt-file integration: experimental (your Codex build may not expose these as slash commands)");
+        console.log("- prompt files: legacy; current Codex builds may not expose these as slash commands");
         if (aliases.length === 0) {
-            console.log("- prompt aliases: none");
+            console.log("- legacy prompt files: none");
         }
         else {
-            console.log("- prompt aliases:");
+            console.log("- legacy prompt files:");
             for (const alias of aliases) {
-                console.log(`  - /prompts:${alias.name}`);
+                console.log(`  - ${alias.name}`);
             }
         }
         return;
     }
     throw new Error("Unknown codex subcommand.");
 }
+async function runClaudeSubcommand(subcommand, args) {
+    const customDir = typeof args.dir === "string" ? args.dir : undefined;
+    const roles = listRoleDefinitions();
+    if (subcommand === "install-skills") {
+        const installed = await installClaudeSkills(roles, customDir);
+        console.log(`Installed ${installed.length} LongTable Claude skills in ${resolveClaudeSkillsDir(customDir)}`);
+        console.log("Use them inside Claude Code with natural-language triggers such as `lt explore: ...` or `lt panel: ...`.");
+        for (const skill of installed) {
+            console.log(`- ${skill.name}`);
+        }
+        return;
+    }
+    if (subcommand === "remove-skills") {
+        const removed = await removeClaudeSkills(roles, customDir);
+        console.log(`Removed ${removed.length} LongTable Claude skills from ${resolveClaudeSkillsDir(customDir)}`);
+        return;
+    }
+    if (subcommand === "status") {
+        const skills = await listInstalledClaudeSkills(roles, customDir);
+        const setupPath = resolveDefaultSetupPath(typeof args.path === "string" ? args.path : undefined).path;
+        const runtimePath = resolveDefaultRuntimeConfigPath("claude", typeof args["runtime-path"] === "string" ? args["runtime-path"] : undefined).path;
+        const status = {
+            setupPath,
+            setupExists: existsSync(setupPath),
+            runtimePath,
+            runtimeExists: existsSync(runtimePath),
+            skillsDir: resolveClaudeSkillsDir(customDir),
+            skillsInstalled: skills.map((skill) => skill.name)
+        };
+        if (args.json === true) {
+            console.log(JSON.stringify(status, null, 2));
+            return;
+        }
+        console.log("LongTable Claude status");
+        console.log(`- setup: ${status.setupExists ? "present" : "missing"} (${setupPath})`);
+        console.log(`- claude runtime artifact: ${status.runtimeExists ? "present" : "missing"} (${runtimePath})`);
+        console.log(`- skills dir: ${status.skillsDir}`);
+        if (skills.length === 0) {
+            console.log("- skills: none");
+        }
+        else {
+            console.log("- skills:");
+            for (const skill of skills) {
+                console.log(`  - ${skill.name}`);
+            }
+        }
+        return;
+    }
+    throw new Error("Unknown claude subcommand.");
+}
 async function main() {
     const parsed = parseArgs(process.argv.slice(2));
     const { command, subcommand, values } = parsed;
@@ -1098,6 +1712,10 @@ async function main() {
         await runResume(values);
         return;
     }
+    if (command === "doctor" || command === "status") {
+        await runDoctor(values);
+        return;
+    }
     if (command === "roles") {
         await runRoles(values);
         return;
@@ -1114,11 +1732,34 @@ async function main() {
         await runAsk(values);
         return;
     }
+    if (command === "question") {
+        await runQuestion(values);
+        return;
+    }
+    if (command === "panel") {
+        await runPanelCommand(values);
+        return;
+    }
+    if (command === "decide") {
+        await runDecide(values);
+        return;
+    }
     if (command === "codex") {
         await runCodexSubcommand(subcommand, values);
         return;
     }
+    if (command === "claude") {
+        await runClaudeSubcommand(subcommand, values);
+        return;
+    }
     if (VALID_MODES.has(command)) {
+        if (values.panel === true) {
+            await runPanelCommand({
+                ...values,
+                mode: command
+            });
+            return;
+        }
         await runModeCommand(command, values);
         return;
     }