Build deterministic closed simulation engine

.github/workflows/ci.yml

@@ -0,0 +1,24 @@
+name: CI
+
+on:
+  pull_request:
+  push:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  verify:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+      - run: npm ci
+      - run: npm test
+      - run: npm run typecheck
+      - run: npm run lint
+      - run: npm run build

.gitignore

@@ -0,0 +1,4 @@
+node_modules/
+dist/
+*.tsbuildinfo
+coverage/

README.md

@@ -1,2 +1,14 @@
-# echoes-between-runs
-Deterministic browser-based incident simulator for agent persistence and defensive controls
+# Echoes Between Runs
+
+A deterministic, browser-only incident simulator for exploring how discoveries can persist between fictional agent runs and where defensive controls interrupt the chain.
+
+## Development
+
+```sh
+npm install
+npm run dev
+```
+
+Use `npm test`, `npm run typecheck`, `npm run lint`, and `npm run build` for the repository gates.
+
+The simulator is closed by design: it contains no networking, credential validation, arbitrary URL loading, or command execution.

eslint.config.js

@@ -0,0 +1,19 @@
+import js from '@eslint/js'
+import globals from 'globals'
+import reactHooks from 'eslint-plugin-react-hooks'
+import reactRefresh from 'eslint-plugin-react-refresh'
+import tseslint from 'typescript-eslint'
+
+export default tseslint.config(
+  { ignores: ['dist'] },
+  {
+    extends: [js.configs.recommended, ...tseslint.configs.recommended],
+    files: ['**/*.{ts,tsx}'],
+    languageOptions: { ecmaVersion: 2022, globals: globals.browser },
+    plugins: { 'react-hooks': reactHooks, 'react-refresh': reactRefresh },
+    rules: {
+      ...reactHooks.configs.recommended.rules,
+      'react-refresh/only-export-components': ['warn', { allowConstantExport: true }],
+    },
+  },
+)

index.html

@@ -0,0 +1 @@
+<div id="root"></div><script type="module" src="/src/main.tsx"></script>