botrun-msync 0.1.0 → 0.2.0

package/README.md

@@ -39,7 +39,7 @@ A **scope** is a logical name that maps to a git repo. Each agent can have multi
 ```bash
 npx botrun-msync config add-scope my-notes \
   --repo github.com/org/my-memory \
-  --token-env BM_TOKEN_NOTES \
+  --token-env BMS_TOKEN_NOTES \
   --description "Personal research notes" \
   --access readwrite
 ```
@@ -53,27 +53,27 @@ Different scopes can point to different repos. Permissions are controlled by Git
 # Read-write token for personal repo
 npx botrun-msync config add-scope director \
   --repo github.com/org/director-memory \
-  --token-env BM_TOKEN_DIRECTOR \
+  --token-env BMS_TOKEN_DIRECTOR \
   --description "Director personal research" \
   --access readwrite
 
 # Read-only token for team repos
 npx botrun-msync config add-scope team1 \
   --repo github.com/org/team1-memory \
-  --token-env BM_TOKEN_TEAMS \
+  --token-env BMS_TOKEN_TEAMS \
   --description "Team 1 memory" \
   --access readonly
 
 npx botrun-msync config add-scope team2 \
   --repo github.com/org/team2-memory \
-  --token-env BM_TOKEN_TEAMS \
+  --token-env BMS_TOKEN_TEAMS \
   --description "Team 2 memory" \
   --access readonly
 ```
 
 Create separate GitHub Fine-grained PATs with different permissions:
-- `BM_TOKEN_DIRECTOR` → Contents: Read and write (only `director-memory` repo)
-- `BM_TOKEN_TEAMS` → Contents: Read-only (only `team1-memory` + `team2-memory` repos)
+- `BMS_TOKEN_DIRECTOR` → Contents: Read and write (only `director-memory` repo)
+- `BMS_TOKEN_TEAMS` → Contents: Read-only (only `team1-memory` + `team2-memory` repos)
 
 This way, even if a user modifies the config, they can't write to repos their token doesn't allow.
 
@@ -84,7 +84,7 @@ This way, even if a user modifies the config, they can't write to repos their to
 All `bms` data lives under a single base directory:
 
 ```
-~/.botrun/bm/              ← default base path
+~/.botrun/bms/             ← default base path
 ├── config.json            ← scope definitions
 └── data/
     ├── my-notes/          ← git clone of my-notes scope
@@ -95,31 +95,31 @@ All `bms` data lives under a single base directory:
 Override with CLI option or environment variable:
 
 ```bash
-npx botrun-msync --bm-path /tmp/test-bm memory init    # CLI option (highest priority)
-BM_PATH=/custom/path npx botrun-msync memory init       # environment variable
+npx botrun-msync --bms-path /tmp/test-bms memory init    # CLI option (highest priority)
+BMS_PATH=/custom/path npx botrun-msync memory init        # environment variable
 ```
 
-Priority: `--bm-path` > `BM_PATH` > `~/.botrun/bm/`
+Priority: `--bms-path` > `BMS_PATH` > `~/.botrun/bms/`
 
 ### Config File
 
-Located at `<BM_PATH>/config.json` (default: `~/.botrun/bm/config.json`).
+Located at `<BMS_PATH>/config.json` (default: `~/.botrun/bms/config.json`).
 
