@getmarrow/install 0.1.3 → 0.1.5

package/README.md

@@ -11,8 +11,9 @@ npx @getmarrow/install --repair
 npx @getmarrow/install doctor
 ```
 
-## What's New in v0.1.3
+## What's New in v0.1.4
 
+- Installer self-test now finishes with a first-value summary: Marrow active state, captured surfaces, first useful lesson, value proof, and exact next action.
 - Generated SDK passive runtime enables one-call agent runtime checks by default with `MARROW_AGENT_RUNTIME=true`.
 - Self-test now verifies the runtime endpoint in addition to creating a harmless decision and committing its outcome.
 - `--repair` keeps dry-run behavior safe when `--dry-run` is present and reports whether one-call runtime was verified.
@@ -50,7 +51,7 @@ npx @getmarrow/install --md --dry-run
 
 ## Self-Test
 
-When `MARROW_API_KEY` is present, the installer creates a harmless test decision, commits the outcome, and reads `/v1/agent/status`.
+When `MARROW_API_KEY` is present, the installer creates a harmless test decision, commits the outcome, reads `/v1/agent/status`, calls the one-call runtime, and prints the first useful Marrow signal.
 
 ```bash
 MARROW_API_KEY=mrw_live_xxx npx @getmarrow/install --yes
@@ -77,3 +78,12 @@ MARROW_API_KEY=mrw_live_xxx npx @getmarrow/install --repair
 ## Trust Model
 
 This package is intended to be open source and auditable. It prints every file it will touch, requires `--yes` to write, does not store API keys in project files, and supports MCP-only, SDK-only, both, and markdown-only setups.
+
+---
+
+## Related Packages
+
+- **[@getmarrow/sdk](https://www.npmjs.com/package/@getmarrow/sdk)** — TypeScript/Node.js SDK for custom agent integrations, passive runtime hooks, guarded actions, and direct API access.
+- **[@getmarrow/mcp](https://www.npmjs.com/package/@getmarrow/mcp)** — MCP server for Claude Code, Claude Desktop, Cursor, and other MCP-compatible clients.
+
+**Docs:** [https://getmarrow.ai/docs](https://getmarrow.ai/docs)

package/bin/marrow-install.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+
+const { runCli } = require('../src/installer');
+
+runCli(process.argv.slice(2)).catch((error) => {
+  const message = error instanceof Error ? error.message : String(error);
+  process.stderr.write(`marrow-install failed: ${message}\n`);
+  process.exit(1);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getmarrow/install",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Universal installer for Marrow passive agent setup.",
   "bin": {
     "marrow-install": "bin/marrow-install.js"

package/src/installer.js

@@ -453,6 +453,12 @@ async function runSelfTest(options) {
     ok: false,
     error: error instanceof Error ? error.message : String(error),
   }));
+  const performance = await requestJson(`${baseUrl}/v1/analytics/agent-performance?period=7`, { headers })
+    .catch((error) => ({
+      ok: false,
+      error: error instanceof Error ? error.message : String(error),
+    }));
+  const firstValueSignal = buildFirstValueSignal(status, runtime, performance);
   return {
     skipped: false,
     decision_id: decisionId,
@@ -465,6 +471,50 @@ async function runSelfTest(options) {
     runtime_active: Boolean(runtime && runtime.ok !== false),
     runtime_exact_next_action: runtime.exact_next_action || null,
     runtime_before_you_act: runtime.before_you_act || null,
+    first_value_signal: firstValueSignal,
+    performance_proof: performance && performance.ok !== false ? {
+      avoided_mistakes: performance.avoided_mistakes ?? performance.avoided_repeated_mistakes ?? 0,
+      reused_winning_decisions: performance.reused_winning_decisions ?? 0,
+      prevented_bad_actions: performance.prevented_bad_actions ?? 0,
+      estimated_tokens_saved: performance.token_time_saved_estimate?.estimated_tokens_saved ?? 0,
+      estimated_minutes_saved: performance.token_time_saved_estimate?.estimated_minutes_saved ?? 0,
+      reliability_score: performance.agent_reliability_score ?? null,
+    } : null,
+  };
+}
+
+function buildFirstValueSignal(status, runtime, performance) {
+  const capture = status.capture_coverage || {};
+  const closure = status.auto_outcome_closure || {};
+  const captured = [];
+  if (status.enabled || capture.decisions) captured.push('decisions');
+  if (capture.tools === 'detected') captured.push('tools');
+  if (capture.commands === 'detected') captured.push('commands');
+  if (capture.deploys === 'detected') captured.push('deploys');
+  if (capture.publishes === 'detected') captured.push('publishes');
+  if (closure.state) captured.push(`outcomes:${closure.state}`);
+
+  const proof = performance && performance.ok !== false ? performance : {};
+  const proofBits = [];
+  if (Number(proof.avoided_mistakes || proof.avoided_repeated_mistakes || 0) > 0) proofBits.push(`${proof.avoided_mistakes || proof.avoided_repeated_mistakes} avoided mistake(s)`);
+  if (Number(proof.reused_winning_decisions || 0) > 0) proofBits.push(`${proof.reused_winning_decisions} reused winning decision(s)`);
+  if (Number(proof.prevented_bad_actions || 0) > 0) proofBits.push(`${proof.prevented_bad_actions} prevented risky action(s)`);
+  const tokens = proof.token_time_saved_estimate?.estimated_tokens_saved || 0;
+  if (tokens > 0) proofBits.push(`~${tokens} tokens saved`);
+
+  const firstLesson = runtime.before_you_act
+    || runtime.before_you_act_injection?.message
+    || runtime.exact_next_action
+    || status.recommended_fix
+    || 'Marrow will surface prior lessons before risky or repeated work.';
+
+  return {
+    active: Boolean(status.enabled ?? status.ok),
+    headline: `Marrow active: ${captured.length ? captured.join(', ') : 'decisions'} captured.`,
+    captured,
+    first_lesson: firstLesson,
+    value_proof: proofBits,
+    next_action: runtime.exact_next_action || status.next_action || 'Keep working; Marrow will capture outcomes and reuse lessons automatically.',
   };
 }
 
@@ -495,6 +545,15 @@ function printReport(report) {
     process.stdout.write(`- health: ${report.selfTest.health || 'unknown'}\n`);
     process.stdout.write(`- one-call runtime: ${report.selfTest.runtime_active ? 'active' : 'not verified'}\n`);
     if (report.selfTest.next_action) process.stdout.write(`- next action: ${report.selfTest.next_action}\n`);
+    if (report.selfTest.first_value_signal) {
+      process.stdout.write('\nFirst value:\n');
+      process.stdout.write(`- ${report.selfTest.first_value_signal.headline}\n`);
+      process.stdout.write(`- First useful lesson: ${report.selfTest.first_value_signal.first_lesson}\n`);
+      if (report.selfTest.first_value_signal.value_proof.length) {
+        process.stdout.write(`- Proof: ${report.selfTest.first_value_signal.value_proof.join('; ')}\n`);
+      }
+      process.stdout.write(`- Next: ${report.selfTest.first_value_signal.next_action}\n`);
+    }
   }
 
   if (report.remediation) {