expressible 0.1.2 → 0.1.3

package/README.md

@@ -1,15 +1,13 @@
 # Expressible CLI
 
-Open-source developer tools by [Expressible AI, Inc.](https://expressible.ai)
+Train small, local text classifiers from labeled examples. No API keys, no cloud, no Python, no GPU. Your data never leaves your machine.
 
-The Expressible CLI provides local-first tooling for AI workflows where data sovereignty matters. It is part of the [Expressible platform](https://gen.expressible.ai) for secure, end-to-end software delivery.
+Open source (Apache 2.0) · Built by [Expressible AI](https://expressible.ai)
 
 ---
 
 ## Distill
 
-Train small, task-specific ML models from input/output examples. Runs entirely on your machine. Your data never leaves your environment.
-
 ![Expressible Distill demo](https://raw.githubusercontent.com/expressibleai/expressible-cli/refs/heads/main/demo.svg)
 
 ```
@@ -136,6 +134,10 @@ Everything.
 
 ---
 
+Works in environments where data can't leave the network — healthcare, financial services, legal, government, or any organization with data residency requirements.
+
+---
+
 ### Use Cases
 
 **Legal document review** — Classify contract clauses by type across thousands of agreements. Privileged documents stay within your perimeter.
@@ -160,25 +162,17 @@ With 50 labeled examples (~30 minutes of work), no API keys, and no ML expertise
 | 20 Newsgroups (5 categories) | 80.0% | [Public dataset](https://huggingface.co/datasets/SetFit/20_newsgroups) |
 | AG News (4 categories) | 64.0% | [Public dataset](https://huggingface.co/datasets/fancyzhx/ag_news) |
 
-AG News improves to 80% with 100 training samples. More data helps — see [benchmarks](docs/benchmarks.md) for scaling details.
-
-Public dataset results use real-world text from established ML benchmarks — 50 samples drawn from datasets containing 120,000+ entries. All samples and the test harness are included in the repo so you can reproduce these results:
+Reproduce these results:
 
 ```bash
 npx tsx tests/harness/run.ts
 ```
 
-Accuracy improves as you add more examples through the review-retrain loop. Full results, methodology, and known limitations: **[docs/benchmarks.md](docs/benchmarks.md)**
-
----
+**Known limitation:** Distill struggles with sentiment and tone classification (44–50% accuracy). The embedding model captures what text is *about*, not how it *evaluates*. "Amazing camera" and "terrible camera" produce nearly identical vectors. Details in [benchmarks](docs/benchmarks.md).
 
-### Built for Environments Where Data Stays Internal
+AG News improves to 80% with 100 training samples. More data helps — see [benchmarks](docs/benchmarks.md) for scaling details. Public dataset results use real-world text from established ML benchmarks — 50 samples drawn from datasets containing 120,000+ entries.
 
-- Healthcare teams handling patient records
-- Financial services processing sensitive transactions
-- Government contractors with data residency requirements
-- Legal teams working with privileged documents
-- Any organization with data sovereignty obligations
+Accuracy improves as you add more examples through the review-retrain loop. Full results, methodology, and known limitations: **[docs/benchmarks.md](docs/benchmarks.md)**
 
 ---
 
@@ -248,9 +242,7 @@ my-task/
 
 ---
 
-### Expressible Platform
-
-The CLI is the open-source, local-first layer of the Expressible platform. For teams that need governance, traceability, and managed deployment across AI-generated workloads, see [expressible.ai](https://expressible.ai).
+The CLI is fully standalone and open source. [Expressible AI](https://expressible.ai) offers additional tooling for teams that need governance and managed deployment.
 
 ### Contributing
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "expressible",
-  "version": "0.1.2",
-  "description": "Open-source CLI toolkit by Expressible AI, Inc.",
+  "version": "0.1.3",
+  "description": "Train small, local text classifiers from labeled examples. No API keys, no cloud, no GPU.",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
@@ -14,8 +14,17 @@
     "test": "vitest run",
     "test:watch": "vitest"
   },
-  "keywords": ["ml", "local", "training", "cli", "inference"],
+  "keywords": ["ml", "local", "training", "cli", "inference", "classification", "nlp", "text-classification", "offline", "on-premise"],
   "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/expressibleai/expressible-cli.git"
+  },
+  "homepage": "https://expressible.ai",
+  "bugs": {
+    "url": "https://github.com/expressibleai/expressible-cli/issues"
+  },
+  "author": "Expressible AI, Inc.",
   "dependencies": {
     "@tensorflow/tfjs": "^4.22.0",
     "@tensorflow/tfjs-node": "^4.22.0",

package/dist/ui/static/static/index.html

@@ -1,486 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>Distill — Review</title>
-  <style>
-    * { margin: 0; padding: 0; box-sizing: border-box; }
-
-    body {
-      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
-      background: #f5f5f5;
-      color: #333;
-      min-height: 100vh;
-    }
-
-    .header {
-      background: #fff;
-      border-bottom: 1px solid #e0e0e0;
-      padding: 16px 24px;
-      display: flex;
-      align-items: center;
-      justify-content: space-between;
-      flex-wrap: wrap;
-      gap: 12px;
-    }
-
-    .header h1 {
-      font-size: 20px;
-      font-weight: 600;
-      color: #111;
-    }
-
-    .header h1 span {
-      color: #6366f1;
-    }
-
-    .stats-bar {
-      display: flex;
-      gap: 20px;
-      font-size: 13px;
-      color: #666;
-    }
-
-    .stats-bar .stat-value {
-      font-weight: 600;
-      color: #333;
-    }
-
-    .progress-container {
-      background: #fff;
-      padding: 12px 24px;
-      border-bottom: 1px solid #e0e0e0;
-    }
-
-    .progress-bar {
-      width: 100%;
-      height: 6px;
-      background: #e5e7eb;
-      border-radius: 3px;
-      overflow: hidden;
-    }
-
-    .progress-fill {
-      height: 100%;
-      background: #6366f1;
-      border-radius: 3px;
-      transition: width 0.3s ease;
-    }
-
-    .progress-text {
-      font-size: 12px;
-      color: #999;
-      margin-top: 4px;
-    }
-
-    .main {
-      max-width: 1200px;
-      margin: 24px auto;
-      padding: 0 24px;
-    }
-
-    .panels {
-      display: grid;
-      grid-template-columns: 1fr 1fr;
-      gap: 16px;
-      margin-bottom: 20px;
-    }
-
-    @media (max-width: 768px) {
-      .panels { grid-template-columns: 1fr; }
-    }
-
-    .panel {
-      background: #fff;
-      border: 1px solid #e0e0e0;
-      border-radius: 8px;
-      overflow: hidden;
-    }
-
-    .panel-header {
-      padding: 12px 16px;
-      background: #fafafa;
-      border-bottom: 1px solid #e0e0e0;
-      font-size: 13px;
-      font-weight: 600;
-      text-transform: uppercase;
-      letter-spacing: 0.5px;
-      color: #888;
-    }
-
-    .panel-body {
-      padding: 16px;
-      font-size: 14px;
-      line-height: 1.6;
-      white-space: pre-wrap;
-      word-break: break-word;
-      min-height: 120px;
-      max-height: 400px;
-      overflow-y: auto;
-    }
-
-    .actions {
-      background: #fff;
-      border: 1px solid #e0e0e0;
-      border-radius: 8px;
-      padding: 20px;
-    }
-
-    .action-buttons {
-      display: flex;
-      gap: 12px;
-      justify-content: center;
-      margin-bottom: 16px;
-    }
-
-    .btn {
-      padding: 10px 32px;
-      border: 2px solid transparent;
-      border-radius: 8px;
-      font-size: 15px;
-      font-weight: 600;
-      cursor: pointer;
-      transition: all 0.15s ease;
-      display: flex;
-      align-items: center;
-      gap: 8px;
-    }
-
-    .btn:active { transform: scale(0.97); }
-
-    .btn-approve {
-      background: #ecfdf5;
-      color: #059669;
-      border-color: #a7f3d0;
-    }
-    .btn-approve:hover { background: #d1fae5; }
-    .btn-approve.active { background: #059669; color: #fff; }
-
-    .btn-reject {
-      background: #fef2f2;
-      color: #dc2626;
-      border-color: #fecaca;
-    }
-    .btn-reject:hover { background: #fee2e2; }
-    .btn-reject.active { background: #dc2626; color: #fff; }
-
-    .correction-area {
-      margin-top: 12px;
-      display: none;
-    }
-
-    .correction-area.visible {
-      display: block;
-    }
-
-    .correction-area label {
-      display: block;
-      font-size: 13px;
-      font-weight: 500;
-      color: #666;
-      margin-bottom: 6px;
-    }
-
-    .correction-area textarea {
-      width: 100%;
-      min-height: 80px;
-      padding: 10px 12px;
-      border: 1px solid #d1d5db;
-      border-radius: 6px;
-      font-family: 'SF Mono', Monaco, Consolas, monospace;
-      font-size: 13px;
-      resize: vertical;
-    }
-
-    .correction-area textarea:focus {
-      outline: none;
-      border-color: #6366f1;
-      box-shadow: 0 0 0 3px rgba(99, 102, 241, 0.1);
-    }
-
-    .nav {
-      display: flex;
-      justify-content: space-between;
-      align-items: center;
-      margin-top: 16px;
-    }
-
-    .nav-btn {
-      padding: 8px 20px;
-      border: 1px solid #d1d5db;
-      border-radius: 6px;
-      background: #fff;
-      font-size: 14px;
-      cursor: pointer;
-      color: #374151;
-    }
-    .nav-btn:hover { background: #f9fafb; }
-    .nav-btn:disabled { opacity: 0.4; cursor: not-allowed; }
-
-    .nav-info {
-      font-size: 14px;
-      color: #666;
-    }
-
-    .done-btn {
-      padding: 8px 20px;
-      border: 1px solid #6366f1;
-      border-radius: 6px;
-      background: #6366f1;
-      color: #fff;
-      font-size: 14px;
-      font-weight: 500;
-      cursor: pointer;
-    }
-    .done-btn:hover { background: #4f46e5; }
-
-    .empty-state {
-      text-align: center;
-      padding: 60px 20px;
-      color: #999;
-    }
-
-    .keyboard-hint {
-      text-align: center;
-      font-size: 12px;
-      color: #aaa;
-      margin-top: 10px;
-    }
-
-    kbd {
-      padding: 2px 6px;
-      background: #f3f4f6;
-      border: 1px solid #d1d5db;
-      border-radius: 3px;
-      font-size: 11px;
-      font-family: inherit;
-    }
-  </style>
-</head>
-<body>
-  <div class="header">
-    <h1><span>distill</span> — Review</h1>
-    <div class="stats-bar" id="stats-bar">
-      <div>Reviewed: <span class="stat-value" id="stat-reviewed">0</span></div>
-      <div>Approved: <span class="stat-value" id="stat-approved">0</span></div>
-      <div>Rejected: <span class="stat-value" id="stat-rejected">0</span></div>
-      <div>Approval rate: <span class="stat-value" id="stat-rate">—</span></div>
-    </div>
-  </div>
-
-  <div class="progress-container">
-    <div class="progress-bar">
-      <div class="progress-fill" id="progress-fill" style="width: 0%"></div>
-    </div>
-    <div class="progress-text" id="progress-text">Loading...</div>
-  </div>
-
-  <div class="main">
-    <div id="content">
-      <div class="panels">
-        <div class="panel">
-          <div class="panel-header">Input</div>
-          <div class="panel-body" id="input-display"></div>
-        </div>
-        <div class="panel">
-          <div class="panel-header">Predicted Output</div>
-          <div class="panel-body" id="output-display"></div>
-        </div>
-      </div>
-
-      <div class="actions">
-        <div class="action-buttons">
-          <button class="btn btn-approve" id="btn-approve" onclick="score(true)">
-            👍 Approve
-          </button>
-          <button class="btn btn-reject" id="btn-reject" onclick="score(false)">
-            👎 Reject
-          </button>
-        </div>
-
-        <div class="correction-area" id="correction-area">
-          <label for="correction">What should the correct output be?</label>
-          <textarea id="correction" placeholder="Enter the correct output..."></textarea>
-        </div>
-
-        <div class="nav">
-          <button class="nav-btn" id="btn-prev" onclick="navigate(-1)">← Previous</button>
-          <span class="nav-info" id="nav-info">— / —</span>
-          <button class="nav-btn" id="btn-next" onclick="navigate(1)">Next →</button>
-          <button class="done-btn" onclick="finish()">Done</button>
-        </div>
-
-        <div class="keyboard-hint">
-          <kbd>→</kbd> Approve &nbsp; <kbd>←</kbd> Reject &nbsp; <kbd>Enter</kbd> Next
-        </div>
-      </div>
-    </div>
-
-    <div class="empty-state" id="empty-state" style="display:none">
-      <h2>All items reviewed!</h2>
-      <p>You've reviewed all items. Close this tab or click Done.</p>
-    </div>
-  </div>
-
-  <script>
-    let items = [];
-    let currentIndex = 0;
-
-    async function init() {
-      const res = await fetch('/api/items');
-      items = await res.json();
-      if (items.length === 0) {
-        document.getElementById('content').style.display = 'none';
-        document.getElementById('empty-state').style.display = 'block';
-        return;
-      }
-      // Start at first unreviewed item
-      const firstUnreviewed = items.findIndex(i => !i.reviewedAt);
-      currentIndex = firstUnreviewed >= 0 ? firstUnreviewed : 0;
-      render();
-      updateStats();
-    }
-
-    function render() {
-      const item = items[currentIndex];
-      if (!item) return;
-
-      document.getElementById('input-display').textContent = item.input;
-      document.getElementById('output-display').textContent = item.predictedOutput;
-      document.getElementById('nav-info').textContent =
-        `${currentIndex + 1} / ${items.length}`;
-
-      document.getElementById('btn-prev').disabled = currentIndex === 0;
-      document.getElementById('btn-next').disabled = currentIndex === items.length - 1;
-
-      // Show current state
-      const approveBtn = document.getElementById('btn-approve');
-      const rejectBtn = document.getElementById('btn-reject');
-      const correctionArea = document.getElementById('correction-area');
-
-      approveBtn.classList.toggle('active', item.reviewedAt && item.approved === true);
-      rejectBtn.classList.toggle('active', item.reviewedAt && item.approved === false);
-
-      if (item.reviewedAt && item.approved === false) {
-        correctionArea.classList.add('visible');
-        document.getElementById('correction').value = item.correctedOutput || '';
-      } else {
-        correctionArea.classList.remove('visible');
-        document.getElementById('correction').value = '';
-      }
-    }
-
-    async function score(approved) {
-      const item = items[currentIndex];
-      const correctedOutput = !approved
-        ? document.getElementById('correction').value.trim() || undefined
-        : undefined;
-
-      await fetch('/api/score', {
-        method: 'POST',
-        headers: { 'Content-Type': 'application/json' },
-        body: JSON.stringify({
-          id: item.id,
-          approved,
-          correctedOutput,
-        }),
-      });
-
-      item.approved = approved;
-      item.reviewedAt = new Date().toISOString();
-      if (correctedOutput) item.correctedOutput = correctedOutput;
-
-      // Show/hide correction area
-      const correctionArea = document.getElementById('correction-area');
-      if (!approved) {
-        correctionArea.classList.add('visible');
-        document.getElementById('correction').focus();
-      } else {
-        correctionArea.classList.remove('visible');
-      }
-
-      render();
-      updateStats();
-
-      // Auto-advance on approve
-      if (approved && currentIndex < items.length - 1) {
-        setTimeout(() => navigate(1), 300);
-      }
-    }
-
-    function navigate(delta) {
-      const newIndex = currentIndex + delta;
-      if (newIndex >= 0 && newIndex < items.length) {
-        // Save any pending correction before navigating
-        const item = items[currentIndex];
-        if (item.reviewedAt && item.approved === false) {
-          const correction = document.getElementById('correction').value.trim();
-          if (correction && correction !== item.correctedOutput) {
-            fetch('/api/score', {
-              method: 'POST',
-              headers: { 'Content-Type': 'application/json' },
-              body: JSON.stringify({
-                id: item.id,
-                approved: false,
-                correctedOutput: correction,
-              }),
-            });
-            item.correctedOutput = correction;
-          }
-        }
-        currentIndex = newIndex;
-        render();
-      }
-    }
-
-    async function updateStats() {
-      const res = await fetch('/api/stats');
-      const stats = await res.json();
-
-      document.getElementById('stat-reviewed').textContent = stats.reviewed;
-      document.getElementById('stat-approved').textContent = stats.approved;
-      document.getElementById('stat-rejected').textContent = stats.rejected;
-      document.getElementById('stat-rate').textContent =
-        stats.reviewed > 0 ? stats.approvalRate + '%' : '—';
-
-      const pct = stats.total > 0 ? (stats.reviewed / stats.total) * 100 : 0;
-      document.getElementById('progress-fill').style.width = pct + '%';
-      document.getElementById('progress-text').textContent =
-        `${stats.reviewed} of ${stats.total} reviewed`;
-
-      if (stats.remaining === 0 && stats.total > 0) {
-        document.getElementById('content').style.display = 'none';
-        document.getElementById('empty-state').style.display = 'block';
-      }
-    }
-
-    async function finish() {
-      if (confirm('End review session?')) {
-        await fetch('/api/shutdown', { method: 'POST' });
-        document.body.innerHTML =
-          '<div style="display:flex;align-items:center;justify-content:center;height:100vh;color:#666;font-family:sans-serif">' +
-          '<div style="text-align:center"><h2>Review complete</h2><p>You can close this tab.</p></div></div>';
-      }
-    }
-
-    // Keyboard shortcuts
-    document.addEventListener('keydown', (e) => {
-      if (e.target.tagName === 'TEXTAREA') return;
-
-      if (e.key === 'ArrowRight') {
-        e.preventDefault();
-        score(true);
-      } else if (e.key === 'ArrowLeft') {
-        e.preventDefault();
-        score(false);
-      } else if (e.key === 'Enter') {
-        e.preventDefault();
-        navigate(1);
-      }
-    });
-
-    init();
-  </script>
-</body>
-</html>