opencode-swarm 6.19.8 → 6.20.0

package/dist/commands/checkpoint.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Handle /swarm checkpoint command
+ * Creates, lists, restores, or deletes checkpoints with optional label
+ */
+export declare function handleCheckpointCommand(directory: string, args: string[]): Promise<string>;

package/dist/context/role-filter.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Role-Scoped Context Injection Filter
+ * Filters context entries based on [FOR: ...] tags for role-based context delivery.
+ */
+/**
+ * Context entry with role metadata
+ */
+export interface ContextEntry {
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+    name?: string;
+}
+/**
+ * Filter context entries based on target role and [FOR: ...] tags.
+ *
+ * Filtering rules:
+ * - Entries with [FOR: ALL] are included for all agents
+ * - Entries with [FOR: specific_agents] are included only for named agents
+ * - Entries without [FOR: ...] tag are included for all agents (backward compatibility)
+ * - System prompts, delegation envelopes, plan content, and knowledge entries are never filtered
+ *
+ * @param entries - Array of context entries to filter
+ * @param targetRole - The target agent role to filter for
+ * @param directory - Optional project directory for metrics logging (defaults to cwd)
+ * @returns Filtered array of context entries
+ */
+export declare function filterByRole(entries: ContextEntry[], targetRole: string, directory?: string): ContextEntry[];

package/dist/context/zone-classifier.d.ts

@@ -0,0 +1,17 @@
+export type FileZone = 'production' | 'test' | 'config' | 'generated' | 'docs' | 'build';
+export interface ZoneClassification {
+    filePath: string;
+    zone: FileZone;
+    confidence: 'high' | 'medium';
+    reason: string;
+}
+export interface ZonePolicy {
+    qaDepth: 'full' | 'standard' | 'light' | 'skip';
+    lintRequired: boolean;
+    testRequired: boolean;
+    reviewRequired: boolean;
+    securityReviewRequired: boolean;
+}
+export declare function classifyFile(filePath: string): ZoneClassification;
+export declare function classifyFiles(filePaths: string[]): ZoneClassification[];
+export declare function getZonePolicy(zone: FileZone): ZonePolicy;

package/dist/diff/ast-diff.d.ts

@@ -0,0 +1,20 @@
+export interface ASTChange {
+    type: 'added' | 'modified' | 'removed';
+    category: 'function' | 'class' | 'type' | 'export' | 'import' | 'variable' | 'other';
+    name: string;
+    lineStart: number;
+    lineEnd: number;
+    signature?: string;
+}
+export interface ASTDiffResult {
+    filePath: string;
+    language: string | null;
+    changes: ASTChange[];
+    durationMs: number;
+    usedAST: boolean;
+    error?: string;
+}
+/**
+ * Compute AST-level diff between old and new file content
+ */
+export declare function computeASTDiff(filePath: string, oldContent: string, newContent: string): Promise<ASTDiffResult>;

package/dist/git/branch.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Check if we're in a git repository
+ */
+export declare function isGitRepo(cwd: string): boolean;
+/**
+ * Get current branch name
+ */
+export declare function getCurrentBranch(cwd: string): string;
+/**
+ * Create a new branch
+ * @param cwd - Working directory
+ * @param branchName - Name of the branch to create
+ * @param remote - Remote name (default: 'origin')
+ */
+export declare function createBranch(cwd: string, branchName: string, remote?: string): void;
+/**
+ * Get list of changed files compared to main/master
+ * @param cwd - Working directory
+ * @param branch - Base branch to compare against (optional, auto-detected if not provided)
+ * @returns Array of changed file paths, or empty array if error occurs
+ */
+export declare function getChangedFiles(cwd: string, branch?: string): string[];
+/**
+ * Get default base branch (main or master)
+ */
+export declare function getDefaultBaseBranch(cwd: string): string;
+/**
+ * Stage specific files for commit
+ * @param cwd - Working directory
+ * @param files - Array of file paths to stage (must not be empty)
+ * @throws Error if files array is empty
+ */
+export declare function stageFiles(cwd: string, files: string[]): void;
+/**
+ * Stage all files in the working directory
+ * @param cwd - Working directory
+ */
+export declare function stageAll(cwd: string): void;
+/**
+ * Commit changes
+ */
+export declare function commitChanges(cwd: string, message: string): void;
+/**
+ * Get current commit SHA
+ */
+export declare function getCurrentSha(cwd: string): string;
+/**
+ * Check if there are uncommitted changes
+ */
+export declare function hasUncommittedChanges(cwd: string): boolean;

