claude-flow 3.59.11 → 3.59.13
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.
- package/.claude/helpers/hook-handler.cjs +228 -11
- package/.claude/proven-config.json +1 -1
- package/.claude/skills/pair-programming/SKILL.md +72 -61
- package/package.json +1 -1
- package/v3/@claude-flow/cli/catalog-manifest.json +2 -2
- package/v3/@claude-flow/cli/dist/src/commands/index.d.ts +1 -0
- package/v3/@claude-flow/cli/dist/src/commands/index.js +7 -3
- package/v3/@claude-flow/cli/dist/src/commands/pair.d.ts +46 -0
- package/v3/@claude-flow/cli/dist/src/commands/pair.js +303 -0
- package/v3/@claude-flow/cli/dist/src/mcp-tools/claims-tools.d.ts +1 -1
- package/v3/@claude-flow/cli/dist/src/mcp-tools/claims-tools.js +4 -3
- package/v3/@claude-flow/cli/package.json +1 -1
|
@@ -24,9 +24,10 @@ const helpersDir = __dirname;
|
|
|
24
24
|
const helperRoot = path.resolve(helpersDir, '..', '..');
|
|
25
25
|
|
|
26
26
|
// Resolve an installed @claude-flow/cli (or ruflo) bin — mirrors
|
|
27
|
-
// statusline-generator.ts's resolveCliBin() candidate list
|
|
28
|
-
//
|
|
29
|
-
//
|
|
27
|
+
// statusline-generator.ts's resolveCliBin() candidate list, then looks for a
|
|
28
|
+
// global install (resolveGlobalCliBin() below, #3368). Used only to spawn the
|
|
29
|
+
// detached funnel-refresh helper below; failures are silent (no candidate
|
|
30
|
+
// found just means the refresh falls back to npx).
|
|
30
31
|
//
|
|
31
32
|
// Verifies dist/src/index.js exists alongside bin/cli.js, not just the bin
|
|
32
33
|
// itself — Claude Code's own plugin marketplace mechanism installs by
|
|
@@ -39,7 +40,17 @@ const helperRoot = path.resolve(helpersDir, '..', '..');
|
|
|
39
40
|
// first every time and spawnDetachedFunnelRefresh() below had no fallback,
|
|
40
41
|
// so the promo/disclosure row could never populate for any marketplace
|
|
41
42
|
// install, on any OS.
|
|
43
|
+
// session-restore asks up to three times (first-run enable, then the two
|
|
44
|
+
// refreshes). The answer cannot change inside one short-lived hook process,
|
|
45
|
+
// so resolve once: `undefined` means "not looked up yet", null means "no
|
|
46
|
+
// local or global CLI — use npx".
|
|
47
|
+
let cliBinCache;
|
|
42
48
|
function resolveCliBinForHook() {
|
|
49
|
+
if (cliBinCache === undefined) cliBinCache = resolveCliBinUncached();
|
|
50
|
+
return cliBinCache;
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
function resolveCliBinUncached() {
|
|
43
54
|
try {
|
|
44
55
|
const home = os.homedir();
|
|
45
56
|
const candidates = [
|
|
@@ -53,16 +64,219 @@ function resolveCliBinForHook() {
|
|
|
53
64
|
path.join(helpersDir, '..', '..', 'bin', 'cli.js'),
|
|
54
65
|
];
|
|
55
66
|
for (const p of candidates) {
|
|
56
|
-
|
|
57
|
-
if (fs.existsSync(p) && fs.existsSync(path.join(path.dirname(p), '..', 'dist', 'src', 'index.js'))) {
|
|
58
|
-
return p;
|
|
59
|
-
}
|
|
60
|
-
} catch (e) { /* try next candidate */ }
|
|
67
|
+
if (isRunnableCli(p)) return p;
|
|
61
68
|
}
|
|
69
|
+
return resolveGlobalCliBin();
|
|
62
70
|
} catch (e) { /* ignore */ }
|
|
63
71
|
return null;
|
|
64
72
|
}
|
|
65
73
|
|
|
74
|
+
function isRunnableCli(p) {
|
|
75
|
+
try {
|
|
76
|
+
return fs.existsSync(p) && fs.existsSync(path.join(path.dirname(p), '..', 'dist', 'src', 'index.js'));
|
|
77
|
+
} catch (e) { return false; }
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
// #3368: a global install — the README's `npm install -g ruflo@latest` — keeps
|
|
81
|
+
// the CLI at <prefix>/lib/node_modules/ruflo/node_modules/@claude-flow/cli,
|
|
82
|
+
// which none of the project-relative candidates above cover, so on those
|
|
83
|
+
// machines every refresh fell back to npx: a second, separately cached copy
|
|
84
|
+
// of the CLI that follows the registry's latest rather than the version the
|
|
85
|
+
// user pinned (the same npx-cache skew as #3306), and that cannot start
|
|
86
|
+
// offline on a cold cache.
|
|
87
|
+
//
|
|
88
|
+
// Three lookups, fs calls only (no child process), reached only after every
|
|
89
|
+
// candidate above missed:
|
|
90
|
+
// 1. npm's global prefix, resolved the way npm resolves it
|
|
91
|
+
// (npmGlobalPrefix() below). First because it does not depend on PATH:
|
|
92
|
+
// a hook inherits the host process's PATH, which need not contain the
|
|
93
|
+
// prefix's bin/ even when the user's interactive shell does (observed:
|
|
94
|
+
// the Claude Code process spawning hooks lacked ~/.npm-global/bin while
|
|
95
|
+
// a login zsh on the same machine had it).
|
|
96
|
+
// 2. `ruflo`, then `claude-flow`, on PATH — the order plugins/ruflo-core/
|
|
97
|
+
// scripts/ruflo-hook.cjs uses — for globals npm did not install (yarn
|
|
98
|
+
// classic, bun). Only a symlinked bin counts, and only when it lands in
|
|
99
|
+
// a package that declares one of the three known names, so a wrapper
|
|
100
|
+
// script or a version-manager shim (Volta) is never mistaken for an
|
|
101
|
+
// install. The <dir>/node_modules/<name> layout npm uses on Windows,
|
|
102
|
+
// where ruflo.cmd sits beside node_modules\ruflo (what resolveNpmShim()
|
|
103
|
+
// in ruflo-hook.cjs maps), is only consulted on win32: on POSIX every
|
|
104
|
+
// manager symlinks, and probing it there would follow a Windows install
|
|
105
|
+
// exposed to WSL through the appended Windows PATH.
|
|
106
|
+
// Relative PATH entries (`.` or an empty entry) are skipped, so a bare
|
|
107
|
+
// `./ruflo` in the working directory is never picked up.
|
|
108
|
+
// 3. ~/.npm-global, npm's documented no-sudo prefix, when 1 and 2 both
|
|
109
|
+
// missed: the prefix setting may live where this hook's node never
|
|
110
|
+
// reads it, and a wrapper script on PATH is skipped by 2.
|
|
111
|
+
// `env`/`platform`/`execPath` are parameters so any layout is testable
|
|
112
|
+
// from any OS.
|
|
113
|
+
function resolveGlobalCliBin(env = process.env, platform = process.platform, execPath = process.execPath) {
|
|
114
|
+
const prefix = npmGlobalPrefix(env, platform, execPath);
|
|
115
|
+
if (prefix) {
|
|
116
|
+
const hit = cliUnderPrefix(prefix, platform);
|
|
117
|
+
if (hit) return hit;
|
|
118
|
+
}
|
|
119
|
+
const dirs = String(env.PATH || env.Path || '').split(platform === 'win32' ? ';' : ':');
|
|
120
|
+
const exts = platform === 'win32' ? ['.cmd', ''] : [''];
|
|
121
|
+
for (const name of ['ruflo', 'claude-flow']) {
|
|
122
|
+
for (const dir of dirs) {
|
|
123
|
+
if (!dir || !path.isAbsolute(dir)) continue;
|
|
124
|
+
for (const ext of exts) {
|
|
125
|
+
const shim = path.join(dir, name + ext);
|
|
126
|
+
if (!fs.existsSync(shim)) continue;
|
|
127
|
+
const roots = [];
|
|
128
|
+
try {
|
|
129
|
+
if (fs.lstatSync(shim).isSymbolicLink()) {
|
|
130
|
+
const root = path.dirname(path.dirname(fs.realpathSync(shim)));
|
|
131
|
+
if (isKnownPackageRoot(root)) roots.push(root);
|
|
132
|
+
}
|
|
133
|
+
} catch (e) { /* unreadable link — fall back to the layout roots */ }
|
|
134
|
+
if (platform === 'win32') {
|
|
135
|
+
roots.push(path.join(dir, 'node_modules', name));
|
|
136
|
+
if (name === 'claude-flow') roots.push(path.join(dir, 'node_modules', '@claude-flow', 'cli'));
|
|
137
|
+
}
|
|
138
|
+
for (const root of roots) {
|
|
139
|
+
const hit = cliInPackage(root);
|
|
140
|
+
if (hit) return hit;
|
|
141
|
+
}
|
|
142
|
+
}
|
|
143
|
+
}
|
|
144
|
+
}
|
|
145
|
+
// Last resort: ~/.npm-global, the prefix npm's own docs recommend for
|
|
146
|
+
// global installs without sudo ("Resolving EACCES permissions errors").
|
|
147
|
+
// The setting that points npm there can live where this hook's node never
|
|
148
|
+
// looks (another node's builtin npmrc, or a wrapper script that sets it
|
|
149
|
+
// per call), and a `ruflo` wrapper script on PATH is skipped above by
|
|
150
|
+
// design. Without this, such a machine fell back to npx @latest on every
|
|
151
|
+
// hook. Checked only after the configured prefix and PATH both miss, so it
|
|
152
|
+
// can never override either.
|
|
153
|
+
const home = env.HOME || env.USERPROFILE;
|
|
154
|
+
if (home && path.isAbsolute(home)) {
|
|
155
|
+
const hit = cliUnderPrefix(path.join(home, '.npm-global'), platform);
|
|
156
|
+
if (hit) return hit;
|
|
157
|
+
}
|
|
158
|
+
return null;
|
|
159
|
+
}
|
|
160
|
+
|
|
161
|
+
// The CLI of a global install under an npm prefix: <prefix>/lib/node_modules
|
|
162
|
+
// on POSIX, <prefix>\node_modules on Windows, trying the three published
|
|
163
|
+
// package names in order.
|
|
164
|
+
function cliUnderPrefix(prefix, platform) {
|
|
165
|
+
const modules = platform === 'win32'
|
|
166
|
+
? path.join(prefix, 'node_modules')
|
|
167
|
+
: path.join(prefix, 'lib', 'node_modules');
|
|
168
|
+
for (const pkg of ['ruflo', 'claude-flow', path.join('@claude-flow', 'cli')]) {
|
|
169
|
+
const hit = cliInPackage(path.join(modules, pkg));
|
|
170
|
+
if (hit) return hit;
|
|
171
|
+
}
|
|
172
|
+
return null;
|
|
173
|
+
}
|
|
174
|
+
|
|
175
|
+
// A bin on PATH only counts as an install when the package it points into
|
|
176
|
+
// declares one of the three published names. This is a narrower check than
|
|
177
|
+
// resolveNpmShim() in ruflo-hook.cjs, which never reads `name`: that one takes
|
|
178
|
+
// the package name from the shim's own filename, then validates package.json's
|
|
179
|
+
// `bin` entry and that its realpath stays inside the package. Here the bin has
|
|
180
|
+
// already been resolved to a package root, so the manifest `name` is what
|
|
181
|
+
// identifies it.
|
|
182
|
+
function isKnownPackageRoot(root) {
|
|
183
|
+
try {
|
|
184
|
+
const name = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf-8')).name;
|
|
185
|
+
return name === 'ruflo' || name === 'claude-flow' || name === '@claude-flow/cli';
|
|
186
|
+
} catch (e) { return false; }
|
|
187
|
+
}
|
|
188
|
+
|
|
189
|
+
// Map an installed ruflo / claude-flow / @claude-flow/cli package root to the
|
|
190
|
+
// CLI it runs: <root>/bin/cli.js (@claude-flow/cli itself),
|
|
191
|
+
// <root>/v3/@claude-flow/cli/bin/cli.js (the claude-flow umbrella bundles
|
|
192
|
+
// it), or @claude-flow/cli in the node_modules npm nests inside <root> —
|
|
193
|
+
// or, for the flat layout yarn classic and bun use, in the node_modules
|
|
194
|
+
// folder that holds <root> itself. That is the dependency edge
|
|
195
|
+
// ruflo/bin/ruflo.js's findCliPath() follows. The search stops at that one
|
|
196
|
+
// enclosing node_modules: walking further up would reach unrelated trees,
|
|
197
|
+
// such as a stray ~/node_modules left by an `npm i` in a home directory.
|
|
198
|
+
// Every hit must still pass isRunnableCli().
|
|
199
|
+
function cliInPackage(root) {
|
|
200
|
+
if (!fs.existsSync(root)) return null;
|
|
201
|
+
const candidates = [
|
|
202
|
+
path.join(root, 'bin', 'cli.js'),
|
|
203
|
+
path.join(root, 'v3', '@claude-flow', 'cli', 'bin', 'cli.js'),
|
|
204
|
+
path.join(root, 'node_modules', '@claude-flow', 'cli', 'bin', 'cli.js'),
|
|
205
|
+
];
|
|
206
|
+
for (let dir = path.dirname(root), i = 0; i < 4 && dir !== path.dirname(dir); i++, dir = path.dirname(dir)) {
|
|
207
|
+
if (path.basename(dir) === 'node_modules') {
|
|
208
|
+
candidates.push(path.join(dir, '@claude-flow', 'cli', 'bin', 'cli.js'));
|
|
209
|
+
break;
|
|
210
|
+
}
|
|
211
|
+
}
|
|
212
|
+
return candidates.find(isRunnableCli) || null;
|
|
213
|
+
}
|
|
214
|
+
|
|
215
|
+
// npm's global prefix without spawning npm (`npm prefix -g` measured 70-80 ms
|
|
216
|
+
// per call, paid on every SessionStart that gets this far). Same precedence
|
|
217
|
+
// npm applies:
|
|
218
|
+
// 1. npm_config_prefix in the environment (npm accepts either case);
|
|
219
|
+
// 2. `prefix=` in the user npmrc ($npm_config_userconfig, else ~/.npmrc),
|
|
220
|
+
// where `npm config set prefix ~/.npm-global` (the npm docs' fix for
|
|
221
|
+
// EACCES on global installs) writes it;
|
|
222
|
+
// 3. `prefix=` in npm's builtin npmrc (<npm package>/npmrc), found through
|
|
223
|
+
// the `npm` link beside node: Homebrew writes `prefix = /opt/homebrew`
|
|
224
|
+
// there (its process.execPath is the Cellar path, so step 4 alone would
|
|
225
|
+
// be wrong), and the Node.js Windows installer ships
|
|
226
|
+
// `prefix=${APPDATA}\npm`;
|
|
227
|
+
// 4. npm's default: $PREFIX, else the directory above node's bin/ (POSIX)
|
|
228
|
+
// or node.exe's own directory (Windows).
|
|
229
|
+
// Values follow npm's ini handling for the cases that decide a path: a
|
|
230
|
+
// quoted value is taken literally, an unquoted `;`/`#` starts a comment,
|
|
231
|
+
// keys below a `[section]` header are ignored, `${VAR}` expands when the
|
|
232
|
+
// variable is set (and `${VAR?}` to empty when it is not) but otherwise
|
|
233
|
+
// stays literal like npm — which leaves the value relative, so the
|
|
234
|
+
// isAbsolute() check below rejects it instead of pointing at the drive root.
|
|
235
|
+
// Not emulated: escaped characters and npm's other ini corner cases; each of
|
|
236
|
+
// those produces a miss, never a wrong CLI. The npmrc is read into memory,
|
|
237
|
+
// but only the value of its last top-level `prefix =` line is kept: no other
|
|
238
|
+
// line (an `_authToken`, say) is returned, stored or logged.
|
|
239
|
+
function npmGlobalPrefix(env = process.env, platform = process.platform, execPath = process.execPath) {
|
|
240
|
+
const home = (platform === 'win32' ? env.USERPROFILE : env.HOME) || os.homedir();
|
|
241
|
+
const readPrefix = (file) => {
|
|
242
|
+
let value = null;
|
|
243
|
+
try {
|
|
244
|
+
for (const line of fs.readFileSync(file, 'utf-8').split(/\r?\n/)) {
|
|
245
|
+
if (/^\s*\[/.test(line)) break; // only the top-level section applies
|
|
246
|
+
const m = /^\s*prefix\s*=\s*(.*?)\s*$/.exec(line);
|
|
247
|
+
if (m) value = m[1]; // last one wins, as in npm's ini parser
|
|
248
|
+
}
|
|
249
|
+
} catch (e) { /* no such npmrc */ }
|
|
250
|
+
return value;
|
|
251
|
+
};
|
|
252
|
+
const nodeDir = path.dirname(execPath);
|
|
253
|
+
// npm's builtin npmrc sits in npm's own package dir. On Windows that is
|
|
254
|
+
// node_modules\npm beside node.exe; elsewhere follow the `npm` link beside
|
|
255
|
+
// node (<npm>/bin/npm-cli.js) — on Homebrew it points out of the node keg
|
|
256
|
+
// to /opt/homebrew/lib/node_modules/npm.
|
|
257
|
+
let builtinRc = path.join(nodeDir, 'node_modules', 'npm', 'npmrc');
|
|
258
|
+
if (platform !== 'win32') {
|
|
259
|
+
try {
|
|
260
|
+
builtinRc = path.join(path.dirname(path.dirname(fs.realpathSync(path.join(nodeDir, 'npm')))), 'npmrc');
|
|
261
|
+
} catch (e) { /* no npm beside node */ }
|
|
262
|
+
}
|
|
263
|
+
const raw = env.npm_config_prefix || env.NPM_CONFIG_PREFIX
|
|
264
|
+
|| readPrefix(env.npm_config_userconfig || env.NPM_CONFIG_USERCONFIG || path.join(home, '.npmrc'))
|
|
265
|
+
|| readPrefix(builtinRc)
|
|
266
|
+
|| env.PREFIX
|
|
267
|
+
|| (platform === 'win32' ? nodeDir : path.dirname(nodeDir));
|
|
268
|
+
let value = String(raw).trim();
|
|
269
|
+
const quoted = /^(["'])([\s\S]*)\1$/.exec(value);
|
|
270
|
+
if (quoted) value = quoted[2];
|
|
271
|
+
else value = value.replace(/(^|[^\\])[;#].*$/, '$1').trim();
|
|
272
|
+
value = value
|
|
273
|
+
.replace(/\$\{([^}?]+)(\?)?\}/g, (whole, name, optional) => (
|
|
274
|
+
env[name] !== undefined ? env[name] : (optional ? '' : whole)
|
|
275
|
+
))
|
|
276
|
+
.replace(/^~(?=$|[\\/])/, home);
|
|
277
|
+
return path.isAbsolute(value) ? path.resolve(value) : null;
|
|
278
|
+
}
|
|
279
|
+
|
|
66
280
|
// Fire-and-forget doesn't work when the CALLER is itself a short-lived
|
|
67
281
|
// subprocess (confirmed live: two consecutive statusline renders 5s apart
|
|
68
282
|
// both saw an empty funnel-messages-cache, because the async HTTPS fetch
|
|
@@ -74,8 +288,8 @@ function resolveCliBinForHook() {
|
|
|
74
288
|
// chance to write the cache. Never awaited here — must not add to
|
|
75
289
|
// SessionStart's own timeout budget.
|
|
76
290
|
//
|
|
77
|
-
// No usable local candidate (resolveCliBinForHook() returned null)
|
|
78
|
-
// back to npx: this call is detached/unref'd, so a slower npx cold-start
|
|
291
|
+
// No usable local or global candidate (resolveCliBinForHook() returned null)
|
|
292
|
+
// falls back to npx: this call is detached/unref'd, so a slower npx cold-start
|
|
79
293
|
// costs nothing perceptible — unlike the statusline's own synchronous
|
|
80
294
|
// render path, where local-first exists purely for per-render latency.
|
|
81
295
|
// `--prefer-offline` avoids a registry round trip for the tarball when
|
|
@@ -1060,4 +1274,7 @@ if (require.main === module) {
|
|
|
1060
1274
|
// Which sibling helpers loaded (all CommonJS, shipped as .cjs — #3555).
|
|
1061
1275
|
const loadedHelpers = { router: !!router, session: !!session, memory: !!memory, intelligence: !!intelligence };
|
|
1062
1276
|
|
|
1063
|
-
|
|
1277
|
+
// resolveGlobalCliBin/npmGlobalPrefix are exported for
|
|
1278
|
+
// hook-handler-global-cli.test.ts; resolveCliBinForHook for anyone checking
|
|
1279
|
+
// what a given machine resolves to without running a hook (#3368).
|
|
1280
|
+
module.exports = { runWithTimeout, INTELLIGENCE_TIMEOUT_MS, loadedHelpers, ownedByMod, MOD_OWNABLE_EVENTS, resolveCliBinForHook, resolveGlobalCliBin, npmGlobalPrefix, cliSpawnArgs, helperRoot, scanSessionStartSettingsForRisk, srFormatRiskFindingsForAutomaticBoot, srScanSettingsForRisk, srScanCommandStringForRisk, srScanAllowRuleForRisk, SR_DANGEROUS_COMMAND_WORDS, SR_SHELL_EXEC_WORDS, SR_DOWNLOADER_WORDS, SR_STANDALONE_RISK_PATTERNS };
|
|
@@ -19,10 +19,21 @@ This skill provides professional pair programming capabilities with AI assistanc
|
|
|
19
19
|
- **Code Review**: Security scanning, performance analysis, best practice enforcement
|
|
20
20
|
- **Session Persistence**: Auto-save, recovery, export, and sharing
|
|
21
21
|
|
|
22
|
+
## How Claude Code Uses This
|
|
23
|
+
|
|
24
|
+
The CLI holds the session state; Claude Code reads it. There is no REPL to type into.
|
|
25
|
+
|
|
26
|
+
1. At the start of every turn run `ruflo pair status --json`. If `active` is `false`, this skill is dormant.
|
|
27
|
+
2. Follow `mode` and `aiRole`. As **driver** you write the code and the human reviews. As **navigator** you review and suggest and never edit unless asked. `tdd`, `review`, `mentor` and `debug` refine that behaviour as described below.
|
|
28
|
+
3. When `switchDue` is `true`, run `ruflo pair switch`, announce the swap, and continue in the new role.
|
|
29
|
+
4. Change mode mid-session with `ruflo pair mode <mode>`. The human can run the same commands from their shell.
|
|
30
|
+
|
|
31
|
+
State lives in `.claude-flow/sessions/pair/current.json`. `ruflo pair end` archives it to `history.jsonl` next to it.
|
|
32
|
+
|
|
22
33
|
## Prerequisites
|
|
23
34
|
|
|
24
35
|
**Required:**
|
|
25
|
-
-
|
|
36
|
+
- Ruflo CLI installed (`npm install -g ruflo`), which provides the `ruflo pair` command
|
|
26
37
|
- Git repository (optional but recommended)
|
|
27
38
|
|
|
28
39
|
**Recommended:**
|
|
@@ -35,13 +46,13 @@ This skill provides professional pair programming capabilities with AI assistanc
|
|
|
35
46
|
### Basic Session
|
|
36
47
|
```bash
|
|
37
48
|
# Start simple pair programming
|
|
38
|
-
|
|
49
|
+
ruflo pair start
|
|
39
50
|
```
|
|
40
51
|
|
|
41
52
|
### TDD Session
|
|
42
53
|
```bash
|
|
43
54
|
# Test-driven development
|
|
44
|
-
|
|
55
|
+
ruflo pair start \
|
|
45
56
|
--mode tdd \
|
|
46
57
|
--test-first \
|
|
47
58
|
--coverage 90
|
|
@@ -56,23 +67,23 @@ claude-flow pair --start \
|
|
|
56
67
|
#### Starting Sessions
|
|
57
68
|
```bash
|
|
58
69
|
# Basic start
|
|
59
|
-
|
|
70
|
+
ruflo pair start
|
|
60
71
|
|
|
61
72
|
# Expert refactoring session
|
|
62
|
-
|
|
73
|
+
ruflo pair start \
|
|
63
74
|
--agent senior-dev \
|
|
64
75
|
--focus refactor \
|
|
65
76
|
--verify \
|
|
66
77
|
--threshold 0.98
|
|
67
78
|
|
|
68
79
|
# Debugging session
|
|
69
|
-
|
|
80
|
+
ruflo pair start \
|
|
70
81
|
--agent debugger-expert \
|
|
71
82
|
--focus debug \
|
|
72
83
|
--review
|
|
73
84
|
|
|
74
85
|
# Learning session
|
|
75
|
-
|
|
86
|
+
ruflo pair start \
|
|
76
87
|
--mode mentor \
|
|
77
88
|
--pace slow \
|
|
78
89
|
--examples
|
|
@@ -81,10 +92,10 @@ claude-flow pair --start \
|
|
|
81
92
|
#### Session Management
|
|
82
93
|
```bash
|
|
83
94
|
# Check status
|
|
84
|
-
|
|
95
|
+
ruflo pair status
|
|
85
96
|
|
|
86
97
|
# View history
|
|
87
|
-
|
|
98
|
+
ruflo pair history
|
|
88
99
|
|
|
89
100
|
# Pause session
|
|
90
101
|
/pause [--reason <reason>]
|
|
@@ -93,7 +104,7 @@ claude-flow pair --history
|
|
|
93
104
|
/resume
|
|
94
105
|
|
|
95
106
|
# End session
|
|
96
|
-
|
|
107
|
+
ruflo pair end [--save] [--report]
|
|
97
108
|
```
|
|
98
109
|
|
|
99
110
|
### Available Modes
|
|
@@ -102,7 +113,7 @@ claude-flow pair --end [--save] [--report]
|
|
|
102
113
|
You write code while AI provides guidance.
|
|
103
114
|
|
|
104
115
|
```bash
|
|
105
|
-
|
|
116
|
+
ruflo pair start --mode driver
|
|
106
117
|
```
|
|
107
118
|
|
|
108
119
|
**Your Responsibilities:**
|
|
@@ -137,7 +148,7 @@ claude-flow pair --start --mode driver
|
|
|
137
148
|
AI writes code while you provide direction.
|
|
138
149
|
|
|
139
150
|
```bash
|
|
140
|
-
|
|
151
|
+
ruflo pair start --mode navigator
|
|
141
152
|
```
|
|
142
153
|
|
|
143
154
|
**Your Responsibilities:**
|
|
@@ -173,13 +184,13 @@ Automatically alternates roles at intervals.
|
|
|
173
184
|
|
|
174
185
|
```bash
|
|
175
186
|
# Default 10-minute intervals
|
|
176
|
-
|
|
187
|
+
ruflo pair start --mode switch
|
|
177
188
|
|
|
178
189
|
# 5-minute intervals (rapid)
|
|
179
|
-
|
|
190
|
+
ruflo pair start --mode switch --interval 5m
|
|
180
191
|
|
|
181
192
|
# 15-minute intervals (deep focus)
|
|
182
|
-
|
|
193
|
+
ruflo pair start --mode switch --interval 15m
|
|
183
194
|
```
|
|
184
195
|
|
|
185
196
|
**Handoff Process:**
|
|
@@ -199,7 +210,7 @@ claude-flow pair --start --mode switch --interval 15m
|
|
|
199
210
|
|
|
200
211
|
**TDD Mode** - Test-Driven Development:
|
|
201
212
|
```bash
|
|
202
|
-
|
|
213
|
+
ruflo pair start \
|
|
203
214
|
--mode tdd \
|
|
204
215
|
--test-first \
|
|
205
216
|
--coverage 100
|
|
@@ -208,7 +219,7 @@ Workflow: Write failing test → Implement → Refactor → Repeat
|
|
|
208
219
|
|
|
209
220
|
**Review Mode** - Continuous code review:
|
|
210
221
|
```bash
|
|
211
|
-
|
|
222
|
+
ruflo pair start \
|
|
212
223
|
--mode review \
|
|
213
224
|
--strict \
|
|
214
225
|
--security
|
|
@@ -217,7 +228,7 @@ Features: Real-time feedback, security scanning, performance analysis
|
|
|
217
228
|
|
|
218
229
|
**Mentor Mode** - Learning-focused:
|
|
219
230
|
```bash
|
|
220
|
-
|
|
231
|
+
ruflo pair start \
|
|
221
232
|
--mode mentor \
|
|
222
233
|
--explain-all \
|
|
223
234
|
--pace slow
|
|
@@ -226,7 +237,7 @@ Features: Detailed explanations, step-by-step guidance, pattern teaching
|
|
|
226
237
|
|
|
227
238
|
**Debug Mode** - Problem-solving:
|
|
228
239
|
```bash
|
|
229
|
-
|
|
240
|
+
ruflo pair start \
|
|
230
241
|
--mode debug \
|
|
231
242
|
--verbose \
|
|
232
243
|
--trace
|
|
@@ -559,19 +570,19 @@ Create `.claude-flow/pair-config.json`:
|
|
|
559
570
|
#### CLI Configuration
|
|
560
571
|
```bash
|
|
561
572
|
# Set configuration
|
|
562
|
-
|
|
563
|
-
|
|
573
|
+
ruflo pair config set defaultMode switch
|
|
574
|
+
ruflo pair config set verification.threshold 0.98
|
|
564
575
|
|
|
565
576
|
# Get configuration
|
|
566
|
-
|
|
567
|
-
|
|
577
|
+
ruflo pair config get
|
|
578
|
+
ruflo pair config get defaultMode
|
|
568
579
|
|
|
569
580
|
# Export/Import
|
|
570
|
-
|
|
571
|
-
|
|
581
|
+
ruflo pair config export > config.json
|
|
582
|
+
ruflo pair config import config.json
|
|
572
583
|
|
|
573
584
|
# Reset
|
|
574
|
-
|
|
585
|
+
ruflo pair config reset
|
|
575
586
|
```
|
|
576
587
|
|
|
577
588
|
#### Profile Management
|
|
@@ -580,17 +591,17 @@ Create reusable profiles:
|
|
|
580
591
|
|
|
581
592
|
```bash
|
|
582
593
|
# Create profile
|
|
583
|
-
|
|
594
|
+
ruflo pair profile create refactoring \
|
|
584
595
|
--mode driver \
|
|
585
596
|
--verify true \
|
|
586
597
|
--threshold 0.98 \
|
|
587
598
|
--focus refactor
|
|
588
599
|
|
|
589
600
|
# Use profile
|
|
590
|
-
|
|
601
|
+
ruflo pair start --profile refactoring
|
|
591
602
|
|
|
592
603
|
# List profiles
|
|
593
|
-
|
|
604
|
+
ruflo pair profile list
|
|
594
605
|
```
|
|
595
606
|
|
|
596
607
|
Profile configuration:
|
|
@@ -629,7 +640,7 @@ Implementing user authentication with JWT tokens:
|
|
|
629
640
|
|
|
630
641
|
```bash
|
|
631
642
|
# Session setup
|
|
632
|
-
|
|
643
|
+
ruflo pair start \
|
|
633
644
|
--mode switch \
|
|
634
645
|
--agent senior-dev \
|
|
635
646
|
--focus implement \
|
|
@@ -676,7 +687,7 @@ Debugging a memory leak in Node.js:
|
|
|
676
687
|
|
|
677
688
|
```bash
|
|
678
689
|
# Session setup
|
|
679
|
-
|
|
690
|
+
ruflo pair start \
|
|
680
691
|
--mode navigator \
|
|
681
692
|
--agent debugger-expert \
|
|
682
693
|
--focus debug \
|
|
@@ -717,7 +728,7 @@ Building shopping cart with test-driven development:
|
|
|
717
728
|
|
|
718
729
|
```bash
|
|
719
730
|
# Session setup
|
|
720
|
-
|
|
731
|
+
ruflo pair start \
|
|
721
732
|
--mode tdd \
|
|
722
733
|
--agent tdd-specialist \
|
|
723
734
|
--test-first
|
|
@@ -759,7 +770,7 @@ Modernizing legacy code:
|
|
|
759
770
|
|
|
760
771
|
```bash
|
|
761
772
|
# Session setup
|
|
762
|
-
|
|
773
|
+
ruflo pair start \
|
|
763
774
|
--mode driver \
|
|
764
775
|
--focus refactor \
|
|
765
776
|
--verify \
|
|
@@ -807,7 +818,7 @@ Optimizing slow React application:
|
|
|
807
818
|
|
|
808
819
|
```bash
|
|
809
820
|
# Session setup
|
|
810
|
-
|
|
821
|
+
ruflo pair start \
|
|
811
822
|
--mode switch \
|
|
812
823
|
--agent performance-expert \
|
|
813
824
|
--focus optimize \
|
|
@@ -852,7 +863,7 @@ Building RESTful API with Express:
|
|
|
852
863
|
|
|
853
864
|
```bash
|
|
854
865
|
# Session setup
|
|
855
|
-
|
|
866
|
+
ruflo pair start \
|
|
856
867
|
--mode navigator \
|
|
857
868
|
--agent backend-expert \
|
|
858
869
|
--focus implement \
|
|
@@ -897,28 +908,28 @@ claude-flow pair --start \
|
|
|
897
908
|
|
|
898
909
|
```bash
|
|
899
910
|
# Refactoring template
|
|
900
|
-
|
|
911
|
+
ruflo pair --template refactor
|
|
901
912
|
# Focus: Code improvement
|
|
902
913
|
# Verification: High (0.98)
|
|
903
914
|
# Testing: After each change
|
|
904
915
|
# Review: Continuous
|
|
905
916
|
|
|
906
917
|
# Feature template
|
|
907
|
-
|
|
918
|
+
ruflo pair --template feature
|
|
908
919
|
# Focus: Implementation
|
|
909
920
|
# Verification: Standard (0.95)
|
|
910
921
|
# Testing: On completion
|
|
911
922
|
# Review: Pre-commit
|
|
912
923
|
|
|
913
924
|
# Debug template
|
|
914
|
-
|
|
925
|
+
ruflo pair --template debug
|
|
915
926
|
# Focus: Problem solving
|
|
916
927
|
# Verification: Moderate (0.90)
|
|
917
928
|
# Testing: Regression tests
|
|
918
929
|
# Review: Root cause
|
|
919
930
|
|
|
920
931
|
# Learning template
|
|
921
|
-
|
|
932
|
+
ruflo pair --template learn
|
|
922
933
|
# Mode: Mentor
|
|
923
934
|
# Pace: Slow
|
|
924
935
|
# Explanations: Detailed
|
|
@@ -930,7 +941,7 @@ claude-flow pair --template learn
|
|
|
930
941
|
#### Session Status
|
|
931
942
|
|
|
932
943
|
```bash
|
|
933
|
-
|
|
944
|
+
ruflo pair status
|
|
934
945
|
```
|
|
935
946
|
|
|
936
947
|
**Output:**
|
|
@@ -962,7 +973,7 @@ Next Switch: in 3 minutes
|
|
|
962
973
|
#### Session History
|
|
963
974
|
|
|
964
975
|
```bash
|
|
965
|
-
|
|
976
|
+
ruflo pair history
|
|
966
977
|
```
|
|
967
978
|
|
|
968
979
|
**Output:**
|
|
@@ -993,32 +1004,32 @@ claude-flow pair --history
|
|
|
993
1004
|
|
|
994
1005
|
```bash
|
|
995
1006
|
# Save session
|
|
996
|
-
|
|
1007
|
+
ruflo pair --save [--name <name>]
|
|
997
1008
|
|
|
998
1009
|
# Load session
|
|
999
|
-
|
|
1010
|
+
ruflo pair --load <session-id>
|
|
1000
1011
|
|
|
1001
1012
|
# Export session
|
|
1002
|
-
|
|
1013
|
+
ruflo pair --export <session-id> [--format json|md]
|
|
1003
1014
|
|
|
1004
1015
|
# Generate report
|
|
1005
|
-
|
|
1016
|
+
ruflo pair --report <session-id>
|
|
1006
1017
|
```
|
|
1007
1018
|
|
|
1008
1019
|
#### Background Sessions
|
|
1009
1020
|
|
|
1010
1021
|
```bash
|
|
1011
1022
|
# Start in background
|
|
1012
|
-
|
|
1023
|
+
ruflo pair start --background
|
|
1013
1024
|
|
|
1014
1025
|
# Monitor background session
|
|
1015
|
-
|
|
1026
|
+
ruflo pair --monitor
|
|
1016
1027
|
|
|
1017
1028
|
# Attach to background session
|
|
1018
|
-
|
|
1029
|
+
ruflo pair --attach <session-id>
|
|
1019
1030
|
|
|
1020
1031
|
# End background session
|
|
1021
|
-
|
|
1032
|
+
ruflo pair end <session-id>
|
|
1022
1033
|
```
|
|
1023
1034
|
|
|
1024
1035
|
### Advanced Features
|
|
@@ -1054,30 +1065,30 @@ Use custom commands:
|
|
|
1054
1065
|
|
|
1055
1066
|
```bash
|
|
1056
1067
|
# Start with recording
|
|
1057
|
-
|
|
1068
|
+
ruflo pair start --record
|
|
1058
1069
|
|
|
1059
1070
|
# Replay session
|
|
1060
|
-
|
|
1071
|
+
ruflo pair --replay <session-id>
|
|
1061
1072
|
|
|
1062
1073
|
# Session analytics
|
|
1063
|
-
|
|
1074
|
+
ruflo pair --analytics <session-id>
|
|
1064
1075
|
```
|
|
1065
1076
|
|
|
1066
1077
|
#### Integration Options
|
|
1067
1078
|
|
|
1068
1079
|
**With Git:**
|
|
1069
1080
|
```bash
|
|
1070
|
-
|
|
1081
|
+
ruflo pair start --git --auto-commit
|
|
1071
1082
|
```
|
|
1072
1083
|
|
|
1073
1084
|
**With CI/CD:**
|
|
1074
1085
|
```bash
|
|
1075
|
-
|
|
1086
|
+
ruflo pair start --ci --non-interactive
|
|
1076
1087
|
```
|
|
1077
1088
|
|
|
1078
1089
|
**With IDE:**
|
|
1079
1090
|
```bash
|
|
1080
|
-
|
|
1091
|
+
ruflo pair start --ide vscode
|
|
1081
1092
|
```
|
|
1082
1093
|
|
|
1083
1094
|
### Best Practices
|
|
@@ -1131,7 +1142,7 @@ claude-flow pair --start --ide vscode
|
|
|
1131
1142
|
- Validate JSON syntax
|
|
1132
1143
|
- Check file permissions
|
|
1133
1144
|
- Review priority order (CLI > env > project > user > global)
|
|
1134
|
-
- Run `
|
|
1145
|
+
- Run `ruflo pair config validate`
|
|
1135
1146
|
|
|
1136
1147
|
### Quality Metrics
|
|
1137
1148
|
|
|
@@ -1195,8 +1206,8 @@ Default shortcuts:
|
|
|
1195
1206
|
|
|
1196
1207
|
### Related Commands
|
|
1197
1208
|
|
|
1198
|
-
- `
|
|
1199
|
-
- `
|
|
1200
|
-
- `
|
|
1201
|
-
- `
|
|
1202
|
-
- `
|
|
1209
|
+
- `ruflo pair --help` - Show help
|
|
1210
|
+
- `ruflo pair config` - Manage configuration
|
|
1211
|
+
- `ruflo pair profile` - Manage profiles
|
|
1212
|
+
- `ruflo pair templates` - List templates
|
|
1213
|
+
- `ruflo pair agents` - List available agents
|
package/package.json
CHANGED
|
@@ -46,6 +46,7 @@ export declare function getGuidanceCommand(): Promise<Command | undefined>;
|
|
|
46
46
|
export declare function getApplianceCommand(): Promise<Command | undefined>;
|
|
47
47
|
export declare function getCleanupCommand(): Promise<Command | undefined>;
|
|
48
48
|
export declare function getAutopilotCommand(): Promise<Command | undefined>;
|
|
49
|
+
export declare function getPairCommand(): Promise<Command | undefined>;
|
|
49
50
|
export declare function getTransportCommand(): Promise<Command | undefined>;
|
|
50
51
|
/**
|
|
51
52
|
* Core commands loaded synchronously (available immediately)
|
|
@@ -70,6 +70,9 @@ const commandLoaders = {
|
|
|
70
70
|
'transfer-store': () => import('./transfer-store.js'),
|
|
71
71
|
cleanup: () => import('./cleanup.js'),
|
|
72
72
|
autopilot: () => import('./autopilot.js'),
|
|
73
|
+
// Pair programming session state (restores the v2 `pair` command the
|
|
74
|
+
// bundled pair-programming skill depends on)
|
|
75
|
+
pair: () => import('./pair.js'),
|
|
73
76
|
// GAIA Benchmark Harness (ADR-133)
|
|
74
77
|
'gaia-bench': () => import('./gaia-bench.js'),
|
|
75
78
|
// MetaHarness integration (ADR-150) — dispatcher over plugins/ruflo-metaharness/
|
|
@@ -203,6 +206,7 @@ export async function getGuidanceCommand() { return loadCommand('guidance'); }
|
|
|
203
206
|
export async function getApplianceCommand() { return loadCommand('appliance'); }
|
|
204
207
|
export async function getCleanupCommand() { return loadCommand('cleanup'); }
|
|
205
208
|
export async function getAutopilotCommand() { return loadCommand('autopilot'); }
|
|
209
|
+
export async function getPairCommand() { return loadCommand('pair'); }
|
|
206
210
|
export async function getTransportCommand() { return loadCommand('transport'); }
|
|
207
211
|
/**
|
|
208
212
|
* Core commands loaded synchronously (available immediately)
|
|
@@ -249,14 +253,14 @@ export const commandsByCategory = {
|
|
|
249
253
|
* Use this for help display and full command listings.
|
|
250
254
|
*/
|
|
251
255
|
export async function getCommandsByCategory() {
|
|
252
|
-
const [daemonCmd, doctorCmd, embeddingsCmd, neuralCmd, performanceCmd, securityCmd, ruvectorCmd, hiveMindCmd, configCmd, completionsCmd, migrateCmd, workflowCmd, analyzeCmd, routeCmd, progressCmd, providersCmd, pluginsCmd, deploymentCmd, claimsCmd, issuesCmd, updateCmd, processCmd, guidanceCmd, applianceCmd, cleanupCmd, autopilotCmd, policyCmd,] = await Promise.all([
|
|
256
|
+
const [daemonCmd, doctorCmd, embeddingsCmd, neuralCmd, performanceCmd, securityCmd, ruvectorCmd, hiveMindCmd, configCmd, completionsCmd, migrateCmd, workflowCmd, analyzeCmd, routeCmd, progressCmd, providersCmd, pluginsCmd, deploymentCmd, claimsCmd, issuesCmd, updateCmd, processCmd, guidanceCmd, applianceCmd, cleanupCmd, autopilotCmd, policyCmd, pairCmd,] = await Promise.all([
|
|
253
257
|
loadCommand('daemon'), loadCommand('doctor'), loadCommand('embeddings'), loadCommand('neural'),
|
|
254
258
|
loadCommand('performance'), loadCommand('security'), loadCommand('ruvector'), loadCommand('hive-mind'),
|
|
255
259
|
loadCommand('config'), loadCommand('completions'), loadCommand('migrate'), loadCommand('workflow'),
|
|
256
260
|
loadCommand('analyze'), loadCommand('route'), loadCommand('progress'), loadCommand('providers'),
|
|
257
261
|
loadCommand('plugins'), loadCommand('deployment'), loadCommand('claims'), loadCommand('issues'),
|
|
258
262
|
loadCommand('update'), loadCommand('process'), loadCommand('guidance'), loadCommand('appliance'),
|
|
259
|
-
loadCommand('cleanup'), loadCommand('autopilot'), loadCommand('policy'),
|
|
263
|
+
loadCommand('cleanup'), loadCommand('autopilot'), loadCommand('policy'), loadCommand('pair'),
|
|
260
264
|
]);
|
|
261
265
|
return {
|
|
262
266
|
primary: [
|
|
@@ -270,7 +274,7 @@ export async function getCommandsByCategory() {
|
|
|
270
274
|
].filter(Boolean),
|
|
271
275
|
utility: [
|
|
272
276
|
configCmd, doctorCmd, daemonCmd, completionsCmd,
|
|
273
|
-
migrateCmd, workflowCmd,
|
|
277
|
+
migrateCmd, workflowCmd, pairCmd,
|
|
274
278
|
].filter(Boolean),
|
|
275
279
|
analysis: [
|
|
276
280
|
analyzeCmd, routeCmd, progressCmd,
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* `ruflo pair` — pair programming session state.
|
|
3
|
+
*
|
|
4
|
+
* The bundled `pair-programming` skill has told Claude Code to run
|
|
5
|
+
* `claude-flow pair --start --mode tdd` since v2, but the v3 CLI never
|
|
6
|
+
* shipped the command, so the skill's modes could not be activated or
|
|
7
|
+
* switched. This restores a minimal, non-interactive version: the session
|
|
8
|
+
* (mode, who currently drives, when roles last swapped) lives in
|
|
9
|
+
* `.claude-flow/sessions/pair/current.json` in the project so both the human
|
|
10
|
+
* and the agent can read it between turns. There is no REPL — Claude Code
|
|
11
|
+
* cannot type into one — the agent reads `pair status --json` and behaves
|
|
12
|
+
* according to the recorded mode and role.
|
|
13
|
+
*
|
|
14
|
+
* Legacy v2 spellings (`pair --start`, `--status`, `--end`, `--history`)
|
|
15
|
+
* still work so existing skill docs and muscle memory keep functioning.
|
|
16
|
+
*/
|
|
17
|
+
import type { Command } from '../types.js';
|
|
18
|
+
export declare const PAIR_MODES: {
|
|
19
|
+
readonly driver: "AI writes the code, human reviews and steers";
|
|
20
|
+
readonly navigator: "Human writes the code, AI reviews and suggests";
|
|
21
|
+
readonly switch: "Roles swap every --interval (default 10m)";
|
|
22
|
+
readonly tdd: "Red-green-refactor; AI writes failing tests first";
|
|
23
|
+
readonly review: "Read-only review of existing code, no edits without approval";
|
|
24
|
+
readonly mentor: "AI explains every step and asks before acting";
|
|
25
|
+
readonly debug: "Hypothesis-driven debugging; AI reproduces before fixing";
|
|
26
|
+
};
|
|
27
|
+
export type PairMode = keyof typeof PAIR_MODES;
|
|
28
|
+
export type PairRole = 'driver' | 'navigator';
|
|
29
|
+
export interface PairSession {
|
|
30
|
+
id: string;
|
|
31
|
+
mode: PairMode;
|
|
32
|
+
/** Who currently types. Always refers to the AI's role. */
|
|
33
|
+
aiRole: PairRole;
|
|
34
|
+
switchIntervalMinutes: number | null;
|
|
35
|
+
startedAt: string;
|
|
36
|
+
lastSwitchAt: string;
|
|
37
|
+
switches: number;
|
|
38
|
+
endedAt?: string;
|
|
39
|
+
}
|
|
40
|
+
export declare function readSession(cwd: string): PairSession | null;
|
|
41
|
+
export declare function readHistory(cwd: string): PairSession[];
|
|
42
|
+
/** Accepts `10`, `10m`, `1h`, `90s`; returns minutes or null when unparseable. */
|
|
43
|
+
export declare function parseIntervalMinutes(raw: unknown): number | null;
|
|
44
|
+
export declare const pairCommand: Command;
|
|
45
|
+
export default pairCommand;
|
|
46
|
+
//# sourceMappingURL=pair.d.ts.map
|
|
@@ -0,0 +1,303 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* `ruflo pair` — pair programming session state.
|
|
3
|
+
*
|
|
4
|
+
* The bundled `pair-programming` skill has told Claude Code to run
|
|
5
|
+
* `claude-flow pair --start --mode tdd` since v2, but the v3 CLI never
|
|
6
|
+
* shipped the command, so the skill's modes could not be activated or
|
|
7
|
+
* switched. This restores a minimal, non-interactive version: the session
|
|
8
|
+
* (mode, who currently drives, when roles last swapped) lives in
|
|
9
|
+
* `.claude-flow/sessions/pair/current.json` in the project so both the human
|
|
10
|
+
* and the agent can read it between turns. There is no REPL — Claude Code
|
|
11
|
+
* cannot type into one — the agent reads `pair status --json` and behaves
|
|
12
|
+
* according to the recorded mode and role.
|
|
13
|
+
*
|
|
14
|
+
* Legacy v2 spellings (`pair --start`, `--status`, `--end`, `--history`)
|
|
15
|
+
* still work so existing skill docs and muscle memory keep functioning.
|
|
16
|
+
*/
|
|
17
|
+
import * as fs from 'node:fs';
|
|
18
|
+
import * as path from 'node:path';
|
|
19
|
+
import { output } from '../output.js';
|
|
20
|
+
export const PAIR_MODES = {
|
|
21
|
+
driver: 'AI writes the code, human reviews and steers',
|
|
22
|
+
navigator: 'Human writes the code, AI reviews and suggests',
|
|
23
|
+
switch: 'Roles swap every --interval (default 10m)',
|
|
24
|
+
tdd: 'Red-green-refactor; AI writes failing tests first',
|
|
25
|
+
review: 'Read-only review of existing code, no edits without approval',
|
|
26
|
+
mentor: 'AI explains every step and asks before acting',
|
|
27
|
+
debug: 'Hypothesis-driven debugging; AI reproduces before fixing',
|
|
28
|
+
};
|
|
29
|
+
const SESSION_DIR = ['.claude-flow', 'sessions', 'pair'];
|
|
30
|
+
const DEFAULT_SWITCH_INTERVAL_MINUTES = 10;
|
|
31
|
+
function sessionDir(cwd) {
|
|
32
|
+
return path.join(cwd, ...SESSION_DIR);
|
|
33
|
+
}
|
|
34
|
+
function currentPath(cwd) {
|
|
35
|
+
return path.join(sessionDir(cwd), 'current.json');
|
|
36
|
+
}
|
|
37
|
+
function historyPath(cwd) {
|
|
38
|
+
return path.join(sessionDir(cwd), 'history.jsonl');
|
|
39
|
+
}
|
|
40
|
+
export function readSession(cwd) {
|
|
41
|
+
try {
|
|
42
|
+
return JSON.parse(fs.readFileSync(currentPath(cwd), 'utf-8'));
|
|
43
|
+
}
|
|
44
|
+
catch {
|
|
45
|
+
return null;
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
function writeSession(cwd, session) {
|
|
49
|
+
fs.mkdirSync(sessionDir(cwd), { recursive: true });
|
|
50
|
+
const tmp = currentPath(cwd) + '.tmp-' + process.pid;
|
|
51
|
+
fs.writeFileSync(tmp, JSON.stringify(session, null, 2) + '\n', 'utf-8');
|
|
52
|
+
fs.renameSync(tmp, currentPath(cwd));
|
|
53
|
+
}
|
|
54
|
+
export function readHistory(cwd) {
|
|
55
|
+
try {
|
|
56
|
+
return fs.readFileSync(historyPath(cwd), 'utf-8')
|
|
57
|
+
.split('\n')
|
|
58
|
+
.filter(Boolean)
|
|
59
|
+
.map(line => JSON.parse(line));
|
|
60
|
+
}
|
|
61
|
+
catch {
|
|
62
|
+
return [];
|
|
63
|
+
}
|
|
64
|
+
}
|
|
65
|
+
/** Accepts `10`, `10m`, `1h`, `90s`; returns minutes or null when unparseable. */
|
|
66
|
+
export function parseIntervalMinutes(raw) {
|
|
67
|
+
if (raw === undefined || raw === null || raw === '')
|
|
68
|
+
return null;
|
|
69
|
+
if (typeof raw === 'number')
|
|
70
|
+
return raw > 0 ? raw : null;
|
|
71
|
+
const match = /^(\d+(?:\.\d+)?)\s*(s|m|h)?$/i.exec(String(raw).trim());
|
|
72
|
+
if (!match)
|
|
73
|
+
return null;
|
|
74
|
+
const value = parseFloat(match[1]);
|
|
75
|
+
const unit = (match[2] ?? 'm').toLowerCase();
|
|
76
|
+
const minutes = unit === 'h' ? value * 60 : unit === 's' ? value / 60 : value;
|
|
77
|
+
return minutes > 0 ? minutes : null;
|
|
78
|
+
}
|
|
79
|
+
function isMode(value) {
|
|
80
|
+
return typeof value === 'string' && value in PAIR_MODES;
|
|
81
|
+
}
|
|
82
|
+
function otherRole(role) {
|
|
83
|
+
return role === 'driver' ? 'navigator' : 'driver';
|
|
84
|
+
}
|
|
85
|
+
/** Default AI role implied by a mode, used when --role is not given. */
|
|
86
|
+
function defaultRoleFor(mode) {
|
|
87
|
+
return mode === 'navigator' || mode === 'review' ? 'navigator' : 'driver';
|
|
88
|
+
}
|
|
89
|
+
function switchDue(session, now) {
|
|
90
|
+
if (session.mode !== 'switch' || !session.switchIntervalMinutes)
|
|
91
|
+
return false;
|
|
92
|
+
const elapsedMinutes = (now.getTime() - new Date(session.lastSwitchAt).getTime()) / 60_000;
|
|
93
|
+
return elapsedMinutes >= session.switchIntervalMinutes;
|
|
94
|
+
}
|
|
95
|
+
function describe(session, now) {
|
|
96
|
+
return {
|
|
97
|
+
...session,
|
|
98
|
+
modeDescription: PAIR_MODES[session.mode],
|
|
99
|
+
humanRole: otherRole(session.aiRole),
|
|
100
|
+
switchDue: switchDue(session, now),
|
|
101
|
+
};
|
|
102
|
+
}
|
|
103
|
+
function printSession(session, now) {
|
|
104
|
+
output.writeln(`Session: ${session.id}`);
|
|
105
|
+
output.writeln(`Mode: ${session.mode} — ${PAIR_MODES[session.mode]}`);
|
|
106
|
+
output.writeln(`AI role: ${session.aiRole} (human: ${otherRole(session.aiRole)})`);
|
|
107
|
+
if (session.switchIntervalMinutes) {
|
|
108
|
+
output.writeln(`Interval: every ${session.switchIntervalMinutes}m, ${session.switches} switch(es) so far`);
|
|
109
|
+
if (switchDue(session, now))
|
|
110
|
+
output.printWarning('Role switch is due — run `ruflo pair switch`.');
|
|
111
|
+
}
|
|
112
|
+
output.writeln(`Started: ${session.startedAt}`);
|
|
113
|
+
}
|
|
114
|
+
function noSession(ctx) {
|
|
115
|
+
if (ctx.flags.json)
|
|
116
|
+
output.printJson({ active: false });
|
|
117
|
+
else
|
|
118
|
+
output.writeln('No active pair session. Start one with `ruflo pair start --mode <mode>`.');
|
|
119
|
+
return { success: true, data: { active: false } };
|
|
120
|
+
}
|
|
121
|
+
async function startAction(ctx) {
|
|
122
|
+
// `pair start tdd` and `pair start --mode tdd` both work; a bare word wins
|
|
123
|
+
// over the option default so it is never silently ignored.
|
|
124
|
+
const mode = ctx.args[0] ?? ctx.flags.mode ?? 'driver';
|
|
125
|
+
if (!isMode(mode)) {
|
|
126
|
+
output.printError(`Unknown mode "${String(mode)}". Choose one of: ${Object.keys(PAIR_MODES).join(', ')}`);
|
|
127
|
+
return { success: false, exitCode: 1 };
|
|
128
|
+
}
|
|
129
|
+
const existing = readSession(ctx.cwd);
|
|
130
|
+
if (existing) {
|
|
131
|
+
output.printError(`A pair session is already active (${existing.id}). End it first with \`ruflo pair end\`.`);
|
|
132
|
+
return { success: false, exitCode: 1, data: describe(existing, new Date()) };
|
|
133
|
+
}
|
|
134
|
+
const interval = ctx.flags.interval !== undefined ? parseIntervalMinutes(ctx.flags.interval) : null;
|
|
135
|
+
if (ctx.flags.interval !== undefined && interval === null) {
|
|
136
|
+
output.printError(`Invalid --interval "${String(ctx.flags.interval)}". Use e.g. 10m, 90s or 1h.`);
|
|
137
|
+
return { success: false, exitCode: 1 };
|
|
138
|
+
}
|
|
139
|
+
const role = ctx.flags.role;
|
|
140
|
+
const now = new Date();
|
|
141
|
+
const session = {
|
|
142
|
+
id: `pair_${now.getTime()}`,
|
|
143
|
+
mode,
|
|
144
|
+
aiRole: role === 'driver' || role === 'navigator' ? role : defaultRoleFor(mode),
|
|
145
|
+
switchIntervalMinutes: mode === 'switch' ? (interval ?? DEFAULT_SWITCH_INTERVAL_MINUTES) : interval,
|
|
146
|
+
startedAt: now.toISOString(),
|
|
147
|
+
lastSwitchAt: now.toISOString(),
|
|
148
|
+
switches: 0,
|
|
149
|
+
};
|
|
150
|
+
writeSession(ctx.cwd, session);
|
|
151
|
+
if (ctx.flags.json)
|
|
152
|
+
output.printJson(describe(session, now));
|
|
153
|
+
else {
|
|
154
|
+
output.printSuccess('Pair session started.');
|
|
155
|
+
printSession(session, now);
|
|
156
|
+
}
|
|
157
|
+
return { success: true, data: describe(session, now) };
|
|
158
|
+
}
|
|
159
|
+
const startSub = {
|
|
160
|
+
name: 'start',
|
|
161
|
+
description: 'Start a pair programming session',
|
|
162
|
+
options: [
|
|
163
|
+
{ name: 'mode', short: 'm', description: 'Collaboration mode', type: 'string', default: 'driver', choices: Object.keys(PAIR_MODES) },
|
|
164
|
+
{ name: 'role', description: "AI's starting role (defaults from mode)", type: 'string', choices: ['driver', 'navigator'] },
|
|
165
|
+
{ name: 'interval', short: 'i', description: 'Role switch interval for switch mode (e.g. 10m, 1h)', type: 'string' },
|
|
166
|
+
{ name: 'json', description: 'Output as JSON', type: 'boolean', default: false },
|
|
167
|
+
],
|
|
168
|
+
action: startAction,
|
|
169
|
+
};
|
|
170
|
+
async function statusAction(ctx) {
|
|
171
|
+
const session = readSession(ctx.cwd);
|
|
172
|
+
if (!session)
|
|
173
|
+
return noSession(ctx);
|
|
174
|
+
const now = new Date();
|
|
175
|
+
if (ctx.flags.json)
|
|
176
|
+
output.printJson({ active: true, ...describe(session, now) });
|
|
177
|
+
else
|
|
178
|
+
printSession(session, now);
|
|
179
|
+
return { success: true, data: { active: true, ...describe(session, now) } };
|
|
180
|
+
}
|
|
181
|
+
const statusSub = {
|
|
182
|
+
name: 'status',
|
|
183
|
+
description: 'Show the active pair session',
|
|
184
|
+
options: [{ name: 'json', description: 'Output as JSON', type: 'boolean', default: false }],
|
|
185
|
+
action: statusAction,
|
|
186
|
+
};
|
|
187
|
+
async function switchAction(ctx) {
|
|
188
|
+
const session = readSession(ctx.cwd);
|
|
189
|
+
if (!session)
|
|
190
|
+
return noSession(ctx);
|
|
191
|
+
const now = new Date();
|
|
192
|
+
session.aiRole = otherRole(session.aiRole);
|
|
193
|
+
session.lastSwitchAt = now.toISOString();
|
|
194
|
+
session.switches += 1;
|
|
195
|
+
writeSession(ctx.cwd, session);
|
|
196
|
+
if (ctx.flags.json)
|
|
197
|
+
output.printJson(describe(session, now));
|
|
198
|
+
else
|
|
199
|
+
output.printSuccess(`Switched — AI is now ${session.aiRole}, human is ${otherRole(session.aiRole)}.`);
|
|
200
|
+
return { success: true, data: describe(session, now) };
|
|
201
|
+
}
|
|
202
|
+
const switchSub = {
|
|
203
|
+
name: 'switch',
|
|
204
|
+
description: 'Swap driver and navigator roles',
|
|
205
|
+
options: [{ name: 'json', description: 'Output as JSON', type: 'boolean', default: false }],
|
|
206
|
+
action: switchAction,
|
|
207
|
+
};
|
|
208
|
+
async function modeAction(ctx) {
|
|
209
|
+
const session = readSession(ctx.cwd);
|
|
210
|
+
if (!session)
|
|
211
|
+
return noSession(ctx);
|
|
212
|
+
const mode = ctx.args[0];
|
|
213
|
+
if (!isMode(mode)) {
|
|
214
|
+
output.printError(`Usage: ruflo pair mode <${Object.keys(PAIR_MODES).join('|')}>`);
|
|
215
|
+
return { success: false, exitCode: 1 };
|
|
216
|
+
}
|
|
217
|
+
const now = new Date();
|
|
218
|
+
session.mode = mode;
|
|
219
|
+
if (mode === 'switch' && !session.switchIntervalMinutes) {
|
|
220
|
+
session.switchIntervalMinutes = DEFAULT_SWITCH_INTERVAL_MINUTES;
|
|
221
|
+
session.lastSwitchAt = now.toISOString();
|
|
222
|
+
}
|
|
223
|
+
writeSession(ctx.cwd, session);
|
|
224
|
+
if (ctx.flags.json)
|
|
225
|
+
output.printJson(describe(session, now));
|
|
226
|
+
else
|
|
227
|
+
output.printSuccess(`Mode changed to ${mode} — ${PAIR_MODES[mode]}.`);
|
|
228
|
+
return { success: true, data: describe(session, now) };
|
|
229
|
+
}
|
|
230
|
+
const modeSub = {
|
|
231
|
+
name: 'mode',
|
|
232
|
+
description: 'Change the mode of the active session: ruflo pair mode <mode>',
|
|
233
|
+
options: [{ name: 'json', description: 'Output as JSON', type: 'boolean', default: false }],
|
|
234
|
+
action: modeAction,
|
|
235
|
+
};
|
|
236
|
+
async function endAction(ctx) {
|
|
237
|
+
const session = readSession(ctx.cwd);
|
|
238
|
+
if (!session)
|
|
239
|
+
return noSession(ctx);
|
|
240
|
+
session.endedAt = new Date().toISOString();
|
|
241
|
+
fs.appendFileSync(historyPath(ctx.cwd), JSON.stringify(session) + '\n', 'utf-8');
|
|
242
|
+
fs.rmSync(currentPath(ctx.cwd), { force: true });
|
|
243
|
+
if (ctx.flags.json)
|
|
244
|
+
output.printJson(session);
|
|
245
|
+
else
|
|
246
|
+
output.printSuccess(`Pair session ${session.id} ended after ${session.switches} role switch(es).`);
|
|
247
|
+
return { success: true, data: session };
|
|
248
|
+
}
|
|
249
|
+
const endSub = {
|
|
250
|
+
name: 'end',
|
|
251
|
+
description: 'End the active session and append it to the history',
|
|
252
|
+
options: [{ name: 'json', description: 'Output as JSON', type: 'boolean', default: false }],
|
|
253
|
+
action: endAction,
|
|
254
|
+
};
|
|
255
|
+
async function historyAction(ctx) {
|
|
256
|
+
const history = readHistory(ctx.cwd);
|
|
257
|
+
if (ctx.flags.json)
|
|
258
|
+
output.printJson(history);
|
|
259
|
+
else if (history.length === 0)
|
|
260
|
+
output.writeln('No past pair sessions.');
|
|
261
|
+
else
|
|
262
|
+
for (const s of history)
|
|
263
|
+
output.writeln(`${s.id} ${s.mode.padEnd(9)} ${s.startedAt} → ${s.endedAt ?? '?'} (${s.switches} switches)`);
|
|
264
|
+
return { success: true, data: history };
|
|
265
|
+
}
|
|
266
|
+
const historySub = {
|
|
267
|
+
name: 'history',
|
|
268
|
+
description: 'List past pair sessions',
|
|
269
|
+
options: [{ name: 'json', description: 'Output as JSON', type: 'boolean', default: false }],
|
|
270
|
+
action: historyAction,
|
|
271
|
+
};
|
|
272
|
+
export const pairCommand = {
|
|
273
|
+
name: 'pair',
|
|
274
|
+
description: 'Pair programming session: modes, driver/navigator roles, switching',
|
|
275
|
+
subcommands: [startSub, statusSub, switchSub, modeSub, endSub, historySub],
|
|
276
|
+
// Top-level flags kept for the v2 spelling used throughout the skill docs.
|
|
277
|
+
options: [
|
|
278
|
+
{ name: 'start', description: 'Alias for `pair start`', type: 'boolean', default: false },
|
|
279
|
+
{ name: 'status', description: 'Alias for `pair status`', type: 'boolean', default: false },
|
|
280
|
+
{ name: 'end', description: 'Alias for `pair end`', type: 'boolean', default: false },
|
|
281
|
+
{ name: 'history', description: 'Alias for `pair history`', type: 'boolean', default: false },
|
|
282
|
+
...(startSub.options ?? []),
|
|
283
|
+
],
|
|
284
|
+
examples: [
|
|
285
|
+
{ command: 'ruflo pair start --mode tdd', description: 'Start a test-first session with the AI driving' },
|
|
286
|
+
{ command: 'ruflo pair start --mode switch --interval 15m', description: 'Swap roles every 15 minutes' },
|
|
287
|
+
{ command: 'ruflo pair status --json', description: 'Machine-readable state for the agent to read each turn' },
|
|
288
|
+
{ command: 'ruflo pair switch', description: 'Swap driver and navigator now' },
|
|
289
|
+
{ command: 'ruflo pair mode review', description: 'Change mode mid-session' },
|
|
290
|
+
{ command: 'ruflo pair end', description: 'End the session and record it in the history' },
|
|
291
|
+
],
|
|
292
|
+
action: async (ctx) => {
|
|
293
|
+
if (ctx.flags.start)
|
|
294
|
+
return startAction(ctx);
|
|
295
|
+
if (ctx.flags.end)
|
|
296
|
+
return endAction(ctx);
|
|
297
|
+
if (ctx.flags.history)
|
|
298
|
+
return historyAction(ctx);
|
|
299
|
+
return statusAction(ctx);
|
|
300
|
+
},
|
|
301
|
+
};
|
|
302
|
+
export default pairCommand;
|
|
303
|
+
//# sourceMappingURL=pair.js.map
|
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
*
|
|
7
7
|
* @module @claude-flow/cli/mcp-tools/claims
|
|
8
8
|
*/
|
|
9
|
-
import type
|
|
9
|
+
import { type MCPTool } from './types.js';
|
|
10
10
|
export declare const claimsTools: MCPTool[];
|
|
11
11
|
export default claimsTools;
|
|
12
12
|
//# sourceMappingURL=claims-tools.d.ts.map
|
|
@@ -6,19 +6,20 @@
|
|
|
6
6
|
*
|
|
7
7
|
* @module @claude-flow/cli/mcp-tools/claims
|
|
8
8
|
*/
|
|
9
|
+
import { getProjectCwd } from './types.js';
|
|
9
10
|
import { readClaimsStore } from '../services/claims-store.js';
|
|
10
11
|
import { validateIdentifier, validateText } from './validate-input.js';
|
|
11
12
|
// File-based persistence
|
|
12
13
|
import { existsSync, writeFileSync, mkdirSync } from 'fs';
|
|
13
|
-
import {
|
|
14
|
+
import { resolve } from 'path';
|
|
14
15
|
const CLAIMS_DIR = '.claude-flow/claims';
|
|
15
16
|
const CLAIMS_FILE = 'claims.json';
|
|
16
17
|
const DEFAULT_MAX_CLAIMS = 5;
|
|
17
18
|
function getClaimsPath() {
|
|
18
|
-
return resolve(
|
|
19
|
+
return resolve(getProjectCwd(), CLAIMS_DIR, CLAIMS_FILE);
|
|
19
20
|
}
|
|
20
21
|
function ensureClaimsDir() {
|
|
21
|
-
const dir = resolve(CLAIMS_DIR);
|
|
22
|
+
const dir = resolve(getProjectCwd(), CLAIMS_DIR);
|
|
22
23
|
if (!existsSync(dir)) {
|
|
23
24
|
mkdirSync(dir, { recursive: true });
|
|
24
25
|
}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@claude-flow/cli",
|
|
3
|
-
"version": "3.59.
|
|
3
|
+
"version": "3.59.13",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"description": "Ruflo CLI - Enterprise AI agent orchestration with 60+ specialized agents, swarm coordination, MCP server, self-learning hooks, and vector memory for Claude Code",
|
|
6
6
|
"main": "dist/src/index.js",
|