peaks-loop 4.0.54 → 4.1.1

package/dist/services/workflow/workflow-autonomous-resume-helpers.js

@@ -9,7 +9,9 @@
  * `createResumePlan`). The high-level orchestrator
  * `createAutonomousWorkflowPlan` lives in the parent module and
  * imports from this sibling. Function signatures and behaviour are
- * unchanged (verbatim move).
+ * unchanged (verbatim move). The pure JSON / frontmatter content
+ * validators now live in the sibling
+ * `workflow-autonomous-resume-validation.ts` (B wave-3 file-size split).
  */
 import { closeSync, fstatSync, lstatSync, openSync, readSync, realpathSync, statSync } from 'node:fs';
 import { isAbsolute, relative, resolve } from 'node:path';
@@ -21,6 +23,7 @@ import { isAbsolute, relative, resolve } from 'node:path';
 // pre-built.
 import { getSessionDir } from '../session/getSessionDir.js';
 import { normalizePath } from '../../shared/path-utils.js';
+import { extractMarkdownListSection, getCheckpointValidationRefs, getMarkdownBody, isValidResumeArtifact } from './workflow-autonomous-resume-validation.js';
 const MAX_RESUME_ARTIFACT_BYTES = 256_000;
 // Slice 2026-06-29-change-id-root-removal: return the bare role-relative
 // sub-paths instead of `.peaks/_runtime/change/<id>/<role>/...` strings.
@@ -40,9 +43,6 @@ export function getResumeRequiredArtifacts(_sessionId) {
         'rd/swarm/resume-instructions.md'
     ];
 }
