@braingrid/cli 0.0.5 → 0.0.7

package/dist/utils/local-store.js

@@ -0,0 +1,82 @@
+/**
+ * Local Project Store
+ * Handles reading/writing .braingrid/project.json
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { LocalProjectConfigSchema } from '../types/local-project.js';
+const BRAINGRID_DIR = '.braingrid';
+const PROJECT_CONFIG_FILE = 'project.json';
+/**
+ * Get the path to the .braingrid directory
+ */
+export function getBraingridDir(cwd = process.cwd()) {
+    return path.join(cwd, BRAINGRID_DIR);
+}
+/**
+ * Get the path to the project.json file
+ */
+export function getProjectConfigPath(cwd = process.cwd()) {
+    return path.join(getBraingridDir(cwd), PROJECT_CONFIG_FILE);
+}
+/**
+ * Check if .braingrid/project.json exists
+ */
+export function projectConfigExists(cwd = process.cwd()) {
+    return fs.existsSync(getProjectConfigPath(cwd));
+}
+/**
+ * Ensure .braingrid directory exists
+ */
+function ensureBraingridDir(cwd = process.cwd()) {
+    const dir = getBraingridDir(cwd);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+}
+/**
+ * Load project configuration from .braingrid/project.json
+ * @throws Error if file doesn't exist or is invalid
+ */
+export function loadProjectConfig(cwd = process.cwd()) {
+    const configPath = getProjectConfigPath(cwd);
+    if (!fs.existsSync(configPath)) {
+        throw new Error(`Project not initialized. Run 'braingrid init' to initialize this repository.`);
+    }
+    const content = fs.readFileSync(configPath, 'utf8');
+    const data = JSON.parse(content);
+    // Validate with Zod schema
+    return LocalProjectConfigSchema.parse(data);
+}
+/**
+ * Save project configuration to .braingrid/project.json
+ */
+export function saveProjectConfig(config, cwd = process.cwd()) {
+    ensureBraingridDir(cwd);
+    const configPath = getProjectConfigPath(cwd);
+    const content = JSON.stringify(config, null, 2);
+    fs.writeFileSync(configPath, content, 'utf8');
+}
+/**
+ * Delete .braingrid/project.json
+ */
+export function deleteProjectConfig(cwd = process.cwd()) {
+    const configPath = getProjectConfigPath(cwd);
+    if (fs.existsSync(configPath)) {
+        fs.unlinkSync(configPath);
+    }
+}
+/**
+ * Get the local project ID from .braingrid/project.json
+ * Returns the short_id (e.g., PROJ-123) if project.json exists, null otherwise
+ */
+export function getLocalProjectId(cwd = process.cwd()) {
+    try {
+        const config = loadProjectConfig(cwd);
+        return config.project_short_id;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=local-store.js.map

package/dist/utils/local-store.js.map

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

package/dist/utils/package-manager.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Package Manager Detection Utility
+ *
+ * Detects which package manager (npm, pnpm, yarn) was used to install the CLI
+ * by checking global installation directories.
+ */
+export type PackageManager = 'npm' | 'pnpm' | 'yarn';
+interface PackageManagerInfo {
+    name: PackageManager;
+    installed: boolean;
+    hasPackage: boolean;
+}
+/**
+ * Get information about available package managers and whether they have the CLI installed
+ */
+export declare function getPackageManagerInfo(packageName: string): Promise<PackageManagerInfo[]>;
+/**
+ * Detect which package manager was used to install the CLI
+ * Returns the detected package manager or prompts the user if detection fails
+ */
+export declare function detectPackageManager(packageName: string): Promise<PackageManager>;
+/**
+ * Get the update command for a specific package manager
+ */
+export declare function getUpdateCommand(pm: PackageManager, packageName: string): string;
+/**
+ * Execute the update command
+ */
+export declare function executeUpdate(pm: PackageManager, packageName: string): void;
+export {};
+//# sourceMappingURL=package-manager.d.ts.map

package/dist/utils/package-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-manager.d.ts","sourceRoot":"","sources":["../../src/utils/package-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAErD,UAAU,kBAAkB;IAC3B,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;CACpB;AAyDD;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAW9F;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CA+BvF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAYhF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAa3E"}

package/dist/utils/package-manager.js

@@ -0,0 +1,133 @@
+/**
+ * Package Manager Detection Utility
+ *
+ * Detects which package manager (npm, pnpm, yarn) was used to install the CLI
+ * by checking global installation directories.
+ */
+import { execSync } from 'child_process';
+import { select } from '@inquirer/prompts';
+/**
+ * Check if a package manager is installed on the system
+ */
+function isPackageManagerInstalled(pm) {
+    try {
+        execSync(`which ${pm}`, { stdio: 'ignore', timeout: 2000 });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if the CLI package is installed globally with a specific package manager
+ */
+function checkGlobalInstallation(pm, packageName) {
+    try {
+        let command;
+        switch (pm) {
+            case 'npm': {
+                command = `npm list -g ${packageName} 2>&1`;
+                break;
+            }
+            case 'pnpm': {
+                command = `pnpm list -g ${packageName} 2>&1`;
+                break;
+            }
+            case 'yarn': {
+                command = `yarn global list 2>&1`;
+                break;
+            }
+        }
+        const output = execSync(command, {
+            encoding: 'utf-8',
+            timeout: 5000,
+        });
+        // For npm and pnpm, check if output contains the package name and not "(empty)"
+        if (pm === 'npm' || pm === 'pnpm') {
+            return output.includes(packageName) && !output.includes('(empty)');
+        }
+        // For yarn, check if package is in the list
+        if (pm === 'yarn') {
+            return output.includes(packageName);
+        }
+        return false;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get information about available package managers and whether they have the CLI installed
+ */
+export async function getPackageManagerInfo(packageName) {
+    const packageManagers = ['npm', 'pnpm', 'yarn'];
+    return packageManagers.map(pm => {
+        const installed = isPackageManagerInstalled(pm);
+        return {
+            name: pm,
+            installed,
+            hasPackage: installed ? checkGlobalInstallation(pm, packageName) : false,
+        };
+    });
+}
+/**
+ * Detect which package manager was used to install the CLI
+ * Returns the detected package manager or prompts the user if detection fails
+ */
+export async function detectPackageManager(packageName) {
+    const pmInfo = await getPackageManagerInfo(packageName);
+    // First, check if any package manager has the package installed
+    const installedWith = pmInfo.find(pm => pm.hasPackage);
+    if (installedWith) {
+        return installedWith.name;
+    }
+    // If detection failed, check which package managers are available and prompt
+    const availablePMs = pmInfo.filter(pm => pm.installed);
+    if (availablePMs.length === 0) {
+        throw new Error('No package manager found. Please install npm, pnpm, or yarn.');
+    }
+    if (availablePMs.length === 1) {
+        return availablePMs[0].name;
+    }
+    // Multiple package managers available, prompt user
+    const selected = await select({
+        message: 'Unable to detect which package manager was used. Please select one:',
+        choices: availablePMs.map(pm => ({
+            name: pm.name,
+            value: pm.name,
+        })),
+    });
+    return selected;
+}
+/**
+ * Get the update command for a specific package manager
+ */
+export function getUpdateCommand(pm, packageName) {
+    switch (pm) {
+        case 'npm': {
+            return `npm install -g ${packageName}@latest`;
+        }
+        case 'pnpm': {
+            return `pnpm add -g ${packageName}@latest`;
+        }
+        case 'yarn': {
+            return `yarn global add ${packageName}@latest`;
+        }
+    }
+}
+/**
+ * Execute the update command
+ */
+export function executeUpdate(pm, packageName) {
+    const command = getUpdateCommand(pm, packageName);
+    try {
+        execSync(command, {
+            stdio: 'inherit',
+            timeout: 120000, // 2 minutes timeout
+        });
+    }
+    catch (error) {
+        throw new Error(`Failed to update package: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+//# sourceMappingURL=package-manager.js.map

package/dist/utils/package-manager.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@braingrid/cli",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "description": "BrainGrid - Turn thoughts into AI-ready specs. Command-line interface for spec-driven development.",
   "type": "module",
   "main": "dist/cli.js",
@@ -33,12 +33,14 @@
     "CHANGELOG.md"
   ],
   "dependencies": {
+    "@inquirer/prompts": "^7.8.6",
     "axios": "^1.10.0",
     "chalk": "^5.3.0",
     "commander": "^12.0.0",
     "conf": "13.0.1",
     "node-machine-id": "1.1.12",
-    "open": "^10.1.0"
+    "open": "^10.1.0",
+    "zod": "^4.1.11"
   },
   "devDependencies": {
     "@types/node": "^20.19.1",
@@ -88,6 +90,7 @@
     "test:cli:verbose": "bash scripts/test-cli.sh --verbose",
     "validate:fix": "pnpm lint:fix && pnpm format && pnpm type-check",
     "docs:fetch-openapi": "gh api repos/BrainGridAI/braingrid-app/contents/src/app/api/v1/openapi.yaml | jq -r '.content' | base64 -D > docs/openapi.yaml",
+    "docs:sync": "bash scripts/sync-docs-to-braingrid.sh",
     "preversion": "pnpm validate:fix && pnpm test:all",
     "release:patch": "npm version patch && git push && git push --tags",
     "release:minor": "npm version minor && git push && git push --tags",