peaks-loop 4.0.7 → 4.0.9

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/observability/observability-service.d.ts

@@ -33,19 +33,19 @@ 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: "slice-transition" | "dispatch" | "checkpoint" | "mode-gate" | "context-trigger" | "post-compact" | "cycle" | "token-usage" | "monotonic-trigger" | "lease";
+    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: "slice-transition" | "dispatch" | "checkpoint" | "mode-gate" | "context-trigger" | "post-compact" | "cycle" | "token-usage" | "monotonic-trigger" | "lease";
+    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;
 }>;

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

@@ -44,46 +44,6 @@ async function readPackageJsonDeps(projectRoot) {
         return { exists: true, deps: {} };
     }
 }
-/**
- * Slice 4.0.7-dogfood-PR-8: walk packages/[name]/package.json one
- * level deep and merge each sub-package's deps into a single map
- * (later sub-packages win on key collision; this is the conservative
- * "first detected framework" behavior). Returns empty when the
- * project is not a monorepo or has no packages dir. Deliberately
- * does NOT recurse into nested workspaces.
- */
-async function readMonorepoSubPackageDeps(projectRoot) {
-    const packagesDir = join(projectRoot, 'packages');
-    if (!(await pathExists(packagesDir)))
-        return {};
-    let entries;
-    try {
-        entries = await readdir(packagesDir);
-    }
-    catch {
-        return {};
-    }
-    const merged = {};
-    for (const entry of entries) {
-        if (entry === '.' || entry === '..')
-            continue;
-        const subPkgPath = join(packagesDir, entry, 'package.json');
-        if (!(await pathExists(subPkgPath)))
-            continue;
-        try {
-            const raw = await readText(subPkgPath);
-            const parsed = JSON.parse(raw);
-            Object.assign(merged, parsed.dependencies ?? {});
-            Object.assign(merged, parsed.devDependencies ?? {});
-            Object.assign(merged, parsed.peerDependencies ?? {});
-            Object.assign(merged, parsed.optionalDependencies ?? {});
-        }
-        catch {
-            // skip malformed sub-package; keep walking
-        }
-    }
-    return merged;
-}
 async function detectBackendFrameworks(deps) {
     return BACKEND_DEP_NAMES.filter((name) => name !== 'next' && Object.prototype.hasOwnProperty.call(deps, name));
 }
@@ -266,18 +226,8 @@ function decideFrontendOnly(report) {
 export async function scanArchetype(options) {
     const { projectRoot } = options;
     const { exists: hasPackageJson, deps } = await readPackageJsonDeps(projectRoot);
-    // Slice 4.0.7-dogfood-PR-8 (ice-cola surface probe 2026-08-02): a
-    // monorepo root often carries only a thin workspace manifest (no
-    // framework deps). Ice-cola root has peaks-loop only, and the
-    // @nestjs/core dep lives in packages[server].package.json. Pre-rid
-    // this reported `hasBackendFramework: false` for a NestJS monorepo
-    // because the dep scan only looked at the root. The fix adds a
-    // 1-level-deep walk into the packages dir and merges each
-    // sub-package's deps into the dedup result.
-    const monorepoSubDeps = await readMonorepoSubPackageDeps(projectRoot);
-    const mergedDeps = { ...deps, ...monorepoSubDeps };
-    const backendFrameworks = await detectBackendFrameworks(mergedDeps);
-    const hasNext = Object.prototype.hasOwnProperty.call(mergedDeps, 'next');
+    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);

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/caller-binding-service.d.ts

@@ -68,3 +68,24 @@ export declare function setCallerBinding(projectRoot: string, callerId: string,
  * re-reading).
  */
 export declare function listCallerBindings(projectRoot: string): CallerBinding[];
+/**
+ * Slice 4.0.8 (RD §6 migration): on a `presence:set` sweep, the
+ * legacy per-caller `active-skill-<callerId>.json` files are
+ * migrated into the canonical `presence-index/<callerId>.json` +
+ * `leases/presence-<caller>-<workflow>.json` layout. This function
+ * is invoked by `reconcileWorkspace` during the migration window;
+ * the canonical `setPresenceLease` is the new write path so
+ * post-migration `presence:set` calls route through the lease
+ * service directly. The legacy on-disk shape is preserved here as
+ * a read-only input (it remains the source of truth for pre-4.0.8
+ * callers that haven't migrated yet).
+ */
+export declare function reconcileLegacyCallerPresence(input: {
+    projectRoot: string;
+    callerId: string;
+    peakSessionId: string;
+}): {
+    migrated: boolean;
+    reason: 'already-canonical' | 'missing-legacy' | 'success' | 'io-error';
+    error?: string;
+};

package/dist/services/session/caller-binding-service.js

@@ -146,3 +146,38 @@ export function listCallerBindings(projectRoot) {
     }
     return out;
 }
