0xray 3.4.1 → 3.4.3
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/.xray/codex.json +598 -0
- package/.xray/config.json +25 -0
- package/.xray/features.json +152 -0
- package/.xray/features.schema.json +33 -0
- package/AGENTS-consumer.md +127 -10
- package/AGENTS.md +172 -56
- package/README.md +159 -82
- package/SKILLS.md +79 -53
- package/dist/AGENTS.md +172 -56
- package/dist/CHANGELOG.md +95 -52
- package/dist/README.md +159 -82
- package/dist/SKILLS.md +79 -53
- package/dist/agents/architect.d.ts +2 -0
- package/dist/agents/backend-engineer.d.ts +8 -0
- package/dist/agents/bug-triage-specialist.d.ts +2 -0
- package/dist/agents/code-analyzer.d.ts +7 -0
- package/dist/agents/code-reviewer.d.ts +2 -0
- package/dist/agents/content-creator.d.ts +9 -0
- package/dist/agents/database-engineer.d.ts +8 -0
- package/dist/agents/devops-engineer.d.ts +8 -0
- package/dist/agents/frontend-engineer.d.ts +8 -0
- package/dist/agents/frontend-ui-ux-engineer.d.ts +8 -0
- package/dist/agents/growth-strategist.d.ts +8 -0
- package/dist/agents/index.d.ts +25 -0
- package/dist/agents/known-names.d.ts +26 -0
- package/dist/agents/librarian-agents-updater.d.ts +30 -0
- package/dist/agents/log-monitor.d.ts +2 -0
- package/dist/agents/mobile-developer.d.ts +9 -0
- package/dist/agents/multimodal-looker.d.ts +9 -0
- package/dist/agents/performance-engineer.d.ts +8 -0
- package/dist/agents/refactorer.d.ts +2 -0
- package/dist/agents/registry.d.ts +37 -0
- package/dist/agents/researcher.d.ts +2 -0
- package/dist/agents/security-auditor.d.ts +2 -0
- package/dist/agents/seo-consultant.d.ts +8 -0
- package/dist/agents/strategist.d.ts +7 -0
- package/dist/agents/tech-writer.d.ts +8 -0
- package/dist/agents/testing-lead.d.ts +2 -0
- package/dist/agents/types.d.ts +45 -0
- package/dist/analytics/consent-manager.d.ts +92 -0
- package/dist/analytics/emerging-pattern-detector.d.ts +66 -0
- package/dist/analytics/pattern-learning-engine.d.ts +79 -0
- package/dist/analytics/pattern-performance-tracker.d.ts +96 -0
- package/dist/analytics/predictive-analytics.d.ts +40 -0
- package/dist/analytics/prompt-pattern-analyzer.d.ts +98 -0
- package/dist/analytics/routing-performance-analyzer.d.ts +100 -0
- package/dist/analytics/routing-refiner.d.ts +102 -0
- package/dist/analytics/simple-pattern-analyzer.d.ts +79 -0
- package/dist/architect/architect-tools.d.ts +70 -0
- package/dist/architect/architectural-integrity.d.ts +20 -0
- package/dist/benchmark/performance-benchmark.d.ts +103 -0
- package/dist/cli/commands/analytics-disable.d.ts +9 -0
- package/dist/cli/commands/analytics-enable-action.d.ts +8 -0
- package/dist/cli/commands/analytics-preview.d.ts +9 -0
- package/dist/cli/commands/analytics-status.d.ts +9 -0
- package/dist/cli/commands/antigravity-status.d.ts +9 -0
- package/dist/cli/commands/archive-logs.d.ts +23 -0
- package/dist/cli/commands/credible-init.d.ts +11 -0
- package/dist/cli/commands/enforce.d.ts +12 -0
- package/dist/cli/commands/govern.d.ts +29 -0
- package/dist/cli/commands/grok-install.d.ts +7 -0
- package/dist/cli/commands/hermes-install.d.ts +2 -0
- package/dist/cli/commands/mcp-install.d.ts +4 -0
- package/dist/cli/commands/openclaw-install.d.ts +2 -0
- package/dist/cli/commands/opencode-install.d.ts +2 -0
- package/dist/cli/commands/plugin-commands.d.ts +18 -0
- package/dist/cli/commands/publish-agent.d.ts +15 -0
- package/dist/cli/commands/security-audit.d.ts +23 -0
- package/dist/cli/commands/skill-install.d.ts +6 -0
- package/dist/cli/commands/status.d.ts +41 -0
- package/dist/cli/commands/storyteller.d.ts +19 -0
- package/dist/cli/index.d.ts +7 -0
- package/dist/cli/server.d.ts +1 -0
- package/dist/config/default-agents.d.ts +12 -0
- package/dist/config/routing-mappings.d.ts +26 -0
- package/dist/core/activity-logger.d.ts +71 -0
- package/dist/core/adaptive-kernel.d.ts +108 -0
- package/dist/core/agent-spawn-gate.d.ts +56 -0
- package/dist/core/boot-orchestrator.d.ts +99 -0
- package/dist/core/codex-formatter.d.ts +95 -0
- package/dist/core/codex-injector.d.ts +73 -0
- package/dist/core/config-loader.d.ts +59 -0
- package/dist/core/config-paths.d.ts +66 -0
- package/dist/core/context-loader.d.ts +120 -0
- package/dist/core/context-validator.d.ts +52 -0
- package/dist/core/features-config.d.ts +485 -0
- package/dist/core/features-config.js +5 -0
- package/dist/core/framework-logger.d.ts +76 -0
- package/dist/core/index.d.ts +5 -0
- package/dist/core/kernel-patterns.d.ts +129 -0
- package/dist/core/logging-config.d.ts +10 -0
- package/dist/core/model-router.d.ts +56 -0
- package/dist/core/orchestrator.d.ts +71 -0
- package/dist/core/system-prompt-generator.d.ts +34 -0
- package/dist/core/trace-context.d.ts +12 -0
- package/dist/core/xray-activation.d.ts +14 -0
- package/dist/delegation/agent-delegator.d.ts +185 -0
- package/dist/delegation/agent-expertise.d.ts +15 -0
- package/dist/delegation/analytics/index.d.ts +11 -0
- package/dist/delegation/analytics/learning-engine.d.ts +84 -0
- package/dist/delegation/analytics/outcome-tracker.d.ts +117 -0
- package/dist/delegation/analytics/routing-analytics.d.ts +60 -0
- package/dist/delegation/ast-code-parser.d.ts +173 -0
- package/dist/delegation/codebase-context-analyzer.d.ts +164 -0
- package/dist/delegation/complexity-analyzer.d.ts +110 -0
- package/dist/delegation/complexity-core.d.ts +119 -0
- package/dist/delegation/config/types.d.ts +247 -0
- package/dist/delegation/dependency-graph-builder.d.ts +94 -0
- package/dist/delegation/index.d.ts +25 -0
- package/dist/delegation/metrics-aggregator.d.ts +91 -0
- package/dist/delegation/session-coordinator.d.ts +132 -0
- package/dist/delegation/strategy-selector.d.ts +27 -0
- package/dist/delegation/voting-coordinator.d.ts +48 -0
- package/dist/delegation/voting-types.d.ts +154 -0
- package/dist/delegation/weighted-voting-aggregator.d.ts +36 -0
- package/dist/enforcement/core/index.d.ts +14 -0
- package/dist/enforcement/core/rule-executor.d.ts +157 -0
- package/dist/enforcement/core/rule-hierarchy.d.ts +145 -0
- package/dist/enforcement/core/rule-registry.d.ts +196 -0
- package/dist/enforcement/core/violation-fixer.d.ts +105 -0
- package/dist/enforcement/enforcer-tools.d.ts +78 -0
- package/dist/enforcement/index.d.ts +22 -0
- package/dist/enforcement/loaders/agent-triage-loader.d.ts +98 -0
- package/dist/enforcement/loaders/agents-md-validation-loader.d.ts +75 -0
- package/dist/enforcement/loaders/base-loader.d.ts +82 -0
- package/dist/enforcement/loaders/codex-loader.d.ts +76 -0
- package/dist/enforcement/loaders/index.d.ts +36 -0
- package/dist/enforcement/loaders/loader-orchestrator.d.ts +96 -0
- package/dist/enforcement/loaders/processor-loader.d.ts +59 -0
- package/dist/enforcement/rule-enforcer.d.ts +142 -0
- package/dist/enforcement/test-auto-healing.d.ts +83 -0
- package/dist/enforcement/types.d.ts +500 -0
- package/dist/enforcement/validators/architecture-validators.d.ts +154 -0
- package/dist/enforcement/validators/base-validator.d.ts +87 -0
- package/dist/enforcement/validators/code-quality-validators.d.ts +88 -0
- package/dist/enforcement/validators/index.d.ts +14 -0
- package/dist/enforcement/validators/security-validators.d.ts +52 -0
- package/dist/enforcement/validators/testing-validators.d.ts +80 -0
- package/dist/enforcement/validators/validator-registry.d.ts +91 -0
- package/dist/execution/opencode-cli-invoker.d.ts +8 -0
- package/dist/execution/proposal-applier.d.ts +24 -0
- package/dist/governance/codex-policy.service.d.ts +56 -0
- package/dist/governance/governance-core.d.ts +53 -0
- package/dist/governance/governance-service.d.ts +38 -0
- package/dist/governance/governance-types.d.ts +90 -0
- package/dist/governance/llm-governance-provider.d.ts +13 -0
- package/dist/index.d.ts +28 -0
- package/dist/inference/deploy-verifier.d.ts +26 -0
- package/dist/inference/index.d.ts +10 -0
- package/dist/inference/inference-accumulator.d.ts +29 -0
- package/dist/inference/inference-agent-invoker.d.ts +3 -0
- package/dist/inference/inference-applier.d.ts +4 -0
- package/dist/inference/inference-cycle.d.ts +70 -0
- package/dist/inference/inference-proposal-generator.d.ts +3 -0
- package/dist/inference/semantic-patterns.d.ts +7 -0
- package/dist/inference/session-capture.d.ts +32 -0
- package/dist/infrastructure/iac-validator.d.ts +150 -0
- package/dist/infrastructure/schemas/cloud-schemas.d.ts +482 -0
- package/dist/integrations/base/ExampleIntegration.d.ts +46 -0
- package/dist/integrations/base/Integration.d.ts +266 -0
- package/dist/integrations/base/index.d.ts +11 -0
- package/dist/integrations/base/registry.d.ts +272 -0
- package/dist/integrations/base/types.d.ts +167 -0
- package/dist/integrations/enforcement-gate.d.ts +44 -0
- package/dist/integrations/governance/governance-client.d.ts +75 -0
- package/dist/integrations/governance/index.d.ts +98 -0
- package/dist/integrations/governance/types.d.ts +238 -0
- package/dist/integrations/grok/grok-cli.d.ts +25 -0
- package/dist/integrations/grok/hooks/grok-hook-activity.js +53 -0
- package/dist/integrations/grok/hooks/grok-hook-utils.js +261 -0
- package/dist/integrations/grok/hooks/pre-tool-use.js +85 -115
- package/dist/integrations/grok/hooks/session-start.js +52 -0
- package/dist/integrations/grok/plugin/0xray/hooks/hooks.json +20 -3
- package/dist/integrations/openclaw/api-server.d.ts +86 -0
- package/dist/integrations/openclaw/client.d.ts +121 -0
- package/dist/integrations/openclaw/config.d.ts +95 -0
- package/dist/integrations/openclaw/hooks/xray-hooks.d.ts +123 -0
- package/dist/integrations/openclaw/index.d.ts +100 -0
- package/dist/integrations/openclaw/types.d.ts +425 -0
- package/dist/integrations/plugins/index.d.ts +9 -0
- package/dist/integrations/plugins/plugin-integration.d.ts +288 -0
- package/dist/integrations/plugins/plugin-registry.d.ts +223 -0
- package/dist/mcps/agent-resolver.d.ts +45 -0
- package/dist/mcps/architect-tools.server.d.ts +16 -0
- package/dist/mcps/auto-format.server.d.ts +18 -0
- package/dist/mcps/boot-orchestrator.server.d.ts +48 -0
- package/dist/mcps/config/config-loader.d.ts +56 -0
- package/dist/mcps/config/config-validator.d.ts +40 -0
- package/dist/mcps/config/index.d.ts +31 -0
- package/dist/mcps/config/plugin-server-registry.d.ts +126 -0
- package/dist/mcps/config/server-config-registry.d.ts +51 -0
- package/dist/mcps/config/server-config-registry.js +4 -3
- package/dist/mcps/connection/connection-manager.d.ts +39 -0
- package/dist/mcps/connection/connection-pool.d.ts +64 -0
- package/dist/mcps/connection/mcp-connection.d.ts +66 -0
- package/dist/mcps/connection/process-spawner.d.ts +24 -0
- package/dist/mcps/enforcer-tools.server.d.ts +26 -0
- package/dist/mcps/estimation.server.d.ts +19 -0
- package/dist/mcps/framework-compliance-audit.server.d.ts +20 -0
- package/dist/mcps/framework-help.server.d.ts +13 -0
- package/dist/mcps/governance.server.d.ts +35 -0
- package/dist/mcps/governance.server.js +14 -2
- package/dist/mcps/in-process-skill-registry.d.ts +20 -0
- package/dist/mcps/index.d.ts +17 -0
- package/dist/mcps/knowledge-skills/api-design.server.d.ts +13 -0
- package/dist/mcps/knowledge-skills/architecture-patterns.server.d.ts +13 -0
- package/dist/mcps/knowledge-skills/bug-triage-specialist.server.d.ts +31 -0
- package/dist/mcps/knowledge-skills/code-analyzer.server.d.ts +29 -0
- package/dist/mcps/knowledge-skills/code-review.server.d.ts +44 -0
- package/dist/mcps/knowledge-skills/content-creator.server.d.ts +11 -0
- package/dist/mcps/knowledge-skills/database-design.server.d.ts +41 -0
- package/dist/mcps/knowledge-skills/devops-deployment.server.d.ts +41 -0
- package/dist/mcps/knowledge-skills/git-workflow.server.d.ts +13 -0
- package/dist/mcps/knowledge-skills/growth-strategist.server.d.ts +11 -0
- package/dist/mcps/knowledge-skills/log-monitor.server.d.ts +22 -0
- package/dist/mcps/knowledge-skills/mobile-development.server.d.ts +17 -0
- package/dist/mcps/knowledge-skills/multimodal-looker.server.d.ts +53 -0
- package/dist/mcps/knowledge-skills/performance-optimization.server.d.ts +69 -0
- package/dist/mcps/knowledge-skills/project-analysis.server.d.ts +35 -0
- package/dist/mcps/knowledge-skills/refactoring-strategies.server.d.ts +31 -0
- package/dist/mcps/knowledge-skills/security-audit.server.d.ts +46 -0
- package/dist/mcps/knowledge-skills/seo-consultant.server.d.ts +24 -0
- package/dist/mcps/knowledge-skills/session-management.server.d.ts +22 -0
- package/dist/mcps/knowledge-skills/skill-invocation.server.d.ts +32 -0
- package/dist/mcps/knowledge-skills/storyteller.server.d.ts +11 -0
- package/dist/mcps/knowledge-skills/strategist.server.d.ts +15 -0
- package/dist/mcps/knowledge-skills/tech-writer.server.d.ts +45 -0
- package/dist/mcps/knowledge-skills/testing-best-practices.server.d.ts +34 -0
- package/dist/mcps/knowledge-skills/testing-strategy.server.d.ts +45 -0
- package/dist/mcps/knowledge-skills/ui-ux-design.server.d.ts +67 -0
- package/dist/mcps/lint.server.d.ts +15 -0
- package/dist/mcps/mcp-client.d.ts +157 -0
- package/dist/mcps/model-health-check.server.d.ts +14 -0
- package/dist/mcps/orchestrator/aside-context.d.ts +21 -0
- package/dist/mcps/orchestrator/config/agent-capabilities.d.ts +39 -0
- package/dist/mcps/orchestrator/config/memory-routing-bridge.d.ts +12 -0
- package/dist/mcps/orchestrator/execution/execution-planner.d.ts +62 -0
- package/dist/mcps/orchestrator/handlers/complexity-handler.d.ts +32 -0
- package/dist/mcps/orchestrator/handlers/complexity-handler.js +33 -3
- package/dist/mcps/orchestrator/handlers/status-handler.d.ts +71 -0
- package/dist/mcps/orchestrator/handlers/task-handler.d.ts +53 -0
- package/dist/mcps/orchestrator/index.d.ts +6 -0
- package/dist/mcps/orchestrator/server.d.ts +38 -0
- package/dist/mcps/orchestrator/server.js +1 -1
- package/dist/mcps/orchestrator/types.d.ts +128 -0
- package/dist/mcps/orchestrator.server.d.ts +10 -0
- package/dist/mcps/performance-analysis.server.d.ts +25 -0
- package/dist/mcps/processor-pipeline.server.d.ts +29 -0
- package/dist/mcps/protocol/protocol-constants.d.ts +46 -0
- package/dist/mcps/researcher-confidence.d.ts +21 -0
- package/dist/mcps/researcher.server.d.ts +29 -0
- package/dist/mcps/researcher.server.js +3 -0
- package/dist/mcps/security-scan.server.d.ts +19 -0
- package/dist/mcps/shared/knowledge-skill-base.d.ts +17 -0
- package/dist/mcps/shared/prompt-security-validator.d.ts +44 -0
- package/dist/mcps/shared/security-scanner.d.ts +119 -0
- package/dist/mcps/simulation/index.d.ts +12 -0
- package/dist/mcps/simulation/server-simulations.d.ts +39 -0
- package/dist/mcps/simulation/simulation-engine.d.ts +51 -0
- package/dist/mcps/state-manager.server.d.ts +27 -0
- package/dist/mcps/tools/index.d.ts +14 -0
- package/dist/mcps/tools/tool-cache.d.ts +53 -0
- package/dist/mcps/tools/tool-discovery.d.ts +27 -0
- package/dist/mcps/tools/tool-executor.d.ts +41 -0
- package/dist/mcps/tools/tool-registry.d.ts +42 -0
- package/dist/mcps/types/index.d.ts +13 -0
- package/dist/mcps/types/json-rpc.types.d.ts +35 -0
- package/dist/mcps/types/mcp.types.d.ts +105 -0
- package/dist/memory-routing/index.d.ts +6 -0
- package/dist/memory-routing/null-provider.d.ts +14 -0
- package/dist/memory-routing/provider-loader.d.ts +2 -0
- package/dist/memory-routing/provider-registry.d.ts +8 -0
- package/dist/memory-routing/types.d.ts +104 -0
- package/dist/memory-routing/validate-config.d.ts +7 -0
- package/dist/metrics/agent-metrics.d.ts +169 -0
- package/dist/metrics/index.d.ts +6 -0
- package/dist/monitoring/advanced-profiler.d.ts +51 -0
- package/dist/monitoring/memory-monitor.d.ts +113 -0
- package/dist/monitoring/nudge-watchdog.d.ts +87 -0
- package/dist/monitoring/test-auto-generation-monitor.d.ts +64 -0
- package/dist/nucleus/autonomy-kernel.d.ts +48 -0
- package/dist/nucleus/autonomy-kernel.js +176 -0
- package/dist/nucleus/default-plugins.d.ts +17 -0
- package/dist/nucleus/govern-http.d.ts +59 -0
- package/dist/nucleus/index.d.ts +17 -0
- package/dist/nucleus/index.js +1 -0
- package/dist/nucleus/kernel.d.ts +51 -0
- package/dist/nucleus/plugin-registry.d.ts +132 -0
- package/dist/nucleus/thin-dispatch.d.ts +33 -0
- package/dist/orchestrator/agent-spawn-governor.d.ts +126 -0
- package/dist/orchestrator/enhanced-multi-agent-orchestrator.d.ts +156 -0
- package/dist/orchestrator/intelligent-commit-batcher.d.ts +114 -0
- package/dist/orchestrator/multi-agent-orchestration-coordinator.d.ts +126 -0
- package/dist/orchestrator/orchestrator.d.ts +141 -0
- package/dist/orchestrator/self-direction-activation.d.ts +108 -0
- package/dist/orchestrator/universal-librarian-consultation.d.ts +98 -0
- package/dist/orchestrator/universal-registry-bridge.d.ts +84 -0
- package/dist/performance/performance-budget-enforcer.d.ts +157 -0
- package/dist/performance/performance-regression-tester.d.ts +107 -0
- package/dist/plugin/plugin-codex-context.d.ts +18 -0
- package/dist/plugin/plugin-helpers.d.ts +23 -0
- package/dist/plugin/plugin-logger.d.ts +8 -0
- package/dist/plugin/plugin-modules.d.ts +11 -0
- package/dist/plugin/plugin-quality-gate.d.ts +11 -0
- package/dist/plugin/plugin-types.d.ts +93 -0
- package/dist/plugin/xray-codex-injection.d.ts +39 -0
- package/dist/postprocessor/PostProcessor.d.ts +107 -0
- package/dist/postprocessor/analysis/CodeChangeAnalyzer.d.ts +11 -0
- package/dist/postprocessor/analysis/FailureAnalysisEngine.d.ts +39 -0
- package/dist/postprocessor/autofix/AutoFixEngine.d.ts +48 -0
- package/dist/postprocessor/autofix/FixValidator.d.ts +23 -0
- package/dist/postprocessor/config/ProcessorConfigLoader.d.ts +44 -0
- package/dist/postprocessor/config.d.ts +6 -0
- package/dist/postprocessor/escalation/EscalationEngine.d.ts +154 -0
- package/dist/postprocessor/integration.d.ts +156 -0
- package/dist/postprocessor/metamorphosis/SelfProposalEngine.d.ts +87 -0
- package/dist/postprocessor/metamorphosis/index.d.ts +2 -0
- package/dist/postprocessor/monitoring/MonitoringEngine.d.ts +40 -0
- package/dist/postprocessor/redeploy/RedeployCoordinator.d.ts +91 -0
- package/dist/postprocessor/redeploy/RetryHandler.d.ts +49 -0
- package/dist/postprocessor/services/RegressionAnalysisService.d.ts +39 -0
- package/dist/postprocessor/success/SuccessHandler.d.ts +57 -0
- package/dist/postprocessor/triggers/APITrigger.d.ts +34 -0
- package/dist/postprocessor/triggers/GitHookTrigger.d.ts +38 -0
- package/dist/postprocessor/triggers/WebhookTrigger.d.ts +46 -0
- package/dist/postprocessor/types.d.ts +227 -0
- package/dist/processors/doc-write-guard.d.ts +6 -0
- package/dist/processors/implementations/agents-md-validation-processor.d.ts +62 -0
- package/dist/processors/implementations/async-pattern-processor.d.ts +47 -0
- package/dist/processors/implementations/codex-compliance-processor.d.ts +7 -0
- package/dist/processors/implementations/commit-batcher-processor.d.ts +13 -0
- package/dist/processors/implementations/console-log-guard-processor.d.ts +32 -0
- package/dist/processors/implementations/coverage-analysis-processor.d.ts +19 -0
- package/dist/processors/implementations/error-boundary-processor.d.ts +7 -0
- package/dist/processors/implementations/inference-improvement-processor.d.ts +36 -0
- package/dist/processors/implementations/log-protection-processor.d.ts +29 -0
- package/dist/processors/implementations/nudge-processor.d.ts +21 -0
- package/dist/processors/implementations/performance-budget-processor.d.ts +49 -0
- package/dist/processors/implementations/postprocessor-chain-validator.d.ts +45 -0
- package/dist/processors/implementations/pre-validate-processor.d.ts +7 -0
- package/dist/processors/implementations/publish-preflight-processor.d.ts +37 -0
- package/dist/processors/implementations/refactoring-logging-processor-wrapper.d.ts +7 -0
- package/dist/processors/implementations/refactoring-logging-processor.d.ts +31 -0
- package/dist/processors/implementations/regression-testing-processor.d.ts +20 -0
- package/dist/processors/implementations/session-capture-processor.d.ts +14 -0
- package/dist/processors/implementations/session-summary-processor.d.ts +26 -0
- package/dist/processors/implementations/spawn-governance-processor.d.ts +57 -0
- package/dist/processors/implementations/state-validation-processor.d.ts +11 -0
- package/dist/processors/implementations/storytelling-trigger-processor.d.ts +40 -0
- package/dist/processors/implementations/test-auto-creation-processor.d.ts +16 -0
- package/dist/processors/implementations/test-execution-processor.d.ts +11 -0
- package/dist/processors/implementations/typescript-compilation-processor.d.ts +37 -0
- package/dist/processors/implementations/version-compliance-processor.d.ts +111 -0
- package/dist/processors/processor-interfaces.d.ts +126 -0
- package/dist/processors/processor-manager.d.ts +80 -0
- package/dist/processors/processor-types.d.ts +189 -0
- package/dist/public/XrayService.d.ts +17 -0
- package/dist/public/index.d.ts +4 -0
- package/dist/reporting/framework-reporting-system.d.ts +19 -0
- package/dist/reporting/log-parser.d.ts +10 -0
- package/dist/reporting/metrics.d.ts +15 -0
- package/dist/reporting/report-formatter.d.ts +5 -0
- package/dist/reporting/types.d.ts +102 -0
- package/dist/scripts/activate-kernel-pipeline.d.ts +7 -0
- package/dist/scripts/integration.d.ts +36 -0
- package/dist/security/comprehensive-security-audit.d.ts +157 -0
- package/dist/security/index.d.ts +13 -0
- package/dist/security/prompt-security-validator.d.ts +44 -0
- package/dist/security/security-agent-coordinator.d.ts +71 -0
- package/dist/security/security-auditor.d.ts +55 -0
- package/dist/security/security-hardener.d.ts +61 -0
- package/dist/security/security-hardening-system.d.ts +238 -0
- package/dist/security/security-headers.d.ts +63 -0
- package/dist/security/security-orchestration-layer.d.ts +118 -0
- package/dist/security/security-scanner.d.ts +119 -0
- package/dist/services/inference-tuner.d.ts +76 -0
- package/dist/session/index.d.ts +3 -0
- package/dist/session/session-cleanup-manager.d.ts +117 -0
- package/dist/session/session-monitor.d.ts +132 -0
- package/dist/session/session-state-manager.d.ts +144 -0
- package/dist/skills/boot-orchestrator/SKILL.md +1 -5
- package/dist/skills/orchestrator/SKILL.md +35 -12
- package/dist/skills/researcher/SKILL.md +17 -4
- package/dist/skills/strategist/SKILL.md +12 -0
- package/dist/skills/testing-strategy/SKILL.md +13 -2
- package/dist/skills/xray-orchestrator/index.d.ts +12 -0
- package/dist/state/context-providers.d.ts +4 -0
- package/dist/state/index.d.ts +4 -0
- package/dist/state/state-manager.d.ts +41 -0
- package/dist/state/state-types.d.ts +5 -0
- package/dist/testing/memory-regression-suite.d.ts +105 -0
- package/dist/tools/assess-complexity-tool.d.ts +28 -0
- package/dist/tools/query-routing-tool.d.ts +17 -0
- package/dist/types/metamorphosis.d.ts +21 -0
- package/dist/utils/batch-operations.d.ts +25 -0
- package/dist/utils/codex-parser.d.ts +60 -0
- package/dist/utils/command-runner.d.ts +32 -0
- package/dist/utils/import-resolver.d.ts +54 -0
- package/dist/utils/language-detector.d.ts +43 -0
- package/dist/utils/path-resolver.d.ts +48 -0
- package/dist/utils/shutdown-handler.d.ts +26 -0
- package/dist/utils/task-graph.d.ts +29 -0
- package/dist/utils/test-template-generator.d.ts +25 -0
- package/dist/utils/token-manager.d.ts +48 -0
- package/dist/validation/agent-config-validator.d.ts +110 -0
- package/dist/validation/estimation-validator.d.ts +61 -0
- package/dist/validation/orchestration-flow-validator.d.ts +87 -0
- package/dist/validation/report-content-validator.d.ts +42 -0
- package/package.json +23 -8
- package/scripts/node/consumer-install-smoke.mjs +174 -0
- package/scripts/node/install-bridges.cjs +20 -6
- package/scripts/node/pre-publish-guard.js +107 -168
- package/scripts/node/reconcile-version.mjs +147 -0
- package/scripts/node/release-gate.mjs +66 -0
- package/scripts/node/release.js +5 -147
- package/scripts/node/release.mjs +106 -181
- package/scripts/node/setup.cjs +12 -22
- package/scripts/node/sync-versions.mjs +12 -134
- package/scripts/node/universal-version-manager.js +4 -0
- package/scripts/node/validate-release-docs.mjs +299 -0
- package/scripts/node/version-manager.mjs +225 -49
- package/src/integrations/grok/plugin/0xray/hooks/hooks.json +20 -3
- package/src/mcps/config/__tests__/server-config-registry.test.ts +9 -0
- package/src/mcps/config/server-config-registry.ts +5 -3
- package/src/mcps/governance.server.ts +15 -2
- package/src/mcps/orchestrator/handlers/complexity-handler.ts +54 -3
- package/src/mcps/orchestrator/server.ts +1 -1
- package/src/mcps/researcher.server.ts +4 -0
- package/src/skills/boot-orchestrator/SKILL.md +1 -5
- package/src/skills/orchestrator/SKILL.md +35 -12
- package/src/skills/researcher/SKILL.md +17 -4
- package/src/skills/strategist/SKILL.md +12 -0
- package/src/skills/testing-strategy/SKILL.md +13 -2
- package/xray/config.json +25 -0
- package/xray/features.json +152 -0
- package/xray/features.schema.json +33 -0
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
import { EventEmitter } from "events";
|
|
2
|
+
interface ProfileData {
|
|
3
|
+
agentName: string;
|
|
4
|
+
operation: string;
|
|
5
|
+
startTime: number;
|
|
6
|
+
endTime?: number;
|
|
7
|
+
duration?: number;
|
|
8
|
+
memoryUsage: {
|
|
9
|
+
before: NodeJS.MemoryUsage;
|
|
10
|
+
after?: NodeJS.MemoryUsage;
|
|
11
|
+
};
|
|
12
|
+
success: boolean;
|
|
13
|
+
error?: string;
|
|
14
|
+
metadata: Record<string, any>;
|
|
15
|
+
}
|
|
16
|
+
interface ProfilingMetrics {
|
|
17
|
+
totalOperations: number;
|
|
18
|
+
successfulOperations: number;
|
|
19
|
+
failedOperations: number;
|
|
20
|
+
averageDuration: number;
|
|
21
|
+
memoryDelta: number;
|
|
22
|
+
slowestOperation: string;
|
|
23
|
+
fastestOperation: string;
|
|
24
|
+
}
|
|
25
|
+
export declare class AdvancedProfiler extends EventEmitter {
|
|
26
|
+
private profiles;
|
|
27
|
+
private activeProfiles;
|
|
28
|
+
private profilingEnabled;
|
|
29
|
+
private profileStoragePath;
|
|
30
|
+
private reportTimer?;
|
|
31
|
+
private cleanupTimer?;
|
|
32
|
+
private isRunning;
|
|
33
|
+
constructor(storagePath?: string | undefined);
|
|
34
|
+
start(): void;
|
|
35
|
+
stop(): void;
|
|
36
|
+
private ensureStorageDirectory;
|
|
37
|
+
startProfiling(operationId: string, agentName: string, operation: string, metadata?: Record<string, any>): void;
|
|
38
|
+
endProfiling(operationId: string, success?: boolean, error?: string): void;
|
|
39
|
+
private detectAnomalies;
|
|
40
|
+
private calculateMemoryDelta;
|
|
41
|
+
getMetrics(agentName?: string): ProfilingMetrics;
|
|
42
|
+
private generatePerformanceReport;
|
|
43
|
+
private generateRecommendations;
|
|
44
|
+
private cleanupOldProfiles;
|
|
45
|
+
enableProfiling(): void;
|
|
46
|
+
disableProfiling(): void;
|
|
47
|
+
clearProfiles(): void;
|
|
48
|
+
exportProfiles(): Record<string, ProfileData[]>;
|
|
49
|
+
}
|
|
50
|
+
export declare const advancedProfiler: AdvancedProfiler;
|
|
51
|
+
export {};
|
|
@@ -0,0 +1,113 @@
|
|
|
1
|
+
import { EventEmitter } from "events";
|
|
2
|
+
export interface MemoryStats {
|
|
3
|
+
heapUsed: number;
|
|
4
|
+
heapTotal: number;
|
|
5
|
+
external: number;
|
|
6
|
+
rss: number;
|
|
7
|
+
timestamp: number;
|
|
8
|
+
sessionId?: string;
|
|
9
|
+
}
|
|
10
|
+
export interface MemoryLeakAlert {
|
|
11
|
+
type: "leak_detected" | "high_usage" | "spike_detected";
|
|
12
|
+
severity: "low" | "medium" | "high" | "critical";
|
|
13
|
+
message: string;
|
|
14
|
+
details: {
|
|
15
|
+
currentUsage: number;
|
|
16
|
+
threshold: number;
|
|
17
|
+
trend: "increasing" | "stable" | "decreasing";
|
|
18
|
+
recommendations: string[];
|
|
19
|
+
};
|
|
20
|
+
}
|
|
21
|
+
export interface MemoryMonitorConfig {
|
|
22
|
+
checkInterval: number;
|
|
23
|
+
alertThresholds: {
|
|
24
|
+
warning: number;
|
|
25
|
+
critical: number;
|
|
26
|
+
leakDetection: {
|
|
27
|
+
growthRate: number;
|
|
28
|
+
sustainedPeriod: number;
|
|
29
|
+
};
|
|
30
|
+
};
|
|
31
|
+
enableFrameworkLogging: boolean;
|
|
32
|
+
sessionTracking: boolean;
|
|
33
|
+
}
|
|
34
|
+
export interface MemorySummary {
|
|
35
|
+
current: MemoryStats;
|
|
36
|
+
peak: MemoryStats;
|
|
37
|
+
average: number;
|
|
38
|
+
trend: "increasing" | "stable" | "decreasing";
|
|
39
|
+
}
|
|
40
|
+
export declare class MemoryMonitor extends EventEmitter {
|
|
41
|
+
private config;
|
|
42
|
+
private monitoringInterval;
|
|
43
|
+
private statsHistory;
|
|
44
|
+
private maxHistorySize;
|
|
45
|
+
private leakDetectionEnabled;
|
|
46
|
+
private lastLeakCheck;
|
|
47
|
+
private leakCheckInterval;
|
|
48
|
+
private listenersInitialized;
|
|
49
|
+
constructor(config?: Partial<MemoryMonitorConfig>);
|
|
50
|
+
/**
|
|
51
|
+
* Start memory monitoring
|
|
52
|
+
*/
|
|
53
|
+
start(): void;
|
|
54
|
+
/**
|
|
55
|
+
* Stop memory monitoring
|
|
56
|
+
*/
|
|
57
|
+
stop(): void;
|
|
58
|
+
/**
|
|
59
|
+
* Get current memory statistics
|
|
60
|
+
*/
|
|
61
|
+
getCurrentStats(): MemoryStats;
|
|
62
|
+
/**
|
|
63
|
+
* Check memory usage and detect issues
|
|
64
|
+
*/
|
|
65
|
+
private checkMemory;
|
|
66
|
+
/**
|
|
67
|
+
* Check memory usage against thresholds
|
|
68
|
+
*/
|
|
69
|
+
private checkThresholds;
|
|
70
|
+
/**
|
|
71
|
+
* Detect potential memory leaks
|
|
72
|
+
*/
|
|
73
|
+
private detectMemoryLeaks;
|
|
74
|
+
/**
|
|
75
|
+
* Calculate memory usage trend
|
|
76
|
+
*/
|
|
77
|
+
private calculateTrend;
|
|
78
|
+
/**
|
|
79
|
+
* Emit memory alert
|
|
80
|
+
*/
|
|
81
|
+
private emitAlert;
|
|
82
|
+
/**
|
|
83
|
+
* Log memory stats to framework log
|
|
84
|
+
*/
|
|
85
|
+
private logFrameworkMemory;
|
|
86
|
+
/**
|
|
87
|
+
* Get memory usage history
|
|
88
|
+
*/
|
|
89
|
+
getHistory(hours?: number): MemoryStats[];
|
|
90
|
+
/**
|
|
91
|
+
* Get memory usage summary
|
|
92
|
+
*/
|
|
93
|
+
getSummary(): MemorySummary;
|
|
94
|
+
/**
|
|
95
|
+
* Force garbage collection (if available)
|
|
96
|
+
*/
|
|
97
|
+
forceGC(): boolean;
|
|
98
|
+
/**
|
|
99
|
+
* Internal logging method - writes to framework log only
|
|
100
|
+
*/
|
|
101
|
+
private log;
|
|
102
|
+
/**
|
|
103
|
+
* Safely add an alert listener, preventing duplicates
|
|
104
|
+
*/
|
|
105
|
+
addAlertListener(callback: (alert: MemoryLeakAlert) => void): void;
|
|
106
|
+
}
|
|
107
|
+
export declare const memoryMonitor: MemoryMonitor;
|
|
108
|
+
export declare function getMemoryUsage(): MemoryStats;
|
|
109
|
+
export declare function logMemoryUsage(): MemoryStats;
|
|
110
|
+
export declare function checkMemoryHealth(): {
|
|
111
|
+
healthy: boolean;
|
|
112
|
+
issues: string[];
|
|
113
|
+
};
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Nudge Watchdog - Detects and breaks stuck AI patterns
|
|
3
|
+
*
|
|
4
|
+
* Monitors agent actions and detects common failure patterns:
|
|
5
|
+
* - think-loop: AI keeps outputting thinking tags but no progress
|
|
6
|
+
* - syntax-loop: AI keeps trying to fix same file/error multiple times
|
|
7
|
+
* - death-spiral: AI re-explains instead of fixing
|
|
8
|
+
* - tool-loop: Same tool called with similar args repeatedly
|
|
9
|
+
* - repair-failure: Processor indicates fix but error persists
|
|
10
|
+
*
|
|
11
|
+
* @module monitoring/nudge-watchdog
|
|
12
|
+
*/
|
|
13
|
+
import { EventEmitter } from "events";
|
|
14
|
+
export interface NudgeConfig {
|
|
15
|
+
enabled: boolean;
|
|
16
|
+
think_loop_threshold: number;
|
|
17
|
+
syntax_loop_threshold: number;
|
|
18
|
+
tool_loop_threshold: number;
|
|
19
|
+
death_spiral_threshold: number;
|
|
20
|
+
cooldown_ms: number;
|
|
21
|
+
}
|
|
22
|
+
export type NudgeType = "think-loop" | "syntax-loop" | "death-spiral" | "tool-loop" | "repair-failure";
|
|
23
|
+
export interface StuckPattern {
|
|
24
|
+
type: NudgeType;
|
|
25
|
+
count: number;
|
|
26
|
+
firstSeen: number;
|
|
27
|
+
lastSeen: number;
|
|
28
|
+
details: Record<string, unknown>;
|
|
29
|
+
}
|
|
30
|
+
export interface NudgeAction {
|
|
31
|
+
type: NudgeType;
|
|
32
|
+
message: string;
|
|
33
|
+
suggestion: string;
|
|
34
|
+
priority: number;
|
|
35
|
+
}
|
|
36
|
+
declare class NudgeWatchdog extends EventEmitter {
|
|
37
|
+
private config;
|
|
38
|
+
private patterns;
|
|
39
|
+
private lastNudgeTime;
|
|
40
|
+
private thinkTagCount;
|
|
41
|
+
private lastThinkTagTime;
|
|
42
|
+
private toolCallHistory;
|
|
43
|
+
private fixAttempts;
|
|
44
|
+
private explanationCount;
|
|
45
|
+
private codeChangeCount;
|
|
46
|
+
private listenersInitialized;
|
|
47
|
+
constructor(config?: Partial<NudgeConfig>);
|
|
48
|
+
private loadConfigFromFeatures;
|
|
49
|
+
start(): void;
|
|
50
|
+
stop(): void;
|
|
51
|
+
recordThinkTag(): void;
|
|
52
|
+
recordCodeChange(): void;
|
|
53
|
+
recordToolCall(tool: string, args: string): void;
|
|
54
|
+
recordFixAttempt(filePath: string, error: string): void;
|
|
55
|
+
recordExplanation(): void;
|
|
56
|
+
recordProcessorFix(filePath: string, fixed: boolean, errorPersisted: boolean): void;
|
|
57
|
+
private checkThinkLoop;
|
|
58
|
+
private checkToolLoop;
|
|
59
|
+
private checkSyntaxLoop;
|
|
60
|
+
private checkDeathSpiral;
|
|
61
|
+
private checkRepairFailure;
|
|
62
|
+
private checkCooldownAndNudge;
|
|
63
|
+
private triggerNudge;
|
|
64
|
+
getNudgeSuggestion(type: NudgeType, context?: Record<string, unknown>): string;
|
|
65
|
+
private hashArgs;
|
|
66
|
+
private isSimilarError;
|
|
67
|
+
private cleanupOldToolCalls;
|
|
68
|
+
reset(): void;
|
|
69
|
+
getStats(): {
|
|
70
|
+
thinkTags: number;
|
|
71
|
+
codeChanges: number;
|
|
72
|
+
explanations: number;
|
|
73
|
+
activePatterns: number;
|
|
74
|
+
lastNudgeAgo: number;
|
|
75
|
+
};
|
|
76
|
+
private log;
|
|
77
|
+
}
|
|
78
|
+
export declare const nudgeWatchdog: NudgeWatchdog;
|
|
79
|
+
export declare function recordThinkTag(): void;
|
|
80
|
+
export declare function recordCodeChange(): void;
|
|
81
|
+
export declare function recordToolCall(tool: string, args: string): void;
|
|
82
|
+
export declare function recordFixAttempt(filePath: string, error: string): void;
|
|
83
|
+
export declare function recordExplanation(): void;
|
|
84
|
+
export declare function getNudgeSuggestion(type: NudgeType, context?: Record<string, unknown>): string;
|
|
85
|
+
export declare function getNudgeWatchdog(): NudgeWatchdog;
|
|
86
|
+
export declare function recordProcessorFix(filePath: string, fixed: boolean, errorPersisted: boolean): void;
|
|
87
|
+
export {};
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Test Auto-Generation Monitor
|
|
3
|
+
*
|
|
4
|
+
* Tracks and reports on test auto-generation activity.
|
|
5
|
+
* Provides metrics on test creation success/failure rates.
|
|
6
|
+
*
|
|
7
|
+
* @since 2026-02-22
|
|
8
|
+
*/
|
|
9
|
+
export interface TestGenerationMetrics {
|
|
10
|
+
totalFilesProcessed: number;
|
|
11
|
+
testsGenerated: number;
|
|
12
|
+
testsSkipped: number;
|
|
13
|
+
testsFailed: number;
|
|
14
|
+
startTime: number;
|
|
15
|
+
lastGenerationTime: number | null;
|
|
16
|
+
}
|
|
17
|
+
export interface TestGenerationEvent {
|
|
18
|
+
type: "generated" | "skipped" | "failed";
|
|
19
|
+
filePath: string;
|
|
20
|
+
testFile: string | null;
|
|
21
|
+
timestamp: number;
|
|
22
|
+
reason?: string;
|
|
23
|
+
}
|
|
24
|
+
declare class TestAutoGenerationMonitor {
|
|
25
|
+
private metrics;
|
|
26
|
+
private events;
|
|
27
|
+
private maxEvents;
|
|
28
|
+
private metricsFile;
|
|
29
|
+
constructor(metricsDir?: string);
|
|
30
|
+
/**
|
|
31
|
+
* Load metrics from disk if they exist
|
|
32
|
+
*/
|
|
33
|
+
private loadMetrics;
|
|
34
|
+
/**
|
|
35
|
+
* Save metrics to disk
|
|
36
|
+
*/
|
|
37
|
+
private saveMetrics;
|
|
38
|
+
/**
|
|
39
|
+
* Record a test generation event
|
|
40
|
+
*/
|
|
41
|
+
recordEvent(event: TestGenerationEvent): void;
|
|
42
|
+
/**
|
|
43
|
+
* Get current metrics
|
|
44
|
+
*/
|
|
45
|
+
getMetrics(): TestGenerationMetrics;
|
|
46
|
+
/**
|
|
47
|
+
* Get recent events
|
|
48
|
+
*/
|
|
49
|
+
getRecentEvents(count?: number): TestGenerationEvent[];
|
|
50
|
+
/**
|
|
51
|
+
* Get success rate as percentage
|
|
52
|
+
*/
|
|
53
|
+
getSuccessRate(): number;
|
|
54
|
+
/**
|
|
55
|
+
* Generate a status report
|
|
56
|
+
*/
|
|
57
|
+
generateReport(): string;
|
|
58
|
+
/**
|
|
59
|
+
* Reset metrics (for testing)
|
|
60
|
+
*/
|
|
61
|
+
reset(): void;
|
|
62
|
+
}
|
|
63
|
+
export declare const testAutoGenerationMonitor: TestAutoGenerationMonitor;
|
|
64
|
+
export {};
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Lead-dev plan builder — internal implementation for orchestrator + hooks.
|
|
3
|
+
* Config: features.json → multi_agent_orchestration (lead_dev_mode), NOT a separate surface.
|
|
4
|
+
*/
|
|
5
|
+
export declare const LEAD_DEV_RULES: readonly ["Phased plan + detailed todos; assign best subagent; monitor output; iterate fully", "Lead dev takes helm — loop test fix until complete; no permission pings", "Per-suite test triage after major changes; full suite only when individuals pass", "Lead stays main thread; subagents execute; update todos continuously", "Read all console and test output; triage fix rerun", "Never defer errors as pre-existing — add todo and resolve", "Resolve all errors before phase completion"];
|
|
6
|
+
export declare const MANDATORY_MAJOR_CONSULTS: readonly ["researcher", "architect-tools", "code-review"];
|
|
7
|
+
export type SubagentRoute = 'strategist' | 'architect-tools' | 'researcher' | 'backend-engineer' | 'frontend-engineer' | 'bug-triage' | 'code-review' | 'security-audit' | 'enforcer';
|
|
8
|
+
export interface LeadDevTodo {
|
|
9
|
+
id: string;
|
|
10
|
+
task: string;
|
|
11
|
+
subagent: SubagentRoute;
|
|
12
|
+
status: 'pending' | 'in_progress' | 'completed';
|
|
13
|
+
}
|
|
14
|
+
export interface LeadDevPhase {
|
|
15
|
+
id: string;
|
|
16
|
+
name: string;
|
|
17
|
+
goal: string;
|
|
18
|
+
definitionOfDone: string;
|
|
19
|
+
todos: LeadDevTodo[];
|
|
20
|
+
}
|
|
21
|
+
export interface LeadDevPlan {
|
|
22
|
+
active: boolean;
|
|
23
|
+
rules: readonly string[];
|
|
24
|
+
codexTerms: [59, 67, 68, 69];
|
|
25
|
+
description: string;
|
|
26
|
+
complexity: number;
|
|
27
|
+
requiresPhasedPlan: boolean;
|
|
28
|
+
recommendedStrategy: string;
|
|
29
|
+
mandatoryConsults: string[];
|
|
30
|
+
phases: LeadDevPhase[];
|
|
31
|
+
testProtocol: {
|
|
32
|
+
perSuiteFirst: boolean;
|
|
33
|
+
fullSuiteGate: boolean;
|
|
34
|
+
hint: string;
|
|
35
|
+
};
|
|
36
|
+
}
|
|
37
|
+
export declare function isLeadDevModeActive(): boolean;
|
|
38
|
+
export declare function routeSubagent(taskType: string): SubagentRoute;
|
|
39
|
+
export declare function shouldFlagFullTestSuite(command: string): boolean;
|
|
40
|
+
export declare function buildLeadDevPlan(description: string, taskTypes?: string[]): LeadDevPlan | null;
|
|
41
|
+
export declare function buildSessionBootContext(): Record<string, unknown>;
|
|
42
|
+
/** Persist plan for PreToolUse spawn_subagent gate */
|
|
43
|
+
export declare function persistLeadDevPlan(plan: LeadDevPlan, projectRoot?: string): string;
|
|
44
|
+
/** @deprecated Use isLeadDevModeActive */
|
|
45
|
+
export declare const isAutonomyKernelActive: typeof isLeadDevModeActive;
|
|
46
|
+
/** @deprecated Use buildLeadDevPlan */
|
|
47
|
+
export declare const buildAutonomyIntake: typeof buildLeadDevPlan;
|
|
48
|
+
export declare const AUTONOMY_RULES: readonly ["Phased plan + detailed todos; assign best subagent; monitor output; iterate fully", "Lead dev takes helm — loop test fix until complete; no permission pings", "Per-suite test triage after major changes; full suite only when individuals pass", "Lead stays main thread; subagents execute; update todos continuously", "Read all console and test output; triage fix rerun", "Never defer errors as pre-existing — add todo and resolve", "Resolve all errors before phase completion"];
|
|
@@ -0,0 +1,176 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Lead-dev plan builder — internal implementation for orchestrator + hooks.
|
|
3
|
+
* Config: features.json → multi_agent_orchestration (lead_dev_mode), NOT a separate surface.
|
|
4
|
+
*/
|
|
5
|
+
import * as fs from 'fs';
|
|
6
|
+
import * as path from 'path';
|
|
7
|
+
import { featuresConfigLoader } from '../core/features-config.js';
|
|
8
|
+
import { scoreComplexity } from './thin-dispatch.js';
|
|
9
|
+
export const LEAD_DEV_RULES = [
|
|
10
|
+
'Phased plan + detailed todos; assign best subagent; monitor output; iterate fully',
|
|
11
|
+
'Lead dev takes helm — loop test fix until complete; no permission pings',
|
|
12
|
+
'Per-suite test triage after major changes; full suite only when individuals pass',
|
|
13
|
+
'Lead stays main thread; subagents execute; update todos continuously',
|
|
14
|
+
'Read all console and test output; triage fix rerun',
|
|
15
|
+
'Never defer errors as pre-existing — add todo and resolve',
|
|
16
|
+
'Resolve all errors before phase completion',
|
|
17
|
+
];
|
|
18
|
+
export const MANDATORY_MAJOR_CONSULTS = [
|
|
19
|
+
'researcher',
|
|
20
|
+
'architect-tools',
|
|
21
|
+
'code-review',
|
|
22
|
+
];
|
|
23
|
+
const TASK_TYPE_ROUTES = {
|
|
24
|
+
plan: 'strategist',
|
|
25
|
+
architecture: 'architect-tools',
|
|
26
|
+
research: 'researcher',
|
|
27
|
+
implement: 'backend-engineer',
|
|
28
|
+
frontend: 'frontend-engineer',
|
|
29
|
+
test: 'bug-triage',
|
|
30
|
+
review: 'code-review',
|
|
31
|
+
security: 'security-audit',
|
|
32
|
+
governance: 'enforcer',
|
|
33
|
+
};
|
|
34
|
+
function orchestrationConfig() {
|
|
35
|
+
try {
|
|
36
|
+
return featuresConfigLoader.loadConfig().multi_agent_orchestration;
|
|
37
|
+
}
|
|
38
|
+
catch {
|
|
39
|
+
return { enabled: true };
|
|
40
|
+
}
|
|
41
|
+
}
|
|
42
|
+
export function isLeadDevModeActive() {
|
|
43
|
+
const cfg = orchestrationConfig();
|
|
44
|
+
return cfg.enabled && cfg.lead_dev_mode !== false;
|
|
45
|
+
}
|
|
46
|
+
export function routeSubagent(taskType) {
|
|
47
|
+
return TASK_TYPE_ROUTES[taskType.toLowerCase().trim()] ?? 'backend-engineer';
|
|
48
|
+
}
|
|
49
|
+
export function shouldFlagFullTestSuite(command) {
|
|
50
|
+
const cfg = orchestrationConfig();
|
|
51
|
+
if (!cfg.enabled || cfg.per_suite_test_triage === false)
|
|
52
|
+
return false;
|
|
53
|
+
const cmd = command.toLowerCase();
|
|
54
|
+
const isTest = /\b(npm\s+(run\s+)?test|vitest\s+run|pnpm\s+test|yarn\s+test)\b/.test(cmd);
|
|
55
|
+
const hasFocusedTarget = /--\s+\S+\.test/.test(cmd) ||
|
|
56
|
+
/vitest\s+run\s+\S+\.test/.test(cmd) ||
|
|
57
|
+
/\btest:\w+/.test(cmd);
|
|
58
|
+
return isTest && !hasFocusedTarget;
|
|
59
|
+
}
|
|
60
|
+
export function buildLeadDevPlan(description, taskTypes = ['implement']) {
|
|
61
|
+
if (!isLeadDevModeActive())
|
|
62
|
+
return null;
|
|
63
|
+
const cfg = orchestrationConfig();
|
|
64
|
+
const threshold = cfg.phased_plan_threshold ?? 25;
|
|
65
|
+
const score = scoreComplexity(description, { taskTypes });
|
|
66
|
+
const complexity = score.score;
|
|
67
|
+
const requiresPhasedPlan = complexity > threshold;
|
|
68
|
+
const mandatoryConsults = cfg.auto_consult_major_work !== false && requiresPhasedPlan
|
|
69
|
+
? [...MANDATORY_MAJOR_CONSULTS]
|
|
70
|
+
: [];
|
|
71
|
+
const phases = requiresPhasedPlan
|
|
72
|
+
? [
|
|
73
|
+
{
|
|
74
|
+
id: 'phase-1',
|
|
75
|
+
name: 'Research & architecture',
|
|
76
|
+
goal: 'Understand scope before edits',
|
|
77
|
+
definitionOfDone: 'researcher + architect-tools + code-review consulted',
|
|
78
|
+
todos: mandatoryConsults.map((subagent, i) => ({
|
|
79
|
+
id: `1.${i + 1}`,
|
|
80
|
+
task: `Consult ${subagent} on: ${description.slice(0, 120)}`,
|
|
81
|
+
subagent: subagent,
|
|
82
|
+
status: 'pending',
|
|
83
|
+
})),
|
|
84
|
+
},
|
|
85
|
+
{
|
|
86
|
+
id: 'phase-2',
|
|
87
|
+
name: 'Implementation',
|
|
88
|
+
goal: 'Execute with best subagent per todo',
|
|
89
|
+
definitionOfDone: 'Affected per-suite tests green',
|
|
90
|
+
todos: taskTypes.map((type, i) => ({
|
|
91
|
+
id: `2.${i + 1}`,
|
|
92
|
+
task: description.slice(0, 200),
|
|
93
|
+
subagent: routeSubagent(type),
|
|
94
|
+
status: 'pending',
|
|
95
|
+
})),
|
|
96
|
+
},
|
|
97
|
+
{
|
|
98
|
+
id: 'phase-3',
|
|
99
|
+
name: 'Verification',
|
|
100
|
+
goal: 'Per-suite triage then full suite gate',
|
|
101
|
+
definitionOfDone: 'Full test suite green; zero open errors',
|
|
102
|
+
todos: [
|
|
103
|
+
{
|
|
104
|
+
id: '3.1',
|
|
105
|
+
task: 'Run affected test files individually; triage and fix',
|
|
106
|
+
subagent: 'bug-triage',
|
|
107
|
+
status: 'pending',
|
|
108
|
+
},
|
|
109
|
+
{
|
|
110
|
+
id: '3.2',
|
|
111
|
+
task: 'Run full test suite gate',
|
|
112
|
+
subagent: 'bug-triage',
|
|
113
|
+
status: 'pending',
|
|
114
|
+
},
|
|
115
|
+
],
|
|
116
|
+
},
|
|
117
|
+
]
|
|
118
|
+
: [
|
|
119
|
+
{
|
|
120
|
+
id: 'phase-1',
|
|
121
|
+
name: 'Direct execution',
|
|
122
|
+
goal: description.slice(0, 120),
|
|
123
|
+
definitionOfDone: 'Task complete with tests green',
|
|
124
|
+
todos: [
|
|
125
|
+
{
|
|
126
|
+
id: '1.1',
|
|
127
|
+
task: description.slice(0, 200),
|
|
128
|
+
subagent: routeSubagent(taskTypes[0] ?? 'implement'),
|
|
129
|
+
status: 'pending',
|
|
130
|
+
},
|
|
131
|
+
],
|
|
132
|
+
},
|
|
133
|
+
];
|
|
134
|
+
return {
|
|
135
|
+
active: true,
|
|
136
|
+
rules: LEAD_DEV_RULES,
|
|
137
|
+
codexTerms: [59, 67, 68, 69],
|
|
138
|
+
description,
|
|
139
|
+
complexity,
|
|
140
|
+
requiresPhasedPlan,
|
|
141
|
+
recommendedStrategy: score.recommendedStrategy,
|
|
142
|
+
mandatoryConsults,
|
|
143
|
+
phases,
|
|
144
|
+
testProtocol: {
|
|
145
|
+
perSuiteFirst: cfg.per_suite_test_triage !== false,
|
|
146
|
+
fullSuiteGate: true,
|
|
147
|
+
hint: 'After major changes: npm test -- path/to/file.test.ts → fix → repeat → full npm test last',
|
|
148
|
+
},
|
|
149
|
+
};
|
|
150
|
+
}
|
|
151
|
+
export function buildSessionBootContext() {
|
|
152
|
+
if (!isLeadDevModeActive()) {
|
|
153
|
+
return { lead_dev_mode: false, reason: 'multi_agent_orchestration.lead_dev_mode=false' };
|
|
154
|
+
}
|
|
155
|
+
return {
|
|
156
|
+
lead_dev_mode: true,
|
|
157
|
+
codexTerms: [67, 68],
|
|
158
|
+
rules: LEAD_DEV_RULES,
|
|
159
|
+
mcpBoot: 'xray-orchestrator → analyze-complexity (includes lead-dev plan when active)',
|
|
160
|
+
message: '[0xRay] Lead dev mode ON — phased todos, subagent dispatch, loop until green.',
|
|
161
|
+
};
|
|
162
|
+
}
|
|
163
|
+
/** Persist plan for PreToolUse spawn_subagent gate */
|
|
164
|
+
export function persistLeadDevPlan(plan, projectRoot = process.cwd()) {
|
|
165
|
+
const stateDir = path.join(projectRoot, '.xray', 'state');
|
|
166
|
+
fs.mkdirSync(stateDir, { recursive: true });
|
|
167
|
+
const planPath = path.join(stateDir, 'lead-dev-plan.json');
|
|
168
|
+
const payload = { ...plan, persistedAt: new Date().toISOString() };
|
|
169
|
+
fs.writeFileSync(planPath, JSON.stringify(payload, null, 2));
|
|
170
|
+
return planPath;
|
|
171
|
+
}
|
|
172
|
+
/** @deprecated Use isLeadDevModeActive */
|
|
173
|
+
export const isAutonomyKernelActive = isLeadDevModeActive;
|
|
174
|
+
/** @deprecated Use buildLeadDevPlan */
|
|
175
|
+
export const buildAutonomyIntake = buildLeadDevPlan;
|
|
176
|
+
export const AUTONOMY_RULES = LEAD_DEV_RULES;
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* DefaultPlugins — Phase 2C: centralized bootstrap for all knowledge-skill
|
|
3
|
+
* servers as SkillToolPlugin registrations.
|
|
4
|
+
*
|
|
5
|
+
* Exports registerDefaultPlugins() which is called once at boot to register
|
|
6
|
+
* all 24 knowledge-skill MCP servers (plus the researcher) as in-process
|
|
7
|
+
* plugin tools, making them dispatchable without MCP transport.
|
|
8
|
+
*/
|
|
9
|
+
export interface DefaultPluginsResult {
|
|
10
|
+
registered: number;
|
|
11
|
+
failed: string[];
|
|
12
|
+
}
|
|
13
|
+
/**
|
|
14
|
+
* Register all knowledge-skill servers as SkillToolPlugins.
|
|
15
|
+
* Called once at boot. Returns counts of registered and failed servers.
|
|
16
|
+
*/
|
|
17
|
+
export declare function registerDefaultPlugins(): Promise<DefaultPluginsResult>;
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Nucleus HTTP Adapter — semantic convenience surface (Phase 0)
|
|
3
|
+
*
|
|
4
|
+
* IMPORTANT: MCP is the new standard (just as Dynamo is the established standard
|
|
5
|
+
* for the external governance signal). The canonical way for agents to call the
|
|
6
|
+
* nucleus is the first-class MCP tools (`govern_proposals`, `govern_reflection`)
|
|
7
|
+
* exposed by the governance MCP server (which already supports stdio + Streamable
|
|
8
|
+
* HTTP transport on /mcp and already delegates to the same GovernanceService).
|
|
9
|
+
*
|
|
10
|
+
* This module provides the *direct semantic convenience adapter*:
|
|
11
|
+
* - Pure `handleGovernRequest(body)` → returns the raw GovernanceResponse object.
|
|
12
|
+
* - Optional tiny Express app with `POST /govern` (and /health).
|
|
13
|
+
* - No full MCP JSON-RPC protocol overhead — ideal for curl, CI, simple bridges,
|
|
14
|
+
* or anything that just wants the decision without speaking MCP.
|
|
15
|
+
*
|
|
16
|
+
* It reuses the exact same kernel (getGovernanceService + types) as the MCP path.
|
|
17
|
+
* Zero impact on the federation or existing MCP surfaces.
|
|
18
|
+
*
|
|
19
|
+
* Design goals:
|
|
20
|
+
* - Framework-agnostic pure handler (usable by Express, Fastify, raw http, tests, or in-process).
|
|
21
|
+
* - Only frameworkLogger.
|
|
22
|
+
* - Follows the thin-wrapper style of APITrigger.
|
|
23
|
+
*
|
|
24
|
+
* Usage (embeddable / in-process):
|
|
25
|
+
* import { handleGovernRequest } from './nucleus/govern-http.js';
|
|
26
|
+
* const result = await handleGovernRequest(req.body);
|
|
27
|
+
*
|
|
28
|
+
* Usage (standalone):
|
|
29
|
+
* NUCLEUS_PORT=8787 node dist/nucleus/govern-http.js
|
|
30
|
+
*/
|
|
31
|
+
import express from 'express';
|
|
32
|
+
import type { GovernanceResponse } from '../governance/governance-types.js';
|
|
33
|
+
export interface GovernHTTPConfig {
|
|
34
|
+
path?: string;
|
|
35
|
+
apiKey?: string;
|
|
36
|
+
enabled?: boolean;
|
|
37
|
+
port?: number;
|
|
38
|
+
}
|
|
39
|
+
/**
|
|
40
|
+
* Pure handler. Can be used by any HTTP server (Express, Fastify, raw http, etc.)
|
|
41
|
+
* or called directly in tests / in-process.
|
|
42
|
+
*/
|
|
43
|
+
export declare function handleGovernRequest(body: unknown, options?: {
|
|
44
|
+
requireExternalDynamo?: boolean;
|
|
45
|
+
}): Promise<GovernanceResponse>;
|
|
46
|
+
/**
|
|
47
|
+
* Minimal Express app (prototype only).
|
|
48
|
+
* Mirrors the shape and logging discipline of APITrigger.
|
|
49
|
+
*/
|
|
50
|
+
export declare class GovernHTTPAdapter {
|
|
51
|
+
private app;
|
|
52
|
+
private config;
|
|
53
|
+
private initialized;
|
|
54
|
+
constructor(config?: GovernHTTPConfig);
|
|
55
|
+
initialize(): Promise<void>;
|
|
56
|
+
getApp(): express.Application;
|
|
57
|
+
listen(): Promise<void>;
|
|
58
|
+
shutdown(): void;
|
|
59
|
+
}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* xray Nucleus — barrel export
|
|
3
|
+
*
|
|
4
|
+
* Import from here for the stable nucleus surface:
|
|
5
|
+
* import { handleGovernRequest, governSingle } from './nucleus/index.js';
|
|
6
|
+
*/
|
|
7
|
+
export { handleGovernRequest, governSingle, getGovernanceService, GovernHTTPAdapter, NUCLEUS_VERSION, NUCLEUS_DESCRIPTION, } from './kernel.js';
|
|
8
|
+
export type { GovernHTTPConfig } from './govern-http.js';
|
|
9
|
+
export type { GovernanceRequest, GovernanceResponse, GovernanceProposal, GovernanceVote, GovernanceResult, GovernanceContext, GovernOptions, ProposalType, } from '../governance/governance-types.js';
|
|
10
|
+
export { pluginRegistry, } from './plugin-registry.js';
|
|
11
|
+
export type { SkillPlugin, SkillToolPlugin, SkillProposalArgs, SkillPluginResult, ToolDefinition, } from './plugin-registry.js';
|
|
12
|
+
export { scoreComplexity, routeToAgent, scoreAndRoute } from './thin-dispatch.js';
|
|
13
|
+
export type { ComplexityMetrics, ComplexityScore, ComplexityLevel, ComplexityThresholds, } from './thin-dispatch.js';
|
|
14
|
+
export { NUCLEUS_THIN_DISPATCH_VERSION } from './thin-dispatch.js';
|
|
15
|
+
export { LEAD_DEV_RULES, isLeadDevModeActive, buildLeadDevPlan, buildSessionBootContext, shouldFlagFullTestSuite, } from './autonomy-kernel.js';
|
|
16
|
+
export { registerDefaultPlugins } from './default-plugins.js';
|
|
17
|
+
export type { DefaultPluginsResult } from './default-plugins.js';
|
package/dist/nucleus/index.js
CHANGED
|
@@ -8,4 +8,5 @@ export { handleGovernRequest, governSingle, getGovernanceService, GovernHTTPAdap
|
|
|
8
8
|
export { pluginRegistry, } from './plugin-registry.js';
|
|
9
9
|
export { scoreComplexity, routeToAgent, scoreAndRoute } from './thin-dispatch.js';
|
|
10
10
|
export { NUCLEUS_THIN_DISPATCH_VERSION } from './thin-dispatch.js';
|
|
11
|
+
export { LEAD_DEV_RULES, isLeadDevModeActive, buildLeadDevPlan, buildSessionBootContext, shouldFlagFullTestSuite, } from './autonomy-kernel.js';
|
|
11
12
|
export { registerDefaultPlugins } from './default-plugins.js';
|