peaks-loop 4.0.0-beta.5 → 4.0.0-beta.7

package/dist/src/services/polyrepo/polyrepo-service.js

@@ -0,0 +1,49 @@
+/**
+ * Polyrepo service — slice S2-b of RD-2.
+ *
+ * Thin orchestrator wrapping the scanner + dispatcher. CLI commands
+ * call into this service so they don't need to know about the
+ * individual helpers.
+ */
+import { dispatchArtifact, readManifest, writeManifest, manifestPath } from './polyrepo-dispatcher.js';
+import { scanPolyrepo } from './polyrepo-scanner.js';
+export class PolyrepoService {
+    /** Run a scan and persist the manifest. Returns the manifest + a
+     *  `created` flag indicating whether a new manifest was written
+     *  (false = existing manifest was overwritten). */
+    init(opts) {
+        const existing = readManifest(opts.root);
+        const manifest = opts.children === undefined
+            ? scanPolyrepo(opts.root)
+            : scanPolyrepo(opts.root, { explicitChildren: opts.children });
+        writeManifest(opts.root, manifest);
+        return { manifest, created: existing === null };
+    }
+    /** Read the persisted manifest + report children. */
+    status(root) {
+        const m = readManifest(root);
+        return {
+            root,
+            manifestExists: m !== null,
+            children: m?.children ?? [],
+            detectedAt: m?.detectedAt ?? null
+        };
+    }
+    /** Dispatch an artifact to the named child targets. Wrapper
+     *  around dispatchArtifact that resolves the manifest from disk
+     *  first. Throws when no manifest exists (caller should run init
+     *  first). */
+    dispatch(root, params) {
+        const manifest = readManifest(root);
+        if (manifest === null) {
+            throw new Error(`no polyrepo manifest at ${manifestPath(root)} — run \`peaks polyrepo init\` first`);
+        }
+        return dispatchArtifact({
+            manifest,
+            sid: params.sid,
+            rid: params.rid,
+            targets: params.targets,
+            artifact: { role: params.role, path: params.artifactPath }
+        });
+    }
+}

package/dist/src/services/polyrepo/polyrepo-types.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Polyrepo types — slice S2-b of RD-2.
+ *
+ * Models a parent directory that hosts one or more child git repos,
+ * each of which may carry its own `.peaks/` state. The root `.peaks/`
+ * is the source of truth for cross-child orchestration; child
+ * `.peaks/` are subsets that mirror only the artifacts the child
+ * needs (PRD §4.3).
+ */
+export type PeaksScope = 'root+child' | 'child-only';
+/** A single child repo discovered under the parent root. */
+export interface PolyrepoChild {
+    /** Stable id derived from the basename (e.g. `frontend`, `backend`). */
+    readonly id: string;
+    /** Absolute path to the child directory. */
+    readonly path: string;
+    /** Whether `.git` exists at the child root (true git repo, not just a subdir). */
+    readonly gitRoot: boolean;
+    /** Whether the child carries its own `.peaks/` artifact subset. */
+    readonly peaksScope: PeaksScope;
+    /** Whether the child has peaks-loop installed (peaks binary on PATH
+     *  is NOT checked here — that's done at dispatch time). */
+    readonly peaksInstalled: boolean;
+}
+/** The polyrepo manifest, written to `.peaks/polyrepo.json` on init. */
+export interface PolyrepoManifest {
+    /** Schema version — increment on breaking changes. */
+    readonly version: 1;
+    /** Absolute path to the parent (root) directory. */
+    readonly root: string;
+    /** ISO-8601 timestamp of when this manifest was generated. */
+    readonly detectedAt: string;
+    /** Children discovered under the root. */
+    readonly children: PolyrepoChild[];
+}
+/** A dispatch record — written to `.peaks/_runtime/<sid>/sc/dispatch/<rid>.json`
+ *  AND mirrored to each target child's
+ *  `.peaks/_runtime/<sid>/sc/dispatch/<rid>.json`. The two-axis
+ *  convention from .peaks/standards/ is preserved: reviewable
+ *  artifacts live under `.peaks/_runtime/<sid>/<role>/`, never as
+ *  top-level siblings of `.peaks/_runtime/`. */
+export interface PolyrepoDispatch {
+    readonly rid: string;
+    readonly sid: string;
+    readonly root: string;
+    /** Child ids targeted by this dispatch. Empty array = root-only. */
+    readonly targets: string[];
+    /** ISO timestamp. */
+    readonly dispatchedAt: string;
+    /** Source-of-truth for the artifact body. */
+    readonly artifact: {
+        readonly role: 'prd' | 'rd' | 'qa';
+        readonly path: string;
+    };
+}