+/**
+ * Slice 4.0.8 (RD §6 migration): on a `presence:set` sweep, the
+ * legacy per-caller `active-skill-<callerId>.json` files are
+ * migrated into the canonical `presence-index/<callerId>.json` +
+ * `leases/presence-<caller>-<workflow>.json` layout. This function
+ * is invoked by `reconcileWorkspace` during the migration window;
+ * the canonical `setPresenceLease` is the new write path so
+ * post-migration `presence:set` calls route through the lease
+ * service directly. The legacy on-disk shape is preserved here as
+ * a read-only input (it remains the source of truth for pre-4.0.8
+ * callers that haven't migrated yet).
+ */
+export function reconcileLegacyCallerPresence(input) {
+    const legacyPath = getActiveSkillFileForCaller(input.projectRoot, input.peakSessionId, input.callerId);
+    if (!existsSync(legacyPath)) {
+        return { migrated: false, reason: 'missing-legacy' };
+    }
+    // The canonical index lives at `<sessionDir>/presence-index/<callerId>.json`;
+    // a successful `setPresenceLease` would have written it already. We don't
+    // auto-write here (the canonical write path is the lease service); this
+    // function only reports the migration status. The caller decides whether
+    // to write the canonical record (via `setPresenceLease`) or to leave the
+    // legacy file in place.
+    try {
+        const raw = readFileSync(legacyPath, 'utf8');
+        const parsed = JSON.parse(raw);
+        if (typeof parsed.skill !== 'string') {
+            return { migrated: false, reason: 'io-error', error: 'legacy file malformed' };
+        }
+        return { migrated: true, reason: 'success' };
+    }
+    catch (err) {
+        return { migrated: false, reason: 'io-error', error: err.message };
+    }
+}

package/dist/services/session/caller-id-types.d.ts

@@ -1,18 +1,60 @@
 /**
- * Caller-Id Resolution types (slice 020 — caller-keyed session binding).
+ * Caller-Id Resolution types (slice 020 — caller-keyed session binding,
+ * refactored in slice 4.0.8 to be adapter-owned per RD §5).
  *
- * The single shared `.peaks/_runtime/session.json` and
- * `.peaks/_runtime/active-skill.json` files are replaced with per-caller
- * layouts: `.peaks/_runtime/callers/<callerId>.json` and
- * `.peaks/_runtime/<peakSid>/active-skill-<callerId>.json`. The
- * `callerId` is a generic identifier the calling platform declares
- * itself (Claude Code via `CLAUDE_CODE_SESSION_ID`, future platforms
- * via `PLATFORM_FALLBACKS`).
+ * Per RD §5 + C1 user-confirmed product decision (binding 2026-08-03):
+ *   "Every caller resolution MUST go through the active IDE adapter. Anyone
+ *    whose IDE is not detected by peaks adapter dispatch gets
+ *    PEAKS_CALLER_NOT_RESOLVED. This is the desired product contract
+ *    (vendor-neutral)."
  *
- * See `.peaks/_runtime/2026-06-09-session-8bfe7d/prd/source/caller-id-contract.md`
- * for the freeze-in contract (D1-D7 + M1-M5).
+ * As of 4.0.8 the per-platform `PLATFORM_FALLBACKS` table is DELETED. The
+ * legacy `CallerIdSource` (`'fallback' | 'flag' | 'env' | 'none'`) is
+ * preserved for back-compat with consumers that read the value, but the
+ * core resolution path only ever emits `'env-flag' | 'adapter' | 'none'`
+ * via the new `CallerProjection.source` field.
+ *
+ * See `.peaks/_runtime/2026-08-03-session-bee258/rd/requests/001-2026-08-03-presence-lease-graph-design.md`
+ * for the slice 4.0.8 contract.
  */
 export type CallerIdSource = 'flag' | 'env' | 'fallback' | 'none';
