@longtable/cli 0.1.38 → 0.1.39

package/README.md

@@ -156,16 +156,21 @@ longtable codex install-skills
 longtable claude install-skills
 ```
 
-Codex skills include `longtable`, `longtable-panel`, and generated role-specific
-skills such as `longtable-methods-critic`. If your Codex build exposes explicit
-skill shortcuts, `$longtable-interview` is the research-start entry and
-`$longtable` is the general router. Do not depend on `/prompts`; current Codex
-builds may reject it.
-
-Claude Code skills include `longtable`, `longtable-panel`, and generated
-role-specific skills such as `longtable-methods-critic`. They also include
-`longtable-interview` for the First Research Shape workflow. They are adapter
-files generated from the LongTable role registry.
+By default, provider skills use the compact surface: `longtable`,
+`longtable-interview`, and five short role shortcuts: `longtable-methods`,
+`longtable-measure`, `longtable-theory`, `longtable-reviewer`, and
+`longtable-voice`. `$longtable` remains the general router and can still invoke
+editor, ethics, venue, panel, explore, or review behavior when the request calls
+for it.
+
+Power users can install the legacy full surface explicitly:
+
+```bash
+longtable codex install-skills --surface full
+longtable claude install-skills --surface full
+```
+
+Do not depend on `/prompts`; current Codex builds may reject it.
 
 ## Panel Orchestration
 

package/dist/cli.js

@@ -17,7 +17,7 @@ import { buildPersonaGuidance, parseInvocationDirective } from "./persona-router
 import { PERSONA_DEFINITIONS, listRoleDefinitions } from "./personas.js";
 import { buildPanelFallback, renderPanelSummary } from "./panel.js";
 import { LONGTABLE_MANAGED_HOOK_EVENTS, codexHooksEnabled, enableCodexHooksFeature, getMissingManagedCodexHookEvents, mergeManagedCodexHooksConfig, removeManagedCodexHooks } from "./codex-hooks.js";
-import { appendInvocationRecordToWorkspace, assertWorkspaceNotBlocked, answerWorkspaceQuestion, buildQuestionOpportunitySpecs, clearWorkspaceQuestion, createWorkspaceFollowUpQuestions, createWorkspaceQuestion, createOrUpdateProjectWorkspace, inspectProjectWorkspace, loadWorkspaceState, loadProjectContextFromDirectory, repairWorkspaceStateConsistency, renderProjectWorkspaceSummary, syncCurrentWorkspaceView } from "./project-session.js";
+import { appendInvocationRecordToWorkspace, assertWorkspaceNotBlocked, answerWorkspaceQuestion, buildQuestionOpportunitySpecs, clearWorkspaceQuestion, createWorkspaceFollowUpQuestions, createWorkspaceQuestion, createOrUpdateProjectWorkspace, inspectProjectWorkspace, loadWorkspaceState, loadProjectContextFromDirectory, pruneWorkspaceQuestions, repairWorkspaceStateConsistency, renderProjectWorkspaceSummary, syncCurrentWorkspaceView } from "./project-session.js";
 import { buildTeamDebate, buildTeamReview, renderTeamDebateSummary } from "./debate.js";
 import { createPromptRenderer } from "./prompt-renderer.js";
 const VALID_MODES = new Set([
@@ -45,7 +45,7 @@ const ANSI = {
     green: "\u001B[32m"
 };
 const LONGTABLE_MCP_SERVER_NAME = "longtable-state";
-const LONGTABLE_MCP_PACKAGE_VERSION = "0.1.38";
+const LONGTABLE_MCP_PACKAGE_VERSION = "0.1.39";
 const LONGTABLE_MCP_MARKER_START = "# LongTable state MCP START";
 const LONGTABLE_MCP_MARKER_END = "# LongTable state MCP END";
 function style(text, prefix) {
@@ -120,16 +120,17 @@ function usage() {
         "  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-skills] [--install-prompts] [--json]",
-        "  longtable codex install-skills [--dir <path>]",
+        "  longtable codex install-skills [--surface compact|full] [--dir <path>]",
         "  longtable codex remove-skills [--dir <path>]",
         "  longtable codex install-prompts [--dir <path>]",
         "  longtable codex remove-prompts [--dir <path>]",
         "  longtable codex install-hooks [--codex-config <path>] [--hooks-path <path>] [--json]",
         "  longtable codex remove-hooks [--codex-config <path>] [--hooks-path <path>] [--json]",
-        "  longtable codex status [--dir <path>] [--codex-config <path>] [--hooks-path <path>] [--json]",
-        "  longtable claude install-skills [--dir <path>]",
+        "  longtable codex status [--surface compact|full] [--dir <path>] [--codex-config <path>] [--hooks-path <path>] [--json]",
+        "  longtable claude install-skills [--surface compact|full] [--dir <path>]",
         "  longtable claude remove-skills [--dir <path>]",
-        "  longtable claude status [--dir <path>] [--json]",
+        "  longtable claude status [--surface compact|full] [--dir <path>] [--json]",
+        "  longtable prune-questions [--cwd <path>] [--dry-run] [--json]",
         "  longtable mcp install --provider all",
         "",
         "Examples:",
@@ -150,7 +151,7 @@ function parseArgs(argv) {
     const values = {};
     let subcommand = maybeSubcommand;
     const modeCommand = command && VALID_MODES.has(command);
-    const directCommand = command && ["init", "setup", "start", "resume", "doctor", "status", "audit", "roles", "show", "install", "mcp", "codex", "claude", "ask", "clarify", "question", "clear-question", "panel", "decide", "sentinel", "team", "search"].includes(command);
+    const directCommand = command && ["init", "setup", "start", "resume", "doctor", "status", "audit", "roles", "show", "install", "mcp", "codex", "claude", "ask", "clarify", "question", "clear-question", "prune-questions", "panel", "decide", "sentinel", "team", "search"].includes(command);
     let startIndex = 1;
     if (modeCommand) {
         subcommand = undefined;
@@ -238,6 +239,16 @@ function questionSection(questionId) {
 function formatModeLabel(mode) {
     return `${mode[0].toUpperCase()}${mode.slice(1)}`;
 }
+function parseSkillSurface(args) {
+    const value = args.surface;
+    if (value === undefined || value === true) {
+        return "compact";
+    }
+    if (value === "compact" || value === "full") {
+        return value;
+    }
+    throw new Error("Invalid --surface value. Use compact or full.");
+}
 function stripWrappingQuotes(value) {
     const trimmed = value.trim();
     if ((trimmed.startsWith("\"") && trimmed.endsWith("\"")) ||
@@ -1416,6 +1427,7 @@ function setupForProvider(setup, provider) {
 }
 async function collectDoctorStatus(args) {
     const roles = listRoleDefinitions();
+    const skillSurface = parseSkillSurface(args);
     const setupOverride = typeof args.setup === "string"
         ? args.setup
         : typeof args.path === "string"
@@ -1458,11 +1470,11 @@ async function collectDoctorStatus(args) {
     const missingManagedHookEvents = codexHooksContent
         ? (getMissingManagedCodexHookEvents(codexHooksContent) ?? [...LONGTABLE_MANAGED_HOOK_EVENTS])
         : [...LONGTABLE_MANAGED_HOOK_EVENTS];
-    const expectedCodexSkills = buildCodexSkillSpecs(roles).map((skill) => skill.name);
-    const expectedClaudeSkills = buildClaudeSkillSpecs(roles).map((skill) => skill.name);
+    const expectedCodexSkills = buildCodexSkillSpecs(roles, skillSurface).map((skill) => skill.name);
+    const expectedClaudeSkills = buildClaudeSkillSpecs(roles, skillSurface).map((skill) => skill.name);
     const [codexSkills, claudeSkills, codexAliases, workspace] = await Promise.all([
-        listInstalledCodexSkills(roles, codexDir),
-        listInstalledClaudeSkills(roles, claudeDir),
+        listInstalledCodexSkills(roles, codexDir, skillSurface),
+        listInstalledClaudeSkills(roles, claudeDir, skillSurface),
         listInstalledCodexPromptAliases(codexPromptsDir),
         inspectProjectWorkspace(typeof args.cwd === "string" ? args.cwd : cwd())
     ]);
@@ -1646,6 +1658,7 @@ function renderRepairSummary(repair) {
 }
 async function repairDoctorStatus(args, status) {
     const roles = listRoleDefinitions();
+    const skillSurface = parseSkillSurface(args);
     const codexDir = typeof args["codex-dir"] === "string"
         ? args["codex-dir"]
         : typeof args.dir === "string"
@@ -1684,10 +1697,10 @@ async function repairDoctorStatus(args, status) {
         skipped: []
     };
     if (status.providers.codex.missingSkills.length > 0) {
-        repair.installedCodexSkills = (await installCodexSkills(roles, codexDir)).map((skill) => skill.name);
+        repair.installedCodexSkills = (await installCodexSkills(roles, codexDir, skillSurface)).map((skill) => skill.name);
     }
     if (status.providers.claude.missingSkills.length > 0) {
-        repair.installedClaudeSkills = (await installClaudeSkills(roles, claudeDir)).map((skill) => skill.name);
+        repair.installedClaudeSkills = (await installClaudeSkills(roles, claudeDir, skillSurface)).map((skill) => skill.name);
     }
     if (status.providers.codex.legacyPromptFilesInstalled.length > 0) {
         repair.removedLegacyPromptFiles = await removeCodexPromptAliases(codexPromptsDir);
@@ -1851,10 +1864,10 @@ function runRoleAudit() {
         "longtable-review"
     ]);
     const roles = [
-        ...buildCodexSkillSpecs(listRoleDefinitions())
+        ...buildCodexSkillSpecs(listRoleDefinitions(), "full")
             .filter((spec) => !baseSkillNames.has(spec.name))
             .map((spec) => buildRoleAuditEntry("codex", spec)),
-        ...buildClaudeSkillSpecs(listRoleDefinitions())
+        ...buildClaudeSkillSpecs(listRoleDefinitions(), "full")
             .filter((spec) => !baseSkillNames.has(spec.name))
             .map((spec) => buildRoleAuditEntry("claude", spec))
     ];
@@ -2671,6 +2684,41 @@ async function runClearQuestion(args) {
     console.log(`- state: ${context.stateFilePath}`);
     console.log(`- current: ${context.currentFilePath}`);
 }
+async function runPruneQuestions(args) {
+    const workingDirectory = typeof args.cwd === "string" ? args.cwd : cwd();
+    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 dryRun = args["dry-run"] === true;
+    const result = await pruneWorkspaceQuestions({
+        context,
+        dryRun
+    });
+    if (args.json === true) {
+        console.log(JSON.stringify({
+            dryRun,
+            removedCount: result.removedQuestions.length,
+            removedQuestions: result.removedQuestions.map((question) => ({
+                id: question.id,
+                title: question.prompt.title,
+                reason: question.clearedReason
+            })),
+            files: {
+                state: context.stateFilePath,
+                current: context.currentFilePath
+            }
+        }, null, 2));
+        return;
+    }
+    console.log(dryRun ? "LongTable question prune preview" : "LongTable questions pruned");
+    console.log(`- removed false-positive cleared questions: ${result.removedQuestions.length}`);
+    for (const question of result.removedQuestions) {
+        console.log(`  - ${question.id}: ${question.prompt.title}`);
+    }
+    console.log(`- state: ${context.stateFilePath}`);
+    console.log(`- current: ${context.currentFilePath}`);
+}
 function isInteractiveTerminal() {
     return Boolean(input.isTTY && output.isTTY);
 }
@@ -3241,11 +3289,12 @@ async function runResume(args) {
 async function runCodexSubcommand(subcommand, args) {
     const customDir = typeof args.dir === "string" ? args.dir : undefined;
     const roles = listRoleDefinitions();
+    const skillSurface = parseSkillSurface(args);
     if (subcommand === "install-skills") {
-        const installed = await installCodexSkills(roles, customDir);
-        console.log(`Installed ${installed.length} LongTable Codex skills in ${resolveCodexSkillsDir(customDir)}`);
+        const installed = await installCodexSkills(roles, customDir, skillSurface);
+        console.log(`Installed ${installed.length} LongTable Codex skills in ${resolveCodexSkillsDir(customDir)} (${skillSurface} surface)`);
         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.");
+        console.log("Use `$longtable` as the general router; compact installs expose only the most common role shortcuts.");
         for (const skill of installed) {
             console.log(`- ${skill.name}`);
         }
@@ -3295,7 +3344,7 @@ async function runCodexSubcommand(subcommand, args) {
     }
     if (subcommand === "status") {
         const aliases = await listInstalledCodexPromptAliases(customDir);
-        const skills = await listInstalledCodexSkills(roles, customDir);
+        const skills = await listInstalledCodexSkills(roles, customDir, skillSurface);
         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 configPath = resolveCodexMcpConfigPath(args);
@@ -3308,6 +3357,7 @@ async function runCodexSubcommand(subcommand, args) {
             runtimePath,
             runtimeExists: existsSync(runtimePath),
             skillsDir: resolveCodexSkillsDir(customDir),
+            skillSurface,
             skillsInstalled: skills.map((skill) => skill.name),
             promptsDir: resolveCodexPromptsDir(customDir),
             legacyPromptFilesInstalled: aliases.map((alias) => alias.name),
@@ -3327,6 +3377,7 @@ async function runCodexSubcommand(subcommand, args) {
         console.log(`- setup: ${status.setupExists ? "present" : "missing"} (${setupPath})`);
         console.log(`- codex runtime artifact: ${status.runtimeExists ? "present" : "missing"} (${runtimePath})`);
         console.log(`- skills dir: ${status.skillsDir}`);
+        console.log(`- skill surface: ${status.skillSurface}`);
         if (skills.length === 0) {
             console.log("- skills: none");
         }
@@ -3358,9 +3409,10 @@ async function runCodexSubcommand(subcommand, args) {
 async function runClaudeSubcommand(subcommand, args) {
     const customDir = typeof args.dir === "string" ? args.dir : undefined;
     const roles = listRoleDefinitions();
+    const skillSurface = parseSkillSurface(args);
     if (subcommand === "install-skills") {
-        const installed = await installClaudeSkills(roles, customDir);
-        console.log(`Installed ${installed.length} LongTable Claude skills in ${resolveClaudeSkillsDir(customDir)}`);
+        const installed = await installClaudeSkills(roles, customDir, skillSurface);
+        console.log(`Installed ${installed.length} LongTable Claude skills in ${resolveClaudeSkillsDir(customDir)} (${skillSurface} surface)`);
         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}`);
