@bastani/atomic 0.5.25 → 0.5.26-0

package/dist/sdk/workflows/builtin/open-claude-design/helpers/design-system.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Design.md persistence — loading, saving, and reading design system data.
+ *
+ * The Design.md file is a structured markdown document containing design
+ * tokens (colors, typography, spacing, components) extracted from the
+ * codebase and approved by the user via HIL. It serves as the single
+ * source of truth for all generation and refinement stages.
+ */
+/** Structured representation of the design system data. */
+export interface DesignSystemData {
+    /** Raw markdown content of Design.md. */
+    raw: string;
+    /** Absolute path to the Design.md file. */
+    path: string;
+}
+/**
+ * Load an existing Design.md from the given path.
+ * Used when the user provides `--design-system=<path>`.
+ */
+export declare function loadDesignSystem(designSystemPath: string): Promise<DesignSystemData>;
+/**
+ * Persist the design system builder's output as Design.md in the project root.
+ *
+ * The builder stage produces a visible session where the agent constructs
+ * the Design.md content interactively with the user. We read the transcript
+ * and extract the final Design.md content that the agent wrote.
+ *
+ * For simplicity, the agent in the builder stage is instructed to write
+ * Design.md directly to disk. This function reads it back to populate
+ * the DesignSystemData for downstream stages.
+ */
+export declare function persistDesignSystem(root: string): Promise<DesignSystemData>;
+/**
+ * Read the existing .impeccable.md brand context file, if present.
+ * Returns empty string if the file does not exist.
+ */
+export declare function readImpeccableMd(root: string): Promise<string>;
+/**
+ * Derive a URL-safe slug from the user's prompt for directory naming.
+ */
+export declare function slugifyPrompt(prompt: string): string;
+/**
+ * Ensure the scratch directory exists for intermediate workflow outputs.
+ */
+export declare function ensureScratchDir(root: string): Promise<string>;
+//# sourceMappingURL=design-system.d.ts.map

package/dist/sdk/workflows/builtin/open-claude-design/helpers/design-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-system.d.ts","sourceRoot":"","sources":["../../../../../../src/sdk/workflows/builtin/open-claude-design/helpers/design-system.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,2DAA2D;AAC3D,MAAM,WAAW,gBAAgB;IAC/B,yCAAyC;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,gBAAgB,CAAC,CAI3B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,gBAAgB,CAAC,CAI3B;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAMpE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAUpD;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAKpE"}

package/dist/sdk/workflows/builtin/open-claude-design/helpers/export.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Export engine — handoff bundle packaging.
+ *
+ * Writes the deterministic parts of the handoff bundle (no LLM call):
+ *   - handoff-prompt.md  — ready-to-use prompt for Claude Code
+ *   - README.md          — how to use the bundle
+ *
+ * The exporter stage (LLM) handles copying design files, writing
+ * design-intent.md and component-specs.md since those require
+ * understanding the generated design content.
+ */
+import type { DesignSystemData } from "./design-system.ts";
+export interface HandoffBundleOptions {
+    designSystem: DesignSystemData;
+    prompt: string;
+    outputType: string;
+}
+/**
+ * Write the deterministic handoff bundle files.
+ *
+ * The exporter stage is responsible for:
+ *   - Copying design files (index.html, styles.css, script.js) to design/
+ *   - Writing design-intent.md from transcript analysis
+ *   - Writing component-specs.md from design analysis
+ *
+ * This function writes the remaining deterministic files:
+ *   - Design.md (copy of the design system)
+ *   - handoff-prompt.md (ready-to-use implementation prompt)
+ *   - README.md (bundle documentation)
+ */
+export declare function writeHandoffBundle(finalDesignDir: string, opts: HandoffBundleOptions): Promise<void>;
+//# sourceMappingURL=export.d.ts.map

package/dist/sdk/workflows/builtin/open-claude-design/helpers/export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../../../../../src/sdk/workflows/builtin/open-claude-design/helpers/export.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,gBAAgB,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,kBAAkB,CACtC,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,IAAI,CAAC,CAyBf"}

