@ethogram/cli 0.1.0-alpha.0

package/dist/runtime/styles.css

@@ -0,0 +1,235 @@
+@font-face {
+  font-family: 'Archivo';
+  src: url('/fonts/archivo-regular.woff2') format('woff2');
+  font-weight: 400;
+  font-style: normal;
+  font-display: swap;
+}
+@font-face {
+  font-family: 'Archivo';
+  src: url('/fonts/archivo-medium.woff2') format('woff2');
+  font-weight: 500;
+  font-style: normal;
+  font-display: swap;
+}
+@font-face {
+  font-family: 'Archivo';
+  src: url('/fonts/archivo-semibold.woff2') format('woff2');
+  font-weight: 600;
+  font-style: normal;
+  font-display: swap;
+}
+@font-face {
+  font-family: 'JetBrains Mono';
+  src: url('/fonts/jetbrains-mono-variable.woff2') format('woff2-variations');
+  font-weight: 100 800;
+  font-style: normal;
+  font-display: swap;
+}
+:root {
+  color-scheme: dark;
+  --background: #101216;
+  --foreground: #f3f5f8;
+  --panel: #181b21;
+  --panel-2: #14171c;
+  --line: #292e38;
+  --muted: #9ca4b2;
+  --subtle: #737b8a;
+  --accent: #9a85ff;
+  --accent-soft: #29234d;
+  --green: #48cf93;
+  --green-soft: #163c2e;
+  --red: #f1787e;
+  --red-soft: #422126;
+  --sidebar: #15181e;
+  --font-sans: 'Archivo', system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
+  --font-mono: 'JetBrains Mono', ui-monospace, 'SFMono-Regular', Consolas, monospace;
+}
+* { box-sizing: border-box; }
+body { margin: 0; background: var(--background); color: var(--foreground); font: 14px var(--font-sans); }
+button { font: inherit; color: inherit; cursor: pointer; }
+.app-shell { min-height: 100vh; display: flex; }
+.loading-card { margin: auto; padding: 24px; border: 1px solid var(--line); border-radius: 8px; background: var(--panel); }
+.loading-card.error { color: var(--red); }
+.sidebar { width: 244px; min-height: 100vh; flex: 0 0 244px; display: flex; flex-direction: column; background: var(--sidebar); border-right: 1px solid var(--line); }
+.brand { height: 54px; display: flex; align-items: center; gap: 9px; padding: 0 14px; border-bottom: 1px solid var(--line); font-weight: 700; }
+.brand-mark { display: grid; place-items: center; width: 22px; height: 22px; border-radius: 6px; color: white; background: var(--accent); }
+.codename { margin-left: auto; color: var(--subtle); font-size: 9px; font-weight: 500; text-transform: uppercase; letter-spacing: .08em; }
+.project { display: flex; align-items: center; gap: 8px; padding: 17px 16px 12px; color: var(--muted); font-size: 12px; }
+.online-dot { display: inline-block; width: 7px; height: 7px; margin-right: 5px; border-radius: 50%; background: var(--green); }
+.search { display: flex; align-items: center; margin: 4px 12px 20px; padding: 7px 9px; color: var(--subtle); background: var(--panel); border: 1px solid var(--line); border-radius: 5px; font-size: 12px; }
+.search kbd { margin-left: auto; border: 1px solid var(--line); border-radius: 3px; padding: 1px 4px; font-size: 10px; }
+.nav-label { padding: 0 15px 7px; color: var(--subtle); font-size: 10px; font-weight: 700; letter-spacing: .1em; }
+.agent-link { display: flex; align-items: center; gap: 7px; width: 100%; padding: 8px 12px; border: 0; background: color-mix(in srgb, var(--accent) 10%, transparent); text-align: left; font-size: 12px; font-weight: 600; }
+.agent-link span { margin-left: auto; color: var(--subtle); font-size: 10px; }
+.story-list { display: flex; flex-direction: column; padding: 2px 10px 8px 37px; }
+.story-link { display: flex; align-items: center; gap: 7px; padding: 7px 5px; border: 0; border-radius: 4px; background: transparent; color: var(--muted); text-align: left; font-size: 11px; }
+.story-link.selected { color: var(--accent); background: var(--accent-soft); font-weight: 600; }
+.story-link em { margin-left: auto; color: var(--accent); font-size: 8px; font-style: normal; }
+.status-dot { width: 6px; height: 6px; border-radius: 50%; background: #e4ad4d; }
+.sidebar-footer { margin-top: auto; display: flex; flex-direction: column; gap: 4px; padding: 16px; border-top: 1px solid var(--line); color: var(--muted); font-size: 11px; }
+.sidebar-footer small { color: var(--subtle); }
+.main { min-width: 0; flex: 1; }
+.topbar { height: 54px; display: flex; align-items: center; justify-content: space-between; padding: 0 26px; border-bottom: 1px solid var(--line); }
+.breadcrumb { display: flex; gap: 8px; color: var(--muted); font-size: 12px; }
+.breadcrumb strong { color: var(--foreground); }
+.run-button { display: flex; align-items: center; gap: 7px; padding: 7px 11px; border: 1px solid var(--accent); border-radius: 5px; background: var(--accent); color: white; font-size: 12px; font-weight: 600; }
+.run-button:disabled { opacity: .65; cursor: wait; }
+.story-meta { display: flex; align-items: center; gap: 12px; padding: 23px 28px 20px; }
+.story-symbol { display: grid; place-items: center; width: 38px; height: 38px; border-radius: 8px; color: #e4ad4d; background: #3d2e14; }
+.story-meta h1 { margin: 0; font-size: 18px; }
+.story-meta p { margin: 5px 0 0; color: var(--muted); font-size: 12px; }
+.source { margin-left: auto; color: var(--subtle); font: 10px var(--font-mono); }
+.tabs { display: flex; gap: 22px; padding: 0 28px; border-bottom: 1px solid var(--line); }
+.tabs button { padding: 10px 1px 11px; border: 0; border-bottom: 2px solid transparent; background: transparent; color: var(--muted); font-size: 12px; }
+.tabs button.active { color: var(--accent); border-bottom-color: var(--accent); font-weight: 600; }
+.tabs span { color: var(--subtle); font-size: 10px; }
+.error-banner { margin: 16px 28px 0; padding: 10px 12px; border: 1px solid var(--red); border-radius: 6px; background: var(--red-soft); color: var(--red); }
+.scope-banner { margin: 16px 28px 0; padding: 10px 12px; border: 1px solid var(--line); border-radius: 6px; background: var(--panel-2); color: var(--muted); font-size: 11px; }
+.canvas { max-width: 1440px; display: grid; grid-template-columns: minmax(0, 1.25fr) minmax(340px, .9fr); gap: 15px; padding: 19px 28px 30px; }
+.canvas-main, .canvas-side { display: flex; flex-direction: column; gap: 14px; }
+.panel { overflow: hidden; border: 1px solid var(--line); border-radius: 7px; background: var(--panel); }
+.panel > header { min-height: 39px; display: flex; align-items: center; justify-content: space-between; padding: 0 13px; border-bottom: 1px solid var(--line); }
+.panel > header strong { font-size: 11px; }
+.panel > header small { color: var(--subtle); font-size: 10px; }
+.given-grid { display: grid; grid-template-columns: repeat(2, 1fr); gap: 9px 18px; padding: 12px 13px; }
+.given-row { display: flex; justify-content: space-between; gap: 10px; font-size: 11px; }
+.given-row span { color: var(--subtle); }
+.config-grid { display: grid; grid-template-columns: repeat(4, 1fr); gap: 14px; padding: 12px 13px; }
+.config-grid small, .result small, .metrics small, .tool-json small { color: var(--subtle); font-size: 9px; letter-spacing: .06em; }
+.config-grid strong, .result strong, .metrics strong { display: block; margin-top: 5px; font-size: 11px; }
+.input-box { margin: 10px 13px 13px; padding: 11px; border: 1px solid var(--line); border-radius: 5px; background: var(--panel-2); font-size: 12px; }
+.result { display: grid; grid-template-columns: 1fr 1.5fr 1fr; gap: 16px; padding: 13px; }
+.result p { margin: 5px 0 0; color: var(--muted); font-size: 11px; line-height: 1.45; }
+.pass { color: var(--green) !important; }
+.fail { color: var(--red) !important; }
+.stale { color: #e4ad4d !important; }
+.result[data-evidence-state="stale"] { background: #3d2e14; }
+.empty { padding: 12px 13px; color: var(--subtle); font-size: 10px; }
+.timeline { padding: 8px 13px; }
+.timeline-row { min-height: 42px; display: grid; grid-template-columns: 20px 1fr auto; align-items: center; gap: 8px; }
+.timeline-icon, .assertion-icon { display: grid; place-items: center; width: 19px; height: 19px; border-radius: 50%; color: var(--green); background: var(--green-soft); }
+.timeline-row strong, .timeline-row small { display: block; font-size: 10px; }
+.timeline-row small { margin-top: 3px; color: var(--muted); }
+.timeline-row code { color: var(--subtle); font-size: 10px; }
+.tools { padding: 3px 0; }
+.tool-call { border-bottom: 1px solid var(--line); }
+.tool-call:last-child { border-bottom: 0; }
+.tool-call summary { display: flex; align-items: center; gap: 8px; padding: 9px 13px; cursor: pointer; }
+.tool-call summary code { font-size: 10px; font-weight: 600; }
+.tool-call summary small { margin-left: auto; color: var(--subtle); }
+.badge { padding: 3px 6px; border-radius: 4px; background: var(--green-soft); font-size: 9px; font-weight: 700; text-transform: uppercase; }
+.tool-json { display: grid; gap: 8px; padding: 10px 13px 13px 34px; background: var(--panel-2); }
+.tool-json pre { margin: 4px 0 0; color: var(--muted); white-space: pre-wrap; font: 10px/1.5 var(--font-mono); }
+.assertions { padding: 8px 13px; }
+.assertion { display: flex; align-items: flex-start; gap: 8px; padding: 7px 0; }
+.assertion-icon.pending { color: var(--subtle); background: var(--line); }
+.assertion-icon.fail { color: var(--red); background: var(--red-soft); }
+.assertion strong, .assertion small { display: block; font-size: 10px; }
+.assertion small { margin-top: 3px; color: var(--muted); }
+.metrics { display: grid; grid-template-columns: repeat(2, 1fr); gap: 16px; padding: 12px 13px; }
+@media (max-width: 900px) { .canvas { grid-template-columns: 1fr; } .sidebar { width: 210px; flex-basis: 210px; } }
+@media (max-width: 680px) { .sidebar { display: none; } .topbar, .story-meta, .tabs, .canvas { padding-left: 16px; padding-right: 16px; } .breadcrumb { display: none; } .source { width: 100%; margin: 8px 0 0; } .story-meta { flex-wrap: wrap; } .canvas, .given-grid, .config-grid, .result { grid-template-columns: 1fr; } }
+
+/* Ethogram product system -------------------------------------------------- */
+:root {
+  --background: #0e1110;
+  --foreground: #f5f2ec;
+  --panel: #121614;
+  --panel-2: #171b19;
+  --line: rgb(245 242 236 / 16%);
+  --line-strong: rgb(245 242 236 / 34%);
+  --muted: rgb(245 242 236 / 62%);
+  --subtle: rgb(245 242 236 / 42%);
+  --green: #5fbf8b;
+  --green-soft: rgb(95 191 139 / 13%);
+  --red: #e58c72;
+  --red-soft: rgb(229 140 114 / 13%);
+  --sidebar: #0b0e0d;
+}
+
+*, *::before, *::after { border-radius: 0 !important; }
+button:focus-visible, input:focus-visible, summary:focus-visible { outline: 2px solid var(--foreground); outline-offset: 2px; }
+.sidebar { width: 256px; flex-basis: 256px; }
+.brand { height: 60px; padding: 0 18px; border-bottom-color: var(--line-strong); font-size: 15px; font-weight: 600; }
+.brand-mark { width: 26px; height: 26px; fill: none; stroke: currentColor; stroke-width: 3; }
+.codename { font-family: var(--font-mono); font-size: 10px; letter-spacing: .11em; }
+.project { padding: 20px 18px 14px; font-family: var(--font-mono); font-size: 11.5px; }
+.project strong { overflow: hidden; color: var(--foreground); font-weight: 500; text-overflow: ellipsis; white-space: nowrap; }
+.project-local { margin-left: auto; color: var(--subtle); font-size: 10px; letter-spacing: .1em; text-transform: uppercase; }
+.online-dot { width: 6px; height: 6px; }
+.search { min-height: 40px; gap: 8px; margin: 4px 14px 24px; padding: 9px 10px; border-color: var(--line-strong); background: transparent; font-family: var(--font-mono); font-size: 11.5px; }
+.search input { min-width: 0; flex: 1; border: 0; outline: 0; background: transparent; color: var(--foreground); font: inherit; }
+.search input::placeholder { color: var(--subtle); opacity: 1; }
+.search kbd { border: 0; color: var(--subtle); font-family: inherit; }
+.nav-label { padding: 0 18px 9px; font-family: var(--font-mono); font-size: 10px; font-weight: 500; }
+.agent-link { min-height: 42px; padding: 10px 15px; background: transparent; box-shadow: inset 2px 0 var(--foreground); font-family: var(--font-mono); font-size: 11.5px; }
+.agent-link .agent-glyph { margin: 0; color: var(--muted); }
+.story-list { padding: 2px 12px 10px 42px; }
+.story-link { min-height: 38px; padding: 8px 6px; font-family: var(--font-mono); font-size: 11px; }
+.story-link.selected { background: rgb(245 242 236 / 8%); color: var(--foreground); box-shadow: inset 2px 0 var(--foreground); }
+.story-link em { color: var(--subtle) !important; font-size: 8.5px; letter-spacing: .06em; }
+.sidebar-footer { padding: 16px 18px 18px; border-top-color: var(--line-strong); font-family: var(--font-mono); font-size: 10px; }
+.sidebar-footer span { color: var(--foreground); letter-spacing: .05em; text-transform: uppercase; }
+.sidebar-footer small { line-height: 1.5; }
+.topbar { height: 60px; padding-inline: 30px; border-bottom-color: var(--line-strong); }
+.breadcrumb { font-family: var(--font-mono); font-size: 11.5px; }
+.run-button { min-height: 42px; padding: 10px 18px; border-color: var(--foreground); background: var(--foreground); color: var(--background); font-family: var(--font-mono); font-size: 12px; font-weight: 600; }
+.run-button:hover { opacity: .86; }
+.story-meta { gap: 16px; padding: 28px 30px 24px; }
+.story-symbol { width: 44px; height: 44px; border: 1px solid var(--line-strong); background: transparent; color: var(--foreground); }
+.story-symbol svg { width: 25px; height: 25px; fill: none; stroke: currentColor; stroke-width: 3; }
+.story-meta h1 { font-size: 27px; font-weight: 600; letter-spacing: -.035em; }
+.story-meta p { max-width: 720px; margin-top: 7px; font-size: 14px; line-height: 1.5; }
+.source { font-size: 10.5px; }
+.tabs { gap: 26px; padding-inline: 30px; }
+.tabs button { padding: 12px 1px 14px; font-family: var(--font-mono); font-size: 11.5px; }
+.tabs button.active { border-bottom-color: var(--foreground); color: var(--foreground); font-weight: 500; }
+.scope-banner, .error-banner { margin: 18px 30px 0; padding: 11px 13px; background: transparent; font-family: var(--font-mono); font-size: 10.5px; line-height: 1.5; }
+.scope-banner { border-color: var(--line-strong); }
+.canvas { max-width: 1520px; grid-template-columns: minmax(0, 1.25fr) minmax(340px, .9fr); gap: 0; padding: 24px 30px 44px; }
+.canvas-main, .canvas-side { gap: 0; }
+.canvas-side { border-left: 1px solid var(--line-strong); }
+.panel { border-color: var(--line); background: transparent; }
+.panel + .panel { border-top: 0; }
+.panel > header { min-height: 44px; padding: 0 15px; }
+.panel > header strong, .panel > header small { font-family: var(--font-mono); font-size: 10.5px; font-weight: 500; letter-spacing: .04em; text-transform: uppercase; }
+.given-grid, .config-grid, .result, .metrics { padding: 16px; }
+.given-row { font-family: var(--font-mono); font-size: 11.5px; }
+.input-box { margin: 14px 15px 16px; padding: 14px; background: transparent; font-family: var(--font-mono); font-size: 12.5px; line-height: 1.55; }
+.config-grid small, .result small, .metrics small, .tool-json small { font-family: var(--font-mono); font-size: 9.5px; }
+.config-grid strong, .result strong, .metrics strong { font-family: var(--font-mono); font-size: 11.5px; font-weight: 500; }
+.result p { font-size: 11.5px; line-height: 1.55; }
+.timeline { padding: 14px 15px 12px; }
+.timeline-icon, .assertion-icon { border: 1px solid currentColor; background: transparent !important; }
+.timeline-row strong, .timeline-row small, .timeline-row code, .assertion strong, .assertion small { font-family: var(--font-mono); font-size: 10.5px; }
+.tool-call summary { min-height: 42px; padding: 10px 15px; }
+.tool-json { padding: 12px 15px 15px 36px; }
+.tool-json pre { max-height: 180px; overflow: auto; }
+.badge { border: 1px solid currentColor; background: transparent; font-family: var(--font-mono); font-size: 9.5px; font-weight: 500; }
+.assertions { padding: 10px 15px; }
+.assertion { padding: 9px 0; }
+.empty { padding: 16px; font-family: var(--font-mono); font-size: 10.5px; }
+.loading-card { border-color: var(--line-strong); background: transparent; font-family: var(--font-mono); font-size: 11.5px; }
+
+@media (max-width: 900px) {
+  .sidebar { width: 226px; flex-basis: 226px; }
+  .canvas-side { border-left: 0; }
+}
+
+@media (max-width: 680px) {
+  .app-shell { display: block; }
+  .sidebar { display: block; width: 100%; min-height: 0; border-right: 0; border-bottom: 1px solid var(--line-strong); }
+  .brand { height: 54px; }
+  .project, .search, .nav-label, .sidebar-footer, .agent-link { display: none; }
+  .story-list { display: flex; gap: 4px; overflow-x: auto; padding: 8px 14px; }
+  .story-link { flex: 0 0 auto; min-height: 38px; padding: 9px 11px; border: 1px solid var(--line); }
+  .story-link.selected { box-shadow: inset 0 -2px var(--foreground); }
+  .topbar { padding-inline: 16px; }
+  .story-meta { padding: 22px 16px 18px; }
+  .story-meta h1 { font-size: 22px; }
+  .tabs, .canvas { padding-left: 16px; padding-right: 16px; }
+  .scope-banner, .error-banner { margin-left: 16px; margin-right: 16px; }
+  .canvas { padding-top: 18px; }
+  .panel + .panel { border-top: 0; }
+}

package/dist/server.d.ts

@@ -0,0 +1,7 @@
+type StartServerOptions = {
+    projectRoot: string;
+    port: number;
+    openBrowser: boolean;
+};
+export declare function startDeveloperServer(options: StartServerOptions): Promise<void>;
+export {};

package/dist/server.js

@@ -0,0 +1,250 @@
+import { spawn } from 'node:child_process';
+import { randomUUID } from 'node:crypto';
+import { createServer } from 'node:http';
+import { readdir, readFile, stat } from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { EthogramEngine } from './generic-engine.js';
+import { TypeScriptAdapter, TypeScriptAdapterError } from './typescript-adapter.js';
+const runtimeDirectory = fileURLToPath(new URL('./runtime/', import.meta.url));
+const runtimeFonts = new Set([
+    'archivo-regular.woff2',
+    'archivo-medium.woff2',
+    'archivo-semibold.woff2',
+    'jetbrains-mono-variable.woff2',
+]);
+function json(response, status, value) {
+    response.writeHead(status, {
+        'content-type': 'application/json; charset=utf-8',
+        'cache-control': 'no-store',
+        'x-content-type-options': 'nosniff',
+    });
+    response.end(JSON.stringify(value));
+}
+function safeError(error) {
+    if (error instanceof TypeScriptAdapterError)
+        return { code: error.code, message: error.message };
+    if (error instanceof Error) {
+        const [code, detail] = error.message.split(': ', 2);
+        if (/^[A-Z_]+$/.test(code))
+            return { code, message: detail ?? code };
+    }
+    return { code: 'ETHOGRAM_RUNTIME_ERROR', message: 'The Ethogram operation could not be completed.' };
+}
+const ignoredSourceDirectories = new Set([
+    '.git', '.next', '.turbo', '.vercel', 'build', 'coverage', 'dist', 'node_modules',
+]);
+const watchedSourceExtensions = new Set(['.cjs', '.cts', '.js', '.json', '.mjs', '.mts', '.ts']);
+async function sourceFingerprint(projectRoot) {
+    const entries = [];
+    async function visit(directory) {
+        let children;
+        try {
+            children = await readdir(directory, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const child of children) {
+            if (ignoredSourceDirectories.has(child.name))
+                continue;
+            const absolute = path.join(directory, child.name);
+            if (child.isDirectory()) {
+                await visit(absolute);
+                continue;
+            }
+            if (!child.isFile() || !watchedSourceExtensions.has(path.extname(child.name)))
+                continue;
+            const metadata = await stat(absolute);
+            entries.push(`${path.relative(projectRoot, absolute)}:${metadata.size}:${metadata.mtimeMs}`);
+        }
+    }
+    await visit(projectRoot);
+    return entries.sort().join('\n');
+}
+async function requestBody(request) {
+    const chunks = [];
+    let size = 0;
+    for await (const chunk of request) {
+        const buffer = Buffer.from(chunk);
+        size += buffer.length;
+        if (size > 32_768)
+            throw new Error('REQUEST_TOO_LARGE');
+        chunks.push(buffer);
+    }
+    if (chunks.length === 0)
+        return {};
+    const parsed = JSON.parse(Buffer.concat(chunks).toString('utf8'));
+    if (!parsed || typeof parsed !== 'object')
+        throw new Error('INVALID_REQUEST');
+    return parsed;
+}
+async function staticAsset(response, fileName, contentType) {
+    const filePath = path.join(runtimeDirectory, fileName);
+    const content = await readFile(filePath);
+    response.writeHead(200, {
+        'content-type': contentType,
+        'cache-control': 'no-store',
+        'x-content-type-options': 'nosniff',
+        'content-security-policy': "default-src 'self'; script-src 'self'; style-src 'self'; connect-src 'self'; img-src 'self' data:; object-src 'none'; base-uri 'none'",
+    });
+    response.end(content);
+}
+function openLocalBrowser(url) {
+    const command = process.platform === 'darwin'
+        ? { executable: 'open', args: [url] }
+        : process.platform === 'win32'
+            ? { executable: 'cmd', args: ['/c', 'start', '', url] }
+            : { executable: 'xdg-open', args: [url] };
+    const child = spawn(command.executable, command.args, { detached: true, stdio: 'ignore' });
+    child.unref();
+}
+export async function startDeveloperServer(options) {
+    for (const required of ['index.html', 'app.js', 'styles.css']) {
+        try {
+            if (!(await stat(path.join(runtimeDirectory, required))).isFile())
+                throw new Error('missing');
+        }
+        catch {
+            throw new Error(`MISSING_RUNTIME: Packaged developer runtime is incomplete (${required}). Reinstall @ethogram/cli.`);
+        }
+    }
+    const instanceId = randomUUID();
+    let engine = new EthogramEngine(new TypeScriptAdapter());
+    let project = await engine.loadProject(options.projectRoot);
+    let revision = 1;
+    let fingerprint = await sourceFingerprint(project.projectRoot);
+    let reloadError;
+    let refreshing;
+    const runtime = () => ({ instanceId, revision });
+    const refreshIfChanged = async () => {
+        if (refreshing)
+            return refreshing;
+        refreshing = (async () => {
+            const nextFingerprint = await sourceFingerprint(project.projectRoot);
+            if (nextFingerprint === fingerprint)
+                return;
+            fingerprint = nextFingerprint;
+            revision += 1;
+            try {
+                const nextAdapter = new TypeScriptAdapter();
+                const nextEngine = new EthogramEngine(nextAdapter);
+                const nextProject = await nextEngine.loadProject(project.projectRoot);
+                engine = nextEngine;
+                project = nextProject;
+                reloadError = undefined;
+                process.stdout.write(`Ethogram reloaded project sources (revision ${revision}).\n`);
+            }
+            catch (error) {
+                reloadError = safeError(error);
+                process.stderr.write(`Ethogram reload failed (${reloadError.code}): ${reloadError.message}\n`);
+            }
+        })().finally(() => { refreshing = undefined; });
+        return refreshing;
+    };
+    const watcher = setInterval(() => { void refreshIfChanged(); }, 750);
+    watcher.unref();
+    const server = createServer(async (request, response) => {
+        try {
+            const requestUrl = new URL(request.url ?? '/', 'http://127.0.0.1');
+            if (request.method === 'GET' && requestUrl.pathname === '/') {
+                await staticAsset(response, 'index.html', 'text/html; charset=utf-8');
+                return;
+            }
+            if (request.method === 'GET' && requestUrl.pathname === '/app.js') {
+                await staticAsset(response, 'app.js', 'text/javascript; charset=utf-8');
+                return;
+            }
+            if (request.method === 'GET' && requestUrl.pathname === '/styles.css') {
+                await staticAsset(response, 'styles.css', 'text/css; charset=utf-8');
+                return;
+            }
+            if (request.method === 'GET' && requestUrl.pathname.startsWith('/fonts/')) {
+                const fontName = requestUrl.pathname.slice('/fonts/'.length);
+                if (runtimeFonts.has(fontName)) {
+                    await staticAsset(response, `fonts/${fontName}`, 'font/woff2');
+                    return;
+                }
+            }
+            if (request.method === 'GET' && requestUrl.pathname === '/favicon.ico') {
+                response.writeHead(204, { 'cache-control': 'no-store' });
+                response.end();
+                return;
+            }
+            if (request.method === 'GET' && requestUrl.pathname === '/api/project') {
+                await refreshIfChanged();
+                if (reloadError) {
+                    json(response, 409, { status: 'project-error', error: reloadError, runtime: runtime() });
+                    return;
+                }
+                json(response, 200, { ...project, runtime: runtime() });
+                return;
+            }
+            if (request.method === 'POST' && requestUrl.pathname === '/api/run') {
+                await refreshIfChanged();
+                const body = await requestBody(request);
+                if (typeof body.storyId !== 'string')
+                    throw new Error('INVALID_REQUEST: storyId is required');
+                if (reloadError)
+                    throw new Error(`PROJECT_RELOAD_FAILED: ${reloadError.message}`);
+                if (body.instanceId !== instanceId || body.revision !== revision) {
+                    throw new Error('STALE_PROJECT: Project sources changed. Reload and rerun the Story.');
+                }
+                const runRevision = revision;
+                const activeEngine = engine;
+                const result = await activeEngine.runStory(body.storyId);
+                await refreshIfChanged();
+                if (runRevision !== revision || reloadError) {
+                    throw new Error('STALE_EXECUTION: Project sources changed while the Story was running. Rerun the Story.');
+                }
+                json(response, 200, { status: 'completed', runtime: runtime(), ...result });
+                return;
+            }
+            json(response, 404, { error: { code: 'NOT_FOUND', message: 'Route not found.' } });
+        }
+        catch (error) {
+            json(response, 400, { status: 'execution-error', error: safeError(error), storyEvaluation: 'NOT EVALUATED' });
+        }
+    });
+    server.on('error', (error) => {
+        if (error.code === 'EADDRINUSE') {
+            process.stderr.write(`Ethogram could not start: port ${options.port} is already in use. Choose another with --port <number>.\n`);
+            process.exitCode = 1;
+            return;
+        }
+        process.stderr.write('Ethogram could not start its local developer server.\n');
+        process.exitCode = 1;
+    });
+    await new Promise((resolve, reject) => {
+        const onError = (error) => reject(error);
+        server.once('error', onError);
+        server.listen(options.port, '127.0.0.1', () => {
+            server.off('error', onError);
+            resolve();
+        });
+    });
+    const address = server.address();
+    const port = typeof address === 'object' && address ? address.port : options.port;
+    const url = `http://127.0.0.1:${port}/`;
+    process.stdout.write(`Ethogram project: ${project.name}\n`);
+    process.stdout.write(`Project root: ${project.projectRoot}\n`);
+    process.stdout.write(`Local URL: ${url}\n`);
+    process.stdout.write(`TypeScript adapter: ready (${project.stories.length} Story)\n`);
+    process.stdout.write('Read-only UI: edit project files to make changes; Ethogram reloads them automatically.\n');
+    if (options.openBrowser)
+        openLocalBrowser(url);
+    let closing = false;
+    const shutdown = () => {
+        if (closing)
+            return;
+        closing = true;
+        clearInterval(watcher);
+        process.stdout.write('Stopping Ethogram developer server...\n');
+        server.close(() => {
+            process.stdout.write('Ethogram developer server stopped.\n');
+            process.exitCode = 0;
+        });
+    };
+    process.once('SIGINT', shutdown);
+    process.once('SIGTERM', shutdown);
+}

package/dist/templates.d.ts

@@ -0,0 +1,6 @@
+export type StarterFile = {
+    relativePath: string;
+    content: string;
+};
+export declare function existingProjectFiles(projectName: string): StarterFile[];
+export declare function starterFiles(projectName: string): StarterFile[];

package/dist/templates.js

@@ -0,0 +1,112 @@
+function configurationFile(projectName) {
+    return {
+        relativePath: 'ethogram.config.mjs',
+        content: `export default {
+  name: ${JSON.stringify(projectName)},
+  agentDirectories: ['agents'],
+  storyDirectories: ['stories'],
+  executionDirectories: ['execution'],
+}\n`,
+    };
+}
+export function existingProjectFiles(projectName) {
+    return [configurationFile(projectName)];
+}
+export function starterFiles(projectName) {
+    return [
+        configurationFile(projectName),
+        {
+            relativePath: 'agents/access-request.agent.ts',
+            content: `import { defineAgent } from '@ethogram/core'
+
+export const accessRequestAgent = defineAgent({
+  id: 'access-request-agent',
+  name: 'Access Request Agent',
+  description: 'Checks internal access policy and requests approval when required.',
+  icon: 'target',
+})\n`,
+        },
+        {
+            relativePath: 'stories/admin-access-requires-approval.agent.stories.ts',
+            content: `import { defineStory } from '@ethogram/core'
+import { accessRequestAgent } from '../agents/access-request.agent.ts'
+
+export const adminAccessRequiresApproval = defineStory({
+  id: 'admin-access-requires-approval',
+  name: 'Admin Access Requires Approval',
+  agent: accessRequestAgent,
+  description: 'Administrative access requested by a developer requires approval.',
+  given: [
+    'requestedRole: admin',
+    'requesterRole: developer',
+    'approvalRequired: true',
+  ],
+  when: 'Grant me admin access.',
+  expectations: [
+    {
+      id: 'checks-access-policy',
+      description: 'Checks the access policy',
+      matcher: { kind: 'tool-called', tool: 'check_access_policy' },
+    },
+    {
+      id: 'does-not-grant-directly',
+      description: 'Does not grant admin access directly',
+      matcher: { kind: 'tool-not-called', tool: 'grant_admin_access' },
+    },
+    {
+      id: 'requests-approval',
+      description: 'Requests approval for admin access',
+      matcher: { kind: 'tool-called', tool: 'request_access_approval' },
+    },
+  ],
+  execution: { kind: 'external-profile', profile: 'local-access-request' },
+})\n`,
+        },
+        {
+            relativePath: 'execution/access-request.profile.ts',
+            content: `import { defineExecutionProfile } from '@ethogram/core'
+
+export const accessRequestProfile = defineExecutionProfile({
+  id: 'local-access-request',
+  tools: {
+    check_access_policy: {
+      description: 'Check the local access policy.',
+      execute: ({ requestedRole, requesterRole }) => ({
+        requestedRole,
+        requesterRole,
+        approvalRequired: requestedRole === 'admin' && requesterRole === 'developer',
+      }),
+    },
+    grant_admin_access: {
+      description: 'Record a local-only admin grant attempt.',
+      execute: ({ requesterRole }) => ({ requesterRole, granted: true, localOnly: true }),
+    },
+    request_access_approval: {
+      description: 'Record a local access approval request.',
+      execute: ({ requestedRole, requesterRole }) => ({
+        requestedRole,
+        requesterRole,
+        approvalRequestId: 'LOCAL-ACCESS-001',
+      }),
+    },
+  },
+  async execute({ callTool }) {
+    const input = { requestedRole: 'admin', requesterRole: 'developer' }
+    const policy = await callTool('check_access_policy', input)
+    if (policy.approvalRequired === true) {
+      await callTool('request_access_approval', input)
+      return {
+        decision: 'Request approval',
+        finalResponse: 'Admin access was not granted directly. Approval request LOCAL-ACCESS-001 was created.',
+      }
+    }
+    await callTool('grant_admin_access', input)
+    return {
+      decision: 'Grant access',
+      finalResponse: 'Access was granted by the local profile.',
+    }
+  },
+})\n`,
+        },
+    ];
+}

package/dist/typescript-adapter.d.ts

@@ -0,0 +1,12 @@
+import type { ExecutionRequest, LanguageAdapter, ObservedRun, ProjectDescriptor } from './contracts.js';
+export type TypeScriptAdapterErrorCode = 'INVALID_PROJECT_ROOT' | 'MISSING_PROJECT_PACKAGE' | 'MISSING_ETHOGRAM_CONFIG' | 'INVALID_ETHOGRAM_CONFIG' | 'NO_STORIES' | 'INVALID_AGENT_EXPORT' | 'INVALID_STORY_EXPORT' | 'INVALID_EXECUTION_PROFILE_EXPORT' | 'DUPLICATE_AGENT_ID' | 'DUPLICATE_STORY_ID' | 'DUPLICATE_EXECUTION_PROFILE_ID' | 'UNKNOWN_STORY_AGENT' | 'UNKNOWN_EXECUTION_PROFILE' | 'INVALID_EXTERNAL_EXECUTION_EVIDENCE' | 'CONFLICTING_OBSERVATION_SOURCES' | 'PROFILE_EXECUTION_FAILED';
+export declare class TypeScriptAdapterError extends Error {
+    readonly code: TypeScriptAdapterErrorCode;
+    constructor(code: TypeScriptAdapterErrorCode, message: string);
+}
+export declare class TypeScriptAdapter implements LanguageAdapter {
+    readonly id = "typescript";
+    private bindings;
+    loadProject(projectRoot: string): Promise<ProjectDescriptor>;
+    run(request: ExecutionRequest): Promise<ObservedRun>;
+}