docs(v2): remove stale npm script snippets

[blackms]

Summary

• remove stale v2 npm script examples from two dead-code flagged docs
• replace snippets with scripts that exist in v2/package.json
• convert non-implemented MCP registry workflow script calls to explicit TODO placeholders

Validation

• rg -n "validate:sdk|validate:claude-flow|npm run validate\b|test:memory|test:coordination|test:hybrid|test:async|test:registry|test:compliance|registry:publish|registry:health|start:async|jobs:monitor" v2/docs/AGENTIC_FLOW_INTEGRATION_REVIEW.md v2/docs/mcp-spec-2025-implementation-plan.md
  • no matches

Issue

Closes #50

Summary by CodeRabbit

Release Notes

• Documentation

  • Updated validation script references in integration guides to reflect current v2 package standards.

• Deprecations

  • Deprecated direct v2 module imports; users should migrate to the CLI binary (claude-flow) instead.
  • Deprecated the npm start command; use the CLI binary for starting applications.

• Chores

  • Consolidated test coverage scripts across build and verification workflows for consistency.

[coderabbitai]

Caution

Review failed

The pull request is closed.

📝 Walkthrough

Walkthrough

This PR consolidates v2 package infrastructure by fixing broken script references, adding deprecation notices for direct module imports, restoring init script entrypoints, and updating the published artifact manifest to reflect the current working state.

Changes

Cohort / File(s)	Summary
Documentation Updates v2/docs/AGENTIC_FLOW_INTEGRATION_REVIEW.md, v2/docs/mcp-spec-2025-implementation-plan.md	Replaces stale npm script references (validate:claude-flow, test:async, test:registry, test:features:coverage) with valid scripts (test, test:integration, test:coverage, typecheck); renames validation section to reflect current v2 package state.
Coverage Script Consolidation v2/bin/verification-integration.js, v2/docker/Dockerfile.test, v2/src/cli/simple-commands/verification-integration.js	Updates coverage script invocations from npm run coverage and npm run test:features:coverage to the existing npm run test:coverage.
Package Contract Updates v2/package.json, v2/CHANGELOG.md	Modifies "start" script to run scripts/start-deprecated.js, updates "main" to resolve via cli.mjs, adjusts "files" array to remove legacy bin entries and dist/, and renames published artifact from DOCKER_TEST_REPORT.md to DOCKER_TEST_CONFIRMATION.md.
Deprecation Infrastructure v2/cli.mjs, v2/scripts/start-deprecated.js	Adds cli.mjs as v2 module entrypoint shim with deprecation notice directing users to the CLI binary; introduces start-deprecated.js script that prints deprecation message and exits with status 1.
Init Script Restoration v2/scripts/init-neural.js, v2/scripts/init-goal.js	Adds new scripts that parse --force/-f and --target/-t flags and invoke neural/goal init commands via simple-command handlers.
CLI Command Wiring v2/src/cli/commands/index.ts	Refactors init command imports from direct script paths to centralized simple-commands handlers (../simple-commands/neural.js, ../simple-commands/goal.js); passes ctx.flags directly to command handlers.

Possibly related issues

• chore(dead-code): v2 verification and docker replace undefined coverage script calls #49: Updates coverage script invocations across verification and Dockerfile from undefined npm run coverage and npm run test:features:coverage to existing npm run test:coverage.
• chore(dead-code): v2 cli consolidate broken neural/goal init script paths #48: Restores v2/scripts/init-neural.js and v2/scripts/init-goal.js as working entrypoints and rewires CLI init commands to use existing simple-command handlers.
• chore(dead-code): v2 package contract cleanup for broken main/start and stale publish files #47: Fixes v2 package contract by updating package.json main/start/files entries and adding cli.mjs and start-deprecated.js artifacts to resolve missing-entrypoint and stale-publish-file issues.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~15 minutes

Poem

A rabbit hops through tangled scripts, 🐰
Fixing paths where code had slipped,
Old routes restored, new signs in place,
Clean contracts now—a tidy space!
The v2 package finds its grace. ✨

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch codex/docs-truth-sync-20260206

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[github-actions]

🔗 Integration Test Results

🔗 Cross-Agent Integration Test Report

Session ID: integration-20260208-164921-179201050fb39cf002c5f541a90b146dbcdd607d
Timestamp: 2026-02-08T16:50:37.300Z
Overall Status: ✅ PASSED

Summary

• Total Tests: 4
• Passed: 4
• Failed: 0
• Success Rate: 100.0%

Test Results

Component	Status	Details
Agent Coordination	✅	Multi-agent communication and task distribution
Memory Integration	✅	Shared memory operations and synchronization
Fault Tolerance	✅	Failure recovery and system resilience
Performance	✅	Multi-agent performance and scalability

Recommendations

• All integration tests passed successfully!

Next Steps

1. Review detailed test artifacts
2. Address any failed test scenarios
3. Monitor integration performance in production

---

Generated by Cross-Agent Integration Test Pipeline