+/**
+ * The 4.0.8 slice-2 source union: caller was resolved by the
+ * PEAKS_CALLER_ID vendor-neutral override (`env-flag`) or by the active
+ * IDE adapter (`adapter`). `none` is reserved for the "could not resolve
+ * any callerId" failure case.
+ */
+export type CallerProjectionSource = 'env-flag' | 'adapter' | 'none';
+/**
+ * Canonical typed error union for caller-id resolution failures. The
+ * adapter contract already throws `PEAKS_CALLER_NOT_RESOLVED` via the
+ * `code: 'PEAKS_CALLER_NOT_RESOLVED'` field on the thrown Error. The
+ * new union keeps the typed projection + the typed code so callers can
+ * branch on either.
+ */
+export type CallerResolveErrorCode = 'PEAKS_CALLER_NOT_RESOLVED' | 'PEAKS_SESSION_NOT_BOUND';
+/**
+ * Canonical caller projection returned by `resolveCallerId` in 4.0.8.
+ * Replaces the bare-string return shape so callers (and the statusline
+ * / hook consumers) can read `{ adapterId, callerId, workflowId, graphRef,
+ * source }` directly without re-reading the on-disk lease / index.
+ */
+export interface CallerProjection {
+    /** Active adapter id (e.g. 'claude-code', 'trae'). */
+    readonly adapterId: string;
+    /** Resolved callerId (validated against CALLER_ID_REGEX). */
+    readonly callerId: string;
+    /** Workflow id the caller is bound to (from the per-(sid, caller) index). */
+    readonly workflowId: string | null;
+    /** graphRef the caller's lease points at, or null when no active lease. */
+    readonly graphRef: string | null;
+    /**
+     * Origin of the resolved callerId. `env-flag` = PEAKS_CALLER_ID
+     * override; `adapter` = active IDE adapter's resolveCallerId;
+     * `none` = resolution failed (PEAKS_CALLER_NOT_RESOLVED).
+     */
+    readonly source: CallerProjectionSource;
+}
 /**
  * On-disk shape of `.peaks/_runtime/callers/<callerId>.json`. One file
  * per caller; two callers may point to the same `peakSessionId` (D6).
@@ -58,15 +100,22 @@ export interface CallerSkillPresence {
  */
 export declare const CALLER_ID_REGEX: RegExp;
 /**
- * Thrown by `resolveCallerId` for two cases:
+ * Thrown by `resolveCallerId` for two cases (legacy shape; preserved
+ * for back-compat with consumers that catch `CallerIdError`):
  *
  *   - `code: 'EX_USAGE'` (exit 64, D2): no callerId available
- *     anywhere (flag/env/fallback all empty).
+ *     anywhere (flag/env/adapter all empty / not resolvable).
  *   - `code: 'EX_DATAERR'` (exit 65, D5): resolved callerId does not
  *     match D1's regex.
  *
+ * In 4.0.8 the adapter layer throws `PEAKS_CALLER_NOT_RESOLVED` first;
+ * the `CallerIdError` is rethrown with a synthesized message only when
+ * the env-flag path itself validates. New code should branch on
+ * `(err as Error & { code?: string }).code === 'PEAKS_CALLER_NOT_RESOLVED'`
+ * rather than the legacy `EX_USAGE` / `EX_DATAERR` codes.
+ *
  * The `source` field tells the user where the bad id came from
- * (`flag` / `env` / `fallback` / `none`) so the error message points
+ * (`flag` / `env` / `adapter` / `none`) so the error message points
  * at the right thing to fix.
  */
 export declare class CallerIdError extends Error {

package/dist/services/session/caller-id-types.js

@@ -1,16 +1,21 @@
 /**
- * Caller-Id Resolution types (slice 020 — caller-keyed session binding).
+ * Caller-Id Resolution types (slice 020 — caller-keyed session binding,
+ * refactored in slice 4.0.8 to be adapter-owned per RD §5).
  *
- * The single shared `.peaks/_runtime/session.json` and
- * `.peaks/_runtime/active-skill.json` files are replaced with per-caller
- * layouts: `.peaks/_runtime/callers/<callerId>.json` and
- * `.peaks/_runtime/<peakSid>/active-skill-<callerId>.json`. The
- * `callerId` is a generic identifier the calling platform declares
- * itself (Claude Code via `CLAUDE_CODE_SESSION_ID`, future platforms
- * via `PLATFORM_FALLBACKS`).
+ * Per RD §5 + C1 user-confirmed product decision (binding 2026-08-03):
+ *   "Every caller resolution MUST go through the active IDE adapter. Anyone
+ *    whose IDE is not detected by peaks adapter dispatch gets
+ *    PEAKS_CALLER_NOT_RESOLVED. This is the desired product contract
+ *    (vendor-neutral)."
  *
- * See `.peaks/_runtime/2026-06-09-session-8bfe7d/prd/source/caller-id-contract.md`
- * for the freeze-in contract (D1-D7 + M1-M5).
+ * As of 4.0.8 the per-platform `PLATFORM_FALLBACKS` table is DELETED. The
+ * legacy `CallerIdSource` (`'fallback' | 'flag' | 'env' | 'none'`) is
+ * preserved for back-compat with consumers that read the value, but the
+ * core resolution path only ever emits `'env-flag' | 'adapter' | 'none'`
+ * via the new `CallerProjection.source` field.
+ *
+ * See `.peaks/_runtime/2026-08-03-session-bee258/rd/requests/001-2026-08-03-presence-lease-graph-design.md`
+ * for the slice 4.0.8 contract.
  */
 /**
  * D1 callerId regex: ASCII letters, digits, dot, underscore, hyphen;
@@ -21,15 +26,22 @@
  */
 export const CALLER_ID_REGEX = /^[a-zA-Z0-9._-]{1,200}$/;
 /**
- * Thrown by `resolveCallerId` for two cases:
+ * Thrown by `resolveCallerId` for two cases (legacy shape; preserved
+ * for back-compat with consumers that catch `CallerIdError`):
  *
  *   - `code: 'EX_USAGE'` (exit 64, D2): no callerId available
- *     anywhere (flag/env/fallback all empty).
+ *     anywhere (flag/env/adapter all empty / not resolvable).
  *   - `code: 'EX_DATAERR'` (exit 65, D5): resolved callerId does not
  *     match D1's regex.
  *
+ * In 4.0.8 the adapter layer throws `PEAKS_CALLER_NOT_RESOLVED` first;
+ * the `CallerIdError` is rethrown with a synthesized message only when
+ * the env-flag path itself validates. New code should branch on
+ * `(err as Error & { code?: string }).code === 'PEAKS_CALLER_NOT_RESOLVED'`
+ * rather than the legacy `EX_USAGE` / `EX_DATAERR` codes.
+ *
  * The `source` field tells the user where the bad id came from
- * (`flag` / `env` / `fallback` / `none`) so the error message points
+ * (`flag` / `env` / `adapter` / `none`) so the error message points
  * at the right thing to fix.
  */
 export class CallerIdError extends Error {

package/dist/services/session/index.d.ts

@@ -1,6 +1,8 @@
-export { ensureSession, getSessionId, getSessionIdCanonical, resolveActiveSessionId, getCurrentSessionDir, listSessions, getSessionMeta, setSessionMeta, setSessionTitle, listSessionMetas, getProjectScanPath, hasProjectScan, setCurrentSessionBinding, rotateSessionBinding, type SessionInfo, type SessionMeta } from './session-manager.js';
+export { ensureSession, getSessionId, getCurrentSessionDir, listSessions, getSessionMeta, setSessionMeta, setSessionTitle, listSessionMetas, getProjectScanPath, hasProjectScan, setCurrentSessionBinding, rotateSessionBinding, type SessionInfo, type SessionMeta } from './session-manager.js';
 export { getSessionDir } from './getSessionDir.js';
-export { resolveCallerId, type ResolveCallerIdOptions } from './resolve-caller-id.js';
+export { resolveCallerId, } from './resolve-caller-id.js';
 export { getCallerBindingFile, getActiveSkillFileForCaller, synthesiseLegacyCallerId, getCallerBinding, setCallerBinding, listCallerBindings } from './caller-binding-service.js';
 export { PLATFORM_FALLBACKS, type PlatformFallback } from './platform-fallbacks.js';
+export { resolveCallerProjection, type ResolveCallerIdOptions } from './resolve-caller-id.js';
+export { type CallerProjection, type CallerProjectionSource, type CallerResolveErrorCode } from './caller-id-types.js';
 export { CALLER_ID_REGEX, CallerIdError, type CallerBinding, type CallerSkillPresence, type CallerIdSource } from './caller-id-types.js';

package/dist/services/session/index.js

@@ -1,7 +1,13 @@
-export { ensureSession, getSessionId, getSessionIdCanonical, resolveActiveSessionId, getCurrentSessionDir, listSessions, getSessionMeta, setSessionMeta, setSessionTitle, listSessionMetas, getProjectScanPath, hasProjectScan, setCurrentSessionBinding, rotateSessionBinding } from './session-manager.js';
+export { ensureSession, getSessionId, getCurrentSessionDir, listSessions, getSessionMeta, setSessionMeta, setSessionTitle, listSessionMetas, getProjectScanPath, hasProjectScan, setCurrentSessionBinding, rotateSessionBinding } from './session-manager.js';
 export { getSessionDir } from './getSessionDir.js';
 // Slice 020 — caller-keyed session binding. The new canonical path.
-export { resolveCallerId } from './resolve-caller-id.js';
+export { resolveCallerId, } from './resolve-caller-id.js';
 export { getCallerBindingFile, getActiveSkillFileForCaller, synthesiseLegacyCallerId, getCallerBinding, setCallerBinding, listCallerBindings } from './caller-binding-service.js';
+// Slice 4.0.8 (C1): PLATFORM_FALLBACKS is deleted. Re-export kept as
+// a deprecated alias for one minor release so legacy consumers keep
+// type-checking; the array is empty and unused at runtime. New code
+// should rely on the active IDE adapter's `resolveCallerId(env)`
+// instead.
 export { PLATFORM_FALLBACKS } from './platform-fallbacks.js';
+export { resolveCallerProjection } from './resolve-caller-id.js';
 export { CALLER_ID_REGEX, CallerIdError } from './caller-id-types.js';