@inkobytes/nexus 1.0.1 → 1.0.2

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 1.0.2 - 2026-06-03
+
+- Collapsed large `nexus doctor` Git Privacy floods into grouped per-root summaries with sample paths.
+- Prioritized `CONTINUITY.md` and `memories/` samples first so agent-local issues stay visible.
+
 ## 1.0.1 - 2026-06-02
 
 - Added colorized `nexus help` output for a more readable CLI experience.

package/README.md

@@ -166,6 +166,7 @@ Doctor reports grouped issues:
 - missing Nexus files
 - package script exfiltration and install-hook risks
 - package privacy risks for local/private files
+- grouped Git Privacy summaries for tracked private/local trees so large agent folders stay readable
 - stale nexus locks
 - missing agent instructions specifically for nexus
 - missing continuity and memory scaffolds

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inkobytes/nexus",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "Multi-agent coordination CLI for coding agents sharing a local repository",
   "type": "module",
   "bin": {

package/src/commands/doctor.js

@@ -93,6 +93,8 @@ This project uses Nexus for multi-agent coordination.
 ### Nexus Rules
 
 - Claim before editing shared project files: \`nexus claim <path> @Agent "intent"\`.
+- Nexus is agent-native and file-native, not feature-native: commit and release by file as soon as the file reaches a coherent checkpoint.
+- Do not hold claims while waiting to bundle related files into one feature commit; that blocks other agents who may need the file next.
 - Release finished work through Nexus: \`nexus release <path> "commit message"\`.
 - Use \`nexus next @Agent\` for the next safe queue task.
 - Do not free-roam into unassigned or \`Auto-flow: no\` work without user approval.
@@ -673,6 +675,11 @@ export default function doctor(args) {
     for (const entry of entries) {
       const prefix = entry.ok ? '-' : '!';
       console.log(`  ${prefix} ${entry.issue}`);
+      if (entry.details) {
+        for (const detail of entry.details) {
+          console.log(`    ${detail}`);
+        }
+      }
       if (entry.fix) console.log(`    Fix: ${entry.fix}`);
       if (!entry.ok) problemCount++;
     }
@@ -843,6 +850,20 @@ const PRIVATE_GIT_PATHS = [
   'USER.md',
 ];
 
+const GIT_PRIVACY_COLLAPSE_ROOTS = [
+  '.agent-session-logs',
+  '.agent-*',
+  '.agy',
+  '.antigravitycli',
+  '.claude',
+  '.codex',
+  '.gemini',
+  '.nexus/local',
+  'docs-priv',
+  'scratch',
+  'session-logs',
+];
+
 function scanPackagePrivacy(root) {
   const packagePath = join(root, 'package.json');
   if (!existsSync(packagePath)) return [];
@@ -886,10 +907,66 @@ function scanGitPrivacy(root) {
   if (result.status !== 0) return [];
 
   const tracked = result.stdout.split('\n').filter(Boolean);
-  return tracked.map((file) => ({
-    issue: `Git tracks private/local path: ${file}`,
-    fix: 'Untrack it without deleting local files: `git rm --cached -r -- <path>`, then add an ignore rule.',
-  }));
+  return summarizeGitPrivacyIssues(tracked);
+}
+
+function summarizeGitPrivacyIssues(tracked) {
+  const grouped = new Map();
+  const singles = [];
+
+  for (const file of tracked) {
+    const root = gitPrivacyRoot(file);
+    if (!root) {
+      singles.push(file);
+      continue;
+    }
+    if (!grouped.has(root)) grouped.set(root, []);
+    grouped.get(root).push(file);
+  }
+
+  const issues = [];
+
+  for (const file of singles.sort()) {
+    issues.push({
+      issue: `Git tracks private/local path: ${file}`,
+      fix: 'Untrack it without deleting local files: `git rm --cached -r -- <path>`, then add an ignore rule.',
+    });
+  }
+
+  for (const root of Array.from(grouped.keys()).sort()) {
+    const files = grouped.get(root).slice().sort(compareGitPrivacyFiles);
+    const samples = files.slice(0, 5);
+    const hiddenCount = files.length - samples.length;
+    const noun = files.length === 1 ? 'path' : 'paths';
+    const issue = `Git tracks private/local ${noun} under ${root}/ (${files.length} files)`;
+    const fix = 'Review the sample paths below. If the tree is intentionally tracked in this repo, keep it. Otherwise untrack it without deleting local files: `git rm --cached -r -- <path>`, then add an ignore rule.';
+    const details = samples.map((file) => `sample: ${file}`);
+    if (hiddenCount > 0) {
+      details.push(`...and ${hiddenCount} more tracked paths`);
+    }
+    issues.push({ issue, fix, details });
+  }
+
+  return issues;
+}
+
+function gitPrivacyRoot(file) {
+  for (const root of GIT_PRIVACY_COLLAPSE_ROOTS) {
+    if (matchesPrivatePath(file, root)) {
+      return root.replace(/\/$/, '');
+    }
+  }
+  return '';
+}
+
+function compareGitPrivacyFiles(a, b) {
+  return gitPrivacyPriority(a) - gitPrivacyPriority(b) || a.localeCompare(b);
+}
+
+function gitPrivacyPriority(file) {
+  if (/\/(CONTINUITY\.md|memories\/)/.test(file)) return 0;
+  if (/\/(AGENTS\.md|CLAUDE\.md|GEMINI\.md)$/.test(file)) return 1;
+  return 2;
 }
 
 function scanGeneratedArtifacts(root) {

package/src/commands/init.js

@@ -379,6 +379,8 @@ This project uses Nexus for multi-agent coordination.
 ### Nexus Rules
 
 - Claim before editing shared project files: \`nexus claim <path> @Agent "intent"\`.
+- Nexus is agent-native and file-native, not feature-native: commit and release by file as soon as the file reaches a coherent checkpoint.
+- Do not hold claims while waiting to bundle related files into one feature commit; that blocks other agents who may need the file next.
 - Release finished work through Nexus: \`nexus release <path> "commit message"\`.
 - Use \`nexus next @Agent\` for the next safe queue task.
 - Do not free-roam into unassigned or \`Auto-flow: no\` work without user approval.

package/src/commands/status.js

@@ -7,6 +7,8 @@ import { listLocks } from '../lib/lockManager.js';
 import { getConfig } from '../lib/config.js';
 import { spawnSync } from 'child_process';
 
+const FILE_FLOW_WARNING = 'Stale claim. Commit this file now.';
+
 export default function status(args) {
   const config = getConfig();
   const locks = listLocks();
@@ -36,6 +38,9 @@ export default function status(args) {
     const staleTag = stale ? ' ⚠️  STALE' : '';
     console.log(`  🔒 ${lock.target}`);
     console.log(`     Agent: ${agent} | Age: ${ageStr}${staleTag}`);
+    if (stale) {
+      console.log(`     Warning: ${FILE_FLOW_WARNING}`);
+    }
   }
 
   console.log('');