@claude-flow/cli 3.32.26 → 3.32.30

package/node_modules/@claude-flow/security/dist/mcp-composition-inspector.js

@@ -0,0 +1,254 @@
+/**
+ * MCP Tool Composition Inspector — ADR-320 (this ADR; ruvnet/ruflo dream-cycle
+ * proposal, arXiv:2606.27027 "ShareLock").
+ *
+ * The attack: an adversary registers N seemingly-benign MCP tools whose
+ * individual descriptions look fine in isolation, but whose CONCATENATION
+ * (or pairwise overlap) forms an injection payload targeting a downstream
+ * agent — a Shamir-secret-sharing-style split across tool descriptions.
+ * Per-tool inspection misses this because each fragment sits under any
+ * single-tool detection threshold.
+ *
+ * Relationship to prior art in this repo
+ * ---------------------------------------
+ * A CLI-only v1 of this idea already shipped directly to `main`
+ * (dream-cycle #2783, commits 381b7ebcc/581cd2bf3) as
+ * `v3/@claude-flow/cli/src/security/mcp-composition-inspector.ts` — an
+ * on-demand `ruflo security composition-scan` command using exact
+ * common-substring matching plus an injection-phrase catalog and
+ * typosquat check. That module's own header explicitly scopes itself as
+ * "a bounded engineering fix rather than an ADR-scope subsystem" and lists
+ * "Future v2: SimHash + LSH for scale" as deliberately deferred. THIS
+ * module is that v2: a reusable `@claude-flow/security` library primitive
+ * (not a CLI-only tool) built around a real SimHash fingerprint, so it can
+ * be called from a pre-task/pre-tool-use hook before a multi-tool chain
+ * executes, per this ADR's implementation target. It does not replace or
+ * import the CLI v1 — the two are independent, complementary detectors
+ * (exact-substring vs. hashed-shingle-overlap) that a caller may run
+ * together.
+ *
+ * Detection method (deterministic, no LLM call)
+ * -----------------------------------------------
+ * 1. Each tool description is normalized and split into overlapping
+ *    word-shingles (default: 5-word windows). Shingling — rather than
+ *    whole-description comparison — is what lets us find a SMALL embedded
+ *    fragment inside an otherwise unrelated, benign description.
+ * 2. Each tool gets a 64-bit SimHash fingerprint: every shingle is hashed
+ *    (FNV-1a, 64-bit) and the fingerprint bits are set by majority vote
+ *    across all of a tool's shingle hashes. Two tools whose descriptions
+ *    share enough content have a SMALL Hamming distance between
+ *    fingerprints — this is the O(1)-per-pair coarse filter that avoids an
+ *    LLM call and stays cheap even at hundreds of registered tools (fast
+ *    64-bit XOR + popcount per pair).
+ * 3. An inverted shingle-hash index (hash -> set of tool indices) is built
+ *    once, in O(total shingles). For each pair flagged by the SimHash
+ *    filter (or found in the index) the SAME index is used to compute the
+ *    actual overlapping shingle text — this is what makes the finding
+ *    reportable (the SimHash score alone can't tell an operator *what*
+ *    matched).
+ * 4. A fragment's "population" (how many distinct tools carry it) caps
+ *    false positives: shared shingles that appear in more than
+ *    `maxFragmentPopulation` (default 3) tools are template language
+ *    (e.g. every ruflo `memory_*` tool's boilerplate), not an attack —
+ *    Shamir-split attacks concentrate a fragment in a small conspiracy of
+ *    2-3 tools. Same population-cap idea as the CLI v1, reimplemented here
+ *    against the hash index instead of raw substrings.
+ *
+ * This is a heuristic detector, not a security boundary: it reports
+ * SUSPECTS. Default action is warn + log; blocking is opt-in via
+ * `CLAUDE_FLOW_MCP_COMPOSITION_BLOCK=1` (see {@link evaluateToolComposition}).
+ *
+ * @module @claude-flow/security/mcp-composition-inspector
+ */
+// ============================================================================
+// SimHash primitives (plain TS, no dependency)
+// ============================================================================
+const FNV_OFFSET_BASIS_64 = 0xcbf29ce484222325n;
+const FNV_PRIME_64 = 0x100000001b3n;
+const MASK_64 = (1n << 64n) - 1n;
+/** FNV-1a, 64-bit. Deterministic, dependency-free, good avalanche for short strings. */
+export function fnv1a64(input) {
+    let hash = FNV_OFFSET_BASIS_64;
+    for (let i = 0; i < input.length; i++) {
+        hash ^= BigInt(input.charCodeAt(i));
+        hash = (hash * FNV_PRIME_64) & MASK_64;
+    }
+    return hash;
+}
+/**
+ * Classic SimHash: bit-vote a 64-bit fingerprint across a list of token
+ * hashes. Near-duplicate token sets (even with some fragments differing)
+ * produce fingerprints with a small Hamming distance.
+ */
+export function simhash64(shingles) {
+    if (shingles.length === 0)
+        return 0n;
+    const bitVotes = new Array(64).fill(0);
+    for (const shingle of shingles) {
+        const h = fnv1a64(shingle);
+        for (let bit = 0; bit < 64; bit++) {
+            const set = (h >> BigInt(bit)) & 1n;
+            bitVotes[bit] += set === 1n ? 1 : -1;
+        }
+    }
+    let fingerprint = 0n;
+    for (let bit = 0; bit < 64; bit++) {
+        if (bitVotes[bit] > 0)
+            fingerprint |= 1n << BigInt(bit);
+    }
+    return fingerprint;
+}
+/** Hamming distance between two 64-bit fingerprints (0..64). */
+export function hammingDistance64(a, b) {
+    let x = (a ^ b) & MASK_64;
+    let count = 0;
+    while (x > 0n) {
+        count += Number(x & 1n);
+        x >>= 1n;
+    }
+    return count;
+}
+// ============================================================================
+// Shingling
+// ============================================================================
+function normalize(text) {
+    return text.toLowerCase().replace(/\s+/g, ' ').trim();
+}
+/** Overlapping word-shingles of `k` words each. Falls back to the whole (short) text as a single shingle. */
+function wordShingles(text, k) {
+    const words = normalize(text).split(' ').filter(Boolean);
+    if (words.length === 0)
+        return [];
+    if (words.length < k)
+        return [words.join(' ')];
+    const shingles = [];
+    for (let i = 0; i + k <= words.length; i++) {
+        shingles.push(words.slice(i, i + k).join(' '));
+    }
+    return shingles;
+}
+export function inspectToolComposition(tools, options = {}) {
+    const shingleSize = options.shingleSize ?? 5;
+    const simhashThreshold = options.simhashThreshold ?? 0.6;
+    const fragmentOverlapThreshold = options.fragmentOverlapThreshold ?? 0.25;
+    const maxFragmentPopulation = options.maxFragmentPopulation ?? 3;
+    const minShingleChars = options.minShingleChars ?? 12;
+    const maxSampleFragments = options.maxSampleFragments ?? 5;
+    const indexed = tools.map((t, idx) => {
+        const shingles = wordShingles(t.description, shingleSize).filter((s) => s.length >= minShingleChars);
+        const hashKeys = new Set(shingles.map((s) => fnv1a64(s).toString(36)));
+        return {
+            idx,
+            name: t.name,
+            shingles,
+            hashKeys,
+            fingerprint: simhash64(shingles),
+        };
+    });
+    // Inverted index: shingle-hash -> {tools that carry it, sample text}.
+    const shingleToTools = new Map();
+    const shingleSampleText = new Map();
+    for (const t of indexed) {
+        for (const shingle of t.shingles) {
+            const key = fnv1a64(shingle).toString(36);
+            const set = shingleToTools.get(key) ?? new Set();
+            set.add(t.idx);
+            shingleToTools.set(key, set);
+            if (!shingleSampleText.has(key))
+                shingleSampleText.set(key, shingle);
+        }
+    }
+    const findings = [];
+    const stats = {
+        toolsScanned: tools.length,
+        pairsCompared: 0,
+        shinglesIndexed: shingleToTools.size,
+        candidatePairsFromSimhash: 0,
+    };
+    for (let i = 0; i < indexed.length; i++) {
+        for (let j = i + 1; j < indexed.length; j++) {
+            stats.pairsCompared++;
+            const a = indexed[i];
+            const b = indexed[j];
+            const hamming = hammingDistance64(a.fingerprint, b.fingerprint);
+            const simhashSimilarity = a.shingles.length > 0 && b.shingles.length > 0 ? 1 - hamming / 64 : 0;
+            if (simhashSimilarity >= simhashThreshold)
+                stats.candidatePairsFromSimhash++;
+            // Low-population shared shingles between this pair, via the inverted index.
+            let sharedCount = 0;
+            let maxPopulationSeen = 0;
+            const sample = [];
+            for (const key of a.hashKeys) {
+                if (!b.hashKeys.has(key))
+                    continue;
+                const population = shingleToTools.get(key)?.size ?? 0;
+                if (population > maxFragmentPopulation)
+                    continue; // template language, not an attack signature
+                sharedCount++;
+                maxPopulationSeen = Math.max(maxPopulationSeen, population);
+                if (sample.length < maxSampleFragments) {
+                    const text = shingleSampleText.get(key);
+                    if (text)
+                        sample.push(text);
+                }
+            }
+            const minShingleCount = Math.max(1, Math.min(a.shingles.length, b.shingles.length));
+            const fragmentOverlapScore = sharedCount / minShingleCount;
+            const flagBySimhash = simhashSimilarity >= simhashThreshold && sharedCount > 0;
+            const flagByFragment = fragmentOverlapScore >= fragmentOverlapThreshold && sharedCount > 0;
+            if (!flagBySimhash && !flagByFragment)
+                continue;
+            findings.push({
+                toolA: a.name,
+                toolB: b.name,
+                simhashSimilarity: Number(simhashSimilarity.toFixed(3)),
+                fragmentOverlapScore: Number(fragmentOverlapScore.toFixed(3)),
+                sharedFragments: sample,
+                fragmentPopulation: maxPopulationSeen,
+                reason: flagBySimhash
+                    ? `SimHash similarity ${simhashSimilarity.toFixed(2)} (Hamming distance ${hamming}/64) with ${sharedCount} low-population shared shingle(s) (population <= ${maxFragmentPopulation}) — possible cross-tool instruction fragment`
+                    : `Fragment overlap ${fragmentOverlapScore.toFixed(2)} (${sharedCount}/${minShingleCount} shingles shared, population <= ${maxFragmentPopulation}) — possible Shamir-split instruction fragment`,
+            });
+        }
+    }
+    return { findings, stats };
+}
+// ============================================================================
+// Guard: env-var-gated warn/block decision
+// ============================================================================
+const COMPOSITION_BLOCK_ENV = 'CLAUDE_FLOW_MCP_COMPOSITION_BLOCK';
+/** Reads `CLAUDE_FLOW_MCP_COMPOSITION_BLOCK` fresh on every call. '1' or 'true' (case-insensitive) enables blocking; unset/anything else keeps the default warn+log posture. */
+export function isCompositionBlockEnabled() {
+    const raw = process.env[COMPOSITION_BLOCK_ENV];
+    return raw === '1' || raw?.toLowerCase() === 'true';
+}
+/**
+ * Runs {@link inspectToolComposition} and applies the ADR-320 default
+ * posture: warn + log (via `console.warn`) unless
+ * `CLAUDE_FLOW_MCP_COMPOSITION_BLOCK=1`, in which case the chain is marked
+ * `blocked: true` — the caller (the pre-task hook / MCP dispatcher) decides
+ * what "blocked" means operationally; this function does not throw or abort
+ * anything itself.
+ */
+export function evaluateToolComposition(tools, options = {}) {
+    const result = inspectToolComposition(tools, options);
+    if (result.findings.length === 0) {
+        return { result, action: 'none', blocked: false };
+    }
+    const summary = `MCP Composition Inspector: ${result.findings.length} suspicious cross-tool fragment(s) ` +
+        `across ${result.stats.toolsScanned} tools (${result.stats.pairsCompared} pairs compared)`;
+    if (isCompositionBlockEnabled()) {
+        const message = `${summary} — blocking chain (${COMPOSITION_BLOCK_ENV}=1)`;
+        console.warn(`[mcp-composition-inspector] ${message}`);
+        for (const f of result.findings) {
+            console.warn(`  - ${f.toolA} <-> ${f.toolB}: ${f.reason}`);
+        }
+        return { result, action: 'block', blocked: true, message };
+    }
+    console.warn(`[mcp-composition-inspector] ${summary}`);
+    for (const f of result.findings) {
+        console.warn(`  - ${f.toolA} <-> ${f.toolB}: ${f.reason}`);
+    }
+    return { result, action: 'warn', blocked: false, message: summary };
+}
+//# sourceMappingURL=mcp-composition-inspector.js.map

