opencode-swarm 7.46.5 → 7.48.0

package/dist/agents/architect.d.ts

@@ -70,4 +70,4 @@ export declare function buildCouncilWorkflow(council?: CouncilWorkflowConfig): s
  * BRAINSTORM, and PLAN inline paths stay in lockstep.
  */
 export declare function buildQaGateSelectionDialogue(modeLabel: 'BRAINSTORM' | 'SPECIFY' | 'PLAN'): string;
-export declare function createArchitectAgent(model: string, customPrompt?: string, customAppendPrompt?: string, adversarialTesting?: AdversarialTestingConfig, council?: CouncilWorkflowConfig, uiReview?: UIReviewConfig, memoryEnabled?: boolean, architecturalSupervision?: ArchitectureSupervisionWorkflowConfig): AgentDefinition;
+export declare function createArchitectAgent(model: string, customPrompt?: string, customAppendPrompt?: string, adversarialTesting?: AdversarialTestingConfig, council?: CouncilWorkflowConfig, uiReview?: UIReviewConfig, memoryEnabled?: boolean, architecturalSupervision?: ArchitectureSupervisionWorkflowConfig, designDocsEnabled?: boolean): AgentDefinition;

package/dist/agents/docs.d.ts

@@ -1,2 +1,11 @@
 import type { AgentDefinition } from './architect';
-export declare function createDocsAgent(model: string, customPrompt?: string, customAppendPrompt?: string): AgentDefinition;
+/**
+ * Role discriminator for the docs agent. Mirrors the critic agent's `CriticRole`
+ * pattern: a single factory + a role-keyed prompt/name table produces multiple
+ * registered variants that share one base.
+ * - `standard`   — the README/CHANGELOG/API-doc synthesizer (default).
+ * - `design_docs` — the structured design-doc author (issue #1080): generates
+ *   the language-agnostic domain/technical-spec/behavior-spec docs + reference/.
+ */
+export type DocsRole = 'standard' | 'design_docs';
+export declare function createDocsAgent(model: string, customPrompt?: string, customAppendPrompt?: string, role?: DocsRole): AgentDefinition;

package/dist/background/event-bus.d.ts

@@ -5,7 +5,7 @@
  * Events flow through the system without external dependencies.
  */
 /** Automation event types */
