@zoebuildsai/trace 1.5.0

package/tests/v1.5/cli-v2.test.ts

@@ -0,0 +1,354 @@
+/**
+ * Trace CLI v2 Tests
+ * Pure Trace commands (no git references)
+ * All operations via "trace" command
+ */
+
+import { TraceCliv2 } from '../../src/cli-v2';
+
+describe('TraceCliv2 - Pure Trace CLI', () => {
+  let cli: TraceCliv2;
+
+  beforeEach(() => {
+    cli = new TraceCliv2();
+  });
+
+  describe('Command Validation', () => {
+    test('requires "trace" prefix', async () => {
+      const result = await cli.execute('commit -m "test"');
+      expect(result.success).toBe(false);
+      expect(result.message).toContain('trace');
+    });
+
+    test('rejects unknown commands', async () => {
+      const result = await cli.execute('trace unknown-cmd');
+      expect(result.success).toBe(false);
+      expect(result.message).toContain('unknown command');
+    });
+
+    test('provides help for missing command', async () => {
+      const result = await cli.execute('trace');
+      expect(result.success).toBe(false);
+      expect(result.message).toContain('command required');
+    });
+  });
+
+  describe('Core VCS Commands', () => {
+    test('trace init creates repository', async () => {
+      const result = await cli.execute('trace init /tmp/test-repo');
+      expect(result.success).toBe(true);
+      expect(result.message).toContain('Trace repository');
+    });
+
+    test('trace commit requires message', async () => {
+      const result = await cli.execute('trace commit');
+      expect(result.success).toBe(false);
+      expect(result.message).toContain('-m');
+    });
+
+    test('trace commit creates commit with message', async () => {
+      const result = await cli.execute('trace commit -m "initial commit"');
+      expect(result.success).toBe(true);
+      expect(result.message).toContain('Commit created');
+    });
+
+    test('trace log displays history', async () => {
+      const result = await cli.execute('trace log');
+      expect(result.success).toBe(true);
+      expect(result.message).toContain('Log');
+    });
+
+    test('trace push sends to remote', async () => {
+      const result = await cli.execute('trace push origin main');
+      expect(result.success).toBe(true);
+      expect(result.message).toContain('origin/main');
+    });
+
+    test('trace pull receives from remote', async () => {
+      const result = await cli.execute('trace pull origin main');
+      expect(result.success).toBe(true);
+      expect(result.message).toContain('origin/main');
+    });
+
+    test('trace push defaults to origin/main', async () => {
+      const result = await cli.execute('trace push');
+      expect(result.success).toBe(true);
+      expect(result.message).toContain('origin');
+    });
+  });
+
+  describe('Multi-Agent Commands', () => {
+    test('trace lock requires file', async () => {
+      const result = await cli.execute('trace lock');
+      expect(result.success).toBe(false);
+      expect(result.message).toContain('file');
+    });
+
+    test('trace lock acquires exclusive access', async () => {
+      const result = await cli.execute('trace lock src/main.ts');
+      expect(result.success).toBe(true);
+      expect(result.message).toContain('Locked');
+    });
+
+    test('trace unlock releases file', async () => {
+      const result = await cli.execute('trace unlock src/main.ts');
+      expect(result.success).toBe(true);
+      expect(result.message).toContain('Unlocked');
+    });
+
+    test('trace status shows repository state', async () => {
+      const result = await cli.execute('trace status');
+      expect(result.success).toBe(true);
+    });
+  });
+
+  describe('Advanced Commands', () => {
+    test('trace merge requires branch', async () => {
+      const result = await cli.execute('trace merge');
+      expect(result.success).toBe(false);
+      expect(result.message).toContain('branch');
+    });
+
+    test('trace merge accepts branch name', async () => {
+      const result = await cli.execute('trace merge feature-branch');
+      expect(result.success).toBe(true);
+      expect(result.message).toContain('Merged');
+    });
+
+    test('trace merge accepts merge strategy', async () => {
+      const result = await cli.execute('trace merge feature --strategy ours');
+      expect(result.success).toBe(true);
+      expect(result.message).toContain('ours');
+    });
+
+    test('trace branch lists branches', async () => {
+      const result = await cli.execute('trace branch list');
+      expect(result.success).toBe(true);
+    });
+
+    test('trace rebase requires target', async () => {
+      const result = await cli.execute('trace rebase');
+      expect(result.success).toBe(false);
+      expect(result.message).toContain('target');
+    });
+
+    test('trace rebase rebases onto branch', async () => {
+      const result = await cli.execute('trace rebase main');
+      expect(result.success).toBe(true);
+      expect(result.message).toContain('Rebase');
+    });
+
+    test('trace stash saves changes', async () => {
+      const result = await cli.execute('trace stash save');
+      expect(result.success).toBe(true);
+    });
+
+    test('trace cherry-pick requires commits', async () => {
+      const result = await cli.execute('trace cherry-pick');
+      expect(result.success).toBe(false);
+      expect(result.message).toContain('commit');
+    });
+
+    test('trace cherry-pick accepts commit hashes', async () => {
+      const result = await cli.execute('trace cherry-pick abc123 def456');
+      expect(result.success).toBe(true);
+      expect(result.message).toContain('2 commit');
+    });
+  });
+
+  describe('Coordination Commands', () => {
+    test('trace task manages agent tasks', async () => {
+      const result = await cli.execute('trace task register --agent agent-a --files src/main.ts');
+      expect(result.success).toBe(true);
+    });
+
+    test('trace collision-detect finds conflicts', async () => {
+      const result = await cli.execute('trace collision-detect --file src/main.ts');
+      expect(result.success).toBe(true);
+      expect(result.message.toLowerCase()).toContain('collision');
+    });
+
+    test('trace audit shows security trail', async () => {
+      const result = await cli.execute('trace audit --agent agent-a');
+      expect(result.success).toBe(true);
+      expect(result.message).toContain('Audit');
+    });
+
+    test('trace validate checks files', async () => {
+      const result = await cli.execute('trace validate --secure');
+      expect(result.success).toBe(true);
+      expect(result.message).toContain('Validation');
+    });
+  });
+
+  describe('Conflict Resolution Commands', () => {
+    test('trace resolve requires file', async () => {
+      const result = await cli.execute('trace resolve');
+      expect(result.success).toBe(false);
+      expect(result.message).toContain('file');
+    });
+
+    test('trace resolve opens conflict resolver', async () => {
+      const result = await cli.execute('trace resolve src/main.ts');
+      expect(result.success).toBe(true);
+      expect(result.message).toContain('Resolving');
+    });
+
+    test('trace resolve accepts merge strategy', async () => {
+      const result = await cli.execute('trace resolve src/main.ts --strategy ours');
+      expect(result.success).toBe(true);
+    });
+  });
+
+  describe('Help System', () => {
+    test('trace help shows all commands', async () => {
+      const result = await cli.execute('trace help');
+      expect(result.success).toBe(true);
+      expect(result.message).toContain('Available Commands');
+      expect(result.message).toContain('Core VCS');
+      expect(result.message).toContain('Multi-Agent');
+    });
+
+    test('trace help displays command categories', async () => {
+      const result = await cli.execute('trace help');
+      expect(result.success).toBe(true);
+      expect(result.message).toContain('Advanced');
+      expect(result.message).toContain('Coordination');
+    });
+
+    test('trace help <command> shows details', async () => {
+      const result = await cli.execute('trace help commit');
+      expect(result.success).toBe(true);
+      expect(result.message).toContain('commit');
+      expect(result.message).toContain('Usage');
+    });
+
+    test('help for unknown command fails gracefully', async () => {
+      const result = await cli.execute('trace help unknown');
+      expect(result.success).toBe(false);
+      expect(result.message).toContain('Unknown');
+    });
+  });
+
+  describe('Command Availability', () => {
+    test('all commands are registered', () => {
+      const commands = cli.getCommands();
+      expect(commands).toContain('init');
+      expect(commands).toContain('commit');
+      expect(commands).toContain('log');
+      expect(commands).toContain('push');
+      expect(commands).toContain('pull');
+      expect(commands).toContain('lock');
+      expect(commands).toContain('unlock');
+      expect(commands).toContain('merge');
+      expect(commands).toContain('branch');
+      expect(commands).toContain('rebase');
+      expect(commands).toContain('stash');
+      expect(commands).toContain('cherry-pick');
+      expect(commands).toContain('task');
+      expect(commands).toContain('collision-detect');
+      expect(commands).toContain('audit');
+      expect(commands).toContain('validate');
+      expect(commands).toContain('resolve');
+    });
+
+    test('command count matches expected', () => {
+      const commands = cli.getCommands();
+      expect(commands.length).toBeGreaterThanOrEqual(15);
+    });
+  });
+
+  describe('Real Usage Scenarios', () => {
+    test('agent workflow: init → lock → commit → unlock', async () => {
+      let result = await cli.execute('trace init');
+      expect(result.success).toBe(true);
+
+      result = await cli.execute('trace lock src/main.ts');
+      expect(result.success).toBe(true);
+
+      result = await cli.execute('trace commit -m "feature: add function"');
+      expect(result.success).toBe(true);
+
+      result = await cli.execute('trace unlock src/main.ts');
+      expect(result.success).toBe(true);
+    });
+
+    test('conflict resolution workflow', async () => {
+      let result = await cli.execute('trace resolve src/conflict.ts --strategy manual');
+      expect(result.success).toBe(true);
+
+      result = await cli.execute('trace commit -m "fix: resolved conflict"');
+      expect(result.success).toBe(true);
+
+      result = await cli.execute('trace push origin main');
+      expect(result.success).toBe(true);
+    });
+
+    test('parallel agent workflow', async () => {
+      // Agent A
+      let result = await cli.execute('trace lock src/api.ts');
+      expect(result.success).toBe(true);
+
+      // Agent B (would wait for A to unlock)
+      result = await cli.execute('trace lock src/utils.ts');
+      expect(result.success).toBe(true);
+
+      // Both commit
+      result = await cli.execute('trace commit -m "agent-a: api changes"');
+      expect(result.success).toBe(true);
+
+      result = await cli.execute('trace commit -m "agent-b: utils changes"');
+      expect(result.success).toBe(true);
+    });
+
+    test('merge workflow', async () => {
+      let result = await cli.execute('trace branch create feature');
+      expect(result.success).toBe(true);
+
+      result = await cli.execute('trace commit -m "feature work"');
+      expect(result.success).toBe(true);
+
+      result = await cli.execute('trace merge main --strategy auto');
+      expect(result.success).toBe(true);
+    });
+
+    test('advanced rebase workflow', async () => {
+      let result = await cli.execute('trace rebase main --interactive');
+      expect(result.success).toBe(true);
+
+      result = await cli.execute('trace cherry-pick abc123 def456');
+      expect(result.success).toBe(true);
+
+      result = await cli.execute('trace push origin main');
+      expect(result.success).toBe(true);
+    });
+  });
+
+  describe('Error Handling', () => {
+    test('gracefully handles invalid syntax', async () => {
+      const result = await cli.execute('trace commit -m');
+      // Either fails or handles missing argument
+      expect(result).toHaveProperty('success');
+      expect(result).toHaveProperty('message');
+    });
+
+    test('provides clear error messages', async () => {
+      const result = await cli.execute('trace invalid-command arg1 arg2');
+      expect(result.success).toBe(false);
+      expect(result.message).toBeTruthy();
+      expect(result.message.length).toBeGreaterThan(0);
+    });
+  });
+
+  describe('Command Case Sensitivity', () => {
+    test('commands are case-sensitive (lowercase)', async () => {
+      const result = await cli.execute('trace commit -m "test"');
+      expect(result.success).toBe(true);
+    });
+
+    test('uppercase commands should fail', async () => {
+      const result = await cli.execute('trace COMMIT -m "test"');
+      expect(result.success).toBe(false);
+    });
+  });
+});