@longtable/provider-claude 0.1.38 → 0.1.40

package/dist/skills.d.ts

@@ -10,8 +10,9 @@ export interface InstalledClaudeSkill {
     path: string;
     description: string;
 }
+export type LongTableSkillSurface = "compact" | "full";
 export declare function resolveClaudeSkillsDir(customDir?: string): string;
-export declare function buildClaudeSkillSpecs(roles: RoleDefinition[]): ClaudeSkillSpec[];
-export declare function installClaudeSkills(roles: RoleDefinition[], customDir?: string): Promise<InstalledClaudeSkill[]>;
+export declare function buildClaudeSkillSpecs(roles: RoleDefinition[], surface?: LongTableSkillSurface): ClaudeSkillSpec[];
+export declare function installClaudeSkills(roles: RoleDefinition[], customDir?: string, surface?: LongTableSkillSurface): Promise<InstalledClaudeSkill[]>;
 export declare function removeClaudeSkills(roles: RoleDefinition[], customDir?: string): Promise<string[]>;
-export declare function listInstalledClaudeSkills(roles: RoleDefinition[], customDir?: string): Promise<InstalledClaudeSkill[]>;
+export declare function listInstalledClaudeSkills(roles: RoleDefinition[], customDir?: string, surface?: LongTableSkillSurface): Promise<InstalledClaudeSkill[]>;

package/dist/skills.js

@@ -2,10 +2,20 @@ import { existsSync } from "node:fs";
 import { mkdir, readdir, rm, writeFile } from "node:fs/promises";
 import { homedir } from "node:os";
 import { join, resolve } from "node:path";
+const COMPACT_ROLE_SKILL_NAMES = {
+    methods_critic: "longtable-methods",
+    measurement_auditor: "longtable-measure",
+    theory_critic: "longtable-theory",
+    reviewer: "longtable-reviewer",
+    voice_keeper: "longtable-voice"
+};
 export function resolveClaudeSkillsDir(customDir) {
     return customDir ? resolve(customDir) : join(homedir(), ".claude", "skills");
 }