package/dist/sdk/workflows/builtin/open-claude-design/helpers/import.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Import handler — input type detection and aggregation.
+ *
+ * Classifies the user's `--reference` input as a URL, file path, or
+ * neither, and aggregates all import sources into a structured context
+ * object that the generator consumes.
+ */
+/** Aggregated import context passed to the generator stage. */
+export interface ImportContext {
+    /** The user's free-form design prompt. */
+    prompt: string;
+    /** Raw reference string (URL, file path, or empty). */
+    reference: string;
+    /** Extracted content from a web URL capture, or null. */
+    webCapture: string | null;
+    /** Extracted content from a parsed file, or null. */
+    fileParse: string | null;
+}
+/** Check whether the reference string looks like a URL. */
+export declare function isUrl(reference: string): boolean;
+/** Check whether the reference string looks like a file path. */
+export declare function isFilePath(reference: string): boolean;
+/**
+ * Aggregate all import results into a single context object.
+ * Pure deterministic function — no LLM call.
+ */
+export declare function aggregateImportResults(opts: {
+    prompt: string;
+    reference: string;
+    webCapture: string | null;
+    fileParse: string | null;
+}): ImportContext;
+//# sourceMappingURL=import.d.ts.map

package/dist/sdk/workflows/builtin/open-claude-design/helpers/import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import.d.ts","sourceRoot":"","sources":["../../../../../../src/sdk/workflows/builtin/open-claude-design/helpers/import.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,+DAA+D;AAC/D,MAAM,WAAW,aAAa;IAC5B,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,qDAAqD;IACrD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,2DAA2D;AAC3D,wBAAgB,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAGhD;AAED,iEAAiE;AACjE,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAMrD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,GAAG,aAAa,CAOhB"}

package/dist/sdk/workflows/builtin/open-claude-design/helpers/prompts.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Prompt builders for the open-claude-design workflow.
+ *
+ * Each builder produces a focused, single-responsibility prompt for one
+ * stage of the 5-phase design pipeline. Context-engineering principles:
+ *
+ *   - Position-aware framing: key context (design prompt, design system)
+ *     at the TOP and BOTTOM of every prompt.
+ *   - Forward-only data flow: downstream stages embed upstream outputs
+ *     verbatim — no re-discovery.
+ *   - Trailing-prose guarantee: every prompt asks for a short prose recap
+ *     so transcript reads never return empty.
+ *   - HIL via AskUserQuestion: explicit instructions to use the tool,
+ *     never regular NL conversation, for user decisions.
+ */
+import type { ImportContext } from "./import.ts";
+import type { DesignSystemData } from "./design-system.ts";
+/** Phase 1 — headless: find CSS/Tailwind/design files in codebase. */
+export declare function buildDesignLocatorPrompt(opts: {
+    root: string;
+}): string;
+/** Phase 1 — headless: extract colors, fonts, spacing from located files. */
+export declare function buildDesignAnalyzerPrompt(opts: {
+    root: string;
+}): string;
+/** Phase 1 — headless: find existing component patterns in the codebase. */
+export declare function buildDesignPatternPrompt(opts: {
+    root: string;
+}): string;
+/**
+ * Phase 1 — visible, HIL: present findings and build Design.md with
+ * user approval at each decision point.
+ */
+export declare function buildDesignSystemBuilderPrompt(opts: {
+    root: string;
+    locatorOutput: string;
+    analyzerOutput: string;
+    patternsOutput: string;
+    existingImpeccable: string;
+}): string;
+/** Phase 2 — headless: navigate URL, screenshot, extract DOM/CSS. */
+export declare function buildWebCapturePrompt(opts: {
+    url: string;
+    screenshotDir: string;
+}): string;
+/** Phase 2 — headless: parse document reference (DOCX/PPTX/XLSX/image/PDF). */
+export declare function buildFileParserPrompt(opts: {
+    filePath: string;
+}): string;
+/** Phase 3 — visible: generate first design version. */
+export declare function buildGeneratorPrompt(opts: {
+    prompt: string;
+    outputType: string;
+    designSystem: DesignSystemData;
+    importContext: ImportContext;
+    root: string;
+    outputDir: string;
+}): string;
+/** Phase 4 — visible, HIL: collect user feedback on the current design. */
+export declare function buildRefineFeedbackPrompt(opts: {
+    prompt: string;
+    designDir: string;
+    iteration: number;
+    maxIterations: number;
+}): string;
+/** Phase 4 — headless: automated design critique with structured output. */
+export declare function buildCritiquePrompt(opts: {
+    designDir: string;
+    designSystem: DesignSystemData;
+    userFeedback: string;
+}): string;
+/** Phase 4 — headless: visual validation via playwright screenshot. */
+export declare function buildScreenshotValidationPrompt(opts: {
+    designDir: string;
+    scratchDir: string;
+}): string;
+/** Phase 4 — visible: apply feedback + critique findings to the design. */
+export declare function buildApplyChangesPrompt(opts: {
+    prompt: string;
+    designDir: string;
+    designSystem: DesignSystemData;
+    userFeedback: string;
+    critiqueOutput: string;
+    screenshotOutput: string;
+    scanFindings: string;
+    iteration: number;
+}): string;
+/**
+ * Phase 4 — visible: final deterministic gate. Runs when the post-loop
+ * scanner still reports findings. The agent MUST remove every one before
+ * export; no ambiguity, no negotiation, no new features.
+ */
+export declare function buildForcedFixPrompt(opts: {
+    designDir: string;
+    designSystem: DesignSystemData;
+    scanFindings: string;
+}): string;
+/** Phase 5 — visible: export design and create output-type-tailored assets. */
+export declare function buildExportPrompt(opts: {
+    prompt: string;
+    designDir: string;
+    finalDesignDir: string;
+    designSystem: DesignSystemData;
+    outputType: string;
+}): string;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/sdk/workflows/builtin/open-claude-design/helpers/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../../../../src/sdk/workflows/builtin/open-claude-design/helpers/prompts.ts"],"names":[],"mappings":"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"}

