binder-cli 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Corrjo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,177 @@
+# Binder
+
+A lightweight CLI tool to orchestrate "Virtual Monoliths" from distributed repositories and define semantic boundaries for AI agents.
+
+**[Read the docs →](https://corrjo.github.io/binder-website/)**
+
+## What is Binder?
+
+Binder helps you work across multiple repositories by defining clear scopes and permissions for AI-assisted development. Instead of manually managing repo clones and context, define your workspace topology once and let Binder handle the rest.
+
+## Installation
+
+```bash
+npm install -g binder-cli
+```
+
+## Quick Start
+
+```bash
+# Initialize a new workspace
+binder init
+
+# Edit binder.yaml to add your repositories...
+
+# Clone/checkout repositories
+binder pull
+
+# Generate AI context map
+binder context
+
+# Check workspace status
+binder status
+```
+
+## Commands
+
+### `binder init`
+
+Creates a new `binder.yaml` configuration file with a commented template.
+
+### `binder pull`
+
+Clones missing repositories and checks out configured branches. This command is idempotent - safe to run multiple times.
+
+### `binder context`
+
+Generates `CONTEXT_MAP.md` - an AI-readable file that describes your workspace topology, scopes, and permissions. Use this in your AI system prompts or `.cursorrules`.
+
+### `binder status`
+
+Shows the current state of your workspace:
+- Which repos exist vs missing
+- Dirty repos (uncommitted changes)
+- Branch mismatches
+- Orphaned repos (on disk but not in config)
+
+## Configuration
+
+### binder.yaml
+
+```yaml
+name: my-workspace
+
+repos:
+  # OWNER - Full read/write access
+  - name: my-service
+    url: git@github.com:org/my-service.git
+    scope: owner
+    path: ./services/my-service  # optional
+    branch: main                  # optional
+    notes: "Core service"         # optional
+
+  # PLATFORM - Guest contributor
+  - name: shared-platform
+    url: https://github.com/org/platform.git
+    scope: platform
+    notes: "Shared infrastructure - minimal changes only"
+
+  # REFERENCE - Read only
+  - name: legacy-api
+    url: git@github.com:org/legacy-api.git
+    scope: reference
+    depth: 1  # shallow clone
+    notes: "Reference only - historical context"
+```
+
+### Repository Options
+
+| Option | Required | Description |
+|--------|----------|-------------|
+| `name` | Yes | Repository name (used for display and default path) |
+| `url` | Yes | Git URL (HTTPS or SSH) |
+| `scope` | Yes | Access level: `owner`, `platform`, or `reference` |
+| `path` | No | Local path (defaults to `./repos/{name}`) |
+| `branch` | No | Branch to checkout |
+| `notes` | No | Context notes for AI agents |
+| `depth` | No | Shallow clone depth |
+
+## Core Concepts
+
+### Scopes
+
+- **OWNER** (green) - Full read/write access. Your primary workspace. AI can refactor freely.
+- **PLATFORM** (yellow) - Guest contributor. Read fully, edit conservatively. AI should follow existing patterns.
+- **REFERENCE** (red) - Read-only. For validation and historical context. AI should not suggest modifications.
+
+### CONTEXT_MAP.md
+
+The generated context map tells AI agents:
+- Which repositories exist in your workspace
+- What scope/permissions apply to each
+- Specific instructions per scope
+- Any notes you've provided
+
+Example output:
+
+```markdown
+# WORKSPACE TOPOLOGY & SCOPE DEFINITIONS
+
+**Workspace:** my-workspace
+
+## 🟢 SCOPE: OWNER (Full Authority)
+
+**Repositories:**
+- `my-service` at `./services/my-service`
+
+**Permissions:** Full read/write access
+**Instructions:**
+- You are responsible for architecture, implementation, and refactoring.
+- Make changes freely to improve code quality and functionality.
+
+## 🟡 SCOPE: PLATFORM (Restricted Contributor)
+
+**Repositories:**
+- `shared-platform` at `./repos/shared-platform`
+  - *Shared infrastructure - minimal changes only*
+
+**Permissions:** Limited write access
+**Instructions:**
+- Only make minimal changes when necessary to support OWNER scope.
+- Strictly adhere to existing patterns and conventions.
+```
+
+## Philosophy
+
+**Topology vs. Task** - Binder separates workspace definition from feature implementation:
+
+- **Binder's job**: "Here are the repos. You own these, you're a guest here, read-only there."
+- **Your job**: "We are building Feature X. Please implement Y."
+
+This separation allows AI agents to understand their permissions and responsibilities across your distributed codebase without manual context management.
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Run in development mode
+npm run dev -- init
+
+# Run tests
+npm test
+
+# Lint and format
+npm run lint:fix
+
+# Build
+npm run build
+
+# Link globally for testing
+npm link
+```
+
+## License
+
+MIT

package/bin/binder.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+require('../dist/cli.js');

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,119 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const init_1 = require("./commands/init");
+const pull_1 = require("./commands/pull");
+const context_1 = require("./commands/context");
+const status_1 = require("./commands/status");
+const logger_1 = require("./utils/logger");
+// Read version from package.json
+const packageJsonPath = path.join(__dirname, '../package.json');
+const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+const program = new commander_1.Command();
+program
+    .name('binder')
+    .description('Orchestrate Virtual Monoliths from distributed repositories')
+    .version(packageJson.version)
+    .option('-v, --verbose', 'Enable verbose output')
+    .hook('preAction', (thisCommand) => {
+    const opts = thisCommand.opts();
+    if (opts.verbose) {
+        (0, logger_1.setVerbose)(true);
+    }
+});
+program
+    .command('init')
+    .description('Create a new binder.yaml configuration file')
+    .action(async () => {
+    try {
+        await (0, init_1.initCommand)();
+    }
+    catch (error) {
+        console.error('Unexpected error while running "init" command:', error);
+        process.exitCode = 1;
+    }
+});
+program
+    .command('pull')
+    .description('Clone missing repositories and checkout configured branches')
+    .action(async () => {
+    try {
+        await (0, pull_1.pullCommand)();
+    }
+    catch (error) {
+        console.error('Unexpected error while running "pull" command:', error);
+        process.exitCode = 1;
+    }
+});
+// Helper to collect multiple --file options into an array
+function collect(value, previous) {
+    return previous.concat([value]);
+}
+program
+    .command('context')
+    .description('Generate CONTEXT_MAP.md for AI agents')
+    .option('--claude', 'Inject instructions into CLAUDE.md')
+    .option('--cursor', 'Inject instructions into .cursorrules')
+    .option('--roo', 'Inject instructions into .roo/rules.md')
+    .option('--agents', 'Inject instructions into agents.md')
+    .option('--file <path>', 'Inject into a custom file (can be used multiple times)', collect, [])
+    .action(async (options) => {
+    try {
+        await (0, context_1.contextCommand)(options);
+    }
+    catch (error) {
+        console.error('Unexpected error while running "context" command:', error);
+        process.exitCode = 1;
+    }
+});
+program
+    .command('status')
+    .description('Show workspace status (repos, branches, dirty state)')
+    .action(async () => {
+    try {
+        await (0, status_1.statusCommand)();
+    }
+    catch (error) {
+        console.error('Unexpected error while running "status" command:', error);
+        process.exitCode = 1;
+    }
+});
+// Parse arguments
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/commands/context.d.ts

@@ -0,0 +1,12 @@
+export interface ContextCommandOptions {
+    claude?: boolean;
+    cursor?: boolean;
+    roo?: boolean;
+    agents?: boolean;
+    file?: string[];
+}
+/**
+ * Generate CONTEXT_MAP.md from binder.yaml
+ */
+export declare function contextCommand(options?: ContextCommandOptions): Promise<void>;
+//# sourceMappingURL=context.d.ts.map

package/dist/commands/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/commands/context.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CA4DvF"}

package/dist/commands/context.js

@@ -0,0 +1,105 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.contextCommand = contextCommand;
+const path = __importStar(require("path"));
+const parser_1 = require("../core/config/parser");
+const context_map_1 = require("../core/generator/context-map");
+const rule_injector_1 = require("../core/generator/rule-injector");
+const filesystem_1 = require("../utils/filesystem");
+const logger_1 = require("../utils/logger");
+const CONTEXT_MAP_FILENAME = 'CONTEXT_MAP.md';
+/**
+ * Generate CONTEXT_MAP.md from binder.yaml
+ */
+async function contextCommand(options = {}) {
+    // Load configuration
+    let config;
+    try {
+        config = await (0, parser_1.loadConfig)();
+    }
+    catch (err) {
+        if (err instanceof parser_1.ConfigError) {
+            (0, logger_1.error)(err.message);
+            (0, logger_1.info)('Run `binder init` to create a configuration file.');
+        }
+        else {
+            (0, logger_1.error)('Failed to load configuration');
+        }
+        process.exit(1);
+    }
+    // Generate context map content
+    const content = (0, context_map_1.generateContextMap)(config);
+    // Write to file
+    const outputPath = path.join(process.cwd(), CONTEXT_MAP_FILENAME);
+    try {
+        await (0, filesystem_1.writeFile)(outputPath, content);
+        (0, logger_1.success)(`Generated ${CONTEXT_MAP_FILENAME}`);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Unknown error';
+        (0, logger_1.error)(`Failed to write ${CONTEXT_MAP_FILENAME}: ${message}`);
+        process.exit(1);
+    }
+    // Check if any injection flags were provided
+    const hasInjectionFlags = options.claude ||
+        options.cursor ||
+        options.roo ||
+        options.agents ||
+        (options.file && options.file.length > 0);
+    if (hasInjectionFlags) {
+        (0, logger_1.newline)();
+        (0, logger_1.info)('Injecting Binder instructions into AI rule files...');
+        (0, logger_1.newline)();
+        const targets = {
+            claude: options.claude,
+            cursor: options.cursor,
+            roo: options.roo,
+            agents: options.agents,
+            file: options.file,
+        };
+        await (0, rule_injector_1.injectIntoRuleFiles)({
+            basePath: process.cwd(),
+            contextMapPath: CONTEXT_MAP_FILENAME,
+            targets,
+        });
+    }
+    else {
+        (0, logger_1.newline)();
+        (0, logger_1.info)('This file describes your workspace topology for AI agents.');
+        (0, logger_1.info)('Use --claude, --cursor, --roo, --agents, or --file to inject instructions.');
+    }
+}
+//# sourceMappingURL=context.js.map

package/dist/commands/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/commands/context.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoBA,wCA4DC;AAhFD,2CAA6B;AAC7B,kDAAgE;AAChE,+DAAmE;AACnE,mEAAwF;AACxF,oDAAgD;AAChD,4CAAgE;AAEhE,MAAM,oBAAoB,GAAG,gBAAgB,CAAC;AAU9C;;GAEG;AACI,KAAK,UAAU,cAAc,CAAC,UAAiC,EAAE;IACtE,qBAAqB;IACrB,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,IAAA,mBAAU,GAAE,CAAC;IAC9B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,oBAAW,EAAE,CAAC;YAC/B,IAAA,cAAK,EAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACnB,IAAA,aAAI,EAAC,mDAAmD,CAAC,CAAC;QAC5D,CAAC;aAAM,CAAC;YACN,IAAA,cAAK,EAAC,8BAA8B,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,+BAA+B;IAC/B,MAAM,OAAO,GAAG,IAAA,gCAAkB,EAAC,MAAM,CAAC,CAAC;IAE3C,gBAAgB;IAChB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,oBAAoB,CAAC,CAAC;IAClE,IAAI,CAAC;QACH,MAAM,IAAA,sBAAS,EAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACrC,IAAA,gBAAO,EAAC,aAAa,oBAAoB,EAAE,CAAC,CAAC;IAC/C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QACrE,IAAA,cAAK,EAAC,mBAAmB,oBAAoB,KAAK,OAAO,EAAE,CAAC,CAAC;QAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,6CAA6C;IAC7C,MAAM,iBAAiB,GACrB,OAAO,CAAC,MAAM;QACd,OAAO,CAAC,MAAM;QACd,OAAO,CAAC,GAAG;QACX,OAAO,CAAC,MAAM;QACd,CAAC,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAE5C,IAAI,iBAAiB,EAAE,CAAC;QACtB,IAAA,gBAAO,GAAE,CAAC;QACV,IAAA,aAAI,EAAC,qDAAqD,CAAC,CAAC;QAC5D,IAAA,gBAAO,GAAE,CAAC;QAEV,MAAM,OAAO,GAAqB;YAChC,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,IAAI,EAAE,OAAO,CAAC,IAAI;SACnB,CAAC;QAEF,MAAM,IAAA,mCAAmB,EAAC;YACxB,QAAQ,EAAE,OAAO,CAAC,GAAG,EAAE;YACvB,cAAc,EAAE,oBAAoB;YACpC,OAAO;SACR,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,IAAA,gBAAO,GAAE,CAAC;QACV,IAAA,aAAI,EAAC,4DAA4D,CAAC,CAAC;QACnE,IAAA,aAAI,EAAC,4EAA4E,CAAC,CAAC;IACrF,CAAC;AACH,CAAC"}

package/dist/commands/init.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Initialize a new binder.yaml configuration file
+ */
+export declare function initCommand(): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAoCjD"}

package/dist/commands/init.js

@@ -0,0 +1,119 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initCommand = initCommand;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs-extra"));
+const logger_1 = require("../utils/logger");
+const CONFIG_FILENAME = 'binder.yaml';
+/**
+ * Initialize a new binder.yaml configuration file
+ */
+async function initCommand() {
+    const configPath = path.join(process.cwd(), CONFIG_FILENAME);
+    // Check if config already exists
+    if (await fs.pathExists(configPath)) {
+        (0, logger_1.warning)(`${CONFIG_FILENAME} already exists in this directory.`);
+        (0, logger_1.info)('Edit the existing file or delete it to start fresh.');
+        return;
+    }
+    // Read the template
+    const templatePath = path.join(__dirname, '../../templates/binder.yaml.template');
+    let template;
+    try {
+        template = await fs.readFile(templatePath, 'utf-8');
+    }
+    catch {
+        // Fallback if template file is not found (e.g., in development)
+        template = getDefaultTemplate();
+    }
+    // Write the config file
+    try {
+        await fs.writeFile(configPath, template, 'utf-8');
+        (0, logger_1.success)(`Created ${CONFIG_FILENAME}`);
+        (0, logger_1.info)('');
+        (0, logger_1.info)('Next steps:');
+        (0, logger_1.info)('  1. Edit binder.yaml to add your repositories');
+        (0, logger_1.info)('  2. Run `binder pull` to clone/checkout repositories');
+        (0, logger_1.info)('  3. Run `binder context` to generate CONTEXT_MAP.md');
+        (0, logger_1.info)('  4. Run `binder status` to see workspace state');
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Unknown error';
+        (0, logger_1.error)(`Failed to create ${CONFIG_FILENAME}: ${message}`);
+        process.exit(1);
+    }
+}
+/**
+ * Default template content (fallback)
+ */
+function getDefaultTemplate() {
+    return `# ============================================================================
+# Binder Configuration
+# ============================================================================
+# This file defines your workspace topology and repository scopes.
+# Run 'binder pull' to clone/checkout repositories.
+# Run 'binder context' to generate CONTEXT_MAP.md for AI agents.
+# Run 'binder status' to see workspace state.
+# ============================================================================
+
+# Workspace name (used in CONTEXT_MAP.md header)
+name: my-workspace
+
+# Repository definitions
+repos:
+  # OWNER SCOPE - Full Authority
+  - name: my-service
+    url: git@github.com:org/my-service.git
+    scope: owner
+    # path: ./services/my-service   # Optional: local path
+    # branch: main                  # Optional: branch to checkout
+    # notes: "Core service"         # Optional: context for AI agents
+
+  # PLATFORM SCOPE - Restricted Contributor
+  # - name: shared-platform
+  #   url: https://github.com/org/platform.git
+  #   scope: platform
+  #   notes: "Shared infrastructure - minimal changes only"
+
+  # REFERENCE SCOPE - Read Only
+  # - name: legacy-api
+  #   url: git@github.com:org/legacy-api.git
+  #   scope: reference
+  #   depth: 1                      # Optional: shallow clone
+  #   notes: "Reference only - historical context"
+`;
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AASA,kCAoCC;AA7CD,2CAA6B;AAC7B,6CAA+B;AAC/B,4CAAgE;AAEhE,MAAM,eAAe,GAAG,aAAa,CAAC;AAEtC;;GAEG;AACI,KAAK,UAAU,WAAW;IAC/B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,eAAe,CAAC,CAAC;IAE7D,iCAAiC;IACjC,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACpC,IAAA,gBAAO,EAAC,GAAG,eAAe,oCAAoC,CAAC,CAAC;QAChE,IAAA,aAAI,EAAC,qDAAqD,CAAC,CAAC;QAC5D,OAAO;IACT,CAAC;IAED,oBAAoB;IACpB,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,sCAAsC,CAAC,CAAC;IAClF,IAAI,QAAgB,CAAC;IAErB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,gEAAgE;QAChE,QAAQ,GAAG,kBAAkB,EAAE,CAAC;IAClC,CAAC;IAED,wBAAwB;IACxB,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;QAClD,IAAA,gBAAO,EAAC,WAAW,eAAe,EAAE,CAAC,CAAC;QACtC,IAAA,aAAI,EAAC,EAAE,CAAC,CAAC;QACT,IAAA,aAAI,EAAC,aAAa,CAAC,CAAC;QACpB,IAAA,aAAI,EAAC,gDAAgD,CAAC,CAAC;QACvD,IAAA,aAAI,EAAC,uDAAuD,CAAC,CAAC;QAC9D,IAAA,aAAI,EAAC,sDAAsD,CAAC,CAAC;QAC7D,IAAA,aAAI,EAAC,iDAAiD,CAAC,CAAC;IAC1D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QACrE,IAAA,cAAK,EAAC,oBAAoB,eAAe,KAAK,OAAO,EAAE,CAAC,CAAC;QACzD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,kBAAkB;IACzB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkCR,CAAC;AACF,CAAC"}

package/dist/commands/pull.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Pull (clone/checkout) repositories according to binder.yaml
+ */
+export declare function pullCommand(): Promise<void>;
+//# sourceMappingURL=pull.d.ts.map

package/dist/commands/pull.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pull.d.ts","sourceRoot":"","sources":["../../src/commands/pull.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAsCjD"}

package/dist/commands/pull.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pullCommand = pullCommand;
+const parser_1 = require("../core/config/parser");
+const orchestrator_1 = require("../core/workspace/orchestrator");
+const logger_1 = require("../utils/logger");
+/**
+ * Pull (clone/checkout) repositories according to binder.yaml
+ */
+async function pullCommand() {
+    // Load configuration
+    let config;
+    try {
+        config = await (0, parser_1.loadConfig)();
+    }
+    catch (err) {
+        if (err instanceof parser_1.ConfigError) {
+            (0, logger_1.error)(err.message);
+            (0, logger_1.info)('Run `binder init` to create a configuration file.');
+        }
+        else {
+            (0, logger_1.error)('Failed to load configuration');
+        }
+        process.exit(1);
+    }
+    (0, logger_1.header)(`Pulling repositories for "${config.name}"`);
+    // Orchestrate repositories
+    const result = await (0, orchestrator_1.orchestrate)(config);
+    // Summary
+    (0, logger_1.newline)();
+    if (result.success) {
+        (0, logger_1.success)('Orchestration complete!');
+    }
+    else {
+        (0, logger_1.error)('Orchestration completed with errors.');
+    }
+    (0, logger_1.info)(`  Cloned: ${result.cloned}`);
+    (0, logger_1.info)(`  Checked out: ${result.checkedOut}`);
+    (0, logger_1.info)(`  Up to date: ${result.skipped}`);
+    if (result.errors > 0) {
+        (0, logger_1.info)(`  Errors: ${result.errors}`);
+    }
+    if (!result.success) {
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=pull.js.map

package/dist/commands/pull.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pull.js","sourceRoot":"","sources":["../../src/commands/pull.ts"],"names":[],"mappings":";;AAOA,kCAsCC;AA7CD,kDAAgE;AAChE,iEAA6D;AAC7D,4CAAwE;AAExE;;GAEG;AACI,KAAK,UAAU,WAAW;IAC/B,qBAAqB;IACrB,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,IAAA,mBAAU,GAAE,CAAC;IAC9B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,oBAAW,EAAE,CAAC;YAC/B,IAAA,cAAK,EAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACnB,IAAA,aAAI,EAAC,mDAAmD,CAAC,CAAC;QAC5D,CAAC;aAAM,CAAC;YACN,IAAA,cAAK,EAAC,8BAA8B,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAA,eAAM,EAAC,6BAA6B,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC;IAEpD,2BAA2B;IAC3B,MAAM,MAAM,GAAG,MAAM,IAAA,0BAAW,EAAC,MAAM,CAAC,CAAC;IAEzC,UAAU;IACV,IAAA,gBAAO,GAAE,CAAC;IACV,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,IAAA,gBAAO,EAAC,yBAAyB,CAAC,CAAC;IACrC,CAAC;SAAM,CAAC;QACN,IAAA,cAAK,EAAC,sCAAsC,CAAC,CAAC;IAChD,CAAC;IAED,IAAA,aAAI,EAAC,aAAa,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACnC,IAAA,aAAI,EAAC,kBAAkB,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IAC5C,IAAA,aAAI,EAAC,iBAAiB,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IACxC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,IAAA,aAAI,EAAC,aAAa,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/commands/status.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Display workspace status
+ */
+export declare function statusCommand(): Promise<void>;
+//# sourceMappingURL=status.d.ts.map

package/dist/commands/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAgDA;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAsEnD"}