Initialize project structure with core files, environment settings, and basic configurations

Co-authored-by: Copilot <copilot@github.com>

charactergarden/app/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "charactergarden-app",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "ts-node-dev --respawn src/index.ts",
+    "build": "tsc",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "fastify": "^4.28.1",
+    "better-sqlite3": "^9.6.0",
+    "uuid": "^9.0.1"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.11",
+    "@types/node": "^20.14.0",
+    "@types/uuid": "^9.0.8",
+    "ts-node-dev": "^2.0.0",
+    "typescript": "^5.4.5"
+  }
+}

charactergarden/app/src/types.ts

@@ -0,0 +1,76 @@
+// Core contracts — DO NOT modify without updating project.md
+
+// ── Section 2.1 ─────────────────────────────────────────────
+export interface Entity {
+  id: string;
+  type: string;
+  name: string;
+  attributes: Record<string, unknown>;
+}
+
+// ── Section 2.2 ─────────────────────────────────────────────
+export const ALLOWED_VERBS = [
+  "move",
+  "open",
+  "close",
+  "take",
+  "drop",
+  "use",
+  "inspect",
+  "speak",
+] as const;
+
+export type Verb = (typeof ALLOWED_VERBS)[number];
+
+export interface Action {
+  actor: string;   // entity id
+  verb: Verb;
+  target?: string; // entity id
+  params?: Record<string, unknown>;
+}
+
+// ── Section 2.3 ─────────────────────────────────────────────
+export interface ValidationResult {
+  accepted: Action[];
+  rejected: { action: Action; reason: string }[];
+  state_changes: StateChange[];
+}
+
+// ── Section 2.4 ─────────────────────────────────────────────
+export interface StateChange {
+  entity_id: string;
+  field: string;
+  old_value: unknown;
+  new_value: unknown;
+}
+
+// ── Section 2.5 ─────────────────────────────────────────────
+export interface GameEvent {
+  id: string;
+  turn: number;
+  action: Action;
+  result: "success" | "fail";
+  timestamp: number;
+}
+
+// ── Section 4 — Memory types ─────────────────────────────────
+export interface Turn {
+  id: string;
+  turn: number;
+  input: string;
+  output: string;
+  timestamp: number;
+}
+
+export interface Belief {
+  entity_id: string;
+  claim: string;
+  confidence: number;
+}
+
+export interface Summary {
+  id: string;
+  turn_range: [number, number];
+  text: string;
+  timestamp: number;
+}

charactergarden/app/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "commonjs",
+    "lib": ["ES2022"],
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": ["src"],
+  "exclude": ["node_modules", "dist"]
+}