peaks-loop 4.0.54 → 4.1.1

package/dist/services/sop/gate-enforce-service.js

@@ -89,7 +89,9 @@ export function recordGateBypass(projectRoot, sopId, phase, reason) {
 }
 function denyReason(matched) {
     const lines = matched.map((m) => {
-        const gates = m.failing.map((g) => `${g.gateId}=${g.result}${g.reason ? ` (${g.reason})` : ''}`).join(', ');
+        const gates = m.failing
+            .map((g) => `${g.gateId}=${g.result}${g.reason ? ` (${g.reason})` : ''}`)
+            .join(', ');
         return `SOP "${m.sopId}" phase "${m.phase}": ${gates}`;
     });
     const hint = matched
@@ -111,7 +113,12 @@ export async function enforceBashCommand(projectRoot, command) {
         sopIds = (await readRegistry(projectRoot)).sops.map((sop) => sop.id);
     }
     catch (error) {
-        return { decision: 'allow', warnings: [`gate enforce: could not read registry (${error instanceof Error ? error.message : 'error'}); allowing`] };
+        return {
+            decision: 'allow',
+            warnings: [
+                `gate enforce: could not read registry (${error instanceof Error ? error.message : 'error'}); allowing`
+            ]
+        };
     }
     const matched = [];
     for (const sopId of sopIds) {

package/dist/services/sop/sop-advance-service.js

@@ -98,7 +98,13 @@ export async function advanceSop(options) {
     }
     const bypassed = options.allowIncomplete === true;
     if (options.dryRun === true) {
-        return { id: options.id, phase: options.toPhase, bypassed, previousPhase: previous.currentPhase, applied: false };
+        return {
+            id: options.id,
+            phase: options.toPhase,
+            bypassed,
+            previousPhase: previous.currentPhase,
+            applied: false
+        };
     }
     const entry = options.reason === undefined
         ? { phase: options.toPhase, bypassed }
@@ -110,6 +116,12 @@ export async function advanceSop(options) {
     const path = sopStatePath(options.projectRoot, options.id);
     await mkdir(dirname(path), { recursive: true });
     await writeFile(path, `${JSON.stringify(nextState, null, 2)}\n`, 'utf8');
-    return { id: options.id, phase: options.toPhase, bypassed, previousPhase: previous.currentPhase, applied: true };
+    return {
+        id: options.id,
+        phase: options.toPhase,
+        bypassed,
+        previousPhase: previous.currentPhase,
+        applied: true
+    };
 }
 export { EMPTY_STATE };

package/dist/services/sop/sop-check-service.js

@@ -38,7 +38,9 @@ function evaluateFileExists(projectRoot, path) {
     if (resolved === null) {
         return { result: 'blocked', reason: `path "${path}" escapes the project root` };
     }
-    return existsSync(resolved) ? { result: 'pass' } : { result: 'fail', reason: `file "${path}" does not exist` };
+    return existsSync(resolved)
+        ? { result: 'pass' }
+        : { result: 'fail', reason: `file "${path}" does not exist` };
 }
 function evaluateGrep(projectRoot, file, pattern, absent, stripMeta) {
     const resolved = resolveInsideProject(projectRoot, file);
@@ -142,12 +144,17 @@ function evaluateCommand(projectRoot, run, expectExitZero, allowCommands, timeou
             exitCode = err.status;
         }
         else {
-            return { result: 'blocked', reason: `command could not be run (${String(err.code ?? 'spawn error')})` };
+            return {
+                result: 'blocked',
+                reason: `command could not be run (${String(err.code ?? 'spawn error')})`
+            };
         }
     }
     const zero = exitCode === 0;
     const pass = expectExitZero ? zero : !zero;
-    return pass ? { result: 'pass' } : { result: 'fail', reason: `command exited ${exitCode} (expectExitZero=${expectExitZero})` };
+    return pass
+        ? { result: 'pass' }
+        : { result: 'fail', reason: `command exited ${exitCode} (expectExitZero=${expectExitZero})` };
 }
 function evaluateCheck(projectRoot, check, allowCommands, timeoutMs) {
     switch (check.type) {
@@ -184,7 +191,12 @@ export async function checkGate(options) {
         evaluateOptions.commandTimeoutMs = options.commandTimeoutMs;
     }
     const verdict = evaluateGate(options.projectRoot, gate, evaluateOptions);
-    const result = { id: options.id, gateId: gate.id, phase: gate.phase, result: verdict.result };
+    const result = {
+        id: options.id,
+        gateId: gate.id,
+        phase: gate.phase,
+        result: verdict.result
+    };
     if (verdict.reason !== undefined) {
         result.reason = verdict.reason;
     }

package/dist/services/sop/sop-paths.js

@@ -4,7 +4,9 @@ import { join, resolve } from 'node:path';
 /** Global Peaks home (`~/.peaks`), overridable via PEAKS_HOME for test isolation. */
 export function peaksHome() {
     const override = process.env.PEAKS_HOME;
-    return override !== undefined && override.length > 0 ? resolve(override) : join(homedir(), '.peaks');
+    return override !== undefined && override.length > 0
+        ? resolve(override)
+        : join(homedir(), '.peaks');
 }
 /** Global SOP definition directory: `~/.peaks/sops/<id>`. */
 export function sopDir(id) {

package/dist/services/sop/sop-registry-service.js

@@ -73,7 +73,11 @@ export async function registerSop(options) {
         phase: gate.phase,
         transition: `${manifest.id}:${gate.phase}`
     }));
-    const registered = { id: manifest.id, path: relativeManifestPath(manifest.id), gates };
+    const registered = {
+        id: manifest.id,
+        path: relativeManifestPath(manifest.id),
+        gates
+    };
     // Upsert within the SAME layer's registry (not the merged view).
     const current = await readRegistryAt(scope, options.projectRoot);
     const others = current.filter((sop) => sop.id !== manifest.id);

package/dist/services/sop/sop-service.js

@@ -76,8 +76,12 @@ export async function initSop(options) {
     }
     const inProject = options.projectRoot !== undefined;
     const dir = inProject ? projectSopDir(options.projectRoot, options.id) : sopDir(options.id);
-    const manifestPath = inProject ? projectSopManifestPath(options.projectRoot, options.id) : sopManifestPath(options.id);
-    const skillPath = inProject ? projectSopSkillPath(options.projectRoot, options.id) : sopSkillPath(options.id);
+    const manifestPath = inProject
+        ? projectSopManifestPath(options.projectRoot, options.id)
+        : sopManifestPath(options.id);
+    const skillPath = inProject
+        ? projectSopSkillPath(options.projectRoot, options.id)
+        : sopSkillPath(options.id);
     if (existsSync(manifestPath)) {
         throw new Error(`A SOP with id "${options.id}" already exists at ${manifestPath}. Remove it before re-running peaks sop init.`);
     }
@@ -101,7 +105,9 @@ export async function initSop(options) {
     return { ...result, applied: true };
 }
 function pushError(findings, code, message, gateId) {
-    findings.push(gateId === undefined ? { code, message, severity: 'error' } : { code, message, gateId, severity: 'error' });
+    findings.push(gateId === undefined
+        ? { code, message, severity: 'error' }
+        : { code, message, gateId, severity: 'error' });
 }
 function lintGate(gate, index, phases, seenGateIds, allowCommands, findings) {
     const label = typeof gate?.id === 'string' && gate.id.length > 0 ? gate.id : `#${index}`;
@@ -118,18 +124,26 @@ function lintGate(gate, index, phases, seenGateIds, allowCommands, findings) {
         pushError(findings, 'GATE_PHASE_UNKNOWN', `Gate "${gate.id}" binds to unknown phase "${String(gate.phase)}"`, gate.id);
     }
     const check = gate.check;
-    if (check === null || typeof check !== 'object' || !SOP_GATE_CHECK_TYPES.includes(check.type ?? '')) {
+    if (check === null ||
+        typeof check !== 'object' ||
+        !SOP_GATE_CHECK_TYPES.includes(check.type ?? '')) {
         pushError(findings, 'INVALID_CHECK_TYPE', `Gate "${gate.id}" has an invalid or missing check type (expected ${SOP_GATE_CHECK_TYPES.join(' | ')})`, gate.id);
         return;
     }
     if (check.type === 'file-exists' && (typeof check.path !== 'string' || check.path.length === 0)) {
         pushError(findings, 'CHECK_MISSING_FIELD', `Gate "${gate.id}" file-exists check requires a non-empty "path"`, gate.id);
     }
-    if (check.type === 'grep' && (typeof check.file !== 'string' || check.file.length === 0 || typeof check.pattern !== 'string' || check.pattern.length === 0)) {
+    if (check.type === 'grep' &&
+        (typeof check.file !== 'string' ||
+            check.file.length === 0 ||
+            typeof check.pattern !== 'string' ||
+            check.pattern.length === 0)) {
         pushError(findings, 'CHECK_MISSING_FIELD', `Gate "${gate.id}" grep check requires non-empty "file" and "pattern"`, gate.id);
     }
     if (check.type === 'command') {
-        if (!Array.isArray(check.run) || check.run.length === 0 || !check.run.every((part) => typeof part === 'string')) {
+        if (!Array.isArray(check.run) ||
+            check.run.length === 0 ||
+            !check.run.every((part) => typeof part === 'string')) {
             pushError(findings, 'CHECK_MISSING_FIELD', `Gate "${gate.id}" command check requires a non-empty string array "run"`, gate.id);
         }
         if (!allowCommands) {
@@ -171,7 +185,15 @@ export async function lintSop(options) {
     }
     catch (error) {
         pushError(findings, 'INVALID_JSON', `Manifest is not valid JSON: ${error instanceof Error ? error.message : 'parse error'}`);
-        return { ok: false, id: options.id, manifestPath, gateCount: 0, gateIds: [], findings, warnings };
+        return {
+            ok: false,
+            id: options.id,
+            manifestPath,
+            gateCount: 0,
+            gateIds: [],
+            findings,
+            warnings
+        };
     }
     if (typeof manifest.id !== 'string' || !SOP_ID_PATTERN.test(manifest.id)) {
         pushError(findings, 'INVALID_ID', `Manifest id "${String(manifest.id)}" is invalid (expected lowercase kebab)`);

package/dist/services/sop/sop-types.js

@@ -6,6 +6,10 @@
  * later metering layer (Feature B) can count them; Slice 1 only models and
  * validates them — no registry, no enforcement.
  */
-export const SOP_GATE_CHECK_TYPES = ['file-exists', 'grep', 'command'];
+export const SOP_GATE_CHECK_TYPES = [
+    'file-exists',
+    'grep',
+    'command'
+];
 /** SOP id grammar: lowercase kebab, must start alphanumeric. */
 export const SOP_ID_PATTERN = /^[a-z0-9][a-z0-9-]*$/;

package/dist/services/standards/ide-aware-standards-service.js

@@ -1,5 +1,5 @@
-import { detectAllResourceTargets, getStandardsProfile, } from '../ide/resource-profile.js';
-import { executeProjectStandardsInit, executeProjectStandardsUpdate, } from './project-standards-service.js';
+import { detectAllResourceTargets, getStandardsProfile } from '../ide/resource-profile.js';
+import { executeProjectStandardsInit, executeProjectStandardsUpdate } from './project-standards-service.js';
 import { detectInstalledIde } from '../ide/ide-detector.js';
 function warnUnregisteredIde(ideId, projectRoot) {
     process.stderr.write(`peaks standards: IDE '${ideId}' has no standardsProfile declared; ` +

package/dist/services/standards/loop-engineering-lint.js

@@ -34,13 +34,13 @@ export const EXPECTED_RED_LINE_IDS = [
     // short of the file it was supposed to police. The file's own footer said
     // "Total red lines: 9 (RL-0..RL-9)" while RL-10 sat below it — the two
     // statements contradicted each other and only the file was ever read.
-    'RL-10',
+    'RL-10'
 ];
 export const REQUIRED_SECTIONS = [
     'Failure modes',
     'Rewrite',
     'Self-check',
-    'Out-of-scope',
+    'Out-of-scope'
 ];
 const RED_LINE_HEADING = /^##\s+(RL-\d+)\s+[—-]\s+(.+?)\s*$/gm;
 const SECTION_HEADING = /^##\s+(Failure modes|Rewrite|Self-check|Out-of-scope)\s*$/gm;
@@ -76,7 +76,12 @@ function parseRedLines(raw) {
     const headings = [];
     let m;
     while ((m = headingRegex.exec(raw)) !== null) {
-        headings.push({ id: m[1] ?? '', title: m[2] ?? '', start: m.index + m[0].length, end: raw.length });
+        headings.push({
+            id: m[1] ?? '',
+            title: m[2] ?? '',
+            start: m.index + m[0].length,
+            end: raw.length
+        });
     }
     for (let i = 0; i < headings.length - 1; i++) {
         headings[i].end = headings[i + 1].start;
@@ -94,14 +99,16 @@ function parseRedLines(raw) {
         }
         for (let i = 0; i < sectionMatches.length; i++) {
             const start = sectionMatches[i].start;
-            const end = i + 1 < sectionMatches.length ? sectionMatches[i + 1].start - sectionMatches[i].start : body.length - start;
+            const end = i + 1 < sectionMatches.length
+                ? sectionMatches[i + 1].start - sectionMatches[i].start
+                : body.length - start;
             const text = body.slice(start, start + end);
             sections[sectionMatches[i].name] = text;
         }
         return {
             id: h.id,
             title: h.title,
-            sections,
+            sections
         };
     });
 }

package/dist/services/standards/loop-engineering-readiness-lint.js

@@ -59,7 +59,7 @@
  * with a slash prefix and sometimes without. We accept both.
  */
 export const LOOP_ENGINEERING_GUIDELINE_PATHS = [
-    '.peaks/standards/loop-engineering-guidelines.md',
+    '.peaks/standards/loop-engineering-guidelines.md'
 ];
 /**
  * The allowlist of CLI verbs that a peaks-* SKILL.md may legitimately
@@ -111,7 +111,7 @@ export const ALLOWED_CLI_VERBS = new Set([
     'lint',
     'standards',
     'skill',
-    'ready',
+    'ready'
 ]);
 /**
  * Phrases that constitute a JSON / manifest hand-authoring surface.
@@ -139,7 +139,7 @@ export const JSON_HAND_AUTHORING_PHRASES = [
     'open the manifest and',
     'open the manifest.json and',
     'manually edit the manifest',
-    'manually edit the json',
+    'manually edit the json'
 ];
 /**
  * Phrases that explicitly reference a JSON / manifest surface but
@@ -162,7 +162,7 @@ export const JSON_REFERENCE_ALLOWLIST = [
     'schema_version',
     'peaks.bundle/1',
     'peaks.loop/1',
-    'peaks.bee/1',
+    'peaks.bee/1'
 ];
 // ---------------------------------------------------------------------------
 // Pure function
@@ -178,7 +178,7 @@ export function lintSkillLoopEngineeringReadiness(skillMdText) {
     if (typeof skillMdText !== 'string' || skillMdText.trim().length === 0) {
         return {
             ok: false,
-            findings: ['skill-md-empty: SKILL.md text is empty or missing'],
+            findings: ['skill-md-empty: SKILL.md text is empty or missing']
         };
     }
     checkGuidelineReference(skillMdText, findings);

package/dist/services/standards/migrate-claude-rules-service.js

@@ -85,17 +85,17 @@ const CANONICAL_2_0_COMMON_FILES = [
     { relPath: 'common/dev-preference.md', content: CANONICAL_2_0_DEV_PREFERENCE },
     {
         relPath: 'common/coding-style.md',
-        content: '# Coding Standards (2.0 canonical)\n\n- Prefer simple, readable code over clever abstractions.\n- Keep functions focused and files cohesive.\n- Use immutable updates unless a language-specific convention explicitly favors mutation.\n- Validate user input, external data, file paths, and configuration at system boundaries.\n- Preserve existing project conventions when they are stricter than this baseline.\n',
+        content: '# Coding Standards (2.0 canonical)\n\n- Prefer simple, readable code over clever abstractions.\n- Keep functions focused and files cohesive.\n- Use immutable updates unless a language-specific convention explicitly favors mutation.\n- Validate user input, external data, file paths, and configuration at system boundaries.\n- Preserve existing project conventions when they are stricter than this baseline.\n'
     },
     {
         relPath: 'common/code-review.md',
-        content: '# Code Review Standards (2.0 canonical)\n\n- Review diffs for correctness, maintainability, test coverage, and regression risk.\n- Treat missing tests for changed behavior as a blocker unless the change is documentation-only.\n- Verify code paths that handle filesystem, external APIs, credentials, user input, or generated artifacts.\n',
+        content: '# Code Review Standards (2.0 canonical)\n\n- Review diffs for correctness, maintainability, test coverage, and regression risk.\n- Treat missing tests for changed behavior as a blocker unless the change is documentation-only.\n- Verify code paths that handle filesystem, external APIs, credentials, user input, or generated artifacts.\n'
     },
     {
         relPath: 'common/security.md',
-        content: '# Security Review Standards (2.0 canonical)\n\n- Never hardcode secrets, API keys, passwords, tokens, or credentials.\n- Do not send private code or secrets to external services without explicit user authorization.\n- Guard filesystem writes against path traversal, symlink, and junction escapes.\n- Require explicit confirmation for destructive actions, external state changes, and credential use.\n',
+        content: '# Security Review Standards (2.0 canonical)\n\n- Never hardcode secrets, API keys, passwords, tokens, or credentials.\n- Do not send private code or secrets to external services without explicit user authorization.\n- Guard filesystem writes against path traversal, symlink, and junction escapes.\n- Require explicit confirmation for destructive actions, external state changes, and credential use.\n'
     },
-    { relPath: 'typescript/coding-style.md', content: CANONICAL_2_0_CODING_STYLE_TS },
+    { relPath: 'typescript/coding-style.md', content: CANONICAL_2_0_CODING_STYLE_TS }
 ];
 export function migrateClaudeRules(input) {
     const projectRoot = input.projectRoot;
@@ -124,7 +124,9 @@ export function migrateClaudeRules(input) {
     // the would-create location) but only created on disk in
     // apply mode. In dry-run mode we still return the path so
     // the user can see where the backup will land.
-    const computedBackupPath = hasThickFiles ? join(claudeRulesDir, `.peaks-2.0-backup-${timestampSlug()}`) : null;
+    const computedBackupPath = hasThickFiles
+        ? join(claudeRulesDir, `.peaks-2.0-backup-${timestampSlug()}`)
+        : null;
     const backupPath = apply ? computedBackupPath : null;
     const thinnedFiles = [];
     const scaffoldedFiles = [];
@@ -207,8 +209,8 @@ export function migrateClaudeRules(input) {
             preservedFiles,
             wouldChange,
             applied: apply && hasThickFiles,
-            nextActions,
+            nextActions
         },
-        warnings,
+        warnings
     };
 }

package/dist/services/standards/missing-standards-detector.js

@@ -68,9 +68,7 @@ export function diagnoseStandardsTree(projectRoot, language) {
     }
     const normalizedRoot = normalizeProjectRoot(projectRoot);
     const commonDir = join(normalizedRoot, '.peaks', 'standards', 'common');
-    const languageDir = language === 'generic'
-        ? null
-        : join(normalizedRoot, '.peaks', 'standards', language);
+    const languageDir = language === 'generic' ? null : join(normalizedRoot, '.peaks', 'standards', language);
     const commonOk = hasPopulatedMarkdown(commonDir);
     const languageOk = languageDir === null ? true : hasPopulatedMarkdown(languageDir);
     if (commonOk && languageOk) {

package/dist/services/standards/project-context-support.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Support declarations hoisted verbatim out of `project-context.ts` by the
+ * b1 file-size campaign: the package.json reader, the build-tool config probe
+ * and its candidate table, the semver-major helper, the CSS-conflict /
+ * state-management / routing / data-fetching / notable-dependency tables, the
+ * package-level legacy-signal collector, the sampled-JSX marker scanner and
+ * the directory-walk helpers it walks with — plus the two display-label maps
+ * that were finding-free where they stood.
+ *
+ * Signatures, bodies, tables and comments are unchanged; the two long
+ * signatures that could not take an `export ` prefix without being re-wrapped
+ * are exported from the footer below so every moved line stays byte-identical.
+ *
+ * What deliberately stayed in `project-context.ts` is every declaration that
+ * carries a lint finding today: the `_projectRoot` `no-unused-vars` cluster
+ * behind the detector table, `detectCssFrameworks` and
+ * `componentLibraryLabel` (both over the `complexity` threshold),
+ * `collectSourceFileLegacySignals` (`no-magic-numbers`) and
+ * `sampleSourceFiles` (a non-null assertion). A campaign sibling must be
+ * clean outright, so a finding-carrying declaration cannot be hoisted into
+ * one — which is also why only two of the three label maps live here.
+ */
+import { statSync } from 'node:fs';
+import type { BuildTool, ComponentLibrary, CssFramework } from './project-context-types.js';
+declare function readPackageJson(projectRoot: string): {
+    exists: boolean;
+    deps: Record<string, string>;
+};
+export declare function detectBuildTool(projectRoot: string): {
+    tool: BuildTool;
+    path?: string;
+};
+export declare function majorOf(version: string | undefined): string | undefined;
+declare function detectCssConflicts(library: ComponentLibrary, frameworks: CssFramework[]): string[];
+export declare function detectStateManagement(deps: Record<string, string>): string[];
+export declare function detectRouting(deps: Record<string, string>): string[];
+export declare function detectDataFetching(deps: Record<string, string>): string[];
+export declare function collectPackageLegacySignals(deps: Record<string, string>, signals: string[]): void;
+export declare function scanSampleForLegacyMarkers(sample: readonly string[]): {
+    classComponentHits: number;
+    inlineStyleHits: number;
+};
+export declare function readDirOrEmpty(dir: string): string[];
+export declare function statOrNull(path: string): ReturnType<typeof statSync> | null;
+export declare function isIgnoredEntry(entry: string): boolean;
+export declare function isJsxFile(entry: string): boolean;
+export declare function notableDepsList(deps: Record<string, string>): string[];
+export declare function buildToolLabel(tool: BuildTool): string;
+export declare function cssFrameworkLabel(framework: CssFramework): string;
+export { readPackageJson, detectCssConflicts };