@alaagh/brainkit 2.0.0 → 2.0.2

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 All notable changes to this project are documented here.
 
+## [2.0.2] - 2026-03-20
+
+### Added
+
+- Comprehensive failure path tests added for scripts and CLI edge cases.
+
+### Fixed
+
+- CLI option parsing hardened for missing values (`--dest`, `--mode`).
+- CI steps split for better attribution.
+
 ## [2.0.0] - 2026-02-14
 
 ### Added

package/README.md

@@ -5,45 +5,44 @@
 [![npm version](https://img.shields.io/npm/v/%40alaagh%2Fbrainkit)](https://www.npmjs.com/package/@alaagh/brainkit)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](./LICENSE)
 
-`brainkit` is an installable npm package for AI-ready assets:
+Install production-ready AI skills with npm
 
-- skills
-- skill artifacts (`.skill`)
-- tool registry space (future)
+## Why Brainkit
 
-It currently includes one production skill: `threejs-performance-optimizer`.
+`brainkit` packages AI skills so teams can install, version, and reuse them through a single npm package.
+It keeps skill delivery simple: discover skills, install artifacts or source, and integrate them into existing workflows.
 
-## Install with npm
+## Quickstart
 
 ```bash
 npm install @alaagh/brainkit
+npx brainkit list
+npx brainkit install threejs-performance-optimizer --dest ./skills
 ```
 
-## Install the skill
+## JavaScript API
 
-1. List available skills:
+```js
+import { listSkills, installSkill } from "@alaagh/brainkit";
 
-```bash
-npx brainkit list
+const skills = listSkills();
+await installSkill("threejs-performance-optimizer", "./local-skills");
 ```
 
-2. Install the packaged skill artifact:
+```ts
+import { listSkills, installSkill } from "@alaagh/brainkit";
+import type { InstallResult } from "@alaagh/brainkit";
 
-```bash
-npx brainkit install threejs-performance-optimizer --dest ~/.config/opencode/skills
+const skills: string[] = listSkills();
+const result: InstallResult = await installSkill(
+  "threejs-performance-optimizer",
+  "./local-skills",
+);
 ```
 
-This creates:
-
-`~/.config/opencode/skills/threejs-performance-optimizer.skill`
-
-3. Optional: install source folder instead of `.skill` artifact:
-
-```bash
-npx brainkit install threejs-performance-optimizer --mode source --dest ~/.config/opencode/skills
-```
+See `docs/API_REFERENCE.md` for all exported functions.
 
-## CLI quick reference
+## CLI reference
 
 ```bash
 brainkit list
@@ -53,18 +52,11 @@ brainkit where threejs-performance-optimizer
 brainkit install <skill|all> --dest <path> [--mode artifact|source]
 ```
 
-## JavaScript API
+## What's included
 
-```js
-import { listSkills, installSkill } from "@alaagh/brainkit";
-
-const skills = listSkills();
-await installSkill("threejs-performance-optimizer", "./local-skills");
-```
-
-## What is included today
-
-- `threejs-performance-optimizer`: profile-first optimization playbook for Three.js and React Three Fiber performance.
+- Current production skill: `threejs-performance-optimizer`
+- Skill artifacts in `.skill` format for direct installation
+- Tool registry space in `tools/manifest.json` for future expansion
 
 ## Repository layout
 
@@ -84,4 +76,8 @@ npm test
 
 ## Contributing
 
-See `CONTRIBUTING.md`.
+See `CONTRIBUTING.md` and look for issues labeled `good first issue`.
+
+## License
+
+MIT. See `./LICENSE`.

package/dist/cli.js

@@ -19,12 +19,18 @@ function parseOptions(argv) {
     const token = argv[index];
 
     if (token === "--dest") {
+      if (index + 1 >= argv.length || argv[index + 1].startsWith("--")) {
+        throw new Error("Missing value for --dest.");
+      }
       options.dest = argv[index + 1];
       index += 1;
       continue;
     }
 
     if (token === "--mode") {
+      if (index + 1 >= argv.length || argv[index + 1].startsWith("--")) {
+        throw new Error("Missing value for --mode.");
+      }
       options.mode = argv[index + 1];
       index += 1;
       continue;
@@ -121,7 +127,11 @@ async function run() {
 
     const options = parseOptions(argv.slice(2));
     if (!options.dest) {
-      throw new Error("Destination path is required. Use --dest <path>.");
+      throw new Error(
+        "Missing required option --dest.\n\n" +
+          "Example:\n" +
+          "  brainkit install threejs-performance-optimizer --dest ./my-skills",
+      );
     }
 
     if (!["artifact", "source"].includes(options.mode)) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@alaagh/brainkit",
-  "version": "2.0.0",
-  "description": "Installable npm bundle of AI skills with CLI and JavaScript API.",
+  "version": "2.0.2",
+  "description": "Install production-ready AI skills with npm",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",