@braingrid/cli 0.2.1 → 0.2.3

package/CHANGELOG.md

@@ -5,6 +5,54 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.3] - 2025-01-10
+
+### Added
+
+- New `task summary` subcommand for quick table overview without content
+  - Use `braingrid task summary -r REQ-X` for compact task list
+  - Complements full detail view with lightweight summary option
+
+### Changed
+
+- Simplified CLI output format with markdown as default
+  - `requirement breakdown` now defaults to markdown format (was table)
+  - `task list` now defaults to markdown format with full content (was table)
+  - Removed `--verbose` flag - full content always shown by default for AI-ready output
+  - Use `--format table` or new `task summary` command for compact view
+- Updated `/breakdown` slash command documentation
+  - Removed all `--verbose` flag references
+  - Updated examples to use new default markdown format
+  - Added references to `task summary` for quick overviews
+
+## [0.2.2] - 2025-11-10
+
+### Added
+
+- Concise BrainGrid documentation for project injection (`.claude/CLAUDE.md`)
+  - 42-line section explaining BrainGrid workflow for Claude Code
+  - Slash commands reference and typical workflow
+  - Key features (auto-detection, reactive errors, status flows, output formats)
+- BrainGrid CLI slash commands for Claude Code
+  - `/specify [prompt]` - Create AI-refined requirement from vague idea
+  - `/save-requirement [title]` - Save detailed plan as requirement
+  - `/breakdown [req-id]` - Break requirement into AI-prompted tasks
+  - `/build [req-id]` - Get complete implementation plan in markdown
+  - `/cut-release [patch|minor|major]` - Automate NPM release workflow
+- BrainGrid CLI skill for Claude Code with comprehensive workflow guidance
+- Installation instructions in braingrid-cli skill
+- BrainGrid project configuration files
+
+### Changed
+
+- Updated README tagline capitalization
+
+### Fixed
+
+- Removed unsupported `--status` field from `/save-requirement` slash command
+  - API does not accept status field during requirement creation
+  - Status is set automatically by the backend
+
 ## [0.2.1] - 2025-01-07
 
 ### Added

package/README.md

@@ -2,7 +2,7 @@
 <img src="https://www.braingrid.ai/logos/braingrid-symbol-800.png" width="100"/>
   <h1>BrainGrid</h1>
 
