@brainjar/cli 0.2.0 → 0.2.2

package/README.md

@@ -2,6 +2,7 @@
 
 [![CI](https://github.com/brainjar-sh/brainjar-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/brainjar-sh/brainjar-cli/actions/workflows/ci.yml)
 [![npm](https://img.shields.io/npm/v/@brainjar/cli)](https://www.npmjs.com/package/@brainjar/cli)
+[![downloads](https://img.shields.io/npm/dm/@brainjar/cli)](https://www.npmjs.com/package/@brainjar/cli)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 
 Shape how your AI thinks — identity, soul, persona, rules.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brainjar/cli",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Shape how your AI thinks — composable identity, soul, persona, and rules for AI agents",
   "type": "module",
   "license": "MIT",
@@ -43,9 +43,6 @@
     "changeset:tag": "changeset tag",
     "changeset:publish": "changeset publish"
   },
-  "overrides": {
-    "hono": ">=4.12.7"
-  },
   "dependencies": {
     "incur": "^0.3.4",
     "yaml": "^2.8.2"

package/src/brain.ts

@@ -0,0 +1,69 @@
+import { Errors } from 'incur'
+import { readFile } from 'node:fs/promises'
+import { join } from 'node:path'
+import { parse as parseYaml } from 'yaml'
+import { paths } from './paths.js'
+import { normalizeSlug } from './state.js'
+
+const { IncurError } = Errors
+
+/** Brain YAML schema: soul + persona + rules */
+export interface BrainConfig {
+  soul: string
+  persona: string
+  rules: string[]
+}
+
+/** Read and validate a brain YAML file. */
+export async function readBrain(name: string): Promise<BrainConfig> {
+  const slug = normalizeSlug(name, 'brain name')
+  const file = join(paths.brains, `${slug}.yaml`)
+
+  let raw: string
+  try {
+    raw = await readFile(file, 'utf-8')
+  } catch {
+    throw new IncurError({
+      code: 'BRAIN_NOT_FOUND',
+      message: `Brain "${slug}" not found.`,
+      hint: 'Run `brainjar brain list` to see available brains.',
+    })
+  }
+
+  let parsed: unknown
+  try {
+    parsed = parseYaml(raw)
+  } catch (e) {
+    throw new IncurError({
+      code: 'BRAIN_CORRUPT',
+      message: `Brain "${slug}" has invalid YAML: ${(e as Error).message}`,
+    })
+  }
+
+  if (!parsed || typeof parsed !== 'object') {
+    throw new IncurError({
+      code: 'BRAIN_CORRUPT',
+      message: `Brain "${slug}" is empty or invalid.`,
+    })
+  }
+
+  const p = parsed as Record<string, unknown>
+
+  if (typeof p.soul !== 'string' || !p.soul) {
+    throw new IncurError({
+      code: 'BRAIN_INVALID',
+      message: `Brain "${slug}" is missing required field "soul".`,
+    })
+  }
+
+  if (typeof p.persona !== 'string' || !p.persona) {
+    throw new IncurError({
+      code: 'BRAIN_INVALID',
+      message: `Brain "${slug}" is missing required field "persona".`,
+    })
+  }
+
+  const rules = Array.isArray(p.rules) ? p.rules.map(String) : []
+
+  return { soul: p.soul, persona: p.persona, rules }
+}

package/src/commands/brain.ts

@@ -3,7 +3,7 @@ import { Cli, z, Errors } from 'incur'
 const { IncurError } = Errors
 import { readdir, readFile, writeFile, access, rm } from 'node:fs/promises'
 import { join, basename } from 'node:path'
-import { parse as parseYaml, stringify as stringifyYaml } from 'yaml'
+import { stringify as stringifyYaml } from 'yaml'
 import { paths } from '../paths.js'
 import {
   readState,
@@ -17,69 +17,9 @@ import {
   requireBrainjarDir,
   normalizeSlug,
 } from '../state.js'
+import { readBrain, type BrainConfig } from '../brain.js'
 import { sync } from '../sync.js'
 
-/** Brain YAML schema: soul + persona + rules */
-export interface BrainConfig {
-  soul: string
-  persona: string
-  rules: string[]
-}
-
-/** Read and validate a brain YAML file. */
-export async function readBrain(name: string): Promise<BrainConfig> {
-  const slug = normalizeSlug(name, 'brain name')
-  const file = join(paths.brains, `${slug}.yaml`)
-
-  let raw: string
-  try {
-    raw = await readFile(file, 'utf-8')
-  } catch {
-    throw new IncurError({
-      code: 'BRAIN_NOT_FOUND',
-      message: `Brain "${slug}" not found.`,
-      hint: 'Run `brainjar brain list` to see available brains.',
-    })
-  }
-
-  let parsed: unknown
-  try {
-    parsed = parseYaml(raw)
-  } catch (e) {
-    throw new IncurError({
-      code: 'BRAIN_CORRUPT',
-      message: `Brain "${slug}" has invalid YAML: ${(e as Error).message}`,
-    })
-  }
-
-  if (!parsed || typeof parsed !== 'object') {
-    throw new IncurError({
-      code: 'BRAIN_CORRUPT',
-      message: `Brain "${slug}" is empty or invalid.`,
-    })
-  }
-
-  const p = parsed as Record<string, unknown>
-
-  if (typeof p.soul !== 'string' || !p.soul) {
-    throw new IncurError({
-      code: 'BRAIN_INVALID',
-      message: `Brain "${slug}" is missing required field "soul".`,
-    })
-  }
-
-  if (typeof p.persona !== 'string' || !p.persona) {
-    throw new IncurError({
-      code: 'BRAIN_INVALID',
-      message: `Brain "${slug}" is missing required field "persona".`,
-    })
-  }
-
-  const rules = Array.isArray(p.rules) ? p.rules.map(String) : []
-
-  return { soul: p.soul, persona: p.persona, rules }
-}
-
 export const brain = Cli.create('brain', {
   description: 'Manage brains — full-stack configuration snapshots (soul + persona + rules)',
 })

package/src/commands/compose.ts

@@ -15,7 +15,7 @@ import {
   stripFrontmatter,
   resolveRuleContent,
 } from '../state.js'
-import { readBrain } from './brain.js'
+import { readBrain } from '../brain.js'
 
 export const compose = Cli.create('compose', {
   description: 'Assemble a full subagent prompt from a brain or ad-hoc persona',

package/src/commands/shell.ts

@@ -6,7 +6,7 @@ import { access } from 'node:fs/promises'
 import { requireBrainjarDir } from '../state.js'
 import { sync } from '../sync.js'
 import { getLocalDir } from '../paths.js'
-import { readBrain } from './brain.js'
+import { readBrain } from '../brain.js'
 
 export const shell = Cli.create('shell', {
   description: 'Spawn a subshell with BRAINJAR_* env vars set',

package/src/hooks.ts

@@ -43,13 +43,18 @@ function getSettingsPath(local: boolean): string {
 }
 
 async function readSettings(path: string): Promise<Settings> {
+  let raw: string
   try {
-    const raw = await readFile(path, 'utf-8')
-    return JSON.parse(raw)
+    raw = await readFile(path, 'utf-8')
   } catch (e) {
     if ((e as NodeJS.ErrnoException).code === 'ENOENT') return {}
     throw e
   }
+  try {
+    return JSON.parse(raw)
+  } catch {
+    throw new Error(`Invalid JSON in ${path} — fix the file or delete it and re-run.`)
+  }
 }
 
 async function writeSettings(path: string, settings: Settings): Promise<void> {

package/src/pack.ts

@@ -4,7 +4,7 @@ import { parse as parseYaml, stringify as stringifyYaml } from 'yaml'
 import { Errors } from 'incur'
 import { paths } from './paths.js'
 import { normalizeSlug, requireBrainjarDir, readState, writeState, withStateLock } from './state.js'
-import { readBrain, type BrainConfig } from './commands/brain.js'
+import { readBrain, type BrainConfig } from './brain.js'
 import { sync } from './sync.js'
 
 const { IncurError } = Errors

package/src/sync.ts

@@ -80,10 +80,7 @@ export async function sync(options?: Backend | SyncOptions) {
   try {
     existingContent = await readFile(config.configFile, 'utf-8')
   } catch (e) {
-    const code = (e as NodeJS.ErrnoException).code
-    if (code !== 'ENOENT') {
-      warnings.push(`Could not read existing config: ${(e as Error).message}`)
-    }
+    if ((e as NodeJS.ErrnoException).code !== 'ENOENT') throw e
   }
 
   // Backup existing config if it has no brainjar markers (first-time takeover)