attesso 0.9.0 → 0.10.0

package/README.md

@@ -22,10 +22,10 @@ are appended, and writes mode and path changes to the same files the hook reads:
 
 ```sh
 npx attesso ui
-npx attesso ui --port 0 --no-open
+npx attesso ui --no-open
 ```
 
-The server binds `127.0.0.1`, mints a per-process token, and serves the page from
+The server binds `127.0.0.1:8197`, mints a per-process token, and serves the page from
 the installed package. It has no account, no hosted data, and no dependency on a
 snapshot file. `Ctrl-C` stops it.
 

package/bin/attesso.mjs

@@ -78,6 +78,7 @@ const USAGE = `attesso: a local, signed ledger of what your agents attempted
   attesso mode [observe|enforce|off]  read or set the active hook mode
   attesso paths [--json|--set FILE]   read or replace the filesystem scope
   attesso ui [--port N] [--no-open]    local control surface for the signed ledger
+                                     (default 127.0.0.1:8197)
   attesso policy pull [--url URL] [--apply] [--json]
                                      verify the hosted rule bundle and optionally
                                      write rules.json (key from ATTESSO_API_KEY)
@@ -697,11 +698,12 @@ switch (command) {
   case 'ui': {
     try {
       const options = flags(rest);
-      const requested = options.port === undefined ? 0 : Number(options.port);
+      const requested = options.port === undefined ? 8197 : Number(options.port);
       if (!Number.isInteger(requested) || requested < 0 || requested > 65535) {
         console.error('ui: --port must be an integer from 0 to 65535');
         process.exit(2);
       }
+      requireLedger();
       const ui = await startUi({
         dir: DIR,
         cwd: process.cwd(),

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "attesso",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "Bounds: decide an AI agent's next tool call before it runs, with a signed record. Free and unlimited locally, $0.00085 per synced decision.",
   "license": "Apache-2.0",
   "type": "module",
   "bin": {
-    "attesso": "./bin/attesso.mjs",
-    "attesso-mcp": "./bin/attesso-mcp.mjs",
-    "attesso-control-mcp": "./bin/attesso-control-mcp.mjs"
+    "attesso": "bin/attesso.mjs",
+    "attesso-mcp": "bin/attesso-mcp.mjs",
+    "attesso-control-mcp": "bin/attesso-control-mcp.mjs"
   },
   "files": [
     "bin",

package/src/connect.mjs

@@ -78,12 +78,15 @@ function wiredHarnesses(harnesses, { dir, cwd }) {
   });
 }
 
-function instructions({ mode, wired, manual }) {
+function instructions({ initialized, mode, wired, manual }) {
+  if (!initialized) return ['run `attesso init` first'];
   const next = [];
   if (!mode) next.push('run `attesso connect --write --mode observe` from the agent');
   else if (mode === 'off') next.push('run `attesso mode observe` to start recording');
   if (manual.length) next.push('wire the listed harnesses by hand, or use the generic hook contract');
-  if (mode && !wired.length) next.push('run `attesso connect --write --mode observe` from the agent');
+  if (mode && !wired.length && !manual.length) {
+    next.push('no agent harness detected; wire the generic hook contract or run `attesso connect` from an agent project');
+  }
   return next;
 }
 
@@ -101,7 +104,7 @@ export function status({ dir, cwd = process.cwd(), home = homedir() } = {}) {
     wired: wired.map((harness) => harness.key),
     manual: manual.map((harness) => harness.key),
     connected: initialized && mode !== null && mode !== 'off' && wired.length > 0,
-    next: instructions({ mode, wired, manual }),
+    next: instructions({ initialized, mode, wired, manual }),
   };
 }
 
@@ -163,6 +166,6 @@ export function connect({
     wired: wired.map((result) => result.key),
     manual: results.filter((result) => result.manual || result.error || result.reason?.includes('merge by hand')).map((result) => result.key),
     agent_context: agentContext,
-    next: instructions({ mode: effectiveMode, wired, manual: results.filter((result) => result.manual || result.error) }),
+    next: instructions({ initialized: isInitialised(ledgerDir), mode: effectiveMode, wired, manual: results.filter((result) => result.manual || result.error) }),
   };
 }

package/src/ui/static/index.html

@@ -69,6 +69,7 @@
   .badge{border:1px solid #ead6b3;background:#fbf5e8;color:#7a4b12;padding:2px 6px;font-size:10px}
   .actions{display:flex;gap:7px;align-items:center}
   .button{border:1px solid #d0d5dd;background:#fff;color:var(--body);padding:7px 11px;font-size:12px;cursor:pointer}
+  .button:disabled{opacity:.4;cursor:default}
   .button.primary{border-color:var(--ink);background:var(--ink);color:#fff}
   .button:hover{background:#f2f4f7}
   .page{max-width:1440px;padding:24px 30px 48px}
@@ -303,7 +304,7 @@
     <div class="topbar">
       <div class="crumbs"><span>Bounds</span><span>/</span><span class="current">local</span><span class="badge">ledger</span></div>
       <div class="actions">
-        <button class="button" type="button" id="export-draft">Export draft</button>
+        <button class="button" type="button" id="export-draft" title="Set a rule on a block first" disabled>Export draft</button>
         <button class="button" type="button" id="all-calls">All calls</button>
       </div>
     </div>
@@ -687,9 +688,12 @@
       el('agent-action').textContent = 'Manage agent';
     } else {
       const wired = Array.isArray(agentData.wired) ? agentData.wired.length : 0;
+      const recorded = days.reduce((total, day) => total + summarize(day).calls, 0);
       el('agent-sub').textContent = wired
         ? 'Hook is ' + (agentData.mode || 'not configured') + ' - connect any agent to start observing'
-        : 'No harness wired - connect an agent to start observing';
+        : recorded > 0
+          ? fmt(recorded) + ' recorded calls; no harness wired'
+          : 'No harness wired - connect an agent to start observing';
       el('agent-action').textContent = 'Connect agent';
     }
     renderAgentPanel();
@@ -1044,6 +1048,7 @@
     closePopover();
     applyFlowFilter();
     renderTokens(day);
+    updateExportDraft();
   }
 
   function renderV1Flow(day, preserveCenter = null) {
@@ -1132,6 +1137,7 @@
     closePopover();
     applyFlowFilter();
     renderTokens(day);
+    updateExportDraft();
   }
 
   function applyFlowFilter() {
@@ -1328,6 +1334,7 @@
       if (allOn) drafts.delete(key); else drafts.set(key, state);
     }
     updateMarkerDraft(marker);
+    updateExportDraft();
     const popover = el('flow-popover');
     if (popover && !popover.hidden) {
       const draft = popover.querySelector('#fp-block-draft');
@@ -1347,6 +1354,7 @@
       if (!row) continue;
       if (next === 'unset') drafts.delete(String(row[0])); else drafts.set(String(row[0]), next);
     }
+    updateExportDraft();
     const marker = selectedMarker || markerBySeq.get(key);
     if (marker) {
       marker.classList.remove('draft-allow', 'draft-deny', 'draft-ask');
@@ -1382,6 +1390,10 @@
   async function renderDay(day) {
     if (!calls[day] && !v1) return;
     const request = ++dayRequest;
+    if (selectedDay !== day && drafts.size > 0) {
+      drafts.clear();
+      updateExportDraft();
+    }
     selectedDay = day;
     callsDay = day;
     callsPage = 0;
@@ -1414,7 +1426,15 @@
     renderFlow(selectedDay, centerMinute);
   }
 
+  function updateExportDraft() {
+    const button = el('export-draft');
+    if (!button) return;
+    button.disabled = drafts.size === 0;
+    button.title = drafts.size === 0 ? 'Set a rule on a block first' : '';
+  }
+
   function exportDraft() {
+    if (drafts.size === 0) return;
     const output = {
       generated_at: new Date().toISOString(),
       day: selectedDay,