binder-cli 1.1.0

package/dist/utils/filesystem.js

@@ -0,0 +1,152 @@
+"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.resolvePath = resolvePath;
+exports.exists = exists;
+exports.isDirectory = isDirectory;
+exports.isGitRepository = isGitRepository;
+exports.ensureDir = ensureDir;
+exports.writeFile = writeFile;
+exports.readFile = readFile;
+exports.removeDir = removeDir;
+exports.listDirectories = listDirectories;
+exports.getDefaultRepoPath = getDefaultRepoPath;
+const fs = __importStar(require("fs-extra"));
+const path = __importStar(require("path"));
+const errors_1 = require("./errors");
+/**
+ * Resolve a path relative to the current working directory
+ * Handles both absolute and relative paths
+ */
+function resolvePath(inputPath, basePath) {
+    const base = basePath ?? process.cwd();
+    if (path.isAbsolute(inputPath)) {
+        return inputPath;
+    }
+    return path.resolve(base, inputPath);
+}
+/**
+ * Check if a path exists
+ */
+async function exists(targetPath) {
+    return fs.pathExists(targetPath);
+}
+/**
+ * Check if a path is a directory
+ */
+async function isDirectory(targetPath) {
+    try {
+        const stat = await fs.stat(targetPath);
+        return stat.isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if a path is a git repository (contains .git directory)
+ */
+async function isGitRepository(targetPath) {
+    const gitDir = path.join(targetPath, '.git');
+    return isDirectory(gitDir);
+}
+/**
+ * Ensure a directory exists, creating it if necessary
+ */
+async function ensureDir(dirPath) {
+    try {
+        await fs.ensureDir(dirPath);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        throw new errors_1.FileSystemError(`Failed to create directory: ${message}`, dirPath);
+    }
+}
+/**
+ * Write content to a file, creating directories if needed
+ */
+async function writeFile(filePath, content) {
+    try {
+        await fs.ensureDir(path.dirname(filePath));
+        await fs.writeFile(filePath, content, 'utf-8');
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        throw new errors_1.FileSystemError(`Failed to write file: ${message}`, filePath);
+    }
+}
+/**
+ * Read a file's content
+ */
+async function readFile(filePath) {
+    try {
+        return await fs.readFile(filePath, 'utf-8');
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        throw new errors_1.FileSystemError(`Failed to read file: ${message}`, filePath);
+    }
+}
+/**
+ * Remove a directory and its contents
+ */
+async function removeDir(dirPath) {
+    try {
+        await fs.remove(dirPath);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        throw new errors_1.FileSystemError(`Failed to remove directory: ${message}`, dirPath);
+    }
+}
+/**
+ * List directories in a path
+ */
+async function listDirectories(dirPath) {
+    try {
+        const entries = await fs.readdir(dirPath, { withFileTypes: true });
+        return entries.filter((entry) => entry.isDirectory()).map((entry) => entry.name);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Get the default repository path based on repo name
+ */
+function getDefaultRepoPath(repoName) {
+    return `./repos/${repoName}`;
+}
+//# sourceMappingURL=filesystem.js.map

package/dist/utils/filesystem.js.map

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

package/dist/utils/logger.d.ts

@@ -0,0 +1,59 @@
+import type { Ora } from 'ora';
+export interface Logger {
+    info(message: string): void;
+    success(message: string): void;
+    warning(message: string): void;
+    error(message: string): void;
+    debug(message: string): void;
+    spinner(message: string): Ora;
+}
+/**
+ * Enable or disable verbose/debug logging
+ */
+export declare function setVerbose(enabled: boolean): void;
+/**
+ * Check if verbose mode is enabled
+ */
+export declare function isVerbose(): boolean;
+/**
+ * Log an info message
+ */
+export declare function info(message: string): void;
+/**
+ * Log a success message
+ */
+export declare function success(message: string): void;
+/**
+ * Log a warning message
+ */
+export declare function warning(message: string): void;
+/**
+ * Log an error message
+ */
+export declare function error(message: string): void;
+/**
+ * Log a debug message (only in verbose mode)
+ */
+export declare function debug(message: string): void;
+/**
+ * Create a spinner for long-running operations
+ */
+export declare function spinner(message: string): Ora;
+/**
+ * Log a blank line
+ */
+export declare function newline(): void;
+/**
+ * Log a header/title
+ */
+export declare function header(title: string): void;
+/**
+ * Log a list item
+ */
+export declare function listItem(text: string, indent?: number): void;
+/**
+ * Format a scope for display
+ */
+export declare function formatScope(scope: 'owner' | 'platform' | 'reference'): string;
+export declare const logger: Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAE/B,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC;CAC/B;AAID;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEjD;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE3C;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAI3C;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAK5C;AAED;;GAEG;AACH,wBAAgB,OAAO,IAAI,IAAI,CAE9B;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAI1C;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,SAAI,GAAG,IAAI,CAGvD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,GAAG,WAAW,GAAG,MAAM,CAS7E;AAGD,eAAO,MAAM,MAAM,EAAE,MAOpB,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,118 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = void 0;
+exports.setVerbose = setVerbose;
+exports.isVerbose = isVerbose;
+exports.info = info;
+exports.success = success;
+exports.warning = warning;
+exports.error = error;
+exports.debug = debug;
+exports.spinner = spinner;
+exports.newline = newline;
+exports.header = header;
+exports.listItem = listItem;
+exports.formatScope = formatScope;
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+let verboseMode = false;
+/**
+ * Enable or disable verbose/debug logging
+ */
+function setVerbose(enabled) {
+    verboseMode = enabled;
+}
+/**
+ * Check if verbose mode is enabled
+ */
+function isVerbose() {
+    return verboseMode;
+}
+/**
+ * Log an info message
+ */
+function info(message) {
+    console.log(chalk_1.default.blue('info'), message);
+}
+/**
+ * Log a success message
+ */
+function success(message) {
+    console.log(chalk_1.default.green('✓'), message);
+}
+/**
+ * Log a warning message
+ */
+function warning(message) {
+    console.log(chalk_1.default.yellow('⚠'), message);
+}
+/**
+ * Log an error message
+ */
+function error(message) {
+    console.error(chalk_1.default.red('✗'), message);
+}
+/**
+ * Log a debug message (only in verbose mode)
+ */
+function debug(message) {
+    if (verboseMode) {
+        console.log(chalk_1.default.gray('debug'), message);
+    }
+}
+/**
+ * Create a spinner for long-running operations
+ */
+function spinner(message) {
+    return (0, ora_1.default)({
+        text: message,
+        color: 'cyan',
+    });
+}
+/**
+ * Log a blank line
+ */
+function newline() {
+    console.log();
+}
+/**
+ * Log a header/title
+ */
+function header(title) {
+    console.log();
+    console.log(chalk_1.default.bold.underline(title));
+    console.log();
+}
+/**
+ * Log a list item
+ */
+function listItem(text, indent = 0) {
+    const padding = '  '.repeat(indent);
+    console.log(`${padding}${chalk_1.default.dim('•')} ${text}`);
+}
+/**
+ * Format a scope for display
+ */
+function formatScope(scope) {
+    switch (scope) {
+        case 'owner':
+            return chalk_1.default.green('owner');
+        case 'platform':
+            return chalk_1.default.yellow('platform');
+        case 'reference':
+            return chalk_1.default.red('reference');
+    }
+}
+// Export a logger object for convenience
+exports.logger = {
+    info,
+    success,
+    warning,
+    error,
+    debug,
+    spinner,
+};
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":";;;;;;AAkBA,gCAEC;AAKD,8BAEC;AAKD,oBAEC;AAKD,0BAEC;AAKD,0BAEC;AAKD,sBAEC;AAKD,sBAIC;AAKD,0BAKC;AAKD,0BAEC;AAKD,wBAIC;AAKD,4BAGC;AAKD,kCASC;AAhHD,kDAA0B;AAC1B,8CAAsB;AAYtB,IAAI,WAAW,GAAG,KAAK,CAAC;AAExB;;GAEG;AACH,SAAgB,UAAU,CAAC,OAAgB;IACzC,WAAW,GAAG,OAAO,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,SAAgB,SAAS;IACvB,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,SAAgB,IAAI,CAAC,OAAe;IAClC,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,SAAgB,OAAO,CAAC,OAAe;IACrC,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,SAAgB,OAAO,CAAC,OAAe;IACrC,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,SAAgB,KAAK,CAAC,OAAe;IACnC,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,SAAgB,KAAK,CAAC,OAAe;IACnC,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,OAAO,CAAC,OAAe;IACrC,OAAO,IAAA,aAAG,EAAC;QACT,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,MAAM;KACd,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,SAAgB,OAAO;IACrB,OAAO,CAAC,GAAG,EAAE,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAgB,MAAM,CAAC,KAAa;IAClC,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IACzC,OAAO,CAAC,GAAG,EAAE,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAgB,QAAQ,CAAC,IAAY,EAAE,MAAM,GAAG,CAAC;IAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACpC,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,GAAG,eAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,SAAgB,WAAW,CAAC,KAAyC;IACnE,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,OAAO;YACV,OAAO,eAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC9B,KAAK,UAAU;YACb,OAAO,eAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAClC,KAAK,WAAW;YACd,OAAO,eAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAClC,CAAC;AACH,CAAC;AAED,yCAAyC;AAC5B,QAAA,MAAM,GAAW;IAC5B,IAAI;IACJ,OAAO;IACP,OAAO;IACP,KAAK;IACL,KAAK;IACL,OAAO;CACR,CAAC"}

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "binder-cli",
+  "version": "1.1.0",
+  "description": "Orchestrate Virtual Monoliths from distributed repositories and define semantic boundaries for AI agents",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "binder": "./bin/binder.js"
+  },
+  "files": [
+    "dist/",
+    "bin/",
+    "templates/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "ts-node src/cli.ts",
+    "binder": "node dist/cli.js",
+    "package": "npm run build && npm pack",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "lint": "eslint src --ext .ts && prettier --check \"src/**/*.ts\" \"tests/**/*.ts\"",
+    "lint:fix": "eslint src --ext .ts --fix && prettier --write \"src/**/*.ts\" \"tests/**/*.ts\"",
+    "clean": "rimraf dist",
+    "prepublishOnly": "npm run clean && npm run build && npm test",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "cli",
+    "git",
+    "workspace",
+    "monorepo",
+    "ai",
+    "orchestration",
+    "virtual-monolith"
+  ],
+  "author": "Corrjo",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/corrjo/binder.git"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "commander": "^12.1.0",
+    "yaml": "^2.6.1",
+    "zod": "^3.24.1",
+    "simple-git": "^3.27.0",
+    "chalk": "^4.1.2",
+    "ora": "^5.4.1",
+    "fs-extra": "^11.2.0"
+  },
+  "devDependencies": {
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "semantic-release": "^24.2.0",
+    "@types/node": "^22.10.2",
+    "@types/fs-extra": "^11.0.4",
+    "@types/jest": "^29.5.14",
+    "@typescript-eslint/eslint-plugin": "^8.18.2",
+    "@typescript-eslint/parser": "^8.18.2",
+    "eslint": "^8.57.1",
+    "jest": "^29.7.0",
+    "prettier": "^3.4.2",
+    "rimraf": "^6.0.1",
+    "ts-jest": "^29.2.5",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.7.2"
+  }
+}

package/templates/binder.yaml.template

@@ -0,0 +1,52 @@
+# ============================================================================
+# 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
+# Each repo defines a git repository and its scope in this workspace
+repos:
+  # --------------------------------------------------------------------------
+  # OWNER SCOPE - Full Authority
+  # --------------------------------------------------------------------------
+  # Repositories you own and have full control over.
+  # AI agents can read, write, refactor, and restructure freely.
+  #
+  - name: my-service
+    url: git@github.com:org/my-service.git
+    # path: ./services/my-service   # Optional: local path (defaults to ./repos/{name})
+    scope: owner
+    # branch: main                  # Optional: branch to checkout
+    # notes: "Core service"         # Optional: context for AI agents
+
+  # --------------------------------------------------------------------------
+  # PLATFORM SCOPE - Restricted Contributor
+  # --------------------------------------------------------------------------
+  # Repositories where you are a guest contributor.
+  # AI agents should only make minimal changes when necessary to support
+  # the owner scope. Must follow existing patterns strictly.
+  #
+  # - name: shared-platform
+  #   url: https://github.com/org/platform.git
+  #   scope: platform
+  #   notes: "Shared infrastructure - minimal changes only"
+
+  # --------------------------------------------------------------------------
+  # REFERENCE SCOPE - Read Only
+  # --------------------------------------------------------------------------
+  # Repositories used for reference and validation only.
+  # AI agents must NOT suggest modifications to these repos.
+  # Useful for documentation, legacy code, or external dependencies.
+  #
+  # - name: legacy-api
+  #   url: git@github.com:org/legacy-api.git
+  #   scope: reference
+  #   depth: 1                      # Optional: shallow clone
+  #   notes: "Reference only - historical context"