package/node_modules/@claude-flow/security/dist/mcp-composition-inspector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-composition-inspector.js","sourceRoot":"","sources":["../src/mcp-composition-inspector.ts"],"names":[],"mappings":"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"}

package/node_modules/@claude-flow/security/dist/oauth/browser.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Opens the system default browser for the `ruflo auth login` flow. A
+ * TypeScript port of meta-proxy's `src/oauth/browser.rs`.
+ *
+ * Deliberately does NOT go through `SafeExecutor.execute()`: `SafeExecutor`'s
+ * blocked-argument patterns (`safe-executor.ts`'s `DEFAULT_BLOCKED_PATTERNS`)
+ * include a bare `&`, which is meant to catch shell-metacharacter injection in
+ * command-line-style arguments — but it also appears in every real OAuth
+ * authorize URL's query string (`?a=1&b=2&...`), so passing one through would
+ * false-positive-reject on every real invocation. That blocklist is the wrong
+ * tool for a URL argument: with `shell: false` (used here, same as
+ * `SafeExecutor`), a single argv element containing `&` is inert — there's no
+ * shell to interpret it. The actual safety property that matters is "the URL
+ * was constructed by us from validated components, never from raw external
+ * input" (this module's `authorizeUrl()` in `client.ts` is the only caller),
+ * which `assertSafeUrl` below checks directly instead.
+ *
+ * @module v3/security/oauth/browser
+ */
+/**
+ * Attempts to open `url` in the system default browser. Resolves whether or
+ * not a browser window actually appeared — this cannot be confirmed in
+ * general, which is why the caller always also prints the URL as a fallback.
+ */
+export declare function openBrowser(url: string): Promise<void>;
+/** Pure command selection, exported for platform regression tests. */
+export declare function browserCommand(url: string, platform?: NodeJS.Platform): {
+    cmd: string;
+    args: string[];
+};
+//# sourceMappingURL=browser.d.ts.map

package/node_modules/@claude-flow/security/dist/oauth/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/oauth/browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAYH;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQtD;AAED,sEAAsE;AACtE,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAWzH"}

package/node_modules/@claude-flow/security/dist/oauth/browser.js

@@ -0,0 +1,55 @@
+/**
+ * Opens the system default browser for the `ruflo auth login` flow. A
+ * TypeScript port of meta-proxy's `src/oauth/browser.rs`.
+ *
+ * Deliberately does NOT go through `SafeExecutor.execute()`: `SafeExecutor`'s
+ * blocked-argument patterns (`safe-executor.ts`'s `DEFAULT_BLOCKED_PATTERNS`)
+ * include a bare `&`, which is meant to catch shell-metacharacter injection in
+ * command-line-style arguments — but it also appears in every real OAuth
+ * authorize URL's query string (`?a=1&b=2&...`), so passing one through would
+ * false-positive-reject on every real invocation. That blocklist is the wrong
+ * tool for a URL argument: with `shell: false` (used here, same as
+ * `SafeExecutor`), a single argv element containing `&` is inert — there's no
+ * shell to interpret it. The actual safety property that matters is "the URL
+ * was constructed by us from validated components, never from raw external
+ * input" (this module's `authorizeUrl()` in `client.ts` is the only caller),
+ * which `assertSafeUrl` below checks directly instead.
+ *
+ * @module v3/security/oauth/browser
+ */
+import { execFile } from 'node:child_process';
+/** Throws if `url` isn't a well-formed https/http URL — the one check that matters here. */
+function assertSafeUrl(url) {
+    const parsed = new URL(url); // throws on malformed input
+    if (parsed.protocol !== 'https:' && parsed.protocol !== 'http:') {
+        throw new Error(`refusing to open non-http(s) URL scheme: ${parsed.protocol}`);
+    }
+}
+/**
+ * Attempts to open `url` in the system default browser. Resolves whether or
+ * not a browser window actually appeared — this cannot be confirmed in
+ * general, which is why the caller always also prints the URL as a fallback.
+ */
+export function openBrowser(url) {
+    assertSafeUrl(url);
+    const { cmd, args } = browserCommand(url);
+    return new Promise((resolve) => {
+        execFile(cmd, args, { shell: false, windowsHide: true }, () => resolve());
+    });
+}
+/** Pure command selection, exported for platform regression tests. */
+export function browserCommand(url, platform = process.platform) {
+    assertSafeUrl(url);
+    if (platform === 'darwin') {
+        return { cmd: 'open', args: [url] };
+    }
+    else if (platform === 'win32') {
+        // cmd.exe treats OAuth query-string `&` separators as command operators,
+        // truncating the URL before client_id. Use the URL handler without a shell.
+        return { cmd: 'rundll32.exe', args: ['url.dll,FileProtocolHandler', url] };
+    }
+    else {
+        return { cmd: 'xdg-open', args: [url] };
+    }
+}
+//# sourceMappingURL=browser.js.map

package/node_modules/@claude-flow/security/dist/oauth/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../src/oauth/browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,4FAA4F;AAC5F,SAAS,aAAa,CAAC,GAAW;IAChC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,4BAA4B;IACzD,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QAChE,MAAM,IAAI,KAAK,CAAC,4CAA4C,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IACjF,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,aAAa,CAAC,GAAG,CAAC,CAAC;IAEnB,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IAE1C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,QAAQ,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;AACL,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,cAAc,CAAC,GAAW,EAAE,WAA4B,OAAO,CAAC,QAAQ;IACtF,aAAa,CAAC,GAAG,CAAC,CAAC;IACnB,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1B,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;IACtC,CAAC;SAAM,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QAChC,yEAAyE;QACzE,4EAA4E;QAC5E,OAAO,EAAE,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,6BAA6B,EAAE,GAAG,CAAC,EAAE,CAAC;IAC7E,CAAC;SAAM,CAAC;QACN,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;IAC1C,CAAC;AACH,CAAC"}

package/node_modules/@claude-flow/security/dist/oauth/callback-server.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Ephemeral-port localhost callback server for the browser-based OAuth flow
+ * (ADR-306). A minimal single-request HTTP server — deliberately not a full
+ * framework for one GET route that lives for one request and then shuts
+ * down. A TypeScript port of meta-proxy's `src/oauth/callback_server.rs`.
+ *
+ * @module v3/security/oauth/callback-server
+ */
+export interface CallbackResult {
+    code: string | null;
+    state: string | null;
+    error: string | null;
+}
+export declare class CallbackTimeoutError extends Error {
+    constructor();
+}
+export declare class CallbackServer {
+    private readonly server;
+    readonly redirectUri: string;
+    readonly port: number;
+    private constructor();
+    /**
+     * Binds `127.0.0.1:0` (OS-assigned ephemeral port) and returns the server
+     * plus the exact `redirect_uri` to send in the authorize request — must be
+     * the `http://127.0.0.1:<port>/oauth/callback` shape identity's
+     * `validate_redirect_uri` accepts.
+     */
+    static bind(): Promise<CallbackServer>;
+    /**
+     * Waits for exactly one `GET /oauth/callback?...` request, replies with the
+     * browser success page, closes the server, and returns the parsed query
+     * parameters. Times out after `waitForMs` so a login attempt the user
+     * abandons in the browser doesn't hang the CLI forever.
+     */
+    awaitCallback(waitForMs?: number): Promise<CallbackResult>;
+}
+//# sourceMappingURL=callback-server.d.ts.map

package/node_modules/@claude-flow/security/dist/oauth/callback-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"callback-server.d.ts","sourceRoot":"","sources":["../../src/oauth/callback-server.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAeD,qBAAa,oBAAqB,SAAQ,KAAK;;CAK9C;AAED,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,MAAM;aACP,WAAW,EAAE,MAAM;aACnB,IAAI,EAAE,MAAM;IAH9B,OAAO;IAMP;;;;;OAKG;WACU,IAAI,IAAI,OAAO,CAAC,cAAc,CAAC;IAa5C;;;;;OAKG;IACG,aAAa,CAAC,SAAS,SAAqB,GAAG,OAAO,CAAC,cAAc,CAAC;CA0B7E"}

package/node_modules/@claude-flow/security/dist/oauth/callback-server.js

@@ -0,0 +1,86 @@
+/**
+ * Ephemeral-port localhost callback server for the browser-based OAuth flow
+ * (ADR-306). A minimal single-request HTTP server — deliberately not a full
+ * framework for one GET route that lives for one request and then shuts
+ * down. A TypeScript port of meta-proxy's `src/oauth/callback_server.rs`.
+ *
+ * @module v3/security/oauth/callback-server
+ */
+import { createServer } from 'node:http';
+const SUCCESS_PAGE = `<html>
+<body style="background:#0a0a0a; color:#f5f5f5; font-family:sans-serif;
+    display:flex; align-items:center; justify-content:center;
+    height:100vh; margin:0;">
+    <div style="text-align:center;">
+    <h1>&#10003; ruflo login successful</h1>
+    <p>You can close this tab and return to your terminal.</p>
+    </div>
+</body>
+</html>`;
+const DEFAULT_TIMEOUT_MS = 5 * 60 * 1000; // 5 minutes, matches meta-proxy's CALLBACK_TIMEOUT
+export class CallbackTimeoutError extends Error {
+    constructor() {
+        super('timed out waiting for OAuth callback');
+        this.name = 'CallbackTimeoutError';
+    }
+}
+export class CallbackServer {
+    server;
+    redirectUri;
+    port;
+    constructor(server, redirectUri, port) {
+        this.server = server;
+        this.redirectUri = redirectUri;
+        this.port = port;
+    }
+    /**
+     * Binds `127.0.0.1:0` (OS-assigned ephemeral port) and returns the server
+     * plus the exact `redirect_uri` to send in the authorize request — must be
+     * the `http://127.0.0.1:<port>/oauth/callback` shape identity's
+     * `validate_redirect_uri` accepts.
+     */
+    static async bind() {
+        return new Promise((resolve, reject) => {
+            const server = createServer();
+            server.once('error', reject);
+            server.listen(0, '127.0.0.1', () => {
+                server.removeListener('error', reject);
+                const addr = server.address();
+                const redirectUri = `http://127.0.0.1:${addr.port}/oauth/callback`;
+                resolve(new CallbackServer(server, redirectUri, addr.port));
+            });
+        });
+    }
+    /**
+     * Waits for exactly one `GET /oauth/callback?...` request, replies with the
+     * browser success page, closes the server, and returns the parsed query
+     * parameters. Times out after `waitForMs` so a login attempt the user
+     * abandons in the browser doesn't hang the CLI forever.
+     */
+    async awaitCallback(waitForMs = DEFAULT_TIMEOUT_MS) {
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.server.close();
+                reject(new CallbackTimeoutError());
+            }, waitForMs);
+            this.server.once('request', (req, res) => {
+                clearTimeout(timer);
+                const url = new URL(req.url ?? '/oauth/callback', 'http://127.0.0.1');
+                const result = {
+                    code: url.searchParams.get('code'),
+                    state: url.searchParams.get('state'),
+                    error: url.searchParams.get('error'),
+                };
+                res.writeHead(200, {
+                    'content-type': 'text/html; charset=utf-8',
+                    connection: 'close',
+                });
+                res.end(SUCCESS_PAGE, () => {
+                    this.server.close();
+                    resolve(result);
+                });
+            });
+        });
+    }
+}
+//# sourceMappingURL=callback-server.js.map

