@getmarrow/install 0.1.8 → 0.1.10

package/README.md

@@ -11,13 +11,31 @@ npx @getmarrow/install --repair
 npx @getmarrow/install doctor
 ```
 
-## What's New in v0.1.8
+## What's New in v0.1.10
 
 - First-run output now explains the value in agent/user language: your agent is no longer starting from zero.
 - Self-test prints first proof: setup decision captured, outcome closed, runtime gate active, and risky work now gets a pre-action brief.
 - Fresh accounts get a guided prompt to try immediately: "I am about to deploy to production. What should I check first?"
 - Existing accounts/fleets show stronger proof when available: avoided mistakes, reused winning decisions, prevented risky actions, and token/time savings.
 - Generated SDK passive runtime now fails soft if `@getmarrow/sdk` is missing and the installer prints the exact dependency fix.
+- Docs now make the universal installer the default path; SDK and MCP are advanced/manual integration paths.
+
+## Which Install Path Should I Use?
+
+Start here unless you already know you need a lower-level integration:
+
+```bash
+npx @getmarrow/install --yes
+```
+
+The universal installer detects your local agent/runtime environment and wires the safest combination of MCP hooks, SDK passive runtime files, and agent instructions automatically. It also runs the self-test and prints first-run value proof.
+
+Use the lower-level packages only when you need direct control:
+
+- **SDK:** use `@getmarrow/sdk` when you are building a custom Node/TypeScript agent integration or wrapping your own tools, commands, deploys, and publishes in code.
+- **MCP:** use `@getmarrow/mcp` when you want manual MCP server/hook setup for Claude Code, Claude Desktop, Cursor, or another MCP-compatible client.
+
+The three packages are not three competing onboarding paths. `@getmarrow/install` is the front door; SDK and MCP are the implementation paths underneath it.
 
 ## Agent Value Proof Quickstart
 
@@ -33,6 +51,7 @@ Expected result:
 - A harmless setup decision is created and its outcome is committed.
 - `/v1/agent/status` confirms capture health and missing hooks.
 - `/v1/agent/runtime` verifies the one-call runtime gate.
+- `/v1/agent/first-value` returns the five-minute proof payload used by installer, SDK, and MCP clients.
 - The installer prints: "Your agent is no longer starting from zero."
 - Fresh accounts get a first useful action to try immediately.
 - Accounts with history get proof such as avoided mistakes, reused winning decisions, prevented risky actions, or estimated time/token savings.

package/package.json

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

package/src/installer.js

@@ -610,8 +610,25 @@ async function runSelfTest(options) {
       ok: false,
       error: error instanceof Error ? error.message : String(error),
     }));
-  const firstValueSignal = buildFirstValueSignal(status, runtime, performance);
-  const installValueMoment = buildInstallValueMoment(firstValueSignal, status, runtime, performance);
+  const firstValue = await requestJson(`${baseUrl}/v1/agent/first-value`, {
+    method: 'POST',
+    headers,
+    body: JSON.stringify({
+      action: 'I am about to deploy to production. What should I check first?',
+      type: 'deploy',
+      role: 'deploy',
+      surfaces: ['production', 'deploy'],
+      proof: {
+        checks: ['installer first-value self-test'],
+        outcome: 'first-value endpoint reached',
+      },
+    }),
+  }).catch((error) => ({
+    ok: false,
+    error: error instanceof Error ? error.message : String(error),
+  }));
+  const firstValueSignal = buildFirstValueSignal(status, runtime, performance, firstValue);
+  const installValueMoment = buildInstallValueMoment(firstValueSignal, status, runtime, performance, firstValue);
   return {
     skipped: false,
     decision_id: decisionId,
@@ -624,6 +641,7 @@ 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: firstValue && firstValue.ok !== false ? firstValue : null,
     first_value_signal: firstValueSignal,
     install_value_moment: installValueMoment,
     performance_proof: performance && performance.ok !== false ? {
@@ -637,7 +655,18 @@ async function runSelfTest(options) {
   };
 }
 
-function buildInstallValueMoment(firstValueSignal = {}, status = {}, runtime = {}, performance = {}) {
+function buildInstallValueMoment(firstValueSignal = {}, status = {}, runtime = {}, performance = {}, firstValue = {}) {
+  if (firstValue && firstValue.ok !== false && firstValue.first_value) {
+    return {
+      headline: firstValue.headline || firstValue.first_value.headline || 'Your agent is no longer starting from zero.',
+      proof: Array.isArray(firstValue.first_value.proof) ? firstValue.first_value.proof : [],
+      fleet_signal: firstValue.history_signal?.summary || 'Fresh account: Marrow will build fleet memory from this first captured outcome.',
+      try_this_now: firstValue.first_value.try_this_now || 'Ask your agent: "I am about to deploy to production. What should I check first?"',
+      expected_response: firstValue.first_value.expected_response || 'Marrow should answer with a risk gate, required proof, and any matching fleet lessons before the agent acts.',
+      first_lesson: firstValue.first_value.first_lesson || null,
+    };
+  }
+
   const proof = firstValueSignal.value_proof || [];
   const hasFleetSignal = proof.length > 0;
   const runtimeLesson = runtime.before_you_act
@@ -662,7 +691,25 @@ function buildInstallValueMoment(firstValueSignal = {}, status = {}, runtime = {
   };
 }
 
-function buildFirstValueSignal(status, runtime, performance) {
+function buildFirstValueSignal(status, runtime, performance, firstValue = {}) {
+  if (firstValue && firstValue.ok !== false && firstValue.first_value) {
+    const capture = firstValue.capture || {};
+    const proof = firstValue.value_proof || {};
+    const proofBits = [];
+    if (Number(proof.avoided_mistakes || 0) > 0) proofBits.push(`${proof.avoided_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)`);
+    if (Number(proof.estimated_tokens_saved || 0) > 0) proofBits.push(`~${proof.estimated_tokens_saved} tokens saved`);
+    return {
+      active: Boolean(firstValue.active),
+      headline: `Marrow active: ${(capture.surfaces || ['decisions']).join(', ')} captured.`,
+      captured: capture.surfaces || ['decisions'],
+      first_lesson: firstValue.first_value.first_lesson,
+      value_proof: proofBits,
+      next_action: firstValue.next_action?.reason || 'Keep working; Marrow will capture outcomes and reuse lessons automatically.',
+    };
+  }
+
   const capture = status.capture_coverage || {};
   const closure = status.auto_outcome_closure || {};
   const captured = [];