opencode-swarm 7.139.8 → 7.140.1

package/dist/tools/index.d.ts

@@ -106,6 +106,8 @@ export { lean_turbo_status } from './lean-turbo-status';
 export { lint_spec } from './lint-spec';
 export { mutation_test } from './mutation-test';
 export { executePreparePrWorkflowCheckout, prepare_pr_workflow_checkout, } from './prepare-pr-workflow-checkout';
+export { executeRecordIssuePublication, record_issue_publication, } from './record-issue-publication';
+export { executeRecordIssueReproduction, record_issue_reproduction, } from './record-issue-reproduction';
 export { executeRunPrFeedbackStageA, run_pr_feedback_stage_a, } from './run-pr-feedback-stage-a';
 export { symbols } from './symbols';
 export { type SyntaxCheckFileResult, type SyntaxCheckInput, type SyntaxCheckResult, syntax_check, syntaxCheck, } from './syntax-check';

package/dist/tools/manifest.d.ts

@@ -46,6 +46,8 @@ export declare const TOOL_MANIFEST: {
     abort_pr_workflow: () => ToolDefinition;
     approve_plan_critic: () => ToolDefinition;
     prepare_pr_workflow_checkout: () => ToolDefinition;
+    record_issue_publication: () => ToolDefinition;
+    record_issue_reproduction: () => ToolDefinition;
     run_pr_feedback_stage_a: () => ToolDefinition;
     submit_council_verdicts: () => ToolDefinition;
     submit_phase_council_verdicts: () => ToolDefinition;

package/dist/tools/record-issue-publication.d.ts

@@ -0,0 +1,16 @@
+/**
+ * record_issue_publication — persist an issue-bound publication receipt for the
+ * issue-trace workflow (issue #2131 finding 2.4).
+ *
+ * The issue-trace reducer reaches `publication_handoff` when all implementation
+ * phases are complete and the commit-pr directive has been emitted, but that is
+ * NOT a terminal "issue resolved" state. The trace reaches `published` (the only
+ * terminal state) only after an issue-bound publication receipt is observed.
+ * commit-pr invokes this tool after PR creation/update. The reader
+ * (`publicationReceiptExists` in issue-trace-state.ts) accepts the receipt only
+ * when `published === true` AND `issueNumber` matches the traced issue — so a
+ * prior issue's receipt cannot satisfy a new trace.
+ */
+import { createSwarmTool } from './create-tool';
+export declare function executeRecordIssuePublication(args: unknown, directory: string): Promise<string>;
+export declare const record_issue_publication: ReturnType<typeof createSwarmTool>;

package/dist/tools/record-issue-reproduction.d.ts

@@ -0,0 +1,22 @@
+/**
+ * record_issue_reproduction — persist an issue-bound reproduction receipt for
+ * the issue-trace workflow (issue #2131 finding 2.6).
+ *
+ * The issue-trace reducer requires reproduction evidence (OR a typed waiver)
+ * before the localization → PLAN transition can fire. The noRepro flag/waiver
+ * path is set by `/swarm issue --no-repro`; this tool is the writer for the
+ * case where reproduction was actually performed. The reader
+ * (`reproductionReceiptExists` in issue-trace-state.ts) accepts the receipt only
+ * when `performed === true` and `issueNumber` matches the traced issue.
+ *
+ * Note: this is an agent self-attestation, not an independently verified
+ * reproduction — it records the commands the agent ran and the output summary it
+ * observed. It raises the bar from unchecked prose to a structured, issue-bound
+ * artifact with a session provenance stamp, but does not itself prove the
+ * reproduction exercises the defect.
+ */
+import { createSwarmTool } from './create-tool';
+export declare function executeRecordIssueReproduction(args: unknown, directory: string, context?: {
+    sessionID?: string;
+}): Promise<string>;
+export declare const record_issue_reproduction: ReturnType<typeof createSwarmTool>;

package/dist/tools/repo-graph/ask.d.ts

@@ -0,0 +1,24 @@
+import type { AskOptions, AskResult, GraphNode, RepoGraph } from './types';
+declare function tokenize(text: string): string[];
+declare function splitCompound(token: string): string[];
+declare function buildVocabulary(graph: RepoGraph): Set<string>;
+declare function expandTerms(tokens: string[], vocab: Set<string>): string[];
+declare function computeIDF(term: string, nodes: GraphNode[]): number;
+declare function lexicalScore(node: GraphNode, terms: string[], idfMap: Map<string, number>): {
+    score: number;
+    matchedTerms: string[];
+};
+declare function buildUndirectedAdjacency(graph: RepoGraph, nodeKeys: string[]): Map<string, Set<string>>;
+declare function personalizedPageRank(adj: Map<string, Set<string>>, restart: Map<string, number>, nodeKeys: string[]): Map<string, number>;
+export declare function askGraph(graph: RepoGraph, question: string, options?: AskOptions): AskResult;
+export declare const _internals: {
+    tokenize: typeof tokenize;
+    splitCompound: typeof splitCompound;
+    expandTerms: typeof expandTerms;
+    buildVocabulary: typeof buildVocabulary;
+    computeIDF: typeof computeIDF;
+    lexicalScore: typeof lexicalScore;
+    personalizedPageRank: typeof personalizedPageRank;
+    buildUndirectedAdjacency: typeof buildUndirectedAdjacency;
+};
+export {};

package/dist/tools/repo-graph/query.d.ts

@@ -48,6 +48,8 @@ export declare function getLocalizationContext(graph: RepoGraph, filePath: strin
 export declare function getContextPack(graph: RepoGraph, file: string, symbol: string, options?: {
     maxDepth?: number;
     maxTokens?: number;
+    includeSource?: boolean;
+    directory?: string;
 }): ContextPackResult;
 export declare function getPackageBoundaries(graph: RepoGraph, topN?: number): PackageBoundarySummary[];
 export declare function buildOntologyPreflightPacket(graph: RepoGraph, filePaths?: string[], options?: {

package/dist/tools/repo-graph/types.d.ts

@@ -218,6 +218,8 @@ export interface ContextPackSpan {
     startLine: number;
     endLine: number;
     mode: 'full' | 'signature';
+    text?: string;
+    note?: string;
 }
 /**
  * Result of a context-pack query: the set of spans needed to understand
@@ -239,6 +241,28 @@ export interface ContextPackResult {
     estimatedTokens: number;
     /** Optional human-readable note about scope or limitations. */
     note?: string;
+    /** Whether source text was embedded in spans (only present when include_source was requested). */
+    sourceIncluded?: boolean;
+}
+export interface AskHit {
+    file: string;
+    score: number;
+    matchedTerms: string[];
+    topExports: string[];
+    role: string;
+    community: string;
+}
+export interface AskOptions {
+    topN?: number;
+}
+export interface AskResult {
+    hits: AskHit[];
+    expandedTerms: string[];
+    budget: {
+        requested: number;
+        returned: number;
+        dropped: number;
+    };
 }
 /**
  * A file that references a specific exported symbol of a target file.

package/dist/tools/repo-graph.d.ts

@@ -14,6 +14,7 @@
  *
  * All existing imports of this module continue to work unchanged.
  */
+export { _internals as _askInternals, askGraph } from './repo-graph/ask';
 export type { RepoGraphInputMetadata, RepoGraphInputWalkOptions, RepoGraphInputWalkResult, ScanResult, } from './repo-graph/builder';
 export { addEdge, buildWorkspaceGraph, buildWorkspaceGraphAsync, isGraphWideInputPath, isScannableSourcePath, resolveModuleSpecifier, upsertNode, walkRepoGraphInputs, } from './repo-graph/builder';
 export { clearCache, getCachedGraph, getCachedMtime, isDirty, markDirty, setCachedGraph, } from './repo-graph/cache';
@@ -25,6 +26,6 @@ export { extractFileOntology } from './repo-graph/ontology';
 export type { DeadExportsOptions } from './repo-graph/query';
 export { buildOntologyPreflightPacket, getBlastRadius, getCallers, getContextPack, getDeadExports, getDependencies, getFileOntology, getGraphHealth, getGraphNode, getImporters, getKeyFiles, getLocalizationContext, getPackageBoundaries, getSymbolConsumers, isGraphFresh, resetQueryCache, } from './repo-graph/query';
 export { getGraphPath, loadGraph, loadGraphSync, loadOrCreateGraph, saveGraph, saveIfDirty, } from './repo-graph/storage';
-export type { BlastRadiusResult, BuildWorkspaceGraphOptions, CallerReference, ContextPackResult, ContextPackSpan, ConventionFact, DataOperationFact, DeadExportCandidate, DeadExportsResult, FileOntology, FileReference, FileRole, FreshnessProbeState, GraphEdge, GraphExtractionFailure, GraphExtractorInputWitness, GraphHealthResult, GraphNode, GraphUnresolvedImport, LocalizationBlock, OntologyFinding, PackageBoundarySummary, RepoGraph, RepoGraphDiagnostics, RouteFact, RouteMethod, SecurityFact, SymbolEdge, SymbolReference, } from './repo-graph/types';
-export { createEmptyGraph, GRAPH_SCHEMA_VERSION, isSchemaVersionAtLeast, normalizeGraphPath, REPO_GRAPH_FILENAME, updateGraphMetadata, } from './repo-graph/types';
+export type { AskHit, AskOptions, AskResult, BlastRadiusResult, BuildWorkspaceGraphOptions, CallerReference, ContextPackResult, ContextPackSpan, ConventionFact, DataOperationFact, DeadExportCandidate, DeadExportsResult, FileOntology, FileReference, FileRole, FreshnessProbeState, GraphEdge, GraphExtractionFailure, GraphExtractorInputWitness, GraphHealthResult, GraphNode, GraphUnresolvedImport, LocalizationBlock, OntologyFinding, PackageBoundarySummary, RepoGraph, RepoGraphDiagnostics, RouteFact, RouteMethod, SecurityFact, SymbolEdge, SymbolReference, } from './repo-graph/types';
+export { createEmptyGraph, GRAPH_SCHEMA_VERSION, inferPackageBoundary, isSchemaVersionAtLeast, normalizeGraphPath, REPO_GRAPH_FILENAME, updateGraphMetadata, } from './repo-graph/types';
 export { validateGraphEdge, validateGraphNode, validateWorkspace, } from './repo-graph/validation';

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

@@ -164,6 +164,14 @@ export declare const TOOL_METADATA: {
         description: string;
         agents: "architect"[];
     };
+    record_issue_publication: {
+        description: string;
+        agents: "architect"[];
+    };
+    record_issue_reproduction: {
+        description: string;
+        agents: "architect"[];
+    };
     run_pr_feedback_stage_a: {
         description: string;
         agents: "architect"[];

package/package.json

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