package/node_modules/@claude-flow/security/dist/oauth/callback-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"callback-server.js","sourceRoot":"","sources":["../../src/oauth/callback-server.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAe,MAAM,WAAW,CAAC;AAStD,MAAM,YAAY,GAAG;;;;;;;;;QASb,CAAC;AAET,MAAM,kBAAkB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,mDAAmD;AAE7F,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC7C;QACE,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED,MAAM,OAAO,cAAc;IAEN;IACD;IACA;IAHlB,YACmB,MAAc,EACf,WAAmB,EACnB,IAAY;QAFX,WAAM,GAAN,MAAM,CAAQ;QACf,gBAAW,GAAX,WAAW,CAAQ;QACnB,SAAI,GAAJ,IAAI,CAAQ;IAC3B,CAAC;IAEJ;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,IAAI;QACf,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;YAC9B,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC7B,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE;gBACjC,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;gBACvC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,EAAiB,CAAC;gBAC7C,MAAM,WAAW,GAAG,oBAAoB,IAAI,CAAC,IAAI,iBAAiB,CAAC;gBACnE,OAAO,CAAC,IAAI,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YAC9D,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,aAAa,CAAC,SAAS,GAAG,kBAAkB;QAChD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;gBACpB,MAAM,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;YACrC,CAAC,EAAE,SAAS,CAAC,CAAC;YAEd,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;gBACvC,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,iBAAiB,EAAE,kBAAkB,CAAC,CAAC;gBACtE,MAAM,MAAM,GAAmB;oBAC7B,IAAI,EAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC;oBAClC,KAAK,EAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC;oBACpC,KAAK,EAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC;iBACrC,CAAC;gBACF,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE;oBACjB,cAAc,EAAE,0BAA0B;oBAC1C,UAAU,EAAE,OAAO;iBACpB,CAAC,CAAC;gBACH,GAAG,CAAC,GAAG,CAAC,YAAY,EAAE,GAAG,EAAE;oBACzB,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;oBACpB,OAAO,CAAC,MAAM,CAAC,CAAC;gBAClB,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/node_modules/@claude-flow/security/dist/oauth/client.d.ts

@@ -0,0 +1,57 @@
+/**
+ * HTTP client for `auth.cognitum.one`'s OAuth surface (ADR-306): authorize
+ * URL construction, `POST /oauth/token` (`authorization_code` and
+ * `refresh_token` grants), and `POST /v1/oauth/code-exchange` (OOB fallback).
+ *
+ * A TypeScript port of meta-proxy's `src/oauth/client.rs`
+ * (cognitum-one/meta-proxy) — same base URL, same endpoints, same
+ * form/query parameter names, confirmed live 2026-07-16 (a real
+ * `GET /oauth/authorize?...&client_id=meta-proxy&redirect_uri=<ruflo-controlled
+ * loopback>` returns a working consent page, not a redirect_uri-mismatch
+ * error — so this client reuses meta-proxy's registered `client_id` rather
+ * than requiring a new one).
+ *
+ * Deliberately NOT `api.cognitum.one/v1/auth/*` — that's what ruflo's own
+ * checked-in OpenAPI spec (v3/docs/api/cognitum-v1.openapi.yaml, ADR-308)
+ * describes, but it does not match what the real identity server serves.
+ * This client targets the proven, live surface instead.
+ *
+ * @module v3/security/oauth/client
+ */
+export declare const CLIENT_ID = "meta-proxy";
+export declare const SCOPE = "inference";
+/** RFC 8252 out-of-band sentinel — the OOB/manual-paste flow's `redirect_uri`. */
+export declare const OOB_REDIRECT_URI = "urn:ietf:wg:oauth:2.0:oob";
+export interface TokenResponse {
+    access_token: string;
+    token_type: string;
+    account_email?: string;
+    refresh_token?: string;
+    expires_in?: number;
+}
+export declare class OAuthError extends Error {
+    readonly code: 'network' | 'protocol' | 'unexpected_shape';
+    readonly oauthError?: string | undefined;
+    readonly oauthDescription?: string | undefined;
+    constructor(message: string, code: 'network' | 'protocol' | 'unexpected_shape', oauthError?: string | undefined, oauthDescription?: string | undefined);
+}
+/** Builds the `/oauth/authorize` URL for the standard loopback-redirect flow. */
+export declare function authorizeUrl(redirectUri: string, state: string, codeChallenge: string): string;
+/** `POST /oauth/token` with `grant_type=authorization_code`. */
+export declare function exchangeCode(code: string, codeVerifier: string, redirectUri: string, base?: string): Promise<TokenResponse>;
+/**
+ * `POST /oauth/token` with `grant_type=refresh_token`. identity rotates
+ * refresh tokens with reuse detection: presenting a refresh token returns a
+ * NEW refresh token and revokes the old one, and re-presenting a spent one
+ * revokes the whole session family. Callers MUST persist the returned
+ * `refresh_token` atomically before using the new access token, and must
+ * never retry a failed refresh with the same token.
+ */
+export declare function refreshToken(refreshTokenValue: string, base?: string): Promise<TokenResponse>;
+/**
+ * `POST /v1/oauth/code-exchange` — the OOB manual-entry fallback for
+ * headless/SSH/container environments where no browser round-trip to
+ * `127.0.0.1` is reachable.
+ */
+export declare function exchangeManualCode(code: string, codeVerifier: string, base?: string): Promise<TokenResponse>;
+//# sourceMappingURL=client.d.ts.map

package/node_modules/@claude-flow/security/dist/oauth/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/oauth/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,eAAO,MAAM,SAAS,eAAe,CAAC;AACtC,eAAO,MAAM,KAAK,cAAc,CAAC;AACjC,kFAAkF;AAClF,eAAO,MAAM,gBAAgB,8BAA8B,CAAC;AAO5D,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAOD,qBAAa,UAAW,SAAQ,KAAK;aAGjB,IAAI,EAAE,SAAS,GAAG,UAAU,GAAG,kBAAkB;aACjD,UAAU,CAAC,EAAE,MAAM;aACnB,gBAAgB,CAAC,EAAE,MAAM;gBAHzC,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,SAAS,GAAG,UAAU,GAAG,kBAAkB,EACjD,UAAU,CAAC,EAAE,MAAM,YAAA,EACnB,gBAAgB,CAAC,EAAE,MAAM,YAAA;CAK5C;AAED,iFAAiF;AACjF,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAU9F;AAsCD,gEAAgE;AAChE,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,IAAI,SAAgB,GACnB,OAAO,CAAC,aAAa,CAAC,CAMxB;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,iBAAiB,EAAE,MAAM,EAAE,IAAI,SAAgB,GAAG,OAAO,CAAC,aAAa,CAAC,CAE1G;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,IAAI,SAAgB,GACnB,OAAO,CAAC,aAAa,CAAC,CAYxB"}