@getmarrow/install 0.1.22 → 0.1.24

package/README.md

@@ -1,8 +1,8 @@
 # @getmarrow/install
 
-Universal installer for Marrow passive agent setup.
+Universal installer for Marrow agent governance, proof, and passive control setup.
 
-Use it when you want Marrow to detect the local agent/runtime environment and wire the safest passive integration automatically.
+Use it when you want Marrow to detect the local agent/runtime environment and wire the safest passive governance integration automatically.
 
 ```bash
 npx @getmarrow/install --dry-run
@@ -11,18 +11,26 @@ npx @getmarrow/install --repair
 npx @getmarrow/install doctor
 ```
 
-## What's New in v0.1.22
+## What's New in v0.1.24
 
-v0.1.22 makes token value proof easier to repair from the Fleet Operator TUI.
+v0.1.24 aligns the installer docs with Marrow's control-plane direction.
 
-- Generated passive runtimes enable compact model-usage capture by default with `captureModelUsage`.
-- First-run self-test calls `/v1/agent/value/proof` and prints a `Token value proof` block.
-- Fresh accounts show token capture as active and warming up; accounts with observed model calls show calls, tokens, estimated savings, confidence, and next action.
-- Provider usage capture stores compact metadata only: provider, model, token counts, latency, cost estimate, workflow/decision linkage, and Marrow intervention type.
-- Marrow does not store prompts, completions, tool stdout/stderr, plaintext API keys, or raw model output for this feature.
-- Disable only when required with `MARROW_PASSIVE_TOKEN_USAGE=false`.
+- Marrow is positioned as an agent governance, proof, and intelligence layer, not a single-agent memory app.
+- The recommended setup path remains passive by default: install once, then let agents call runtime gates, completion contracts, and outcome closure as they work.
+- Hermes Agent is a supported client label and integration target; Marrow maps Hermes goals, verification evidence, learning, journey, and subagent outcomes into fleet governance proof.
+- New backend surfaces include governance control-plane proof, completion-contract evaluation, fleet governance timeline, and buyer-grade value proof.
 
-Business value: new users should see from day one whether Marrow is capturing the signals needed to prove token/time savings over workflows, tasks, and builds.
+## What's New in v0.1.23
+
+v0.1.23 improves attribution quality so Marrow can produce cleaner per-agent, per-harness, and per-workflow value reports.
+
+- Installer self-tests and governed runner calls attach `source_meta.channel`, `source_meta.client`, and inferred workflow intent by default.
+- Generated passive runtime keeps using SDK defaults for `agent_id`, harness/client, source channel, and user intent attribution.
+- Set `MARROW_CLIENT`, `MARROW_HARNESS`, or `MARROW_AGENT_CLIENT` to labels such as `codex`, `claude-code`, `cursor`, `gemini`, `qwen`, `opencode`, `hermes`, `openclaw`, or `custom`.
+- Invalid or unknown client labels fall back to `custom` instead of breaking onboarding.
+- Marrow still does not store prompts, completions, tool stdout/stderr, plaintext API keys, or raw model output for this feature.
+
+Business value: dashboards and reports can show which agents, harnesses, and workflow types are improving instead of grouping too much work into "unknown."
 
 ## Governed Runner
 
@@ -87,6 +95,14 @@ Use the lower-level packages only when you need direct control:
 
 The three packages are not three competing onboarding paths. `@getmarrow/install` is the front door; SDK and MCP are the implementation paths underneath it.
 
+For cleaner attribution, set an agent id and optional client label before install:
+
+```bash
+export MARROW_FLEET_AGENT_ID=codex-deploy-agent
+export MARROW_CLIENT=codex
+npx @getmarrow/install --yes
+```
+
 ## Agent Value Proof Quickstart
 
 One command should prove Marrow is active and useful:

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@getmarrow/install",
-  "version": "0.1.22",
-  "description": "Universal installer for Marrow passive agent setup.",
+  "version": "0.1.24",
+  "description": "Universal installer for Marrow agent governance, proof, and passive control setup.",
   "bin": {
     "marrow-install": "bin/marrow-install.js"
   },
@@ -15,7 +15,10 @@
     "marrow",
     "mcp",
     "installer",
