swarmdo 1.9.0 → 1.11.0

package/.claude/helpers/statusline.cjs

@@ -515,7 +515,7 @@ function getCostFromStdin() {
 // misses, the displayed version is meaningful (matches what the user
 // installed), not a stale hard-coded string.
 function getPkgVersion() {
-  let ver = '1.9.0';
+  let ver = '1.11.0';
   try {
     const home = os.homedir();
     const pkgPaths = [

package/README.md

@@ -1,8 +1,8 @@
 <div align="center">
 
-[![swarmdo](swarmdo/assets/swarmdo-banner.svg)](https://swarmdo.com)
+[![swarmdo](swarmdo/assets/brand/logo-full.svg)](https://swarmdo.com)
 
-[![npm version (swarmdo)](https://img.shields.io/badge/npx%20swarmdo-v1.9.0-cb3837?style=for-the-badge&logo=npm&logoColor=white)](https://github.com/SwarmDo/swarmdo/releases)
+[![npm version (swarmdo)](https://img.shields.io/badge/npx%20swarmdo-v1.11.0-cb3837?style=for-the-badge&logo=npm&logoColor=white)](https://github.com/SwarmDo/swarmdo/releases)
 [![MIT License](https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge)](https://github.com/SwarmDo/swarmdo/blob/main/LICENSE)
 [![Website](https://img.shields.io/badge/swarmdo.com-e2a33c?style=for-the-badge&logoColor=black)](https://swarmdo.com)
 [![Star on GitHub](https://img.shields.io/github/stars/SwarmDo/swarmdo?style=for-the-badge&logo=github&color=gold)](https://github.com/SwarmDo/swarmdo)
@@ -277,8 +277,9 @@ The recent release train added a full day-to-day operations layer around the swa
 | `swarmdo worktree` (alias `wt`) | **Parallel-agent isolation** on git worktrees — add / list / diff / merge / remove |
 | `swarmdo transcript` (alias `tx`) | **Export any Claude Code session** to clean markdown — system noise stripped, ready to share; `transcript search <query>` full-text-searches every session |
 | `swarmdo compact` | **Compress noisy command output** before it reaches an LLM — strip ANSI, collapse repeats, fold `node_modules` stack frames, window long logs. `npm test 2>&1 \| swarmdo compact` or `swarmdo compact -- npm test` (exit code propagates). Deterministic, zero tokens |
-| `swarmdo codegraph` (alias `cg`) | **Queryable symbol index** — `codegraph index` scans TS/JS for exported symbols; `query <name>` (with `--fuzzy`/`--kind`) and `file <path>` answer "where is X defined / what does this file export" from `.swarm/codegraph.json` instead of grep+read round-trips. 1,750 symbols across 289 files in <1s. Also exposed as MCP tools (`codegraph_query`/`file`/`index`/`stats`) so agents query the index in-session |
+| `swarmdo codegraph` (alias `cg`) | **Queryable symbol index** — `codegraph index` scans TS/JS for exported symbols; `query <name>` (with `--fuzzy`/`--kind`) and `file <path>` answer "where is X defined / what does this file export" from `.swarm/codegraph.json` instead of grep+read round-trips. `codegraph importers <file>` shows reverse deps ("what breaks if I change this"); `codegraph imports <file>` shows a file's dependencies. 1,786 symbols + import graph across 296 files in <1s. Also MCP tools (`codegraph_query`/`file`/`imports`/`importers`/`index`/`stats`) so agents query the graph in-session |
 | `swarmdo redact` | **Mask secrets before they reach an LLM/log/memory** — detect API keys, tokens, and private keys (gitleaks-style rule catalog + Shannon-entropy fallback) and redact them. Stdin filter (`cat deploy.log \| swarmdo redact`), command-wrap (`swarmdo redact -- npm run deploy`), or `--scan` to fail CI on any secret. Also MCP tools (`redact_text`/`redact_scan`). Deterministic, zero tokens |
+| `swarmdo pack` | **Bundle a repo into one AI-context blob** — walk the tree (respects `.gitignore` + glob `--include`/`--exclude`, skips binaries/node_modules), emit markdown/xml/json/plain with a directory tree and per-file + total token estimates. `swarmdo pack --tokens` for a budget breakdown; `--redact` masks secrets first. Deterministic |
 | `swarmdo integrations` (alias `integrate`) | **Use swarmdo from Codex CLI, GitHub Copilot CLI, and pi** — one command wires AGENTS.md + each CLI's MCP config (idempotent, dry-run first, never touches your Claude Code setup) |
 | OpenRouter model pool | **Let swarms pick from any models you configure** — declare tier-mapped OpenRouter models in `swarmdo.config.json`; the router Thompson-samples among them per task and the execution layer dispatches the winner |
 | `swarmdo changelog` (alias `notes`) | **Release notes from conventional commits** — `--out NOTES.md` feeds `gh release create --notes-file` |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "swarmdo",
-  "version": "1.9.0",
+  "version": "1.11.0",
   "description": "Swarmdo - Enterprise AI agent orchestration for Claude Code. Deploy 60+ specialized agents in coordinated swarms with self-learning, fault-tolerant consensus, vector memory, and MCP integration",
   "main": "dist/index.js",
   "type": "module",

package/v3/@swarmdo/cli/dist/src/codegraph/codegraph.d.ts

@@ -21,13 +21,39 @@ export interface CodeSymbol {
     /** The trimmed declaration line (signature), truncated for storage. */
     signature: string;
 }
+/** A dependency edge: `from` imports module `spec`, resolved to a repo file when relative. */
+export interface ImportEdge {
+    /** repo-relative file containing the import */
+    from: string;
+    /** the raw module specifier as written, e.g. './store.js' or 'node:fs' */
+    spec: string;
+    /** repo-relative file the spec resolves to, or null for external/unresolved */
+    resolved: string | null;
+    /** 1-based line of the import */
+    line: number;
+}
 export interface CodeIndex {
     /** Repo-relative file → symbols declared in it. */
     symbols: CodeSymbol[];
+    /** Dependency edges between files (relative imports resolved; externals kept unresolved). */
+    imports: ImportEdge[];
     fileCount: number;
 }
 /** Extract exported symbols from one source file. Pure. */
 export declare function extractSymbols(source: string, file: string): CodeSymbol[];
+/** Extract the raw import specifiers from one source file. Pure. */
+export declare function extractImports(source: string, file: string): Array<{
+    from: string;
+    spec: string;
+    line: number;
+}>;
+/**
+ * Resolve a spec to a repo-relative file in `fileSet`, or null. Only relative
+ * specs (`.`/`..`) resolve; bare specifiers (packages, aliases, `node:`) are
+ * external → null. Tries the path as-is, common extensions, and `/index.*`,
+ * and rewrites a `.js` spec to its `.ts` sibling (TS ESM convention).
+ */
+export declare function resolveImport(fromFile: string, spec: string, fileSet: Set<string>): string | null;
 /** Build an index from already-read files. Pure. */
 export declare function buildIndex(files: Array<{
     file: string;
@@ -43,10 +69,18 @@ export interface QueryOptions {
 export declare function queryIndex(index: CodeIndex, name: string, opts?: QueryOptions): CodeSymbol[];
 /** Symbols declared in a specific file (exact repo-relative path). Pure. */
 export declare function symbolsInFile(index: CodeIndex, file: string): CodeSymbol[];
+/** Edges FROM a file — what it imports (resolved repo files + external specs). Pure. */
+export declare function fileImports(index: CodeIndex, file: string): ImportEdge[];
+/** Edges TO a file — who imports it ("what breaks if I change this"). Pure. */
+export declare function fileImporters(index: CodeIndex, file: string): ImportEdge[];
 export interface IndexStats {
     files: number;
     symbols: number;
     byKind: Record<string, number>;
+    /** total import edges */
+    imports: number;
+    /** edges resolved to an in-repo file (vs external packages) */
+    internalImports: number;
 }
 /** Summary counts for the index. Pure. */
 export declare function indexStats(index: CodeIndex): IndexStats;

package/v3/@swarmdo/cli/dist/src/codegraph/codegraph.js

@@ -57,15 +57,96 @@ export function extractSymbols(source, file) {
     }
     return out;
 }
+/**
+ * Module specifiers on a line, from any of: `import … from 'x'`,
+ * `export … from 'x'`, side-effect `import 'x'`, `require('x')`, and dynamic
+ * `import('x')`. Line-based like the symbol matchers; captures every spec on
+ * the line (dynamic imports can be mid-line).
+ */
+const IMPORT_RES = [
+    /\bfrom\s*['"]([^'"]+)['"]/g, // import/export … from '…'
+    /\bimport\s*['"]([^'"]+)['"]/g, // side-effect import '…'
+    /\bimport\s*\(\s*['"]([^'"]+)['"]\s*\)/g, // dynamic import('…')
+    /\brequire\s*\(\s*['"]([^'"]+)['"]\s*\)/g, // require('…')
+];
+/** Extract the raw import specifiers from one source file. Pure. */
+export function extractImports(source, file) {
+    const out = [];
+    const lines = source.split('\n');
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (!/\b(?:from|import|require)\b/.test(line))
+            continue;
+        const seen = new Set();
+        for (const re of IMPORT_RES) {
+            re.lastIndex = 0;
+            let m;
+            while ((m = re.exec(line)) !== null) {
+                const spec = m[1];
+                if (seen.has(spec))
+                    continue; // same spec caught by two patterns on one line
+                seen.add(spec);
+                out.push({ from: file, spec, line: i + 1 });
+            }
+        }
+    }
+    return out;
+}
+/** Normalize a relative spec against the importing file's dir → repo-relative POSIX path (no extension). */
+function joinRelative(fromFile, spec) {
+    const parts = fromFile.includes('/') ? fromFile.slice(0, fromFile.lastIndexOf('/')).split('/') : [];
+    for (const seg of spec.split('/')) {
+        if (seg === '' || seg === '.')
+            continue;
+        if (seg === '..')
+            parts.pop();
+        else
+            parts.push(seg);
+    }
+    return parts.join('/');
+}
+const RESOLVE_EXTS = ['', '.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs', '.mts', '.cts'];
+/**
+ * Resolve a spec to a repo-relative file in `fileSet`, or null. Only relative
+ * specs (`.`/`..`) resolve; bare specifiers (packages, aliases, `node:`) are
+ * external → null. Tries the path as-is, common extensions, and `/index.*`,
+ * and rewrites a `.js` spec to its `.ts` sibling (TS ESM convention).
+ */
+export function resolveImport(fromFile, spec, fileSet) {
+    if (!spec.startsWith('.'))
+        return null;
+    const base = joinRelative(fromFile, spec);
+    const bases = [base];
+    const jsExt = base.match(/\.(js|jsx|mjs|cjs)$/);
+    if (jsExt)
+        bases.push(base.slice(0, -jsExt[0].length)); // ./x.js → try ./x(.ts…)
+    for (const b of bases) {
+        for (const ext of RESOLVE_EXTS) {
+            if (fileSet.has(b + ext))
+                return b + ext;
+        }
+        for (const ext of RESOLVE_EXTS.slice(1)) {
+            if (fileSet.has(b + '/index' + ext))
+                return b + '/index' + ext;
+        }
+    }
+    return null;
+}
 /** Build an index from already-read files. Pure. */
 export function buildIndex(files) {
     const symbols = [];
+    const fileSet = new Set(files.map((f) => f.file));
+    const imports = [];
     for (const { file, source } of files) {
         symbols.push(...extractSymbols(source, file));
+        for (const imp of extractImports(source, file)) {
+            imports.push({ ...imp, resolved: resolveImport(imp.from, imp.spec, fileSet) });
+        }
     }
     // Stable order: file, then line.
     symbols.sort((a, b) => (a.file < b.file ? -1 : a.file > b.file ? 1 : a.line - b.line));
-    return { symbols, fileCount: files.length };
+    imports.sort((a, b) => (a.from < b.from ? -1 : a.from > b.from ? 1 : a.line - b.line));
+    return { symbols, imports, fileCount: files.length };
 }
 /** Look up symbols by name. Pure. */
 export function queryIndex(index, name, opts = {}) {
@@ -80,11 +161,26 @@ export function queryIndex(index, name, opts = {}) {
 export function symbolsInFile(index, file) {
     return index.symbols.filter((s) => s.file === file);
 }
+/** Edges FROM a file — what it imports (resolved repo files + external specs). Pure. */
+export function fileImports(index, file) {
+    return (index.imports ?? []).filter((e) => e.from === file);
+}
+/** Edges TO a file — who imports it ("what breaks if I change this"). Pure. */
+export function fileImporters(index, file) {
+    return (index.imports ?? []).filter((e) => e.resolved === file);
+}
 /** Summary counts for the index. Pure. */
 export function indexStats(index) {
     const byKind = {};
     for (const s of index.symbols)
         byKind[s.kind] = (byKind[s.kind] ?? 0) + 1;
-    return { files: index.fileCount, symbols: index.symbols.length, byKind };
+    const imports = index.imports ?? [];
+    return {
+        files: index.fileCount,
+        symbols: index.symbols.length,
+        byKind,
+        imports: imports.length,
+        internalImports: imports.filter((e) => e.resolved !== null).length,
+    };
 }
 //# sourceMappingURL=codegraph.js.map

package/v3/@swarmdo/cli/dist/src/commands/codegraph.js

@@ -13,11 +13,15 @@
  */
 import * as path from 'node:path';
 import { output } from '../output.js';
-import { queryIndex, symbolsInFile, indexStats, } from '../codegraph/codegraph.js';
+import { queryIndex, symbolsInFile, indexStats, fileImports, fileImporters, } from '../codegraph/codegraph.js';
 import { INDEX_REL, scanRepo, saveIndex, loadIndex } from '../codegraph/store.js';
 function fmtSymbol(s) {
     return `${s.file}:${s.line}  ${output.dim(`[${s.kind}]`)} ${s.signature}`;
 }
+/** Accept an absolute or cwd-relative path; return the repo-relative key. */
+function relKey(root, arg) {
+    return path.relative(root, path.resolve(root, arg)).split(path.sep).join('/');
+}
 const indexCommand = {
     name: 'index',
     description: 'Scan the tree for exported symbols and persist the index',
@@ -124,32 +128,102 @@ const statsCommand = {
             output.printJson(stats);
             return { success: true, data: stats };
         }
-        output.writeln(output.bold(`codegraph: ${stats.symbols} symbols, ${stats.files} files`));
+        output.writeln(output.bold(`codegraph: ${stats.symbols} symbols, ${stats.files} files, ${stats.imports} imports (${stats.internalImports} internal)`));
         output.printList(Object.entries(stats.byKind).sort((a, b) => b[1] - a[1]).map(([k, n]) => `${k}: ${n}`));
         return { success: true, exitCode: 0 };
     },
 };
+const importsCommand = {
+    name: 'imports',
+    description: 'What a file imports — resolved repo files + external packages',
+    options: [
+        { name: 'internal', description: 'only edges resolved to a repo file (hide external packages)', type: 'boolean', default: false },
+        { name: 'json', description: 'machine-readable output', type: 'boolean', default: false },
+    ],
+    action: async (ctx) => {
+        const root = ctx.cwd || process.cwd();
+        const arg = ctx.args[0];
+        if (!arg) {
+            output.printError('Usage: swarmdo codegraph imports <path>');
+            return { success: false, exitCode: 1 };
+        }
+        const index = loadIndex(root);
+        if (!index) {
+            output.printError(`no index — run \`swarmdo codegraph index\` first`);
+            return { success: false, exitCode: 1 };
+        }
+        let edges = fileImports(index, relKey(root, arg));
+        if (ctx.flags.internal === true)
+            edges = edges.filter((e) => e.resolved !== null);
+        if (ctx.flags.json === true) {
+            output.printJson(edges);
+            return { success: true, data: edges };
+        }
+        if (edges.length === 0) {
+            output.writeln(output.dim(`no imports in ${relKey(root, arg)} (indexed?)`));
+            return { success: true, exitCode: 0 };
+        }
+        for (const e of edges) {
+            output.writeln(`  ${e.line}  ${e.spec}${e.resolved ? output.dim(` → ${e.resolved}`) : output.dim(' (external)')}`);
+        }
+        return { success: true, exitCode: 0 };
+    },
+};
+const importersCommand = {
+    name: 'importers',
+    aliases: ['rdeps'],
+    description: 'Who imports a file — reverse deps ("what breaks if I change this")',
+    options: [{ name: 'json', description: 'machine-readable output', type: 'boolean', default: false }],
+    action: async (ctx) => {
+        const root = ctx.cwd || process.cwd();
+        const arg = ctx.args[0];
+        if (!arg) {
+            output.printError('Usage: swarmdo codegraph importers <path>');
+            return { success: false, exitCode: 1 };
+        }
+        const index = loadIndex(root);
+        if (!index) {
+            output.printError(`no index — run \`swarmdo codegraph index\` first`);
+            return { success: false, exitCode: 1 };
+        }
+        const edges = fileImporters(index, relKey(root, arg));
+        if (ctx.flags.json === true) {
+            output.printJson(edges);
+            return { success: true, data: edges };
+        }
+        if (edges.length === 0) {
+            output.writeln(output.dim(`nothing imports ${relKey(root, arg)} (leaf, entrypoint, or not indexed)`));
+            return { success: true, exitCode: 0 };
+        }
+        for (const e of edges)
+            output.writeln(`  ${e.from}:${e.line}  ${output.dim(e.spec)}`);
+        return { success: true, exitCode: 0 };
+    },
+};
 export const codegraphCommand = {
     name: 'codegraph',
     aliases: ['cg'],
-    description: 'Queryable index of exported symbols — where things are defined, without grep+read',
-    subcommands: [indexCommand, queryCommand, fileCommand, statsCommand],
+    description: 'Queryable index of exported symbols + import graph — where things are defined and what depends on what, without grep+read',
+    subcommands: [indexCommand, queryCommand, fileCommand, importsCommand, importersCommand, statsCommand],
     options: [],
     examples: [
-        { command: 'swarmdo codegraph index', description: 'Scan the repo and persist the symbol index' },
+        { command: 'swarmdo codegraph index', description: 'Scan the repo and persist the symbol + import index' },
         { command: 'swarmdo codegraph query buildIndex', description: 'Find where a symbol is defined' },
         { command: 'swarmdo codegraph query Handler --fuzzy --kind type', description: 'Fuzzy, kind-filtered lookup' },
         { command: 'swarmdo codegraph file src/index.ts', description: 'What a file exports' },
+        { command: 'swarmdo codegraph importers src/codegraph/store.ts', description: 'What breaks if I change this file' },
     ],
     action: async () => {
-        output.writeln(output.bold('swarmdo codegraph — exported-symbol index'));
+        output.writeln(output.bold('swarmdo codegraph — exported-symbol index + import graph'));
         output.printList([
-            'index [path]   scan TS/JS and persist to .swarm/codegraph.json',
-            'query <name>   find a symbol (--fuzzy, --kind)',
-            'file <path>    symbols a file exports',
-            'stats          index summary',
+            'index [path]      scan TS/JS and persist to .swarm/codegraph.json',
+            'query <name>      find a symbol (--fuzzy, --kind)',
+            'file <path>       symbols a file exports',
+            'imports <path>    what a file imports (--internal)',
+            'importers <path>  who imports a file (reverse deps)',
+            'stats             index summary',
         ]);
-        output.writeln(output.dim('MVP: exported top-level symbols. Call-graph edges + watch + MCP tool are follow-ups.'));
+        output.writeln(output.dim('MVP: exported top-level symbols + relative-import edges. Incremental watch is a follow-up.'));
         return { success: true, exitCode: 0 };
     },
 };

package/v3/@swarmdo/cli/dist/src/commands/index.js

@@ -25,6 +25,9 @@ const commandLoaders = {
     // Secret detection + redaction on the agent data path (gitleaks/trufflehog
     // demand) — mask API keys/tokens before they reach an LLM/log/memory.
     redact: () => import('./redact.js'),
+    // Repo→AI-context bundle (repomix demand) — one promptable blob with tree +
+    // token counts; swarmdo's context-assembly primitive.
+    pack: () => import('./pack.js'),
     // Queryable exported-symbol index (codegraph demand) — where things are
     // defined without grep+read round-trips.
     codegraph: () => import('./codegraph.js'),
@@ -258,7 +261,7 @@ export async function getCommandsByCategory() {
     // three slots from 'statusline' onward (completionsCmd received the
     // statusline module, analyzeCmd received completions, …), scrambling the
     // categorized help. Every load now has a named slot.
-    const [daemonCmd, doctorCmd, embeddingsCmd, neuralCmd, performanceCmd, securityCmd, swarmvectorCmd, hiveMindCmd, configCmd, statuslineCmd, compressCmd, efficiencyCmd, completionsCmd, migrateCmd, workflowCmd, analyzeCmd, routeCmd, progressCmd, providersCmd, pluginsCmd, deploymentCmd, claimsCmd, issuesCmd, updateCmd, processCmd, guidanceCmd, applianceCmd, cleanupCmd, autopilotCmd, demoCmd, usageCmd, repairCmd, hudCmd, compactCmd, codegraphCmd, redactCmd,] = await Promise.all([
+    const [daemonCmd, doctorCmd, embeddingsCmd, neuralCmd, performanceCmd, securityCmd, swarmvectorCmd, hiveMindCmd, configCmd, statuslineCmd, compressCmd, efficiencyCmd, completionsCmd, migrateCmd, workflowCmd, analyzeCmd, routeCmd, progressCmd, providersCmd, pluginsCmd, deploymentCmd, claimsCmd, issuesCmd, updateCmd, processCmd, guidanceCmd, applianceCmd, cleanupCmd, autopilotCmd, demoCmd, usageCmd, repairCmd, hudCmd, compactCmd, codegraphCmd, redactCmd, packCmd,] = await Promise.all([
         loadCommand('daemon'), loadCommand('doctor'), loadCommand('embeddings'), loadCommand('neural'),
         loadCommand('performance'), loadCommand('security'), loadCommand('swarmvector'), loadCommand('hive-mind'),
         loadCommand('config'), loadCommand('statusline'), loadCommand('compress'), loadCommand('efficiency'),
@@ -266,7 +269,7 @@ export async function getCommandsByCategory() {
         loadCommand('analyze'), loadCommand('route'), loadCommand('progress'), loadCommand('providers'),
         loadCommand('plugins'), loadCommand('deployment'), loadCommand('claims'), loadCommand('issues'),
         loadCommand('update'), loadCommand('process'), loadCommand('guidance'), loadCommand('appliance'),
-        loadCommand('cleanup'), loadCommand('autopilot'), loadCommand('demo'), loadCommand('usage'), loadCommand('repair'), loadCommand('hud'), loadCommand('compact'), loadCommand('codegraph'), loadCommand('redact'),
+        loadCommand('cleanup'), loadCommand('autopilot'), loadCommand('demo'), loadCommand('usage'), loadCommand('repair'), loadCommand('hud'), loadCommand('compact'), loadCommand('codegraph'), loadCommand('redact'), loadCommand('pack'),
     ]);
     return {
         primary: [
@@ -282,7 +285,7 @@ export async function getCommandsByCategory() {
         utility: [
             configCmd, doctorCmd, daemonCmd, completionsCmd,
             migrateCmd, workflowCmd, demoCmd,
-            statuslineCmd, compressCmd, compactCmd, redactCmd, efficiencyCmd,
+            statuslineCmd, compressCmd, compactCmd, redactCmd, packCmd, efficiencyCmd,
         ].filter(Boolean),
         analysis: [
             analyzeCmd, routeCmd, progressCmd, usageCmd, hudCmd, codegraphCmd,

package/v3/@swarmdo/cli/dist/src/commands/pack.d.ts

@@ -0,0 +1,18 @@
+/**
+ * `swarmdo pack` — bundle a repo (or subset) into one AI-friendly context blob.
+ *
+ *   swarmdo pack                         # markdown bundle of the repo → stdout
+ *   swarmdo pack src --format xml -o ctx.xml
+ *   swarmdo pack --include '*.ts' --exclude '*.test.ts'
+ *   swarmdo pack --tokens                # just per-file + total token counts
+ *   swarmdo pack --redact                # mask secrets in each file first
+ *
+ * The fs walk lives here (default skips + .gitignore + glob include/exclude +
+ * binary/size guards); the pure engine (../pack/pack.ts) does formatting +
+ * token accounting. --redact composes the ../redact engine so secrets never
+ * land in the bundle.
+ */
+import type { Command } from '../types.js';
+export declare const packCommand: Command;
+export default packCommand;
+//# sourceMappingURL=pack.d.ts.map

package/v3/@swarmdo/cli/dist/src/commands/pack.js

@@ -0,0 +1,184 @@
+/**
+ * `swarmdo pack` — bundle a repo (or subset) into one AI-friendly context blob.
+ *
+ *   swarmdo pack                         # markdown bundle of the repo → stdout
+ *   swarmdo pack src --format xml -o ctx.xml
+ *   swarmdo pack --include '*.ts' --exclude '*.test.ts'
+ *   swarmdo pack --tokens                # just per-file + total token counts
+ *   swarmdo pack --redact                # mask secrets in each file first
+ *
+ * The fs walk lives here (default skips + .gitignore + glob include/exclude +
+ * binary/size guards); the pure engine (../pack/pack.ts) does formatting +
+ * token accounting. --redact composes the ../redact engine so secrets never
+ * land in the bundle.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { output } from '../output.js';
+import { packFiles, makeIgnoreMatcher } from '../pack/pack.js';
+import { redactText } from '../redact/redact.js';
+const SKIP_DIRS = new Set([
+    'node_modules', '.git', '.swarm', 'dist', 'dist-standalone', 'build',
+    'coverage', '.next', '.turbo', 'out', 'vendor', '.cache',
+]);
+const BINARY_EXT = new Set([
+    'png', 'jpg', 'jpeg', 'gif', 'webp', 'ico', 'pdf', 'zip', 'gz', 'tar', 'tgz',
+    'woff', 'woff2', 'ttf', 'eot', 'mp4', 'mov', 'mp3', 'wav', 'wasm', 'so', 'dylib',
+    'dll', 'exe', 'bin', 'node', 'lock', 'jpeg',
+]);
+/** Looks binary if it has a NUL in the first 8 KiB. */
+function looksBinary(buf) {
+    const n = Math.min(buf.length, 8192);
+    for (let i = 0; i < n; i++)
+        if (buf[i] === 0)
+            return true;
+    return false;
+}
+function walk(o) {
+    const files = [];
+    const stack = [o.root];
+    while (stack.length) {
+        const dir = stack.pop();
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const e of entries) {
+            const full = path.join(dir, e.name);
+            const rel = path.relative(o.root, full).split(path.sep).join('/');
+            if (e.isDirectory()) {
+                if (SKIP_DIRS.has(e.name))
+                    continue;
+                if (o.gitignore?.(rel + '/'))
+                    continue;
+                stack.push(full);
+            }
+            else if (e.isFile()) {
+                if (o.gitignore?.(rel))
+                    continue;
+                if (o.exclude?.(rel))
+                    continue;
+                if (o.include && !o.include(rel))
+                    continue;
+                if (BINARY_EXT.has(e.name.slice(e.name.lastIndexOf('.') + 1).toLowerCase()))
+                    continue;
+                let stat;
+                try {
+                    stat = fs.statSync(full);
+                }
+                catch {
+                    continue;
+                }
+                if (stat.size > o.maxBytes)
+                    continue;
+                let buf;
+                try {
+                    buf = fs.readFileSync(full);
+                }
+                catch {
+                    continue;
+                }
+                if (looksBinary(buf))
+                    continue;
+                files.push({ path: rel, content: buf.toString('utf8') });
+            }
+        }
+    }
+    return files;
+}
+function csv(v) {
+    if (typeof v !== 'string' || !v)
+        return undefined;
+    return v.split(',').map((s) => s.trim()).filter(Boolean);
+}
+async function run(ctx) {
+    const repoRoot = ctx.cwd || process.cwd();
+    const scanRoot = ctx.args[0] ? path.resolve(repoRoot, ctx.args[0]) : repoRoot;
+    // NB: use --style, not --format — `format` is a global flag (text/json/table,
+    // default 'text') that would shadow ours (#1425 removed its short alias).
+    const format = (typeof ctx.flags.style === 'string' ? ctx.flags.style : 'md');
+    if (!['md', 'xml', 'json', 'plain'].includes(format)) {
+        output.printError(`unknown --style '${format}' (use md|xml|json|plain)`);
+        return { success: false, exitCode: 1 };
+    }
+    const maxKb = typeof ctx.flags['max-file-size'] === 'string' ? parseInt(ctx.flags['max-file-size'], 10) : 512;
+    const maxBytes = (Number.isFinite(maxKb) ? maxKb : 512) * 1024;
+    const includePats = csv(ctx.flags.include);
+    const excludePats = csv(ctx.flags.exclude);
+    let gitignore;
+    if (ctx.flags['no-gitignore'] !== true) {
+        try {
+            const gi = fs.readFileSync(path.join(scanRoot, '.gitignore'), 'utf8').split('\n');
+            gitignore = makeIgnoreMatcher(gi);
+        }
+        catch { /* no .gitignore */ }
+    }
+    const files = walk({
+        root: scanRoot,
+        include: includePats ? makeIgnoreMatcher(includePats) : undefined,
+        exclude: excludePats ? makeIgnoreMatcher(excludePats) : undefined,
+        gitignore,
+        maxBytes,
+    });
+    if (files.length === 0) {
+        output.printError('no files matched — check the path, --include/--exclude, or .gitignore');
+        return { success: false, exitCode: 1 };
+    }
+    const opts = { format, tree: ctx.flags['no-tree'] !== true };
+    if (ctx.flags.redact === true) {
+        opts.transform = (content) => redactText(content).output;
+    }
+    const { output: bundle, stats } = packFiles(files, opts);
+    // --tokens: report accounting only, no bundle.
+    if (ctx.flags.tokens === true) {
+        if (ctx.flags.json === true) {
+            output.printJson(stats);
+        }
+        else {
+            for (const f of [...stats.perFile].sort((a, b) => b.tokens - a.tokens)) {
+                output.writeln(`${String(f.tokens).padStart(8)}  ${f.path}`);
+            }
+            output.writeln(output.bold(`${String(stats.tokens).padStart(8)}  TOTAL (${stats.files} files, ${(stats.bytes / 1024).toFixed(1)} KiB)`));
+        }
+        return { success: true, exitCode: 0 };
+    }
+    const outFile = (typeof ctx.flags.output === 'string' && ctx.flags.output) || (typeof ctx.flags.o === 'string' && ctx.flags.o);
+    if (outFile) {
+        fs.writeFileSync(path.resolve(repoRoot, outFile), bundle);
+        output.printSuccess(`packed ${stats.files} files (~${stats.tokens} tokens) → ${outFile}`);
+    }
+    else {
+        process.stdout.write(bundle);
+        if (!process.stdout.isTTY) { /* piped: keep stdout clean */ }
+        process.stderr.write(output.dim(`packed ${stats.files} files (~${stats.tokens} tokens)\n`));
+    }
+    return { success: true, exitCode: 0 };
+}
+export const packCommand = {
+    name: 'pack',
+    description: 'Bundle a repo (or subset) into one AI-friendly context blob (md/xml/json/plain) with a tree + token counts — deterministic',
+    options: [
+        { name: 'style', description: 'output format: md (default), xml, json, plain', type: 'string' },
+        { name: 'include', description: 'comma-separated globs; keep only matching files (e.g. "*.ts,*.md")', type: 'string' },
+        { name: 'exclude', description: 'comma-separated globs to skip (e.g. "*.test.ts")', type: 'string' },
+        { name: 'output', short: 'o', description: 'write the bundle to a file instead of stdout', type: 'string' },
+        { name: 'no-tree', description: 'omit the directory tree header', type: 'boolean' },
+        { name: 'no-gitignore', description: "don't apply the repo's .gitignore", type: 'boolean' },
+        { name: 'max-file-size', description: 'skip files larger than N KiB (default 512)', type: 'string' },
+        { name: 'redact', description: 'mask secrets in each file before bundling (uses `swarmdo redact`)', type: 'boolean' },
+        { name: 'tokens', description: 'print per-file + total token estimates only, no bundle', type: 'boolean' },
+        { name: 'json', description: 'with --tokens, emit the stats as JSON', type: 'boolean' },
+    ],
+    examples: [
+        { command: 'swarmdo pack src -o context.md', description: 'Bundle src/ to a markdown file' },
+        { command: "swarmdo pack --include '*.ts' --exclude '*.test.ts'", description: 'Only non-test TypeScript' },
+        { command: 'swarmdo pack --tokens', description: 'Token budget breakdown, largest first' },
+        { command: 'swarmdo pack --redact --style xml', description: 'Secret-safe XML bundle' },
+    ],
+    action: run,
+};
+export default packCommand;
+//# sourceMappingURL=pack.js.map

package/v3/@swarmdo/cli/dist/src/mcp-tools/codegraph-tools.js

@@ -6,7 +6,7 @@
  * instead of shelling out to `swarmdo codegraph` or grep+read. Reads the same
  * .swarm/codegraph.json the CLI writes (shared fs layer in codegraph/store.ts).
  */
-import { queryIndex, symbolsInFile, indexStats } from '../codegraph/codegraph.js';
+import { queryIndex, symbolsInFile, indexStats, fileImports, fileImporters } from '../codegraph/codegraph.js';
 import { INDEX_REL, scanRepo, saveIndex, loadIndex } from '../codegraph/store.js';
 const KINDS = ['function', 'class', 'interface', 'type', 'const', 'enum', 'default'];
 /** Resolve the repo root for scan/load. Params may override; default = cwd. */
@@ -113,10 +113,65 @@ const codegraphStatsTool = {
         return indexStats(index);
     },
 };
+const codegraphImportsTool = {
+    name: 'codegraph_imports',
+    description: 'List what a file imports — each edge as the raw specifier plus the repo file it resolves to (external packages resolve to null). Answers "what does this module depend on" from the index. Requires a prior codegraph_index.',
+    category: 'codegraph',
+    tags: ['code', 'imports', 'dependencies', 'navigation'],
+    inputSchema: {
+        type: 'object',
+        properties: {
+            file: { type: 'string', description: 'Repo-relative file path (as indexed, e.g. src/index.ts)' },
+            internal: { type: 'boolean', description: 'only edges resolved to a repo file (hide external packages)', default: false },
+            root: { type: 'string', description: 'Repo root (default: current working directory)' },
+        },
+        required: ['file'],
+    },
+    handler: async (params) => {
+        const root = rootOf(params);
+        const file = params.file;
+        if (typeof file !== 'string' || !file)
+            return { error: true, message: 'file is required' };
+        const index = loadIndex(root);
+        if (!index)
+            return { error: true, message: 'no index — run codegraph_index first' };
+        let edges = fileImports(index, file);
+        if (params.internal === true)
+            edges = edges.filter((e) => e.resolved !== null);
+        return { file, count: edges.length, edges };
+    },
+};
+const codegraphImportersTool = {
+    name: 'codegraph_importers',
+    description: 'List which files import a given file — its reverse dependencies. Use before changing or moving a file to see what depends on it ("what breaks if I change this"). Requires a prior codegraph_index.',
+    category: 'codegraph',
+    tags: ['code', 'imports', 'dependencies', 'impact', 'navigation'],
+    inputSchema: {
+        type: 'object',
+        properties: {
+            file: { type: 'string', description: 'Repo-relative file path whose importers you want' },
+            root: { type: 'string', description: 'Repo root (default: current working directory)' },
+        },
+        required: ['file'],
+    },
+    handler: async (params) => {
+        const root = rootOf(params);
+        const file = params.file;
+        if (typeof file !== 'string' || !file)
+            return { error: true, message: 'file is required' };
+        const index = loadIndex(root);
+        if (!index)
+            return { error: true, message: 'no index — run codegraph_index first' };
+        const edges = fileImporters(index, file);
+        return { file, count: edges.length, importers: edges };
+    },
+};
 export const codegraphTools = [
     codegraphIndexTool,
     codegraphQueryTool,
     codegraphFileTool,
+    codegraphImportsTool,
+    codegraphImportersTool,
     codegraphStatsTool,
 ];
 //# sourceMappingURL=codegraph-tools.js.map

package/v3/@swarmdo/cli/dist/src/pack/pack.d.ts

@@ -0,0 +1,59 @@
+/**
+ * pack.ts — bundle a repo (or a subset) into one AI-friendly context blob.
+ *
+ * swarmdo has no context-assembly primitive: `codegraph` indexes symbols for
+ * *querying* and `compact` de-noises a *stream*, but neither emits promptable
+ * source for *feeding a model*. `pack` walks the tree (respecting default skips
+ * + a minimal .gitignore + glob include/exclude), and writes a bundle in
+ * markdown / xml / json / plain with a directory tree and per-file + total
+ * token estimates. Deterministic — same inputs, byte-identical output.
+ *
+ * Pure engine: the fs walk is injected as a file list + reader by the caller
+ * (../commands/pack.ts), so this module has no fs dependency and is trivially
+ * testable. Optional secret redaction reuses ../redact/redact.ts.
+ */
+export type PackFormat = 'md' | 'xml' | 'json' | 'plain';
+export interface PackFile {
+    /** repo-relative path, POSIX separators */
+    path: string;
+    content: string;
+}
+export interface PackOptions {
+    format?: PackFormat;
+    /** include a directory tree at the top (default true) */
+    tree?: boolean;
+    /** optional per-file transform (e.g. secret redaction) applied before bundling */
+    transform?: (content: string, path: string) => string;
+}
+export interface PackFileStat {
+    path: string;
+    bytes: number;
+    tokens: number;
+}
+export interface PackResult {
+    output: string;
+    stats: {
+        files: number;
+        bytes: number;
+        tokens: number;
+        perFile: PackFileStat[];
+    };
+}
+/**
+ * Cheap, deterministic token estimate (~4 chars/token, the widely-used rule of
+ * thumb for English + code). Not a real BPE tokenizer — good enough for budget
+ * warnings, and dependency-free.
+ */
+export declare function estimateTokens(text: string): number;
+/** Build an ASCII directory tree from a sorted file list. */
+export declare function buildTree(paths: string[]): string;
+/** Bundle files into a single context blob per `format`. */
+export declare function packFiles(input: PackFile[], opts?: PackOptions): PackResult;
+/**
+ * Minimal .gitignore-style matcher. Handles the common cases — plain names,
+ * `dir/`, `*.ext` globs, leading `/` anchors, and `!` negation — not the full
+ * spec (no `**` depth semantics beyond substring, no nested ignore files).
+ * Good enough to keep obvious noise out; full semantics is a follow-up.
+ */
+export declare function makeIgnoreMatcher(patterns: string[]): (relPath: string) => boolean;
+//# sourceMappingURL=pack.d.ts.map

package/v3/@swarmdo/cli/dist/src/pack/pack.js

@@ -0,0 +1,178 @@
+/**
+ * pack.ts — bundle a repo (or a subset) into one AI-friendly context blob.
+ *
+ * swarmdo has no context-assembly primitive: `codegraph` indexes symbols for
+ * *querying* and `compact` de-noises a *stream*, but neither emits promptable
+ * source for *feeding a model*. `pack` walks the tree (respecting default skips
+ * + a minimal .gitignore + glob include/exclude), and writes a bundle in
+ * markdown / xml / json / plain with a directory tree and per-file + total
+ * token estimates. Deterministic — same inputs, byte-identical output.
+ *
+ * Pure engine: the fs walk is injected as a file list + reader by the caller
+ * (../commands/pack.ts), so this module has no fs dependency and is trivially
+ * testable. Optional secret redaction reuses ../redact/redact.ts.
+ */
+/**
+ * Cheap, deterministic token estimate (~4 chars/token, the widely-used rule of
+ * thumb for English + code). Not a real BPE tokenizer — good enough for budget
+ * warnings, and dependency-free.
+ */
+export function estimateTokens(text) {
+    if (!text)
+        return 0;
+    return Math.ceil(text.length / 4);
+}
+/** Build an ASCII directory tree from a sorted file list. */
+export function buildTree(paths) {
+    const root = {};
+    for (const p of [...paths].sort()) {
+        const parts = p.split('/');
+        let node = root;
+        for (let i = 0; i < parts.length; i++) {
+            const part = parts[i];
+            const isFile = i === parts.length - 1;
+            if (isFile) {
+                if (!node['\0files'])
+                    node['\0files'] = [];
+                node['\0files'].push(part);
+            }
+            else {
+                node[part] = node[part] ?? {};
+                node = node[part];
+            }
+        }
+    }
+    const lines = [];
+    const walk = (node, prefix) => {
+        const dirs = Object.keys(node).filter((k) => k !== '\0files').sort();
+        const files = (node['\0files'] ?? []).sort();
+        const entries = [...dirs.map((d) => ['dir', d]), ...files.map((f) => ['file', f])];
+        entries.forEach(([kind, name], i) => {
+            const last = i === entries.length - 1;
+            lines.push(`${prefix}${last ? '└── ' : '├── '}${name}${kind === 'dir' ? '/' : ''}`);
+            if (kind === 'dir')
+                walk(node[name], prefix + (last ? '    ' : '│   '));
+        });
+    };
+    walk(root, '');
+    return lines.join('\n');
+}
+/** Pick a fenced-code language hint from a file extension. */
+function langOf(path) {
+    const ext = path.slice(path.lastIndexOf('.') + 1).toLowerCase();
+    const map = {
+        ts: 'typescript', tsx: 'tsx', js: 'javascript', jsx: 'jsx', mjs: 'javascript', cjs: 'javascript',
+        json: 'json', md: 'markdown', py: 'python', rs: 'rust', go: 'go', sh: 'bash', yml: 'yaml', yaml: 'yaml',
+        html: 'html', css: 'css', sql: 'sql', toml: 'toml',
+    };
+    return map[ext] ?? '';
+}
+function renderMarkdown(files, opts) {
+    const parts = ['# Repository context', ''];
+    if (opts.tree !== false) {
+        parts.push('## Files', '', '```', buildTree(files.map((f) => f.path)), '```', '');
+    }
+    parts.push('## Contents', '');
+    for (const f of files) {
+        const lang = langOf(f.path);
+        parts.push(`### ${f.path}`, '', '```' + lang, f.content.replace(/\n$/, ''), '```', '');
+    }
+    return parts.join('\n');
+}
+function escapeXml(s) {
+    return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+}
+function renderXml(files, opts) {
+    const parts = ['<repository>'];
+    if (opts.tree !== false) {
+        parts.push('  <tree>', escapeXml(buildTree(files.map((f) => f.path))), '  </tree>');
+    }
+    parts.push('  <files>');
+    for (const f of files) {
+        parts.push(`    <file path="${escapeXml(f.path)}">`, escapeXml(f.content.replace(/\n$/, '')), '    </file>');
+    }
+    parts.push('  </files>', '</repository>');
+    return parts.join('\n');
+}
+function renderJson(files) {
+    return JSON.stringify({ files: files.map((f) => ({ path: f.path, content: f.content })) }, null, 2);
+}
+function renderPlain(files) {
+    const parts = [];
+    for (const f of files) {
+        parts.push('='.repeat(8) + ' ' + f.path + ' ' + '='.repeat(8), f.content.replace(/\n$/, ''), '');
+    }
+    return parts.join('\n');
+}
+/** Bundle files into a single context blob per `format`. */
+export function packFiles(input, opts = {}) {
+    const files = input
+        .map((f) => ({ path: f.path, content: opts.transform ? opts.transform(f.content, f.path) : f.content }))
+        .sort((a, b) => a.path.localeCompare(b.path));
+    const format = opts.format ?? 'md';
+    let output;
+    switch (format) {
+        case 'xml':
+            output = renderXml(files, opts);
+            break;
+        case 'json':
+            output = renderJson(files);
+            break;
+        case 'plain':
+            output = renderPlain(files);
+            break;
+        default: output = renderMarkdown(files, opts);
+    }
+    const perFile = files.map((f) => ({
+        path: f.path,
+        bytes: Buffer.byteLength(f.content, 'utf8'),
+        tokens: estimateTokens(f.content),
+    }));
+    return {
+        output,
+        stats: {
+            files: files.length,
+            bytes: perFile.reduce((n, f) => n + f.bytes, 0),
+            tokens: estimateTokens(output),
+            perFile,
+        },
+    };
+}
+/**
+ * Minimal .gitignore-style matcher. Handles the common cases — plain names,
+ * `dir/`, `*.ext` globs, leading `/` anchors, and `!` negation — not the full
+ * spec (no `**` depth semantics beyond substring, no nested ignore files).
+ * Good enough to keep obvious noise out; full semantics is a follow-up.
+ */
+export function makeIgnoreMatcher(patterns) {
+    const rules = patterns
+        .map((p) => p.trim())
+        .filter((p) => p && !p.startsWith('#'))
+        .map((p) => {
+        const negate = p.startsWith('!');
+        let body = negate ? p.slice(1) : p;
+        const dirOnly = body.endsWith('/');
+        if (dirOnly)
+            body = body.slice(0, -1);
+        const anchored = body.startsWith('/');
+        if (anchored)
+            body = body.slice(1);
+        const re = new RegExp('^' +
+            body
+                .replace(/[.+^${}()|[\]\\]/g, '\\$&')
+                .replace(/\*/g, '[^/]*')
+                .replace(/\?/g, '[^/]') +
+            (dirOnly ? '(/|$)' : '($|/)'));
+        return { negate, anchored, re };
+    });
+    return (relPath) => {
+        let ignored = false;
+        for (const r of rules) {
+            const candidates = r.anchored ? [relPath] : [relPath, ...relPath.split('/').map((_, i, a) => a.slice(i).join('/'))];
+            if (candidates.some((c) => r.re.test(c)))
+                ignored = !r.negate;
+        }
+        return ignored;
+    };
+}
+//# sourceMappingURL=pack.js.map

package/v3/@swarmdo/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarmdo/cli",
-  "version": "1.9.0",
+  "version": "1.11.0",
   "type": "module",
   "description": "Swarmdo CLI - Enterprise AI agent orchestration with 60+ specialized agents, swarm coordination, MCP server, self-learning hooks, and vector memory for Claude Code",
   "main": "dist/src/index.js",