create-interview-cockpit 0.1.0

package/template/server/src/storage.ts

@@ -0,0 +1,303 @@
+import fs from "fs/promises";
+import path from "path";
+import { fileURLToPath } from "url";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const DATA_DIR = path.join(__dirname, "../../data");
+const TOPICS_FILE = path.join(DATA_DIR, "topics.json");
+const QUESTIONS_DIR = path.join(DATA_DIR, "questions");
+const CONTEXT_FILES_DIR = path.join(DATA_DIR, "context-files");
+
+async function ensureDirs() {
+  await fs.mkdir(DATA_DIR, { recursive: true });
+  await fs.mkdir(QUESTIONS_DIR, { recursive: true });
+  await fs.mkdir(CONTEXT_FILES_DIR, { recursive: true });
+}
+
+export interface Topic {
+  id: string;
+  name: string;
+  contextFiles: ContextFile[];
+  createdAt: string;
+}
+
+export interface ContextFile {
+  id: string;
+  name: string;
+  originalName: string;
+  createdAt: string;
+}
+
+export interface Message {
+  id: string;
+  role: string;
+  content: string;
+  createdAt?: string;
+}
+
+export interface AnnotationFollowUp {
+  id: string;
+  prompt: string;
+  response: string;
+  createdAt: string;
+}
+
+export interface Annotation {
+  id: string;
+  messageId: string;
+  selectedText: string;
+  prompt: string;
+  response: string;
+  followUps?: AnnotationFollowUp[];
+  createdAt: string;
+}
+
+export interface ReadingBookmark {
+  messageId: string;
+  blockIndex: number;
+}
+
+export interface Question {
+  id: string;
+  topicId: string;
+  parentQuestionId?: string;
+  title: string;
+  systemContext: string;
+  codeContextFiles: string[];
+  contextFiles: ContextFile[];
+  messages: Message[];
+  annotations?: Annotation[];
+  readingBookmark?: ReadingBookmark;
+  createdAt: string;
+}
+
+// --- Topics ---
+
+export async function getTopics(): Promise<Topic[]> {
+  await ensureDirs();
+  try {
+    const data = await fs.readFile(TOPICS_FILE, "utf-8");
+    const topics: Topic[] = JSON.parse(data);
+    // Backfill missing fields from older data
+    for (const t of topics) {
+      if (!t.contextFiles) t.contextFiles = [];
+    }
+    return topics;
+  } catch {
+    return [];
+  }
+}
+
+export async function saveTopic(topic: Topic): Promise<Topic> {
+  const topics = await getTopics();
+  const idx = topics.findIndex((t) => t.id === topic.id);
+  if (idx !== -1) {
+    topics[idx] = topic;
+  } else {
+    topics.push(topic);
+  }
+  await fs.writeFile(TOPICS_FILE, JSON.stringify(topics, null, 2));
+  return topic;
+}
+
+export async function deleteTopic(id: string): Promise<void> {
+  const topics = await getTopics();
+  const topic = topics.find((t) => t.id === id);
+  // Clean up context files on disk
+  if (topic?.contextFiles) {
+    for (const cf of topic.contextFiles) {
+      try {
+        await fs.unlink(path.join(CONTEXT_FILES_DIR, cf.id));
+      } catch {
+        /* already gone */
+      }
+    }
+  }
+  const remaining = topics.filter((t) => t.id !== id);
+  await fs.writeFile(TOPICS_FILE, JSON.stringify(remaining, null, 2));
+  const questions = await getQuestionsByTopic(id);
+  for (const q of questions) {
+    await deleteQuestion(q.id);
+  }
+}
+
+export async function updateTopic(
+  id: string,
+  patch: Partial<Topic>,
+): Promise<Topic | null> {
+  const topics = await getTopics();
+  const idx = topics.findIndex((t) => t.id === id);
+  if (idx === -1) return null;
+  Object.assign(topics[idx], patch);
+  await fs.writeFile(TOPICS_FILE, JSON.stringify(topics, null, 2));
+  return topics[idx];
+}
+
+// --- Context Files ---
+
+export function getContextFilesDir(): string {
+  return CONTEXT_FILES_DIR;
+}
+
+export async function saveContextFile(
+  topicId: string,
+  fileId: string,
+  originalName: string,
+  buffer: Buffer,
+): Promise<ContextFile> {
+  await ensureDirs();
+  await fs.writeFile(path.join(CONTEXT_FILES_DIR, fileId), buffer);
+  const cf: ContextFile = {
+    id: fileId,
+    name: originalName,
+    originalName,
+    createdAt: new Date().toISOString(),
+  };
+  const topics = await getTopics();
+  const topic = topics.find((t) => t.id === topicId);
+  if (topic) {
+    if (!topic.contextFiles) topic.contextFiles = [];
+    topic.contextFiles.push(cf);
+    await fs.writeFile(TOPICS_FILE, JSON.stringify(topics, null, 2));
+  }
+  return cf;
+}
+
+export async function deleteContextFile(
+  topicId: string,
+  fileId: string,
+): Promise<void> {
+  try {
+    await fs.unlink(path.join(CONTEXT_FILES_DIR, fileId));
+  } catch {
+    /* already gone */
+  }
+  const topics = await getTopics();
+  const topic = topics.find((t) => t.id === topicId);
+  if (topic) {
+    topic.contextFiles = (topic.contextFiles || []).filter(
+      (f) => f.id !== fileId,
+    );
+    await fs.writeFile(TOPICS_FILE, JSON.stringify(topics, null, 2));
+  }
+}
+
+export async function readContextFileContent(fileId: string): Promise<string> {
+  return fs.readFile(path.join(CONTEXT_FILES_DIR, fileId), "utf-8");
+}
+
+// --- Questions ---
+
+export async function getQuestion(id: string): Promise<Question | null> {
+  await ensureDirs();
+  try {
+    const data = await fs.readFile(
+      path.join(QUESTIONS_DIR, `${id}.json`),
+      "utf-8",
+    );
+    const q: Question = JSON.parse(data);
+    if (!q.contextFiles) q.contextFiles = [];
+    if (!q.annotations) q.annotations = [];
+    return q;
+  } catch {
+    return null;
+  }
+}
+
+export async function getQuestionsByTopic(
+  topicId: string,
+): Promise<Question[]> {
+  await ensureDirs();
+  try {
+    const files = await fs.readdir(QUESTIONS_DIR);
+    const questions: Question[] = [];
+    for (const file of files) {
+      if (!file.endsWith(".json")) continue;
+      const data = await fs.readFile(path.join(QUESTIONS_DIR, file), "utf-8");
+      const q: Question = JSON.parse(data);
+      if (q.topicId === topicId) {
+        questions.push(q);
+      }
+    }
+    return questions.sort((a, b) => a.createdAt.localeCompare(b.createdAt));
+  } catch {
+    return [];
+  }
+}
+
+export async function saveQuestion(question: Question): Promise<Question> {
+  await ensureDirs();
+  await fs.writeFile(
+    path.join(QUESTIONS_DIR, `${question.id}.json`),
+    JSON.stringify(question, null, 2),
+  );
+  return question;
+}
+
+export async function deleteQuestion(id: string): Promise<void> {
+  // Clean up question-level context files
+  const q = await getQuestion(id);
+  if (q?.contextFiles) {
+    for (const cf of q.contextFiles) {
+      try {
+        await fs.unlink(path.join(CONTEXT_FILES_DIR, cf.id));
+      } catch {
+        /* ok */
+      }
+    }
+  }
+  try {
+    await fs.unlink(path.join(QUESTIONS_DIR, `${id}.json`));
+  } catch {
+    // ignore if already deleted
+  }
+}
+
+export async function saveQuestionContextFile(
+  questionId: string,
+  fileId: string,
+  originalName: string,
+  buffer: Buffer,
+): Promise<ContextFile> {
+  await ensureDirs();
+  await fs.writeFile(path.join(CONTEXT_FILES_DIR, fileId), buffer);
+  const cf: ContextFile = {
+    id: fileId,
+    name: originalName,
+    originalName,
+    createdAt: new Date().toISOString(),
+  };
+  const q = await getQuestion(questionId);
+  if (q) {
+    if (!q.contextFiles) q.contextFiles = [];
+    q.contextFiles.push(cf);
+    await saveQuestion(q);
+  }
+  return cf;
+}
+
+export async function deleteQuestionContextFile(
+  questionId: string,
+  fileId: string,
+): Promise<void> {
+  try {
+    await fs.unlink(path.join(CONTEXT_FILES_DIR, fileId));
+  } catch {
+    /* ok */
+  }
+  const q = await getQuestion(questionId);
+  if (q) {
+    q.contextFiles = (q.contextFiles || []).filter((f) => f.id !== fileId);
+    await saveQuestion(q);
+  }
+}
+
+export async function updateQuestionMessages(
+  questionId: string,
+  messages: Message[],
+): Promise<void> {
+  const q = await getQuestion(questionId);
+  if (!q) throw new Error("Question not found");
+  q.messages = messages;
+  await saveQuestion(q);
+}

package/template/server/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ES2022",
+    "moduleResolution": "bundler",
+    "esModuleInterop": true,
+    "strict": true,
+    "outDir": "dist",
+    "rootDir": "src",
+    "resolveJsonModule": true,
+    "skipLibCheck": true
+  },
+  "include": ["src"]
+}