@productbrain/cli 0.1.0-beta.7 → 0.1.0-beta.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (166) hide show
  1. package/README.md +84 -1
  2. package/dist/__tests__/capture.test.d.ts +2 -0
  3. package/dist/__tests__/capture.test.d.ts.map +1 -0
  4. package/dist/__tests__/capture.test.js +86 -0
  5. package/dist/__tests__/capture.test.js.map +1 -0
  6. package/dist/__tests__/constellation.test.d.ts +2 -0
  7. package/dist/__tests__/constellation.test.d.ts.map +1 -0
  8. package/dist/__tests__/constellation.test.js +260 -0
  9. package/dist/__tests__/constellation.test.js.map +1 -0
  10. package/dist/__tests__/fields.test.d.ts +2 -0
  11. package/dist/__tests__/fields.test.d.ts.map +1 -0
  12. package/dist/__tests__/fields.test.js +238 -0
  13. package/dist/__tests__/fields.test.js.map +1 -0
  14. package/dist/__tests__/handshake.test.d.ts +2 -0
  15. package/dist/__tests__/handshake.test.d.ts.map +1 -0
  16. package/dist/__tests__/handshake.test.js +187 -0
  17. package/dist/__tests__/handshake.test.js.map +1 -0
  18. package/dist/__tests__/relate.test.d.ts +2 -0
  19. package/dist/__tests__/relate.test.d.ts.map +1 -0
  20. package/dist/__tests__/relate.test.js +79 -0
  21. package/dist/__tests__/relate.test.js.map +1 -0
  22. package/dist/__tests__/repo-detect.test.d.ts +2 -0
  23. package/dist/__tests__/repo-detect.test.d.ts.map +1 -0
  24. package/dist/__tests__/repo-detect.test.js +119 -0
  25. package/dist/__tests__/repo-detect.test.js.map +1 -0
  26. package/dist/__tests__/runner.test.d.ts +2 -0
  27. package/dist/__tests__/runner.test.d.ts.map +1 -0
  28. package/dist/__tests__/runner.test.js +215 -0
  29. package/dist/__tests__/runner.test.js.map +1 -0
  30. package/dist/__tests__/session-touch.test.d.ts +2 -0
  31. package/dist/__tests__/session-touch.test.d.ts.map +1 -0
  32. package/dist/__tests__/session-touch.test.js +134 -0
  33. package/dist/__tests__/session-touch.test.js.map +1 -0
  34. package/dist/__tests__/session.test.d.ts +2 -0
  35. package/dist/__tests__/session.test.d.ts.map +1 -0
  36. package/dist/__tests__/session.test.js +52 -0
  37. package/dist/__tests__/session.test.js.map +1 -0
  38. package/dist/__tests__/strip.test.d.ts +2 -0
  39. package/dist/__tests__/strip.test.d.ts.map +1 -0
  40. package/dist/__tests__/strip.test.js +136 -0
  41. package/dist/__tests__/strip.test.js.map +1 -0
  42. package/dist/__tests__/update.test.d.ts +2 -0
  43. package/dist/__tests__/update.test.d.ts.map +1 -0
  44. package/dist/__tests__/update.test.js +148 -0
  45. package/dist/__tests__/update.test.js.map +1 -0
  46. package/dist/commands/capture.d.ts +21 -0
  47. package/dist/commands/capture.d.ts.map +1 -0
  48. package/dist/commands/capture.js +100 -0
  49. package/dist/commands/capture.js.map +1 -0
  50. package/dist/commands/constellation.d.ts +11 -0
  51. package/dist/commands/constellation.d.ts.map +1 -0
  52. package/dist/commands/constellation.js +28 -0
  53. package/dist/commands/constellation.js.map +1 -0
  54. package/dist/commands/context.d.ts +2 -1
  55. package/dist/commands/context.d.ts.map +1 -1
  56. package/dist/commands/context.js +15 -9
  57. package/dist/commands/context.js.map +1 -1
  58. package/dist/commands/fields.d.ts +9 -0
  59. package/dist/commands/fields.d.ts.map +1 -0
  60. package/dist/commands/fields.js +26 -0
  61. package/dist/commands/fields.js.map +1 -0
  62. package/dist/commands/get.d.ts +8 -1
  63. package/dist/commands/get.d.ts.map +1 -1
  64. package/dist/commands/get.js +51 -6
  65. package/dist/commands/get.js.map +1 -1
  66. package/dist/commands/handshake.d.ts +18 -0
  67. package/dist/commands/handshake.d.ts.map +1 -0
  68. package/dist/commands/handshake.js +378 -0
  69. package/dist/commands/handshake.js.map +1 -0
  70. package/dist/commands/ingest.d.ts +1 -0
  71. package/dist/commands/ingest.d.ts.map +1 -1
  72. package/dist/commands/ingest.js +25 -8
  73. package/dist/commands/ingest.js.map +1 -1
  74. package/dist/commands/orient.d.ts +1 -0
  75. package/dist/commands/orient.d.ts.map +1 -1
  76. package/dist/commands/orient.js +13 -8
  77. package/dist/commands/orient.js.map +1 -1
  78. package/dist/commands/relate.d.ts +15 -0
  79. package/dist/commands/relate.d.ts.map +1 -0
  80. package/dist/commands/relate.js +72 -0
  81. package/dist/commands/relate.js.map +1 -0
  82. package/dist/commands/search.d.ts +1 -0
  83. package/dist/commands/search.d.ts.map +1 -1
  84. package/dist/commands/search.js +5 -3
  85. package/dist/commands/search.js.map +1 -1
  86. package/dist/commands/session.d.ts +20 -0
  87. package/dist/commands/session.d.ts.map +1 -0
  88. package/dist/commands/session.js +134 -0
  89. package/dist/commands/session.js.map +1 -0
  90. package/dist/commands/update.d.ts +16 -0
  91. package/dist/commands/update.d.ts.map +1 -0
  92. package/dist/commands/update.js +89 -0
  93. package/dist/commands/update.js.map +1 -0
  94. package/dist/formatters/capture.d.ts +30 -0
  95. package/dist/formatters/capture.d.ts.map +1 -0
  96. package/dist/formatters/capture.js +58 -0
  97. package/dist/formatters/capture.js.map +1 -0
  98. package/dist/formatters/constellation.d.ts +34 -0
  99. package/dist/formatters/constellation.d.ts.map +1 -0
  100. package/dist/formatters/constellation.js +38 -0
  101. package/dist/formatters/constellation.js.map +1 -0
  102. package/dist/formatters/fields.d.ts +32 -0
  103. package/dist/formatters/fields.d.ts.map +1 -0
  104. package/dist/formatters/fields.js +49 -0
  105. package/dist/formatters/fields.js.map +1 -0
  106. package/dist/formatters/handshake.d.ts +17 -0
  107. package/dist/formatters/handshake.d.ts.map +1 -0
  108. package/dist/formatters/handshake.js +51 -0
  109. package/dist/formatters/handshake.js.map +1 -0
  110. package/dist/formatters/relate.d.ts +11 -0
  111. package/dist/formatters/relate.d.ts.map +1 -0
  112. package/dist/formatters/relate.js +10 -0
  113. package/dist/formatters/relate.js.map +1 -0
  114. package/dist/formatters/session.d.ts +11 -0
  115. package/dist/formatters/session.d.ts.map +1 -0
  116. package/dist/formatters/session.js +51 -0
  117. package/dist/formatters/session.js.map +1 -0
  118. package/dist/formatters/update.d.ts +17 -0
  119. package/dist/formatters/update.d.ts.map +1 -0
  120. package/dist/formatters/update.js +43 -0
  121. package/dist/formatters/update.js.map +1 -0
  122. package/dist/generators/adapters.d.ts +10 -0
  123. package/dist/generators/adapters.d.ts.map +1 -0
  124. package/dist/generators/adapters.js +102 -0
  125. package/dist/generators/adapters.js.map +1 -0
  126. package/dist/generators/briefing-md.d.ts +8 -0
  127. package/dist/generators/briefing-md.d.ts.map +1 -0
  128. package/dist/generators/briefing-md.js +51 -0
  129. package/dist/generators/briefing-md.js.map +1 -0
  130. package/dist/generators/context-md.d.ts +8 -0
  131. package/dist/generators/context-md.d.ts.map +1 -0
  132. package/dist/generators/context-md.js +123 -0
  133. package/dist/generators/context-md.js.map +1 -0
  134. package/dist/generators/portable-knowledge.d.ts +72 -0
  135. package/dist/generators/portable-knowledge.d.ts.map +1 -0
  136. package/dist/generators/portable-knowledge.js +246 -0
  137. package/dist/generators/portable-knowledge.js.map +1 -0
  138. package/dist/generators/portable-knowledge.test.d.ts +2 -0
  139. package/dist/generators/portable-knowledge.test.d.ts.map +1 -0
  140. package/dist/generators/portable-knowledge.test.js +399 -0
  141. package/dist/generators/portable-knowledge.test.js.map +1 -0
  142. package/dist/index.d.ts +3 -2
  143. package/dist/index.d.ts.map +1 -1
  144. package/dist/index.js +231 -6
  145. package/dist/index.js.map +1 -1
  146. package/dist/lib/client.d.ts +19 -0
  147. package/dist/lib/client.d.ts.map +1 -1
  148. package/dist/lib/client.js +102 -8
  149. package/dist/lib/client.js.map +1 -1
  150. package/dist/lib/repo-detect.d.ts +14 -0
  151. package/dist/lib/repo-detect.d.ts.map +1 -0
  152. package/dist/lib/repo-detect.js +58 -0
  153. package/dist/lib/repo-detect.js.map +1 -0
  154. package/dist/lib/runner.d.ts +31 -0
  155. package/dist/lib/runner.d.ts.map +1 -0
  156. package/dist/lib/runner.js +65 -0
  157. package/dist/lib/runner.js.map +1 -0
  158. package/dist/lib/session.d.ts +17 -0
  159. package/dist/lib/session.d.ts.map +1 -0
  160. package/dist/lib/session.js +43 -0
  161. package/dist/lib/session.js.map +1 -0
  162. package/dist/lib/strip.d.ts +11 -0
  163. package/dist/lib/strip.d.ts.map +1 -0
  164. package/dist/lib/strip.js +26 -0
  165. package/dist/lib/strip.js.map +1 -0
  166. package/package.json +6 -3