package/dist/git/index.d.ts

@@ -0,0 +1,22 @@
+import { createBranch, isGitRepo } from './branch.js';
+import { isAuthenticated, isGhAvailable } from './pr.js';
+export interface PRWorkflowOptions {
+    title: string;
+    body?: string;
+    branch?: string;
+}
+export interface PRWorkflowResult {
+    success: boolean;
+    url?: string;
+    number?: number;
+    error?: string;
+}
+/**
+ * Full PR workflow: create branch → commit → push → create PR
+ */
+export declare function runPRWorkflow(cwd: string, options: PRWorkflowOptions): Promise<PRWorkflowResult>;
+/**
+ * Generate evidence summary without creating PR
+ */
+export declare function prepareEvidence(cwd: string): string;
+export { isGhAvailable, isAuthenticated, isGitRepo, createBranch };

package/dist/git/pr.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Sanitize input string to prevent command injection
+ * Removes or escapes shell metacharacters
+ */
+export declare function sanitizeInput(input: string): string;
+/**
+ * Check if gh CLI is available
+ */
+export declare function isGhAvailable(cwd: string): boolean;
+/**
+ * Check if authenticated with gh
+ */
+export declare function isAuthenticated(cwd: string): boolean;
+/**
+ * Create evidence.md summary
+ */
+export declare function generateEvidenceMd(cwd: string): string;
+/**
+ * Create a pull request
+ */
+export declare function createPullRequest(cwd: string, title: string, body?: string, baseBranch?: string): Promise<{
+    url: string;
+    number: number;
+}>;
+/**
+ * Commit and push current changes
+ */
+export declare function commitAndPush(cwd: string, message: string): void;

package/dist/hooks/delegation-gate.d.ts

@@ -5,6 +5,13 @@
  * Uses experimental.chat.messages.transform to provide non-blocking guidance.
  */
 import type { PluginConfig } from '../config';