-  <p>Prompt AI Coding Tools like a rockstar developer</p>
+  <p>Prompt AI Coding Tools Like a Rockstar Developer</p>
   <h3>A CLI to turn messy thoughts into detailed specs and perfectly-prompted tasks to build well-structured, maintainable software with AI.</h3>
 
 [![npm version](https://img.shields.io/npm/v/@braingrid/cli.svg?color=blue&logo=npm)](https://www.npmjs.com/package/@braingrid/cli)

package/dist/cli.js

@@ -422,7 +422,7 @@ import axios3, { AxiosError as AxiosError2 } from "axios";
 
 // src/build-config.ts
 var BUILD_ENV = true ? "production" : process.env.NODE_ENV === "test" ? "development" : "production";
-var CLI_VERSION = true ? "0.2.1" : "0.0.0-test";
+var CLI_VERSION = true ? "0.2.3" : "0.0.0-test";
 var PRODUCTION_CONFIG = {
   apiUrl: "https://app.braingrid.ai",
   workosAuthUrl: "https://sensitive-harvest-60.authkit.app",
@@ -4493,10 +4493,70 @@ async function handleTaskList(opts) {
     }
     const projectShortId = projectId;
     const requirementShortId = opts.requirement;
-    const format = opts.format || "table";
-    const verbose = opts.verbose || false;
+    const format = opts.format || "markdown";
     const config = getConfig();
-    const output = formatTasksListOutput(response.tasks, format, verbose, {
+    const output = formatTasksListOutput(response.tasks, format, true, {
+      requirementId,
+      projectShortId,
+      requirementShortId,
+      apiUrl: config.apiUrl
+    });
+    return {
+      success: true,
+      message: output,
+      data: response
+    };
+  } catch (error) {
+    if (stopSpinner) {
+      stopSpinner();
+    }
+    return {
+      success: false,
+      message: formatError(error, "listing tasks")
+    };
+  }
+}
+async function handleTaskSummary(opts) {
+  let stopSpinner = null;
+  try {
+    const { taskService, auth } = getServices3();
+    const isAuthenticated = await auth.isAuthenticated();
+    if (!isAuthenticated) {
+      return {
+        success: false,
+        message: chalk8.red("\u274C Not authenticated. Please run `braingrid login` first.")
+      };
+    }
+    if (!opts.requirement) {
+      return {
+        success: false,
+        message: chalk8.red("\u274C No requirement specified.\n\n") + chalk8.dim("Please provide a requirement ID:\n") + chalk8.cyan("braingrid task summary -r REQ-456") + chalk8.dim(" (if initialized) or\n") + chalk8.cyan("braingrid task summary -r REQ-456 -p PROJ-123")
+      };
+    }
+    const workspace = await workspaceManager.getProject(opts.project);
+    if (!workspace.success) {
+      return {
+        success: false,
+        message: workspace.error
+      };
+    }
+    const projectId = workspace.projectId;
+    const requirementId = normalizeRequirementId(opts.requirement);
+    stopSpinner = showSpinner("Loading tasks", chalk8.gray);
+    const response = await taskService.listTasks(projectId, requirementId);
+    stopSpinner();
+    stopSpinner = null;
+    if (response.tasks.length === 0) {
+      return {
+        success: true,
+        message: chalk8.yellow("No tasks found."),
+        data: response
+      };
+    }
+    const projectShortId = projectId;
+    const requirementShortId = opts.requirement;
+    const config = getConfig();
+    const output = formatTasksListOutput(response.tasks, "table", false, {
       requirementId,
       projectShortId,
       requirementShortId,
@@ -6205,7 +6265,7 @@ requirement.command("breakdown [id]").description(
 ).option(
   "-p, --project <id>",
   "project ID (auto-detects from .braingrid/project.json if not provided)"
-).option("--format <format>", "output format (table, json, xml, markdown)", "table").action(async (id, opts) => {
+).option("--format <format>", "output format (table, json, xml, markdown)", "markdown").action(async (id, opts) => {
   const result = await handleRequirementBreakdown({ ...opts, id });
   console.log(result.message);
   if (!result.success) {
@@ -6225,13 +6285,20 @@ requirement.command("build [id]").description(
   }
 });
 var task = program.command("task").description("Manage tasks");
-task.command("list").description("List tasks for a requirement").option("-r, --requirement <id>", "requirement ID (REQ-456, auto-detects project if initialized)").option("-p, --project <id>", "project ID (PROJ-123, optional if project is initialized)").option("--format <format>", "output format (table, json, xml, markdown)", "table").option("--verbose", "show detailed information with content for each task").action(async (opts) => {
+task.command("list").description("List tasks for a requirement").option("-r, --requirement <id>", "requirement ID (REQ-456, auto-detects project if initialized)").option("-p, --project <id>", "project ID (PROJ-123, optional if project is initialized)").option("--format <format>", "output format (table, json, xml, markdown)", "markdown").action(async (opts) => {
   const result = await handleTaskList(opts);
   console.log(result.message);
   if (!result.success) {
     process.exit(1);
   }
 });
+task.command("summary").description("Show task summary table (quick overview without content)").option("-r, --requirement <id>", "requirement ID (REQ-456, auto-detects project if initialized)").option("-p, --project <id>", "project ID (PROJ-123, optional if project is initialized)").action(async (opts) => {
+  const result = await handleTaskSummary(opts);
+  console.log(result.message);
+  if (!result.success) {
+    process.exit(1);
+  }
+});
 task.command("show <id>").description("Show task details").option("-r, --requirement <id>", "requirement ID (REQ-456, auto-detects project if initialized)").option("-p, --project <id>", "project ID (PROJ-123, optional if project is initialized)").action(async (id, opts) => {
   const result = await handleTaskShow(id, opts);
   console.log(result.message);