peaks-loop 4.0.0-beta.6 → 4.0.0-beta.8

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

@@ -1,59 +0,0 @@
-/**
- * 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

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

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

@@ -1,7 +0,0 @@
-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

@@ -1,39 +0,0 @@
-/**
- * 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

@@ -1,7 +0,0 @@
-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

@@ -1,43 +0,0 @@
-/**
- * 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

@@ -1,7 +0,0 @@
-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

@@ -1,40 +0,0 @@
-/**
- * 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/sc/index.d.ts

@@ -1 +0,0 @@
-export * from './sc-service.js';

package/dist/src/services/sc/index.js

@@ -1 +0,0 @@
-export * from './sc-service.js';

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

@@ -1,131 +0,0 @@
-export type ChangeImpact = {
-    sessionId: string;
-    sourceArtifacts: string[];
-    affectedModules: string[];
-    affectedFiles: string[];
-    qaImpact: {
-        coverageDelta: number | null;
-        testCount: number;
-        status: 'passed' | 'failed' | 'unknown';
-    };
-    riskImpact: {
-        level: 'low' | 'medium' | 'high';
-        factors: string[];
-    };
-    syncPointers: {
-        artifactRepo: string | null;
-        lastSync: string | null;
-        localPath: string;
-    };
-};
-export type ArtifactRetentionReport = {
-    sliceId: string;
-    prdArtifacts: string[];
-    rdArtifacts: string[];
-    qaArtifacts: string[];
-    coverageArtifacts: string[];
-    reviewArtifacts: string[];
-    codeChanges: string[];
-    retentionStatus: 'local-ready' | 'pending' | 'explicitly-committed' | 'rolled-back';
-    commitHash: string | null;
-    rollbackPoint: string | null;
-};
-export type ChangeTraceabilityStatus = {
-    sessionId: string | null;
-    hasArtifactRepo: boolean;
-    artifactSyncStatus: 'synced' | 'pending' | 'out-of-sync' | 'unknown';
-    localArtifactPath: string;
-    requiredArtifacts: {
-        name: string;
-        path: string;
-        exists: boolean;
-    }[];
-    nextActions: string[];
-};
-export type CommitBoundary = {
-    sliceId: string;
-    commitHash: string | null;
-    timestamp: string;
-    artifacts: string[];
-    codeFiles: string[];
-    syncState: 'synced' | 'pending' | 'failed';
-    rollbackPoint: string | null;
-};
-/**
- * Resolution sources for `resolveArtifactSession`, in priority order.
- * - `active-skill`: the orchestrator's active-skill marker
- *   (`.peaks/_runtime/active-skill.json`, with a one-minor-release
- *   fallback to `.peaks/.active-skill.json`) `sessionId` points to a
- *   session dir that owns the slice's marker artifact.
- * - `session-json`: the workspace binding in
- *   `.peaks/_runtime/session.json` (with back-compat fallback to
- *   `.peaks/.session.json`) points to a session dir that owns the
- *   slice's marker artifact (active-skill was checked but did not
- *   own it; session-json is the next source).
- * - `find-fallback`: neither binding owned the artifact, but a `find`
- *   walk under `.peaks/` located a session dir that does own it.
- */
-export type ArtifactSessionSource = 'active-skill' | 'session-json' | 'find-fallback';
-export type ResolvedArtifactSession = {
-    resolvedSessionId: string | null;
-    candidateSources: ArtifactSessionSource[];
-};
-/**
- * Resolve the session id that owns the slice's artifacts using a 3-tier
- * precedence:
- *
- *   1. `.peaks/_runtime/active-skill.json` `sessionId` (with back-compat
- *      fallback to `.peaks/.active-skill.json`) if it points to a real
- *      session that owns the slice.
- *   2. `.peaks/_runtime/session.json` `sessionId` (with back-compat
- *      fallback to `.peaks/.session.json`) if it points to a real
- *      session that owns the slice.
- *   3. `find .peaks/ -name '<marker>'` — the first session dir under
- *      `.peaks/` that owns the slice.
- *   4. else `{ resolvedSessionId: null, candidateSources: [] }`.
- *
- * The back-compat fallbacks are tolerated for one minor release so
- * users with pre-migration trees (or running an older CLI version)
- * still get a clean resolution. After the migration (or after v1.3.0
- * is installed and `peaks workspace reconcile` has been run), only
- * the new paths exist and the fallbacks never fire.
- *
- * `candidateSources` reports which sources were checked before the
- * resolver found (or did not find) a winner; the list is in the order
- * the resolver consulted them. This makes the precedence observable in
- * the JSON envelope so a human reviewer can see "active-skill was empty
- * AND session-json was empty, so find-fallback won".
- */
-export declare function resolveArtifactSession(projectRoot: string, sliceId: string): ResolvedArtifactSession;
-export declare function getChangeTraceabilityStatus(): ChangeTraceabilityStatus;
-export declare function createChangeImpact(options: {
-    sessionId: string;
-    sourceArtifacts?: string[];
-    affectedModules?: string[];
-    affectedFiles?: string[];
-}): ChangeImpact;
-export declare function createArtifactRetentionReport(options: {
-    sliceId: string;
-    prdArtifacts?: string[];
-    rdArtifacts?: string[];
-    qaArtifacts?: string[];
-    coverageArtifacts?: string[];
-    reviewArtifacts?: string[];
-    codeChanges?: string[];
-}): ArtifactRetentionReport;
-export declare function recordCommitBoundary(options: {
-    sliceId: string;
-    artifacts?: string[];
-    codeFiles?: string[];
-}): CommitBoundary & {
-    resolvedSessionId: string | null;
-    candidateSources: ArtifactSessionSource[];
-};
-export declare function validateArtifactRetention(sliceId: string): {
-    valid: boolean;
-    missingArtifacts: string[];
-    warnings: string[];
-    resolvedSessionId: string | null;
-    candidateSources: ArtifactSessionSource[];
-};
-export declare function getScHelpText(): string[];