+import type { DelegationEnvelope } from '../types/delegation.js';
+/**
+ * Parses a string to extract a DelegationEnvelope.
+ * Returns null if no valid envelope is found.
+ * Never throws - all errors are caught and result in null.
+ */
+export declare function parseDelegationEnvelope(content: string): DelegationEnvelope | null;
 interface MessageInfo {
     role: string;
     agent?: string;

package/dist/hooks/knowledge-store.d.ts

@@ -1,5 +1,6 @@
 /** Core storage layer for the opencode-swarm v6.17 two-tier knowledge system. */
 import type { RejectedLesson } from './knowledge-types.js';
+export declare function getPlatformConfigDir(): string;
 export declare function resolveSwarmKnowledgePath(directory: string): string;
 export declare function resolveSwarmRejectedPath(directory: string): string;
 export declare function resolveHiveKnowledgePath(): string;

package/dist/knowledge/identity.d.ts

@@ -0,0 +1,25 @@
+/** Project Identity Management for opencode-swarm.
+ * Handles creation and retrieval of project identity files.
+ */
+export interface ProjectIdentity {
+    projectHash: string;
+    projectName: string;
+    repoUrl?: string;
+    absolutePath: string;
+    createdAt: string;
+    swarmVersion: string;
+}
+/**
+ * Get identity file path for a project hash.
+ * Path: {platform-config-dir}/projects/{projectHash}/identity.json
+ */
+export declare function resolveIdentityPath(projectHash: string): string;
+/**
+ * Read existing identity.json or return null if it doesn't exist.
+ */
+export declare function readProjectIdentity(projectHash: string): Promise<ProjectIdentity | null>;
+/**
+ * Create or update identity.json for a project.
+ * Uses atomic write pattern (write to temp file, then rename).
+ */
+export declare function writeProjectIdentity(directory: string, projectHash: string, projectName: string): Promise<ProjectIdentity>;

package/dist/knowledge/index.d.ts

@@ -0,0 +1,2 @@
+/** Knowledge system exports for opencode-swarm. */
+export * from './identity.js';

package/dist/output/agent-writer.d.ts

@@ -0,0 +1,27 @@
+export type AgentType = 'architect' | 'coder' | 'reviewer' | 'test_engineer' | 'explorer' | 'sme' | 'critic' | 'docs' | 'designer';
+export type OutputType = 'review' | 'test' | 'research' | 'analysis' | 'summary';
+export interface AgentOutputMetadata {
+    agent: AgentType;
+    type: OutputType;
+    taskId: string;
+    phase: number;
+    timestamp: string;
+    durationMs?: number;
+    success?: boolean;
+}
+/**
+ * Write agent output to persistent storage
+ * Output: .swarm/outputs/phase-N/task-N.M/{agent}-{type}-{timestamp}.md
+ */
+export declare function writeAgentOutput(directory: string, metadata: AgentOutputMetadata, content: string): Promise<string>;
+/**
+ * Read agent output from persistent storage
+ */
+export declare function readAgentOutput(directory: string, phase: number, taskId: string): Promise<{
+    metadata: AgentOutputMetadata;
+    content: string;
+}[]>;
+/**
+ * List all agent outputs for a phase
+ */
+export declare function listAgentOutputs(directory: string, phase?: number): Promise<AgentOutputMetadata[]>;

package/dist/output/index.d.ts

@@ -0,0 +1 @@
+export { type AgentOutputMetadata, type AgentType, listAgentOutputs, type OutputType, readAgentOutput, writeAgentOutput, } from './agent-writer';

package/dist/parallel/dependency-graph.d.ts

@@ -0,0 +1,34 @@
+export interface TaskNode {
+    id: string;
+    phase: number;
+    description: string;
+    depends: string[];
+    dependents: string[];
+    status: 'pending' | 'in_progress' | 'complete' | 'blocked';
+}
+export interface DependencyGraph {
+    tasks: Map<string, TaskNode>;
+    phases: Map<number, string[]>;
+    roots: string[];
+    leaves: string[];
+}
+/**
+ * Parse plan.json and build dependency graph
+ */
+export declare function parseDependencyGraph(planPath: string): DependencyGraph;
+/**
+ * Get tasks that can run in parallel (no unresolved dependencies)
+ */
+export declare function getRunnableTasks(graph: DependencyGraph): string[];
+/**
+ * Check if a task is blocked (has incomplete dependencies)
+ */
+export declare function isTaskBlocked(graph: DependencyGraph, taskId: string): boolean;
+/**
+ * Get execution order (topological sort)
+ */
+export declare function getExecutionOrder(graph: DependencyGraph): string[];
+/**
+ * Find all paths from root to a task
+ */
+export declare function getDependencyChain(graph: DependencyGraph, taskId: string): string[];

package/dist/parallel/file-locks.d.ts

@@ -0,0 +1,33 @@
+export interface FileLock {
+    filePath: string;
+    agent: string;
+    taskId: string;
+    timestamp: string;
+    expiresAt: number;
+}
+/**
+ * Try to acquire a lock on a file
+ */
+export declare function tryAcquireLock(directory: string, filePath: string, agent: string, taskId: string): {
+    acquired: true;
+    lock: FileLock;
+} | {
+    acquired: false;
+    existing?: FileLock;
+};
+/**
+ * Release a lock on a file
+ */
+export declare function releaseLock(directory: string, filePath: string, taskId: string): boolean;
+/**
+ * Check if a file is locked
+ */
+export declare function isLocked(directory: string, filePath: string): FileLock | null;
+/**
+ * Clean up expired locks
+ */
+export declare function cleanupExpiredLocks(directory: string): number;
+/**
+ * List all active locks
+ */
+export declare function listActiveLocks(directory: string): FileLock[];

package/dist/parallel/index.d.ts

@@ -0,0 +1,4 @@
+export { type DependencyGraph, getDependencyChain, getExecutionOrder, getRunnableTasks, isTaskBlocked, parseDependencyGraph, type TaskNode, } from './dependency-graph.js';
+export { cleanupExpiredLocks, type FileLock, isLocked, listActiveLocks, releaseLock, tryAcquireLock, } from './file-locks.js';
+export { extractMetaSummaries, getLatestTaskSummary, indexMetaSummaries, type MetaSummaryEntry, querySummaries, } from './meta-indexer.js';
+export { type ComplexityMetrics, computeComplexity, type ReviewDepth, type ReviewRouting, routeReview, routeReviewForChanges, shouldParallelizeReview, } from './review-router.js';

package/dist/parallel/meta-indexer.d.ts

@@ -0,0 +1,32 @@
+export interface MetaSummaryEntry {
+    timestamp: string;
+    phase?: number;
+    taskId?: string;
+    agent?: string;
+    summary: string;
+    source?: string;
+}
+/**
+ * Extract meta.summary from event JSONL files
+ */
+export declare function extractMetaSummaries(eventsPath: string): MetaSummaryEntry[];
+/**
+ * Index meta summaries to external knowledge store
+ */
+export declare function indexMetaSummaries(directory: string, externalKnowledgeDir?: string): Promise<{
+    indexed: number;
+    path: string;
+}>;
+/**
+ * Query indexed summaries
+ */
+export declare function querySummaries(directory: string, options?: {
+    phase?: number;
+    taskId?: string;
+    agent?: string;
+    since?: string;
+}): MetaSummaryEntry[];
+/**
+ * Get latest summary for a task
+ */
+export declare function getLatestTaskSummary(directory: string, taskId: string): MetaSummaryEntry | undefined;

package/dist/parallel/review-router.d.ts

@@ -0,0 +1,29 @@
+export type ReviewDepth = 'single' | 'double';
+export interface ReviewRouting {
+    reviewerCount: number;
+    testEngineerCount: number;
+    depth: ReviewDepth;
+    reason: string;
+}
+export interface ComplexityMetrics {
+    fileCount: number;
+    functionCount: number;
+    astChangeCount: number;
+    maxFileComplexity: number;
+}
+/**
+ * Compute complexity metrics for a set of files
+ */
+export declare function computeComplexity(directory: string, changedFiles: string[]): Promise<ComplexityMetrics>;
+/**
+ * Determine review routing based on complexity
+ */
+export declare function routeReview(metrics: ComplexityMetrics): ReviewRouting;
+/**
+ * Route review with full analysis
+ */
+export declare function routeReviewForChanges(directory: string, changedFiles: string[]): Promise<ReviewRouting>;
+/**
+ * Check if review should be parallelized
+ */
+export declare function shouldParallelizeReview(routing: ReviewRouting): boolean;

package/dist/skills/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Skill definition with versioning and per-agent overlays
+ */
+export interface AgentOverlay {
+    agent: string;
+    prompt?: string;
+    model?: string;
+}
+export interface SkillDefinition {
+    id: string;
+    name: string;
+    description: string;
+    SKILL_VERSION: number;
+    basePrompt?: string;
+    agents?: AgentOverlay[];
+}
+export declare const skills: SkillDefinition[];
+export declare const AGENT_OVERLAYS: Record<string, AgentOverlay[]>;
+/**
+ * Get skill by ID
+ */
+export declare function getSkill(id: string): SkillDefinition | undefined;
+/**
+ * Get agent overlay for a skill
+ */
+export declare function getAgentOverlay(skillId: string, agent: string): AgentOverlay | undefined;
+/**
+ * Resolve effective prompt for an agent on a skill
+ */
+export declare function resolveAgentPrompt(skillId: string, agent: string, defaultPrompt: string): string;

package/dist/types/delegation.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Delegation Envelope Types
+ * Interface for passing delegated tasks between agents
+ */
+export interface DelegationEnvelope {
+    taskId: string;
+    targetAgent: string;
+    action: string;
+    commandType: 'task' | 'slash_command';
+    files: string[];
+    acceptanceCriteria: string[];
+    technicalContext: string;
+    errorStrategy?: 'FAIL_FAST' | 'BEST_EFFORT';
+    platformNotes?: string;
+}
+/**
+ * Validation result types
+ */
+export type EnvelopeValidationResult = {
+    valid: true;
+} | {
+    valid: false;
+    reason: string;
+};

package/package.json

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