@bernierllc/braingrid-cli-wrapper 0.1.1

package/src/commands/createTask.ts

@@ -0,0 +1,50 @@
+/*
+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 { BrainGridTask, BrainGridTaskSchema } from '../models';
+
+export interface CreateTaskOptions {
+  title: string;
+  description?: string;
+  tags?: string[];
+  dependencies?: string[];
+}
+
+/**
+ * Create a task in BrainGrid under a requirement
+ */
+export async function createTask(
+  reqId: string,
+  options: CreateTaskOptions
+): Promise<BrainGridTask> {
+  const args = ['task', 'create', reqId, '--title', options.title];
+
+  if (options.description) {
+    args.push('--description', options.description);
+  }
+
+  if (options.tags && options.tags.length > 0) {
+    args.push('--tags', options.tags.join(','));
+  }
+
+  if (options.dependencies && options.dependencies.length > 0) {
+    args.push('--dependencies', options.dependencies.join(','));
+  }
+
+  args.push('--format', 'json');
+
+  const result = await runBrainGridCommand(args);
+
+  const parsed = BrainGridTaskSchema.safeParse(result);
+  if (!parsed.success) {
+    throw new Error(`Invalid BrainGrid response: ${parsed.error.message}`);
+  }
+
+  return parsed.data;
+}

package/src/commands/listProjects.test.ts

@@ -0,0 +1,72 @@
+/*
+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 { listProjects } from './listProjects';
+
+jest.mock('../cli', () => ({
+  runBrainGridCommand: jest.fn()
+}));
+
+import { runBrainGridCommand } from '../cli';
+
+describe('listProjects', () => {
+  beforeEach(() => {
+    jest.clearAllMocks();
+  });
+
+  it('should list all projects', async () => {
+    const mockProjects = [
+      {
+        id: 'proj-1',
+        name: 'Project 1',
+        description: 'First project'
+      },
+      {
+        id: 'proj-2',
+        name: 'Project 2',
+        description: 'Second project'
+      }
+    ];
+
+    (runBrainGridCommand as jest.MockedFunction<typeof runBrainGridCommand>).mockResolvedValue(mockProjects);
+
+    const result = await listProjects();
+
+    expect(runBrainGridCommand).toHaveBeenCalledWith([
+      'projects',
+      'list',
+      '--format',
+      'json'
+    ]);
+
+    expect(result).toHaveLength(2);
+    expect(result[0].id).toBe('proj-1');
+    expect(result[1].id).toBe('proj-2');
+  });
+
+  it('should return empty array when no projects', async () => {
+    (runBrainGridCommand as jest.MockedFunction<typeof runBrainGridCommand>).mockResolvedValue([]);
+
+    const result = await listProjects();
+
+    expect(result).toEqual([]);
+  });
+
+  it('should validate response schema', async () => {
+    const invalidProjects = [
+      {
+        id: 123, // Should be string
+        name: 'Test'
+      }
+    ];
+
+    (runBrainGridCommand as jest.MockedFunction<typeof runBrainGridCommand>).mockResolvedValue(invalidProjects);
+
+    await expect(listProjects()).rejects.toThrow();
+  });
+});

package/src/commands/listProjects.ts

@@ -0,0 +1,25 @@
+/*
+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';
+import { z } from 'zod';
+
+/**
+ * List all projects in BrainGrid
+ */
+export async function listProjects(): Promise<BrainGridProject[]> {
+  const result = await runBrainGridCommand(['projects', 'list', '--format', 'json']);
+
+  const parsed = z.array(BrainGridProjectSchema).safeParse(result);
+  if (!parsed.success) {
+    throw new Error(`Invalid BrainGrid response: ${parsed.error.message}`);
+  }
+
+  return parsed.data;
+}

package/src/commands/listTasks.test.ts