@@ -3373,7 +3425,7 @@ async function runClaudeSubcommand(subcommand, args) {
         return;
     }
     if (subcommand === "status") {
-        const skills = await listInstalledClaudeSkills(roles, customDir);
+        const skills = await listInstalledClaudeSkills(roles, customDir, skillSurface);
         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 = {
@@ -3382,6 +3434,7 @@ async function runClaudeSubcommand(subcommand, args) {
             runtimePath,
             runtimeExists: existsSync(runtimePath),
             skillsDir: resolveClaudeSkillsDir(customDir),
+            skillSurface,
             skillsInstalled: skills.map((skill) => skill.name)
         };
         if (args.json === true) {
@@ -3392,6 +3445,7 @@ async function runClaudeSubcommand(subcommand, args) {
         console.log(`- setup: ${status.setupExists ? "present" : "missing"} (${setupPath})`);
         console.log(`- claude runtime artifact: ${status.runtimeExists ? "present" : "missing"} (${runtimePath})`);
         console.log(`- skills dir: ${status.skillsDir}`);
+        console.log(`- skill surface: ${status.skillSurface}`);
         if (skills.length === 0) {
             console.log("- skills: none");
         }
@@ -3472,6 +3526,10 @@ async function main() {
         await runClearQuestion(values);
         return;
     }
+    if (command === "prune-questions") {
+        await runPruneQuestions(values);
+        return;
+    }
     if (command === "panel") {
         await runPanelCommand(values);
         return;

package/dist/longtable-codex-native-hook.js

@@ -110,35 +110,16 @@ function looksLikeClosurePrompt(prompt) {
     return /\b(final|finalize|commit|ship|submit|revise|rewrite|draft|publish|implement|fix)\b/i.test(normalized)
         || /최종|확정|커밋|제출|수정|초안|구현|진행|고쳐/.test(normalized);
 }
-function looksLikeExecutionDirective(prompt) {
-    const normalized = prompt.trim();
-    if (!normalized) {
-        return false;
-    }
-    return /\b(proceed|implement|fix|publish|release|deploy|tag|push|ship)\b/i.test(normalized)
-        || /진행|구현|수정|고쳐|배포|릴리즈|태그|푸시|출시/.test(normalized);
-}
 function looksLikeLongTableEngineeringPrompt(prompt) {
     const normalized = prompt.trim();
     if (!normalized) {
         return false;
     }
-    return /\b(longtable|hook|checkpoint|mcp|agent|npm|version|global|publish|release|deploy|git)\b/i.test(normalized)
-        || /롱테이블|훅|체크포인트|에이전트|글로벌|배포|버전|릴리즈|깃|깃허브/.test(normalized);
-}
-function looksLikeDiagnosticOrExplanatoryPrompt(prompt) {
-    const normalized = prompt.trim();
-    if (!normalized) {
-        return false;
-    }
-    return /\b(explain|why|how|diagnos(?:e|is)|debug|inspect|check|verify|status|simulate|simulation|test|logs?)\b/i.test(normalized)
-        || /설명|왜|어떻게|진단|디버그|확인|점검|상태|시뮬레이션|테스트|로그|불필요/.test(normalized);
+    return /\b(longtable|hook|checkpoint|mcp|agent|skill|skills|ux|interface|setup|install|cli|npm|version|global|publish|release|deploy|git)\b/i.test(normalized)
+        || /롱테이블|훅|체크포인트|에이전트|스킬|사용성|인터페이스|설치|세팅|글로벌|배포|버전|릴리즈|깃|깃허브/.test(normalized);
 }
 function shouldAutoCreateQuestionsForPrompt(prompt) {
-    if (!looksLikeLongTableEngineeringPrompt(prompt)) {
-        return true;
-    }
-    return !looksLikeExecutionDirective(prompt) && !looksLikeDiagnosticOrExplanatoryPrompt(prompt);
+    return !looksLikeLongTableEngineeringPrompt(prompt);
 }
 function shouldApplyProtectedDecisionClosure(runtime, prompt) {
     return Boolean(runtime.context.session.protectedDecision) &&

package/dist/project-session.d.ts

@@ -277,6 +277,13 @@ export declare function clearWorkspaceQuestion(options: {
     question: QuestionRecord;
     state: ResearchState;
 }>;
+export declare function pruneWorkspaceQuestions(options: {
+    context: LongTableProjectContext;
+    dryRun?: boolean;
+}): Promise<{
+    removedQuestions: QuestionRecord[];
+    state: ResearchState;
+}>;
 export declare function repairWorkspaceStateConsistency(options: {
     context: LongTableProjectContext;
 }): Promise<{

package/dist/project-session.js

@@ -1513,6 +1513,53 @@ export async function clearWorkspaceQuestion(options) {
         state: updated
     };
 }
+function isPrunableFalsePositiveQuestion(record) {
+    if (record.status !== "cleared") {
+        return false;
+    }
+    return /false-positive|duplicated automatic hook/i.test(record.clearedReason ?? "");
+}
+export async function pruneWorkspaceQuestions(options) {
+    const state = await loadResearchState(options.context.stateFilePath);
+    const removedQuestions = (state.questionLog ?? []).filter(isPrunableFalsePositiveQuestion);
+    if (removedQuestions.length === 0 || options.dryRun) {
+        return {
+            removedQuestions,
+            state
+        };
+    }
+    const removedIds = new Set(removedQuestions.map((question) => question.id));
+    const updated = {
+        ...state,
+        questionLog: (state.questionLog ?? []).filter((question) => !removedIds.has(question.id)),
+        questionObligations: (state.questionObligations ?? []).filter((obligation) => !obligation.questionId || !removedIds.has(obligation.questionId)),
+        invocationLog: (state.invocationLog ?? []).map((record) => ({
+            ...record,
+            ...(record.panelResult
+                ? {
+                    panelResult: {
+                        ...record.panelResult,
+                        linkedQuestionRecordIds: record.panelResult.linkedQuestionRecordIds.filter((id) => !removedIds.has(id))
+                    }
+                }
+                : {}),
+            ...(record.teamDebateRun
+                ? {
+                    teamDebateRun: {
+                        ...record.teamDebateRun,
+                        linkedQuestionRecordIds: record.teamDebateRun.linkedQuestionRecordIds.filter((id) => !removedIds.has(id))
+                    }
+                }
+                : {})
+        }))
+    };
+    await writeFile(options.context.stateFilePath, JSON.stringify(updated, null, 2), "utf8");
+    await syncCurrentWorkspaceView(options.context);
+    return {
+        removedQuestions,
+        state: updated
+    };
+}
 export async function repairWorkspaceStateConsistency(options) {
     const state = await loadResearchState(options.context.stateFilePath);
     const repaired = [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@longtable/cli",
-  "version": "0.1.38",
+  "version": "0.1.39",
   "private": false,
   "description": "Researcher-facing LongTable CLI",
   "type": "module",
@@ -29,12 +29,12 @@
   },
   "dependencies": {
     "@clack/prompts": "^1.2.0",
-    "@longtable/checkpoints": "0.1.38",
-    "@longtable/core": "0.1.38",
-    "@longtable/memory": "0.1.38",
-    "@longtable/provider-claude": "0.1.38",
-    "@longtable/provider-codex": "0.1.38",
-    "@longtable/setup": "0.1.38"
+    "@longtable/checkpoints": "0.1.39",
+    "@longtable/core": "0.1.39",
+    "@longtable/memory": "0.1.39",
+    "@longtable/provider-claude": "0.1.39",
+    "@longtable/provider-codex": "0.1.39",
+    "@longtable/setup": "0.1.39"
   },
   "devDependencies": {
     "@types/node": "^22.10.1",