@@ -0,0 +1,119 @@
1
+ /**
2
+ * repo-detect — filesystem-based repo detection.
3
+ * Tests cover: package.json parsing, git remote extraction, stack detection, fallbacks.
4
+ */
5
+ import { beforeEach, describe, expect, it, vi } from 'vitest';
6
+ import { detectRepo } from '../lib/repo-detect.js';
7
+ // Mock fs and child_process so tests don't touch the real filesystem.
8
+ const existsSyncMock = vi.fn();
9
+ const readFileSyncMock = vi.fn();
10
+ const execSyncMock = vi.fn();
11
+ vi.mock('fs', () => ({
12
+ existsSync: (path) => existsSyncMock(path),
13
+ readFileSync: (path, encoding) => readFileSyncMock(path, encoding),
14
+ }));
15
+ vi.mock('child_process', () => ({
16
+ execSync: (cmd, opts) => execSyncMock(cmd, opts),
17
+ }));
18
+ describe('detectRepo', () => {
19
+ beforeEach(() => {
20
+ existsSyncMock.mockReset();
21
+ readFileSyncMock.mockReset();
22
+ execSyncMock.mockReset();
23
+ });
24
+ it('strips @scope/ prefix from package.json name', () => {
25
+ existsSyncMock.mockImplementation((p) => String(p).endsWith('package.json'));
26
+ readFileSyncMock.mockReturnValue(JSON.stringify({ name: '@scope/my-app', description: 'A test app' }));
27
+ execSyncMock.mockImplementation(() => { throw new Error('no git'); });
28
+ const result = detectRepo('/fake/dir');
29
+ // Verify scope stripping logic — '@scope/my-app' → 'my-app'
30
+ expect(result.name).toBe('my-app');
31
+ expect(result.description).toBe('A test app');
32
+ // Verify existsSync was called with the resolved package.json path
33
+ expect(existsSyncMock).toHaveBeenCalledWith(expect.stringContaining('package.json'));
34
+ expect(readFileSyncMock).toHaveBeenCalledWith(expect.stringContaining('package.json'), 'utf8');
35
+ });
36
+ it('preserves unscoped package name as-is', () => {
37
+ existsSyncMock.mockImplementation((p) => String(p).endsWith('package.json'));
38
+ readFileSyncMock.mockReturnValue(JSON.stringify({ name: 'plain-name' }));
39
+ execSyncMock.mockImplementation(() => { throw new Error('no git'); });
40
+ const result = detectRepo('/fake/dir');
41
+ expect(result.name).toBe('plain-name');
42
+ });
43
+ it('extracts repoSlug from HTTPS git remote', () => {
44
+ existsSyncMock.mockReturnValue(false);
45
+ execSyncMock.mockReturnValue('https://github.com/acme/my-repo.git\n');
46
+ const result = detectRepo('/fake/dir');
47
+ expect(result.gitRemote).toBe('https://github.com/acme/my-repo.git');
48
+ expect(result.repoSlug).toBe('acme/my-repo');
49
+ });
50
+ it('extracts repoSlug from SSH git remote', () => {
51
+ existsSyncMock.mockReturnValue(false);
52
+ execSyncMock.mockReturnValue('git@github.com:acme/my-repo.git\n');
53
+ const result = detectRepo('/fake/dir');
54
+ expect(result.repoSlug).toBe('acme/my-repo');
55
+ });
56
+ it('detects stack technologies from marker files', () => {
57
+ const markerFiles = new Set([
58
+ '/fake/dir/svelte.config.ts',
59
+ '/fake/dir/tsconfig.json',
60
+ '/fake/dir/vite.config.ts',
61
+ ]);
62
+ existsSyncMock.mockImplementation((p) => markerFiles.has(String(p)));
63
+ execSyncMock.mockImplementation(() => { throw new Error('no git'); });
64
+ const result = detectRepo('/fake/dir');
65
+ expect(result.detectedStack).toContain('sveltekit');
66
+ expect(result.detectedStack).toContain('typescript');
67
+ expect(result.detectedStack).toContain('vite');
68
+ expect(result.detectedStack).not.toContain('nextjs');
69
+ });
70
+ it('detects monorepo from workspaces field', () => {
71
+ existsSyncMock.mockImplementation((p) => String(p).endsWith('package.json'));
72
+ readFileSyncMock.mockReturnValue(JSON.stringify({ name: 'mono', workspaces: ['packages/*'] }));
73
+ execSyncMock.mockImplementation(() => { throw new Error('no git'); });
74
+ const result = detectRepo('/fake/dir');
75
+ expect(result.isMonorepo).toBe(true);
76
+ });
77
+ it('falls back to directory basename when no package.json name', () => {
78
+ existsSyncMock.mockReturnValue(false);
79
+ execSyncMock.mockImplementation(() => { throw new Error('no git'); });
80
+ const result = detectRepo('/fake/my-project');
81
+ expect(result.name).toBe('my-project');
82
+ });
83
+ it('handles malformed package.json gracefully', () => {
84
+ existsSyncMock.mockImplementation((p) => String(p).endsWith('package.json'));
85
+ readFileSyncMock.mockReturnValue('not valid json {{{');
86
+ execSyncMock.mockImplementation(() => { throw new Error('no git'); });
87
+ const result = detectRepo('/fake/dir');
88
+ // Should not throw, falls back to directory name
89
+ expect(result.name).toBe('dir');
90
+ expect(result.description).toBeNull();
91
+ });
92
+ it('returns empty detectedStack when no marker files exist', () => {
93
+ existsSyncMock.mockReturnValue(false);
94
+ execSyncMock.mockImplementation(() => { throw new Error('no git'); });
95
+ const result = detectRepo('/fake/dir');
96
+ expect(result.detectedStack).toEqual([]);
97
+ });
98
+ it('handles git remote without .git suffix', () => {
99
+ existsSyncMock.mockReturnValue(false);
100
+ execSyncMock.mockReturnValue('https://github.com/acme/my-repo\n');
101
+ const result = detectRepo('/fake/dir');
102
+ expect(result.repoSlug).toBe('acme/my-repo');
103
+ });
104
+ it('returns null repoSlug for malformed git remote URL', () => {
105
+ existsSyncMock.mockReturnValue(false);
106
+ execSyncMock.mockReturnValue('not-a-url\n');
107
+ const result = detectRepo('/fake/dir');
108
+ expect(result.gitRemote).toBe('not-a-url');
109
+ expect(result.repoSlug).toBeNull();
110
+ });
111
+ it('sets isMonorepo false when workspaces field is absent', () => {
112
+ existsSyncMock.mockImplementation((p) => String(p).endsWith('package.json'));
113
+ readFileSyncMock.mockReturnValue(JSON.stringify({ name: 'single-pkg' }));
114
+ execSyncMock.mockImplementation(() => { throw new Error('no git'); });
115
+ const result = detectRepo('/fake/dir');
116
+ expect(result.isMonorepo).toBe(false);
117
+ });
118
+ });
119
+ //# sourceMappingURL=repo-detect.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"repo-detect.test.js","sourceRoot":"","sources":["../../src/__tests__/repo-detect.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=runner.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"runner.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/runner.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,215 @@
1
+ /**
2
+ * runCliCommand — unit tests.
3
+ * BET-181 Slice 0: DEC-299 (JSON-default), STD-65 (structured agent responses).
4
+ *
5
+ * Verifies:
6
+ * - Non-TTY (isTTY=false): JSON output with internals stripped
7
+ * - TTY (isTTY=true): human-readable output via formatPretty
8
+ * - --json flag (outputMode=json): forces JSON regardless of TTY
9
+ * - --pretty flag (outputMode=pretty): forces human output regardless of TTY
10
+ * - stripConvexInternals is applied in JSON mode
11
+ * - Error handling: JSON error in JSON mode, plain message in pretty mode
12
+ */
13
+ import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
14
+ import { runCliCommand, setOutputMode, isJsonMode } from '../lib/runner.js';
15
+ // Capture stdout/stderr writes
16
+ let stdoutOutput;
17
+ let stderrOutput;
18
+ let stdoutWriteSpy;
19
+ let stderrWriteSpy;
20
+ let exitSpy;
21
+ beforeEach(() => {
22
+ stdoutOutput = '';
23
+ stderrOutput = '';
24
+ stdoutWriteSpy = vi.spyOn(process.stdout, 'write').mockImplementation((chunk) => {
25
+ stdoutOutput += String(chunk);
26
+ return true;
27
+ });
28
+ stderrWriteSpy = vi.spyOn(process.stderr, 'write').mockImplementation((chunk) => {
29
+ stderrOutput += String(chunk);
30
+ return true;
31
+ });
32
+ exitSpy = vi.spyOn(process, 'exit').mockImplementation(() => { throw new Error('process.exit'); });
33
+ // Reset to auto mode before each test
34
+ setOutputMode('auto');
35
+ });
36
+ afterEach(() => {
37
+ stdoutWriteSpy.mockRestore();
38
+ stderrWriteSpy.mockRestore();
39
+ exitSpy.mockRestore();
40
+ setOutputMode('auto');
41
+ });
42
+ // Helper to simulate TTY state
43
+ function withTty(isTty, fn) {
44
+ return async () => {
45
+ const original = process.stdout.isTTY;
46
+ Object.defineProperty(process.stdout, 'isTTY', { value: isTty, configurable: true, writable: true });
47
+ try {
48
+ await fn();
49
+ }
50
+ finally {
51
+ Object.defineProperty(process.stdout, 'isTTY', { value: original, configurable: true, writable: true });
52
+ }
53
+ };
54
+ }
55
+ describe('isJsonMode', () => {
56
+ it('returns true when outputMode is json', () => {
57
+ setOutputMode('json');
58
+ expect(isJsonMode()).toBe(true);
59
+ });
60
+ it('returns false when outputMode is pretty', () => {
61
+ setOutputMode('pretty');
62
+ expect(isJsonMode()).toBe(false);
63
+ });
64
+ it('returns true in auto mode when stdout is not a TTY (piped)', withTty(false, () => {
65
+ setOutputMode('auto');
66
+ expect(isJsonMode()).toBe(true);
67
+ }));
68
+ it('returns false in auto mode when stdout is a TTY', withTty(true, () => {
69
+ setOutputMode('auto');
70
+ expect(isJsonMode()).toBe(false);
71
+ }));
72
+ });
73
+ describe('runCliCommand — JSON mode (non-TTY)', () => {
74
+ it('outputs JSON to stdout when isTTY is false', withTty(false, async () => {
75
+ setOutputMode('auto');
76
+ await runCliCommand({
77
+ fn: async () => ({ entryId: 'BET-181', name: 'Test' }),
78
+ formatPretty: () => 'Human output',
79
+ });
80
+ const parsed = JSON.parse(stdoutOutput);
81
+ expect(parsed).toHaveProperty('entryId', 'BET-181');
82
+ expect(parsed).toHaveProperty('name', 'Test');
83
+ }));
84
+ it('strips _id and _creationTime in JSON mode', withTty(false, async () => {
85
+ setOutputMode('auto');
86
+ await runCliCommand({
87
+ fn: async () => ({ _id: 'sys123', _creationTime: 999999, entryId: 'BET-181', name: 'Test' }),
88
+ formatPretty: () => 'Human output',
89
+ });
90
+ const parsed = JSON.parse(stdoutOutput);
91
+ expect(parsed).not.toHaveProperty('_id');
92
+ expect(parsed).not.toHaveProperty('_creationTime');
93
+ expect(parsed).toHaveProperty('entryId', 'BET-181');
94
+ }));
95
+ it('does NOT call formatPretty in JSON mode', withTty(false, async () => {
96
+ const formatPretty = vi.fn(() => 'should not be called');
97
+ setOutputMode('auto');
98
+ await runCliCommand({
99
+ fn: async () => ({ entryId: 'BET-181' }),
100
+ formatPretty,
101
+ });
102
+ expect(formatPretty).not.toHaveBeenCalled();
103
+ }));
104
+ it('strips internals recursively from nested objects', withTty(false, async () => {
105
+ setOutputMode('auto');
106
+ await runCliCommand({
107
+ fn: async () => ({
108
+ entryId: 'BET-181',
109
+ relations: [{ _id: 'rel1', type: 'part_of' }],
110
+ }),
111
+ formatPretty: () => '',
112
+ });
113
+ const parsed = JSON.parse(stdoutOutput);
114
+ expect(parsed.relations[0]).not.toHaveProperty('_id');
115
+ expect(parsed.relations[0]).toHaveProperty('type', 'part_of');
116
+ }));
117
+ });
118
+ describe('runCliCommand — pretty mode (TTY)', () => {
119
+ it('calls formatPretty and outputs result when isTTY is true', withTty(true, async () => {
120
+ setOutputMode('auto');
121
+ await runCliCommand({
122
+ fn: async () => ({ entryId: 'BET-181', name: 'Test' }),
123
+ formatPretty: (data) => `Entry: ${data.entryId} — ${data.name}`,
124
+ });
125
+ expect(stdoutOutput).toContain('Entry: BET-181 — Test');
126
+ }));
127
+ it('does NOT output JSON in TTY mode', withTty(true, async () => {
128
+ setOutputMode('auto');
129
+ await runCliCommand({
130
+ fn: async () => ({ entryId: 'BET-181' }),
131
+ formatPretty: () => 'Human output here',
132
+ });
133
+ expect(stdoutOutput).not.toContain('"entryId"');
134
+ expect(stdoutOutput).toContain('Human output here');
135
+ }));
136
+ });
137
+ describe('runCliCommand — --json flag override', () => {
138
+ it('outputs JSON even when isTTY is true', withTty(true, async () => {
139
+ setOutputMode('json');
140
+ await runCliCommand({
141
+ fn: async () => ({ entryId: 'BET-181', name: 'Test' }),
142
+ formatPretty: () => 'Should not appear',
143
+ });
144
+ const parsed = JSON.parse(stdoutOutput);
145
+ expect(parsed).toHaveProperty('entryId', 'BET-181');
146
+ expect(stdoutOutput).not.toContain('Should not appear');
147
+ }));
148
+ it('strips Convex internals when --json forced in TTY', withTty(true, async () => {
149
+ setOutputMode('json');
150
+ await runCliCommand({
151
+ fn: async () => ({ _id: 'sys1', _creationTime: 123, entryId: 'BET-181' }),
152
+ formatPretty: () => '',
153
+ });
154
+ const parsed = JSON.parse(stdoutOutput);
155
+ expect(parsed).not.toHaveProperty('_id');
156
+ expect(parsed).not.toHaveProperty('_creationTime');
157
+ expect(parsed).toHaveProperty('entryId', 'BET-181');
158
+ }));
159
+ });
160
+ describe('runCliCommand — --pretty flag override', () => {
161
+ it('outputs human text even when isTTY is false', withTty(false, async () => {
162
+ setOutputMode('pretty');
163
+ await runCliCommand({
164
+ fn: async () => ({ entryId: 'BET-181', name: 'Test' }),
165
+ formatPretty: (data) => `Pretty: ${data.entryId}`,
166
+ });
167
+ expect(stdoutOutput).toContain('Pretty: BET-181');
168
+ expect(stdoutOutput).not.toContain('"entryId"');
169
+ }));
170
+ });
171
+ describe('runCliCommand — error handling', () => {
172
+ it('outputs JSON error to stderr and exits 1 in JSON mode', withTty(false, async () => {
173
+ setOutputMode('auto');
174
+ await expect(runCliCommand({
175
+ fn: async () => { throw new Error('Entry not found'); },
176
+ formatPretty: () => '',
177
+ })).rejects.toThrow('process.exit');
178
+ expect(exitSpy).toHaveBeenCalledWith(1);
179
+ const errParsed = JSON.parse(stderrOutput);
180
+ expect(errParsed).toHaveProperty('error', 'Entry not found');
181
+ }));
182
+ it('outputs plain error to stderr and exits 1 in pretty mode', withTty(true, async () => {
183
+ setOutputMode('auto');
184
+ await expect(runCliCommand({
185
+ fn: async () => { throw new Error('Something went wrong'); },
186
+ formatPretty: () => '',
187
+ })).rejects.toThrow('process.exit');
188
+ expect(exitSpy).toHaveBeenCalledWith(1);
189
+ expect(stderrOutput).toContain('Something went wrong');
190
+ // Should NOT be JSON
191
+ expect(() => JSON.parse(stderrOutput)).toThrow();
192
+ }));
193
+ it('handles non-Error throws in JSON mode', withTty(false, async () => {
194
+ setOutputMode('auto');
195
+ await expect(runCliCommand({
196
+ fn: async () => { throw 'string error'; }, // eslint-disable-line no-throw-literal
197
+ formatPretty: () => '',
198
+ })).rejects.toThrow('process.exit');
199
+ const errParsed = JSON.parse(stderrOutput);
200
+ expect(errParsed).toHaveProperty('error', 'string error');
201
+ }));
202
+ });
203
+ describe('setOutputMode / getOutputMode', () => {
204
+ it('can be set to json, pretty, and auto', () => {
205
+ setOutputMode('json');
206
+ expect(isJsonMode()).toBe(true);
207
+ setOutputMode('pretty');
208
+ expect(isJsonMode()).toBe(false);
209
+ // auto with non-TTY
210
+ Object.defineProperty(process.stdout, 'isTTY', { value: false, configurable: true, writable: true });
211
+ setOutputMode('auto');
212
+ expect(isJsonMode()).toBe(true);
213
+ });
214
+ });
215
+ //# sourceMappingURL=runner.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"runner.test.js","sourceRoot":"","sources":["../../src/__tests__/runner.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=session-touch.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"session-touch.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/session-touch.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,134 @@
1
+ /**
2
+ * session-touch — verify mcpCallWithSession auto-renews the session TTL.
3
+ * BET-181 Slice 1: Session Auto-Renew on Write.
4
+ *
5
+ * Done-when criteria tested:
6
+ * 1. After a successful mcpCallWithSession, agent.touchSession is called with the current session ID
7
+ * 2. Touch happens in exactly ONE place (mcpCallWithSession) — not per-command
8
+ * 3. Touch is fire-and-forget (does not block the write response)
9
+ * 4. When no session is active (session.json absent), no touch is attempted
10
+ * 5. When mcpCallWithSession fails (write error), touch is NOT called
11
+ */
12
+ import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
13
+ // We need to control what readSession() returns per test.
14
+ let mockSession = null;
15
+ vi.mock('../lib/session.js', () => ({
16
+ readSession: () => mockSession,
17
+ }));
18
+ vi.mock('../lib/config.js', () => ({
19
+ getConfig: vi.fn(() => ({ apiKey: 'pb_sk_test', siteUrl: 'https://test.convex.site' })),
20
+ }));
21
+ // Import the module under test AFTER setting up mocks.
22
+ import { mcpCallWithSession } from '../lib/client.js';
23
+ // Helper: build a fetch mock that returns different responses based on `fn`.
24
+ function makeFetch({ writeOk = true, writeData = { ok: true }, } = {}) {
25
+ return vi.fn(async (_input, init) => {
26
+ const body = JSON.parse(String(init?.body ?? '{}'));
27
+ if (body.fn === 'agent.touchSession') {
28
+ return {
29
+ ok: true,
30
+ json: async () => ({ data: {} }),
31
+ };
32
+ }
33
+ // Default: the write call
34
+ return {
35
+ ok: writeOk,
36
+ statusText: writeOk ? 'OK' : 'Internal Server Error',
37
+ json: async () => (writeOk ? { data: writeData } : { error: 'Server error' }),
38
+ };
39
+ });
40
+ }
41
+ async function flushMicrotasks() {
42
+ // Two rounds of microtask flushing to allow the fire-and-forget .catch chain to settle.
43
+ await Promise.resolve();
44
+ await Promise.resolve();
45
+ }
46
+ describe('mcpCallWithSession — session touch on write', () => {
47
+ beforeEach(() => {
48
+ vi.clearAllMocks();
49
+ mockSession = {
50
+ sessionId: 'sess-abc123',
51
+ workspaceId: 'ws-1',
52
+ workspaceName: 'Product Brain',
53
+ startedAt: '2026-03-23T12:00:00Z',
54
+ entriesCaptured: [],
55
+ };
56
+ });
57
+ afterEach(() => {
58
+ vi.restoreAllMocks();
59
+ });
60
+ it('calls agent.touchSession with the current session ID after a successful write', async () => {
61
+ global.fetch = makeFetch({ writeOk: true, writeData: { entryId: 'BET-181' } });
62
+ await mcpCallWithSession('chain.updateEntry', { entryId: 'BET-181', name: 'New name' });
63
+ await flushMicrotasks();
64
+ const calls = global.fetch.mock.calls;
65
+ // Expect exactly 2 fetch calls: the write + the touch
66
+ expect(calls).toHaveLength(2);
67
+ // First call: the actual write
68
+ const writeBody = JSON.parse(String(calls[0][1]?.body ?? '{}'));
69
+ expect(writeBody.fn).toBe('chain.updateEntry');
70
+ // Second call: the touch
71
+ const touchBody = JSON.parse(String(calls[1][1]?.body ?? '{}'));
72
+ expect(touchBody.fn).toBe('agent.touchSession');
73
+ expect(touchBody.args.sessionId).toBe('sess-abc123');
74
+ });
75
+ it('does NOT call agent.touchSession when no session is active', async () => {
76
+ mockSession = null;
77
+ global.fetch = makeFetch({ writeOk: true });
78
+ await mcpCallWithSession('chain.updateEntry', { entryId: 'BET-100' });
79
+ await flushMicrotasks();
80
+ const calls = global.fetch.mock.calls;
81
+ // Only the write call — no touch
82
+ expect(calls).toHaveLength(1);
83
+ const body = JSON.parse(String(calls[0][1]?.body ?? '{}'));
84
+ expect(body.fn).toBe('chain.updateEntry');
85
+ });
86
+ it('does NOT call agent.touchSession when the write fails', async () => {
87
+ global.fetch = makeFetch({ writeOk: false });
88
+ await expect(mcpCallWithSession('chain.updateEntry', { entryId: 'BET-100' })).rejects.toThrow('Server error');
89
+ await flushMicrotasks();
90
+ const calls = global.fetch.mock.calls;
91
+ // Only the write call — no touch because write threw
92
+ expect(calls).toHaveLength(1);
93
+ const body = JSON.parse(String(calls[0][1]?.body ?? '{}'));
94
+ expect(body.fn).toBe('chain.updateEntry');
95
+ });
96
+ it('touch errors are silently swallowed — write result is returned regardless', async () => {
97
+ // Touch call throws a network error
98
+ global.fetch = vi.fn(async (_input, init) => {
99
+ const body = JSON.parse(String(init?.body ?? '{}'));
100
+ if (body.fn === 'agent.touchSession') {
101
+ throw new Error('Network error');
102
+ }
103
+ return {
104
+ ok: true,
105
+ json: async () => ({ data: { entryId: 'BET-181' } }),
106
+ };
107
+ });
108
+ // Should resolve successfully despite touch throwing
109
+ const result = await mcpCallWithSession('chain.updateEntry', { entryId: 'BET-181' });
110
+ await flushMicrotasks();
111
+ expect(result).toEqual({ entryId: 'BET-181' });
112
+ });
113
+ it('touch is non-blocking — write resolves before touch completes', async () => {
114
+ const order = [];
115
+ global.fetch = vi.fn(async (_input, init) => {
116
+ const body = JSON.parse(String(init?.body ?? '{}'));
117
+ if (body.fn === 'agent.touchSession') {
118
+ // Simulate a slow touch
119
+ await new Promise((resolve) => setTimeout(resolve, 10));
120
+ order.push('touch-complete');
121
+ return { ok: true, json: async () => ({ data: {} }) };
122
+ }
123
+ order.push('write-complete');
124
+ return { ok: true, json: async () => ({ data: { entryId: 'BET-181' } }) };
125
+ });
126
+ await mcpCallWithSession('chain.updateEntry', { entryId: 'BET-181' });
127
+ // Write has resolved — touch has NOT yet completed (it's still pending)
128
+ expect(order).toEqual(['write-complete']);
129
+ // After waiting for the touch to finish
130
+ await new Promise((resolve) => setTimeout(resolve, 20));
131
+ expect(order).toEqual(['write-complete', 'touch-complete']);
132
+ });
133
+ });
134
+ //# sourceMappingURL=session-touch.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"session-touch.test.js","sourceRoot":"","sources":["../../src/__tests__/session-touch.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=session.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"session.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/session.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,52 @@
1
+ /**
2
+ * pb session id — verify local session read behavior.
3
+ * TEN-341 test contract: has session → prints ID, no session → exits 1.
4
+ */
5
+ import { beforeEach, describe, expect, it, vi } from 'vitest';
6
+ import { runSessionId } from '../commands/session.js';
7
+ vi.mock('../lib/client.js', () => ({
8
+ mcpCall: vi.fn(),
9
+ mcpCallWithSession: vi.fn(),
10
+ }));
11
+ vi.mock('../lib/config.js', () => ({
12
+ getConfigOrGuide: vi.fn(() => Promise.resolve({ apiKey: 'pb_sk_test', siteUrl: 'https://test.convex.site' })),
13
+ }));
14
+ let mockSession = null;
15
+ vi.mock('../lib/session.js', () => ({
16
+ readSession: () => mockSession,
17
+ writeSession: vi.fn(),
18
+ clearSession: vi.fn(),
19
+ addCapturedEntry: vi.fn(),
20
+ }));
21
+ vi.mock('./handshake.js', () => ({
22
+ runHandshake: vi.fn(),
23
+ }));
24
+ describe('runSessionId', () => {
25
+ beforeEach(() => {
26
+ vi.clearAllMocks();
27
+ });
28
+ it('prints session ID bare to stdout when session exists', () => {
29
+ mockSession = {
30
+ sessionId: 'rd79ppnrs9k8d4vtak39pzfmex8378f3',
31
+ workspaceId: 'ws-1',
32
+ workspaceName: 'Product Brain',
33
+ startedAt: '2026-03-19T12:00:00Z',
34
+ entriesCaptured: [],
35
+ };
36
+ const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
37
+ runSessionId();
38
+ expect(writeSpy).toHaveBeenCalledWith('rd79ppnrs9k8d4vtak39pzfmex8378f3\n');
39
+ writeSpy.mockRestore();
40
+ });
41
+ it('exits 1 and writes to stderr when no session', () => {
42
+ mockSession = null;
43
+ const exitSpy = vi.spyOn(process, 'exit').mockImplementation(() => { throw new Error('exit'); });
44
+ const stderrSpy = vi.spyOn(process.stderr, 'write').mockImplementation(() => true);
45
+ expect(() => runSessionId()).toThrow('exit');
46
+ expect(exitSpy).toHaveBeenCalledWith(1);
47
+ expect(stderrSpy).toHaveBeenCalledWith(expect.stringContaining('No active session'));
48
+ exitSpy.mockRestore();
49
+ stderrSpy.mockRestore();
50
+ });
51
+ });
52
+ //# sourceMappingURL=session.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"session.test.js","sourceRoot":"","sources":["../../src/__tests__/session.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=strip.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"strip.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/strip.test.ts"],"names":[],"mappings":""}