opencode-swarm 6.47.2 → 6.49.0

package/dist/lang/framework-detector.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Framework Detection Utilities
+ *
+ * Provides deterministic multi-signal framework detection.
+ * Laravel detection uses at least 2 of 3 signals to avoid false positives.
+ */
+/**
+ * Detection signals for Laravel framework identification.
+ * Each signal independently indicates a Laravel project.
+ */
+export interface LaravelDetectionSignals {
+    /** artisan file present in project root (no extension) */
+    hasArtisanFile: boolean;
+    /** laravel/framework present in composer.json require dependencies */
+    hasLaravelFrameworkDep: boolean;
+    /** config/app.php present (Laravel config directory structure) */
+    hasConfigApp: boolean;
+}
+/**
+ * Resolved command overlay for a detected Laravel project.
+ * All fields are set to best-available commands for CI-quality use.
+ */
+export interface LaravelCommandOverlay {
+    /** Primary test command. Always php artisan test for Laravel. */
+    testCommand: string;
+    /** Lint/format command. Pint if detected, PHP-CS-Fixer otherwise, null if neither. */
+    lintCommand: string | null;
+    /** Static analysis command. PHPStan if phpstan config is present, null otherwise. */
+    staticAnalysisCommand: string | null;
+    /** Dependency audit command (always composer audit --locked --format=json for Laravel). */
+    auditCommand: string;
+    /** Whether --parallel flag is supported (Pest parallel testing via artisan). */
+    supportsParallel: boolean;
+}
+/**
+ * Detect whether a directory is a Laravel project.
+ * Uses multi-signal detection: at least 2 of 3 signals must be present
+ * to minimize false positives against generic Composer PHP projects.
+ *
+ * Signals checked:
+ * 1. artisan file in project root (strong signal — only Laravel projects have this)
+ * 2. laravel/framework in composer.json require section
+ * 3. config/app.php file (Laravel directory structure)
+ *
+ * @param directory - Absolute path to the project root
+ * @returns true if project is a Laravel project, false otherwise
+ */
+export declare function detectLaravelProject(directory: string): boolean;
+/**
+ * Get individual Laravel detection signals for a directory.
+ * Exposed for testing and diagnostic purposes.
+ *
+ * @param directory - Absolute path to the project root
+ * @returns LaravelDetectionSignals with each signal's boolean state
+ */
+export declare function getLaravelSignals(directory: string): LaravelDetectionSignals;
+/**
+ * Get the Laravel command overlay for a project directory.
+ * Returns null if the directory is not a Laravel project.
+ *
+ * Command selection logic:
+ * - testCommand: always 'php artisan test' (wraps both PHPUnit and Pest)
+ * - lintCommand: 'vendor/bin/pint --test' if pint.json present,
+ *   'vendor/bin/php-cs-fixer fix --dry-run --diff' if .php-cs-fixer.php present,
+ *   null otherwise
+ * - staticAnalysisCommand: 'vendor/bin/phpstan analyse' if phpstan.neon or phpstan.neon.dist present,
+ *   null otherwise
+ * - auditCommand: always 'composer audit --locked --format=json'
+ * - supportsParallel: true (php artisan test --parallel is supported)
+ *
+ * @param directory - Absolute path to the project root
+ * @returns LaravelCommandOverlay if Laravel detected, null if not a Laravel project
+ */
+export declare function getLaravelCommandOverlay(directory: string): LaravelCommandOverlay | null;

package/dist/lang/profiles.d.ts