package/dist/sdk/workflows/builtin/open-claude-design/helpers/scan.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Deterministic impeccable scan — runs the `impeccable detect --json` CLI
+ * against a design directory and returns structured findings.
+ *
+ * No LLM call; the refinement loop surfaces these findings to the
+ * apply-changes stage so the agent can fix banned anti-patterns
+ * alongside user feedback.
+ */
+/** Shape of a single finding emitted by `impeccable detect --json`. */
+export interface ScanFinding {
+    readonly antipattern: string;
+    readonly name: string;
+    readonly description: string;
+    readonly file: string;
+    readonly line: number;
+    readonly snippet: string;
+}
+/**
+ * Result of running the scanner. Discriminated on `available` so callers
+ * can distinguish "ran successfully, no findings" from "scanner missing".
+ */
+export type ScanResult = {
+    readonly available: true;
+    readonly findings: readonly ScanFinding[];
+} | {
+    readonly available: false;
+    readonly reason: string;
+};
+/**
+ * Run `impeccable detect --json` against `designDir`. The CLI exits 0
+ * whether or not findings exist, so we parse the JSON array and return
+ * its length. If the CLI is missing or its output is not parseable,
+ * return `{ available: false, reason }` so the caller can gracefully
+ * proceed without scan input.
+ */
+export declare function runImpeccableScan(designDir: string): Promise<ScanResult>;
+/**
+ * Returns true iff the scanner ran successfully AND reported at least
+ * one finding. Narrows the union so callers can access `findings`.
+ */
+export declare function hasBlockingFindings(scan: ScanResult): scan is {
+    available: true;
+    findings: readonly ScanFinding[];
+};
+/**
+ * Render findings as a human-readable block for inclusion in agent
+ * prompts. Groups by anti-pattern id, lists each file:line with snippet.
+ */
+export declare function renderScanFindings(findings: readonly ScanFinding[]): string;
+//# sourceMappingURL=scan.d.ts.map

package/dist/sdk/workflows/builtin/open-claude-design/helpers/scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.d.ts","sourceRoot":"","sources":["../../../../../../src/sdk/workflows/builtin/open-claude-design/helpers/scan.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,uEAAuE;AACvE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,GAClB;IAAE,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAA;CAAE,GACvE;IAAE,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3D;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,UAAU,CAAC,CAuCrB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,UAAU,GACf,IAAI,IAAI;IAAE,SAAS,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAA;CAAE,CAE/D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,SAAS,WAAW,EAAE,GAC/B,MAAM,CAqBR"}