@@ -0,0 +1,183 @@
+/*
+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 { listTasks } from './listTasks';
+
+jest.mock('../cli', () => ({
+  runBrainGridCommand: jest.fn()
+}));
+
+import { runBrainGridCommand } from '../cli';
+
+describe('listTasks', () => {
+  beforeEach(() => {
+    jest.clearAllMocks();
+  });
+
+  it('should list all tasks with no filters', async () => {
+    const mockTasks = [
+      {
+        id: 'task-1',
+        reqId: 'req-123',
+        title: 'Task 1',
+        status: 'TODO'
+      },
+      {
+        id: 'task-2',
+        reqId: 'req-123',
+        title: 'Task 2',
+        status: 'IN_PROGRESS'
+      }
+    ];
+
+    (runBrainGridCommand as jest.MockedFunction<typeof runBrainGridCommand>).mockResolvedValue(mockTasks);
+
+    const result = await listTasks();
+
+    expect(runBrainGridCommand).toHaveBeenCalledWith([
+      'task',
+      'list',
+      '--format',
+      'json'
+    ]);
+
+    expect(result).toHaveLength(2);
+    expect(result[0].id).toBe('task-1');
+  });
+
+  it('should filter tasks by requirement ID', async () => {
+    const mockTasks = [
+      {
+        id: 'task-1',
+        reqId: 'req-123',
+        title: 'Task 1',
+        status: 'TODO'
+      }
+    ];
+
+    (runBrainGridCommand as jest.MockedFunction<typeof runBrainGridCommand>).mockResolvedValue(mockTasks);
+
+    await listTasks({ reqId: 'req-123' });
+
+    expect(runBrainGridCommand).toHaveBeenCalledWith([
+      'task',
+      'list',
+      '--req',
+      'req-123',
+      '--format',
+      'json'
+    ]);
+  });
+
+  it('should filter tasks by status', async () => {
+    const mockTasks = [
+      {
+        id: 'task-1',
+        reqId: 'req-123',
+        title: 'Task 1',
+        status: 'TODO'
+      }
+    ];
+
+    (runBrainGridCommand as jest.MockedFunction<typeof runBrainGridCommand>).mockResolvedValue(mockTasks);
+
+    await listTasks({
+      status: ['TODO', 'READY']
+    });
+
+    expect(runBrainGridCommand).toHaveBeenCalledWith([
+      'task',
+      'list',
+      '--status',
+      'TODO,READY',
+      '--format',
+      'json'
+    ]);
+  });
+
+  it('should filter tasks by tags', async () => {
+    const mockTasks = [
+      {
+        id: 'task-1',
+        reqId: 'req-123',
+        title: 'Task 1',
+        status: 'TODO',
+        tags: ['DEV', 'frontend']
+      }
+    ];
+
+    (runBrainGridCommand as jest.MockedFunction<typeof runBrainGridCommand>).mockResolvedValue(mockTasks);
+
+    await listTasks({
+      tags: ['DEV', 'frontend']
+    });
+
+    expect(runBrainGridCommand).toHaveBeenCalledWith([
+      'task',
+      'list',
+      '--tags',
+      'DEV,frontend',
+      '--format',
+      'json'
+    ]);
+  });
+
+  it('should combine all filters', async () => {
+    const mockTasks = [
+      {
+        id: 'task-1',
+        reqId: 'req-123',
+        title: 'Task 1',
+        status: 'TODO',
+        tags: ['DEV']
+      }
+    ];
+
+    (runBrainGridCommand as jest.MockedFunction<typeof runBrainGridCommand>).mockResolvedValue(mockTasks);
+
+    await listTasks({
+      reqId: 'req-123',
+      status: ['TODO'],
+      tags: ['DEV']
+    });
+
+    expect(runBrainGridCommand).toHaveBeenCalledWith([
+      'task',
+      'list',
+      '--req',
+      'req-123',
+      '--status',
+      'TODO',
+      '--tags',
+      'DEV',
+      '--format',
+      'json'
+    ]);
+  });
+
+  it('should return empty array when no tasks', async () => {
+    (runBrainGridCommand as jest.MockedFunction<typeof runBrainGridCommand>).mockResolvedValue([]);
+
+    const result = await listTasks();
+
+    expect(result).toEqual([]);
+  });
+
+  it('should validate response schema', async () => {
+    const invalidTasks = [
+      {
+        id: 123, // Should be string
+        title: 'Test'
+      }
+    ];
+
+    (runBrainGridCommand as jest.MockedFunction<typeof runBrainGridCommand>).mockResolvedValue(invalidTasks);
+
+    await expect(listTasks()).rejects.toThrow();
+  });
+});

package/src/commands/listTasks.ts

@@ -0,0 +1,47 @@
+/*
+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 { BrainGridTask, BrainGridTaskSchema, TaskStatus } from '../models';
+import { z } from 'zod';
+
+export interface ListTasksOptions {
+  reqId?: string;
+  status?: TaskStatus[];
+  tags?: string[];
+}
+
+/**
+ * List tasks in BrainGrid with optional filters
+ */
+export async function listTasks(options: ListTasksOptions = {}): Promise<BrainGridTask[]> {
+  const args = ['task', 'list'];
+
+  if (options.reqId) {
+    args.push('--req', options.reqId);
+  }
+
+  if (options.status && options.status.length > 0) {
+    args.push('--status', options.status.join(','));
+  }
+
+  if (options.tags && options.tags.length > 0) {
+    args.push('--tags', options.tags.join(','));
+  }
+
+  args.push('--format', 'json');
+
+  const result = await runBrainGridCommand(args);
+
+  const parsed = z.array(BrainGridTaskSchema).safeParse(result);
+  if (!parsed.success) {
+    throw new Error(`Invalid BrainGrid response: ${parsed.error.message}`);
+  }
+
+  return parsed.data;
+}

