peaks-loop 3.1.2 → 4.0.0-beta.10

package/dist/src/services/scan/archetype-service.js

@@ -1,242 +0,0 @@
-import { readdir, stat } from 'node:fs/promises';
-import { join } from 'node:path';
-import { isDirectory, pathExists, readText } from '../../shared/fs.js';
-const BACKEND_DEP_NAMES = [
-    'express',
-    'koa',
-    'fastify',
-    '@nestjs/core',
-    '@nestjs/common',
-    'hapi',
-    '@hapi/hapi',
-    'restify',
-    'next' // treated separately for API routes
-];
-const BACKEND_DIR_CANDIDATES = ['server', 'backend', 'api', 'apps/server', 'apps/api', 'packages/server', 'packages/api'];
-const MONOREPO_CONFIG_FILES = ['pnpm-workspace.yaml', 'lerna.json', 'turbo.json', 'nx.json', 'rush.json'];
-const SWAGGER_CANDIDATE_PATHS = [
-    'swagger.json',
-    'swagger.yaml',
-    'openapi.json',
-    'openapi.yaml',
-    'openapi.yml',
-    'docs/swagger.json',
-    'docs/openapi.json',
-    'docs/openapi.yaml'
-];
-async function readPackageJsonDeps(projectRoot) {
-    const pkgPath = join(projectRoot, 'package.json');
-    if (!(await pathExists(pkgPath))) {
-        return { exists: false, deps: {} };
-    }
-    try {
-        const raw = await readText(pkgPath);
-        const parsed = JSON.parse(raw);
-        const deps = {
-            ...(parsed.dependencies ?? {}),
-            ...(parsed.devDependencies ?? {}),
-            ...(parsed.peerDependencies ?? {}),
-            ...(parsed.optionalDependencies ?? {})
-        };
-        return { exists: true, deps };
-    }
-    catch {
-        return { exists: true, deps: {} };
-    }
-}
-async function detectBackendFrameworks(deps) {
-    return BACKEND_DEP_NAMES.filter((name) => name !== 'next' && Object.prototype.hasOwnProperty.call(deps, name));
-}
-async function detectNextApiRoutes(projectRoot, hasNext) {
-    if (!hasNext) {
-        return false;
-    }
-    const candidates = ['pages/api', 'src/pages/api', 'app/api', 'src/app/api'];
-    for (const candidate of candidates) {
-        if (await isDirectory(join(projectRoot, candidate))) {
-            return true;
-        }
-    }
-    return false;
-}
-async function detectBackendDirs(projectRoot) {
-    const found = [];
-    for (const candidate of BACKEND_DIR_CANDIDATES) {
-        if (await isDirectory(join(projectRoot, candidate))) {
-            found.push(candidate);
-        }
-    }
-    return found;
-}
-async function detectSwagger(projectRoot) {
-    const found = [];
-    for (const candidate of SWAGGER_CANDIDATE_PATHS) {
-        if (await pathExists(join(projectRoot, candidate))) {
-            found.push(candidate);
-        }
-    }
-    const protoDir = join(projectRoot, 'proto');
-    if (await isDirectory(protoDir)) {
-        found.push('proto/');
-    }
-    return found;
-}
-async function detectMonorepoConfigs(projectRoot) {
-    const found = [];
-    for (const file of MONOREPO_CONFIG_FILES) {
-        if (await pathExists(join(projectRoot, file))) {
-            found.push(file);
-        }
-    }
-    return found;
-}
-async function countSrcFiles(projectRoot, max = 500) {
-    const srcDir = join(projectRoot, 'src');
-    if (!(await isDirectory(srcDir))) {
-        return 0;
-    }
-    let count = 0;
-    const queue = [srcDir];
-    while (queue.length > 0 && count < max) {
-        const current = queue.shift();
-        if (current === undefined)
-            break;
-        const entries = await readdir(current, { withFileTypes: true });
-        for (const entry of entries) {
-            if (entry.name.startsWith('.') || entry.name === 'node_modules')
-                continue;
-            const full = join(current, entry.name);
-            if (entry.isDirectory()) {
-                queue.push(full);
-            }
-            else if (/\.(tsx?|jsx?|vue|svelte)$/.test(entry.name)) {
-                count += 1;
-                if (count >= max)
-                    break;
-            }
-        }
-    }
-    return count;
-}
-async function lockfileAgeDays(projectRoot) {
-    const candidates = ['pnpm-lock.yaml', 'package-lock.json', 'yarn.lock', 'bun.lockb'];
-    for (const candidate of candidates) {
-        const full = join(projectRoot, candidate);
-        if (await pathExists(full)) {
-            const stats = await stat(full);
-            const ageMs = Date.now() - stats.mtimeMs;
-            return Math.floor(ageMs / (1000 * 60 * 60 * 24));
-        }
-    }
-    return null;
-}
-function decideArchetype(detected) {
-    const signals = [];
-    const hasBackend = detected.hasBackendFramework || detected.hasNextApiRoutes || detected.backendDirsPresent.length > 0;
-    signals.push({
-        name: 'backend-presence',
-        matched: hasBackend,
-        detail: hasBackend
-            ? [
-                detected.backendFrameworks.length > 0 ? `framework: ${detected.backendFrameworks.join(', ')}` : null,
-                detected.hasNextApiRoutes ? 'next-api-routes' : null,
-                detected.backendDirsPresent.length > 0 ? `dirs: ${detected.backendDirsPresent.join(', ')}` : null
-            ]
-                .filter(Boolean)
-                .join('; ')
-            : 'no backend framework, no next API routes, no backend dirs'
-    });
-    signals.push({
-        name: 'swagger-or-proto',
-        matched: detected.hasSwaggerOrProto,
-        detail: detected.hasSwaggerOrProto ? detected.swaggerPaths.join(', ') : 'no swagger/openapi/proto'
-    });
-    signals.push({
-        name: 'monorepo-config',
-        matched: detected.hasMonorepoConfig,
-        detail: detected.hasMonorepoConfig ? detected.monorepoConfigs.join(', ') : 'no monorepo config'
-    });
-    signals.push({
-        name: 'src-size',
-        matched: detected.srcFileCount >= 20,
-        detail: `${detected.srcFileCount} source files in src/`
-    });
-    signals.push({
-        name: 'lockfile-age',
-        matched: detected.lockfileAgeDays !== null && detected.lockfileAgeDays > 180,
-        detail: detected.lockfileAgeDays === null ? 'no lockfile' : `${detected.lockfileAgeDays} days`
-    });
-    if (!detected.hasPackageJson) {
-        return { archetype: 'unknown', confidence: 'low', signals };
-    }
-    if (detected.hasMonorepoConfig && !hasBackend) {
-        return { archetype: 'frontend-monorepo', confidence: 'high', signals };
-    }
-    if (hasBackend && detected.srcFileCount >= 20) {
-        return { archetype: 'legacy-fullstack', confidence: 'high', signals };
-    }
-    const greenfieldSignals = [
-        detected.srcFileCount < 20,
-        detected.lockfileAgeDays === null || detected.lockfileAgeDays <= 30,
-        !detected.hasSwaggerOrProto
-    ];
-    const greenfieldSignalCount = greenfieldSignals.filter(Boolean).length;
-    // Greenfield must show both a small src AND a fresh/missing lockfile — otherwise an empty-src legacy stub still looks like greenfield.
-    if (!hasBackend && greenfieldSignals[0] === true && greenfieldSignals[1] === true) {
-        return { archetype: 'greenfield', confidence: greenfieldSignalCount === 3 ? 'high' : 'medium', signals };
-    }
-    const legacySignalCount = [
-        !hasBackend,
-        !detected.hasSwaggerOrProto,
-        (detected.lockfileAgeDays !== null && detected.lockfileAgeDays > 180) || detected.srcFileCount >= 20
-    ].filter(Boolean).length;
-    if (!hasBackend && legacySignalCount >= 2) {
-        return { archetype: 'legacy-frontend', confidence: legacySignalCount === 3 ? 'high' : 'medium', signals };
-    }
-    if (hasBackend) {
-        return { archetype: 'legacy-fullstack', confidence: 'medium', signals };
-    }
-    return { archetype: 'unknown', confidence: 'low', signals };
-}
-function decideFrontendOnly(report) {
-    if (report.archetype === 'legacy-frontend' || report.archetype === 'frontend-monorepo') {
-        return { frontendOnly: true, reason: `archetype=${report.archetype}` };
-    }
-    const noBackend = !report.detected.hasBackendFramework && !report.detected.hasNextApiRoutes && report.detected.backendDirsPresent.length === 0;
-    if (noBackend && !report.detected.hasSwaggerOrProto) {
-        return { frontendOnly: true, reason: 'no-backend-no-swagger' };
-    }
-    if (report.detected.hasBackendFramework || report.detected.hasNextApiRoutes || report.detected.backendDirsPresent.length > 0) {
-        return { frontendOnly: false, reason: 'backend-detected' };
-    }
-    return { frontendOnly: false, reason: 'swagger-or-proto-present' };
-}
-export async function scanArchetype(options) {
-    const { projectRoot } = options;
-    const { exists: hasPackageJson, deps } = await readPackageJsonDeps(projectRoot);
-    const backendFrameworks = await detectBackendFrameworks(deps);
-    const hasNext = Object.prototype.hasOwnProperty.call(deps, 'next');
-    const hasNextApiRoutes = await detectNextApiRoutes(projectRoot, hasNext);
-    const backendDirsPresent = await detectBackendDirs(projectRoot);
-    const swaggerPaths = await detectSwagger(projectRoot);
-    const monorepoConfigs = await detectMonorepoConfigs(projectRoot);
-    const srcFileCount = await countSrcFiles(projectRoot);
-    const ageDays = await lockfileAgeDays(projectRoot);
-    const detected = {
-        hasPackageJson,
-        hasBackendFramework: backendFrameworks.length > 0,
-        backendFrameworks,
-        hasSwaggerOrProto: swaggerPaths.length > 0,
-        swaggerPaths,
-        hasMonorepoConfig: monorepoConfigs.length > 0,
-        monorepoConfigs,
-        hasNextApiRoutes,
-        srcFileCount,
-        backendDirsPresent,
-        lockfileAgeDays: ageDays
-    };
-    const { archetype, confidence, signals } = decideArchetype(detected);
-    const base = { archetype, confidence, signals, detected };
-    const { frontendOnly, reason } = decideFrontendOnly(base);
-    return { ...base, frontendOnly, frontendOnlyReason: reason };
-}

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

