@dalzoubi/dev-agents-sync 1.0.7 → 1.0.9

package/README.md

@@ -0,0 +1,89 @@
+# @dalzoubi/dev-agents-sync
+
+CLI for syncing managed dev-agent prompts from `dalzoubi/dev-agents` into consumer repositories for Claude Code and Cursor.
+
+## Install
+
+Run with `npx` from the root of the repo that should receive the agent files:
+
+```bash
+npx --yes @dalzoubi/dev-agents-sync@1 init --targets claude,cursor
+```
+
+The CLI requires Node.js 20 or newer.
+
+## Authentication
+
+The source repository is private, so the CLI needs a GitHub token that can read `dalzoubi/dev-agents`.
+
+Authentication is resolved in this order:
+
+1. `--token <token>`
+2. `GITHUB_TOKEN`
+3. `gh auth token`
+
+For local use, authenticate with the GitHub CLI:
+
+```bash
+gh auth login
+```
+
+For CI, set `GITHUB_TOKEN` or a repo secret such as `DEV_AGENTS_TOKEN`.
+
+## Quick Start
+
+Initialize a consumer repo:
+
+```bash
+npx --yes @dalzoubi/dev-agents-sync@1 init --targets claude
+```
+
+This writes managed files into `.claude/` and creates `.dev-agents-sync.json` with the resolved content version.
+Use `--targets cursor` or `--targets claude,cursor` to install Cursor project agents, rules, and slash commands into `.cursor/agents/`, `.cursor/rules/`, and `.cursor/commands/`.
+
+Update to the latest matching content version:
+
+```bash
+npx --yes @dalzoubi/dev-agents-sync@1 update
+```
+
+Check whether managed files are in sync:
+
+```bash
+npx --yes @dalzoubi/dev-agents-sync@1 check
+```
+
+Show the expected diff without writing files:
+
+```bash
+npx --yes @dalzoubi/dev-agents-sync@1 diff
+```
+
+Show lockfile status:
+
+```bash
+npx --yes @dalzoubi/dev-agents-sync@1 status
+```
+
+## Common Flags
+
+- `--targets claude,cursor` selects output targets. Use `claude`, `cursor`, or both.
+- `--range ^1` selects the content version range. The default is `^1`.
+- `--dry-run` prints the planned changes without writing files.
+- `--force` allows overwriting unmanaged file collisions.
+- `--token <token>` passes a GitHub token directly.
+
+## Safety
+
+Managed files include a marker:
+
+```html
+<!-- managed-by: dev-agents-sync vX.Y.Z -->
+```
+
+The CLI overwrites files with this marker. It refuses to overwrite unmarked files unless `--force` is provided.
+
+## License
+
+UNLICENSED. This package is proprietary and all rights are reserved.
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dalzoubi/dev-agents-sync",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "type": "module",
   "description": "CLI that syncs managed dev-agent prompts into consumer repos (.claude/ and/or .cursor/).",
   "license": "UNLICENSED",

package/tests/paths.test.mjs

@@ -99,6 +99,20 @@ describe('resolveConsumerPath', () => {
     assert.equal(result, expected);
   });
 
+  it('translates "cursor/agents/define.md" to .cursor/agents/define.md', () => {
+    const consumerRoot = '/some/repo';
+    const result = resolveConsumerPath(consumerRoot, 'cursor/agents/define.md');
+    const expected = path.join(consumerRoot, '.cursor', 'agents', 'define.md');
+    assert.equal(result, expected);
+  });
+
+  it('translates "cursor/commands/define.md" to .cursor/commands/define.md', () => {
+    const consumerRoot = '/some/repo';
+    const result = resolveConsumerPath(consumerRoot, 'cursor/commands/define.md');
+    const expected = path.join(consumerRoot, '.cursor', 'commands', 'define.md');
+    assert.equal(result, expected);
+  });
+
   it('works with a Windows-style absolute consumer root path', () => {
     // Simulate a Windows-style path
     const consumerRoot = 'C:\\Users\\developer\\projects\\my-app';

package/tests/writer-normalize.test.mjs

@@ -21,9 +21,13 @@ describe('normalizeFileMap — tolerance + visibility', () => {
     const out = normalizeFileMap({
       'claude/agents/define.md': 'A',
       'cursor/rules/x.mdc': 'B',
+      'cursor/commands/define.md': 'C',
+      'cursor/agents/define.md': 'D',
     });
     assert.equal(out['claude/agents/define.md'], 'A');
     assert.equal(out['cursor/rules/x.mdc'], 'B');
+    assert.equal(out['cursor/commands/define.md'], 'C');
+    assert.equal(out['cursor/agents/define.md'], 'D');
   });
 
   it('infers prefix for known un-prefixed first segments', () => {