@longtable/provider-claude 0.1.9

package/README.md

@@ -0,0 +1,11 @@
+# @longtable/provider-claude
+
+Claude-specific adapter logic for LongTable.
+
+This package does not define the product contract. It implements the Claude-facing surface after the contract is fixed in `@longtable/core`, `@longtable/checkpoints`, and `@longtable/setup` for LongTable.
+
+Current responsibilities:
+
+- structured checkpoint prompt rendering
+- Claude runtime guidance shaping
+- generated Claude runtime config fragments

package/dist/config.d.ts

@@ -0,0 +1,17 @@
+import type { SetupPersistedOutput } from "@longtable/setup";
+import { createClaudeRuntimeBridge } from "./index.js";
+export interface ClaudeConfigFragment {
+    setupPath: string;
+    provider: "claude";
+    checkpointProtocol: "native_structured";
+    defaultInteractionMode: SetupPersistedOutput["defaultInteractionMode"];
+    profileSummary: {
+        field: string;
+        careerStage: string;
+        experienceLevel: string;
+        currentProjectType: string;
+    };
+    runtimeGuidance: ReturnType<typeof createClaudeRuntimeBridge>["runtimeDefaults"];
+}
+export declare function createClaudeConfigFragment(setup: SetupPersistedOutput, setupPath: string): ClaudeConfigFragment;
+export declare function renderClaudeConfigJson(setup: SetupPersistedOutput, setupPath: string): string;

package/dist/config.js

@@ -0,0 +1,20 @@
+import { createClaudeRuntimeBridge } from "./index.js";
+export function createClaudeConfigFragment(setup, setupPath) {
+    const bridge = createClaudeRuntimeBridge(setup);
+    return {
+        setupPath,
+        provider: "claude",
+        checkpointProtocol: bridge.checkpointProtocol,
+        defaultInteractionMode: bridge.defaultInteractionMode,
+        profileSummary: {
+            field: bridge.profile.field,
+            careerStage: bridge.profile.careerStage,
+            experienceLevel: bridge.profile.experienceLevel,
+            currentProjectType: bridge.profile.currentProjectType ?? "unspecified research task"
+        },
+        runtimeGuidance: bridge.runtimeDefaults
+    };
+}
+export function renderClaudeConfigJson(setup, setupPath) {
+    return JSON.stringify(createClaudeConfigFragment(setup, setupPath), null, 2);
+}

package/dist/index.d.ts

@@ -0,0 +1,46 @@
+import type { CheckpointSignal, ResearcherProfile, ResolvedCheckpointPolicy, RuntimeGuidance } from "@longtable/checkpoints";
+import type { NumberedCheckpointSpec, SetupPersistedOutput } from "@longtable/setup";
+export interface ClaudeChoice {
+    id: string;
+    label: string;
+}
+export interface ClaudeStructuredCheckpoint {
+    title: string;
+    instructions?: string;
+    choices: ClaudeChoice[];
+    guidance?: {
+        closureDisposition: RuntimeGuidance["closureDisposition"];
+        minimumQuestions: number;
+        requiredSections: string[];
+        mandatoryQuestions: string[];
+    };
+}
+export interface ClaudeCheckpointContext {
+    profile: ResearcherProfile;
+    signal: CheckpointSignal;
+    spec: NumberedCheckpointSpec;
+}
+export interface ClaudeCheckpointResult {
+    policy: ResolvedCheckpointPolicy;
+    guidance: RuntimeGuidance;
+    structuredPrompt: ClaudeStructuredCheckpoint;
+    blocking: boolean;
+}
+export interface ClaudeRuntimeDefaults {
+    askAtLeastTwoQuestionsInExplore: boolean;
+    preserveNarrativeTraceInDraft: boolean;
+    requireWhyMayBeWrongInReview: boolean;
+    structuredQuestionBias: "strong";
+}
+export interface ClaudeRuntimeBridge {
+    provider: "claude";
+    checkpointProtocol: "native_structured";
+    supportsStructuredQuestions: true;
+    defaultInteractionMode: SetupPersistedOutput["defaultInteractionMode"];
+    profile: SetupPersistedOutput["profileSeed"];
+    runtimeDefaults: ClaudeRuntimeDefaults;
+}
+export declare function renderStructuredCheckpoint(spec: NumberedCheckpointSpec, guidance?: RuntimeGuidance): ClaudeStructuredCheckpoint;
+export declare function createClaudeCheckpoint(context: ClaudeCheckpointContext): ClaudeCheckpointResult;
+export declare function createClaudeRuntimeBridge(setup: SetupPersistedOutput): ClaudeRuntimeBridge;
+export * from "./config.js";