@@ -55,6 +55,7 @@ export interface LanguageProfile {
     prompts: {
         coderConstraints: string[];
         reviewerChecklist: string[];
+        testConstraints?: string[];
     };
 }
 export declare class LanguageRegistry {

package/dist/services/tool-doctor.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Tool Doctor Service
+ *
+ * Validates that every tool name in TOOL_NAMES has a corresponding
+ * registration in the plugin's tool: {} block in src/index.ts.
+ *
+ * Also validates:
+ * - AGENT_TOOL_MAP alignment: tools assigned to agents are registered in the plugin
+ * - Class 3 tool binary readiness: external binaries needed by lint tools are available
+ */
+import type { ConfigDoctorResult } from './config-doctor';
+/** Result of tool registration coherence check */
+export type ToolDoctorResult = ConfigDoctorResult;
+/**
+ * Run tool registration coherence check
+ *
+ * Verifies that every entry in TOOL_NAMES has a corresponding key
+ * in the plugin's tool: {} block in src/index.ts.
+ */
+export declare function runToolDoctor(_directory: string, pluginRoot?: string): ToolDoctorResult;

package/dist/services/tool-doctor.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/index.d.ts

@@ -21,9 +21,9 @@ export { knowledgeRemove } from './knowledge-remove';
 export { lint } from './lint';
 export { phase_complete } from './phase-complete';
 export { pkg_audit } from './pkg-audit';
-export { type PlaceholderFinding, type PlaceholderScanInput, type PlaceholderScanResult, placeholderScan, } from './placeholder-scan';
+export { type PlaceholderFinding, type PlaceholderScanInput, type PlaceholderScanResult, placeholder_scan, placeholderScan, } from './placeholder-scan';
 export { type PreCheckBatchInput, type PreCheckBatchResult, pre_check_batch, runPreCheckBatch, type ToolResult, } from './pre-check-batch';
-export { type QualityBudgetInput, type QualityBudgetResult, qualityBudget, } from './quality-budget';
+export { type QualityBudgetInput, type QualityBudgetResult, quality_budget, qualityBudget, } from './quality-budget';
 export { retrieve_summary } from './retrieve-summary';
 export { type SastScanFinding, type SastScanInput, type SastScanResult, sast_scan, sastScan, } from './sast-scan';
 export type { SavePlanArgs, SavePlanResult } from './save-plan';
@@ -32,9 +32,12 @@ export { type SbomGenerateInput, type SbomGenerateResult, sbom_generate, } from
 export { schema_drift } from './schema-drift';
 export { search } from './search';
 export { type SecretFinding, type SecretscanResult, secretscan, } from './secretscan';
-export { suggestPatch } from './suggest-patch';
+import { suggestPatch } from './suggest-patch';
+export { suggestPatch };
+export type { SuggestPatchArgs } from './suggest-patch';
+export declare const suggest_patch: typeof suggestPatch;
 export { symbols } from './symbols';
-export { type SyntaxCheckFileResult, type SyntaxCheckInput, type SyntaxCheckResult, syntaxCheck, } from './syntax-check';
+export { type SyntaxCheckFileResult, type SyntaxCheckInput, type SyntaxCheckResult, syntax_check, syntaxCheck, } from './syntax-check';
 export { test_runner } from './test-runner';
 export { todo_extract } from './todo-extract';
 export { executeUpdateTaskStatus, type UpdateTaskStatusArgs, type UpdateTaskStatusResult, update_task_status, } from './update-task-status';

package/dist/tools/placeholder-scan.d.ts

@@ -1,3 +1,4 @@
+import { tool } from '@opencode-ai/plugin';
 import type { EvidenceVerdict } from '../config/evidence-schema';
 export interface PlaceholderScanInput {
     changed_files: string[];
@@ -24,3 +25,4 @@ export interface PlaceholderScanResult {
  * Scan files for placeholder content (TODO/FIXME comments, stub implementations, etc.)
  */
 export declare function placeholderScan(input: PlaceholderScanInput, directory: string): Promise<PlaceholderScanResult>;
+export declare const placeholder_scan: ReturnType<typeof tool>;

package/dist/tools/quality-budget.d.ts

@@ -1,3 +1,4 @@
+import { tool } from '@opencode-ai/plugin';
 import type { QualityBudgetConfig } from '../config/schema';
 import { type QualityMetrics, type QualityViolation } from '../quality/metrics';
 export interface QualityBudgetInput {
@@ -22,3 +23,4 @@ export interface QualityBudgetResult {
  * and compares against configured thresholds to ensure code quality.
  */
 export declare function qualityBudget(input: QualityBudgetInput, directory: string): Promise<QualityBudgetResult>;
+export declare const quality_budget: ReturnType<typeof tool>;

package/dist/tools/syntax-check.d.ts

@@ -1,3 +1,4 @@
+import { tool } from '@opencode-ai/plugin';
 import type { PluginConfig } from '../config';
 import type { EvidenceVerdict } from '../config/evidence-schema';
 export interface SyntaxCheckInput {
@@ -33,3 +34,4 @@ export interface SyntaxCheckResult {
  * Respects config.gates.syntax_check.enabled - returns skipped if disabled
  */
 export declare function syntaxCheck(input: SyntaxCheckInput, directory: string, config?: PluginConfig): Promise<SyntaxCheckResult>;
+export declare const syntax_check: ReturnType<typeof tool>;

package/dist/tools/test-runner.d.ts

@@ -13,6 +13,7 @@ export interface TestRunnerArgs {
     timeout_ms?: number;
     allow_full_suite?: boolean;
 }
+export type RegressionOutcome = 'pass' | 'skip' | 'regression' | 'scope_exceeded' | 'error';
 export interface TestTotals {
     passed: number;
     failed: number;
@@ -30,6 +31,7 @@ export interface TestSuccessResult {
     coveragePercent?: number;
     rawOutput?: string;
     message?: string;
+    outcome?: RegressionOutcome;
 }
 export interface TestErrorResult {
     success: false;
@@ -43,6 +45,8 @@ export interface TestErrorResult {
     error: string;
     rawOutput?: string;
     message?: string;
+    outcome?: RegressionOutcome;
+    attempted_scope?: 'graph';
 }
 export type TestResult = TestSuccessResult | TestErrorResult;
 export declare function detectTestFramework(cwd: string): Promise<TestFramework>;

package/dist/tools/update-task-status.d.ts

@@ -21,6 +21,8 @@ export interface UpdateTaskStatusResult {
     new_status?: string;
     current_phase?: number;
     errors?: string[];
+    /** Present when the call failed due to lock contention. Instructs the caller to retry. */
+    recovery_guidance?: string;
 }
 /**
  * Validate that the status is one of the allowed values.
@@ -72,7 +74,10 @@ export declare function recoverTaskStateFromDelegations(taskId: string): void;
 /**
  * Execute the update_task_status tool.
  * Validates the task_id and status, then updates the task status in the plan.
+ * Uses file locking on plan.json to prevent concurrent writes from corrupting the plan.
+ * Only one concurrent call wins the lock; others return success: false with recovery_guidance: "retry".
  * @param args - The update task status arguments
+ * @param fallbackDir - Fallback working directory if args.working_directory is not provided
  * @returns UpdateTaskStatusResult with success status and details
  */
 export declare function executeUpdateTaskStatus(args: UpdateTaskStatusArgs, fallbackDir?: string): Promise<UpdateTaskStatusResult>;

package/dist/tools/verify-six-tools-registration.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Verification tests for the 6 registered tools
+ *
+ * Verifies:
+ * 1. All 6 tools can be imported from './tools/index.ts'
+ * 2. The tool: {} block in src/index.ts includes all 6 tools
+ * 3. The plugin can load without errors
+ */
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencode-swarm",
-	"version": "6.47.2",
+	"version": "6.49.0",
 	"description": "Architect-centric agentic swarm plugin for OpenCode - hub-and-spoke orchestration with SME consultation, code generation, and QA review",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",