opencode-swarm 7.140.5 → 7.141.0

package/dist/lang/backend.d.ts

@@ -83,7 +83,12 @@ export interface TestRunSummary {
  * can accept them in `buildTestCommand` without a circular import back to
  * `src/tools/test-runner.ts`.
  */
-export type TestScope = 'all' | 'convention' | 'graph' | 'impact';
+export type TestScope = 'all' | 'convention' | 'graph' | 'impact' | 'target';
+export interface NativeTestTarget {
+    framework: 'go-test' | 'ctest';
+    name: string;
+    path: string;
+}
 /**
  * Options influencing build-command construction. Backends may ignore
  * unrecognized opts; the default backend honors all of these.
@@ -92,6 +97,7 @@ export interface BuildTestCommandOpts {
     scope?: TestScope;
     coverage?: boolean;
     bail?: boolean;
+    nativeTarget?: NativeTestTarget;
 }
 /**
  * Selected web/UI framework for a project (PROJECT_FRAMEWORK template

package/dist/lang/default-backend.d.ts

@@ -9,7 +9,7 @@
  * to the environment, and it lives in `src/build/discovery.ts` with full
  * invariant-3 properties (cwd, stdin: 'ignore', timeout, bounded stdio).
  */
-import type { BuildCommandSelection, BuildTestCommandOpts, FrameworkSelection, LanguageBackend, TestFrameworkSelection, TestRunSummary } from './backend';
+import type { BuildCommandSelection, BuildTestCommandOpts, FrameworkSelection, LanguageBackend, NativeTestTarget, TestFrameworkSelection, TestRunSummary } from './backend';
 import type { LanguageProfile } from './profiles';
 /**
  * Tokenize a string command into an array. Splits on whitespace; respects
@@ -47,6 +47,7 @@ export declare function defaultSelectTestFramework(profile: LanguageProfile, dir
  * Returns null when the framework name is not in the supported set.
  */
 export declare function defaultBuildTestCommand(profile: LanguageProfile, framework: string, files: string[], dir?: string, opts?: BuildTestCommandOpts): string[] | null;
+export declare function buildNativeTargetCommand(target: NativeTestTarget): string[];
 /**
  * Default parseTestOutput: full 14-framework switch ported verbatim from
  * `src/tools/test-runner.ts:parseTestOutput`. Returns a TestRunSummary

package/dist/tools/create-tool.d.ts

@@ -18,11 +18,14 @@ export type ToolResult = string | {
 export interface SwarmToolOptions<Args extends Record<string, unknown>> {
     description: string;
     args: Args;
+    allowWorkingDirectoryOverride?: boolean;
     execute: (args: Args, directory: string, ctx?: ToolContext) => Promise<ToolResult>;
 }
 /**
- * Creates a swarm tool with automatic working directory injection.
- * Wraps the @opencode-ai/plugin/tool factory to always inject `directory` and `ctx` into tool execute callbacks.
+ * Creates a swarm tool with optional working_directory override injection.
+ * Wraps the @opencode-ai/plugin/tool factory to always inject `directory` and `ctx`
+ * into tool execute callbacks, and to expose a caller-controlled
+ * `working_directory` only for tools that explicitly opt into that override.
  *
  * Registration contract (issue #1781 E4): every `export const NAME = createSwarmTool({...})`
  * in `src/tools/**` MUST have a corresponding entry in `TOOL_METADATA`

package/dist/tools/dispatch-lanes.d.ts

@@ -2,6 +2,7 @@ import { z } from 'zod';
 import { type BackgroundDelegationRecord } from '../background/pending-delegations.js';
 import { resolveExactMergeBaseAsync, resolvePrWorkflowRevisionDigestAsync } from '../background/workspace-snapshot.js';
 import { type PrReviewDepthTier } from '../hooks/pr-workflow-gate.js';
+import { buildLaneOrientationBlock } from '../hooks/repo-graph-injection.js';
 import { createParallelDispatcher } from '../parallel/dispatcher/parallel-dispatcher.js';
 import { createSwarmTool } from './create-tool.js';
 export declare const MAX_PROMPT_CHARS = 80000;
@@ -31,6 +32,7 @@ declare const DispatchLanesArgsSchema: z.ZodObject<{
     common_prompt: z.ZodOptional<z.ZodString>;
     max_concurrent: z.ZodOptional<z.ZodNumber>;
     timeout_ms: z.ZodOptional<z.ZodNumber>;
+    orientation: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 declare const DispatchLanesAsyncArgsSchema: z.ZodObject<{
     lanes: z.ZodArray<z.ZodObject<{
@@ -45,6 +47,7 @@ declare const DispatchLanesAsyncArgsSchema: z.ZodObject<{
     common_prompt: z.ZodOptional<z.ZodString>;
     max_concurrent: z.ZodOptional<z.ZodNumber>;
     timeout_ms: z.ZodOptional<z.ZodNumber>;
+    orientation: z.ZodOptional<z.ZodBoolean>;
     launch_timeout_ms: z.ZodOptional<z.ZodNumber>;
     batch_id: z.ZodOptional<z.ZodString>;
     mode: z.ZodOptional<z.ZodString>;
@@ -290,6 +293,7 @@ export declare const _test_exports: {
     applyCommonPrompt: typeof applyCommonPrompt;
     applyExplorerFormatSuffix: typeof applyExplorerFormatSuffix;
     applyPrWorkflowPromptContract: typeof applyPrWorkflowPromptContract;
+    augmentCommonPromptWithOrientation: typeof augmentCommonPromptWithOrientation;
     buildCollectResult: typeof buildCollectResult;
     buildReadOnlyTools: typeof buildReadOnlyTools;
     buildLaneSessionCreateArgs: typeof buildLaneSessionCreateArgs;
@@ -311,6 +315,7 @@ export declare const _test_exports: {
         common_prompt: z.ZodOptional<z.ZodString>;
         max_concurrent: z.ZodOptional<z.ZodNumber>;
         timeout_ms: z.ZodOptional<z.ZodNumber>;
+        orientation: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>;
     DispatchLanesAsyncArgsSchema: z.ZodObject<{
         lanes: z.ZodArray<z.ZodObject<{
@@ -325,6 +330,7 @@ export declare const _test_exports: {
         common_prompt: z.ZodOptional<z.ZodString>;
         max_concurrent: z.ZodOptional<z.ZodNumber>;
         timeout_ms: z.ZodOptional<z.ZodNumber>;
+        orientation: z.ZodOptional<z.ZodBoolean>;
         launch_timeout_ms: z.ZodOptional<z.ZodNumber>;
         batch_id: z.ZodOptional<z.ZodString>;
         mode: z.ZodOptional<z.ZodString>;
@@ -372,9 +378,10 @@ export declare const _test_exports: {
     DEFAULT_ASYNC_STALE_TIMEOUT_MS: number;
     DEFAULT_COLLECT_TIMEOUT_MS: number;
     /**
-     * Clears the module-level `deliveredLaneOutputs` de-dupe set (see
-     * S1.1) so tests can assert first-poll vs. repeat-poll behavior without
-     * cross-test bleed-through.
+     * Clears the lane-output delivery de-dupe state (see S1.1) so tests can
+     * assert first-poll vs. repeat-poll behavior without cross-test
+     * bleed-through. Delegates to the persistent lane-delivery store's
+     * in-memory reset; disk state is untouched.
      */
     resetDeliveredLaneOutputs: () => void;
     recordToLaneResult: typeof recordToLaneResult;
@@ -406,8 +413,14 @@ declare function extractAssistantTranscript(messages: Array<{
     transcriptIncomplete: boolean;
 };
 declare function nextCollectPollInterval(currentMs: number): number;
-declare function buildCollectResult(batchId: string, records: BackgroundDelegationRecord[], includePending: boolean): CollectLaneResultsResult;
-declare function recordToLaneResult(record: BackgroundDelegationRecord, batchId: string): DispatchLaneResult;
+declare function buildCollectResult(batchId: string, records: BackgroundDelegationRecord[], includePending: boolean, deliveryContext?: {
+    directory?: string;
+    sessionID?: string;
+}): CollectLaneResultsResult;
+declare function recordToLaneResult(record: BackgroundDelegationRecord, batchId: string, deliveryContext?: {
+    directory?: string;
+    sessionID?: string;
+}): DispatchLaneResult;
 declare function buildReadOnlyTools(): ReadOnlyToolPermissions;
 type ApplyCommonPromptResult = {
     ok: true;
@@ -426,6 +439,33 @@ type ApplyCommonPromptResult = {
  * when no `commonPrompt` is provided, or shallow-copied lanes with rewritten
  * prompts when it is. Callers may treat the returned array as their own.
  */
+interface OrientationAugmentDeps {
+    buildBlock?: typeof buildLaneOrientationBlock;
+}
+/**
+ * Resolve the `orientation` arg into an augmented common_prompt (issue #1988 C2).
+ *
+ * Execute-time resolution (no zod default — a schema default cannot depend on
+ * graph state): `false` skips entirely; `true` or undefined attempts the block,
+ * and buildLaneOrientationBlock itself returns null unless a fresh graph
+ * exists, so undefined degrades to "false when no fresh graph".
+ *
+ * Overflow rule: the drop decision runs ONCE here, at the common+lane stage —
+ * max over lanes of (common_prompt + orientation + separator + lane.prompt +
+ * ORIENTATION_SUFFIX_RESERVE_CHARS) versus MAX_PROMPT_CHARS — BEFORE
+ * appending. If any lane would exceed the cap the block is dropped (debug
+ * log) rather than truncating content or failing dispatch. The reserve keeps
+ * typical suffix appends (fixed worst case ≈3.2k chars) out of failure
+ * territory they would not have reached without the block; extreme but
+ * schema-valid configurations (maxed item-id/owned-lane arrays) can exceed
+ * the reserve, and anything beyond it remains the caller's own size
+ * responsibility, as before this feature.
+ *
+ * Fail-open: any builder error degrades to the un-augmented common_prompt.
+ */
+declare function augmentCommonPromptWithOrientation(directory: string, lanes: readonly {
+    prompt: string;
+}[], commonPrompt: string | undefined, orientation: boolean | undefined, sessionID: string | undefined, deps?: OrientationAugmentDeps): Promise<string | undefined>;
 declare function applyCommonPrompt(lanes: DispatchLaneSpec[], commonPrompt: string | undefined): ApplyCommonPromptResult;
 declare function applyExplorerFormatSuffix(lanes: DispatchLaneSpec[], options?: {
     failClosed?: boolean;

package/dist/tools/knowledge-receipt.d.ts

@@ -12,8 +12,48 @@
  * relevant, the receipt can set `no_relevant_knowledge: true` — the point is to
  * force explicit consideration, not fake usage.
  */
+import { z } from 'zod';
 import { createSwarmTool } from './create-tool.js';
+declare const ignoredItem: z.ZodObject<{
+    id: z.ZodString;
+    reason: z.ZodEnum<{
+        stale: "stale";
+        other: "other";
+        superseded: "superseded";
+        unsafe: "unsafe";
+        too_generic: "too_generic";
+        already_satisfied: "already_satisfied";
+    }>;
+    note: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * A shown entry that did not apply to the task at hand (issue #2032).
+ * Reasoned: the reason is required so `n_a` cannot be used as a silent
+ * evasion channel — a gate consumer can always ask "why not applicable?".
+ * The reason is trimmed before validation (min(1) after trim), so a
+ * whitespace-only reason is rejected exactly like an empty one — matching
+ * the phase gate's `reason?.trim()` resolution rule.
+ */
+declare const notApplicableItem: z.ZodObject<{
+    id: z.ZodString;
+    reason: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Map the calling agent to a canonical receipt-source class (issue #2032).
+ * Explicit allowlist — do NOT widen silently. The three independent-verifier
+ * roles the knowledge contract names get their own class; every other
+ * non-empty role (coder, spec_writer, sme, docs, designer, custom roles) is
+ * the exposed agent reporting on itself, which is exactly what the
+ * `'delegate'` source class means — a self-report, NOT "subagent of an
+ * architect". Unknown/absent caller stays honestly `'unknown'`; missing
+ * legacy source is never inferred.
+ */
+declare function receiptSourceForAgent(agent: string): string;
 export declare const knowledge_receipt: ReturnType<typeof createSwarmTool>;
 export declare const _internals: {
     knowledge_receipt: typeof knowledge_receipt;
+    receiptSourceForAgent: typeof receiptSourceForAgent;
+    ignoredItemSchema: typeof ignoredItem;
+    notApplicableItemSchema: typeof notApplicableItem;
 };
+export {};

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

@@ -1,8 +1,11 @@
 import * as fs from 'node:fs';
 import type { tool } from '@opencode-ai/plugin';
 import { isCommandAvailable } from '../build/discovery';
+import type { NativeTestTarget, TestScope } from '../lang/backend';
+import { buildNativeTargetCommand } from '../lang/default-backend';
 import { analyzeImpact, loadImpactMap } from '../test-impact/analyzer.js';
 import { getAllHistory, type TestRunRecord } from '../test-impact/history-store.js';
+import { bunSpawn } from '../utils/bun-compat';
 export declare const MAX_OUTPUT_BYTES = 512000;
 export declare const MAX_COMMAND_LENGTH = 500;
 export declare const DEFAULT_TIMEOUT_MS = 60000;
@@ -23,8 +26,9 @@ export declare function estimateFanOut(sourceFiles: string[], cwd: string): Prom
 export declare const SUPPORTED_FRAMEWORKS: readonly ["bun", "vitest", "jest", "mocha", "pytest", "cargo", "pester", "go-test", "maven", "gradle", "dotnet-test", "ctest", "swift-test", "dart-test", "rspec", "minitest", "pest", "phpunit", "php-artisan"];
 export type TestFramework = (typeof SUPPORTED_FRAMEWORKS)[number] | 'none';
 export interface TestRunnerArgs {
-    scope?: 'all' | 'convention' | 'graph' | 'impact';
+    scope?: TestScope;
     files?: string[];
+    native_target?: NativeTestTarget;
     coverage?: boolean;
     timeout_ms?: number;
     bail?: boolean;
@@ -48,7 +52,7 @@ declare const AGGREGATE_TEST_NAME = "(aggregate)";
 export interface TestSuccessResult {
     success: true;
     framework: TestFramework;
-    scope: 'all' | 'convention' | 'graph' | 'impact';
+    scope: TestScope;
     command: string[];
     timeout_ms: number;
     duration_ms: number;
@@ -62,7 +66,7 @@ export interface TestSuccessResult {
 export interface TestErrorResult {
     success: false;
     framework: TestFramework;
-    scope: 'all' | 'convention' | 'graph' | 'impact';
+    scope: TestScope;
     command?: string[];
     timeout_ms?: number;
     duration_ms?: number;
@@ -103,7 +107,7 @@ export declare function detectTestFrameworkViaDispatch(cwd: string): Promise<Tes
  * Returns null on framework=`none` or when dispatch fails — callers (the
  * test-runner) then surface "no test command available".
  */
-export declare function buildTestCommandViaDispatch(framework: TestFramework, scope: 'all' | 'convention' | 'graph' | 'impact', files: string[], coverage: boolean, baseDir: string, bail: boolean): Promise<string[] | null>;
+export declare function buildTestCommandViaDispatch(framework: TestFramework, scope: TestScope, files: string[], coverage: boolean, baseDir: string, bail: boolean, nativeTarget?: NativeTestTarget): Promise<string[] | null>;
 /**
  * Parse test output via the LanguageBackend dispatch path. Calls
  * `backend.parseTestOutput` for the directory's resolved backend and
@@ -147,7 +151,8 @@ export declare function isLanguageSpecificTestFile(basename: string): boolean;
  * Exported for unit tests.
  */
 export declare function getTestFilesFromConvention(sourceFiles: string[], workingDir?: string): string[];
-export declare function runTests(framework: TestFramework, scope: 'all' | 'convention' | 'graph' | 'impact', files: string[], coverage: boolean, timeout_ms: number, cwd: string, bail: boolean): Promise<TestResult>;
+declare function formatNativeHistoryTestFile(target: NativeTestTarget, historyPath: string): string;
+export declare function runTests(framework: TestFramework, scope: TestScope, files: string[], coverage: boolean, timeout_ms: number, cwd: string, bail: boolean, nativeTarget?: NativeTestTarget): Promise<TestResult>;
 declare function selectHistoryForAnalysis(history: ReturnType<typeof getAllHistory>): TestRunRecord[];
 export declare const test_runner: ReturnType<typeof tool>;
 export declare const _internals: {
@@ -157,6 +162,9 @@ export declare const _internals: {
     existsSync: typeof fs.existsSync;
     readdirSync: typeof fs.readdirSync;
     readFileSync: typeof fs.readFileSync;
+    bunSpawn: typeof bunSpawn;
+    buildNativeTargetCommand: typeof buildNativeTargetCommand;
+    formatNativeHistoryTestFile: typeof formatNativeHistoryTestFile;
     selectHistoryForAnalysis: typeof selectHistoryForAnalysis;
     AGGREGATE_TEST_NAME: typeof AGGREGATE_TEST_NAME;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencode-swarm",
-	"version": "7.140.5",
+	"version": "7.141.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",