🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
TypeScript agentic-aiagentic-frameworkagentic-workflowagentsai-agentsai-assistantai-skillsautonomous-agentsclaudecodexdsh-pluginharnessmcp-servermulti-agentmulti-agent-systemsnpmskillsswarmswarm-intelligencetypescript
fix(release): enforce CI and idle assignment safety
ruv13cbd697db55
diff --git a/.claude/settings.json b/.claude/settings.jsonindex a0ae84123e..5f83a499eb 100644--- a/.claude/settings.json+++ b/.claude/settings.json@@ -174,7 +174,7 @@"taskListEnabled": true,"mailboxEnabled": true,"coordination": {- "autoAssignOnIdle": true,+ "autoAssignOnIdle": false,"trainPatternsOnComplete": true,"notifyLeadOnComplete": true,"sharedMemoryNamespace": "agent-teams"@@ -182,7 +182,7 @@"hooks": {"teammateIdle": {"enabled": true,- "autoAssign": true,+ "autoAssign": false,"checkTaskList": true},"taskCompleted": {diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.ymlindex d21cf3e810..93e702b547 100644--- a/.github/workflows/ci.yml+++ b/.github/workflows/ci.yml@@ -73,20 +73,18 @@ jobs:uses: ./.github/actions/npm-ci-retry- name: Run all tests- run: npm test || echo "⚠️ Some tests failed (Jest teardown issues - non-blocking)"- continue-on-error: true-- - name: Generate coverage report- if: matrix.os == 'ubuntu-latest'- run: npm run test:coverage || echo "⚠️ Coverage generation failed (non-blocking)"- continue-on-error: true+ # #3030: the historical suite has known debt, but new failing files+ # are release-blocking. The committed file-level baseline may only+ # shrink; replacing an old failure with a new one still fails.+ run: node scripts/ci-test-ratchet.mjs- name: Upload test resultsif: always()uses: actions/upload-artifact@v4with:name: test-results-${{ matrix.os }}- path: coverage/+ path: .test-results/vitest.json+ if-no-files-found: error# Documentation generationdocs:@@ -314,4 +312,4 @@ jobs:echo "✅ CI Pipeline completed"echo "Security: ${{ needs.security.result }}"echo "Test: ${{ needs.test.result }}"- echo "Build: ${{ needs.build.result }}"\ No newline at end of file+ echo "Build: ${{ needs.build.result }}"diff --git a/package-lock.json b/package-lock.jsonindex 872d4870b4..6628e892ef 100644--- a/package-lock.json+++ b/package-lock.json@@ -1,12 +1,12 @@{"name": "claude-flow",- "version": "3.38.11",+ "version": "3.38.12","lockfileVersion": 3,"requires": true,"packages": {"": {"name": "claude-flow",- "version": "3.38.11",+ "version": "3.38.12","bundleDependencies": ["@claude-flow/codex","@claude-flow/mcp",diff --git a/package.json b/package.jsonindex aa82563ec9..00ab664200 100644--- a/package.json+++ b/package.json@@ -1,6 +1,6 @@{"name": "claude-flow",- "version": "3.38.11",+ "version": "3.38.12","workspaces": ["v3/@claude-flow/codex","v3/@claude-flow/plugin-agent-federation",diff --git a/ruflo/package.json b/ruflo/package.jsonindex 6fa9276529..5a0a816fdb 100644--- a/ruflo/package.json+++ b/ruflo/package.json@@ -1,6 +1,6 @@{"name": "ruflo",- "version": "3.38.11",+ "version": "3.38.12","description": "Ruflo - Enterprise AI agent orchestration platform. Deploy 60+ specialized agents in coordinated swarms with self-learning, fault-tolerant consensus, vector memory, and MCP integration","main": "bin/ruflo.js","type": "module",diff --git a/scripts/__tests__/ci-test-ratchet.test.mjs b/scripts/__tests__/ci-test-ratchet.test.mjsnew file mode 100644index 0000000000..5af1eb4395--- /dev/null+++ b/scripts/__tests__/ci-test-ratchet.test.mjs@@ -0,0 +1,42 @@+import { describe, expect, it } from 'vitest';+import { evaluateTestReport } from '../ci-test-ratchet.mjs';++const root = '/repo';++describe('CI test failure ratchet (#3030)', () => {+ it('permits only failures already named by the baseline', () => {+ const result = evaluateTestReport({+ success: false,+ testResults: [+ { name: '/repo/tests/known.test.ts', status: 'failed' },+ { name: '/repo/tests/green.test.ts', status: 'passed' },+ ],+ }, ['tests/known.test.ts'], root);++ expect(result.ok).toBe(true);+ expect(result.unexpected).toEqual([]);+ });++ it('fails when a new file starts failing even if the total count is unchanged', () => {+ const result = evaluateTestReport({+ success: false,+ testResults: [{ name: '/repo/tests/new-regression.test.ts', status: 'failed' }],+ }, ['tests/old-debt.test.ts'], root);++ expect(result.ok).toBe(false);+ expect(result.unexpected).toEqual(['tests/new-regression.test.ts']);+ expect(result.fixed).toEqual(['tests/old-debt.test.ts']);+ });++ it('fails closed when Vitest fails without a file-level result', () => {+ const result = evaluateTestReport({ success: false, testResults: [] }, [], root);++ expect(result.ok).toBe(false);+ expect(result.error).toMatch(/without identifying/);+ });++ it('fails closed for an empty or malformed report', () => {+ expect(evaluateTestReport({ success: true, testResults: [] }, [], root).ok).toBe(false);+ expect(evaluateTestReport({}, [], root).ok).toBe(false);+ });+});diff --git a/scripts/ci-test-baseline.txt b/scripts/ci-test-baseline.txtnew file mode 100644index 0000000000..a901ff71c1--- /dev/null+++ b/scripts/ci-test-baseline.txt@@ -0,0 +1,121 @@+# Monotone-decreasing file-level failure baseline for .github/workflows/ci.yml.+# Source: origin/main 45e65b5dae5d2c312e70cd5ba90df0701ea05c28+# Evidence: GitHub Actions run 31859043593 (116 failing test files).+# Remove entries when fixed. Never add entries to make a regression green.+plugins/ruflo-adr/scripts/__tests__/adr-create-schema-2651.test.mjs+plugins/ruflo-adr/scripts/__tests__/index-idempotency-2660.test.mjs+plugins/ruflo-adr/scripts/__tests__/parser-bullets-2659.test.mjs+plugins/ruflo-adr/scripts/__tests__/skip-brain-dir-2911.test.mjs+plugins/ruflo-business-pods/scripts/pod-tick.test.mjs+plugins/ruflo-core/scripts/mcp-launch.test.cjs+plugins/ruflo-workflows/scripts/gaia-audit.test.mjs+ruflo/src/ruvocal/src/lib/components/chat/MarkdownRenderer.svelte.test.ts+ruflo/src/ruvocal/src/lib/migrations/migrations.spec.ts+ruflo/src/ruvocal/src/lib/migrations/routines/09-delete-empty-conversations.spec.ts+ruflo/src/ruvocal/src/lib/server/__tests__/conversation-stop-generating.spec.ts+ruflo/src/ruvocal/src/lib/server/api/__tests__/conversations-id.spec.ts+ruflo/src/ruvocal/src/lib/server/api/__tests__/conversations-message.spec.ts+ruflo/src/ruvocal/src/lib/server/api/__tests__/conversations.spec.ts+ruflo/src/ruvocal/src/lib/server/api/__tests__/misc.spec.ts+ruflo/src/ruvocal/src/lib/server/api/__tests__/user-reports.spec.ts+ruflo/src/ruvocal/src/lib/server/api/__tests__/user.spec.ts+ruflo/src/ruvocal/src/lib/server/database/__tests__/rvf.spec.ts+ruflo/src/ruvocal/src/lib/server/isURLLocal.spec.ts+ruflo/src/ruvocal/src/lib/server/mcp/clientPool.spec.ts+ruflo/src/ruvocal/src/lib/server/textGeneration/mcp/wasmTools.test.ts+ruflo/src/ruvocal/src/lib/utils/generationState.spec.ts+ruflo/src/ruvocal/src/lib/utils/marked.spec.ts+ruflo/src/ruvocal/src/lib/utils/messageUpdates.spec.ts+ruflo/src/ruvocal/src/lib/utils/template.spec.ts+ruflo/src/ruvocal/src/lib/utils/toolProgress.spec.ts+ruflo/src/ruvocal/src/lib/utils/tree/addChildren.spec.ts+ruflo/src/ruvocal/src/lib/utils/tree/addSibling.spec.ts+ruflo/src/ruvocal/src/lib/utils/tree/buildSubtree.spec.ts+ruflo/src/ruvocal/src/lib/utils/tree/convertLegacyConversation.spec.ts+ruflo/src/ruvocal/src/lib/utils/tree/isMessageId.spec.ts+ruflo/src/ruvocal/src/lib/utils/tree/treeHelpers.spec.ts+ruflo/src/ruvocal/src/lib/wasm/tests/wasm-capabilities.test.ts+ruflo/src/ruvocal/src/routes/login/callback/updateUser.spec.ts+scripts/__tests__/audit-supply-chain.test.mjs+scripts/__tests__/stage-internal-runtime-bundles.test.mjs+tests/context-persistence-hook.test.mjs+tests/hook-handler-runwithtimeout.test.cjs+tests/rvf-backend.test.ts+tests/rvf-capability-verify.test.ts+tests/rvf-embeddings.test.ts+tests/rvf-event-log.test.ts+tests/rvf-integration.test.ts+tests/rvf-learning-store.test.ts+tests/rvf-migration.test.ts+v3/@claude-flow/cli/__tests__/adr-323-memory-provenance.test.ts+v3/@claude-flow/cli/__tests__/agenticow-tools.test.ts+v3/@claude-flow/cli/__tests__/agntcy/agntcy-commands.test.ts+v3/@claude-flow/cli/__tests__/cli.test.ts+v3/@claude-flow/cli/__tests__/config-loading.test.ts+v3/@claude-flow/cli/__tests__/flywheel-envelope-proposer-contract.test.ts+v3/@claude-flow/cli/__tests__/guidance-brain.test.ts+v3/@claude-flow/cli/__tests__/hooks-intelligence-train-2940.test.ts+v3/@claude-flow/cli/__tests__/hooks-metrics-swarm-backup-2797-2798-2799.test.ts+v3/@claude-flow/cli/__tests__/hooks-post-task-graph-edge-2961.test.ts+v3/@claude-flow/cli/__tests__/init-kebab-flags-2952.test.ts+v3/@claude-flow/cli/__tests__/integration-docker.test.ts+v3/@claude-flow/cli/__tests__/issue-2733-statusline-model-name.test.ts+v3/@claude-flow/cli/__tests__/mcp-client-guardrail.test.ts+v3/@claude-flow/cli/__tests__/mcp-client.test.ts+v3/@claude-flow/cli/__tests__/mcp-http-foreground-2984.test.ts+v3/@claude-flow/cli/__tests__/mcp-http-protocol-tools-2990.test.ts+v3/@claude-flow/cli/__tests__/mcp-tool-filter-2726.test.ts+v3/@claude-flow/cli/__tests__/memory-bridge-failure-diagnostics.test.ts+v3/@claude-flow/cli/__tests__/memory-concurrent-write-loss-2878.test.ts+v3/@claude-flow/cli/__tests__/memory-search-2790.test.ts+v3/@claude-flow/cli/__tests__/memory-search-recall-2558.test.ts+v3/@claude-flow/cli/__tests__/memory-store-upsert-default-2594.test.ts+v3/@claude-flow/cli/__tests__/neural-router.test.ts+v3/@claude-flow/cli/__tests__/output.test.ts+v3/@claude-flow/cli/__tests__/planflip-mempoison-2752.test.ts+v3/@claude-flow/cli/__tests__/plugins-transfer-deep.test.ts+v3/@claude-flow/cli/__tests__/policy-runtime.test.ts+v3/@claude-flow/cli/__tests__/pq-validation.test.ts+v3/@claude-flow/cli/__tests__/proxy-extract-archive.test.ts+v3/@claude-flow/cli/__tests__/security-scan-enum-validation.test.ts+v3/@claude-flow/cli/__tests__/security-scan-persistence.test.ts+v3/@claude-flow/cli/__tests__/security-scan-secret-regex-2931.test.ts+v3/@claude-flow/cli/__tests__/validate-input-path-2352.test.ts+v3/@claude-flow/cli/__tests__/version-anv.test.ts+v3/@claude-flow/embeddings/__tests__/minimal.test.mjs+v3/@claude-flow/embeddings/__tests__/simple.test.mjs+v3/@claude-flow/guidance/tests/hooks.test.ts+v3/@claude-flow/guidance/tests/integration.test.ts+v3/@claude-flow/hooks/__tests__/channel-guard-worker.test.ts+v3/@claude-flow/hooks/__tests__/workers.test.ts+v3/@claude-flow/hooks/src/__tests__/guidance-provider.test.ts+v3/@claude-flow/hooks/src/__tests__/reasoningbank.test.ts+v3/@claude-flow/memory/src/agentdb-backend.test.ts+v3/@claude-flow/memory/src/agentdb-retrieval-guard.test.ts+v3/@claude-flow/memory/src/consolidator.test.ts+v3/@claude-flow/memory/src/controller-registry.test.ts+v3/@claude-flow/memory/src/database-provider.test.ts+v3/@claude-flow/memory/src/graceful-retrieval.test.ts+v3/@claude-flow/memory/src/hnsw-persistence.test.ts+v3/@claude-flow/memory/src/hybrid-backend.test.ts+v3/@claude-flow/memory/src/index.test.ts+v3/@claude-flow/plugin-iot-cognitum/__tests__/integration/sdk-client.test.ts+v3/@claude-flow/plugins/examples/ruvector-plugins/ruvector-plugins.test.ts+v3/@claude-flow/swarm/__tests__/consensus.test.ts+v3/@claude-flow/swarm/__tests__/topology.test.ts+v3/__tests__/appliance/gguf-engine.test.ts+v3/__tests__/appliance/rvfa-builder.test.ts+v3/__tests__/appliance/rvfa-distribution.test.ts+v3/__tests__/appliance/rvfa-format.test.ts+v3/__tests__/appliance/rvfa-signing.test.ts+v3/__tests__/integration/swarm-integration.test.ts+v3/plugins/code-intelligence/tests/mcp-tools.test.ts+v3/plugins/code-intelligence/tests/types.test.ts+v3/plugins/cognitive-kernel/tests/bridges.test.ts+v3/plugins/cognitive-kernel/tests/mcp-tools.test.ts+v3/plugins/financial-risk/tests/mcp-tools.test.ts+v3/plugins/healthcare-clinical/tests/types.test.ts+v3/plugins/legal-contracts/tests/mcp-tools.test.ts+v3/plugins/legal-contracts/tests/types.test.ts+v3/plugins/quantum-optimizer/tests/mcp-tools.test.ts+diff --git a/scripts/ci-test-ratchet.mjs b/scripts/ci-test-ratchet.mjsnew file mode 100644index 0000000000..aa81481ea0--- /dev/null+++ b/scripts/ci-test-ratchet.mjs@@ -0,0 +1,122 @@+#!/usr/bin/env node++import { spawnSync } from 'node:child_process';+import { existsSync, mkdirSync, readFileSync, rmSync } from 'node:fs';+import { dirname, isAbsolute, relative, resolve, sep } from 'node:path';+import { fileURLToPath, pathToFileURL } from 'node:url';++const REPO_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '..');++function normalizeTestPath(name, repoRoot) {+ const normalized = isAbsolute(name) ? relative(repoRoot, name) : name;+ return normalized.split(sep).join('/').replace(/^\.\//, '');+}++export function evaluateTestReport(report, baselineEntries, repoRoot = REPO_ROOT) {+ if (!report || !Array.isArray(report.testResults)) {+ return { ok: false, error: 'Vitest JSON report is missing testResults[]' };+ }+ if (report.testResults.length === 0 && report.success !== false) {+ return { ok: false, error: 'Vitest JSON report contains zero test files' };+ }++ const baseline = new Set(+ baselineEntries.map((entry) => entry.trim()).filter((entry) => entry && !entry.startsWith('#')),+ );+ const failed = new Set(+ report.testResults+ .filter((result) => result?.status === 'failed' && typeof result.name === 'string')+ .map((result) => normalizeTestPath(result.name, repoRoot)),+ );+ const unexpected = [...failed].filter((name) => !baseline.has(name)).sort();+ const fixed = [...baseline].filter((name) => !failed.has(name)).sort();++ if (report.success === false && failed.size === 0) {+ return {+ ok: false,+ error: 'Vitest failed without identifying a failing test file',+ failed: [],+ unexpected: [],+ fixed,+ };+ }++ return {+ ok: unexpected.length === 0,+ failed: [...failed].sort(),+ unexpected,+ fixed,+ baselineCount: baseline.size,+ };+}++function parseArgs(argv) {+ const args = { report: '', baseline: resolve(REPO_ROOT, 'scripts/ci-test-baseline.txt'), run: true };+ for (let i = 0; i < argv.length; i += 1) {+ if (argv[i] === '--report' && argv[i + 1]) {+ args.report = resolve(argv[++i]);+ args.run = false;+ } else if (argv[i] === '--baseline' && argv[i + 1]) {+ args.baseline = resolve(argv[++i]);+ } else {+ throw new Error(`Unknown or incomplete argument: ${argv[i]}`);+ }+ }+ return args;+}++function main() {+ const args = parseArgs(process.argv.slice(2));+ const reportPath = args.report || resolve(REPO_ROOT, '.test-results/vitest.json');+ const vitestBin = resolve(REPO_ROOT, 'node_modules/vitest/vitest.mjs');++ if (args.run) {+ mkdirSync(dirname(reportPath), { recursive: true });+ // A killed runner must not accidentally reuse a prior green-enough report.+ rmSync(reportPath, { force: true });+ const run = spawnSync(process.execPath, [+ vitestBin,+ 'run',+ '--reporter=json',+ `--outputFile=${reportPath}`,+ ], {+ cwd: REPO_ROOT,+ env: { ...process.env, CI: '1' },+ stdio: 'inherit',+ });+ if (run.error) throw run.error;+ if (run.signal || (run.status !== 0 && run.status !== 1)) {+ console.error(`CI test ratchet: Vitest terminated abnormally (${run.signal ?? run.status})`);+ process.exit(1);+ }+ }++ if (!existsSync(reportPath)) {+ console.error(`CI test ratchet: report was not produced: ${reportPath}`);+ process.exit(1);+ }+ if (!existsSync(args.baseline)) {+ console.error(`CI test ratchet: baseline is missing: ${args.baseline}`);+ process.exit(1);+ }++ const report = JSON.parse(readFileSync(reportPath, 'utf8'));+ const baselineEntries = readFileSync(args.baseline, 'utf8').split(/\r?\n/);+ const result = evaluateTestReport(report, baselineEntries);++ if (!result.ok) {+ console.error(`CI test ratchet: FAILED — ${result.unexpected?.length ?? 0} unexpected failing file(s)`);+ for (const name of result.unexpected ?? []) console.error(` + ${name}`);+ if (result.error) console.error(` ${result.error}`);+ process.exit(1);+ }++ console.log(+ `CI test ratchet: PASS — ${result.failed.length}/${result.baselineCount} known failing files remain; `+ + `${result.fixed.length} baseline file(s) are now green`,+ );+}++if (process.argv[1] && import.meta.url === pathToFileURL(resolve(process.argv[1])).href) {+ main();+}diff --git a/v3/@claude-flow/cli/.claude/helpers/.helpers-version b/v3/@claude-flow/cli/.claude/helpers/.helpers-versionindex f38963b891..b0ab480d31 100644--- a/v3/@claude-flow/cli/.claude/helpers/.helpers-version+++ b/v3/@claude-flow/cli/.claude/helpers/.helpers-version@@ -1 +1 @@-3.32.29+3.38.12\ No newline at end of filediff --git a/v3/@claude-flow/cli/.claude/helpers/helpers.manifest.json b/v3/@claude-flow/cli/.claude/helpers/helpers.manifest.jsonindex 6d1181a6f2..b0873be5d0 100644--- a/v3/@claude-flow/cli/.claude/helpers/helpers.manifest.json+++ b/v3/@claude-flow/cli/.claude/helpers/helpers.manifest.json@@ -1,6 +1,6 @@{"manifest": {- "version": "3.38.11",+ "version": "3.38.12","files": {"auto-memory-hook.mjs": "85fe05c757421c52137c0bc8545a0896bab6b4714538c2a11d1d0835bfcc8c1c","hook-handler.cjs": "dae295fb9ae2626b89899c19a20cc911541af82b52d2eeb9b214d618b96e9a86",@@ -8,6 +8,6 @@"statusline.cjs": "0457fe53f8cd2c56458ff178392536a5868efd1a573665fa43bc01d2d95ca677"}},- "signature": "rNkivgIb+R5mwQcChrNF+m4lsfPPlKBn4oizP9Q7nuuIi8en/J3NJYf5l6mPRfEc4vdlqnnf0+Oid/007092Dw==",+ "signature": "8JINtA8uubiBqNQbsz8OL2fcc4xmKGk6gKPGoa1ib7/21nYDaYWiWrZB/4xli8AGUdmQuMS9GT6ANbpPjqAcCw==","algorithm": "ed25519"}diff --git a/v3/@claude-flow/cli/__tests__/teammate-idle-safe-defaults-3031.test.ts b/v3/@claude-flow/cli/__tests__/teammate-idle-safe-defaults-3031.test.tsnew file mode 100644index 0000000000..e982479f6f--- /dev/null+++ b/v3/@claude-flow/cli/__tests__/teammate-idle-safe-defaults-3031.test.ts@@ -0,0 +1,47 @@+import { describe, expect, it } from 'vitest';+import { generateSettings } from '../src/init/settings-generator.js';+import { mergeSettingsForUpgrade } from '../src/init/executor.js';+import { DEFAULT_INIT_OPTIONS } from '../src/init/types.js';+import { hooksCommand } from '../src/commands/hooks.js';++type AgentTeamsSettings = {+ coordination: { autoAssignOnIdle: boolean };+ hooks: { teammateIdle: { autoAssign: boolean; checkTaskList: boolean } };+};++function agentTeams(settings: object): AgentTeamsSettings {+ return (settings as {+ claudeFlow: { agentTeams: AgentTeamsSettings };+ }).claudeFlow.agentTeams;+}++describe('#3031 teammate-idle assignment authority', () => {+ it('keeps generated idle assignment disabled by default', () => {+ const generated = agentTeams(generateSettings(DEFAULT_INIT_OPTIONS));++ expect(generated.coordination.autoAssignOnIdle).toBe(false);+ expect(generated.hooks.teammateIdle.autoAssign).toBe(false);+ expect(generated.hooks.teammateIdle.checkTaskList).toBe(true);+ });++ it('migrates the former unsafe generated default to notify-only behavior', () => {+ const upgraded = agentTeams(mergeSettingsForUpgrade({+ claudeFlow: {+ agentTeams: {+ coordination: { autoAssignOnIdle: true },+ hooks: { teammateIdle: { autoAssign: true, checkTaskList: true } },+ },+ },+ }));++ expect(upgraded.coordination.autoAssignOnIdle).toBe(false);+ expect(upgraded.hooks.teammateIdle.autoAssign).toBe(false);+ });++ it('requires an explicit CLI opt-in before requesting auto-assignment', () => {+ const command = hooksCommand.subcommands?.find(({ name }) => name === 'teammate-idle');+ const option = command?.options?.find(({ name }) => name === 'auto-assign');++ expect(option?.default).toBe(false);+ });+});diff --git a/v3/@claude-flow/cli/package.json b/v3/@claude-flow/cli/package.jsonindex bf20f4ce38..d26f8c348e 100644--- a/v3/@claude-flow/cli/package.json+++ b/v3/@claude-flow/cli/package.json@@ -1,6 +1,6 @@{"name": "@claude-flow/cli",- "version": "3.38.11",+ "version": "3.38.12","type": "module","description": "Ruflo CLI - Enterprise AI agent orchestration with 60+ specialized agents, swarm coordination, MCP server, self-learning hooks, and vector memory for Claude Code","main": "dist/src/index.js",diff --git a/v3/@claude-flow/cli/src/commands/hooks.ts b/v3/@claude-flow/cli/src/commands/hooks.tsindex 5f8ac08fe3..505177c66e 100644--- a/v3/@claude-flow/cli/src/commands/hooks.ts+++ b/v3/@claude-flow/cli/src/commands/hooks.ts@@ -5271,7 +5271,8 @@ const teammateIdleCommand: Command = {short: 'a',description: 'Automatically assign pending tasks to idle teammate',type: 'boolean',- default: true+ // #3031: explicit opt-in only. Idle/liveness is not assignment authority.+ default: false},{name: 'check-task-list',@@ -5297,7 +5298,7 @@ const teammateIdleCommand: Command = {{ command: 'claude-flow hooks teammate-idle -t worker-1 --check-task-list', description: 'Check tasks for specific teammate' }],action: async (ctx: CommandContext): Promise<CommandResult> => {- const autoAssign = ctx.flags.autoAssign !== false;+ const autoAssign = ctx.flags.autoAssign === true;const checkTaskList = ctx.flags.checkTaskList !== false;const teammateId = ctx.flags.teammateId as string;const teamName = ctx.flags.teamName as string;diff --git a/v3/@claude-flow/cli/src/init/executor.ts b/v3/@claude-flow/cli/src/init/executor.tsindex dbe2163f3d..ec03e603b0 100644--- a/v3/@claude-flow/cli/src/init/executor.ts+++ b/v3/@claude-flow/cli/src/init/executor.ts@@ -327,7 +327,7 @@ export interface UpgradeResult {* Preserves user customizations while adding new features like Agent Teams* Uses platform-specific commands for Mac, Linux, and Windows*/-function mergeSettingsForUpgrade(existing: Record<string, unknown>): Record<string, unknown> {+export function mergeSettingsForUpgrade(existing: Record<string, unknown>): Record<string, unknown> {const merged = { ...existing };const platform = detectPlatform();const isWindows = platform.os === 'windows';@@ -499,13 +499,15 @@ function mergeSettingsForUpgrade(existing: Record<string, unknown>): Record<stritaskListEnabled: true,mailboxEnabled: true,coordination: {- autoAssignOnIdle: true,+ // #3031: an upgrade must remove the unsafe generated default. Idle+ // status is not proof that a task is unowned or inside agent scope.+ autoAssignOnIdle: false,trainPatternsOnComplete: true,notifyLeadOnComplete: true,sharedMemoryNamespace: 'agent-teams',},hooks: {- teammateIdle: { enabled: true, autoAssign: true, checkTaskList: true },+ teammateIdle: { enabled: true, autoAssign: false, checkTaskList: true },taskCompleted: { enabled: true, trainPatterns: true, notifyLead: true },},},diff --git a/v3/@claude-flow/cli/src/init/settings-generator.ts b/v3/@claude-flow/cli/src/init/settings-generator.tsindex 5f85f054ed..e0844a0783 100644--- a/v3/@claude-flow/cli/src/init/settings-generator.ts+++ b/v3/@claude-flow/cli/src/init/settings-generator.ts@@ -94,7 +94,11 @@ export function generateSettings(options: InitOptions): object {taskListEnabled: true,mailboxEnabled: true,coordination: {- autoAssignOnIdle: true, // Auto-assign pending tasks when teammate is idle+ // #3031: Liveness alone is not authority. Keep idle assignment off+ // until the scheduler can prove task ownership, agent scope, and a+ // refusal/back-off state. Users may explicitly opt in after supplying+ // those controls in their host configuration.+ autoAssignOnIdle: false,trainPatternsOnComplete: true, // Train neural patterns when tasks completenotifyLeadOnComplete: true, // Notify team lead when tasks completesharedMemoryNamespace: 'agent-teams', // Memory namespace for team coordination@@ -102,7 +106,7 @@ export function generateSettings(options: InitOptions): object {hooks: {teammateIdle: {enabled: true,- autoAssign: true,+ autoAssign: false,checkTaskList: true,},taskCompleted: {