package/src/commands/updateTaskStatus.test.ts

@@ -0,0 +1,96 @@
+/*
+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 { updateTaskStatus } from './updateTaskStatus';
+
+jest.mock('../cli', () => ({
+  runBrainGridCommand: jest.fn()
+}));
+
+import { runBrainGridCommand } from '../cli';
+
+describe('updateTaskStatus', () => {
+  beforeEach(() => {
+    jest.clearAllMocks();
+  });
+
+  it('should update task status', async () => {
+    (runBrainGridCommand as jest.MockedFunction<typeof runBrainGridCommand>).mockResolvedValue(null);
+
+    await updateTaskStatus('task-123', {
+      status: 'IN_PROGRESS'
+    });
+
+    expect(runBrainGridCommand).toHaveBeenCalledWith([
+      'task',
+      'update',
+      'task-123',
+      '--status',
+      'IN_PROGRESS'
+    ]);
+  });
+
+  it('should update task with assigned user', async () => {
+    (runBrainGridCommand as jest.MockedFunction<typeof runBrainGridCommand>).mockResolvedValue(null);
+
+    await updateTaskStatus('task-123', {
+      status: 'IN_PROGRESS',
+      assignedTo: 'user-456'
+    });
+
+    expect(runBrainGridCommand).toHaveBeenCalledWith([
+      'task',
+      'update',
+      'task-123',
+      '--status',
+      'IN_PROGRESS',
+      '--assigned-to',
+      'user-456'
+    ]);
+  });
+
+  it('should update task with metadata', async () => {
+    (runBrainGridCommand as jest.MockedFunction<typeof runBrainGridCommand>).mockResolvedValue(null);
+
+    const metadata = {
+      progress: 50,
+      notes: 'Half done'
+    };
+
+    await updateTaskStatus('task-123', {
+      status: 'IN_PROGRESS',
+      metadata
+    });
+
+    expect(runBrainGridCommand).toHaveBeenCalledWith([
+      'task',
+      'update',
+      'task-123',
+      '--status',
+      'IN_PROGRESS',
+      '--metadata',
+      JSON.stringify(metadata)
+    ]);
+  });
+
+  it('should update without status (metadata only)', async () => {
+    (runBrainGridCommand as jest.MockedFunction<typeof runBrainGridCommand>).mockResolvedValue(null);
+
+    await updateTaskStatus('task-123', {
+      assignedTo: 'user-456'
+    });
+
+    expect(runBrainGridCommand).toHaveBeenCalledWith([
+      'task',
+      'update',
+      'task-123',
+      '--assigned-to',
+      'user-456'
+    ]);
+  });
+});

package/src/commands/updateTaskStatus.ts

@@ -0,0 +1,40 @@
+/*
+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 { TaskStatus } from '../models';
+
+export interface UpdateTaskOptions {
+  status?: TaskStatus;
+  assignedTo?: string;
+  metadata?: Record<string, unknown>;
+}
+
+/**
+ * Update task status and metadata in BrainGrid
+ */
+export async function updateTaskStatus(
+  taskId: string,
+  options: UpdateTaskOptions
+): Promise<void> {
+  const args = ['task', 'update', taskId];
+
+  if (options.status) {
+    args.push('--status', options.status);
+  }
+
+  if (options.assignedTo) {
+    args.push('--assigned-to', options.assignedTo);
+  }
+
+  if (options.metadata) {
+    args.push('--metadata', JSON.stringify(options.metadata));
+  }
+
+  await runBrainGridCommand(args);
+}

package/src/index.ts

@@ -0,0 +1,29 @@
+/*
+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.
+*/
+
+// BrainGrid CLI Wrapper - Type-safe wrapper for BrainGrid CLI
+
+// Export types and schemas
+export {
+  BrainGridProject,
+  BrainGridRequirement,
+  BrainGridTask,
+  RequirementStatus,
+  TaskStatus,
+  BrainGridProjectSchema,
+  BrainGridRequirementSchema,
+  BrainGridTaskSchema,
+  BrainGridCliError
+} from './models';
+
+// Export commands
+export { createIdea } from './commands/createIdea';
+export { listProjects } from './commands/listProjects';
+export { createTask, CreateTaskOptions } from './commands/createTask';
+export { updateTaskStatus, UpdateTaskOptions } from './commands/updateTaskStatus';
+export { listTasks, ListTasksOptions } from './commands/listTasks';