@@ -1,59 +0,0 @@
-export type ProjectArchetype = 'greenfield' | 'legacy-frontend' | 'legacy-fullstack' | 'frontend-monorepo' | 'unknown';
-export type ArchetypeSignal = {
-    name: string;
-    matched: boolean;
-    detail?: string;
-};
-export type ArchetypeReport = {
-    archetype: ProjectArchetype;
-    confidence: 'high' | 'medium' | 'low';
-    frontendOnly: boolean;
-    frontendOnlyReason: string;
-    signals: ArchetypeSignal[];
-    detected: {
-        hasPackageJson: boolean;
-        hasBackendFramework: boolean;
-        backendFrameworks: string[];
-        hasSwaggerOrProto: boolean;
-        swaggerPaths: string[];
-        hasMonorepoConfig: boolean;
-        monorepoConfigs: string[];
-        hasNextApiRoutes: boolean;
-        srcFileCount: number;
-        backendDirsPresent: string[];
-        lockfileAgeDays: number | null;
-    };
-};
-export type VisualTokenSource = {
-    path: string;
-    kind: 'less-vars' | 'sass-vars' | 'css-vars' | 'tailwind-config' | 'antd-config-provider' | 'theme-file';
-};
-export type VisualToken = {
-    name: string;
-    value: string;
-    source: string;
-};
-export type ConventionSample = {
-    path: string;
-    kind: 'component' | 'service' | 'hook' | 'page';
-};
-export type ExistingSystemReport = {
-    archetype: ProjectArchetype;
-    scanned: boolean;
-    scanSkippedReason?: string;
-    visualTokens: {
-        colors: VisualToken[];
-        spacing: VisualToken[];
-        typography: VisualToken[];
-        radii: VisualToken[];
-        sources: VisualTokenSource[];
-    };
-    conventions: {
-        componentNaming: 'PascalCase' | 'kebab-case' | 'mixed' | 'unknown';
-        componentDir: string | null;
-        serviceDir: string | null;
-        hookDir: string | null;
-        samples: ConventionSample[];
-    };
-    inconsistencies: string[];
-};

