@longtable/core 0.1.9

package/README.md

@@ -0,0 +1,11 @@
+# @longtable/core
+
+Provider-neutral domain contracts for LongTable.
+
+Current responsibilities:
+
+- core research object definitions
+- decision record contracts
+- interaction mode contracts
+- narrative trace contracts
+- runtime guidance types used by adapters

package/dist/index.d.ts

@@ -0,0 +1 @@
+export * from "./types.js";

package/dist/index.js

@@ -0,0 +1 @@
+export * from "./types.js";

package/dist/types.d.ts

@@ -0,0 +1,110 @@
+export type ExperienceLevel = "novice" | "intermediate" | "advanced";
+export type CheckpointIntensity = "low" | "balanced" | "high";
+export type InteractionMode = "explore" | "review" | "critique" | "draft" | "commit" | "submit";
+export type ArtifactStakes = "private_note" | "internal_draft" | "study_protocol" | "external_submission";
+export type ResearchStage = "problem_framing" | "theory_selection" | "method_design" | "measurement_design" | "analysis_planning" | "writing" | "submission";
+export type ConfidenceLevel = "low" | "medium" | "high";
+export type NarrativeTraceType = "experience" | "judgment" | "voice" | "context" | "tension";
+export type NarrativeTraceVisibility = "explicit" | "inferred";
+export type HypothesisStatus = "unconfirmed" | "confirmed" | "rejected";
+export type ProviderKind = "claude" | "codex";
+export type CheckpointLevel = "universal_required" | "adaptive_required" | "recommended" | "log_only" | "none";
+export type PromptStyle = "structured_choice" | "confirm_or_revise" | "advisory_summary" | "passive_log";
+export type GuidanceQuestionType = "clarifying" | "boundary" | "tension" | "narrative";
+export type ClosureDisposition = "delay" | "tentative" | "strong" | "strongest";
+export interface ResearcherConfidenceByDomain {
+    theory: ConfidenceLevel;
+    methodology: ConfidenceLevel;
+    measurement: ConfidenceLevel;
+    analysis: ConfidenceLevel;
+    writing: ConfidenceLevel;
+}
+export interface ResearcherProfile {
+    field: string;
+    careerStage: string;
+    experienceLevel: ExperienceLevel;
+    preferredCheckpointIntensity: CheckpointIntensity;
+    currentProjectType: string;
+    humanAuthorshipSignal?: string;
+    aiAutonomyPreference?: "low" | "balanced" | "high";
+    forceCheckpointsOn?: string[];
+    relaxCheckpointsOn?: string[];
+    confidenceByDomain?: Partial<ResearcherConfidenceByDomain>;
+}
+export interface InferredHypothesis {
+    hypothesis: string;
+    confidence: number;
+    evidence: string[];
+    status: HypothesisStatus;
+}
+export interface DecisionRecord {
+    id: string;
+    timestamp: string;
+    checkpointKey: string;
+    level: CheckpointLevel;
+    mode: InteractionMode;
+    summary: string;
+    selectedOption?: string;
+    rationale?: string;
+    explicitStateUpdates?: Record<string, unknown>;
+    studyContractId?: string;
+}
+export interface ArtifactRecord {
+    id: string;
+    timestamp: string;
+    artifactType: string;
+    stakes: ArtifactStakes;
+    source: string;
+    provider?: ProviderKind;
+    location?: string;
+    decisionRecordId?: string;
+    provenanceSummary: string;
+}
+export interface NarrativeTrace {
+    id: string;
+    timestamp: string;
+    source: string;
+    traceType: NarrativeTraceType;
+    summary: string;
+    visibility: NarrativeTraceVisibility;
+    importance: ConfidenceLevel;
+    linkedDecisionRecordId?: string;
+}
+export interface RuntimeGuidance {
+    mode: InteractionMode;
+    minimumQuestions: number;
+    questionTypes: GuidanceQuestionType[];
+    mustAskBeforeClosure: boolean;
+    preferQuestionsFirst: boolean;
+    includeUnaskedQuestions: boolean;
+    includeOpenTensions: boolean;
+    includeWhyMayBeWrong: boolean;
+    preserveNarrativeTrace: boolean;
+    surfaceHumanCommitment: boolean;
+    closureDisposition: ClosureDisposition;
+    mandatoryQuestions: string[];
+    rationale: string[];
+}
+export interface StudyContract {
+    id: string;
+    title: string;
+    problemFraming: string;
+    targetVenue?: string;
+    theoryAnchor: string;
+    methodology: string;
+    measurementPlan: string;
+    analysisPlan?: string;
+    currentStage: ResearchStage;
+    openTensions: string[];
+    decisionRecordIds: string[];
+}
+export interface ResearchState {
+    explicitState: Record<string, unknown>;
+    workingState: Record<string, unknown>;
+    inferredHypotheses: InferredHypothesis[];
+    openTensions: string[];
+    decisionLog: DecisionRecord[];
+    artifactRecords: ArtifactRecord[];
+    narrativeTraces: NarrativeTrace[];
+    studyContract?: StudyContract;
+}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@longtable/core",
+  "version": "0.1.9",
+  "private": false,
+  "description": "Provider-neutral domain models and contracts 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"
+  },
+  "keywords": [
+    "longtable",
+    "research",
+    "contracts",
+    "types"
+  ],
+  "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"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.0"
+  }
+}