@brainjar/cli 0.6.0 → 0.6.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brainjar/cli",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "Shape how your AI thinks — composable soul, persona, and rules for AI agents",
   "type": "module",
   "license": "MIT",

package/src/api-types.ts

@@ -107,6 +107,27 @@ export interface ApiComposeResult {
   warnings?: string[]
 }
 
+// --- Content version types ---
+
+export interface ApiVersionSummary {
+  version: number
+  created_at: string
+}
+
+export interface ApiVersionList {
+  versions: ApiVersionSummary[]
+}
+
+export interface ApiContentVersion {
+  id: string
+  content_type: string
+  slug: string
+  version: number
+  content: string | null
+  metadata: Record<string, unknown> | null
+  created_at: string
+}
+
 // --- Content bundle types (export/import) ---
 
 export interface BundleSoul {

package/src/commands/persona.ts

@@ -6,7 +6,7 @@ import { ErrorCode, createError } from '../errors.js'
 import { normalizeSlug, getEffectiveState, getStateOverride, putState } from '../state.js'
 import { sync } from '../sync.js'
 import { getApi } from '../client.js'
-import type { ApiPersona, ApiPersonaList, ApiRuleList } from '../api-types.js'
+import type { ApiPersona, ApiPersonaList, ApiRuleList, ApiVersionList, ApiContentVersion } from '../api-types.js'
 
 export const persona = Cli.create('persona', {
   description: 'Manage personas — role behavior and workflow for the agent',
@@ -167,6 +167,7 @@ export const persona = Cli.create('persona', {
     options: z.object({
       project: z.boolean().default(false).describe('Show project persona override (if any)'),
       short: z.boolean().default(false).describe('Print only the active persona name'),
+      version: z.number().optional().describe('Show a specific version from history'),
     }),
     async run(c) {
       const api = await getApi()
@@ -177,6 +178,14 @@ export const persona = Cli.create('persona', {
         return state.persona ?? 'none'
       }
 
+      if (c.options.version) {
+        const name = c.args.name
+        if (!name) throw createError(ErrorCode.MISSING_ARG, { message: 'Name is required when using --version' })
+        const slug = normalizeSlug(name, 'persona name')
+        const v = await api.get<ApiContentVersion>(`/api/v1/personas/${slug}/versions/${c.options.version}`)
+        return { name: slug, version: v.version, content: v.content, metadata: v.metadata, created_at: v.created_at }
+      }
+
       if (c.args.name) {
         const name = normalizeSlug(c.args.name, 'persona name')
         try {
@@ -214,6 +223,40 @@ export const persona = Cli.create('persona', {
       }
     },
   })
+  .command('history', {
+    description: 'List version history for a persona',
+    args: z.object({
+      name: z.string().describe('Persona name'),
+    }),
+    async run(c) {
+      const name = normalizeSlug(c.args.name, 'persona name')
+      const api = await getApi()
+      const result = await api.get<ApiVersionList>(`/api/v1/personas/${name}/versions`)
+      return { name, versions: result.versions }
+    },
+  })
+  .command('revert', {
+    description: 'Restore a persona to a previous version',
+    args: z.object({
+      name: z.string().describe('Persona name'),
+    }),
+    options: z.object({
+      to: z.number().describe('Version number to restore'),
+    }),
+    async run(c) {
+      const name = normalizeSlug(c.args.name, 'persona name')
+      const api = await getApi()
+      const v = await api.get<ApiContentVersion>(`/api/v1/personas/${name}/versions/${c.options.to}`)
+      if (!v.content) throw createError(ErrorCode.BAD_REQUEST, { message: 'Version has no content to restore' })
+      const bundledRules = (v.metadata as { bundled_rules?: string[] })?.bundled_rules ?? []
+      await api.put<ApiPersona>(`/api/v1/personas/${name}`, { content: v.content, bundled_rules: bundledRules })
+
+      const state = await getEffectiveState(api)
+      if (state.persona === name) await sync({ api })
+
+      return { reverted: name, to_version: c.options.to }
+    },
+  })
   .command('use', {
     description: 'Activate a persona',
     args: z.object({

package/src/commands/rules.ts

@@ -6,7 +6,7 @@ import { ErrorCode, createError } from '../errors.js'
 import { normalizeSlug, getEffectiveState, getStateOverride, putState } from '../state.js'
 import { sync } from '../sync.js'
 import { getApi } from '../client.js'
-import type { ApiRule, ApiRuleList } from '../api-types.js'
+import type { ApiRule, ApiRuleList, ApiVersionList, ApiContentVersion } from '../api-types.js'
 
 export const rules = Cli.create('rules', {
   description: 'Manage rules — behavioral constraints for the agent',
@@ -145,10 +145,20 @@ export const rules = Cli.create('rules', {
     args: z.object({
       name: z.string().describe('Rule name to show'),
     }),
+    options: z.object({
+      version: z.number().optional().describe('Show a specific version from history'),
+    }),
     async run(c) {
       const name = normalizeSlug(c.args.name, 'rule name')
       const api = await getApi()
 
+      if (c.options.version) {
+        const v = await api.get<ApiContentVersion>(`/api/v1/rules/${name}/versions/${c.options.version}`)
+        const entries = (v.metadata as { entries?: Array<{ sort_key: number; content: string }> })?.entries ?? []
+        const content = entries.map(e => e.content.trim()).join('\n\n')
+        return { name, version: v.version, content, created_at: v.created_at }
+      }
+
       try {
         const rule = await api.get<ApiRule>(`/api/v1/rules/${name}`)
         const content = rule.entries.map(e => e.content.trim()).join('\n\n')
@@ -161,6 +171,40 @@ export const rules = Cli.create('rules', {
       }
     },
   })
+  .command('history', {
+    description: 'List version history for a rule',
+    args: z.object({
+      name: z.string().describe('Rule name'),
+    }),
+    async run(c) {
+      const name = normalizeSlug(c.args.name, 'rule name')
+      const api = await getApi()
+      const result = await api.get<ApiVersionList>(`/api/v1/rules/${name}/versions`)
+      return { name, versions: result.versions }
+    },
+  })
+  .command('revert', {
+    description: 'Restore a rule to a previous version',
+    args: z.object({
+      name: z.string().describe('Rule name'),
+    }),
+    options: z.object({
+      to: z.number().describe('Version number to restore'),
+    }),
+    async run(c) {
+      const name = normalizeSlug(c.args.name, 'rule name')
+      const api = await getApi()
+      const v = await api.get<ApiContentVersion>(`/api/v1/rules/${name}/versions/${c.options.to}`)
+      const entries = (v.metadata as { entries?: Array<{ sort_key: number; content: string }> })?.entries
+      if (!entries) throw createError(ErrorCode.BAD_REQUEST, { message: 'Version has no entries to restore' })
+      await api.put<ApiRule>(`/api/v1/rules/${name}`, { entries: entries.map(e => ({ name: `${name}.md`, content: e.content })) })
+
+      const state = await getEffectiveState(api)
+      if (state.rules.includes(name)) await sync({ api })
+
+      return { reverted: name, to_version: c.options.to }
+    },
+  })
   .command('add', {
     description: 'Activate a rule or rule pack',
     args: z.object({

package/src/commands/soul.ts

@@ -6,7 +6,7 @@ import { ErrorCode, createError } from '../errors.js'
 import { normalizeSlug, getEffectiveState, getStateOverride, putState } from '../state.js'
 import { sync } from '../sync.js'
 import { getApi } from '../client.js'
-import type { ApiSoul, ApiSoulList } from '../api-types.js'
+import type { ApiSoul, ApiSoulList, ApiVersionList, ApiContentVersion } from '../api-types.js'
 
 export const soul = Cli.create('soul', {
   description: 'Manage soul — personality and values for the agent',
@@ -133,6 +133,7 @@ export const soul = Cli.create('soul', {
     options: z.object({
       project: z.boolean().default(false).describe('Show project soul override (if any)'),
       short: z.boolean().default(false).describe('Print only the active soul name'),
+      version: z.number().optional().describe('Show a specific version from history'),
     }),
     async run(c) {
       const api = await getApi()
@@ -143,6 +144,14 @@ export const soul = Cli.create('soul', {
         return state.soul ?? 'none'
       }
 
+      if (c.options.version) {
+        const name = c.args.name
+        if (!name) throw createError(ErrorCode.MISSING_ARG, { message: 'Name is required when using --version' })
+        const slug = normalizeSlug(name, 'soul name')
+        const v = await api.get<ApiContentVersion>(`/api/v1/souls/${slug}/versions/${c.options.version}`)
+        return { name: slug, version: v.version, content: v.content, created_at: v.created_at }
+      }
+
       if (c.args.name) {
         const name = normalizeSlug(c.args.name, 'soul name')
         try {
@@ -180,6 +189,39 @@ export const soul = Cli.create('soul', {
       }
     },
   })
+  .command('history', {
+    description: 'List version history for a soul',
+    args: z.object({
+      name: z.string().describe('Soul name'),
+    }),
+    async run(c) {
+      const name = normalizeSlug(c.args.name, 'soul name')
+      const api = await getApi()
+      const result = await api.get<ApiVersionList>(`/api/v1/souls/${name}/versions`)
+      return { name, versions: result.versions }
+    },
+  })
+  .command('revert', {
+    description: 'Restore a soul to a previous version',
+    args: z.object({
+      name: z.string().describe('Soul name'),
+    }),
+    options: z.object({
+      to: z.number().describe('Version number to restore'),
+    }),
+    async run(c) {
+      const name = normalizeSlug(c.args.name, 'soul name')
+      const api = await getApi()
+      const v = await api.get<ApiContentVersion>(`/api/v1/souls/${name}/versions/${c.options.to}`)
+      if (!v.content) throw createError(ErrorCode.BAD_REQUEST, { message: 'Version has no content to restore' })
+      await api.put<ApiSoul>(`/api/v1/souls/${name}`, { content: v.content })
+
+      const state = await getEffectiveState(api)
+      if (state.soul === name) await sync({ api })
+
+      return { reverted: name, to_version: c.options.to }
+    },
+  })
   .command('use', {
     description: 'Activate a soul',
     args: z.object({