@remits/remits-cli 0.1.132 → 0.1.133

package/index.js

@@ -6,16 +6,16 @@
 - L22  Runtime Bootstrap And Shared State
 - L119  Sessions, Account Resolution, And Production Guards
 - L603  Local State, Workspaces, And Verification Evidence
-- L2155  Account Repos, Guide Sync, And Platform Repo
-- L2813  Component Discovery And HTTP Logging
-- L3389  Skill Delivery And TOC Resolution
-- L3699  Auth And Component Staging
-- L4312  Component Summaries, Status, And Sync Gates
-- L6375  Branches, Promotion, Commit, And Test Runs
-- L8036  Tokens, Tools, Verification, And Config
-- L9251  Service Dashboard And WebSocket Listener
-- L11367  Agent And Ticket Workflows
-- L14559  Help, Auto Update, And Command Dispatch
+- L2255  Account Repos, Guide Sync, And Platform Repo
+- L2949  Component Discovery And HTTP Logging
+- L3525  Skill Delivery And TOC Resolution
+- L3835  Auth And Component Staging
+- L4449  Component Summaries, Status, And Sync Gates
+- L6518  Branches, Promotion, Commit, And Test Runs
+- L8183  Tokens, Tools, Verification, And Config
+- L9405  Service Dashboard And WebSocket Listener
+- L11521  Agent And Ticket Workflows
+- L14815  Help, Auto Update, And Command Dispatch
 */
 
 /*
@@ -1934,6 +1934,106 @@ function printVerificationEnvelope(envelope, fallbackEnvelopeId) {
   }
 }
 
+function slimVerificationPacket(packet) {
+  const p = packet || {};
+  const world = p.world || {};
+  return {
+    packetId: p.packetId || p.id || null,
+    type: p.type || 'unknown',
+    success: p.success !== false,
+    stale: Boolean(p.stale),
+    claim: p.claim || p.summary || null,
+    taskId: p.taskId || (p.testRun && p.testRun.taskId) || null,
+    testName: p.testName || (p.testRun && p.testRun.testName) || null,
+    accountId: world.accountId || p.accountId || null,
+    dataMode: world.dataMode || p.dataMode || null,
+    branchName: world.branchName || p.branchName || null,
+    workspace: world.workspace || p.workspace || null,
+    recordedAt: formatTime(p.recordedAt || p.createdAt || p.at || p.timestamp),
+    message: p.message || p.error || null
+  };
+}
+
+function compactVerificationEnvelope(envelope, fallbackEnvelopeId) {
+  const env = envelope || {};
+  const evaluation = env.evaluation || {};
+  const packets = Array.isArray(env.packets) ? env.packets : [];
+  const failures = Array.isArray(evaluation.currentFailures)
+    ? evaluation.currentFailures
+    : packets.filter((packet) => packet && packet.success === false && !packet.stale);
+  const stale = Array.isArray(evaluation.stale) ? evaluation.stale : packets.filter((packet) => packet && packet.stale);
+  const requiredEvidence = ((env.acceptance || {}).requiredEvidence || evaluation.requiredEvidence || []);
+  const latestByType = evaluation.latestByType || env.latestByType || {};
+  const nextActions = [];
+
+  if (evaluation.noRequiredEvidence) {
+    nextActions.push('Attach a manifest or required evidence contract; packets are context, not proof of completion.');
+  }
+  if (failures.length) {
+    nextActions.push('Inspect and replace the current failing evidence packet(s).');
+  }
+  if (stale.length) {
+    nextActions.push('Re-run stale evidence after the requirement/source change.');
+  }
+
+  return {
+    envelopeId: env.envelopeId || fallbackEnvelopeId || null,
+    summary: env.summary || null,
+    status: env.status || 'unknown',
+    health: evaluation.health || null,
+    acceptanceStatus: evaluation.acceptanceStatus || env.acceptanceStatus || null,
+    requiredEvidence: {
+      satisfiedCount: evaluation.satisfiedCount || 0,
+      requiredCount: evaluation.requiredCount || requiredEvidence.length || 0,
+      missingCount: evaluation.missingCount || 0,
+      staleCount: evaluation.staleCount || stale.length || 0,
+      noRequiredEvidence: Boolean(evaluation.noRequiredEvidence),
+      declared: requiredEvidence.slice(0, 10).map((entry) => ({
+        type: entry && entry.type || entry && entry.evidenceType || null,
+        category: entry && entry.category || null,
+        claim: entry && entry.claim || entry && entry.description || null
+      }))
+    },
+    packets: {
+      count: packets.length,
+      failedCount: evaluation.failedCount || failures.length || 0,
+      currentFailureCount: evaluation.currentFailureCount || failures.length || 0,
+      lastPacketAt: formatTime(env.lastPacketAtMs || env.latestPacketAtMs || env.updatedAtMs),
+      recent: packets.slice(-5).map(slimVerificationPacket)
+    },
+    latestByType,
+    currentFailures: failures.slice(0, 10).map(slimVerificationPacket),
+    stale: stale.slice(0, 10).map(slimVerificationPacket),
+    warnings: (env.warnings || []).slice(0, 10),
+    nextActions
+  };
+}
+
+function printCompactVerificationEnvelope(compact) {
+  console.log('Verification envelope:', compact.envelopeId || '(no id)');
+  if (compact.summary) console.log('Summary:', compact.summary);
+  console.log('Status:', compact.status + (compact.health ? '  health=' + compact.health : ''));
+  if (compact.requiredEvidence.noRequiredEvidence) {
+    console.log('Required evidence: none declared');
+  } else {
+    console.log('Required evidence:', compact.requiredEvidence.satisfiedCount + '/' + compact.requiredEvidence.requiredCount +
+      (compact.requiredEvidence.staleCount ? '  stale=' + compact.requiredEvidence.staleCount : ''));
+  }
+  console.log('Packets:', compact.packets.count + '  current failures=' + compact.packets.currentFailureCount);
+  if (compact.currentFailures.length) {
+    console.log('Current failures:');
+    compact.currentFailures.forEach((packet) => {
+      console.log('  - ' + packet.type + ' ' + (packet.packetId || '') + (packet.claim ? ' - ' + packet.claim : '') +
+        (packet.message ? ' (' + packet.message + ')' : ''));
+    });
+  }
+  if (compact.nextActions.length) {
+    console.log('Next actions:');
+    compact.nextActions.forEach((action) => console.log('  - ' + action));
+  }
+  console.log('Full envelope: remits-cli verify show --json');
+}
+
 function printAcceptanceWarnings(envelope) {
   const warnings = envelope && envelope.acceptance && Array.isArray(envelope.acceptance.warnings)
     ? envelope.acceptance.warnings
@@ -2809,6 +2909,42 @@ function resolveSessionContext(cwd, flags) {
   };
 }
 
+function hasExplicitAccountIdFlag(flags) {
+  const value = Number(flags && flags['account-id']);
+  return Number.isFinite(value) && value > 0;
+}
+
+function platformRepoEntryMatchesCwd(cwd) {
+  const entry = getPlatformRepoEntry();
+  if (!entry || !entry.directory || !cwd) return false;
+  try {
+    return path.resolve(entry.directory) === path.resolve(cwd);
+  } catch (_) {
+    return false;
+  }
+}
+
+function platformRepoAccountCommandProblem(cwd, flags, commandName, sessionContext) {
+  if (hasExplicitAccountIdFlag(flags)) return null;
+  try {
+    if (loadAccountInfo(cwd)) return null;
+  } catch (_) {
+    // No account-info.json means the command would fall back to session state.
+  }
+  if (!looksLikePlatformRepo(cwd) && !platformRepoEntryMatchesCwd(cwd)) return null;
+
+  const account = sessionContext && sessionContext.accountId
+    ? 'account ' + sessionContext.accountId
+    : 'the last authenticated account';
+  return 'Refusing ' + commandName + ' from the Remits platform repo. This checkout is back-stage platform source, not an account repository, so the command would target ' +
+    account + ' from session state. Run it from that account repo, or pass --account-id <id> explicitly if you really intend to inspect that account from here.';
+}
+
+function requireAccountRepoContext(cwd, flags, commandName, sessionContext) {
+  const problem = platformRepoAccountCommandProblem(cwd, flags, commandName, sessionContext);
+  if (problem) throw new Error(problem);
+}
+
 /*
 ## Component Discovery And HTTP Logging
 */