package/dist/index.js

@@ -0,0 +1,69 @@
+import { resolveCheckpointPolicy } from "@longtable/checkpoints";
+import { resolveRuntimeGuidance } from "@longtable/checkpoints";
+function buildRequiredSections(guidance) {
+    const sections = [];
+    if (guidance.preferQuestionsFirst || guidance.minimumQuestions > 0) {
+        sections.push("questions-first");
+    }
+    if (guidance.includeOpenTensions) {
+        sections.push("open-tensions");
+    }
+    if (guidance.includeWhyMayBeWrong) {
+        sections.push("why-this-may-be-wrong");
+    }
+    if (guidance.preserveNarrativeTrace) {
+        sections.push("narrative-trace");
+    }
+    if (guidance.surfaceHumanCommitment) {
+        sections.push("human-commitment");
+    }
+    return sections;
+}
+export function renderStructuredCheckpoint(spec, guidance) {
+    const instructions = [spec.instructions];
+    if (guidance) {
+        instructions.push(`Closure: ${guidance.closureDisposition}. Minimum questions before closure: ${guidance.minimumQuestions}.`);
+    }
+    return {
+        title: spec.title,
+        instructions: instructions.filter(Boolean).join(" "),
+        choices: spec.options.map((option) => ({
+            id: option.value,
+            label: option.label
+        })),
+        guidance: guidance
+            ? {
+                closureDisposition: guidance.closureDisposition,
+                minimumQuestions: guidance.minimumQuestions,
+                requiredSections: buildRequiredSections(guidance),
+                mandatoryQuestions: guidance.mandatoryQuestions
+            }
+            : undefined
+    };
+}
+export function createClaudeCheckpoint(context) {
+    const policy = resolveCheckpointPolicy(context.profile, context.signal);
+    const guidance = resolveRuntimeGuidance(context.profile, context.signal, policy);
+    return {
+        policy,
+        guidance,
+        structuredPrompt: renderStructuredCheckpoint(context.spec, guidance),
+        blocking: policy.blocking
+    };
+}
+export function createClaudeRuntimeBridge(setup) {
+    return {
+        provider: "claude",
+        checkpointProtocol: "native_structured",
+        supportsStructuredQuestions: true,
+        defaultInteractionMode: setup.defaultInteractionMode,
+        profile: setup.profileSeed,
+        runtimeDefaults: {
+            askAtLeastTwoQuestionsInExplore: true,
+            preserveNarrativeTraceInDraft: true,
+            requireWhyMayBeWrongInReview: true,
+            structuredQuestionBias: "strong"
+        }
+    };
+}
+export * from "./config.js";

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@longtable/provider-claude",
+  "version": "0.1.9",
+  "private": false,
+  "description": "Claude adapter surface for LongTable",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "@longtable/checkpoints": "0.1.9",
+    "@longtable/core": "0.1.9",
+    "@longtable/setup": "0.1.9"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.0"
+  },
+  "keywords": [
+    "longtable",
+    "research",
+    "claude",
+    "adapter"
+  ],
+  "author": "Hosung You",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/HosungYou/LongTable.git"
+  },
+  "homepage": "https://github.com/HosungYou/LongTable#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}