-export type AutomationEventType = 'queue.item.enqueued' | 'queue.item.dequeued' | 'queue.item.completed' | 'queue.item.failed' | 'queue.item.retry scheduled' | 'worker.started' | 'worker.stopped' | 'worker.error' | 'circuit.breaker.opened' | 'circuit.breaker.half-open' | 'circuit.breaker.closed' | 'loop.protection.triggered' | 'automation.started' | 'automation.stopped' | 'preflight.requested' | 'preflight.triggered' | 'preflight.skipped' | 'preflight.completed' | 'phase.boundary.detected' | 'phase.status.checked' | 'task.completed' | 'evidence.summary.generated' | 'evidence.summary.error' | 'curator.init.completed' | 'curator.init.llm_completed' | 'curator.init.llm_fallback' | 'curator.phase.completed' | 'curator.phase.llm_completed' | 'curator.phase.llm_fallback' | 'curator.drift.completed' | 'curator.error';
+export type AutomationEventType = 'queue.item.enqueued' | 'queue.item.dequeued' | 'queue.item.completed' | 'queue.item.failed' | 'queue.item.retry scheduled' | 'worker.started' | 'worker.stopped' | 'worker.error' | 'circuit.breaker.opened' | 'circuit.breaker.half-open' | 'circuit.breaker.closed' | 'loop.protection.triggered' | 'automation.started' | 'automation.stopped' | 'preflight.requested' | 'preflight.triggered' | 'preflight.skipped' | 'preflight.completed' | 'phase.boundary.detected' | 'phase.status.checked' | 'task.completed' | 'evidence.summary.generated' | 'evidence.summary.error' | 'curator.init.completed' | 'curator.init.llm_completed' | 'curator.init.llm_fallback' | 'curator.phase.completed' | 'curator.phase.llm_completed' | 'curator.phase.llm_fallback' | 'curator.drift.completed' | 'curator.docdrift.completed' | 'curator.error';
 /** Base automation event */
 export interface AutomationEvent<T = unknown> {
     type: AutomationEventType;

package/dist/cli/index.js

@@ -52,7 +52,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "opencode-swarm",
-    version: "7.46.5",
+    version: "7.48.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",
@@ -16581,6 +16581,7 @@ var init_constants = __esm(() => {
   ALL_SUBAGENT_NAMES = [
     "sme",
     "docs",
+    "docs_design",
     "designer",
     "critic_sounding_board",
     "critic_drift_verifier",
@@ -16846,6 +16847,7 @@ var init_constants = __esm(() => {
       "syntax_check",
       "search",
       "summarize_work",
+      "knowledge_recall",
       "swarm_command"
     ],
     sme: [
@@ -16971,6 +16973,19 @@ var init_constants = __esm(() => {
       "summarize_work",
       "swarm_command"
     ],
+    docs_design: [
+      "detect_domains",
+      "extract_code_blocks",
+      "imports",
+      "retrieve_summary",
+      "search",
+      "symbols",
+      "doc_scan",
+      "doc_extract",
+      "knowledge_recall",
+      "summarize_work",
+      "swarm_command"
+    ],
     designer: [
       "extract_code_blocks",
       "retrieve_summary",
@@ -17130,6 +17145,10 @@ var init_constants = __esm(() => {
       model: "opencode/big-pickle",
       fallback_models: ["opencode/gpt-5-nano", "opencode/big-pickle"]
     },
+    docs_design: {
+      model: "opencode/big-pickle",
+      fallback_models: ["opencode/gpt-5-nano", "opencode/big-pickle"]
+    },
     designer: {
       model: "opencode/big-pickle",
       fallback_models: ["opencode/gpt-5-nano", "opencode/big-pickle"]
@@ -17202,7 +17221,7 @@ function getCanonicalAgentRole(agentName, generatedAgentNames) {
 function stripKnownSwarmPrefix(agentName) {
   return getCanonicalAgentRole(agentName);
 }
-var SEPARATORS, CANONICAL_ROLES_LONGEST_FIRST, CANONICAL_ROLES_SET, AgentOverrideConfigSchema, SwarmConfigSchema, HooksConfigSchema, ScoringWeightsSchema, DecisionDecaySchema, TokenRatiosSchema, ScoringConfigSchema, ContextBudgetConfigSchema, EvidenceConfigSchema, GateFeatureSchema, PlaceholderScanConfigSchema, QualityBudgetConfigSchema, GateConfigSchema, PipelineConfigSchema, PhaseCompleteConfigSchema, SummaryConfigSchema, ReviewPassesConfigSchema, AdversarialDetectionConfigSchema, AdversarialTestingConfigSchemaBase, AdversarialTestingConfigSchema, IntegrationAnalysisConfigSchema, DocsConfigSchema, UIReviewConfigSchema, CompactionAdvisoryConfigSchema, LintConfigSchema, SecretscanConfigSchema, GuardrailsProfileSchema, DEFAULT_AGENT_PROFILES, DEFAULT_ARCHITECT_PROFILE, GuardrailsConfigSchema, WatchdogConfigSchema, SelfReviewConfigSchema, ToolFilterConfigSchema, PlanCursorConfigSchema, CheckpointConfigSchema, AutomationModeSchema, AutomationCapabilitiesSchema, AutomationConfigSchemaBase, AutomationConfigSchema, KnowledgeConfigSchema, MemoryConfigSchema, CuratorConfigSchema, ArchitecturalSupervisionConfigSchema, KnowledgeApplicationConfigSchema, SkillImproverConfigSchema, SpecWriterConfigSchema, SlopDetectorConfigSchema, IncrementalVerifyConfigSchema, CompactionConfigSchema, PrmConfigSchema, AgentAuthorityRuleSchema, AuthorityConfigSchema, GeneralCouncilMemberConfigSchema, GeneralCouncilConfigSchema, CouncilConfigSchema, ParallelizationConfigSchema, LeanTurboConfigSchema, StandardTurboConfigSchema, LeanTurboStrategyConfigSchema, TurboConfigSchema, PluginConfigSchema;
+var SEPARATORS, CANONICAL_ROLES_LONGEST_FIRST, CANONICAL_ROLES_SET, AgentOverrideConfigSchema, SwarmConfigSchema, HooksConfigSchema, ScoringWeightsSchema, DecisionDecaySchema, TokenRatiosSchema, ScoringConfigSchema, ContextBudgetConfigSchema, EvidenceConfigSchema, GateFeatureSchema, PlaceholderScanConfigSchema, QualityBudgetConfigSchema, GateConfigSchema, PipelineConfigSchema, PhaseCompleteConfigSchema, SummaryConfigSchema, ReviewPassesConfigSchema, AdversarialDetectionConfigSchema, AdversarialTestingConfigSchemaBase, AdversarialTestingConfigSchema, IntegrationAnalysisConfigSchema, DocsConfigSchema, DesignDocsConfigSchema, UIReviewConfigSchema, CompactionAdvisoryConfigSchema, LintConfigSchema, SecretscanConfigSchema, GuardrailsProfileSchema, DEFAULT_AGENT_PROFILES, DEFAULT_ARCHITECT_PROFILE, GuardrailsConfigSchema, WatchdogConfigSchema, SelfReviewConfigSchema, ToolFilterConfigSchema, PlanCursorConfigSchema, CheckpointConfigSchema, AutomationModeSchema, AutomationCapabilitiesSchema, AutomationConfigSchemaBase, AutomationConfigSchema, KnowledgeConfigSchema, MemoryConfigSchema, CuratorConfigSchema, ArchitecturalSupervisionConfigSchema, KnowledgeApplicationConfigSchema, SkillImproverConfigSchema, SpecWriterConfigSchema, SlopDetectorConfigSchema, IncrementalVerifyConfigSchema, CompactionConfigSchema, PrmConfigSchema, AgentAuthorityRuleSchema, AuthorityConfigSchema, GeneralCouncilMemberConfigSchema, GeneralCouncilConfigSchema, CouncilConfigSchema, ParallelizationConfigSchema, LeanTurboConfigSchema, StandardTurboConfigSchema, LeanTurboStrategyConfigSchema, TurboConfigSchema, PluginConfigSchema;
 var init_schema = __esm(() => {
   init_zod();
   init_constants();
@@ -17400,6 +17419,13 @@ var init_schema = __esm(() => {
       "**/CHANGELOG.md"
     ])
   });
+  DesignDocsConfigSchema = exports_external.object({
+    enabled: exports_external.boolean().default(false),
+    out_dir: exports_external.string().default("docs").refine((v) => v.length > 0 && v !== "." && !v.includes("..") && !v.startsWith("/") && !v.startsWith("\\") && !/^[A-Za-z]:/.test(v), {
+      message: 'design_docs.out_dir must be a non-empty project-relative path with no "..", leading slash, or drive letter'
+    }),
+    language: exports_external.string().optional()
+  });
   UIReviewConfigSchema = exports_external.object({
     enabled: exports_external.boolean().default(false),
     trigger_paths: exports_external.array(exports_external.string()).default([
@@ -17923,6 +17949,7 @@ var init_schema = __esm(() => {
     adversarial_testing: AdversarialTestingConfigSchema.optional(),
     integration_analysis: IntegrationAnalysisConfigSchema.optional(),
     docs: DocsConfigSchema.optional(),
+    design_docs: DesignDocsConfigSchema.optional(),
     ui_review: UIReviewConfigSchema.optional(),
     compaction_advisory: CompactionAdvisoryConfigSchema.optional(),
     lint: LintConfigSchema.optional(),
@@ -21341,6 +21368,9 @@ ${HARD_RULES}
 var init_critic = () => {};
 // src/agents/curator-agent.ts
 var init_curator_agent = () => {};
+// src/agents/docs.ts
+var init_docs = () => {};
+
 // src/agents/reviewer.ts
 var init_reviewer = () => {};
 // src/agents/index.ts
@@ -21354,11 +21384,13 @@ var init_agents2 = __esm(() => {
   init_council_prompts();
   init_critic();
   init_curator_agent();
+  init_docs();
   init_reviewer();
   init_architect();
   init_council_prompts();
   init_critic();
   init_curator_agent();
+  init_docs();
   init_reviewer();
   warnedAgents = new Set;
   KNOWN_VARIANT_VALUES = new Set([
@@ -40234,6 +40266,122 @@ var init_deep_dive = __esm(() => {
   ]);
 });
 
+// src/commands/design-docs.ts
+function sanitizeDescription(raw) {
+  const collapsed = raw.replace(/\s+/g, " ").trim();
+  const stripped1 = collapsed.replace(/\[\s*MODE\s*:[^\]]*\]/gi, "");
+  const stripped2 = stripped1.replace(/\[\s*MODE\s*:.*$/gi, "");
+  const normalized = stripped2.replace(/\s+/g, " ").trim();
+  if (normalized.length <= MAX_DESC_LEN)
+    return normalized;
+  return `${normalized.slice(0, MAX_DESC_LEN)}\u2026`;
+}
+function cleanFlagValue(raw) {
+  if (raw.includes("[") || raw.includes("]") || /\s/.test(raw))
+    return null;
+  if (/\[\s*MODE\s*:/i.test(raw))
+    return null;
+  return raw;
+}
+function parseArgs3(args) {
+  const result = {
+    out: "docs",
+    lang: "auto",
+    update: false,
+    rest: []
+  };
+  let i = 0;
+  while (i < args.length) {
+    const token = args[i];
+    if (token === "--out") {
+      if (i + 1 >= args.length || args[i + 1].startsWith("--")) {
+        return { ...result, error: `Flag "${token}" requires a value` };
+      }
+      const value = args[++i];
+      const clean = cleanFlagValue(value);
+      if (clean === null || value.includes("..") || value.startsWith("/") || value.startsWith("\\") || /^[A-Za-z]:/.test(value)) {
+        return {
+          ...result,
+          error: `Invalid --out value "${value}". Must be a project-relative directory with no brackets or spaces.`
+        };
+      }
+      const trimmed = clean.replace(/[/\\]+$/, "");
+      if (!trimmed || trimmed === ".") {
+        return {
+          ...result,
+          error: `Invalid --out value "${value}". Must name a non-empty subdirectory.`
+        };
+      }
+      result.out = trimmed;
+    } else if (token === "--lang") {
+      if (i + 1 >= args.length || args[i + 1].startsWith("--")) {
+        return { ...result, error: `Flag "${token}" requires a value` };
+      }
+      const value = args[++i];
+      const clean = cleanFlagValue(value);
+      if (clean === null) {
+        return {
+          ...result,
+          error: `Invalid --lang value "${value}". Must be a single token with no brackets or spaces.`
+        };
+      }
+      result.lang = clean;
+    } else if (token === "--update") {
+      result.update = true;
+    } else if (token.startsWith("--")) {
+      return { ...result, error: `Unknown flag "${token}"` };
+    } else {
+      result.rest.push(token);
+    }
+    i++;
+  }
+  return result;
+}
+async function handleDesignDocsCommand(directory, args) {
+  const parsed = parseArgs3(args);
+  if (parsed.error) {
+    return `Error: ${parsed.error}
+
+${USAGE3}`;
+  }
+  try {
+    const { config: config3 } = loadPluginConfigWithMeta(directory);
+    if (config3.design_docs?.enabled !== true) {
+      return "Error: design docs are disabled. Set `design_docs.enabled: true` in " + `opencode-swarm.json to enable the docs_design agent and this command.
+
+` + USAGE3;
+    }
+  } catch (configErr) {
+    console.warn(`[design-docs] Could not read opencode-swarm.json (${String(configErr)}). ` + "Falling through \u2014 the architect will abort if docs_design is not registered.");
+  }
+  const description = sanitizeDescription(parsed.rest.join(" "));
+  if (!description && !parsed.update) {
+    return USAGE3;
+  }
+  const header = `[MODE: DESIGN_DOCS out=${parsed.out} lang=${parsed.lang} update=${parsed.update}] ${description}`;
+  return header.trimEnd();
+}
+var MAX_DESC_LEN = 2000, USAGE3 = `Usage: /swarm design-docs <description> [--out <dir>] [--lang <name>] [--update]
+
+Generate or sync language-agnostic design docs for the project under build:
+  <out>/domain.md, <out>/technical-spec.md, <out>/behavior-spec.md,
+  <out>/reference/{reference-impl,idiom-notes}.md, <out>/reference/traceability.json
+
+Requires design_docs.enabled: true in opencode-swarm.json.
+
+Examples:
+  /swarm design-docs "terminal GitHub PR client"
+  /swarm design-docs auth-service --lang rust
+  /swarm design docs --update --out design
+
+Flags:
+  --out <dir>     output directory (default "docs")
+  --lang <name>   target language for the reference/ docs (default: inferred)
+  --update        sync existing docs to current code/spec instead of generating fresh`;
+var init_design_docs = __esm(() => {
+  init_config();
+});
+
 // src/config/cache-paths.ts
 import * as os5 from "os";
 import * as path23 from "path";
@@ -45621,7 +45769,7 @@ function validateAndSanitizeUrl(rawUrl) {
     return { error: "Invalid URL format" };
   }
 }
-function parseArgs3(args) {
+function parseArgs4(args) {
   const out = {
     plan: false,
     trace: false,
@@ -45712,24 +45860,24 @@ function parseGitRemoteUrl(remoteUrl) {
   return null;
 }
 function handleIssueCommand(_directory, args) {
-  const parsed = parseArgs3(args);
+  const parsed = parseArgs4(args);
   const rawInput = parsed.rest.join(" ").trim();
   if (!rawInput) {
-    return USAGE3;
+    return USAGE4;
   }
   const isFullUrl = /^https?:\/\//i.test(rawInput);
   const issueInfo = parseIssueRef(isFullUrl ? sanitizeUrl(rawInput) : rawInput);
   if (!issueInfo) {
     return `Error: Could not parse issue reference from "${rawInput}"
 
-${USAGE3}`;
+${USAGE4}`;
   }
   const issueUrl = `https://github.com/${issueInfo.owner}/${issueInfo.repo}/issues/${issueInfo.number}`;
   const result = validateAndSanitizeUrl(issueUrl);
   if ("error" in result) {
     return `Error: ${result.error}
 
-${USAGE3}`;
+${USAGE4}`;
   }
   const flags = [];
   if (parsed.plan)
@@ -45741,9 +45889,9 @@ ${USAGE3}`;
   const flagsStr = flags.length > 0 ? ` ${flags.join(" ")}` : "";
   return `[MODE: ISSUE_INGEST issue="${result.sanitized}"${flagsStr}]`;
 }
-var MAX_URL_LEN = 2048, USAGE3;
+var MAX_URL_LEN = 2048, USAGE4;
 var init_issue = __esm(() => {
-  USAGE3 = [
+  USAGE4 = [
     "Usage: /swarm issue <url|owner/repo#N|N> [--plan] [--trace] [--no-repro]",
     "",
     "Ingest a GitHub issue into the swarm workflow.",
@@ -49699,7 +49847,7 @@ function validateAndSanitizeUrl2(rawUrl) {
     return { error: "Invalid URL format" };
   }
 }
-function parseArgs4(args) {
+function parseArgs5(args) {
   const out = { council: false, rest: [] };
   for (const token of args) {
     if (token === "--council") {
@@ -49783,31 +49931,31 @@ function parseGitRemoteUrl2(remoteUrl) {
   return null;
 }
 function handlePrReviewCommand(_directory, args) {
-  const parsed = parseArgs4(args);
+  const parsed = parseArgs5(args);
   const rawInput = parsed.rest.join(" ").trim();
   if (!rawInput) {
-    return USAGE4;
+    return USAGE5;
   }
   const isFullUrl = /^https?:\/\//i.test(rawInput);
   const prInfo = parsePrRef(isFullUrl ? sanitizeUrl2(rawInput) : rawInput);
   if (!prInfo) {
     return `Error: Could not parse PR reference from "${rawInput}"
 
-${USAGE4}`;
+${USAGE5}`;
   }
   const prUrl = `https://github.com/${prInfo.owner}/${prInfo.repo}/pull/${prInfo.number}`;
   const result = validateAndSanitizeUrl2(prUrl);
   if ("error" in result) {
     return `Error: ${result.error}
 
-${USAGE4}`;
+${USAGE5}`;
   }
   const councilFlag = parsed.council ? "council=true" : "council=false";
   return `[MODE: PR_REVIEW pr="${result.sanitized}" ${councilFlag}]`;
 }
-var MAX_URL_LEN2 = 2048, USAGE4;
+var MAX_URL_LEN2 = 2048, USAGE5;
 var init_pr_review = __esm(() => {
-  USAGE4 = [
+  USAGE5 = [
     "Usage: /swarm pr-review <url|owner/repo#N|N> [--council]",
     "",
     "Run a full swarm PR review on a GitHub pull request.",
@@ -57642,17 +57790,13 @@ var init_tool_policy = __esm(() => {
     "agents",
     "config",
     "config doctor",
-    "config-doctor",
-    "doctor",
     "doctor tools",
     "status",
     "show-plan",
-    "plan",
     "help",
     "history",
     "evidence",
     "evidence summary",
-    "evidence-summary",
     "retrieve",
     "diagnose",
     "preflight",
@@ -57669,8 +57813,7 @@ var init_tool_policy = __esm(() => {
     "memory import",
     "memory migrate",
     "sync-plan",
-    "export",
-    "list-agents"
+    "export"
   ];
   SWARM_COMMAND_TOOL_ALLOWLIST = new Set([
     "agents",
@@ -58252,6 +58395,7 @@ var init_registry = __esm(() => {
   init_curate();
   init_dark_matter();
   init_deep_dive();
+  init_design_docs();
   init_diagnose();
   init_doctor();
   init_evidence();
@@ -58567,6 +58711,20 @@ Subcommands:
       category: "agent",
       aliasOf: "deep-dive"
     },
+    "design-docs": {
+      handler: async (ctx) => handleDesignDocsCommand(ctx.directory, ctx.args),
+      description: "Generate or sync language-agnostic design docs (domain, technical-spec, behavior-spec, reference/) for the project under build [description]",
+      args: "<description> [--out <dir>] [--lang <name>] [--update]",
+      details: "Triggers the architect to enter MODE: DESIGN_DOCS \u2014 delegates to the docs_design agent to author/sync docs/domain.md, docs/technical-spec.md, docs/behavior-spec.md, and docs/reference/* (plus reference/traceability.json and design-changelog.md). Normative docs are 100% language-agnostic; all framework-specific material is quarantined under reference/. --update syncs existing docs to current code/spec instead of generating fresh. Requires design_docs.enabled: true.",
+      category: "agent"
+    },
+    "design docs": {
+      handler: async (ctx) => handleDesignDocsCommand(ctx.directory, ctx.args),
+      description: "Alias for /swarm design-docs \u2014 generate or sync design docs",
+      args: "<description> [--out <dir>] [--lang <name>] [--update]",
+      category: "agent",
+      aliasOf: "design-docs"
+    },
     issue: {
       handler: async (ctx) => handleIssueCommand(ctx.directory, ctx.args),
       description: "Ingest a GitHub issue into the swarm workflow [url] [--plan] [--trace] [--no-repro]",

package/dist/commands/design-docs.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Handle /swarm design-docs command (issue #1080).
+ * Sanitizes the description, parses flags, and emits a DESIGN_DOCS mode signal
+ * that routes the architect into the design-doc generation/sync workflow.
+ */
+export declare function handleDesignDocsCommand(directory: string, args: string[]): Promise<string>;

package/dist/commands/registry.d.ts

@@ -322,6 +322,20 @@ export declare const COMMAND_REGISTRY: {
         readonly category: "agent";
         readonly aliasOf: "deep-dive";
     };
+    readonly 'design-docs': {
+        readonly handler: (ctx: CommandContext) => Promise<string>;
+        readonly description: "Generate or sync language-agnostic design docs (domain, technical-spec, behavior-spec, reference/) for the project under build [description]";
+        readonly args: "<description> [--out <dir>] [--lang <name>] [--update]";
+        readonly details: "Triggers the architect to enter MODE: DESIGN_DOCS — delegates to the docs_design agent to author/sync docs/domain.md, docs/technical-spec.md, docs/behavior-spec.md, and docs/reference/* (plus reference/traceability.json and design-changelog.md). Normative docs are 100% language-agnostic; all framework-specific material is quarantined under reference/. --update syncs existing docs to current code/spec instead of generating fresh. Requires design_docs.enabled: true.";
+        readonly category: "agent";
+    };
+    readonly 'design docs': {
+        readonly handler: (ctx: CommandContext) => Promise<string>;
+        readonly description: "Alias for /swarm design-docs — generate or sync design docs";
+        readonly args: "<description> [--out <dir>] [--lang <name>] [--update]";
+        readonly category: "agent";
+        readonly aliasOf: "design-docs";
+    };
     readonly issue: {
         readonly handler: (ctx: CommandContext) => Promise<string>;
         readonly description: "Ingest a GitHub issue into the swarm workflow [url] [--plan] [--trace] [--no-repro]";

package/dist/commands/tool-policy.d.ts

@@ -1,5 +1,5 @@
 import type { ResolvedSwarmCommand, SwarmCommandPolicyResult } from './command-dispatch.js';
-export declare const SWARM_COMMAND_TOOL_COMMANDS: readonly ["agents", "config", "config doctor", "config-doctor", "doctor", "doctor tools", "status", "show-plan", "plan", "help", "history", "evidence", "evidence summary", "evidence-summary", "retrieve", "diagnose", "preflight", "benchmark", "knowledge", "memory", "memory status", "memory pending", "memory recall-log", "memory compact", "memory stale", "memory export", "memory evaluate", "memory import", "memory migrate", "sync-plan", "export", "list-agents"];
+export declare const SWARM_COMMAND_TOOL_COMMANDS: readonly ["agents", "config", "config doctor", "doctor tools", "status", "show-plan", "help", "history", "evidence", "evidence summary", "retrieve", "diagnose", "preflight", "benchmark", "knowledge", "memory", "memory status", "memory pending", "memory recall-log", "memory compact", "memory stale", "memory export", "memory evaluate", "memory import", "memory migrate", "sync-plan", "export"];
 export type SwarmCommandToolInputCommand = (typeof SWARM_COMMAND_TOOL_COMMANDS)[number];
 export declare const SWARM_COMMAND_TOOL_ALLOWLIST: Set<string>;
 /**

package/dist/config/constants.d.ts

@@ -2,8 +2,8 @@ import type { ToolName } from '../tools/tool-names';
 export declare const QA_AGENTS: readonly ["reviewer", "critic", "critic_oversight"];
 export declare const PIPELINE_AGENTS: readonly ["explorer", "coder", "test_engineer"];
 export declare const ORCHESTRATOR_NAME: "architect";
-export declare const ALL_SUBAGENT_NAMES: readonly ["sme", "docs", "designer", "critic_sounding_board", "critic_drift_verifier", "critic_hallucination_verifier", "critic_architecture_supervisor", "curator_init", "curator_phase", "council_generalist", "council_skeptic", "council_domain_expert", "skill_improver", "spec_writer", "reviewer", "critic", "critic_oversight", "explorer", "coder", "test_engineer"];
-export declare const ALL_AGENT_NAMES: readonly ["architect", "sme", "docs", "designer", "critic_sounding_board", "critic_drift_verifier", "critic_hallucination_verifier", "critic_architecture_supervisor", "curator_init", "curator_phase", "council_generalist", "council_skeptic", "council_domain_expert", "skill_improver", "spec_writer", "reviewer", "critic", "critic_oversight", "explorer", "coder", "test_engineer"];
+export declare const ALL_SUBAGENT_NAMES: readonly ["sme", "docs", "docs_design", "designer", "critic_sounding_board", "critic_drift_verifier", "critic_hallucination_verifier", "critic_architecture_supervisor", "curator_init", "curator_phase", "council_generalist", "council_skeptic", "council_domain_expert", "skill_improver", "spec_writer", "reviewer", "critic", "critic_oversight", "explorer", "coder", "test_engineer"];
+export declare const ALL_AGENT_NAMES: readonly ["architect", "sme", "docs", "docs_design", "designer", "critic_sounding_board", "critic_drift_verifier", "critic_hallucination_verifier", "critic_architecture_supervisor", "curator_init", "curator_phase", "council_generalist", "council_skeptic", "council_domain_expert", "skill_improver", "spec_writer", "reviewer", "critic", "critic_oversight", "explorer", "coder", "test_engineer"];
 export declare const OPENCODE_NATIVE_AGENTS: Set<"compaction" | "title" | "build" | "general" | "plan" | "explore" | "summary">;
 export declare const CLAUDE_CODE_NATIVE_COMMANDS: ReadonlySet<string>;
 export type QAAgentName = (typeof QA_AGENTS)[number];

package/dist/config/schema.d.ts

@@ -308,6 +308,12 @@ export declare const DocsConfigSchema: z.ZodObject<{
     doc_patterns: z.ZodDefault<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 export type DocsConfig = z.infer<typeof DocsConfigSchema>;
+export declare const DesignDocsConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    out_dir: z.ZodDefault<z.ZodString>;
+    language: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type DesignDocsConfig = z.infer<typeof DesignDocsConfigSchema>;
 export declare const UIReviewConfigSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
     trigger_paths: z.ZodDefault<z.ZodArray<z.ZodString>>;
@@ -1110,6 +1116,11 @@ export declare const PluginConfigSchema: z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         doc_patterns: z.ZodDefault<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>>;
+    design_docs: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        out_dir: z.ZodDefault<z.ZodString>;
+        language: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
     ui_review: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         trigger_paths: z.ZodDefault<z.ZodArray<z.ZodString>>;

package/dist/hooks/curator-types.d.ts

@@ -71,6 +71,31 @@ export interface DriftReport {
     /** Truncated summary for architect context injection */
     injection_summary: string;
 }
+/**
+ * Design-doc drift report (issue #1080) — produced by the deterministic
+ * design-doc drift check at phase wrap. Compares the generated design docs
+ * (domain/technical-spec/behavior-spec/reference) against code/spec mtimes via
+ * the traceability registry. Advisory only — never blocks phase completion.
+ */
+export interface DocDriftReport {
+    schema_version: 1;
+    phase: number;
+    timestamp: string;
+    /** Output directory the docs were checked under (project-relative). */
+    out_dir: string;
+    /** Overall verdict for the phase. */
+    verdict: 'DOC_FRESH' | 'DOC_STALE' | 'NO_DOCS';
+    /** Sections whose owning doc is older than a mapped code anchor or the spec. */
+    stale_sections: Array<{
+        section_id: string;
+        doc: string;
+        reason: string;
+    }>;
+    /** Expected design docs that are missing from out_dir. */
+    missing_docs: string[];
+    /** Design docs that were found and checked. */
+    checked_docs: string[];
+}
 export interface CuratorConfig {
     enabled: boolean;
     init_enabled: boolean;

package/dist/hooks/design-doc-drift.d.ts

@@ -0,0 +1,24 @@
+import type { DocDriftReport } from './curator-types.js';
+/** Return mtime in ms for a path, or null if it does not exist / cannot stat. */
+declare function mtimeMsOrNull(absPath: string): number | null;
+/**
+ * Resolve a project-relative anchor path safely under `directory`. Returns null
+ * if the anchor escapes the project root (defense against `..`/absolute paths
+ * in a hand-edited traceability.json).
+ */
+declare function resolveAnchorWithin(directory: string, anchor: string): string | null;
+/**
+ * Run the deterministic design-doc drift check for a phase.
+ *
+ * @param directory  project root
+ * @param phase      phase number
+ * @param outDir     design-doc output directory (project-relative, e.g. "docs")
+ * @returns the written DocDriftReport, or null if the check failed (fail-open).
+ */
+export declare function runDesignDocDriftCheck(directory: string, phase: number, outDir: string): Promise<DocDriftReport | null>;
+export declare const _internals: {
+    mtimeMsOrNull: typeof mtimeMsOrNull;
+    resolveAnchorWithin: typeof resolveAnchorWithin;
+    DESIGN_DOC_FILES: Record<string, string>;
+};
+export {};