package/dist/sdk/workflows/builtin/open-claude-design/helpers/validation.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Validation helpers — refinement loop exit detection and critique parsing.
+ */
+/**
+ * Detect whether the user signaled "done" via AskUserQuestion in the
+ * feedback stage. The feedback stage's prompt instructs the agent to
+ * include one of the completion signal phrases when the user approves.
+ *
+ * Returns `true` if the refinement loop should exit.
+ */
+export declare function isRefinementComplete(feedbackResult: string): boolean;
+//# sourceMappingURL=validation.d.ts.map

package/dist/sdk/workflows/builtin/open-claude-design/helpers/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../../../../src/sdk/workflows/builtin/open-claude-design/helpers/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAoBH;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAQpE"}

package/dist/sdk/workflows/builtin/open-claude-design/opencode/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * open-claude-design / opencode
+ *
+ * OpenCode replica of the Claude open-claude-design workflow. Orchestrates
+ * the design skill ecosystem (impeccable, critique, shape, polish, audit,
+ * etc.) into a deterministic 5-phase pipeline:
+ *
+ *   Phase 1: Design System Onboarding — extract tokens, build Design.md (HIL)
+ *   Phase 2: Import — aggregate text/URL/file references
+ *   Phase 3: Generation — produce first design version
+ *   Phase 4: Refinement Loop — bounded iterate with critique + user feedback
+ *   Phase 5: Export/Handoff — HTML export + Claude Code handoff bundle
+ *
+ * OpenCode-specific concerns (see references/failure-modes.md):
+ *
+ *   • F5 — every `ctx.stage()` is a FRESH session. Every specialist receives
+ *     its required context verbatim in its first prompt.
+ *   • F3 — `result.data!.parts` is a heterogenous array (text/tool/reasoning/
+ *     file parts). Use `extractResponseText()` to filter to text parts only;
+ *     concatenating raw `parts` produces `[object Object]` strings.
+ *   • F6 — every prompt explicitly requires trailing prose so transcripts and
+ *     `extractResponseText()` reads are never empty.
+ *   • F9 — `s.save()` receives the unwrapped `{ info, parts }` payload from
+ *     `result.data!`; passing the full `result` breaks downstream reads.
+ *
+ * Sub-agents are dispatched via the `agent` parameter on
+ * `s.client.session.prompt()` (OpenCode's SDK-native way to route a turn
+ * to a named sub-agent).
+ *
+ * See claude/index.ts for the full topology diagram and design rationale.
+ *
+ * Run: atomic workflow -n open-claude-design -a opencode "design a dashboard"
+ */
+declare const _default: import("../../../index.ts").WorkflowDefinition<"opencode", "prompt" | "reference" | "output-type" | "design-system">;
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/sdk/workflows/builtin/open-claude-design/opencode/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/sdk/workflows/builtin/open-claude-design/opencode/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;;AAoDH,wBAqea"}

package/dist/services/config/atomic-config.d.ts

@@ -7,6 +7,10 @@
  * 2) global `~/.atomic/settings.json` (default fallback)
  */
 import { type AgentKey, type ProviderOverrides } from "./index.ts";
+/** Source control providers Atomic can auto-configure MCP servers for. */
+export declare const SCM_PROVIDERS: readonly ["github", "azure-devops", "sapling"];
+export type ScmProvider = (typeof SCM_PROVIDERS)[number];
+export declare function isScmProvider(value: unknown): value is ScmProvider;
 /**
  * Atomic project configuration schema.
  */
@@ -15,6 +19,8 @@ export interface AtomicConfig {
     version?: number;
     /** Timestamp of last init */
     lastUpdated?: string;
+    /** Selected source control provider (drives MCP server enable/disable sync). */
+    scm?: ScmProvider;
     /** Per-provider overrides for chatFlags and envVars */
     providers?: Partial<Record<AgentKey, ProviderOverrides>>;
 }

