peaks-loop 4.0.8 → 4.0.10

package/dist/services/impact/impact-scan-service.js

@@ -13,6 +13,7 @@
  * command; `peaks impact must-check` returns the must-check list
  * subset. Persistence is per-invocation (no state file).
  */
+import { normalizePath } from '../../shared/path-utils.js';
 /**
  * Default business flow map (covers the most common B-end
  * archetypes; users can override via --flows in the CLI).
@@ -34,7 +35,7 @@ export const DEFAULT_BUSINESS_FLOWS = new Map([
  * (the file itself, the parent dir, the project-wide pattern).
  */
 function pathToGlobs(path) {
-    const normalized = path.replace(/\\/g, '/');
+    const normalized = normalizePath(path);
     const parts = normalized.split('/');
     // Drop the filename → get the parent pattern: "src/foo/" → "src/**"
     const parent = parts.length > 1 ? parts.slice(0, -1).join('/') + '/**' : '**';
@@ -42,7 +43,7 @@ function pathToGlobs(path) {
 }
 /** Simple glob matcher supporting `**` and `*`. */
 export function matchGlob(pattern, path) {
-    const normalizedPath = path.replace(/\\/g, '/');
+    const normalizedPath = normalizePath(path);
     // Build regex by splitting on glob tokens, escaping the rest.
     // Order: ** (doublestar) → .* ; * → [^/]* ; other → escape
     let regexStr = '';
@@ -108,7 +109,7 @@ export function runImpactScan(opts) {
     // Predict other files that may be affected (siblings of changed files).
     const impactedFiles = [];
     for (const f of changed) {
-        const parts = f.replace(/\\/g, '/').split('/');
+        const parts = normalizePath(f).split('/');
         if (parts.length <= 1)
             continue;
         const parent = parts.slice(0, -1).join('/');

package/dist/services/job/job-progress-store.d.ts

@@ -31,16 +31,16 @@ export declare const JobProgressSchema: z.ZodObject<{
     updatedAt: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     updatedAt: string;
-    done: number;
     schemaVersion: 1;
+    done: number;
     jobId: string;
     total: number;
     currentSlice: string;
     lastCommitSha: string | null;
 }, {
     updatedAt: string;
-    done: number;
     schemaVersion: 1;
+    done: number;
     jobId: string;
     total: number;
     currentSlice: string;

package/dist/services/job/job-types.d.ts

@@ -9,7 +9,7 @@ export declare const SliceStateSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.
     repairCycles: z.ZodDefault<z.ZodNumber>;
     blockedReason: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    status: "pending" | "blocked" | "failed" | "done" | "skipped" | "in-progress";
+    status: "pending" | "blocked" | "failed" | "skipped" | "done" | "in-progress";
     label: string;
     sliceId: string;
     repairCycles: number;
@@ -18,7 +18,7 @@ export declare const SliceStateSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.
     failureReason?: string | undefined;
     blockedReason?: string | undefined;
 }, {
-    status: "pending" | "blocked" | "failed" | "done" | "skipped" | "in-progress";
+    status: "pending" | "blocked" | "failed" | "skipped" | "done" | "in-progress";
     label: string;
     sliceId: string;
     commitSha?: string | undefined;
@@ -27,7 +27,7 @@ export declare const SliceStateSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.
     repairCycles?: number | undefined;
     blockedReason?: string | undefined;
 }>, {
-    status: "pending" | "blocked" | "failed" | "done" | "skipped" | "in-progress";
+    status: "pending" | "blocked" | "failed" | "skipped" | "done" | "in-progress";
     label: string;
     sliceId: string;
     repairCycles: number;
@@ -36,7 +36,7 @@ export declare const SliceStateSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.
     failureReason?: string | undefined;
     blockedReason?: string | undefined;
 }, {
-    status: "pending" | "blocked" | "failed" | "done" | "skipped" | "in-progress";
+    status: "pending" | "blocked" | "failed" | "skipped" | "done" | "in-progress";
     label: string;
     sliceId: string;
     commitSha?: string | undefined;
@@ -45,7 +45,7 @@ export declare const SliceStateSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.
     repairCycles?: number | undefined;
     blockedReason?: string | undefined;
 }>, {
-    status: "pending" | "blocked" | "failed" | "done" | "skipped" | "in-progress";
+    status: "pending" | "blocked" | "failed" | "skipped" | "done" | "in-progress";
     label: string;
     sliceId: string;
     repairCycles: number;
@@ -54,7 +54,7 @@ export declare const SliceStateSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.
     failureReason?: string | undefined;
     blockedReason?: string | undefined;
 }, {
-    status: "pending" | "blocked" | "failed" | "done" | "skipped" | "in-progress";
+    status: "pending" | "blocked" | "failed" | "skipped" | "done" | "in-progress";
     label: string;
     sliceId: string;
     commitSha?: string | undefined;
@@ -63,7 +63,7 @@ export declare const SliceStateSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.
     repairCycles?: number | undefined;
     blockedReason?: string | undefined;
 }>, {
-    status: "pending" | "blocked" | "failed" | "done" | "skipped" | "in-progress";
+    status: "pending" | "blocked" | "failed" | "skipped" | "done" | "in-progress";
     label: string;
     sliceId: string;
     repairCycles: number;
@@ -72,7 +72,7 @@ export declare const SliceStateSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.
     failureReason?: string | undefined;
     blockedReason?: string | undefined;
 }, {
-    status: "pending" | "blocked" | "failed" | "done" | "skipped" | "in-progress";
+    status: "pending" | "blocked" | "failed" | "skipped" | "done" | "in-progress";
     label: string;
     sliceId: string;
     commitSha?: string | undefined;
@@ -117,7 +117,7 @@ export declare const JobStateSchema: z.ZodObject<{
         repairCycles: z.ZodDefault<z.ZodNumber>;
         blockedReason: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        status: "pending" | "blocked" | "failed" | "done" | "skipped" | "in-progress";
+        status: "pending" | "blocked" | "failed" | "skipped" | "done" | "in-progress";
         label: string;
         sliceId: string;
         repairCycles: number;
@@ -126,7 +126,7 @@ export declare const JobStateSchema: z.ZodObject<{
         failureReason?: string | undefined;
         blockedReason?: string | undefined;
     }, {
-        status: "pending" | "blocked" | "failed" | "done" | "skipped" | "in-progress";
+        status: "pending" | "blocked" | "failed" | "skipped" | "done" | "in-progress";
         label: string;
         sliceId: string;
         commitSha?: string | undefined;
@@ -135,7 +135,7 @@ export declare const JobStateSchema: z.ZodObject<{
         repairCycles?: number | undefined;
         blockedReason?: string | undefined;
     }>, {
-        status: "pending" | "blocked" | "failed" | "done" | "skipped" | "in-progress";
+        status: "pending" | "blocked" | "failed" | "skipped" | "done" | "in-progress";
         label: string;
         sliceId: string;
         repairCycles: number;
@@ -144,7 +144,7 @@ export declare const JobStateSchema: z.ZodObject<{
         failureReason?: string | undefined;
         blockedReason?: string | undefined;
     }, {
-        status: "pending" | "blocked" | "failed" | "done" | "skipped" | "in-progress";
+        status: "pending" | "blocked" | "failed" | "skipped" | "done" | "in-progress";
         label: string;
         sliceId: string;
         commitSha?: string | undefined;
@@ -153,7 +153,7 @@ export declare const JobStateSchema: z.ZodObject<{
         repairCycles?: number | undefined;
         blockedReason?: string | undefined;
     }>, {
-        status: "pending" | "blocked" | "failed" | "done" | "skipped" | "in-progress";
+        status: "pending" | "blocked" | "failed" | "skipped" | "done" | "in-progress";
         label: string;
         sliceId: string;
         repairCycles: number;
@@ -162,7 +162,7 @@ export declare const JobStateSchema: z.ZodObject<{
         failureReason?: string | undefined;
         blockedReason?: string | undefined;
     }, {
-        status: "pending" | "blocked" | "failed" | "done" | "skipped" | "in-progress";
+        status: "pending" | "blocked" | "failed" | "skipped" | "done" | "in-progress";
         label: string;
         sliceId: string;
         commitSha?: string | undefined;
@@ -171,7 +171,7 @@ export declare const JobStateSchema: z.ZodObject<{
         repairCycles?: number | undefined;
         blockedReason?: string | undefined;
     }>, {
-        status: "pending" | "blocked" | "failed" | "done" | "skipped" | "in-progress";
+        status: "pending" | "blocked" | "failed" | "skipped" | "done" | "in-progress";
         label: string;
         sliceId: string;
         repairCycles: number;
@@ -180,7 +180,7 @@ export declare const JobStateSchema: z.ZodObject<{
         failureReason?: string | undefined;
         blockedReason?: string | undefined;
     }, {
-        status: "pending" | "blocked" | "failed" | "done" | "skipped" | "in-progress";
+        status: "pending" | "blocked" | "failed" | "skipped" | "done" | "in-progress";
         label: string;
         sliceId: string;
         commitSha?: string | undefined;
@@ -200,7 +200,7 @@ export declare const JobStateSchema: z.ZodObject<{
     rotateEvery: number;
     mainSessionCycle: number;
     slices: {
-        status: "pending" | "blocked" | "failed" | "done" | "skipped" | "in-progress";
+        status: "pending" | "blocked" | "failed" | "skipped" | "done" | "in-progress";
         label: string;
         sliceId: string;
         repairCycles: number;
@@ -221,7 +221,7 @@ export declare const JobStateSchema: z.ZodObject<{
     jobId: string;
     startedAt: string;
     slices: {
-        status: "pending" | "blocked" | "failed" | "done" | "skipped" | "in-progress";
+        status: "pending" | "blocked" | "failed" | "skipped" | "done" | "in-progress";
         label: string;
         sliceId: string;
         commitSha?: string | undefined;
@@ -294,8 +294,8 @@ export declare const JobStatusSummarySchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     blocked: number;
     failed: number;
-    done: number;
     skipped: number;
+    done: number;
     total: number;
     mainLoopStrategy: "single" | "rotating";
     mainSessionCycle: number;
@@ -312,8 +312,8 @@ export declare const JobStatusSummarySchema: z.ZodObject<{
 }, {
     blocked: number;
     failed: number;
-    done: number;
     skipped: number;
+    done: number;
     total: number;
     mainLoopStrategy: "single" | "rotating";
     mainSessionCycle: number;
@@ -374,7 +374,7 @@ export declare const JobCheckpointInputSchema: z.ZodEffects<z.ZodEffects<z.ZodOb
     json: z.ZodDefault<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     project: string;
-    state: "failed" | "done" | "skipped";
+    state: "failed" | "skipped" | "done";
     json: boolean;
     jobId: string;
     sliceId: string;
@@ -382,7 +382,7 @@ export declare const JobCheckpointInputSchema: z.ZodEffects<z.ZodEffects<z.ZodOb
     commitSha?: string | undefined;
 }, {
     project: string;
-    state: "failed" | "done" | "skipped";
+    state: "failed" | "skipped" | "done";
     jobId: string;
     sliceId: string;
     reason?: string | undefined;
@@ -390,7 +390,7 @@ export declare const JobCheckpointInputSchema: z.ZodEffects<z.ZodEffects<z.ZodOb
     commitSha?: string | undefined;
 }>, {
     project: string;
-    state: "failed" | "done" | "skipped";
+    state: "failed" | "skipped" | "done";
     json: boolean;
     jobId: string;
     sliceId: string;
@@ -398,7 +398,7 @@ export declare const JobCheckpointInputSchema: z.ZodEffects<z.ZodEffects<z.ZodOb
     commitSha?: string | undefined;
 }, {
     project: string;
-    state: "failed" | "done" | "skipped";
+    state: "failed" | "skipped" | "done";
     jobId: string;
     sliceId: string;
     reason?: string | undefined;
@@ -406,7 +406,7 @@ export declare const JobCheckpointInputSchema: z.ZodEffects<z.ZodEffects<z.ZodOb
     commitSha?: string | undefined;
 }>, {
     project: string;
-    state: "failed" | "done" | "skipped";
+    state: "failed" | "skipped" | "done";
     json: boolean;
     jobId: string;
     sliceId: string;
@@ -414,7 +414,7 @@ export declare const JobCheckpointInputSchema: z.ZodEffects<z.ZodEffects<z.ZodOb
     commitSha?: string | undefined;
 }, {
     project: string;
-    state: "failed" | "done" | "skipped";
+    state: "failed" | "skipped" | "done";
     jobId: string;
     sliceId: string;
     reason?: string | undefined;

package/dist/services/migrate-skill-name/migrate.js

@@ -19,6 +19,7 @@
  */
 import { existsSync, readFileSync, readdirSync, statSync, writeFileSync } from 'node:fs';
 import { join, relative } from 'node:path';
+import { normalizePath } from '../../shared/path-utils.js';
 /**
  * Skip-paths are matched against the path relative to `projectRoot`,
  * forward-slashed (Windows-friendly). Each entry is a SUBSTRING —
@@ -41,7 +42,7 @@ function escapeRe(input) {
 }
 /** True iff `absPath` falls under any skip-path (substring match). */
 export function shouldSkip(projectRoot, absPath) {
-    const rel = relative(projectRoot, absPath).replace(/\\/g, '/');
+    const rel = normalizePath(relative(projectRoot, absPath));
     return SKIP_DIRS.some((skip) => rel.includes(skip));
 }
 /**

package/dist/services/observability/observability-service.d.ts

@@ -33,17 +33,17 @@ export declare const ObservabilityEventSchema: z.ZodObject<{
     role: z.ZodOptional<z.ZodEnum<["rd", "qa", "code-reviewer", "karpathy-reviewer", "peaks-security-audit", "peaks-perf-audit"]>>;
     detail: z.ZodRecord<z.ZodString, z.ZodUnknown>;
 }, "strip", z.ZodTypeAny, {
+    schemaVersion: 1;
     sessionId: string;
     detail: Record<string, unknown>;
-    schemaVersion: 1;
     ts: string;
     category: "dispatch" | "slice-transition" | "checkpoint" | "mode-gate" | "context-trigger" | "post-compact" | "cycle" | "token-usage" | "monotonic-trigger" | "lease";
     role?: "qa" | "rd" | "code-reviewer" | "karpathy-reviewer" | "peaks-security-audit" | "peaks-perf-audit" | undefined;
     sliceRid?: string | undefined;
 }, {
+    schemaVersion: 1;
     sessionId: string;
     detail: Record<string, unknown>;
-    schemaVersion: 1;
     ts: string;
     category: "dispatch" | "slice-transition" | "checkpoint" | "mode-gate" | "context-trigger" | "post-compact" | "cycle" | "token-usage" | "monotonic-trigger" | "lease";
     role?: "qa" | "rd" | "code-reviewer" | "karpathy-reviewer" | "peaks-security-audit" | "peaks-perf-audit" | undefined;

package/dist/services/openspec/artifact-boundary.js

@@ -22,6 +22,7 @@
  */
 import { posix, relative, resolve, isAbsolute as nodeIsAbsolute } from 'node:path';
 import { isPathInsideArtifactRoot as _isPathInsideArtifactRoot } from '../../shared/path-safety.js';
+import { normalizePath } from '../../shared/path-utils.js';
 export function ok(value) {
     return { ok: true, value };
 }
@@ -111,7 +112,7 @@ export function planArtifactPath(input) {
     // Always normalize separators to forward-slashes for the JSON-safe output,
     // then run posix.normalize so empty segments (foo//bar) and `..` segments
     // collapse to canonical form.
-    const forwardSlashed = candidateRaw.replace(/\\/g, '/');
+    const forwardSlashed = normalizePath(candidateRaw);
     const normalized = posix.normalize(forwardSlashed);
     // Resolve against workspaceRoot. If the candidate is already absolute,
     // posix.normalize preserves the leading `/`; `resolve` keeps it absolute
@@ -129,7 +130,7 @@ export function planArtifactPath(input) {
         });
     }
     const relativePath = relative(workspaceRoot, absolutePath);
-    const jsonSafeRelativePath = relativePath.replace(/\\/g, '/');
+    const jsonSafeRelativePath = normalizePath(relativePath);
     return ok({ absolutePath, relativePath, jsonSafeRelativePath });
 }
 const WORKSPACE_UNAVAILABLE_NEXT_ACTIONS = [

package/dist/services/openspec/coverage-evidence-reader.js

@@ -24,6 +24,7 @@ import { posix, relative, resolve } from 'node:path';
 import { readFile, stat } from 'node:fs/promises';
 import { isDirectory } from 'peaks-loop-shared/fs';
 import { ok, err } from './artifact-boundary.js';
+import { normalizePath } from '../../shared/path-utils.js';
 // ---------------------------------------------------------------------------
 // Discovery
 // ---------------------------------------------------------------------------
@@ -63,7 +64,7 @@ export async function resolveCoverageSummaryPath(input) {
     return err({ code: 'missing', triedPaths });
 }
 function toPosix(p) {
-    return p.replace(/\\/g, '/').replace(/\/$/, '');
+    return normalizePath(p).replace(/\/$/, '');
 }
 async function isReadable(p) {
     try {
@@ -112,7 +113,7 @@ export async function readC8Summary(path) {
         if (lines === null || statements === null || functions === null || branches === null) {
             continue;
         }
-        const normalizedKey = posix.normalize(key.replace(/\\/g, '/'));
+        const normalizedKey = posix.normalize(normalizePath(key));
         files.set(normalizedKey, {
             path: normalizePathSep(normalizedKey),
             relativePath: normalizedKey,
@@ -141,7 +142,7 @@ function asMetric(input) {
     return { pct, covered, total };
 }
 function normalizePathSep(p) {
-    return p.replace(/\\/g, '/');
+    return normalizePath(p);
 }
 // ---------------------------------------------------------------------------
 // Capability Mapping block parser (proposal.md)
@@ -215,7 +216,7 @@ function parseCapabilityRow(line) {
         return null;
     const row = {
         capability,
-        source: source.replace(/\\/g, '/').replace(/^\.\//, '').replace(/\/$/, ''),
+        source: normalizePath(source).replace(/^\.\//, '').replace(/\/$/, ''),
     };
     if (testAnchor !== undefined && testAnchor !== '') {
         row.testAnchor = testAnchor;
@@ -236,7 +237,7 @@ function parseCapabilityRow(line) {
 export async function resolveCapabilityFiles(input) {
     const abs = resolve(input.projectRoot, input.row.source);
     if (!(await isDirectory(abs))) {
-        const rel = relative(input.projectRoot, abs).replace(/\\/g, '/');
+        const rel = normalizePath(relative(input.projectRoot, abs));
         return [rel];
     }
     return await walkTsFiles(abs, input.projectRoot);
@@ -261,7 +262,7 @@ async function walkTsFiles(absRoot, projectRoot) {
                 stack.push(full);
             }
             else if (entry.isFile() && entry.name.endsWith('.ts')) {
-                const rel = relative(projectRoot, full).replace(/\\/g, '/');
+                const rel = normalizePath(relative(projectRoot, full));
                 out.push(rel);
             }
         }
@@ -339,7 +340,7 @@ export async function validateCapabilityCoverage(input) {
 export async function findStaleChangeFiles(input) {
     const { stat: statFn } = await import('node:fs/promises');
     const summaryMtime = (await statFn(input.summary.path)).mtimeMs;
-    const changeRoot = `${input.openspecRoot.replace(/\\/g, '/').replace(/\/$/, '')}/changes/${input.changeId}`;
+    const changeRoot = `${normalizePath(input.openspecRoot).replace(/\/$/, '')}/changes/${input.changeId}`;
     const candidates = [
         `${changeRoot}/proposal.md`,
         `${changeRoot}/tasks.md`,
@@ -375,7 +376,7 @@ export async function findStaleChangeFiles(input) {
         try {
             const m = (await statFn(candidate)).mtimeMs;
             if (m > summaryMtime) {
-                stale.push(relative(input.projectRoot, candidate).replace(/\\/g, '/'));
+                stale.push(normalizePath(relative(input.projectRoot, candidate)));
             }
         }
         catch {

package/dist/services/prd/handoff-auto-regen.js

@@ -16,6 +16,7 @@ import { dirname, join } from 'node:path';
 import { createHash } from 'node:crypto';
 import { showRequestArtifact } from '../artifacts/request-artifact-service.js';
 import { sha256OfBody } from './handoff-service.js';
+import { normalizePath } from '../../shared/path-utils.js';
 /**
  * Auto-regen the prd/handoff.md under `.peaks/_runtime/<sid>/prd/`.
  * Returns the outcome; never throws.
@@ -58,7 +59,7 @@ export async function autoRegenPrdHandoff(opts) {
         'goals: []',
         'acceptanceCriteria: []',
         'preservedBehavior: []',
-        `handoffPath: ${handoffPath.replace(opts.projectRoot, '').replace(/\\/g, '/').replace(/^\//, '')}`,
+        `handoffPath: ${normalizePath(handoffPath.replace(opts.projectRoot, '')).replace(/^\//, '')}`,
         '---',
         ''
     ].join('\n');

package/dist/services/scan/type-sanity-service.js

@@ -1,5 +1,6 @@
 import { execFileSync } from 'node:child_process';
 import { extname, basename } from 'node:path';
+import { normalizePath } from '../../shared/path-utils.js';
 const SOURCE_EXTENSIONS = new Set(['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs', '.vue', '.svelte', '.py', '.go', '.rs', '.java', '.kt', '.swift', '.cpp', '.c', '.h', '.cs', '.rb', '.php', '.scala', '.dart', '.less', '.scss', '.sass', '.css']);
 const DOCS_EXTENSIONS = new Set(['.md', '.mdx', '.rst', '.txt']);
 const LOCKFILE_NAMES = new Set(['pnpm-lock.yaml', 'package-lock.json', 'yarn.lock', 'bun.lockb', 'Cargo.lock', 'Gemfile.lock', 'composer.lock', 'go.sum', 'poetry.lock']);
@@ -32,7 +33,7 @@ function classifyFile(filePath) {
  * wrote `.peaks/**` markdown would be misclassified as a docs change.
  */
 function isArtifactWorkspaceFile(filePath) {
-    const normalized = filePath.replace(/\\/g, '/');
+    const normalized = normalizePath(filePath);
     return normalized === '.peaks' || normalized.startsWith('.peaks/');
 }
 function tryGitDiffFiles(projectRoot, baseRef) {

package/dist/services/sediment/json-schema.d.ts

@@ -107,6 +107,7 @@ export declare const BeeManifestSchema: z.ZodEffects<z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     name: string;
     description: string;
+    schemaVersion: "peaks.bee/1";
     segments: {
         name: string;
         outputs: {
@@ -128,7 +129,6 @@ export declare const BeeManifestSchema: z.ZodEffects<z.ZodObject<{
         retireOnMissesInRow?: number | undefined;
     };
     source: "user" | "system";
-    schemaVersion: "peaks.bee/1";
     promotion_status: "candidate" | "stable" | "retired" | "system-stable";
     entrypoint: {
         preamble: string;
@@ -142,6 +142,7 @@ export declare const BeeManifestSchema: z.ZodEffects<z.ZodObject<{
 }, {
     name: string;
     description: string;
+    schemaVersion: "peaks.bee/1";
     segments: {
         name: string;
         outputs: {
@@ -163,7 +164,6 @@ export declare const BeeManifestSchema: z.ZodEffects<z.ZodObject<{
         retireOnMissesInRow?: number | undefined;
     };
     source: "user" | "system";
-    schemaVersion: "peaks.bee/1";
     promotion_status: "candidate" | "stable" | "retired" | "system-stable";
     entrypoint: {
         preamble: string;
@@ -177,6 +177,7 @@ export declare const BeeManifestSchema: z.ZodEffects<z.ZodObject<{
 }>, {
     name: string;
     description: string;
+    schemaVersion: "peaks.bee/1";
     segments: {
         name: string;
         outputs: {
@@ -198,7 +199,6 @@ export declare const BeeManifestSchema: z.ZodEffects<z.ZodObject<{
         retireOnMissesInRow?: number | undefined;
     };
     source: "user" | "system";
-    schemaVersion: "peaks.bee/1";
     promotion_status: "candidate" | "stable" | "retired" | "system-stable";
     entrypoint: {
         preamble: string;
@@ -212,6 +212,7 @@ export declare const BeeManifestSchema: z.ZodEffects<z.ZodObject<{
 }, {
     name: string;
     description: string;
+    schemaVersion: "peaks.bee/1";
     segments: {
         name: string;
         outputs: {
@@ -233,7 +234,6 @@ export declare const BeeManifestSchema: z.ZodEffects<z.ZodObject<{
         retireOnMissesInRow?: number | undefined;
     };
     source: "user" | "system";
-    schemaVersion: "peaks.bee/1";
     promotion_status: "candidate" | "stable" | "retired" | "system-stable";
     entrypoint: {
         preamble: string;

package/dist/services/session/session-binding-bridge.js

@@ -18,10 +18,11 @@
  * Body of every function moved verbatim per Karpathy #3 (Surgical
  * Changes). No behavior change. The bridge adds nothing of its own.
  */
-import { existsSync, mkdirSync, readFileSync, realpathSync, writeFileSync } from 'node:fs';
-import { dirname, join, resolve } from 'node:path';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
 import { randomBytes } from 'node:crypto';
 import { initWorkspace } from '../workspace/workspace-service.js';
+import { projectRootsMatch, stableRealPath } from '../../shared/path-utils.js';
 import { getSessionId, getSessionIdCanonical, getSessionMeta, rotateSessionBinding } from './session-manager.js';
 // --- Lower-level helpers the bridge needs (moved verbatim) ---
 const SESSION_FILE = join('_runtime', 'session.json');
@@ -30,18 +31,6 @@ const META_FILE = 'session.json';
 function getLegacySessionFilePath(projectRoot) {
     return join(projectRoot, '.peaks', LEGACY_SESSION_FILE);
 }
-function canonicalizeProjectRoot(p) {
-    try {
-        return realpathSync(p);
-    }
-    catch {
-        return resolve(p);
-    }
-}
-function resolveStoredAgainstCaller(stored, caller) {
-    const resolved = resolve(caller, stored);
-    return canonicalizeProjectRoot(resolved);
-}
 function generateSessionId() {
     const now = new Date();
     const year = now.getFullYear();
@@ -62,7 +51,9 @@ function readSessionFile(projectRoot) {
         return null;
     try {
         const data = JSON.parse(readFileSync(pathToRead, 'utf8'));
-        if (data.sessionId && data.projectRoot === projectRoot) {
+        if (data.sessionId &&
+            typeof data.projectRoot === 'string' &&
+            projectRootsMatch(data.projectRoot, projectRoot)) {
             return data;
         }
         return null;
@@ -79,10 +70,9 @@ function readSessionFileCanonical(projectRoot) {
         return null;
     try {
         const data = JSON.parse(readFileSync(pathToRead, 'utf8'));
-        const storedRaw = typeof data.projectRoot === 'string' ? data.projectRoot : null;
         if (data.sessionId &&
-            storedRaw !== null &&
-            resolveStoredAgainstCaller(storedRaw, projectRoot) === resolveStoredAgainstCaller(projectRoot, projectRoot)) {
+            typeof data.projectRoot === 'string' &&
+            projectRootsMatch(data.projectRoot, projectRoot)) {
             return data;
         }
         return null;
@@ -97,7 +87,15 @@ function writeSessionFile(projectRoot, info) {
     if (!existsSync(dir)) {
         mkdirSync(dir, { recursive: true });
     }
-    writeFileSync(sessionFile, JSON.stringify(info, null, 2), 'utf8');
+    let canonicalProjectRoot;
+    try {
+        canonicalProjectRoot = stableRealPath(info.projectRoot);
+    }
+    catch {
+        canonicalProjectRoot = info.projectRoot;
+    }
+    const canonicalInfo = { ...info, projectRoot: canonicalProjectRoot };
+    writeFileSync(sessionFile, JSON.stringify(canonicalInfo, null, 2), 'utf8');
 }
 function getMetaFilePath(projectRoot, sessionId) {
     return join(projectRoot, '.peaks', '_runtime', sessionId, META_FILE);