-    "passive-runtime"
+    "passive-runtime",
+    "governance",
+    "proof-packs",
+    "agent-control-plane"
   ],
   "repository": {
     "type": "git",

package/src/governed-runner.js

@@ -9,6 +9,36 @@ const DEFAULT_BASE_URL = 'https://api.getmarrow.ai';
 const HIGH_RISK_TERMS = /\b(deploy|prod|production|publish|release|merge|migration|migrate|secret|token|key|cloudflare|wrangler|npm publish|gh pr merge|git push|terraform apply|kubectl apply|delete|destroy|drop)\b/i;
 const GOVERN_TUI_ROW_COUNT = 7;
 const FLEET_TUI_ROW_COUNT = 11;
+const SOURCE_CLIENTS = new Set(['claude-code', 'cursor', 'windsurf', 'openclaw', 'codex', 'gemini', 'grok', 'deepseek', 'qwen', 'kimi', 'minimax', 'cline', 'opencode', 'hermes', 'glm', 'custom', 'unknown']);
+
+function sourceClient() {
+  const raw = String(process.env.MARROW_CLIENT || process.env.MARROW_HARNESS || process.env.MARROW_AGENT_CLIENT || '').trim().toLowerCase().replace(/\s+/g, '-').replace(/^@/, '');
+  const aliases = {
+    claude: 'claude-code',
+    claude_code: 'claude-code',
+    'claude-code': 'claude-code',
+    cursor: 'cursor',
+    windsurf: 'windsurf',
+    openclaw: 'openclaw',
+    codex: 'codex',
+    'openai-codex': 'codex',
+    gemini: 'gemini',
+    google: 'gemini',
+    grok: 'grok',
+    deepseek: 'deepseek',
+    qwen: 'qwen',
+    kimi: 'kimi',
+    minimax: 'minimax',
+    cline: 'cline',
+    opencode: 'opencode',
+    'open-code': 'opencode',
+    hermes: 'hermes',
+    'hermes-agent': 'hermes',
+    glm: 'glm',
+  };
+  return aliases[raw] || (SOURCE_CLIENTS.has(raw) ? raw : 'custom');
+}
+
 function usage() {
   return `Usage:
   npx @getmarrow/install run --agent deploy-agent -- npm test
@@ -283,6 +313,7 @@ function headers(options) {
     'Content-Type': 'application/json',
     'X-Marrow-Agent-Id': options.agentId,
     'X-Marrow-Session-Id': options.sessionId,
+    'X-Marrow-Client': sourceClient(),
     'User-Agent': '@getmarrow/install governed-runner',
   };
   return h;
@@ -449,6 +480,11 @@ async function createDecision(options, action, type) {
       profile: options.profile,
       governed: true,
     },
+    source_meta: {
+      channel: 'cli',
+      client: sourceClient(),
+      user_intent: type === 'deploy' ? 'deploy' : 'operate',
+    },
   });
 }
 

package/src/installer.js

@@ -6,6 +6,35 @@ const crypto = require('node:crypto');
 const DEFAULT_BASE_URL = 'https://api.getmarrow.ai';
 const MARROW_BLOCK_START = '<!-- marrow:passive-start -->';
 const MARROW_BLOCK_END = '<!-- marrow:passive-end -->';
+const SOURCE_CLIENTS = new Set(['claude-code', 'cursor', 'windsurf', 'openclaw', 'codex', 'gemini', 'grok', 'deepseek', 'qwen', 'kimi', 'minimax', 'cline', 'opencode', 'hermes', 'glm', 'custom', 'unknown']);
+
+function sourceClient() {
+  const raw = String(process.env.MARROW_CLIENT || process.env.MARROW_HARNESS || process.env.MARROW_AGENT_CLIENT || '').trim().toLowerCase().replace(/\s+/g, '-').replace(/^@/, '');
+  const aliases = {
+    claude: 'claude-code',
+    claude_code: 'claude-code',
+    'claude-code': 'claude-code',
+    cursor: 'cursor',
+    windsurf: 'windsurf',
+    openclaw: 'openclaw',
+    codex: 'codex',
+    'openai-codex': 'codex',
+    gemini: 'gemini',
+    google: 'gemini',
+    grok: 'grok',
+    deepseek: 'deepseek',
+    qwen: 'qwen',
+    kimi: 'kimi',
+    minimax: 'minimax',
+    cline: 'cline',
+    opencode: 'opencode',
+    'open-code': 'opencode',
+    hermes: 'hermes',
+    'hermes-agent': 'hermes',
+    glm: 'glm',
+  };
+  return aliases[raw] || (SOURCE_CLIENTS.has(raw) ? raw : 'custom');
+}
 
 function parseArgs(argv) {
   const options = {
@@ -291,7 +320,7 @@ Marrow should run passively after install:
 Required environment:
 
 - \`MARROW_API_KEY\`
-- Optional: \`MARROW_BASE_URL\`, \`MARROW_FLEET_AGENT_ID\`
+- Optional: \`MARROW_BASE_URL\`, \`MARROW_FLEET_AGENT_ID\`, \`MARROW_CLIENT\`
 - Optional: \`MARROW_PASSIVE_TOKEN_USAGE=false\` disables compact provider usage capture when needed.
 ${MARROW_BLOCK_END}`;
 }
@@ -330,6 +359,7 @@ function envExample() {
   return `MARROW_API_KEY=mrw_live_replace_me
 MARROW_BASE_URL=${DEFAULT_BASE_URL}
 MARROW_FLEET_AGENT_ID=agent-or-fleet-id
+MARROW_CLIENT=codex
 MARROW_ENFORCEMENT_MODE=auto
 MARROW_PASSIVE_BRIEF=auto
 MARROW_PASSIVE_VALUE_REPORT=true
@@ -565,6 +595,7 @@ async function runSelfTest(options) {
     authorization: `Bearer ${options.apiKey}`,
     'content-type': 'application/json',
     'x-marrow-session-id': `install-${Date.now()}`,
+    'x-marrow-client': sourceClient(),
   };
   if (options.agentId) headers['x-marrow-agent-id'] = options.agentId;
 
@@ -575,6 +606,11 @@ async function runSelfTest(options) {
     body: JSON.stringify({
       type: 'process',
       action: 'Marrow passive install self-test: verify SDK/MCP hooks can record a harmless setup event',
+      source_meta: {
+        channel: 'cli',
+        client: sourceClient(),
+        user_intent: 'operate',
+      },
     }),
   });