@ethogram/cli 0.1.0-alpha.0

package/dist/runtime/app.js

@@ -0,0 +1,227 @@
+const app = document.querySelector('#app')
+let currentProject
+let currentStoryId
+let currentRuntime
+let evidenceIsCurrent = false
+
+const escapeHtml = (value) => String(value)
+  .replaceAll('&', '&')
+  .replaceAll('<', '&lt;')
+  .replaceAll('>', '&gt;')
+  .replaceAll('"', '&quot;')
+  .replaceAll("'", '&#039;')
+
+const prettyJson = (value) => {
+  try { return JSON.stringify(JSON.parse(value), null, 2) } catch { return value }
+}
+
+const availableText = (value, format = (entry) => String(entry)) => value === undefined
+  ? 'Unavailable'
+  : format(value)
+
+const displayGivenValue = (value) => typeof value === 'string' ? value : JSON.stringify(value)
+
+const givenEntries = (story) => Array.isArray(story.given)
+  ? story.given.map((line) => {
+      const separator = line.indexOf(':')
+      return separator === -1
+        ? { key: line, value: '' }
+        : { key: line.slice(0, separator).trim(), value: line.slice(separator + 1).trim() }
+    })
+  : Object.entries(story.given).map(([key, value]) => ({ key, value: displayGivenValue(value) }))
+
+function panel(title, content, right = '') {
+  return `<section class="panel"><header><strong>${title}</strong>${right}</header>${content}</section>`
+}
+
+function storyShell(project, story) {
+  const agent = project.agents.find((candidate) => candidate.id === story.agent.id) ?? story.agent
+  const agentStories = project.stories.filter((candidate) => candidate.agent.id === agent.id)
+  const storyNavigation = agentStories.map((candidate) => `
+    <button class="story-link ${candidate.id === story.id ? 'selected' : ''}" data-story-id="${escapeHtml(candidate.id)}">
+      <span class="status-dot"></span>${escapeHtml(candidate.name)}<em>STORY</em>
+    </button>`).join('')
+  const given = givenEntries(story).map(({ key, value }) => `
+    <div class="given-row"><span>${escapeHtml(key)}</span><strong>${escapeHtml(value)}</strong></div>`).join('')
+  const expectations = story.expectations.map((expectation) => `
+    <div class="assertion" data-testid="assertion" data-expectation-id="${escapeHtml(expectation.id)}" data-verdict="NOT EVALUATED">
+      <span class="assertion-icon pending">·</span>
+      <div><strong>${escapeHtml(expectation.description)}</strong><small>Not evaluated</small></div>
+    </div>`).join('')
+
+  app.innerHTML = `
+    <aside class="sidebar">
+      <div class="brand"><svg class="brand-mark" viewBox="0 0 64 64" aria-hidden="true"><path d="M32 10L49.3 22L39.8 36.5L32 51L18.1 40L13.8 21.5Z"></path></svg><span>Ethogram</span><span class="codename">alpha</span></div>
+      <div class="project"><span class="online-dot"></span><strong data-testid="project-name">${escapeHtml(project.name)}</strong><span class="project-local">local</span></div>
+      <label class="search"><span aria-hidden="true">⌕</span><input aria-label="Filter stories" placeholder="Filter stories"><kbd>⌘ K</kbd></label>
+      <div class="nav-label">AGENTS</div>
+      <button class="agent-link selected"><span class="agent-glyph" aria-hidden="true">◇</span>${escapeHtml(agent.name)} <span>${agentStories.length}</span></button>
+      <div class="story-list">${storyNavigation}</div>
+      <div class="sidebar-footer"><span>Code-first · read-only UI</span><small>${escapeHtml(project.adapter.label)} adapter · local</small></div>
+    </aside>
+    <main class="main" data-project-source="consumer" data-adapter="${escapeHtml(project.adapter.id)}">
+      <header class="topbar">
+        <div class="breadcrumb">Agents <span>›</span> ${escapeHtml(agent.name)} <span>›</span> <strong>${escapeHtml(story.name)}</strong></div>
+        <button id="run-story" class="run-button" data-testid="run-story"><span aria-hidden="true">▶</span> Run Story</button>
+      </header>
+      <section class="story-meta">
+        <div class="story-symbol"><svg viewBox="0 0 64 64" aria-hidden="true"><path d="M32 10L49.3 22L39.8 36.5L32 51L18.1 40L13.8 21.5Z"></path></svg></div>
+        <div><h1>${escapeHtml(story.name)}</h1><p>${escapeHtml(story.description)}</p></div>
+        <span class="source" data-testid="story-source">${escapeHtml(story.source)}</span>
+      </section>
+      <nav class="tabs"><button class="active">Canvas</button></nav>
+      <div class="scope-banner">GIVEN · WHEN · EXPECTATIONS are defined in project files. This UI reads and runs them; it does not save edits.</div>
+      <div id="execution-error" class="error-banner" hidden></div>
+      <div class="canvas">
+        <div class="canvas-main">
+          ${panel('GIVEN', `<div class="given-grid">${given}</div>`)}
+          ${panel('Configuration', `<div class="config-grid"><div><small>ADAPTER</small><strong>${escapeHtml(project.adapter.label)}</strong></div><div><small>EXECUTION</small><strong>Offline deterministic</strong></div><div><small>PROJECT</small><strong>Consumer owned</strong></div><div><small>ENVIRONMENT</small><strong><span class="online-dot"></span> localhost</strong></div></div>`)}
+          ${panel('WHEN', `<div class="input-box" data-testid="story-prompt">${escapeHtml(story.prompt)}</div>`)}
+          ${panel('Result', `<div id="result" class="result" data-evidence-state="empty"><div><small>STORY EVALUATION</small><strong id="story-verdict" data-testid="story-verdict">NOT EVALUATED</strong></div><div><small>DECISION</small><strong id="decision" data-testid="decision">Run the Story to observe behavior.</strong><p id="final-response" data-testid="final-response">No execution evidence yet.</p></div><div><small>EXPECTATIONS</small><strong id="assertion-count" data-testid="assertion-count">0 / ${story.expectations.length} passed</strong></div></div>`)}
+        </div>
+        <div class="canvas-side">
+          ${panel('Execution Timeline', '<div id="timeline" class="empty">No execution timeline yet.</div>', '<small id="timeline-count">0 events</small>')}
+          ${panel('Tool Calls', '<div id="tool-calls" class="empty">No tool calls observed yet.</div>', '<small id="tool-count">0 calls</small>')}
+          ${panel('Expectations', `<div id="assertions" class="assertions">${expectations}</div>`, `<small id="passed-count">0 / ${story.expectations.length} passed</small>`)}
+          ${panel('Metrics', '<div class="metrics"><div><small>PROVIDER</small><strong id="provider">Unavailable</strong></div><div><small>MODEL</small><strong id="model">Unavailable</strong></div><div><small>LATENCY</small><strong id="latency">Unavailable</strong></div><div><small>TOOLS CALLED</small><strong id="metric-tool-count">0</strong></div></div>')}
+        </div>
+      </div>
+      <output hidden data-testid="execution-evidence" id="execution-evidence"></output>
+    </main>`
+}
+
+function renderCompleted(story, payload) {
+  evidenceIsCurrent = true
+  currentRuntime = payload.runtime
+  const { observedRun, evaluationResult } = payload.execution
+  document.querySelector('#result').dataset.evidenceState = 'current'
+  document.querySelector('#story-verdict').textContent = evaluationResult.verdict
+  document.querySelector('#story-verdict').className = evaluationResult.verdict === 'PASS' ? 'pass' : 'fail'
+  document.querySelector('#decision').textContent = observedRun.decision
+  document.querySelector('#final-response').textContent = observedRun.finalResponse
+  const passed = Object.values(evaluationResult.expectations).filter((value) => value === 'PASS').length
+  document.querySelector('#assertion-count').textContent = `${passed} / ${story.expectations.length} passed`
+  document.querySelector('#passed-count').textContent = `${passed} / ${story.expectations.length} passed`
+  document.querySelector('#timeline-count').textContent = `${observedRun.timeline.length} events`
+  document.querySelector('#timeline').className = 'timeline'
+  document.querySelector('#timeline').innerHTML = observedRun.timeline.map((item, index) => `
+    <div class="timeline-row"><span class="timeline-icon">✓</span><div><strong>${escapeHtml(item.label)}</strong><small>${escapeHtml(item.detail)}</small></div><code>${escapeHtml(availableText(item.duration))}</code></div>`).join('')
+  document.querySelector('#tool-count').textContent = `${observedRun.toolCalls.length} calls`
+  document.querySelector('#metric-tool-count').textContent = String(observedRun.toolCalls.length)
+  document.querySelector('#tool-calls').className = 'tools'
+  document.querySelector('#tool-calls').innerHTML = observedRun.toolCalls.map((call) => {
+    const resultLabel = call.status === 'error' ? 'ERROR' : 'OUTPUT'
+    const resultValue = call.status === 'error' ? call.error : call.output
+    const renderedResult = resultValue === undefined
+      ? 'Unavailable'
+      : typeof resultValue === 'string' ? prettyJson(resultValue) : JSON.stringify(resultValue, null, 2)
+    return `
+    <details class="tool-call"><summary><code>${escapeHtml(call.name)}</code><span class="badge ${call.status === 'success' ? 'pass' : 'fail'}">${escapeHtml(call.status)}</span><small>${escapeHtml(availableText(call.duration))}</small></summary><div class="tool-json"><div><small>INPUT</small><pre>${escapeHtml(prettyJson(call.input))}</pre></div><div><small>${resultLabel}</small><pre>${escapeHtml(renderedResult)}</pre></div></div></details>`
+  }).join('')
+  document.querySelectorAll('[data-testid="assertion"]').forEach((row) => {
+    const id = row.dataset.expectationId
+    const verdict = evaluationResult.expectations[id]
+    row.dataset.verdict = verdict
+    row.querySelector('.assertion-icon').textContent = verdict === 'PASS' ? '✓' : '×'
+    row.querySelector('.assertion-icon').className = `assertion-icon ${verdict === 'PASS' ? 'pass' : 'fail'}`
+    const expectation = story.expectations.find((candidate) => candidate.id === id)
+    row.querySelector('small').textContent = `${expectation.matcher.kind}: ${expectation.matcher.tool}`
+  })
+  document.querySelector('#provider').textContent = availableText(observedRun.evidence.provider)
+  document.querySelector('#model').textContent = availableText(observedRun.evidence.model)
+  document.querySelector('#latency').textContent = availableText(observedRun.evidence.latencyMs, (value) => `${value}ms`)
+  document.querySelector('#execution-evidence').textContent = JSON.stringify(payload)
+}
+
+function markEvidenceStale(message) {
+  const banner = document.querySelector('#execution-error')
+  if (banner) {
+    banner.hidden = false
+    banner.textContent = message
+  }
+  if (!evidenceIsCurrent) return
+  evidenceIsCurrent = false
+  const result = document.querySelector('#result')
+  if (!result) return
+  result.dataset.evidenceState = 'stale'
+  const verdict = document.querySelector('#story-verdict')
+  verdict.textContent = 'STALE — RERUN REQUIRED'
+  verdict.className = 'stale'
+  document.querySelector('#decision').textContent = 'Previous evidence is no longer current.'
+  document.querySelector('#final-response').textContent = message
+  document.querySelector('#execution-evidence').textContent = ''
+}
+
+function bindStory(project, story) {
+  storyShell(project, story)
+  const filter = document.querySelector('.search input')
+  filter?.addEventListener('input', () => {
+    const query = filter.value.trim().toLowerCase()
+    document.querySelectorAll('[data-story-id]').forEach((link) => {
+      link.hidden = Boolean(query) && !link.textContent.toLowerCase().includes(query)
+    })
+  })
+  document.querySelectorAll('[data-story-id]').forEach((link) => {
+    link.addEventListener('click', () => {
+      const selected = project.stories.find((candidate) => candidate.id === link.dataset.storyId)
+      if (!selected) return
+      currentStoryId = selected.id
+      evidenceIsCurrent = false
+      bindStory(project, selected)
+    })
+  })
+  const button = document.querySelector('#run-story')
+  button.addEventListener('click', async () => {
+    if (button.disabled) return
+    button.disabled = true
+    button.textContent = '◌ Running…'
+    document.querySelector('#execution-error').hidden = true
+    try {
+      const runResponse = await fetch('/api/run', {
+        method: 'POST',
+        headers: { 'content-type': 'application/json' },
+        body: JSON.stringify({ storyId: story.id, ...currentRuntime }),
+      })
+      const payload = await runResponse.json()
+      if (!runResponse.ok || payload.status !== 'completed') throw new Error(payload.error?.message ?? 'Execution failed.')
+      renderCompleted(story, payload)
+    } catch (error) {
+      markEvidenceStale('Project or runtime changed. Previous evidence is stale; rerun this Story.')
+      const banner = document.querySelector('#execution-error')
+      banner.hidden = false
+      banner.textContent = error instanceof Error ? error.message : 'The Story execution failed.'
+    } finally {
+      button.disabled = false
+      button.textContent = '▶ Run Story'
+    }
+  })
+}
+
+async function load({ polling = false } = {}) {
+  try {
+    const response = await fetch('/api/project', { cache: 'no-store' })
+    const payload = await response.json()
+    if (!response.ok) throw new Error(payload.error?.message ?? 'The selected project could not be loaded.')
+    const runtimeChanged = currentRuntime
+      && (payload.runtime.instanceId !== currentRuntime.instanceId || payload.runtime.revision !== currentRuntime.revision)
+    if (polling && !runtimeChanged) return
+    if (runtimeChanged) markEvidenceStale('Ethogram detected changed project sources or a replaced runtime. Rerun the Story for current evidence.')
+    currentProject = payload
+    currentRuntime = payload.runtime
+    const story = payload.stories.find((candidate) => candidate.id === currentStoryId) ?? payload.stories[0]
+    if (!story) throw new Error('No Ethogram Stories were found.')
+    currentStoryId = story.id
+    evidenceIsCurrent = false
+    bindStory(payload, story)
+  } catch (error) {
+    const message = error instanceof Error ? error.message : 'Ethogram could not load.'
+    if (currentProject) {
+      markEvidenceStale(`Ethogram cannot confirm current project state: ${message}`)
+      return
+    }
+    app.innerHTML = `<div class="loading-card error">${escapeHtml(message)}</div>`
+  }
+}
+
+await load()
+setInterval(() => { void load({ polling: true }) }, 750)

package/dist/runtime/fonts/OFL-Archivo.txt

@@ -0,0 +1,93 @@
+Copyright 2020 The Archivo Project Authors (https://github.com/Omnibus-Type/Archivo)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/dist/runtime/fonts/OFL-JetBrains-Mono.txt

@@ -0,0 +1,93 @@
+Copyright 2020 The JetBrains Mono Project Authors (https://github.com/JetBrains/JetBrainsMono)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+https://openfontlicense.org
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/dist/runtime/index.html

@@ -0,0 +1,15 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <title>Ethogram Developer</title>
+    <link rel="stylesheet" href="/styles.css">
+  </head>
+  <body>
+    <div id="app" class="app-shell" aria-live="polite">
+      <div class="loading-card">Loading the selected Ethogram project…</div>
+    </div>
+    <script type="module" src="/app.js"></script>
+  </body>
+</html>