-function isObjectRecord(value) {
-    return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
 function isInsidePath(childPath, parentPath) {
     const relativePath = relative(parentPath, childPath);
     return relativePath === '' || (!relativePath.startsWith('..') && !isAbsolute(relativePath));
@@ -79,7 +79,9 @@ function readResumeArtifact(artifactWorkspacePath, sessionId, artifact) {
     try {
         const artifactWorkspaceRealPath = realpathSync(artifactWorkspacePath);
         const artifactStat = lstatSync(artifactPath);
-        if (artifactStat.isSymbolicLink() || !artifactStat.isFile() || artifactStat.size > MAX_RESUME_ARTIFACT_BYTES) {
+        if (artifactStat.isSymbolicLink() ||
+            !artifactStat.isFile() ||
+            artifactStat.size > MAX_RESUME_ARTIFACT_BYTES) {
             return null;
         }
         const sessionRootPath = sessionScopeRoot;
@@ -100,14 +102,20 @@ function readResumeArtifact(artifactWorkspacePath, sessionId, artifact) {
             allowedRootRealPath = realpathSync(roleRootPath);
         }
         const artifactRealPath = realpathSync(artifactPath);
-        if (!isInsidePath(allowedRootRealPath, artifactWorkspaceRealPath) || !isInsidePath(artifactRealPath, allowedRootRealPath)) {
+        if (!isInsidePath(allowedRootRealPath, artifactWorkspaceRealPath) ||
+            !isInsidePath(artifactRealPath, allowedRootRealPath)) {
             return null;
         }
         const fd = openSync(artifactPath, 'r');
         try {
             const openedStat = fstatSync(fd);
             const currentStat = statSync(artifactPath);
-            if (!openedStat.isFile() || openedStat.size > MAX_RESUME_ARTIFACT_BYTES || openedStat.dev !== artifactStat.dev || openedStat.ino !== artifactStat.ino || openedStat.dev !== currentStat.dev || openedStat.ino !== currentStat.ino) {
+            if (!openedStat.isFile() ||
+                openedStat.size > MAX_RESUME_ARTIFACT_BYTES ||
+                openedStat.dev !== artifactStat.dev ||
+                openedStat.ino !== artifactStat.ino ||
+                openedStat.dev !== currentStat.dev ||
+                openedStat.ino !== currentStat.ino) {
                 return null;
             }
             return readFully(fd, openedStat.size);
@@ -116,151 +124,27 @@ function readResumeArtifact(artifactWorkspacePath, sessionId, artifact) {
             closeSync(fd);
         }
     }
-    catch { // TODO(g2): legacy silent catch — grace: 1 minor release (v2.14.0)
-        return null;
-    }
-}
-function getExpectedResumeArtifactType(artifact) {
-    if (artifact.endsWith('/autonomous-goal-package.json'))
-        return 'goal-package';
-    if (artifact.endsWith('/autonomous-rd-plan.json'))
-        return 'rd-plan';
-    if (artifact.endsWith('/checkpoint-1.json'))
-        return 'checkpoint';
-    if (artifact.endsWith('/validation-report.md'))
-        return 'validation-report';
-    return 'resume-instructions';
-}
-function hasStringArray(value) {
-    return Array.isArray(value) && value.length > 0 && value.every((item) => typeof item === 'string' && item.trim().length > 0);
-}
-function hasValidGoalPackageJson(parsed, goal) {
-    return parsed.goal === goal
-        && typeof parsed.doneCondition === 'string'
-        && parsed.doneCondition.trim().length > 0
-        && typeof parsed.resumeCondition === 'string'
-        && parsed.resumeCondition.trim().length > 0
-        && hasStringArray(parsed.acceptanceCriteria);
-}
-function hasValidRdPlanJson(parsed) {
-    return parsed.workerQueueStatus === 'ready'
-        && typeof parsed.taskCount === 'number'
-        && Number.isInteger(parsed.taskCount)
-        && parsed.taskCount > 0
-        && parsed.reducerRequired === true;
-}
-function hasValidCheckpointJson(parsed) {
-    return parsed.checkpointId === 'checkpoint-1'
-        && typeof parsed.createdAt === 'string'
-        && parsed.createdAt.trim().length > 0
-        && isObjectRecord(parsed.workerQueueState)
-        && hasStringArray(parsed.validationRefs);
-}
-function parseJsonObject(content) {
-    try {
-        const parsed = JSON.parse(content);
-        return isObjectRecord(parsed) ? parsed : null;
-    }
-    catch { // TODO(g2): legacy silent catch — grace: 1 minor release (v2.14.0)
+    catch {
+        // TODO(g2): legacy silent catch — grace: 1 minor release (v2.14.0)
         return null;
     }
 }
-function hasValidJsonMetadata(content, sessionId, artifactType, goal) {
-    const parsed = parseJsonObject(content);
-    if (parsed === null || parsed.sessionId !== sessionId || parsed.artifactType !== artifactType || parsed.status !== 'ready') {
-        return false;
-    }
-    if (artifactType === 'goal-package')
-        return hasValidGoalPackageJson(parsed, goal);
-    if (artifactType === 'rd-plan')
-        return hasValidRdPlanJson(parsed);
-    return artifactType === 'checkpoint' && hasValidCheckpointJson(parsed);
-}
-function parseFrontMatter(content) {
-    const lines = content.split(/\r?\n/);
-    if (lines[0] !== '---') {
-        return null;
-    }
-    const closingDelimiterIndex = lines.slice(1).findIndex((line) => line === '---');
-    if (closingDelimiterIndex === -1) {
-        return null;
-    }
-    const metadata = new Map();
-    for (const line of lines.slice(1, closingDelimiterIndex + 1)) {
-        const separatorIndex = line.indexOf(':');
-        if (separatorIndex === -1) {
-            return null;
-        }
-        metadata.set(line.slice(0, separatorIndex).trim(), line.slice(separatorIndex + 1).trim());
-    }
-    return Object.fromEntries(metadata);
-}
-function getMarkdownBody(content) {
-    const lines = content.split(/\r?\n/);
-    const closingDelimiterIndex = lines.slice(1).findIndex((line) => line === '---');
-    return closingDelimiterIndex === -1 ? '' : lines.slice(closingDelimiterIndex + 2).join('\n');
-}
-function hasValidationReportBody(body) {
-    return body.includes('Validation summary:')
-        && body.includes('Checks:')
-        && body.includes('Result: passed')
-        && body.includes('Evidence refs:');
-}
-function hasResumeInstructionsBody(body) {
-    return body.includes('Resume steps:')
-        && body.includes('Preconditions:')
-        && body.includes('Blocked actions:')
-        && body.includes('Next actions:');
-}
-function extractMarkdownListSection(body, heading) {
-    const lines = body.split(/\r?\n/);
-    const startIndex = lines.findIndex((line) => line.trim() === heading);
-    if (startIndex === -1) {
-        return [];
-    }
-    const sectionLines = lines.slice(startIndex + 1);
-    const nextHeadingIndex = sectionLines.findIndex((line) => /^[A-Z][A-Za-z ]+:$/.test(line.trim()));
-    const sectionEndIndex = nextHeadingIndex + 1 || sectionLines.length;
-    return sectionLines.slice(0, sectionEndIndex)
-        .map((line) => line.trim())
-        .filter((line) => line.startsWith('- '))
-        .map((line) => line.slice(2).trim())
-        .filter((line) => line.length > 0);
-}
-function getCheckpointValidationRefs(checkpointContent) {
-    const parsed = parseJsonObject(checkpointContent);
-    return parsed && hasStringArray(parsed.validationRefs) ? parsed.validationRefs : [];
-}
 function isSafeEvidenceRef(ref) {
-    return ref.toLowerCase() !== 'validation-report.md' && /^[A-Za-z0-9][A-Za-z0-9._-]*\.md$/.test(ref) && !ref.includes('..');
+    return (ref.toLowerCase() !== 'validation-report.md' &&
+        /^[A-Za-z0-9][A-Za-z0-9._-]*\.md$/.test(ref) &&
+        !ref.includes('..'));
 }
 function evidenceRefsExist(artifactWorkspacePath, sessionId, refs) {
-    return refs.every((ref) => isSafeEvidenceRef(ref) && readResumeArtifact(artifactWorkspacePath, sessionId, `rd/swarm/evidence/${ref}`) !== null);
+    return refs.every((ref) => isSafeEvidenceRef(ref) &&
+        readResumeArtifact(artifactWorkspacePath, sessionId, `rd/swarm/evidence/${ref}`) !== null);
 }
 function hasMatchingEvidenceRefs(artifactWorkspacePath, sessionId, validationReportContent, checkpointContent) {
     const expectedRefs = getCheckpointValidationRefs(checkpointContent);
     const actualRefs = extractMarkdownListSection(getMarkdownBody(validationReportContent), 'Evidence refs:');
-    return expectedRefs.length > 0
-        && expectedRefs.length === actualRefs.length
-        && expectedRefs.every((expectedRef, index) => expectedRef === actualRefs[index])
-        && evidenceRefsExist(artifactWorkspacePath, sessionId, expectedRefs);
-}
-function hasValidMarkdownMetadata(content, sessionId, artifactType) {
-    const metadata = parseFrontMatter(content);
-    if (metadata === null || metadata.sessionId !== sessionId || metadata.artifactType !== artifactType || metadata.status !== 'passed') {
-        return false;
-    }
-    const body = getMarkdownBody(content);
-    return artifactType === 'validation-report' ? hasValidationReportBody(body) : hasResumeInstructionsBody(body);
-}
-function isValidResumeArtifact(artifact, content, sessionId, goal) {
-    if (!content.trim()) {
-        return false;
-    }
-    const artifactType = getExpectedResumeArtifactType(artifact);
-    return artifact.endsWith('.json')
-        ? hasValidJsonMetadata(content, sessionId, artifactType, goal)
-        : hasValidMarkdownMetadata(content, sessionId, artifactType);
+    return (expectedRefs.length > 0 &&
+        expectedRefs.length === actualRefs.length &&
+        expectedRefs.every((expectedRef, index) => expectedRef === actualRefs[index]) &&
+        evidenceRefsExist(artifactWorkspacePath, sessionId, expectedRefs));
 }
 function getResumeArtifactsStatus(artifactWorkspacePath, requiredArtifacts, sessionId, goal) {
     let hasInvalidArtifact = false;
@@ -282,7 +166,9 @@ function getResumeArtifactsStatus(artifactWorkspacePath, requiredArtifacts, sess
     }
     const checkpointContent = artifactContents.get('rd/swarm/checkpoints/checkpoint-1.json');
     const validationReportContent = artifactContents.get('rd/swarm/evidence/validation-report.md');
-    if (!checkpointContent || !validationReportContent || !hasMatchingEvidenceRefs(artifactWorkspacePath, sessionId, validationReportContent, checkpointContent)) {
+    if (!checkpointContent ||
+        !validationReportContent ||
+        !hasMatchingEvidenceRefs(artifactWorkspacePath, sessionId, validationReportContent, checkpointContent)) {
         hasInvalidArtifact = true;
     }
     return hasInvalidArtifact ? 'invalid' : 'ready';
@@ -291,7 +177,12 @@ export function createResumePlan(sessionId, ready) {
     const requiredArtifacts = getResumeRequiredArtifacts(sessionId);
     return {
         status: ready ? 'ready' : 'preview',
-        checkpoints: ['goal-package-created', 'capabilities-planned', 'rd-swarm-planned', 'validation-evidence-required'],
+        checkpoints: [
+            'goal-package-created',
+            'capabilities-planned',
+            'rd-swarm-planned',
+            'validation-evidence-required'
+        ],
         requiredArtifacts,
         resumeInstructions: ready
             ? 'Before continuing, verify checkpoint artifacts, pending worker queue state, and validation evidence requirements.'

package/dist/services/workflow/workflow-autonomous-resume-validation.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Workflow Autonomous Service -- resume artifact content validators.
+ *
+ * This module is the extracted validation sub-tree of
+ * `workflow-autonomous-resume-helpers.ts` (B wave-3 file-size split).
+ * It hosts the pure JSON / front-matter / markdown-body checks
+ * (`isValidResumeArtifact`, `getCheckpointValidationRefs`,
+ * `getMarkdownBody`, `extractMarkdownListSection` and their private
+ * helpers). Function bodies and behaviour are unchanged (verbatim
+ * move); the I/O-bound `readResumeArtifact` pipeline stays in the
+ * sibling module.
+ */
+export declare function getMarkdownBody(content: string): string;
+export declare function extractMarkdownListSection(body: string, heading: string): string[];
+export declare function getCheckpointValidationRefs(checkpointContent: string): string[];
+export declare function isValidResumeArtifact(artifact: string, content: string, sessionId: string, goal: string): boolean;

package/dist/services/workflow/workflow-autonomous-resume-validation.js

@@ -0,0 +1,155 @@
+/**
+ * Workflow Autonomous Service -- resume artifact content validators.
+ *
+ * This module is the extracted validation sub-tree of
+ * `workflow-autonomous-resume-helpers.ts` (B wave-3 file-size split).
+ * It hosts the pure JSON / front-matter / markdown-body checks
+ * (`isValidResumeArtifact`, `getCheckpointValidationRefs`,
+ * `getMarkdownBody`, `extractMarkdownListSection` and their private
+ * helpers). Function bodies and behaviour are unchanged (verbatim
+ * move); the I/O-bound `readResumeArtifact` pipeline stays in the
+ * sibling module.
+ */
+function isObjectRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function getExpectedResumeArtifactType(artifact) {
+    if (artifact.endsWith('/autonomous-goal-package.json'))
+        return 'goal-package';
+    if (artifact.endsWith('/autonomous-rd-plan.json'))
+        return 'rd-plan';
+    if (artifact.endsWith('/checkpoint-1.json'))
+        return 'checkpoint';
+    if (artifact.endsWith('/validation-report.md'))
+        return 'validation-report';
+    return 'resume-instructions';
+}
+function hasStringArray(value) {
+    return (Array.isArray(value) &&
+        value.length > 0 &&
+        value.every((item) => typeof item === 'string' && item.trim().length > 0));
+}
+function hasValidGoalPackageJson(parsed, goal) {
+    return (parsed.goal === goal &&
+        typeof parsed.doneCondition === 'string' &&
+        parsed.doneCondition.trim().length > 0 &&
+        typeof parsed.resumeCondition === 'string' &&
+        parsed.resumeCondition.trim().length > 0 &&
+        hasStringArray(parsed.acceptanceCriteria));
+}
+function hasValidRdPlanJson(parsed) {
+    return (parsed.workerQueueStatus === 'ready' &&
+        typeof parsed.taskCount === 'number' &&
+        Number.isInteger(parsed.taskCount) &&
+        parsed.taskCount > 0 &&
+        parsed.reducerRequired === true);
+}
+function hasValidCheckpointJson(parsed) {
+    return (parsed.checkpointId === 'checkpoint-1' &&
+        typeof parsed.createdAt === 'string' &&
+        parsed.createdAt.trim().length > 0 &&
+        isObjectRecord(parsed.workerQueueState) &&
+        hasStringArray(parsed.validationRefs));
+}
+function parseJsonObject(content) {
+    try {
+        const parsed = JSON.parse(content);
+        return isObjectRecord(parsed) ? parsed : null;
+    }
+    catch {
+        // TODO(g2): legacy silent catch — grace: 1 minor release (v2.14.0)
+        return null;
+    }
+}
+function hasValidJsonMetadata(content, sessionId, artifactType, goal) {
+    const parsed = parseJsonObject(content);
+    if (parsed === null ||
+        parsed.sessionId !== sessionId ||
+        parsed.artifactType !== artifactType ||
+        parsed.status !== 'ready') {
+        return false;
+    }
+    if (artifactType === 'goal-package')
+        return hasValidGoalPackageJson(parsed, goal);
+    if (artifactType === 'rd-plan')
+        return hasValidRdPlanJson(parsed);
+    return artifactType === 'checkpoint' && hasValidCheckpointJson(parsed);
+}
+function parseFrontMatter(content) {
+    const lines = content.split(/\r?\n/);
+    if (lines[0] !== '---') {
+        return null;
+    }
+    const closingDelimiterIndex = lines.slice(1).findIndex((line) => line === '---');
+    if (closingDelimiterIndex === -1) {
+        return null;
+    }
+    const metadata = new Map();
+    for (const line of lines.slice(1, closingDelimiterIndex + 1)) {
+        const separatorIndex = line.indexOf(':');
+        if (separatorIndex === -1) {
+            return null;
+        }
+        metadata.set(line.slice(0, separatorIndex).trim(), line.slice(separatorIndex + 1).trim());
+    }
+    return Object.fromEntries(metadata);
+}
+export function getMarkdownBody(content) {
+    const lines = content.split(/\r?\n/);
+    const closingDelimiterIndex = lines.slice(1).findIndex((line) => line === '---');
+    return closingDelimiterIndex === -1 ? '' : lines.slice(closingDelimiterIndex + 2).join('\n');
+}
+function hasValidationReportBody(body) {
+    return (body.includes('Validation summary:') &&
+        body.includes('Checks:') &&
+        body.includes('Result: passed') &&
+        body.includes('Evidence refs:'));
+}
+function hasResumeInstructionsBody(body) {
+    return (body.includes('Resume steps:') &&
+        body.includes('Preconditions:') &&
+        body.includes('Blocked actions:') &&
+        body.includes('Next actions:'));
+}
+export function extractMarkdownListSection(body, heading) {
+    const lines = body.split(/\r?\n/);
+    const startIndex = lines.findIndex((line) => line.trim() === heading);
+    if (startIndex === -1) {
+        return [];
+    }
+    const sectionLines = lines.slice(startIndex + 1);
+    const nextHeadingIndex = sectionLines.findIndex((line) => /^[A-Z][A-Za-z ]+:$/.test(line.trim()));
+    const sectionEndIndex = nextHeadingIndex + 1 || sectionLines.length;
+    return sectionLines
+        .slice(0, sectionEndIndex)
+        .map((line) => line.trim())
+        .filter((line) => line.startsWith('- '))
+        .map((line) => line.slice(2).trim())
+        .filter((line) => line.length > 0);
+}
+export function getCheckpointValidationRefs(checkpointContent) {
+    const parsed = parseJsonObject(checkpointContent);
+    return parsed && hasStringArray(parsed.validationRefs) ? parsed.validationRefs : [];
+}
+function hasValidMarkdownMetadata(content, sessionId, artifactType) {
+    const metadata = parseFrontMatter(content);
+    if (metadata === null ||
+        metadata.sessionId !== sessionId ||
+        metadata.artifactType !== artifactType ||
+        metadata.status !== 'passed') {
+        return false;
+    }
+    const body = getMarkdownBody(content);
+    return artifactType === 'validation-report'
+        ? hasValidationReportBody(body)
+        : hasResumeInstructionsBody(body);
+}
+export function isValidResumeArtifact(artifact, content, sessionId, goal) {
+    if (!content.trim()) {
+        return false;
+    }
+    const artifactType = getExpectedResumeArtifactType(artifact);
+    return artifact.endsWith('.json')
+        ? hasValidJsonMetadata(content, sessionId, artifactType, goal)
+        : hasValidMarkdownMetadata(content, sessionId, artifactType);
+}

package/dist/services/workflow/workflow-autonomous-service.js

@@ -39,10 +39,13 @@ function normalizeGoal(goal) {
     return normalized;
 }
 function resolveArtifactWorkspacePath(request) {
-    return request.artifactWorkspacePath ?? (request.workspace ? getLocalArtifactPath(request.workspace) : undefined);
+    return (request.artifactWorkspacePath ??
+        (request.workspace ? getLocalArtifactPath(request.workspace) : undefined));
 }
 function hasArtifactWorkspace(request, artifactWorkspacePath) {
-    return !!request.workspace && !!artifactWorkspacePath && hasValidArtifactWorkspace(request.workspace, artifactWorkspacePath);
+    return (!!request.workspace &&
+        !!artifactWorkspacePath &&
+        hasValidArtifactWorkspace(request.workspace, artifactWorkspacePath));
 }
 function createGoalPackage(sessionId, goal) {
     return {
@@ -95,14 +98,14 @@ function getCapabilityTrustLevel(sourceId) {
     if (sourceId === 'skills/*/SKILL.md' || sourceId === 'local-peaks-skills') {
         return 'local';
     }
-    if (sourceId.startsWith('everything-claude-code')
-        || sourceId.startsWith('ruflo-')
-        || sourceId === 'superpowers'
-        || sourceId === 'openspec'
-        || sourceId === 'gstack'
-        || sourceId === 'impeccable'
-        || sourceId === 'andrej-karpathy-skills'
-        || sourceId === 'mattpocock-skills') {
+    if (sourceId.startsWith('everything-claude-code') ||
+        sourceId.startsWith('ruflo-') ||
+        sourceId === 'superpowers' ||
+        sourceId === 'openspec' ||
+        sourceId === 'gstack' ||
+        sourceId === 'impeccable' ||
+        sourceId === 'andrej-karpathy-skills' ||
+        sourceId === 'mattpocock-skills') {
         return 'user-curated';
     }
     return 'third-party';
@@ -160,7 +163,9 @@ function getCapabilityActivation(status, itemType) {
     }
 }
 function createCapabilityPlan(request) {
-    const catalogPlan = createCapabilityMapPlan({ installedCapabilityIds: request.workspace?.installedCapabilityIds ?? [] });
+    const catalogPlan = createCapabilityMapPlan({
+        installedCapabilityIds: request.workspace?.installedCapabilityIds ?? []
+    });
     const surfaceSummary = createCapabilitySurfaceSummary();
     const candidates = catalogPlan.items.map((item) => {
         const surface = getCapabilitySurface(item.itemType);
@@ -191,7 +196,12 @@ function createCapabilityPlan(request) {
     });
     surfaceSummary.skill += 1;
     return {
-        sources: uniqueStrings(['docs/accessRepo.md', 'docs/mcpServer.md', 'skills/*/SKILL.md', ...catalogPlan.sources.map((source) => source.sourceId)]),
+        sources: uniqueStrings([
+            'docs/accessRepo.md',
+            'docs/mcpServer.md',
+            'skills/*/SKILL.md',
+            ...catalogPlan.sources.map((source) => source.sourceId)
+        ]),
         policy: [
             'reuse-curated-capabilities-before-custom-build',
             'plan-capability-use-before-activation',
@@ -231,7 +241,9 @@ export function createAutonomousWorkflowPlan(request) {
     const goal = normalizeGoal(request.goal);
     const maxWorkers = request.maxWorkers ?? 40;
     const artifactWorkspacePath = resolveArtifactWorkspacePath(request);
-    const memoryBackupPath = artifactWorkspacePath ? join(artifactWorkspacePath, '.peaks', 'memory-backups', 'project-memory-primary') : null;
+    const memoryBackupPath = artifactWorkspacePath
+        ? join(artifactWorkspacePath, '.peaks', 'memory-backups', 'project-memory-primary')
+        : null;
     const sharedWorkspaceOptions = {
         ...(artifactWorkspacePath ? { artifactWorkspacePath } : {}),
         ...(request.workspace ? { workspace: request.workspace } : {})

package/dist/services/workflow/workflow-graph-store-helpers.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Workflow graph store helpers (B wave-3 file-size split).
+ *
+ * Extracted verbatim from `workflow-graph-store.ts`: the canonical
+ * `PEAKS_*` error-code constants, the `GraphStoreError` shape +
+ * `makeError` factory, the session-root/path resolution helpers, the
+ * cycle detector, and the fresh-graph builder. The on-disk graph
+ * record layout is defined by `workflow-graph-types.ts` and is NOT
+ * altered by this move — `emptyGraph` emits the identical node/edge
+ * shape as before. `workflow-graph-store.ts` re-exports every public
+ * name from this module so all importers keep resolving the same path.
+ */
+import { type WorkflowGraph, type WorkflowGraphNode, type WorkflowId } from './workflow-graph-types.js';
+export declare const PEAKS_GRAPH_NOT_FOUND = "PEAKS_GRAPH_NOT_FOUND";
+export declare const PEAKS_GRAPH_CORRUPTED = "PEAKS_GRAPH_CORRUPTED";
+export declare const PEAKS_GRAPH_CYCLE = "PEAKS_GRAPH_CYCLE";
+export declare const PEAKS_GRAPH_REF_BROKEN = "PEAKS_GRAPH_REF_BROKEN";
+export declare const PEAKS_GRAPH_NODE_REQUIRED = "PEAKS_GRAPH_NODE_REQUIRED";
+export declare const PEAKS_GRAPH_NODE_NOT_PREPARED = "PEAKS_GRAPH_NODE_NOT_PREPARED";
+export declare const PEAKS_GRAPH_NODE_KIND_INVALID = "PEAKS_GRAPH_NODE_KIND_INVALID";
+export declare const PEAKS_NODE_EXISTS = "PEAKS_NODE_EXISTS";
+export declare const PEAKS_NODE_TRANSITION_INVALID = "PEAKS_NODE_TRANSITION_INVALID";
+export declare const PEAKS_ENVELOPE_NOT_RECEIVED = "PEAKS_ENVELOPE_NOT_RECEIVED";
+export declare const PEAKS_ENVELOPE_GRAPH_MISMATCH = "PEAKS_ENVELOPE_GRAPH_MISMATCH";
+export declare const PEAKS_TERMINAL_REASON_INVALID = "PEAKS_TERMINAL_REASON_INVALID";
+export declare const PEAKS_TERMINALIZE_ATOMICITY_FAILED = "PEAKS_TERMINALIZE_ATOMICITY_FAILED";
+export declare const PEAKS_UNCONSUMED_ENVELOPE = "PEAKS_UNCONSUMED_ENVELOPE";
+export declare const PEAKS_DEPENDENCY_NOT_CONSUMED = "PEAKS_DEPENDENCY_NOT_CONSUMED";
+export declare const PEAKS_WORKFLOW_OWNS_PRESENCE_CLEAR = "PEAKS_WORKFLOW_OWNS_PRESENCE_CLEAR";
+export declare const PEAKS_SESSION_NOT_BOUND = "PEAKS_SESSION_NOT_BOUND";
+export declare const PEAKS_CALLER_NOT_RESOLVED = "PEAKS_CALLER_NOT_RESOLVED";
+export interface GraphStoreError extends Error {
+    readonly code: string;
+    readonly legacyFallback: boolean;
+}
+export declare function makeError(code: string, message: string, legacyFallback?: boolean): GraphStoreError;
+/** Compute the on-disk graph path. Validates `graphRef` stays under the session root. */
+export declare function graphPathFor(input: {
+    projectRoot: string;
+    sessionId: string;
+    graphRef: string;
+    workflowId: WorkflowId;
+}): string;
+/** Detect cycles in a node-dependency graph. */
+export declare function detectCycle(nodes: readonly WorkflowGraphNode[]): boolean;
+/** Build a fresh empty graph with one terminal node. */
+export declare function emptyGraph(input: {
+    workflowId: WorkflowId;
+    rootSkill: string;
+    parentWorkflowId?: WorkflowId;
+}): WorkflowGraph;

package/dist/services/workflow/workflow-graph-store-helpers.js

@@ -0,0 +1,111 @@
+/**
+ * Workflow graph store helpers (B wave-3 file-size split).
+ *
+ * Extracted verbatim from `workflow-graph-store.ts`: the canonical
+ * `PEAKS_*` error-code constants, the `GraphStoreError` shape +
+ * `makeError` factory, the session-root/path resolution helpers, the
+ * cycle detector, and the fresh-graph builder. The on-disk graph
+ * record layout is defined by `workflow-graph-types.ts` and is NOT
+ * altered by this move — `emptyGraph` emits the identical node/edge
+ * shape as before. `workflow-graph-store.ts` re-exports every public
+ * name from this module so all importers keep resolving the same path.
+ */
+import { join, resolve, sep } from 'node:path';
+import { WORKFLOW_ID_REGEX, isSafeRelativeGraphRef } from './workflow-graph-types.js';
+export const PEAKS_GRAPH_NOT_FOUND = 'PEAKS_GRAPH_NOT_FOUND';
+export const PEAKS_GRAPH_CORRUPTED = 'PEAKS_GRAPH_CORRUPTED';
+export const PEAKS_GRAPH_CYCLE = 'PEAKS_GRAPH_CYCLE';
+export const PEAKS_GRAPH_REF_BROKEN = 'PEAKS_GRAPH_REF_BROKEN';
+export const PEAKS_GRAPH_NODE_REQUIRED = 'PEAKS_GRAPH_NODE_REQUIRED';
+export const PEAKS_GRAPH_NODE_NOT_PREPARED = 'PEAKS_GRAPH_NODE_NOT_PREPARED';
+export const PEAKS_GRAPH_NODE_KIND_INVALID = 'PEAKS_GRAPH_NODE_KIND_INVALID';
+export const PEAKS_NODE_EXISTS = 'PEAKS_NODE_EXISTS';
+export const PEAKS_NODE_TRANSITION_INVALID = 'PEAKS_NODE_TRANSITION_INVALID';
+export const PEAKS_ENVELOPE_NOT_RECEIVED = 'PEAKS_ENVELOPE_NOT_RECEIVED';
+export const PEAKS_ENVELOPE_GRAPH_MISMATCH = 'PEAKS_ENVELOPE_GRAPH_MISMATCH';
+export const PEAKS_TERMINAL_REASON_INVALID = 'PEAKS_TERMINAL_REASON_INVALID';
+export const PEAKS_TERMINALIZE_ATOMICITY_FAILED = 'PEAKS_TERMINALIZE_ATOMICITY_FAILED';
+export const PEAKS_UNCONSUMED_ENVELOPE = 'PEAKS_UNCONSUMED_ENVELOPE';
+export const PEAKS_DEPENDENCY_NOT_CONSUMED = 'PEAKS_DEPENDENCY_NOT_CONSUMED';
+export const PEAKS_WORKFLOW_OWNS_PRESENCE_CLEAR = 'PEAKS_WORKFLOW_OWNS_PRESENCE_CLEAR';
+export const PEAKS_SESSION_NOT_BOUND = 'PEAKS_SESSION_NOT_BOUND';
+export const PEAKS_CALLER_NOT_RESOLVED = 'PEAKS_CALLER_NOT_RESOLVED';
+export function makeError(code, message, legacyFallback = false) {
+    const err = new Error(message);
+    err.name = 'GraphStoreError';
+    err.code = code;
+    err.legacyFallback = legacyFallback;
+    return err;
+}
+function safeSessionRuntimeRoot(projectRoot, sessionId) {
+    if (!WORKFLOW_ID_REGEX.test(sessionId)) {
+        throw makeError(PEAKS_GRAPH_REF_BROKEN, `invalid sessionId: ${sessionId}`);
+    }
+    const root = resolve(projectRoot);
+    return join(root, '.peaks', '_runtime', sessionId);
+}
+/** Compute the on-disk graph path. Validates `graphRef` stays under the session root. */
+export function graphPathFor(input) {
+    if (!isSafeRelativeGraphRef(input.graphRef, input.workflowId)) {
+        throw makeError(PEAKS_GRAPH_REF_BROKEN, `graphRef is not safe: ${input.graphRef}`);
+    }
+    if (!WORKFLOW_ID_REGEX.test(input.workflowId)) {
+        throw makeError(PEAKS_GRAPH_REF_BROKEN, `workflowId is not safe: ${input.workflowId}`);
+    }
+    const sessionRoot = safeSessionRuntimeRoot(input.projectRoot, input.sessionId);
+    const resolved = resolve(sessionRoot, input.graphRef);
+    if (!resolved.startsWith(sessionRoot + sep) && resolved !== sessionRoot) {
+        throw makeError(PEAKS_GRAPH_REF_BROKEN, `graphRef escapes session root: ${input.graphRef}`);
+    }
+    return resolved;
+}
+/** Detect cycles in a node-dependency graph. */
+export function detectCycle(nodes) {
+    const map = new Map();
+    for (const n of nodes)
+        map.set(n.id, n);
+    const color = new Map();
+    const visiting = (id) => {
+        const c = color.get(id) ?? 0;
+        if (c === 1)
+            return true;
+        if (c === 2)
+            return false;
+        color.set(id, 1);
+        const node = map.get(id);
+        if (node) {
+            for (const dep of node.dependsOn) {
+                if (visiting(dep))
+                    return true;
+            }
+        }
+        color.set(id, 2);
+        return false;
+    };
+    for (const n of nodes) {
+        if (visiting(n.id))
+            return true;
+    }
+    return false;
+}
+/** Build a fresh empty graph with one terminal node. */
+export function emptyGraph(input) {
+    const graph = {
+        workflowId: input.workflowId,
+        rootSkill: input.rootSkill,
+        ...(input.parentWorkflowId ? { parentWorkflowId: input.parentWorkflowId } : {}),
+        nodes: [
+            {
+                id: 'terminal',
+                kind: 'terminal',
+                label: 'workflow complete',
+                status: 'prepared',
+                dependsOn: [],
+                ackStatus: 'not-required'
+            }
+        ],
+        edges: [],
+        schemaVersion: 1
+    };
+    return graph;
+}