@bernierllc/braingrid-cli-wrapper 0.1.1 → 0.3.0

package/CHANGELOG.md

@@ -0,0 +1,35 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+# 0.3.0 (2025-12-25)
+
+
+### Bug Fixes
+
+* **ci:** add lerna version step before publish ([3d20300](https://github.com/bernier-llc/tools/commit/3d203002143bf353fffafe4f8a78a99009567347))
+* **jest:** move global options to root config and fix typos ([c14710c](https://github.com/bernier-llc/tools/commit/c14710c11e8fc34dd7f773edf01328151564323a))
+* update neverhub-adapter deps to workspace:* and publish 0.1.2 ([f0e3d04](https://github.com/bernier-llc/tools/commit/f0e3d04d8d4f094e3bb899ddf81e93243d16e2c2))
+
+
+### Features
+
+* add 4 more core/integration packages ([dd05b81](https://github.com/bernier-llc/tools/commit/dd05b816c94adcbd99556afbd9e316146654f44c))
+
+
+
+
+
+# 0.2.0 (2025-12-25)
+
+
+### Bug Fixes
+
+* **jest:** move global options to root config and fix typos ([c14710c](https://github.com/bernier-llc/tools/commit/c14710c11e8fc34dd7f773edf01328151564323a))
+* update neverhub-adapter deps to workspace:* and publish 0.1.2 ([f0e3d04](https://github.com/bernier-llc/tools/commit/f0e3d04d8d4f094e3bb899ddf81e93243d16e2c2))
+
+
+### Features
+
+* add 4 more core/integration packages ([dd05b81](https://github.com/bernier-llc/tools/commit/dd05b816c94adcbd99556afbd9e316146654f44c))

package/README.md

@@ -23,22 +23,41 @@ npm install @bernierllc/braingrid-cli-wrapper
 ## Quick Start
 
 ```typescript
-import { createIdea, listProjects, createTask } from '@bernierllc/braingrid-cli-wrapper';
+import {
+  createIdea,
+  listProjects,
+  createProject,
+  listRequirements,
+  updateRequirementStatus,
+  createTask
+} from '@bernierllc/braingrid-cli-wrapper';
 
-// Create a new requirement (IDEA)
-const requirement = await createIdea('Add OAuth2 authentication', 'proj-123');
-console.log(`Created requirement ${requirement.id} with status ${requirement.status}`);
+// Create a new project
+const project = await createProject('My Project', 'Project description');
+console.log(`Created project ${project.id}`);
 
 // List all projects
 const projects = await listProjects();
 console.log(`Found ${projects.length} projects`);
 
+// Create a new requirement (IDEA)
+const requirement = await createIdea('Add OAuth2 authentication', project.id);
+console.log(`Created requirement ${requirement.id} with status ${requirement.status}`);
+
+// List requirements
+const requirements = await listRequirements(project.id);
+console.log(`Found ${requirements.length} requirements`);
+
+// Update requirement status
+await updateRequirementStatus(requirement.id, 'PLANNED');
+console.log(`Updated requirement to PLANNED status`);
+
 // Create a task under a requirement
-const task = await createTask('req-456', {
+const task = await createTask(requirement.id, {
   title: 'Build login UI',
   description: 'Create login form component',
   tags: ['DEV', 'frontend'],
-  dependencies: ['task-100']
+  dependencies: []
 });
 console.log(`Created task ${task.id}`);
 ```
@@ -89,6 +108,60 @@ const projects = await listProjects();
 // [{ id: 'proj-1', name: 'My Project', description: 'Project description' }]
 ```
 
+#### `createProject(name: string, description?: string): Promise<BrainGridProject>`
+
+Creates a new project in BrainGrid.
+
+**Input:**
+- `name` (string, required): Project name
+- `description` (string, optional): Project description
+
+**Output:**
+- Returns a `BrainGridProject` object
+
+**Example:**
+```typescript
+const project = await createProject('My Project', 'Project description');
+// { id: 'proj-123', name: 'My Project', description: 'Project description' }
+```
+
+#### `listRequirements(projectId?: string): Promise<BrainGridRequirement[]>`
+
+Lists requirements, optionally filtered by project.
+
+**Input:**
+- `projectId` (string, optional): Filter by project ID
+
+**Output:**
+- Returns an array of `BrainGridRequirement` objects
+
+**Example:**
+```typescript
+// List all requirements
+const allRequirements = await listRequirements();
+
+// List requirements for a specific project
+const projectRequirements = await listRequirements('proj-123');
+// [{ id: 'req-1', projectId: 'proj-123', title: 'Add auth', status: 'IDEA' }]
+```
+
+#### `updateRequirementStatus(requirementId: string, status: RequirementStatus): Promise<void>`
+
+Updates a requirement's status.
+
+**Input:**
+- `requirementId` (string, required): Requirement ID to update
+- `status` (RequirementStatus, required): New status (IDEA, PLANNED, IN_PROGRESS, COMPLETED, CANCELLED, PAUSED)
+
+**Output:** Promise that resolves when update is complete
+
+**Example:**
+```typescript
+await updateRequirementStatus('req-123', 'PLANNED');
+await updateRequirementStatus('req-123', 'IN_PROGRESS');
+await updateRequirementStatus('req-123', 'COMPLETED');
+```
+
 #### `createTask(reqId: string, options: CreateTaskOptions): Promise<BrainGridTask>`
 
 Creates a task under a requirement.
@@ -289,17 +362,26 @@ export BRAINGRID_CLI_PATH=/custom/path/braingrid
 
 ```typescript
 import {
+  createProject,
   listProjects,
   createIdea,
+  listRequirements,
+  updateRequirementStatus,
   createTask,
   listTasks,
   updateTaskStatus
 } from '@bernierllc/braingrid-cli-wrapper';
 
 async function workflow() {
-  // 1. List projects
+  // 1. Create or list projects
+  const project = await createProject(
+    'My Project',
+    'Authentication system project'
+  );
+
+  // Or list existing projects
   const projects = await listProjects();
-  const project = projects[0];
+  console.log(`Found ${projects.length} projects`);
 
   // 2. Create a requirement
   const requirement = await createIdea(
@@ -307,7 +389,13 @@ async function workflow() {
     project.id
   );
 
-  // 3. Create tasks
+  // 3. List and update requirements
+  const requirements = await listRequirements(project.id);
+  console.log(`Project has ${requirements.length} requirements`);
+
+  await updateRequirementStatus(requirement.id, 'PLANNED');
+
+  // 4. Create tasks
   const task1 = await createTask(requirement.id, {
     title: 'Design authentication flow',
     tags: ['DESIGN']
@@ -319,16 +407,19 @@ async function workflow() {
     dependencies: [task1.id]
   });
 
-  // 4. List tasks
+  // 5. List tasks
   const tasks = await listTasks({ reqId: requirement.id });
   console.log(`Created ${tasks.length} tasks`);
 
-  // 5. Update task status
+  // 6. Update task status
   await updateTaskStatus(task1.id, { status: 'COMPLETED' });
   await updateTaskStatus(task2.id, {
     status: 'IN_PROGRESS',
     assignedTo: 'user-123'
   });
+
+  // 7. Mark requirement as in progress
+  await updateRequirementStatus(requirement.id, 'IN_PROGRESS');
 }
 ```
 

package/dist/commands/createProject.d.ts

@@ -0,0 +1,8 @@
+import { BrainGridProject } from '../models';
+/**
+ * Creates a new BrainGrid project
+ * @param name - Project name (required)
+ * @param description - Project description (optional)
+ * @returns Promise resolving to the created project
+ */
+export declare function createProject(name: string, description?: string): Promise<BrainGridProject>;

package/dist/commands/createProject.js

@@ -0,0 +1,31 @@
+"use strict";
+/*
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.
+The client may use and modify this code *only within the scope of the project it was delivered for*.
+Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createProject = createProject;
+const cli_1 = require("../cli");
+const models_1 = require("../models");
+/**
+ * Creates a new BrainGrid project
+ * @param name - Project name (required)
+ * @param description - Project description (optional)
+ * @returns Promise resolving to the created project
+ */
+async function createProject(name, description) {
+    const args = ['project', 'create', '--name', name, '--format', 'json'];
+    if (description) {
+        args.push('--description', description);
+    }
+    const result = await (0, cli_1.runBrainGridCommand)(args);
+    // Validate response
+    const parsed = models_1.BrainGridProjectSchema.safeParse(result);
+    if (!parsed.success) {
+        throw new Error(`Invalid BrainGrid response: ${parsed.error.message}`);
+    }
+    return parsed.data;
+}

package/dist/commands/listRequirements.d.ts

@@ -0,0 +1,7 @@
+import { BrainGridRequirement } from '../models';
+/**
+ * Lists BrainGrid requirements
+ * @param projectId - Optional project ID to filter requirements
+ * @returns Promise resolving to array of requirements
+ */
+export declare function listRequirements(projectId?: string): Promise<BrainGridRequirement[]>;

package/dist/commands/listRequirements.js

@@ -0,0 +1,32 @@
+"use strict";
+/*
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.
+The client may use and modify this code *only within the scope of the project it was delivered for*.
+Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listRequirements = listRequirements;
+const cli_1 = require("../cli");
+const models_1 = require("../models");
+const zod_1 = require("zod");
+/**
+ * Lists BrainGrid requirements
+ * @param projectId - Optional project ID to filter requirements
+ * @returns Promise resolving to array of requirements
+ */
+async function listRequirements(projectId) {
+    const args = ['requirement', 'list', '--format', 'json'];
+    if (projectId) {
+        args.push('--project', projectId);
+    }
+    const result = await (0, cli_1.runBrainGridCommand)(args);
+    // Validate response
+    const schema = zod_1.z.array(models_1.BrainGridRequirementSchema);
+    const parsed = schema.safeParse(result);
+    if (!parsed.success) {
+        throw new Error(`Invalid BrainGrid response: ${parsed.error.message}`);
+    }
+    return parsed.data;
+}

package/dist/commands/updateRequirementStatus.d.ts

@@ -0,0 +1,8 @@
+import { RequirementStatus } from '../models';
+/**
+ * Updates a requirement's status
+ * @param requirementId - Requirement ID to update
+ * @param status - New status to set
+ * @returns Promise resolving when update is complete
+ */
+export declare function updateRequirementStatus(requirementId: string, status: RequirementStatus): Promise<void>;

package/dist/commands/updateRequirementStatus.js

@@ -0,0 +1,29 @@
+"use strict";
+/*
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.
+The client may use and modify this code *only within the scope of the project it was delivered for*.
+Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateRequirementStatus = updateRequirementStatus;
+const cli_1 = require("../cli");
+/**
+ * Updates a requirement's status
+ * @param requirementId - Requirement ID to update
+ * @param status - New status to set
+ * @returns Promise resolving when update is complete
+ */
+async function updateRequirementStatus(requirementId, status) {
+    const args = [
+        'requirement',
+        'update',
+        requirementId,
+        '--status',
+        status,
+        '--format',
+        'json'
+    ];
+    await (0, cli_1.runBrainGridCommand)(args);
+}

package/dist/index.d.ts

@@ -1,6 +1,9 @@
 export { BrainGridProject, BrainGridRequirement, BrainGridTask, RequirementStatus, TaskStatus, BrainGridProjectSchema, BrainGridRequirementSchema, BrainGridTaskSchema, BrainGridCliError } from './models';
 export { createIdea } from './commands/createIdea';
 export { listProjects } from './commands/listProjects';
+export { createProject } from './commands/createProject';
+export { listRequirements } from './commands/listRequirements';
+export { updateRequirementStatus } from './commands/updateRequirementStatus';
 export { createTask, CreateTaskOptions } from './commands/createTask';
 export { updateTaskStatus, UpdateTaskOptions } from './commands/updateTaskStatus';
 export { listTasks, ListTasksOptions } from './commands/listTasks';

package/dist/index.js

@@ -7,7 +7,7 @@ The client may use and modify this code *only within the scope of the project it
 Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
 */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.listTasks = exports.updateTaskStatus = exports.createTask = exports.listProjects = exports.createIdea = exports.BrainGridCliError = exports.BrainGridTaskSchema = exports.BrainGridRequirementSchema = exports.BrainGridProjectSchema = void 0;
+exports.listTasks = exports.updateTaskStatus = exports.createTask = exports.updateRequirementStatus = exports.listRequirements = exports.createProject = exports.listProjects = exports.createIdea = exports.BrainGridCliError = exports.BrainGridTaskSchema = exports.BrainGridRequirementSchema = exports.BrainGridProjectSchema = void 0;
 // BrainGrid CLI Wrapper - Type-safe wrapper for BrainGrid CLI
 // Export types and schemas
 var models_1 = require("./models");
@@ -20,6 +20,12 @@ var createIdea_1 = require("./commands/createIdea");
 Object.defineProperty(exports, "createIdea", { enumerable: true, get: function () { return createIdea_1.createIdea; } });
 var listProjects_1 = require("./commands/listProjects");
 Object.defineProperty(exports, "listProjects", { enumerable: true, get: function () { return listProjects_1.listProjects; } });
+var createProject_1 = require("./commands/createProject");
+Object.defineProperty(exports, "createProject", { enumerable: true, get: function () { return createProject_1.createProject; } });
+var listRequirements_1 = require("./commands/listRequirements");
+Object.defineProperty(exports, "listRequirements", { enumerable: true, get: function () { return listRequirements_1.listRequirements; } });
+var updateRequirementStatus_1 = require("./commands/updateRequirementStatus");
+Object.defineProperty(exports, "updateRequirementStatus", { enumerable: true, get: function () { return updateRequirementStatus_1.updateRequirementStatus; } });
 var createTask_1 = require("./commands/createTask");
 Object.defineProperty(exports, "createTask", { enumerable: true, get: function () { return createTask_1.createTask; } });
 var updateTaskStatus_1 = require("./commands/updateTaskStatus");

package/jest.config.cjs

@@ -15,7 +15,6 @@ module.exports = {
     '!src/**/*.d.ts',
   ],
   coverageDirectory: 'coverage',
-  coverageReporters: ['text', 'lcov', 'html'],
   moduleFileExtensions: ['ts', 'js', 'json'],
   setupFilesAfterEnv: [],
 };

package/package.json

@@ -1,9 +1,19 @@
 {
   "name": "@bernierllc/braingrid-cli-wrapper",
-  "version": "0.1.1",
+  "version": "0.3.0",
   "description": "Type-safe wrapper for BrainGrid CLI",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "test": "jest",
+    "test:run": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "lint": "eslint src --ext .ts",
+    "clean": "rimraf dist",
+    "prepublishOnly": "npm run build"
+  },
   "keywords": [
     "braingrid",
     "cli",
@@ -34,13 +44,9 @@
   "engines": {
     "node": ">=18"
   },
-  "scripts": {
-    "build": "tsc",
-    "test": "jest",
-    "test:run": "jest",
-    "test:watch": "jest --watch",
-    "test:coverage": "jest --coverage",
-    "lint": "eslint src --ext .ts",
-    "clean": "rimraf dist"
-  }
-}
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "gitHead": "af7e74b3715d56d3a193e1bb6743b337c2b0df6d"
+}

package/src/__tests__/index.test.ts

@@ -0,0 +1,77 @@
+/*
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.
+The client may use and modify this code *only within the scope of the project it was delivered for*.
+Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
+*/
+
+// Mock CLI module before importing index
+jest.mock('../cli', () => ({
+  runBrainGridCommand: jest.fn()
+}));
+
+// Mock all command modules to avoid loading real execa
+jest.mock('../commands/createIdea', () => ({
+  createIdea: jest.fn()
+}));
+jest.mock('../commands/listProjects', () => ({
+  listProjects: jest.fn()
+}));
+jest.mock('../commands/createProject', () => ({
+  createProject: jest.fn()
+}));
+jest.mock('../commands/listRequirements', () => ({
+  listRequirements: jest.fn()
+}));
+jest.mock('../commands/updateRequirementStatus', () => ({
+  updateRequirementStatus: jest.fn()
+}));
+jest.mock('../commands/createTask', () => ({
+  createTask: jest.fn()
+}));
+jest.mock('../commands/updateTaskStatus', () => ({
+  updateTaskStatus: jest.fn()
+}));
+jest.mock('../commands/listTasks', () => ({
+  listTasks: jest.fn()
+}));
+
+import * as BrainGridWrapper from '../index';
+
+describe('BrainGrid CLI Wrapper - Index Exports', () => {
+  it('should export all type definitions', () => {
+    expect(BrainGridWrapper.BrainGridProjectSchema).toBeDefined();
+    expect(BrainGridWrapper.BrainGridRequirementSchema).toBeDefined();
+    expect(BrainGridWrapper.BrainGridTaskSchema).toBeDefined();
+    expect(BrainGridWrapper.BrainGridCliError).toBeDefined();
+  });
+
+  it('should export all command functions', () => {
+    expect(typeof BrainGridWrapper.createIdea).toBe('function');
+    expect(typeof BrainGridWrapper.listProjects).toBe('function');
+    expect(typeof BrainGridWrapper.createProject).toBe('function');
+    expect(typeof BrainGridWrapper.listRequirements).toBe('function');
+    expect(typeof BrainGridWrapper.updateRequirementStatus).toBe('function');
+    expect(typeof BrainGridWrapper.createTask).toBe('function');
+    expect(typeof BrainGridWrapper.updateTaskStatus).toBe('function');
+    expect(typeof BrainGridWrapper.listTasks).toBe('function');
+  });
+
+  it('should export BrainGridCliError as a class', () => {
+    const error = new BrainGridWrapper.BrainGridCliError(
+      'Test error',
+      'braingrid test',
+      1,
+      'test stderr'
+    );
+
+    expect(error).toBeInstanceOf(Error);
+    expect(error).toBeInstanceOf(BrainGridWrapper.BrainGridCliError);
+    expect(error.name).toBe('BrainGridCliError');
+    expect(error.message).toBe('Test error');
+    expect(error.command).toBe('braingrid test');
+    expect(error.exitCode).toBe(1);
+    expect(error.stderr).toBe('test stderr');
+  });
+});

package/src/commands/createProject.test.ts

@@ -0,0 +1,75 @@
+/*
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.
+The client may use and modify this code *only within the scope of the project it was delivered for*.
+Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
+*/
+
+import { createProject } from './createProject';
+
+jest.mock('../cli', () => ({
+  runBrainGridCommand: jest.fn()
+}));
+
+import { runBrainGridCommand } from '../cli';
+
+describe('createProject', () => {
+  beforeEach(() => {
+    jest.clearAllMocks();
+  });
+
+  it('should create project with name only', async () => {
+    (runBrainGridCommand as jest.MockedFunction<typeof runBrainGridCommand>).mockResolvedValue({
+      id: 'proj-123',
+      name: 'Test Project'
+    });
+
+    const result = await createProject('Test Project');
+
+    expect(runBrainGridCommand).toHaveBeenCalledWith([
+      'project',
+      'create',
+      '--name',
+      'Test Project',
+      '--format',
+      'json'
+    ]);
+    expect(result).toEqual({
+      id: 'proj-123',
+      name: 'Test Project'
+    });
+  });
+
+  it('should create project with name and description', async () => {
+    (runBrainGridCommand as jest.MockedFunction<typeof runBrainGridCommand>).mockResolvedValue({
+      id: 'proj-456',
+      name: 'My Project',
+      description: 'Project description'
+    });
+
+    const result = await createProject('My Project', 'Project description');
+
+    expect(runBrainGridCommand).toHaveBeenCalledWith([
+      'project',
+      'create',
+      '--name',
+      'My Project',
+      '--format',
+      'json',
+      '--description',
+      'Project description'
+    ]);
+    expect(result).toEqual({
+      id: 'proj-456',
+      name: 'My Project',
+      description: 'Project description'
+    });
+  });
+
+  it('should throw on invalid response', async () => {
+    (runBrainGridCommand as jest.MockedFunction<typeof runBrainGridCommand>).mockResolvedValue({ invalid: 'data' });
+
+    await expect(createProject('Test')).rejects.toThrow();
+  });
+});

package/src/commands/createProject.ts

@@ -0,0 +1,37 @@
+/*
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.
+The client may use and modify this code *only within the scope of the project it was delivered for*.
+Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
+*/
+
+import { runBrainGridCommand } from '../cli';
+import { BrainGridProject, BrainGridProjectSchema } from '../models';
+
+/**
+ * Creates a new BrainGrid project
+ * @param name - Project name (required)
+ * @param description - Project description (optional)
+ * @returns Promise resolving to the created project
+ */
+export async function createProject(
+  name: string,
+  description?: string
+): Promise<BrainGridProject> {
+  const args = ['project', 'create', '--name', name, '--format', 'json'];
+
+  if (description) {
+    args.push('--description', description);
+  }
+
+  const result = await runBrainGridCommand(args);
+
+  // Validate response
+  const parsed = BrainGridProjectSchema.safeParse(result);
+  if (!parsed.success) {
+    throw new Error(`Invalid BrainGrid response: ${parsed.error.message}`);
+  }
+
+  return parsed.data;
+}