@@ -3892,6 +4028,7 @@ async function pushComponentsCommand(flags) {
   const cwd = process.cwd();
   ensureLocalState(cwd);
   const sessionContext = resolveSessionContext(cwd, flags);
+  requireAccountRepoContext(cwd, flags, 'components stage', sessionContext);
   const { session, accountId } = sessionContext;
   const baseUrl = flags['base-url'] || session.baseUrl || DEFAULT_BASE_URL;
   const branchName = flags.branch || currentBranch(cwd);
@@ -4823,7 +4960,8 @@ function printBranchContext(response) {
   console.log('  commit writes:  ' + ctx.commitWrites);
   if (Object.prototype.hasOwnProperty.call(ctx, 'lastSyncedSha')) {
     // null is "unknown" (never synced, expired, or the last sync had errors) — never "nothing landed".
-    console.log('  last platform sync of this branch: ' + (ctx.lastSyncedSha ? short(ctx.lastSyncedSha) : 'unknown'));
+    const source = ctx.lastSyncedShaSource ? ' [' + ctx.lastSyncedShaSource + ']' : '';
+    console.log('  last platform sync of this branch: ' + (ctx.lastSyncedSha ? short(ctx.lastSyncedSha) : 'unknown') + source);
   }
   if (ctx.repository) {
     console.log('  sync reads repository: ' + ctx.repository +
@@ -5014,6 +5152,7 @@ async function statusComponentsCommand(flags) {
   const cwd = process.cwd();
   ensureLocalState(cwd);
   const sessionContext = resolveSessionContext(cwd, flags);
+  requireAccountRepoContext(cwd, flags, 'components status', sessionContext);
   const { session, accountId } = sessionContext;
   const baseUrl = flags['base-url'] || session.baseUrl || DEFAULT_BASE_URL;
   const branchName = flags.branch || currentBranch(cwd);
@@ -5082,6 +5221,7 @@ async function lanesComponentsCommand(flags) {
   const cwd = process.cwd();
   ensureLocalState(cwd);
   const sessionContext = resolveSessionContext(cwd, flags);
+  requireAccountRepoContext(cwd, flags, 'components lanes', sessionContext);
   const { session, accountId } = sessionContext;
   const baseUrl = flags['base-url'] || session.baseUrl || DEFAULT_BASE_URL;
   const branchName = flags.branch || currentBranch(cwd);
@@ -5173,6 +5313,7 @@ async function entriesComponentsCommand(flags) {
   const cwd = process.cwd();
   ensureLocalState(cwd);
   const sessionContext = resolveSessionContext(cwd, flags);
+  requireAccountRepoContext(cwd, flags, 'components entries', sessionContext);
   const { session, accountId } = sessionContext;
   const baseUrl = flags['base-url'] || session.baseUrl || DEFAULT_BASE_URL;
   const branchName = flags.branch || currentBranch(cwd);
@@ -5216,6 +5357,7 @@ async function clearComponentsCommand(flags) {
   const cwd = process.cwd();
   ensureLocalState(cwd);
   const sessionContext = resolveSessionContext(cwd, flags);
+  requireAccountRepoContext(cwd, flags, 'components clear', sessionContext);
   const { session, accountId } = sessionContext;
   const baseUrl = flags['base-url'] || session.baseUrl || DEFAULT_BASE_URL;
   const branchName = flags.branch || currentBranch(cwd);
@@ -5275,6 +5417,7 @@ async function syncComponentsCommand(rawFlags) {
   const flags = safe ? expandSafeSyncFlags(rawFlags) : rawFlags;
   ensureLocalState(cwd);
   const sessionContext = resolveSessionContext(cwd, flags);
+  requireAccountRepoContext(cwd, flags, 'components sync', sessionContext);
   const { session, accountId } = sessionContext;
   const baseUrl = flags['base-url'] || session.baseUrl || DEFAULT_BASE_URL;
   const branchName = flags.branch || currentBranch(cwd);
@@ -6382,6 +6525,7 @@ async function branchesComponentsCommand(flags) {
   const cwd = process.cwd();
   ensureLocalState(cwd);
   const sessionContext = resolveSessionContext(cwd, flags);
+  requireAccountRepoContext(cwd, flags, 'components branches', sessionContext);
   const { session, accountId } = sessionContext;
   const baseUrl = flags['base-url'] || session.baseUrl || DEFAULT_BASE_URL;
   const api = buildAxios(baseUrl, session.token);
@@ -6579,6 +6723,7 @@ async function promotionComponentsCommand(flags) {
   const cwd = process.cwd();
   ensureLocalState(cwd);
   const sessionContext = resolvePromotionSessionContext(cwd, flags);
+  requireAccountRepoContext(cwd, flags, 'components promotion', sessionContext);
   const { session, accountId } = sessionContext;
   const baseUrl = flags['base-url'] || session.baseUrl || DEFAULT_BASE_URL;
   const api = buildAxios(baseUrl, session.token);
@@ -6744,7 +6889,9 @@ function shortSignature(signature) {
 async function commitComponentsCommand(flags) {
   const cwd = process.cwd();
   ensureLocalState(cwd);
-  const { session, accountId } = resolveSessionContext(cwd, flags);
+  const sessionContext = resolveSessionContext(cwd, flags);
+  requireAccountRepoContext(cwd, flags, 'components commit', sessionContext);
+  const { session, accountId } = sessionContext;
   const branchName = flags.branch || currentBranch(cwd);
   const commitMessage = String(flags.message || ('remits-cli commit sync ' + new Date().toISOString()));
   const allowEmpty = flags['allow-empty'] === true || flags['allow-empty'] === 'true';
@@ -8945,11 +9092,18 @@ async function verifyCommand(flags, subcommand) {
   if (sub === 'show' || sub === 'read' || sub === 'get' || sub === 'packets') {
     const response = await postVerificationCommand(api, cwd, session, accountId, 'show', { envelopeId });
     if (response.envelope) writeLocalVerificationEnvelope(cwd, response.envelope);
+    const envelope = response.envelope || {};
+    const compact = flagEnabled(flags.summary) || flagEnabled(flags.compact);
     if (flagEnabled(flags.json)) {
-      console.log(JSON.stringify(response.envelope || response, null, 2));
-      return response.envelope || response;
+      const payload = compact ? compactVerificationEnvelope(envelope, envelopeId) : (response.envelope || response);
+      console.log(JSON.stringify(payload, null, 2));
+      return payload;
+    }
+    if (compact) {
+      const payload = compactVerificationEnvelope(envelope, envelopeId);
+      printCompactVerificationEnvelope(payload);
+      return payload;
     }
-    const envelope = response.envelope || {};
     printVerificationEnvelope(envelope, envelopeId);
     return envelope;
   }
@@ -13870,8 +14024,11 @@ async function activityInspectCommand(flags) {
 
   if (!response.success) throw new Error(response.message || 'Activity inspection failed');
   if (flagEnabled(flags.json)) {
-    console.log(JSON.stringify(response, null, 2));
-    return response;
+    const payload = (flagEnabled(flags.summary) || flagEnabled(flags.compact))
+      ? compactActivityInspect(response)
+      : response;
+    console.log(JSON.stringify(payload, null, 2));
+    return payload;
   }
 
   printSessionResolutionWarning(sessionContext);
@@ -13880,6 +14037,98 @@ async function activityInspectCommand(flags) {
   return response;
 }
 
+function smellSeverityRank(smell) {
+  const severity = String((smell && smell.severity) || 'info').toLowerCase();
+  if (severity === 'critical') return 0;
+  if (severity === 'high') return 1;
+  if (severity === 'medium') return 2;
+  if (severity === 'low') return 3;
+  return 4;
+}
+
+function sortedActivitySmells(smells) {
+  return (Array.isArray(smells) ? smells.slice() : []).sort((left, right) => {
+    const severity = smellSeverityRank(left) - smellSeverityRank(right);
+    if (severity) return severity;
+    return String(right.updatedAt || right.at || '').localeCompare(String(left.updatedAt || left.at || ''));
+  });
+}
+
+function slimActivitySmell(smell) {
+  const s = smell || {};
+  return {
+    severity: s.severity || 'info',
+    type: s.type || 'signal',
+    summary: s.summary || null,
+    accountId: s.accountId || null,
+    laneId: s.laneId || null,
+    envelopeId: s.envelopeId || null,
+    taskId: s.taskId || null,
+    branchName: s.branchName || null,
+    workspace: s.workspace || null
+  };
+}
+
+function compactActivityInspect(response) {
+  const counts = response.counts || {};
+  const smells = sortedActivitySmells(response.smells);
+  const lanes = Array.isArray(response.lanes) ? response.lanes : [];
+  const envelopes = Array.isArray(response.envelopes) ? response.envelopes : [];
+  const testRuns = Array.isArray(response.testRuns) ? response.testRuns : [];
+  const nextActions = smells
+    .filter((smell) => smellSeverityRank(smell) <= 2)
+    .slice(0, 5)
+    .map((smell) => (smell.type || 'signal') + ': ' + (smell.summary || 'inspect this signal'));
+
+  return {
+    success: response.success,
+    accountId: response.accountId,
+    accountName: response.accountName || null,
+    scope: response.scope || 'self',
+    dataMode: response.dataMode,
+    accounts: response.accountIds || [],
+    counts: {
+      agents: counts.agents || 0,
+      lanes: counts.lanes || lanes.length || 0,
+      verificationEnvelopes: counts.verificationEnvelopes || envelopes.length || 0,
+      testRuns: counts.testRuns || testRuns.length || 0,
+      corpusResults: counts.corpusResults || 0,
+      smells: smells.length
+    },
+    topSmells: smells.slice(0, 10).map(slimActivitySmell),
+    currentLanes: lanes.slice(0, 10).map((lane) => ({
+      laneId: lane.laneId || null,
+      accountId: lane.accountId || null,
+      branchName: lane.branchName || null,
+      workspace: lane.workspace || null,
+      stagedCount: lane.stagedCountAsOf || lane.stagedCount || 0,
+      worksetCount: lane.worksetCountAsOf == null ? null : lane.worksetCountAsOf,
+      userEmail: lane.userEmail || null,
+      expiresInSeconds: lane.expiresInSeconds == null ? null : lane.expiresInSeconds
+    })),
+    recentEnvelopes: envelopes.slice(0, 8).map((env) => ({
+      envelopeId: env.envelopeId || null,
+      status: env.status || 'unknown',
+      summary: env.summary || null,
+      packetCount: env.packetCount || 0,
+      currentFailureCount: env.currentFailureCount || 0,
+      health: env.health || null,
+      updatedAt: formatTime(env.updatedAtMs || env.lastPacketAtMs || env.createdAt)
+    })),
+    recentTestRuns: testRuns.slice(0, 8).map((run) => ({
+      taskId: run.taskId || null,
+      testName: run.testName || null,
+      passed: run.passed || 0,
+      total: run.total || 0,
+      branchName: run.branchName || null,
+      workspace: run.workspace || null,
+      ai: corpusAiLabel(run),
+      completedAt: formatTime(run.completedAt || run.startedAt)
+    })),
+    nextActions
+  };
+}
+
 function printActivityInspectSummary(response) {
   const subject = response.subjectUser
     ? ' for ' + (response.subjectUser.email || response.subjectUser.name || ('user ' + response.subjectUser.id))
@@ -13896,12 +14145,12 @@ function printActivityInspectSummary(response) {
     (counts.testRuns || 0) + ' test run(s), ' +
     (counts.corpusResults || 0) + ' corpus result(s)');
 
-  const smells = response.smells || [];
+  const smells = sortedActivitySmells(response.smells);
   console.log('');
   if (!smells.length) {
     console.log('Smells: none detected in this slice.');
   } else {
-    console.log('Smells (' + smells.length + '):');
+    console.log('Top smells (' + smells.length + '):');
     smells.slice(0, 20).forEach((smell) => {
       console.log('  [' + (smell.severity || 'info') + '] ' + (smell.type || 'signal') + ': ' + smell.summary);
       const pivots = [
@@ -13916,6 +14165,12 @@ function printActivityInspectSummary(response) {
       if (pivots.length) console.log('       ' + pivots.join(' · '));
     });
     if (smells.length > 20) console.log('  ...' + (smells.length - 20) + ' more; rerun with --json');
+    const actions = compactActivityInspect(response).nextActions;
+    if (actions.length) {
+      console.log('');
+      console.log('Next actions:');
+      actions.forEach((action) => console.log('  - ' + action));
+    }
   }
 
   const lanes = response.lanes || [];
@@ -13978,6 +14233,7 @@ function printActivityInspectSummary(response) {
     });
   }
   console.log('');
+  console.log('Compact JSON: remits-cli activity inspect --summary --json');
   console.log('Full structured payload: remits-cli activity inspect --json');
 }
 
@@ -14952,7 +15208,7 @@ function printVerifyHelp() {
   console.log('  remits-cli verify use <envelopeId>');
   console.log('  remits-cli verify current');
   console.log('  remits-cli verify clear [--all]');
-  console.log('  remits-cli verify show [--envelope ID] [--json]');
+  console.log('  remits-cli verify show [--envelope ID] [--summary|--compact] [--json]');
   console.log('  remits-cli verify status [--envelope ID]');
   console.log('  remits-cli verify report [--envelope ID]');
   console.log('  remits-cli verify abandon --envelope ID --reason "..."');
@@ -15022,6 +15278,11 @@ async function main() {
   // Skip for lifecycle subcommands and help.
   const isLifecycleCmd = command === 'listen' || command === 'start' || command === 'stop' || command === 'status' || command === 'whoami' || command === 'doctor' || command === 'agent' || command === 'ticket';
   const isHelpCmd = !command || command === 'help' || command === '--help' || wantsHelp;
+  if (!wantsJson && !isHelpCmd && command === 'components') {
+    const commandName = 'components ' + (subcommand || 'command');
+    const problem = platformRepoAccountCommandProblem(process.cwd(), args, commandName, null);
+    if (problem) throw new Error(problem);
+  }
   if (!wantsJson && !isHelpCmd && !isLifecycleCmd && !isListenerRunning()) {
     try {
       const dashboardUrl = await autoStartServiceIfNeeded();
@@ -15052,7 +15313,7 @@ async function main() {
     console.log('  remits-cli agent status [--state idle|working|paused] [--ticket ID] [--activity "..."]');
     console.log('  remits-cli agent list [--account-id ID]                             # who else is available');
     console.log('  remits-cli agent map [--account-ids 1,4] [--json]                   # who is EDITING what, where, right now');
-    console.log('  remits-cli activity inspect [--account-id ID] [--scope self|children] [--user-email E] [--json]');
+    console.log('  remits-cli activity inspect [--account-id ID] [--scope self|children] [--user-email E] [--summary|--compact] [--json]');
     console.log('  remits-cli agent release                                            # stop receiving tickets now');
     console.log('  remits-cli start [--foreground true] [--port 8787]                  # human dashboard in the browser');
     console.log('  remits-cli stop');
@@ -15103,7 +15364,7 @@ async function main() {
     console.log('A WORKSPACE is an optional second isolation axis for staging, alongside the git branch.');
     console.log('Staging is keyed by (account, cli user, branch, workspace) — and account and user are fixed');
     console.log('for a given repo, so without a workspace the branch is the ONLY axis. That is why two coding');
-    console.log('agents in two worktrees of the same branch overwrite each other: `components stage` uploads');
+    console.log('agents in two checkouts without their own workspace overwrite each other: `components stage` uploads');
     console.log('the whole repo and replaces the lane wholesale.');
     console.log('');
     console.log('A workspace isolates staging WITHOUT changing anything else:');
@@ -15111,13 +15372,13 @@ async function main() {
     console.log('  - the run still resolves whatever committed ComponentVariant branch the account subscribes to');
     console.log('  - only which staged entries shadow them changes');
     console.log('');
-    console.log('Typical setup, one worktree per agent, all on the same branch:');
-    console.log('  git fetch origin');
+    console.log('Typical setup, one clone per agent, all on the same branch:');
+    console.log('  git clone <repo-url> ../ms-agent-a');
+    console.log('  cd ../ms-agent-a');
     console.log('  git switch forked');
     console.log('  git pull --ff-only origin forked');
     console.log('  git rev-list --left-right --count HEAD...origin/forked   # must print: 0  0');
-    console.log('  git worktree add --force ../ms-agent-a forked');
-    console.log('  cd ../ms-agent-a && remits-cli workspace use --auto');
+    console.log('  remits-cli workspace use --auto');
     console.log('  remits-cli components status      # branch world + staging lane + other lanes');
     console.log('  remits-cli components stage          # isolated lane; nobody else sees it');
     console.log('  remits-cli test run --test 42        # resolves this lane over the forked variants');
@@ -15126,7 +15387,8 @@ async function main() {
     console.log('Precedence: --workspace  >  REMITS_WORKSPACE  >  .remits-cli/workspace  >  shared default lane');
     console.log('Use --no-workspace on a single command to target the shared lane without clearing the file.');
     console.log('');
-    console.log('`.remits-cli/workspace` is per-checkout and gitignored, so a worktree keeps its own lane.');
+    console.log('`.remits-cli/workspace` is per-checkout and gitignored, so each clone keeps its own lane.');
+    console.log('Avoid same-branch worktrees for concurrent agents: they share the branch ref, so one pull moves HEAD under the others, and `components commit` refuses there.');
     process.exit(0);
   }
 
@@ -15277,7 +15539,7 @@ async function main() {
 
   if (command === 'activity') {
     if (wantsHelp || !subcommand) {
-      console.log('Usage: remits-cli activity inspect [--account-id ID] [--scope self|children] [--user-id ID|--user-email EMAIL] [--limit N] [--json]');
+      console.log('Usage: remits-cli activity inspect [--account-id ID] [--scope self|children] [--user-id ID|--user-email EMAIL] [--limit N] [--summary|--compact] [--json]');
       console.log('');
       console.log('Read-only workstream inspection for agent/operator review. Joins current staging lanes,');
       console.log('verification envelopes, durable test runs, corpus measurements, live agent presence,');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remits/remits-cli",
-  "version": "0.1.132",
+  "version": "0.1.133",
   "description": "Local CLI for auth, component sync, and live test execution against Remits",
   "license": "MIT",
   "private": false,