-Override config path independently with: `BM_CONFIG=/path/to/config.json`
+Override config path independently with: `BMS_CONFIG=/path/to/config.json`
 
 ```json
 {
   "scopes": {
     "my-notes": {
       "repo": "github.com/org/member1-memory",
-      "token_env": "BM_TOKEN_NOTES",
+      "token_env": "BMS_TOKEN_NOTES",
       "description": "Personal research notes",
       "access": "readwrite"
     },
     "team1": {
       "repo": "github.com/org/team1-memory",
       "branch": "dev",
-      "token_env": "BM_TOKEN_TEAMS",
+      "token_env": "BMS_TOKEN_TEAMS",
       "description": "Team 1 memory",
       "access": "readonly"
     }
@@ -148,8 +148,8 @@ npx botrun-msync config show
 
 | Variable | Purpose |
 |----------|---------|
-| `BM_PATH` | Base directory for all bm data (default: `~/.botrun/bm`) |
-| `BM_CONFIG` | Config file path (overrides `<BM_PATH>/config.json`) |
+| `BMS_PATH` | Base directory for all bms data (default: `~/.botrun/bms`) |
+| `BMS_CONFIG` | Config file path (overrides `<BMS_PATH>/config.json`) |
 
 Each scope's token is configured via `--token-env`, which points to an environment variable name. There are no global token variables — every scope must declare its own.
 
@@ -157,13 +157,13 @@ Each scope's token is configured via `--token-env`, which points to an environme
 
 ### `npx botrun-msync memory init`
 
-Clones all configured scope repos to `<BM_PATH>/data/<scope-name>/`. If already cloned, pulls latest.
+Clones all configured scope repos to `<BMS_PATH>/data/<scope-name>/`. If already cloned, pulls latest.
 
 ```json
 {
   "scopes": {
-    "my-notes": { "local": "/root/.botrun/bm/data/my-notes" },
-    "team1": { "local": "/root/.botrun/bm/data/team1" }
+    "my-notes": { "local": "/root/.botrun/bms/data/my-notes" },
+    "team1": { "local": "/root/.botrun/bms/data/team1" }
   }
 }
 ```
@@ -179,13 +179,13 @@ Lists all scopes with their repo, description, access, and local filesystem path
       "repo": "github.com/org/member1-memory",
       "description": "Personal research notes",
       "access": "readwrite",
-      "local": "/root/.botrun/bm/data/my-notes"
+      "local": "/root/.botrun/bms/data/my-notes"
     },
     "team1": {
       "repo": "github.com/org/team1-memory",
       "description": "Team 1 memory",
       "access": "readonly",
-      "local": "/root/.botrun/bm/data/team1"
+      "local": "/root/.botrun/bms/data/team1"
     }
   }
 }
@@ -216,7 +216,7 @@ npx botrun-msync memory --help
 
 ```
 VM starts
-  → npx botrun-msync memory init          # clone repos to <BM_PATH>/data/
+  → npx botrun-msync memory init          # clone repos to <BMS_PATH>/data/
   → agent reads/writes files     # using native tools (Read, Write, grep)
   → npx botrun-msync memory sync          # push changes
 VM destroyed
@@ -226,7 +226,7 @@ VM destroyed
 
 ```bash
 npm install
-npm test        # 41 tests
+npm test
 ```
 
 ## License

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "botrun-msync",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Git-backed memory sync CLI for AI agents (forked from botrun-mcli@0.2.2)",
   "type": "module",
   "bin": {

package/src/bin.mjs

@@ -27,13 +27,13 @@ const program = new Command();
 program
   .name('bms')
   .description('Git-backed memory sync for agents')
-  .version('0.1.0')
+  .version('0.2.0')
   .helpCommand(false)
-  .option('--bm-path <path>', 'Base directory for all bm data')
+  .option('--bms-path <path>', 'Base directory for all bms data')
   .configureHelp({ formatHelp: (cmd) => JSON.stringify(jsonHelp(cmd), null, 2) })
   .hook('preAction', (thisCommand) => {
-    const bmPath = thisCommand.opts().bmPath;
-    if (bmPath) process.env.BM_PATH = bmPath;
+    const bmsPath = thisCommand.opts().bmsPath;
+    if (bmsPath) process.env.BMS_PATH = bmsPath;
   });
 
 // --- config ---

package/src/commands/memory/sync.mjs

@@ -37,7 +37,7 @@ export async function syncMemory(options = {}) {
     const status = await gitExec(['-C', cloneDir, 'status', '--porcelain']);
     if (status) {
       await gitExec(['-C', cloneDir, 'add', '-A']);
-      await gitExec(['-C', cloneDir, 'commit', '-m', `bm: update ${name} memories`]);
+      await gitExec(['-C', cloneDir, 'commit', '-m', `bms: update ${name} memories`]);
       await gitExec(['-C', cloneDir, 'push']);
       didPush = true;
     }

package/src/config.mjs

@@ -2,14 +2,14 @@ import { readFile, writeFile, mkdir } from 'node:fs/promises';
 import { homedir } from 'node:os';
 import { join, dirname } from 'node:path';
 
-const DEFAULT_BASE_PATH = join(homedir(), '.botrun', 'bm');
+const DEFAULT_BASE_PATH = join(homedir(), '.botrun', 'bms');
 
 export function getBasePath() {
-  return process.env.BM_PATH || DEFAULT_BASE_PATH;
+  return process.env.BMS_PATH || DEFAULT_BASE_PATH;
 }
 
 export function getConfigPath() {
-  return process.env.BM_CONFIG || join(getBasePath(), 'config.json');
+  return process.env.BMS_CONFIG || join(getBasePath(), 'config.json');
 }
 
 export async function loadConfig(configPath = getConfigPath()) {