package/dist/src/services/session/binding-store.d.ts

@@ -1,161 +0,0 @@
-/**
- * Binding store — v2.16.0 multi-Claude-instance sentinel layer.
- *
- * Pre-v2.16.0 binding schema was a single-session record:
- *   { sessionId, createdAt, projectRoot }
- *
- * v2.16.0 schema is a multi-instance registry with conflict-detection
- * sentinel fields (ownerHint, pid, lastHeartbeat, instances Map).
- * See PRD `001-2026-06-29-v2-16-0-change-id-axis-removal` AC-8.
- *
- * The store keeps a one-shot migration from the legacy schema:
- * legacy single-session binding → v2.16.0 instances Map with one entry,
- * ownerHint sourced from env (PEAKS_OUTER_SESSION_ID fallback
- * CLAUDE_CODE_SESSION_ID fallback 'unknown').
- *
- * Each write produces an atomic writeFileSync — partial writes from
- * crashed processes are acceptable because re-read will re-validate
- * with the zod schema and either re-migrate or rebuild empty.
- */
-import { z } from 'zod';
-export declare const InstanceRecordSchema: z.ZodObject<{
-    startedAt: z.ZodString;
-    roles: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-    callerId: z.ZodString;
-    lastHeartbeat: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    startedAt: string;
-    roles: string[];
-    callerId: string;
-    lastHeartbeat: string;
-}, {
-    startedAt: string;
-    callerId: string;
-    lastHeartbeat: string;
-    roles?: string[] | undefined;
-}>;
-export declare const BindingSchema: z.ZodObject<{
-    ownerHint: z.ZodString;
-    pid: z.ZodNumber;
-    lastHeartbeat: z.ZodString;
-    scope: z.ZodString;
-    instances: z.ZodRecord<z.ZodString, z.ZodObject<{
-        startedAt: z.ZodString;
-        roles: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-        callerId: z.ZodString;
-        lastHeartbeat: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        startedAt: string;
-        roles: string[];
-        callerId: string;
-        lastHeartbeat: string;
-    }, {
-        startedAt: string;
-        callerId: string;
-        lastHeartbeat: string;
-        roles?: string[] | undefined;
-    }>>;
-}, "strip", z.ZodTypeAny, {
-    lastHeartbeat: string;
-    ownerHint: string;
-    pid: number;
-    scope: string;
-    instances: Record<string, {
-        startedAt: string;
-        roles: string[];
-        callerId: string;
-        lastHeartbeat: string;
-    }>;
-}, {
-    lastHeartbeat: string;
-    ownerHint: string;
-    pid: number;
-    scope: string;
-    instances: Record<string, {
-        startedAt: string;
-        callerId: string;
-        lastHeartbeat: string;
-        roles?: string[] | undefined;
-    }>;
-}>;
-export type InstanceRecord = z.infer<typeof InstanceRecordSchema>;
-export type Binding = z.infer<typeof BindingSchema>;
-/**
- * Read the project-level binding.
- *
- * Returns null if no binding exists. Returns a migrated v2.16.0 binding
- * when legacy schema is detected (one-shot auto-migration; original
- * legacy file is NOT deleted — caller decides retention policy).
- *
- * On schema violation (corrupt JSON or missing required field), the file
- * is backed up as `<path>.bak.<ISO>` and null is returned. The next
- * write call will recreate the binding from scratch.
- */
-export declare function readBinding(projectRoot: string): Binding | null;
-/**
- * Persist the binding atomically. Caller passes the full binding object;
- * the store does NOT merge — pass the result of `readBinding` (or
- * `withInstance`) and modify in place.
- */
-export declare function writeBinding(projectRoot: string, binding: Binding): void;
-/**
- * Register a Claude instance by `callerId`. Idempotent: if an instance
- * with the given callerId already exists, refresh its `lastHeartbeat`
- * and return its sid. Otherwise pick the next free sid slot (creating
- * a new session id under `instances`) and return it.
- *
- * This is the D2 Claude-instance-level binding primitive — a single
- * Claude instance keeps one sid across multiple peaks-* skill
- * activations; binding.instances[<sid>].roles accumulates the skill
- * names (peaks-solo → peaks-rd → peaks-qa in the same Claude run).
- *
- * The caller is responsible for actually creating the session dir via
- * `initWorkspace` and storing per-session meta via `setSessionMeta`.
- */
-export declare function registerInstance(projectRoot: string, opts: {
-    callerId: string;
-    roles?: string[];
-    existingSid?: string;
-}): {
-    binding: Binding;
-    sid: string;
-};
-/**
- * Touch the `lastHeartbeat` for a specific instance. Used by the
- * Doctor periodic loop (AC-10) and by the Skill presence `startup`
- * gate.
- */
-export declare function heartbeat(projectRoot: string, sid: string): Binding | null;
-/**
- * Drop an instance entry from the binding. Used when the last peaks-*
- * skill on a Claude instance exits (AC-7: all skills inactive →
- * no record). Returns the updated binding (or null if no instances
- * remain and the caller wants to delete the binding entirely).
- */
-export declare function dropInstance(projectRoot: string, sid: string): Binding | null;
-/**
- * Drop stale instances (lastHeartbeat older than `ttlMs`). Returns
- * the list of dropped sid values so the caller can log them. Used
- * by AC-10 Doctor.
- */
-export declare function dropStale(projectRoot: string, ttlMs: number): {
-    binding: Binding | null;
-    dropped: string[];
-};
-/**
- * Look up the active sid for a Claude caller. Returns null if this
- * caller has never registered or its instance was dropped.
- *
- * The caller is typically the outer-session-id (PEAKS_OUTER_SESSION_ID
- * with CLAUDE_CODE_SESSION_ID fallback) — same string used as
- * `ownerHint` and `callerId`.
- */
-export declare function findSidByCaller(projectRoot: string, callerId: string): string | null;
-export type RebuildResult = {
-    rewritten: number;
-    preserved: number;
-    errors: string[];
-    /** True when no legacy entries were present and the file is unchanged. */
-    noop: boolean;
-};
-export declare function rebuildBindingFromLegacy(projectRoot: string): RebuildResult;