package/dist/services/config/atomic-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"atomic-config.d.ts","sourceRoot":"","sources":["../../../src/services/config/atomic-config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAOnE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uDAAuD;IACvD,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC;CAC1D;AAwHD;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAMvF;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,GAC7B,OAAO,CAAC,IAAI,CAAC,CAsBf;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,iBAAiB,CAAC,CAG5B"}
+{"version":3,"file":"atomic-config.d.ts","sourceRoot":"","sources":["../../../src/services/config/atomic-config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAOnE,0EAA0E;AAC1E,eAAO,MAAM,aAAa,gDAAiD,CAAC;AAC5E,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAElE;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gFAAgF;IAChF,GAAG,CAAC,EAAE,WAAW,CAAC;IAClB,uDAAuD;IACvD,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC;CAC1D;AA0HD;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAMvF;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,GAC7B,OAAO,CAAC,IAAI,CAAC,CAsBf;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,iBAAiB,CAAC,CAG5B"}

package/dist/services/config/scm-sync.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Source-control-driven MCP server enable/disable sync.
+ *
+ * When the user sets `scm` in `.atomic/settings.json` to one of
+ * `github`, `azure-devops`, or `sapling`, Atomic keeps the corresponding
+ * MCP servers in the project's agent configs consistent on every
+ * `atomic chat` / `atomic workflow` startup:
+ *
+ * - `.claude/settings.json`    → updates the `disabledMcpjsonServers` array
+ * - `.opencode/opencode.json`  → flips `mcp.<server>.enabled` flags
+ *
+ * Only servers that already exist in the config are touched — we never
+ * add MCP server definitions the user didn't set up. Files that don't
+ * exist are skipped (the user may not use that agent).
+ */
+import type { ScmProvider } from "./atomic-config.ts";
+/**
+ * Pure helper: returns the `--disable-mcp-server <name>` flag sequence to
+ * append when spawning Copilot CLI, given a selected scm provider.
+ *
+ * Copilot has no on-disk MCP server enable/disable store, so Atomic
+ * injects the flags on the CLI invocation instead. Returns an empty
+ * array when scm is unset so callers can spread unconditionally.
+ */
+export declare function copilotScmDisableFlags(scm: ScmProvider | undefined): string[];
+/**
+ * Resolve Copilot's scm-derived `--disable-mcp-server` flags from the
+ * project's atomic config. Best-effort — returns `[]` on any failure.
+ */
+export declare function getCopilotScmDisableFlags(projectRoot: string): Promise<string[]>;
+/**
+ * Apply the current `scm` selection to the project's agent config files.
+ * No-op when `scm` is unset. Swallows errors so a malformed agent
+ * config never blocks `atomic chat` / `atomic workflow` startup.
+ */
+export declare function syncScmMcpServers(projectRoot: string): Promise<void>;
+//# sourceMappingURL=scm-sync.d.ts.map

package/dist/services/config/scm-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scm-sync.d.ts","sourceRoot":"","sources":["../../../src/services/config/scm-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAatD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,EAAE,CAQ7E;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,CAC7C,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,EAAE,CAAC,CAOnB;AA4FD;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAc1E"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bastani/atomic",
-  "version": "0.5.25",
+  "version": "0.5.26-0",
   "description": "Configuration management CLI and SDK for coding agents",
   "type": "module",
   "license": "MIT",
@@ -70,18 +70,18 @@
     "@types/bun": "^1.3.12",
     "@types/react": "^19.2.14",
     "lefthook": "^2.1.6",
-    "oxlint": "^1.60.0",
-    "typescript": "^6.0.2",
+    "oxlint": "^1.61.0",
+    "typescript": "^6.0.3",
     "typescript-language-server": "^5.1.3"
   },
   "dependencies": {
-    "@anthropic-ai/claude-agent-sdk": "^0.2.111",
+    "@anthropic-ai/claude-agent-sdk": "^0.2.116",
     "@clack/prompts": "^1.2.0",
     "@commander-js/extra-typings": "^14.0.0",
     "@github/copilot-sdk": "^0.2.2",
-    "@opencode-ai/sdk": "^1.4.6",
-    "@opentui/core": "^0.1.99",
-    "@opentui/react": "^0.1.99",
+    "@opencode-ai/sdk": "^1.14.19",
+    "@opentui/core": "^0.1.102",
+    "@opentui/react": "^0.1.102",
     "commander": "^14.0.3",
     "ignore": "^7.0.5",
     "yaml": "^2.8.3",

package/src/cli.ts

@@ -318,8 +318,8 @@ Examples:
     configCmd
         .command("set")
         .description("Set a configuration value")
-        .argument("<key>", "Configuration key (e.g., telemetry)")
-        .argument("<value>", "Value to set (e.g., true, false)")
+        .argument("<key>", "Configuration key (telemetry | scm)")
+        .argument("<value>", "Value to set (telemetry: true|false; scm: github|azure-devops|sapling)")
         .action(async (key: string, value: string) => {
             const { configCommand } = await import("./commands/cli/config.ts");
             const exitCode = await configCommand("set", key, value);

package/src/commands/cli/chat/index.ts

@@ -18,6 +18,7 @@ import { homedir } from "node:os";
 import { mkdir, writeFile, rm } from "node:fs/promises";
 import { AGENT_CONFIG, type AgentKey } from "../../../services/config/index.ts";
 import { getProviderOverrides } from "../../../services/config/atomic-config.ts";
+import { getCopilotScmDisableFlags } from "../../../services/config/scm-sync.ts";
 import { ensureProjectSetup } from "../init/index.ts";
 import { COLORS } from "../../../theme/colors.ts";
 import { isCommandInstalled } from "../../../services/system/detect.ts";
@@ -83,7 +84,13 @@ export async function buildAgentArgs(
 
   const flags = overrides.chatFlags ?? [...config.chat_flags];
 
-  return [...flags, ...passthroughArgs];
+  // Copilot has no on-disk MCP toggle — `--disable-mcp-server <name>` is
+  // the equivalent of flipping `enabled: false` in .opencode/opencode.json
+  // or adding to `disabledMcpjsonServers` in .claude/settings.json.
+  const scmFlags =
+    agentType === "copilot" ? await getCopilotScmDisableFlags(projectRoot) : [];
+
+  return [...flags, ...scmFlags, ...passthroughArgs];
 }
 
 function generateChatId(): string {

package/src/commands/cli/config.ts

@@ -5,10 +5,17 @@
  *
  * Currently supported:
  *   atomic config set telemetry true|false
+ *   atomic config set scm github|azure-devops|sapling
  */
 
 import { log } from "@clack/prompts";
-import { setTelemetryEnabled } from "../../services/config/settings.ts";
+import {
+  setScmProvider,
+  setTelemetryEnabled,
+} from "../../services/config/settings.ts";
+import { SCM_PROVIDERS, isScmProvider } from "../../services/config/atomic-config.ts";
+
+const SUPPORTED_KEYS = ["telemetry", "scm"] as const;
 
 /**
  * Execute the config command
@@ -33,24 +40,41 @@ export async function configCommand(
     return 1;
   }
 
-  if (key !== "telemetry") {
-    log.error(`Unknown config key: ${key}. Only 'telemetry' is supported.`);
+  if (!(SUPPORTED_KEYS as readonly string[]).includes(key)) {
+    log.error(
+      `Unknown config key: ${key}. Supported keys: ${SUPPORTED_KEYS.join(", ")}.`,
+    );
     return 1;
   }
 
   if (!value) {
-    log.error("Missing value. Usage: atomic config set telemetry <true|false>");
+    log.error(`Missing value. Usage: atomic config set ${key} <value>`);
     return 1;
   }
 
-  if (value !== "true" && value !== "false") {
-    log.error(`Invalid value: ${value}. Must be 'true' or 'false'.`);
-    return 1;
+  if (key === "telemetry") {
+    if (value !== "true" && value !== "false") {
+      log.error(`Invalid value: ${value}. Must be 'true' or 'false'.`);
+      return 1;
+    }
+
+    const enabled = value === "true";
+    await setTelemetryEnabled(enabled);
+    log.success(`Telemetry has been ${enabled ? "enabled" : "disabled"}.`);
+    return 0;
   }
 
-  const enabled = value === "true";
-  await setTelemetryEnabled(enabled);
+  // key === "scm"
+  if (!isScmProvider(value)) {
+    log.error(
+      `Invalid value: ${value}. Must be one of: ${SCM_PROVIDERS.join(", ")}.`,
+    );
+    return 1;
+  }
 
-  log.success(`Telemetry has been ${enabled ? "enabled" : "disabled"}.`);
+  await setScmProvider(value);
+  log.success(
+    `Source control provider set to ${value}. The GitHub and Azure DevOps MCP servers in .claude/settings.json and .opencode/opencode.json will be reconciled on the next 'atomic chat' or 'atomic workflow' run.`,
+  );
   return 0;
 }

package/src/commands/cli/init/index.ts

@@ -8,11 +8,19 @@
 
 import type { AgentKey } from "../../../services/config/index.ts";
 import { getConfigRoot } from "../../../services/config/config-path.ts";
+import { syncScmMcpServers } from "../../../services/config/scm-sync.ts";
 import { applyManagedOnboardingFiles } from "./onboarding.ts";
 
 /**
  * Ensure the project is configured for the given agent. Idempotent — safe
  * to call on every `atomic chat` invocation.
+ *
+ * Runs in two phases:
+ *   1. Copy/merge bundled onboarding files into the project.
+ *   2. Reconcile the SCM MCP-server enable/disable state in the agent
+ *      configs to match the user's `scm` selection in `.atomic/settings.json`.
+ *      Order matters: the onboarding step may have just written the
+ *      baseline configs.
  */
 export async function ensureProjectSetup(
   agentKey: AgentKey,
@@ -20,4 +28,5 @@ export async function ensureProjectSetup(
 ): Promise<void> {
   const configRoot = getConfigRoot();
   await applyManagedOnboardingFiles(agentKey, projectRoot, configRoot);
+  await syncScmMcpServers(projectRoot);
 }

package/src/sdk/runtime/executor.ts

@@ -39,6 +39,7 @@ import {
   type ProviderOverrides,
 } from "../../services/config/definitions.ts";
 import { getProviderOverrides } from "../../services/config/atomic-config.ts";
+import { getCopilotScmDisableFlags } from "../../services/config/scm-sync.ts";
 import { ensureDir } from "../../services/system/copy.ts";
 import type { SessionEvent } from "@github/copilot-sdk";
 import type { SessionPromptResponse } from "@opencode-ai/sdk/v2";
@@ -281,6 +282,7 @@ function buildPaneCommand(
   agent: AgentType,
   port: number,
   overrides: ProviderOverrides = {},
+  extraChatFlags: string[] = [],
 ): { command: string; envVars: Record<string, string> } {
   const {
     cmd,
@@ -301,6 +303,7 @@ function buildPaneCommand(
           "--port",
           String(port),
           ...chatFlags,
+          ...extraChatFlags,
         ].join(" "),
         envVars,
       };
@@ -1141,6 +1144,12 @@ interface SharedRunnerState {
   inputs: Record<string, string>;
   /** User-configured provider overrides (global + local merged). */
   providerOverrides: ProviderOverrides;
+  /**
+   * Extra CLI flags appended to the agent's chat flags, derived from
+   * the project's scm selection. Currently only populated for Copilot
+   * (which has no on-disk MCP toggle — see `getCopilotScmDisableFlags`).
+   */
+  extraChatFlags: string[];
   panel: OrchestratorPanel;
   /** Sessions that have been spawned (for name uniqueness + cleanup). */
   activeRegistry: Map<string, ActiveSession>;
@@ -1420,6 +1429,7 @@ function createSessionRunner(
         shared.agent,
         port,
         shared.providerOverrides,
+        shared.extraChatFlags,
       );
 
       // ── 7. Create tmux window or headless execution ──
@@ -1789,6 +1799,8 @@ export async function runOrchestrator(): Promise<void> {
   process.chdir(cwd);
 
   const providerOverrides = await getProviderOverrides(agent, cwd);
+  const extraChatFlags =
+    agent === "copilot" ? await getCopilotScmDisableFlags(cwd) : [];
   const sessionsBaseDir = join(getSessionsBaseDir(), workflowRunId);
   await ensureDir(sessionsBaseDir);
 
@@ -1856,6 +1868,7 @@ export async function runOrchestrator(): Promise<void> {
     agent,
     inputs,
     providerOverrides,
+    extraChatFlags,
     panel,
     activeRegistry: new Map(),
     completedRegistry: new Map(),