@longtable/setup 0.1.18 → 0.1.20

package/README.md

@@ -8,7 +8,7 @@ Researchers should use the unified CLI:
 
 ```bash
 npm install -g @longtable/cli
-longtable init --flow interview
+longtable setup --provider codex
 ```
 
 This package exists so the setup flow can also be consumed programmatically or tested in isolation during development.
@@ -23,14 +23,15 @@ The generated runtime config does not overwrite platform-native config files dir
 
 ## Package Role
 
-The setup contract combines technical setup with researcher-profile calibration rather than treating installation as a purely technical step.
+The setup contract stores runtime permission and intervention defaults. It
+should not front-load researcher-profile calibration.
 
 Global setup should answer:
 
-- who the researcher is
-- how much challenge or slowdown they want
-- what makes writing still feel like theirs
-- how visible disagreement should be by default
+- which provider is being configured
+- where LongTable may install runtime support
+- which provider surfaces are approved
+- how strongly LongTable may interrupt research decisions
 
 Project and session intake belongs to `longtable start`, not library-level setup helpers.
 

package/dist/cli.js

@@ -4,12 +4,12 @@ import { buildProviderChoices, buildQuickSetupFlow, createPersistedSetupOutput }
 import { installRuntimeConfigFromStoredSetup, loadSetupOutput, renderInstallSummary, renderSetupSummary, resolveDefaultSetupPath, saveSetupAndRuntimeConfig, saveSetupOutput, serializeSetupOutput } from "./persistence.js";
 function printUsage() {
     console.log(`Usage:
-  longtable-setup 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]
+  longtable-setup init [--flow quickstart|interview] --provider <codex|claude> --career-stage <stage> --experience <novice|intermediate|advanced> --checkpoint <low|balanced|high> [--field <field>] [--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]
   longtable-setup install [--path <file>] [--runtime-path <file>] [--json]
   longtable-setup show [--path <file>] [--json]
 
 Example:
-  longtable-setup init --flow interview --provider codex --field education --career-stage doctoral --experience intermediate --checkpoint balanced --entry-mode explore --panel-preference show_on_conflict --json
+  longtable-setup init --flow interview --provider codex --career-stage doctoral --experience intermediate --checkpoint balanced --entry-mode explore --panel-preference show_on_conflict --json
 
 If required flags are omitted, interactive setup starts automatically.
 Use --write to save setup.json and --install to also generate provider runtime config.`);
@@ -42,7 +42,9 @@ function requireString(args, key) {
 }
 function toSetupAnswers(args) {
     return {
-        field: requireString(args, "field"),
+        field: typeof args.field === "string" && args.field.trim().length > 0
+            ? args.field.trim()
+            : "unspecified",
         careerStage: requireString(args, "career-stage"),
         experienceLevel: requireString(args, "experience"),
         preferredCheckpointIntensity: requireString(args, "checkpoint"),
@@ -63,7 +65,6 @@ function toSetupAnswers(args) {
 function hasCompleteFlagInput(args) {
     const requiredKeys = [
         "provider",
-        "field",
         "career-stage",
         "experience",
         "checkpoint"

package/dist/onboarding.js

@@ -1,99 +1,7 @@
 import { createEmptyResearchState } from "@longtable/memory";
 export function buildQuickSetupFlow(flow = "quickstart") {
-    const baseQuestions = [
-        {
-            id: "field",
-            prompt: "Before we begin, which research field best matches your work right now?",
-            required: true,
-            kind: "single_choice",
-            choices: buildFieldChoices()
-        },
-        {
-            id: "careerStage",
-            prompt: "What kind of researcher role best fits you today?",
-            required: true,
-            kind: "single_choice",
-            choices: buildCareerStageChoices()
-        },
-        {
-            id: "experienceLevel",
-            prompt: "How comfortable are you making independent research design decisions right now?",
-            required: true,
-            kind: "single_choice",
-            choices: [
-                { id: "novice", label: "Novice", description: "Needs stronger checkpoint guidance." },
-                { id: "intermediate", label: "Intermediate", description: "Wants balanced guidance." },
-                { id: "advanced", label: "Advanced", description: "Prefers lighter intervention." }
-            ]
-        },
-        {
-            id: "preferredCheckpointIntensity",
-            prompt: "How strongly should LongTable challenge or slow you down by default?",
-            required: true,
-            kind: "single_choice",
-            choices: [
-                { id: "low", label: "Low", description: "Mostly lightweight logging and advisory prompts." },
-                { id: "balanced", label: "Balanced", description: "Recommended by default." },
-                { id: "high", label: "High", description: "Frequent structured commitment prompts." }
-            ]
-        },
-        {
-            id: "humanAuthorshipSignal",
-            prompt: "When a piece of writing still feels like yours, what usually makes that true?",
-            required: false,
-            kind: "single_choice",
-            choices: [
-                { id: "personal experience in the narrative", label: "Personal experience", description: "Humanity appears through lived experience and situated voice." },
-                { id: "visible judgment and reasoning path", label: "Judgment trail", description: "Humanity appears through explicit choices and reasoning history." },
-                { id: "contextual nuance that avoids generic fluency", label: "Contextual nuance", description: "Humanity appears through specificity and non-generic framing." },
-                { id: "a distinctive voice that still sounds like the researcher", label: "Distinctive voice", description: "Humanity appears through authorial tone and cadence." },
-                { id: "other", label: "None of the above", description: "Enter a custom authorship signal.", fallbackToText: true }
-            ]
-        }
-    ];
-    if (flow === "quickstart") {
-        return baseQuestions;
-    }
-    return [
-        ...baseQuestions,
-        {
-            id: "preferredEntryMode",
-            prompt: "When you first open LongTable, where do you want it to begin?",
-            required: false,
-            kind: "single_choice",
-            choices: [
-                { id: "explore", label: "Explore", description: "Open the problem, surface tensions, and ask better questions." },
-                { id: "review", label: "Review", description: "Critically inspect a claim, plan, or draft." },
-                { id: "critique", label: "Critique", description: "Stress-test weak assumptions and generate counterarguments." },
-                { id: "draft", label: "Draft", description: "Write while preserving narrative trace and authorship." },
-                { id: "commit", label: "Commit", description: "Slow down and make an explicit research decision." }
-            ]
-        },
-        {
-            id: "weakestDomain",
-            prompt: "Where do you most want LongTable to push back on you first?",
-            required: false,
-            kind: "single_choice",
-            choices: [
-                { id: "theory", label: "Theory", description: "Sharpen framing, constructs, and theoretical defensibility." },
-                { id: "methodology", label: "Methodology", description: "Question design fit, sampling, and study structure." },
-                { id: "measurement", label: "Measurement", description: "Challenge scales, validity, and operationalization." },
-                { id: "analysis", label: "Analysis", description: "Probe analytic logic, interpretation, and evidence claims." },
-                { id: "writing", label: "Writing", description: "Preserve voice while improving clarity and argument flow." }
-            ]
-        },
-        {
-            id: "panelPreference",
-            prompt: "How visible should disagreement between roles be by default?",
-            required: false,
-            kind: "single_choice",
-            choices: [
-                { id: "synthesis_only", label: "Synthesis only", description: "Show one LongTable answer unless I ask for more." },
-                { id: "show_on_conflict", label: "Show on conflict", description: "Surface panel disagreement when roles materially diverge." },
-                { id: "always_visible", label: "Always visible", description: "Keep panel opinions visible by default." }
-            ]
-        }
-    ];
+    void flow;
+    return [];
 }
 export function buildProviderChoices() {
     return [
@@ -144,8 +52,12 @@ export function normalizeProviderChoice(choice) {
 }
 export function createResearcherProfileSeed(answers) {
     return {
-        currentProjectType: answers.currentProjectType ?? "unspecified research task",
         ...answers,
+        field: answers.field ?? "unspecified",
+        careerStage: answers.careerStage ?? "unspecified",
+        experienceLevel: answers.experienceLevel ?? "advanced",
+        preferredCheckpointIntensity: answers.preferredCheckpointIntensity ?? "balanced",
+        currentProjectType: answers.currentProjectType ?? "unspecified research task",
         aiAutonomyPreference: answers.experienceLevel === "advanced"
             ? "balanced"
             : answers.experienceLevel === "intermediate"

package/dist/persistence.js

@@ -23,10 +23,10 @@ export function renderSetupSummary(output) {
         `provider: ${output.providerSelection.provider}`,
         `checkpoint protocol: ${output.providerSelection.checkpointProtocol}`,
         `default mode: ${output.defaultInteractionMode}`,
-        `field: ${output.profileSeed.field}`,
-        `career stage: ${output.profileSeed.careerStage}`,
-        `experience: ${output.profileSeed.experienceLevel}`,
-        `checkpoint intensity: ${output.profileSeed.preferredCheckpointIntensity}`
+        `field: ${output.profileSeed.field ?? "unspecified"}`,
+        `career stage: ${output.profileSeed.careerStage ?? "unspecified"}`,
+        `experience: ${output.profileSeed.experienceLevel ?? "advanced"}`,
+        `checkpoint intensity: ${output.profileSeed.preferredCheckpointIntensity ?? "balanced"}`
     ];
     if (output.profileSeed.weakestDomain) {
         lines.push(`challenge first: ${output.profileSeed.weakestDomain}`);
@@ -96,9 +96,9 @@ function renderCodexRuntimeConfig(output, setupPath) {
         `setup_flow = "${output.setupFlow}"`,
         "",
         "[longtable.profile]",
-        `field = "${output.profileSeed.field}"`,
-        `career_stage = "${output.profileSeed.careerStage}"`,
-        `experience_level = "${output.profileSeed.experienceLevel}"`,
+        `field = "${output.profileSeed.field ?? "unspecified"}"`,
+        `career_stage = "${output.profileSeed.careerStage ?? "unspecified"}"`,
+        `experience_level = "${output.profileSeed.experienceLevel ?? "advanced"}"`,
         ...(output.profileSeed.currentProjectType && output.profileSeed.currentProjectType !== "unspecified research task"
             ? [`current_project_type = "${output.profileSeed.currentProjectType}"`]
             : []),
@@ -125,9 +125,9 @@ function renderClaudeRuntimeConfig(output, setupPath) {
         defaultInteractionMode: output.defaultInteractionMode,
         setupFlow: output.setupFlow,
         profileSummary: {
-            field: output.profileSeed.field,
-            careerStage: output.profileSeed.careerStage,
-            experienceLevel: output.profileSeed.experienceLevel,
+            field: output.profileSeed.field ?? "unspecified",
+            careerStage: output.profileSeed.careerStage ?? "unspecified",
+            experienceLevel: output.profileSeed.experienceLevel ?? "advanced",
             currentProjectType: output.profileSeed.currentProjectType && output.profileSeed.currentProjectType !== "unspecified research task"
                 ? output.profileSeed.currentProjectType
                 : undefined,

package/dist/types.d.ts

@@ -14,11 +14,11 @@ export interface SetupQuestion {
 }
 export type SetupFlow = "quickstart" | "interview";
 export interface SetupAnswers {
-    field: string;
-    careerStage: string;
-    experienceLevel: ExperienceLevel;
+    field?: string;
+    careerStage?: string;
+    experienceLevel?: ExperienceLevel;
     currentProjectType?: string;
-    preferredCheckpointIntensity: CheckpointIntensity;
+    preferredCheckpointIntensity?: CheckpointIntensity;
     humanAuthorshipSignal?: string;
     preferredEntryMode?: Exclude<InteractionMode, "submit">;
     weakestDomain?: Extract<keyof ResearcherConfidenceByDomain, string>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@longtable/setup",
-  "version": "0.1.18",
+  "version": "0.1.20",
   "private": false,
   "description": "Researcher onboarding and setup flows for LongTable",
   "type": "module",
@@ -23,8 +23,8 @@
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },
   "dependencies": {
-    "@longtable/core": "0.1.18",
-    "@longtable/memory": "0.1.18"
+    "@longtable/core": "0.1.20",
+    "@longtable/memory": "0.1.20"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",