-function skillNameForRole(role) {
+function skillNameForRole(role, surface) {
+    if (surface === "compact" && COMPACT_ROLE_SKILL_NAMES[role.key]) {
+        return COMPACT_ROLE_SKILL_NAMES[role.key];
+    }
     return `longtable-${role.key.replaceAll("_", "-")}`;
 }
 function yamlString(value) {
@@ -25,8 +35,8 @@ function renderSkillFile(spec) {
         ...spec.body
     ].join("\n");
 }
-function baseSkillSpecs() {
-    return [
+function baseSkillSpecs(surface = "compact") {
+    const specs = [
         {
             name: "longtable",
             description: "Use for LongTable research conversations, project memory, checkpointing, and role routing.",
@@ -46,11 +56,13 @@ function baseSkillSpecs() {
                 "- `lt panel: ...`",
                 "- `longtable: deploy a research team to review this measurement plan, show the main disagreements, and ask me what decision should be recorded before you revise it.`",
                 "- `longtable: use editor, reviewer, methods, measurement, and voice perspectives to evaluate this manuscript section. Do not collapse disagreement too early.`",
+                "- `$longtable-methods`, `$longtable-measure`, `$longtable-theory`, `$longtable-reviewer`, or `$longtable-voice` when the researcher explicitly wants that shortcut.",
                 "- `$longtable-interview` to create or continue the first research-start interview.",
                 "",
                 "## Rules",
                 "",
                 "- 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.",
                 "- If a Researcher Checkpoint is needed, ask a short structured question with meaningful options and wait for the researcher.",
@@ -188,6 +200,9 @@ function baseSkillSpecs() {
             ]
         }
     ];
+    return surface === "full"
+        ? specs
+        : specs.filter((spec) => spec.name === "longtable" || spec.name === "longtable-interview");
 }
 function mustAskQuestionsForRole(role) {
     const common = [
@@ -222,10 +237,10 @@ function mustAskQuestionsForRole(role) {
     };
     return [...(byRole[role.key] ?? []), ...common];
 }
-function roleSkillSpec(role) {
+function roleSkillSpec(role, surface = "compact") {
     const label = role.label;
     return {
-        name: skillNameForRole(role),
+        name: skillNameForRole(role, surface),
         description: `Use the LongTable ${label} role: ${role.shortDescription}`,
         triggers: [
             ...role.synonyms.slice(0, 8),
@@ -273,14 +288,32 @@ function roleSkillSpec(role) {
         ]
     };
 }
-export function buildClaudeSkillSpecs(roles) {
-    return [...baseSkillSpecs(), ...roles.map(roleSkillSpec)];
+function compactRoles(roles) {
+    return roles.filter((role) => Object.hasOwn(COMPACT_ROLE_SKILL_NAMES, role.key));
+}
+function allClaudeSkillSpecs(roles) {
+    const byName = new Map();
+    for (const spec of [...buildClaudeSkillSpecs(roles, "compact"), ...buildClaudeSkillSpecs(roles, "full")]) {
+        byName.set(spec.name, spec);
+    }
+    return [...byName.values()];
 }
-export async function installClaudeSkills(roles, customDir) {
+export function buildClaudeSkillSpecs(roles, surface = "compact") {
+    const roleSpecs = (surface === "compact" ? compactRoles(roles) : roles).map((role) => roleSkillSpec(role, surface));
+    return [...baseSkillSpecs(surface), ...roleSpecs];
+}
+export async function installClaudeSkills(roles, customDir, surface = "compact") {
     const skillsDir = resolveClaudeSkillsDir(customDir);
     await mkdir(skillsDir, { recursive: true });
+    const specs = buildClaudeSkillSpecs(roles, surface);
+    const selectedNames = new Set(specs.map((spec) => spec.name));
+    for (const spec of allClaudeSkillSpecs(roles)) {
+        if (!selectedNames.has(spec.name)) {
+            await rm(join(skillsDir, spec.name), { recursive: true, force: true });
+        }
+    }
     const installed = [];
-    for (const spec of buildClaudeSkillSpecs(roles)) {
+    for (const spec of specs) {
         const skillDir = join(skillsDir, spec.name);
         await mkdir(skillDir, { recursive: true });
         const path = join(skillDir, "SKILL.md");
@@ -296,7 +329,7 @@ export async function installClaudeSkills(roles, customDir) {
 export async function removeClaudeSkills(roles, customDir) {
     const skillsDir = resolveClaudeSkillsDir(customDir);
     const removed = [];
-    for (const spec of buildClaudeSkillSpecs(roles)) {
+    for (const spec of allClaudeSkillSpecs(roles)) {
         const skillDir = join(skillsDir, spec.name);
         if (existsSync(skillDir)) {
             await rm(skillDir, { recursive: true, force: true });
@@ -305,13 +338,13 @@ export async function removeClaudeSkills(roles, customDir) {
     }
     return removed;
 }
-export async function listInstalledClaudeSkills(roles, customDir) {
+export async function listInstalledClaudeSkills(roles, customDir, surface = "compact") {
     const skillsDir = resolveClaudeSkillsDir(customDir);
     if (!existsSync(skillsDir)) {
         return [];
     }
     const entries = new Set(await readdir(skillsDir));
-    return buildClaudeSkillSpecs(roles)
+    return buildClaudeSkillSpecs(roles, surface)
         .filter((spec) => entries.has(spec.name) && existsSync(join(skillsDir, spec.name, "SKILL.md")))
         .map((spec) => ({
         name: spec.name,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@longtable/provider-claude",
-  "version": "0.1.38",
+  "version": "0.1.40",
   "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.38",
-    "@longtable/core": "0.1.38",
-    "@longtable/setup": "0.1.38"
+    "@longtable/checkpoints": "0.1.40",
+    "@longtable/core": "0.1.40",
+    "@longtable/setup": "0.1.40"
   },
   "devDependencies": {
     "typescript": "^5.6.0"