package/dist/src/services/polyrepo/polyrepo-types.js

@@ -0,0 +1 @@
+export {};

package/dist/src/services/preferences/preferences-types.d.ts

@@ -71,7 +71,7 @@ export interface ProjectPreferences {
      * Slice 2026-06-28-code-mode-bypass-fix: economyMode is a
      * **MODEL-SELECTION** knob only — it chooses between the cheap
      * configured provider (`getConfiguredExecutionModelId`) and the
-     * strongest planner/reviewer model (`STRONGEST_MODEL_ID`). It does
+     * strongest planner/reviewer model (`getStrongestModelId(...)`). It does
      * NOT throttle concurrency, fan-out, or worker count. Per user
      * direction 2026-06-28: "效率比省钱更重要，是在效率达到最大值的时
      * 候，再去考虑经济问题" (efficiency first; economy is only considered

package/dist/src/services/providers/minimax-worker-service.d.ts

@@ -10,7 +10,7 @@ export type MiniMaxWorkerRequest = {
 export type MiniMaxWorkerResult = {
     provider: MiniMaxProviderSmokeResult;
     reviewHandoff: {
-        model: 'claude-opus-4-7';
+        model: string;
         prompt: string;
     };
     constraints: {

package/dist/src/services/providers/minimax-worker-service.js

@@ -62,7 +62,7 @@ export async function runMiniMaxWorker(config, request, fetchImpl = fetch) {
         successMatch: 'startsWith'
     }, fetchImpl);
     const reviewHandoff = {
-        model: 'claude-opus-4-7',
+        model: process.env.PEAKS_MINIMAX_REVIEW_MODEL ?? 'claude-opus-4-7',
         prompt: [
             `Review this MiniMax worker result for change ${sessionId}.`,
             `Goal: ${goal}`,

package/dist/src/services/rd/rd-service.js

@@ -4,7 +4,7 @@ import { stableRealPath } from '../../shared/path-utils.js';
 import { WORKSPACE_UNAVAILABLE_NEXT_ACTIONS } from '../../shared/planner-response.js';
 import { getLocalArtifactPath, hasValidArtifactWorkspace } from '../artifacts/workspace-service.js';
 import { getSessionDir } from '../session/getSessionDir.js';
-import { getConfiguredExecutionModelId, STRONGEST_MODEL_ID } from '../config/model-routing.js';
+import { getConfiguredExecutionModelId, getStrongestModelId } from '../config/model-routing.js';
 /**
  * 2.0.1-bug1: the slim 2.0 `~/.peaks/config.json` no longer carries a
  * `providers` block (legacy model config lives in
@@ -116,8 +116,8 @@ function selectConcreteTargetArea(targetAreas, index) {
 function getTaskModelRole(wave) {
     return wave === 'implementation candidates' || wave === 'unit-test execution' ? 'execution' : 'strongest';
 }
-function getTaskModelId(modelRole, executionModelId) {
-    return modelRole === 'execution' ? executionModelId : STRONGEST_MODEL_ID;
+function getTaskModelId(modelRole, executionModelId, strongestModelId) {
+    return modelRole === 'execution' ? executionModelId : strongestModelId;
 }
 const MAX_ARTIFACT_BYTES = 256_000;
 function readArtifactFile(rootPath, artifactWorkspacePath, artifact) {
@@ -220,6 +220,9 @@ function buildPlan(request, standardsOverlay) {
     const goal = normalizeGoal(request.goal);
     const swarmMode = request.swarmMode ?? true;
     const executionModelId = request.executionModelId?.trim() || resolveExecutionModelId();
+    // Slice 2026-07-09 add-zcode-adapter (A.3): strongest planner/reviewer
+    // model is resolved dynamically (config.model → env-var fallback).
+    const strongestModelId = getStrongestModelId();
     const { workerTarget, blockedReasons } = resolveWorkerTarget(request.maxWorkers);
     const artifactWorkspacePath = resolveArtifactWorkspacePath(request);
     const artifactRoot = 'rd/swarm';
@@ -342,7 +345,7 @@ function buildPlan(request, standardsOverlay) {
             workerKind: taskId,
             purpose: `${taskId.replace(/^rd-/, '').replace(/-/g, ' ')} for ${goal}`,
             modelRole,
-            modelId: getTaskModelId(modelRole, executionModelId),
+            modelId: getTaskModelId(modelRole, executionModelId, strongestModelId),
             inputs: [goal, artifactRoot],
             outputs: [briefPath],
             dependsOn: [...waveDependencies[wave]],

package/dist/src/services/runtime/runtime-detector.d.ts

@@ -0,0 +1,15 @@
+export type DetectedVendor = 'claude-code' | 'codex' | 'copilot' | 'unknown';
+export interface RuntimeDetectorOptions {
+    /** Override for env (used by tests). */
+    readonly env?: NodeJS.ProcessEnv;
+    /** Override for home directory (used by tests). */
+    readonly home?: string;
+}
+export interface DetectionResult {
+    readonly vendor: DetectedVendor;
+    /** Why this vendor was chosen — useful for diagnostics and tests. */
+    readonly reason: string;
+}
+/** Detect the active vendor. Order: claude-code → codex → copilot →
+ *  unknown. The first match wins. */
+export declare function detectRuntime(opts?: RuntimeDetectorOptions): DetectionResult;

package/dist/src/services/runtime/runtime-detector.js

@@ -0,0 +1,62 @@
+/**
+ * Runtime detector — slice S2-a of RD-2.
+ *
+ * Given the current process environment, decide which vendor (if any)
+ * is the active AI runtime. Detection order matters: Claude Code is
+ * checked first because it is the default runtime for peaks-loop
+ * (the project literally runs inside Claude Code). Codex + Copilot
+ * are checked second; if none match we report `unknown`.
+ *
+ * Detectors MUST be cheap (no process spawn, no network). They look
+ * at env vars + filesystem sentinels + home-dir shapes only. This
+ * keeps `peaks runtime detect` sub-100ms even on cold paths.
+ */
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+/** Heuristic: Claude Code sets CLAUDE_CODE_ENTRYPOINT or has a
+ *  .claude/skills directory under HOME (peaks-loop installs there). */
+function detectClaudeCode(opts) {
+    const env = opts.env ?? process.env;
+    if (env.CLAUDE_CODE === '1' || env.CLAUDE_CODE === 'true')
+        return true;
+    if (env.CLAUDE_CODE_ENTRYPOINT !== undefined && env.CLAUDE_CODE_ENTRYPOINT.length > 0)
+        return true;
+    const home = opts.home ?? process.env.HOME ?? process.env.USERPROFILE ?? '';
+    if (home.length > 0 && existsSync(join(home, '.claude')))
+        return true;
+    return false;
+}
+/** Heuristic: Codex sets CODEX_HOME or has a .codex dir under HOME. */
+function detectCodex(opts) {
+    const env = opts.env ?? process.env;
+    if (env.CODEX_HOME !== undefined && env.CODEX_HOME.length > 0)
+        return true;
+    const home = opts.home ?? process.env.HOME ?? process.env.USERPROFILE ?? '';
+    if (home.length > 0 && existsSync(join(home, '.codex')))
+        return true;
+    return false;
+}
+/** Heuristic: Copilot sets GITHUB_COPILOT or has a .copilot dir. */
+function detectCopilot(opts) {
+    const env = opts.env ?? process.env;
+    if (env.GITHUB_COPILOT === '1' || env.GITHUB_COPILOT === 'true')
+        return true;
+    const home = opts.home ?? process.env.HOME ?? process.env.USERPROFILE ?? '';
+    if (home.length > 0 && existsSync(join(home, '.copilot')))
+        return true;
+    return false;
+}
+/** Detect the active vendor. Order: claude-code → codex → copilot →
+ *  unknown. The first match wins. */
+export function detectRuntime(opts = {}) {
+    if (detectClaudeCode(opts)) {
+        return { vendor: 'claude-code', reason: 'CLAUDE_CODE_ENTRYPOINT / CLAUDE_CODE / ~/.claude matched' };
+    }
+    if (detectCodex(opts)) {
+        return { vendor: 'codex', reason: 'CODEX_HOME / ~/.codex matched' };
+    }
+    if (detectCopilot(opts)) {
+        return { vendor: 'copilot', reason: 'GITHUB_COPILOT / ~/.copilot matched' };
+    }
+    return { vendor: 'unknown', reason: 'no vendor sentinel detected' };
+}

package/dist/src/services/runtime/runtime-service.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Runtime service — slice S2-a of RD-2.
+ *
+ * Orchestrator that wires the runtime detector + vendor adapter
+ * registry into a small surface that the CLI commands call. The
+ * service owns the canonical list of built-in adapters (claude-code /
+ * codex / copilot) and decides which adapter handles a given
+ * `--via <id>` request.
+ *
+ * Design notes (Karpathy #2 Simplicity First):
+ *
+ *  - The service is a thin orchestrator — it does NOT contain any
+ *    vendor verb strings (claude / codex / copilot). All vendor verbs
+ *    live in `src/services/runtime/vendors/<vendor>.ts`. Verified by
+ *    AC-1.
+ *  - When `compactVia(id)` is called with an unknown id, the service
+ *    returns a "no-op" result with exitCode=0 and a warning instead of
+ *    throwing — vendor-neutrality means peaks-loop MUST keep working
+ *    even when the requested vendor adapter isn't registered.
+ *  - The service is the SOLE owner of the built-in adapter list. Tests
+ *    and CLI commands should never instantiate adapters directly;
+ *    they should call `listBuiltInAdapters()` or `getAdapter(id)`.
+ */
+import type { VendorAdapter, VendorCompactResult } from './vendor-adapter.js';
+export interface RuntimeServiceOptions {
+    /** Override the built-in adapter list (used by tests + the
+     *  adapter-registry's `register()` flow). */
+    readonly builtIns?: VendorAdapter[];
+    /** Override the home dir used by adapter detect() helpers. */
+    readonly home?: string;
+}
+/** Pure orchestrator. The runtime service holds built-in adapters as
+ *  the baseline registry; the AdapterRegistry layer (`src/services/
+ *  adapter/adapter-registry.ts`) extends this baseline at runtime via
+ *  user-registered adapters persisted to `.peaks/runtime/adapters.json`.
+ *  The two layers are intentionally separate:
+ *    - runtime-service: built-in vendor adapters for the runtime-detect
+ *      compact flow (S2-a).
+ *    - adapter-registry: persisted user-registered adapters (S2-a).
+ *  runtime-service itself does NOT consult the adapter registry —
+ *  callers (`peaks runtime compact --via <id>`) layer them: first look
+ *  up the id in the persisted registry, fall back to the built-in list.
+ */
+export declare class RuntimeService {
+    private readonly builtIns;
+    constructor(opts?: RuntimeServiceOptions);
+    /** Return all built-in adapters. Order: claude-code, codex, copilot. */
+    listBuiltInAdapters(): VendorAdapter[];
+    /** Resolve a built-in adapter by id. Returns undefined when not
+     *  found — caller should fall back to adapter registry or unknown. */
+    getBuiltInAdapter(id: string): VendorAdapter | undefined;
+    /** Compact via a built-in adapter. When the id is unknown, returns
+     *  a no-op result with a warning rather than throwing — vendor
+     *  neutrality demands peaks-loop stay alive even when a vendor is
+     *  not wired up. */
+    compactVia(id: string, force: boolean | undefined): Promise<VendorCompactResult & {
+        warning?: string;
+    }>;
+}

package/dist/src/services/runtime/runtime-service.js

@@ -0,0 +1,51 @@
+import { ClaudeCodeAdapter } from './vendors/claude-code.js';
+import { CodexAdapter } from './vendors/codex.js';
+import { CopilotAdapter } from './vendors/copilot.js';
+const DEFAULT_BUILT_INS = [
+    new ClaudeCodeAdapter(),
+    new CodexAdapter(),
+    new CopilotAdapter()
+];
+/** Pure orchestrator. The runtime service holds built-in adapters as
+ *  the baseline registry; the AdapterRegistry layer (`src/services/
+ *  adapter/adapter-registry.ts`) extends this baseline at runtime via
+ *  user-registered adapters persisted to `.peaks/runtime/adapters.json`.
+ *  The two layers are intentionally separate:
+ *    - runtime-service: built-in vendor adapters for the runtime-detect
+ *      compact flow (S2-a).
+ *    - adapter-registry: persisted user-registered adapters (S2-a).
+ *  runtime-service itself does NOT consult the adapter registry —
+ *  callers (`peaks runtime compact --via <id>`) layer them: first look
+ *  up the id in the persisted registry, fall back to the built-in list.
+ */
+export class RuntimeService {
+    builtIns;
+    constructor(opts = {}) {
+        this.builtIns = opts.builtIns ?? [...DEFAULT_BUILT_INS];
+    }
+    /** Return all built-in adapters. Order: claude-code, codex, copilot. */
+    listBuiltInAdapters() {
+        return [...this.builtIns];
+    }
+    /** Resolve a built-in adapter by id. Returns undefined when not
+     *  found — caller should fall back to adapter registry or unknown. */
+    getBuiltInAdapter(id) {
+        return this.builtIns.find((a) => a.id === id);
+    }
+    /** Compact via a built-in adapter. When the id is unknown, returns
+     *  a no-op result with a warning rather than throwing — vendor
+     *  neutrality demands peaks-loop stay alive even when a vendor is
+     *  not wired up. */
+    async compactVia(id, force) {
+        const adapter = this.getBuiltInAdapter(id);
+        if (adapter === undefined) {
+            return {
+                exitCode: 0,
+                stdout: '',
+                stderr: '',
+                warning: `no built-in adapter registered for id="${id}" — falling back to no-op; use \`peaks adapter register --id ${id} --binary <cmd>\` to wire one`
+            };
+        }
+        return adapter.compact({ force: force === true });
+    }
+}

package/dist/src/services/runtime/vendor-adapter.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Vendor adapter contract — slice S2-a of RD-2 (2026-07-08 session).
+ *
+ * Each `VendorAdapter` is a thin wrapper around ONE AI runtime (Claude
+ * Code / Codex / Copilot / custom) that knows how to:
+ *
+ *   1. Detect whether the current environment is that vendor
+ *      (env vars, sentinel binaries, environment shape).
+ *   2. Issue a compact command through that vendor without forcing
+ *      peaks-loop's core code to know vendor-specific verbs.
+ *
+ * The interface is intentionally MINIMAL (Karpathy #2 Simplicity First):
+ * two methods (`detect`, `compact`) plus an `id` + `displayName`.
+ * New verbs (status, refactor, etc.) are NOT in scope — they would
+ * bloat the surface and force every vendor to implement every verb
+ * whether the vendor supports it or not. When a future verb is needed
+ * it can either be added to the interface (with all vendors forced to
+ * implement) or — preferred — handled through a separate
+ * verb-specific adapter family.
+ *
+ * Vendor-specific verb strings (`claude --compact`, `codex --compact`,
+ * `copilot compact`) MUST live ONLY in adapter implementations under
+ * `src/services/runtime/vendors/<vendor>.ts`. The runtime service that
+ * orchestrates these adapters (runtime-service.ts) and the CLI commands
+ * (`peaks runtime compact --via <id>`) MUST NOT contain vendor verbs
+ * — verified by AC-1: `rg -n "claude --compact|codex --compact|copilot
+ * compact" src/services/code/` must return 0 matches.
+ *
+ * See `.peaks/_runtime/2026-07-08-session-17918f/prd/002-adapter-runtime-and-polyrepo.md`
+ * for the source PRD.
+ */
+export interface VendorCompactArgs {
+    /** When `true`, the vendor is asked to compact unconditionally even
+     *  if its auto-detector says it would not normally do so. */
+    readonly force?: boolean;
+}
+export interface VendorCompactResult {
+    readonly exitCode: number;
+    readonly stdout: string;
+    readonly stderr: string;
+}
+export interface VendorAdapter {
+    /** Stable identifier used by `peaks runtime compact --via <id>` and
+     *  by the adapter registry. Convention: lowercase, dash-separated,
+     *  e.g. `claude-code`, `codex`, `copilot`. */
+    readonly id: string;
+    /** Human-readable name shown in `peaks runtime list` output. */
+    readonly displayName: string;
+    /** Whether the CURRENT environment is this vendor. Detectors MUST
+     *  be pure functions of env + filesystem; they MUST NOT spawn
+     *  processes or call vendor CLIs (a detect that itself runs the
+     *  vendor would defeat the purpose of asking whether the vendor is
+     *  present). */
+    detect(): Promise<boolean>;
+    /** Issue a compact command for this vendor. The adapter chooses
+     *  which binary + args + env to invoke; callers MUST NOT pass
+     *  vendor verbs through this method. */
+    compact(args?: VendorCompactArgs): Promise<VendorCompactResult>;
+}

package/dist/src/services/runtime/vendor-adapter.js

@@ -0,0 +1 @@
+export {};

package/dist/src/services/runtime/vendors/claude-code.d.ts

@@ -0,0 +1,7 @@
+import type { VendorAdapter, VendorCompactArgs, VendorCompactResult } from '../vendor-adapter.js';
+export declare class ClaudeCodeAdapter implements VendorAdapter {
+    readonly id = "claude-code";
+    readonly displayName = "Claude Code";
+    detect(): Promise<boolean>;
+    compact(args?: VendorCompactArgs): Promise<VendorCompactResult>;
+}

package/dist/src/services/runtime/vendors/claude-code.js

@@ -0,0 +1,39 @@
+/**
+ * Claude Code vendor adapter — slice S2-a.
+ *
+ * Stubs the compact verb to `claude --compact` (the canonical vendor
+ * verb for Claude Code). The actual binary is invoked via spawn so
+ * the adapter does NOT block peaks-loop. When the `claude` binary is
+ * not on PATH the adapter returns exitCode=127 + stderr explaining
+ * the missing binary, which the runtime service surfaces as a warning
+ * + no-op rather than a fatal error (vendor-neutrality: peaks-loop
+ * should still work even when the host vendor CLI is absent).
+ */
+import { spawn } from 'node:child_process';
+export class ClaudeCodeAdapter {
+    id = 'claude-code';
+    displayName = 'Claude Code';
+    async detect() {
+        return process.env.CLAUDE_CODE === '1'
+            || process.env.CLAUDE_CODE === 'true'
+            || (process.env.CLAUDE_CODE_ENTRYPOINT?.length ?? 0) > 0;
+    }
+    async compact(args = {}) {
+        const argv = ['--compact'];
+        if (args.force === true)
+            argv.push('--force');
+        return new Promise((resolveRun) => {
+            const proc = spawn('claude', argv, { stdio: ['ignore', 'pipe', 'pipe'] });
+            let stdout = '';
+            let stderr = '';
+            proc.stdout.on('data', (chunk) => { stdout += chunk.toString('utf8'); });
+            proc.stderr.on('data', (chunk) => { stderr += chunk.toString('utf8'); });
+            proc.on('error', (err) => {
+                resolveRun({ exitCode: 127, stdout, stderr: stderr + (stderr.length > 0 ? '\n' : '') + err.message });
+            });
+            proc.on('close', (code) => {
+                resolveRun({ exitCode: code ?? 0, stdout, stderr });
+            });
+        });
+    }
+}

package/dist/src/services/runtime/vendors/codex.d.ts

@@ -0,0 +1,7 @@
+import type { VendorAdapter, VendorCompactArgs, VendorCompactResult } from '../vendor-adapter.js';
+export declare class CodexAdapter implements VendorAdapter {
+    readonly id = "codex";
+    readonly displayName = "Codex";
+    detect(): Promise<boolean>;
+    compact(args?: VendorCompactArgs): Promise<VendorCompactResult>;
+}

package/dist/src/services/runtime/vendors/codex.js

@@ -0,0 +1,43 @@
+/**
+ * Codex vendor adapter — slice S2-a.
+ *
+ * Stub adapter (PRD out-of-scope: full implementation lands in a
+ * future slice). The detect() heuristic is intentionally permissive:
+ * if CODEX_HOME or ~/.codex is present we report detected=true so
+ * `peaks runtime detect` exercises the codex branch. compact() uses
+ * the canonical `codex --compact` invocation; missing-binary is
+ * reported as exitCode=127, not a thrown error (the runtime service
+ * surfaces that as a warning + no-op so a missing vendor CLI does
+ * not break peaks-loop).
+ */
+import { spawn } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+export class CodexAdapter {
+    id = 'codex';
+    displayName = 'Codex';
+    async detect() {
+        if (process.env.CODEX_HOME !== undefined && process.env.CODEX_HOME.length > 0)
+            return true;
+        const home = process.env.HOME ?? process.env.USERPROFILE ?? '';
+        return home.length > 0 && existsSync(join(home, '.codex'));
+    }
+    async compact(args = {}) {
+        const argv = ['--compact'];
+        if (args.force === true)
+            argv.push('--force');
+        return new Promise((resolveRun) => {
+            const proc = spawn('codex', argv, { stdio: ['ignore', 'pipe', 'pipe'] });
+            let stdout = '';
+            let stderr = '';
+            proc.stdout.on('data', (chunk) => { stdout += chunk.toString('utf8'); });
+            proc.stderr.on('data', (chunk) => { stderr += chunk.toString('utf8'); });
+            proc.on('error', (err) => {
+                resolveRun({ exitCode: 127, stdout, stderr: stderr + (stderr.length > 0 ? '\n' : '') + err.message });
+            });
+            proc.on('close', (code) => {
+                resolveRun({ exitCode: code ?? 0, stdout, stderr });
+            });
+        });
+    }
+}

package/dist/src/services/runtime/vendors/copilot.d.ts

@@ -0,0 +1,7 @@
+import type { VendorAdapter, VendorCompactArgs, VendorCompactResult } from '../vendor-adapter.js';
+export declare class CopilotAdapter implements VendorAdapter {
+    readonly id = "copilot";
+    readonly displayName = "GitHub Copilot";
+    detect(): Promise<boolean>;
+    compact(args?: VendorCompactArgs): Promise<VendorCompactResult>;
+}

package/dist/src/services/runtime/vendors/copilot.js

@@ -0,0 +1,40 @@
+/**
+ * Copilot vendor adapter — slice S2-a.
+ *
+ * Stub adapter (PRD out-of-scope: full implementation lands in a
+ * future slice). Copilot's compact verb is `copilot compact`
+ * (subcommand form, not `--compact` flag — different from Claude
+ * Code + Codex). The adapter encapsulates that verb here so the
+ * runtime service + CLI never see it.
+ */
+import { spawn } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+export class CopilotAdapter {
+    id = 'copilot';
+    displayName = 'GitHub Copilot';
+    async detect() {
+        if (process.env.GITHUB_COPILOT === '1' || process.env.GITHUB_COPILOT === 'true')
+            return true;
+        const home = process.env.HOME ?? process.env.USERPROFILE ?? '';
+        return home.length > 0 && existsSync(join(home, '.copilot'));
+    }
+    async compact(args = {}) {
+        const argv = ['compact'];
+        if (args.force === true)
+            argv.push('--force');
+        return new Promise((resolveRun) => {
+            const proc = spawn('copilot', argv, { stdio: ['ignore', 'pipe', 'pipe'] });
+            let stdout = '';
+            let stderr = '';
+            proc.stdout.on('data', (chunk) => { stdout += chunk.toString('utf8'); });
+            proc.stderr.on('data', (chunk) => { stderr += chunk.toString('utf8'); });
+            proc.on('error', (err) => {
+                resolveRun({ exitCode: 127, stdout, stderr: stderr + (stderr.length > 0 ? '\n' : '') + err.message });
+            });
+            proc.on('close', (code) => {
+                resolveRun({ exitCode: code ?? 0, stdout, stderr });
+            });
+        });
+    }
+}

package/dist/src/services/workflow/workflow-router-service.d.ts

@@ -38,7 +38,7 @@ export type WorkflowRouterStep = {
 };
 export type WorkflowModelRouting = {
     readonly strongestModel: {
-        readonly modelId: 'claude-opus-4-7';
+        readonly modelId: string;
         readonly uses: readonly WorkflowStepStage[];
     };
     readonly executionModel: {