peaks-loop 4.0.0-beta.12 → 4.0.0-beta.15

package/README-en.md

@@ -22,7 +22,7 @@
     style="border-radius: 14px; box-shadow: 0 12px 40px rgba(0,0,0,0.55); display: block;"
   />
   <br>
-  <sub>👆 18s looping GIF (<a href="https://raw.githubusercontent.com/SquabbyZ/peaks-loop/main/examples/video-demo/preview/peaks-loop-demo-en.mp4">full 30s mp4 download</a> · 13MB · 480p)</sub>
+  <sub>👆 18s looping GIF (full 30s mp4 is no longer shipped with the npm package — see <a href="https://github.com/SquabbyZ/peaks-loop/releases">GitHub Releases</a> · 13MB · 480p)</sub>
 </p>
 
 ---

package/README.md

@@ -22,7 +22,7 @@
     style="border-radius: 14px; box-shadow: 0 12px 40px rgba(0,0,0,0.55); display: block;"
   />
   <br>
-  <sub>👆 18s 循环 GIF(<a href="https://raw.githubusercontent.com/SquabbyZ/peaks-loop/main/examples/video-demo/preview/peaks-loop-demo.mp4">完整 30s mp4 下载</a> · 13MB · 480p)</sub>
+  <sub>👆 18s 循环 GIF(完整 30s mp4 不再随 npm 包发布,见 <a href="https://github.com/SquabbyZ/peaks-loop/releases">GitHub Release</a> · 13MB · 480p)</sub>
 </p>
 
 ---
@@ -220,6 +220,37 @@ peaks-loop 的两条工程脊柱直接来自这两个项目:
 
 ---
 
+## 发布(Trusted Publishing · OIDC)
+
+本仓库发布链路**不**使用 npm token,改用 **Trusted Publishing + OIDC**:
+
+- 维护者**不需要**也不会持有 `NPM_TOKEN` —— `~/.npmrc` 已被清理,npmjs.com 已把 Publishing access 切到 disallow tokens。
+- 触发方式 1:`git tag vX.Y.Z && git push --tags`(走 `.github/workflows/publish.yml` 的 `push: tags: v*.*.*` 触发器)。
+- 触发方式 2:GitHub UI → Actions → publish → Run workflow(手动兜底,可用于 dry-run / 补发)。
+- 每次发布跑完整链路:`install → typecheck → build → vitest → changesets version → changesets publish`,全部通过才会真正落到 npm。
+- 维护者的本地动作只有两步:`pnpm changeset` 写变更说明 + 合并 PR(剩下的 CI 自动跑)。
+
+**npmjs 侧一次性配置**(本 slice 完成后由人工做一次):
+
+1. 登录 https://www.npmjs.com → Settings → Trusted Publishers → Add GitHub Action。
+2. Owner / Org:`SquabbyZ` · Repository:`peaks-loop` · Workflow filename:`publish.yml` · Environment name:留空。
+3. 保存。
+
+**撤销** = npmjs 端删 trusted publisher,**无需** rotate token。
+
+**常见故障**:
+
+| 现象 | 原因 | 修法 |
+|------|------|------|
+| publish 步骤报 `Cannot get JWT` | 缺 `id-token: write` | 检查 `.github/workflows/publish.yml#permissions` |
+| publish 步骤报 `ENEEDAUTH` 或 `404 from registry.npmjs.org` | npmjs 端没配 trusted publisher | 走上面的 3 步配置 |
+| `changeset version` 把 `package.json` 改了我没想要 | 漏掉了手动 version | 提交前先本地 `pnpm changeset version`,CI 端为 no-op |
+| tag 推了但 CI 没跑 | tag 格式不符 `v*.*.*` | 检查 `git tag` 输出 |
+
+详细 RD 文档见 [`docs/superpowers/slices/slice-s1-trusted-publish.md`](./docs/superpowers/slices/slice-s1-trusted-publish.md)。
+
+---
+
 <div align="center">
 
 MIT License · Made by [SquabbyZ](https://github.com/SquabbyZ) · 中文版 · [English version](./README-en.md)

package/dist/cli/cli-helpers.d.ts

@@ -1,5 +1,5 @@
 import { Command } from 'commander';
-import { getErrorMessage, ok, redactSensitiveErrorMessage, type ResultEnvelope } from '../shared/result.js';
+import { getErrorMessage, ok, redactSensitiveErrorMessage, type ResultEnvelope } from 'peaks-loop-shared/result';
 import type { ArtifactProvider, GuidedArtifactSetup } from '../services/artifacts/artifact-service.js';
 import type { ConfigLayer } from '../services/config/config-service.js';
 import type { RecommendationWorkflow } from '../services/recommendations/recommendation-service.js';

package/dist/cli/cli-helpers.js

@@ -1,4 +1,4 @@
-import { fail, getErrorMessage, ok, redactSensitiveErrorMessage } from '../shared/result.js';
+import { fail, getErrorMessage, ok, redactSensitiveErrorMessage } from 'peaks-loop-shared/result';
 export function printResult(io, result, asJson = false) {
     if (asJson) {
         io.stdout(JSON.stringify(result, null, 2));

package/dist/cli/commands/adapter-commands-s2a.js

@@ -1,6 +1,6 @@
 import { existsSync } from 'node:fs';
 import { addJsonOption, printResult } from '../cli-helpers.js';
-import { fail, ok, getErrorMessage } from '../../shared/result.js';
+import { fail, ok, getErrorMessage } from 'peaks-loop-shared/result';
 import { AdapterRegistry } from '../../services/adapter/adapter-registry.js';
 import { registryFileFor } from './runtime-commands.js';
 function resolveProjectRoot(explicit) {

package/dist/cli/commands/asset-commands.js

@@ -43,12 +43,14 @@
 import { existsSync, mkdirSync } from "node:fs";
 import { join } from "node:path";
 import { openStateDb } from "../../services/skillhub/sqlite-store.js";
-import { CrystallizationService, CrystallizationIntegrityError, } from "../../services/crystallization/crystallization-service.js";
-import { CRYSTALLIZATION_TRIGGERS, parseEvidenceBrief, } from "../../services/crystallization/crystallization-types.js";
-import { BriefSectionError, safeRenderRecommendationPayload, } from "../../services/crystallization/evidence-brief-builder.js";
+import { CrystallizationService, CrystallizationIntegrityError, BriefSectionError, safeRenderRecommendationPayload, CRYSTALLIZATION_TRIGGERS, parseEvidenceBrief, } from "peaks-loop-crystallization";
+import { LoopReleaseSchema, } from "../../services/loop/loop-release-types.js";
+import { insertLoopRelease, } from "../../services/loop/loop-release-store.js";
+import { insertLoopBeeRelation, } from "../../services/loop/loop-bee-relation-store.js";
+import { LoopBeeRelationSchema, } from "../../services/loop/loop-bee-relation-types.js";
 import { findProjectRoot } from "../../services/config/config-safety.js";
 import { addJsonOption, getErrorMessage, printResult } from "../cli-helpers.js";
-import { fail, ok } from "../../shared/result.js";
+import { fail, ok } from 'peaks-loop-shared/result';
 function collectRepeatable(value, previous) {
     if (Array.isArray(previous))
         return [...previous, value];
@@ -120,7 +122,8 @@ export function registerAssetCommands(program, io) {
             }
             catch (err) {
                 if (err instanceof BriefSectionError) {
-                    printResult(io, fail("asset.crystallize", "MISSING_BRIEF_SECTION", err.message, { findings: [...err.findings], flagsProvided: Object.keys(candidateBrief) }, [
+                    const briefErr = err;
+                    printResult(io, fail("asset.crystallize", "MISSING_BRIEF_SECTION", briefErr.message, { findings: [...briefErr.findings], flagsProvided: Object.keys(candidateBrief) }, [
                         "Pass ALL FOUR brief sections via --brief-what-happened / --brief-why-it-matters / --brief-what-learned / --brief-what-action.",
                         "The CLI refuses to render a recommendation without a complete 4-section brief (spec §4.7 / RL-7).",
                     ]), options.json);
@@ -155,7 +158,12 @@ export function registerAssetCommands(program, io) {
             }
             const db = openStateDb(join(projectRoot, ".peaks", "state.db"));
             try {
-                const svc = new CrystallizationService(db);
+                const svc = new CrystallizationService(db, {
+                    loopReleaseSchema: LoopReleaseSchema,
+                    loopBeeRelationSchema: LoopBeeRelationSchema,
+                    insertLoopRelease: insertLoopRelease,
+                    insertLoopBeeRelation: insertLoopBeeRelation,
+                });
                 const result = svc.crystallize({
                     task: {
                         task_id: options.fromTask,
@@ -217,10 +225,11 @@ export function registerAssetCommands(program, io) {
         }
         catch (err) {
             if (err instanceof CrystallizationIntegrityError) {
-                printResult(io, fail("asset.crystallize", err.code, err.message, { findings: [...err.findings] }, [
-                    err.code === "CRYSTALLIZATION_PRE_RUN"
+                const integrityErr = err;
+                printResult(io, fail("asset.crystallize", integrityErr.code, integrityErr.message, { findings: [...integrityErr.findings] }, [
+                    integrityErr.code === "CRYSTALLIZATION_PRE_RUN"
                         ? "Re-shape the candidate task so task_status=completed AND gates_passed=true AND evidence_collected=true (spec §5 / RL-2)."
-                        : err.code === "MISSING_BRIEF_SECTION"
+                        : integrityErr.code === "MISSING_BRIEF_SECTION"
                             ? "Pass ALL FOUR brief sections (RL-7); the CLI refuses to render a recommendation without them."
                             : "Inspect the failure findings and re-shape the payload.",
                 ]), options.json);
@@ -228,14 +237,12 @@ export function registerAssetCommands(program, io) {
                 return;
             }
             if (err instanceof BriefSectionError) {
-                printResult(io, fail("asset.crystallize", "MISSING_BRIEF_SECTION", err.message, { findings: [...err.findings] }, ["Pass all 4 brief sections (RL-7)."]), options.json);
+                const briefErr = err;
+                printResult(io, fail("asset.crystallize", "MISSING_BRIEF_SECTION", briefErr.message, { findings: [...briefErr.findings] }, ["Pass all 4 brief sections (RL-7)."]), options.json);
                 process.exitCode = 1;
                 return;
             }
-            printResult(io, fail("asset.crystallize", "ASSET_CRYSTALLIZE_FAILED", getErrorMessage(err), {}, [
-                "Verify the brief flags and the loop/bee identifiers are valid.",
-            ]), options.json);
-            process.exitCode = 1;
+            throw err;
         }
     });
     // ---------- peaks asset dispose ----------
@@ -258,7 +265,12 @@ export function registerAssetCommands(program, io) {
             }
             const db = openStateDb(join(projectRoot, ".peaks", "state.db"));
             try {
-                const svc = new CrystallizationService(db);
+                const svc = new CrystallizationService(db, {
+                    loopReleaseSchema: LoopReleaseSchema,
+                    loopBeeRelationSchema: LoopBeeRelationSchema,
+                    insertLoopRelease: insertLoopRelease,
+                    insertLoopBeeRelation: insertLoopBeeRelation,
+                });
                 const existing = svc.read(options.crystallizationEvent);
                 if (!existing) {
                     printResult(io, fail("asset.dispose", "ASSET_EVENT_NOT_FOUND", `crystallization event '${options.crystallizationEvent}' not found`, { eventId: options.crystallizationEvent }, ["Verify the event id."]), options.json);
@@ -331,7 +343,12 @@ export function registerAssetCommands(program, io) {
             }
             const db = openStateDb(join(projectRoot, ".peaks", "state.db"));
             try {
-                const svc = new CrystallizationService(db);
+                const svc = new CrystallizationService(db, {
+                    loopReleaseSchema: LoopReleaseSchema,
+                    loopBeeRelationSchema: LoopBeeRelationSchema,
+                    insertLoopRelease: insertLoopRelease,
+                    insertLoopBeeRelation: insertLoopBeeRelation,
+                });
                 let events = [];
                 if (options.loop) {
                     events = [

package/dist/cli/commands/audit-commands.js

@@ -12,7 +12,7 @@ import { resolve } from 'node:path';
 import { runRedLinesAudit } from '../../services/audit/red-lines-service.js';
 import { runStaticAudit } from '../../services/audit/static-service.js';
 import { addJsonOption, getErrorMessage, printResult } from '../cli-helpers.js';
-import { fail, ok } from '../../shared/result.js';
+import { fail, ok } from 'peaks-loop-shared/result';
 import { writeAuditDecision } from '../../services/audit/decision-writer.js';
 import { computeProseRatio } from '../../services/audit/prose-ratio-calculator.js';
 import { writeMachineOutput, writeNarrative, writePrompt, } from '../../services/audit/artifact-writer.js';

package/dist/cli/commands/bee-commands.js

@@ -24,7 +24,7 @@
 import { existsSync, mkdirSync } from 'node:fs';
 import { join } from 'node:path';
 import { addJsonOption, getErrorMessage, printResult } from '../cli-helpers.js';
-import { fail, ok } from '../../shared/result.js';
+import { fail, ok } from 'peaks-loop-shared/result';
 import { findProjectRoot } from '../../services/config/config-safety.js';
 import { openStateDb } from '../../services/skillhub/sqlite-store.js';
 import { writeBundle, BundleNotShareableError, BundleAssetNotFoundError, } from '../../services/share/bundle-writer.js';

package/dist/cli/commands/capability-commands.js

@@ -2,7 +2,7 @@ import { readConfig } from '../../services/config/config-service.js';
 import { resolveCapabilityAvailability } from '../../services/recommendations/capability-availability.js';
 import { createCapabilityMapPlan } from '../../services/recommendations/capability-map-service.js';
 import { seedCapabilityItems, seedCapabilitySources } from '../../services/recommendations/seed-capability-catalog.js';
-import { fail, ok } from '../../shared/result.js';
+import { fail, ok } from 'peaks-loop-shared/result';
 import { addJsonOption, printResult } from '../cli-helpers.js';
 const CAPABILITY_SOURCE_FILTERS = new Set(['all', 'access-repo', 'mcp-server']);
 export function registerCapabilityCommands(program, io) {

package/dist/cli/commands/classify-classify-commands.js

@@ -20,7 +20,7 @@ import { classifyTask } from '../../services/classify/classify-service.js';
 import { TASK_LEVELS } from '../../services/classify/classify-types.js';
 import { loadPreferences } from '../../services/preferences/preferences-service.js';
 import { addJsonOption, getErrorMessage, printResult } from '../cli-helpers.js';
-import { fail, ok } from '../../shared/result.js';
+import { fail, ok } from 'peaks-loop-shared/result';
 const CLASSIFY_AUDIT_FILE = 'classify-audit.jsonl';
 function getSignalsFromGitDiff(projectRoot) {
     // Use git diff --stat to extract file count + line count. Fall back to

package/dist/cli/commands/code-commands.js

@@ -18,7 +18,7 @@
 import { existsSync, readFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { addJsonOption, getErrorMessage, printResult } from '../cli-helpers.js';
-import { fail, ok } from '../../shared/result.js';
+import { fail, ok } from 'peaks-loop-shared/result';
 import { emitObservabilityEvent } from '../../services/observability/observability-service.js';
 import { findProjectRoot } from '../../services/config/config-safety.js';
 import { GATED_STEPS, isHardFloorCategory, isCodeMode, isCommitBoundaryAction, shouldPauseAtGate, formatAutoProceedLogLine } from '../../services/code/mode-gate.js';

package/dist/cli/commands/code-review-commands.js

@@ -1,7 +1,7 @@
 import { getOcrConfigTemplate, detectOcr, runOcrReview } from '../../services/code-review/ocr-service.js';
 import { getOcrLlmConfig, getUserConfigPath, redactConfigSecrets } from '../../services/config/config-service.js';
 import { addJsonOption, getErrorMessage, printResult } from '../cli-helpers.js';
-import { fail, ok } from '../../shared/result.js';
+import { fail, ok } from 'peaks-loop-shared/result';
 export function registerCodeReviewCommands(program, io) {
     const codeReview = program
         .command('code-review', { hidden: true })

package/dist/cli/commands/codegraph-commands.js

@@ -1,6 +1,6 @@
 import { InvalidArgumentError } from 'commander';
 import { createCodegraphInvocation, executeCodegraphInvocation } from '../../services/codegraph/codegraph-service.js';
-import { fail } from '../../shared/result.js';
+import { fail } from 'peaks-loop-shared/result';
 import { getErrorMessage, printResult, redactSensitiveErrorMessage } from '../cli-helpers.js';
 function addPeaksJsonOption(command) {
     return command.option('--peaks-json', 'print Peaks error envelope as machine-readable JSON');

package/dist/cli/commands/compact-command.js

@@ -1,6 +1,6 @@
 import { resolveCanonicalProjectRoot } from '../../services/config/config-service.js';
 import { findProjectRoot } from '../../services/config/config-safety.js';
-import { fail, ok, getErrorMessage } from '../../shared/result.js';
+import { fail, ok, getErrorMessage } from 'peaks-loop-shared/result';
 import { addJsonOption, printResult } from '../cli-helpers.js';
 import { writeCheckpoint } from '../../services/session/session-checkpoint-service.js';
 import { getSessionIdCanonical } from '../../services/session/session-manager.js';

package/dist/cli/commands/complexity-commands.js

@@ -6,7 +6,7 @@
  */
 import { findProjectRoot } from '../../services/config/config-safety.js';
 import { estimateComplexity } from '../../services/complexity/complexity-estimator.js';
-import { fail, ok } from '../../shared/result.js';
+import { fail, ok } from 'peaks-loop-shared/result';
 import { addJsonOption, printResult } from '../cli-helpers.js';
 export function registerComplexityCommands(program, io) {
     addJsonOption(program

package/dist/cli/commands/config-commands.js

@@ -2,7 +2,7 @@ import { executeMigration, planMigration } from '../../services/config/config-mi
 import { getConfig, isSensitiveConfigPath, redactConfigSecrets, setConfig } from '../../services/config/config-service.js';
 import { listAvailableFields, restoreField } from '../../services/config/config-restore.js';
 import { executeRollback, planRollback } from '../../services/config/config-rollback.js';
-import { fail, ok } from '../../shared/result.js';
+import { fail, ok } from 'peaks-loop-shared/result';
 import { addJsonOption, getErrorMessage, parseConfigLayer, printInvalidConfigLayer, printResult } from '../cli-helpers.js';
 export function registerConfigCommands(program, io) {
     const config = program.command('config').description('Manage Peaks configuration');

package/dist/cli/commands/context-commands.js

@@ -19,7 +19,7 @@ import { existsSync, readFileSync, readdirSync } from 'node:fs';
 import { join } from 'node:path';
 import { searchMemory } from '../../services/memory/memory-search-service.js';
 import { addJsonOption, getErrorMessage, printResult } from '../cli-helpers.js';
-import { fail, ok } from '../../shared/result.js';
+import { fail, ok } from 'peaks-loop-shared/result';
 import { emitObservabilityEvent } from '../../services/observability/observability-service.js';
 import { findProjectRoot } from '../../services/config/config-safety.js';
 import { getSessionIdCanonical } from '../../services/session/session-manager.js';

package/dist/cli/commands/contract-commands.js

@@ -1,4 +1,4 @@
-import { fail, ok, getErrorMessage } from '../../shared/result.js';
+import { fail, ok, getErrorMessage } from 'peaks-loop-shared/result';
 import { addJsonOption, printResult } from '../cli-helpers.js';
 import { writeContract } from '../../services/dispatch/contract-store.js';
 import { getCurrentSessionId } from '../../services/skills/skill-presence-service.js';

package/dist/cli/commands/core/artifacts-command.js

@@ -1,6 +1,6 @@
 import { createArtifactInitPlan, getArtifactStatus, createGuidedArtifactSetup } from '../../../services/artifacts/artifact-service.js';
 import { getArtifactWorkspaceStatus, planArtifactSync } from '../../../services/artifacts/workspace-service.js';
-import { fail, ok } from '../../../shared/result.js';
+import { fail, ok } from 'peaks-loop-shared/result';
 import { addJsonOption, failUnsupportedNonDryRun, isArtifactProvider, isArtifactSetupStep, printResult } from '../../cli-helpers.js';
 export function registerArtifactsCommand(program, io) {
     const artifacts = program.command('artifacts').description('Manage intermediate artifact repositories');

package/dist/cli/commands/core/binding-commands.js

@@ -1,7 +1,7 @@
 import { addJsonOption, printResult } from '../../cli-helpers.js';
 import { findProjectRoot } from '../../../services/config/config-safety.js';
 import { loadBindingStatus, formatTable, formatJson } from '../../../services/session/binding-status-service.js';
-import { fail, ok } from '../../../shared/result.js';
+import { fail, ok } from 'peaks-loop-shared/result';
 // v2.18.2 PATCH scope (follow-up issues #2). Read-only introspection
 // CLI. Surface is intentionally minimal: one subcommand
 // (`peaks binding status`), two output modes (table + json), one

package/dist/cli/commands/core/doctor-command.js

@@ -1,8 +1,62 @@
-import { runDoctor } from '../../../services/doctor/doctor-service.js';
+import { runDoctor } from 'peaks-loop-doctor';
 import { readBinding, dropStale, rebuildBindingFromLegacy } from '../../../services/session/binding-store.js';
 import { findProjectRoot } from '../../../services/config/config-safety.js';
+import { loadSkillRegistry } from '../../../services/skills/skill-registry.js';
+import { planStatusLineInstall } from '../../../services/skills/statusline-settings-service.js';
 import { addJsonOption, printResult } from '../../cli-helpers.js';
-import { fail, ok } from '../../../shared/result.js';
+import { fail, ok } from 'peaks-loop-shared/result';
+// slice-3b Option C: the doctor subpackage owns the check pipeline but
+// does NOT import cross-domain utils from the main package (avoids
+// circular deps). The CLI is the natural wiring point — every cross-
+// domain util the doctor used to import directly is now injected as a
+// probe on DoctorOptions at call-site:
+//
+//   loadSkills           ← loadSkillRegistry (main/services/skills/skill-registry.ts)
+//   skillPresenceProbe   ← leave as-is; doctor-command does not own the presence probe
+//   statusLineInstalledProbe ← defaults to a `planStatusLineInstall` wrapper below
+//   projectRootResolver  ← findProjectRoot (main/services/config/config-safety.ts)
+//   isValidSessionIdProbe ← the regex kept in main/services/workspace/sid-naming-guard.ts
+//
+// Inlining isValidSessionId via the doctor subpackage's default regex
+// (which mirrors the upstream file byte-for-byte) keeps the L3 orphan
+// check behaviour-identical without dragging sid-naming-guard into a
+// workspace package. If sid-naming-guard is ever moved into
+// peaks-loop-shared, swap this for a re-import.
+function doctorIsValidSessionId(sid) {
+    return /^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])-session-[0-9a-z]{3,6}$/.test(sid);
+}
+function statusLineAlreadyInstalledForScope(scope, projectRoot) {
+    try {
+        if (scope === 'project') {
+            if (projectRoot === undefined)
+                return false;
+            return planStatusLineInstall('project', projectRoot).alreadyInstalled;
+        }
+        return planStatusLineInstall('global').alreadyInstalled;
+    }
+    catch {
+        return false;
+    }
+}
+function doctorStatusLineInstalledProbe() {
+    const projectRoot = findProjectRoot(process.cwd());
+    // Check both scopes: a user may have installed the statusLine globally, which
+    // the project-only check would miss and falsely report as "not installed".
+    try {
+        if (projectRoot !== null && statusLineAlreadyInstalledForScope('project', projectRoot)) {
+            return true;
+        }
+    }
+    catch { // TODO(g2): legacy silent catch — grace: 1 minor release (v2.14.0)
+        /* fall through to global */
+    }
+    try {
+        return statusLineAlreadyInstalledForScope('global');
+    }
+    catch {
+        return false;
+    }
+}
 // Slice v2.16.0 AC-10: stale binding TTL is 5 minutes by default. The
 // threshold is exposed as a CLI flag so users can tune it for
 // long-running sessions.
@@ -129,7 +183,13 @@ export function registerDoctorCommand(program, io) {
             }
             return;
         }
-        const report = await runDoctor();
+        const report = await runDoctor({
+            // slice-3b Option C: wire cross-domain probes at call-site.
+            loadSkills: loadSkillRegistry,
+            projectRootResolver: () => findProjectRoot(process.cwd()),
+            isValidSessionIdProbe: doctorIsValidSessionId,
+            statusLineInstalledProbe: doctorStatusLineInstalledProbe
+        });
         let logsSection = null;
         if (options.log === true) {
             logsSection = await buildDoctorLogsSection();

package/dist/cli/commands/core/memory-command.js

@@ -1,5 +1,5 @@
 import { executeProjectMemoryBackup, executeProjectMemoryExtract, summarizeProjectMemoryBackupResult, summarizeProjectMemoryExtractResult } from '../../../services/memory/project-memory-service.js';
-import { fail, ok } from '../../../shared/result.js';
+import { fail, ok } from 'peaks-loop-shared/result';
 import { addJsonOption, getErrorMessage, printResult } from '../../cli-helpers.js';
 export function registerMemoryCommand(program, io) {
     const memory = program.command('memory').description('Manage project-local Peaks memory');

package/dist/cli/commands/core/profile-command.js

@@ -1,5 +1,5 @@
 import { listProfiles } from '../../../services/profiles/profile-service.js';
-import { ok } from '../../../shared/result.js';
+import { ok } from 'peaks-loop-shared/result';
 import { addJsonOption, printResult } from '../../cli-helpers.js';
 export function registerProfileCommand(program, io) {
     const profile = program.command('profile').description('Manage runtime profiles');

package/dist/cli/commands/core/proxy-command.js

@@ -1,5 +1,5 @@
 import { planProxyTest } from '../../../services/proxy/proxy-service.js';
-import { fail, ok } from '../../../shared/result.js';
+import { fail, ok } from 'peaks-loop-shared/result';
 import { addJsonOption, failUnsupportedNonDryRun, getErrorMessage, printResult } from '../../cli-helpers.js';
 export function registerProxyCommand(program, io) {
     const proxy = program.command('proxy').description('Manage proxy settings');

package/dist/cli/commands/core/session-command.js

@@ -3,7 +3,7 @@ import { join } from 'node:path';
 import { getSessionMeta, rotateSessionBinding, setSessionTitle, listSessionMetas } from '../../../services/session/session-manager.js';
 import { resolveCanonicalProjectRoot } from '../../../services/config/config-service.js';
 import { findProjectRoot } from '../../../services/config/config-safety.js';
-import { fail, ok } from '../../../shared/result.js';
+import { fail, ok } from 'peaks-loop-shared/result';
 import { addJsonOption, getErrorMessage, printResult } from '../../cli-helpers.js';
 // Slice 2026-07-01-strategic-compact-cli fix: register the
 // `peaks session checkpoint` and `peaks session resume` subcommands

package/dist/cli/commands/core/skill-command.js

@@ -1,4 +1,4 @@
-import { runDoctor } from '../../../services/doctor/doctor-service.js';
+import { runDoctor } from 'peaks-loop-doctor';
 import { listSkills } from '../../../services/skills/skill-registry.js';
 import { runSkillSync, SYNC_PLATFORMS } from '../../../services/skills/sync-service.js';
 import { inspectSkillRunbook } from '../../../services/skills/skill-runbook-service.js';
@@ -7,7 +7,7 @@ import { detectPresenceMarker } from '../../../services/hooks/presence-marker-de
 import { findProjectRoot } from '../../../services/config/config-safety.js';
 import { generateProjectContext } from '../../../services/memory/project-context-service.js';
 import { getSessionId, setSessionMeta } from '../../../services/session/session-manager.js';
-import { fail, ok } from '../../../shared/result.js';
+import { fail, ok } from 'peaks-loop-shared/result';
 import { addJsonOption, getErrorMessage, printResult } from '../../cli-helpers.js';
 // Slice S0 (4.0.0-beta.5 peaks-solo dispatcher release):
 // `peaks skill search` is the CLI primitive that feeds the

package/dist/cli/commands/core/standards-command.js

@@ -2,7 +2,7 @@ import { summarizeProjectStandardsInitResult, summarizeProjectStandardsUpdateRes
 import { executeProjectStandardsInitIdeAware, executeProjectStandardsUpdateIdeAware } from '../../../services/standards/ide-aware-standards-service.js';
 import { migrateStandards } from '../../../services/standards/migrate-service.js';
 import { migrateClaudeRules } from '../../../services/standards/migrate-claude-rules-service.js';
-import { fail, ok } from '../../../shared/result.js';
+import { fail, ok } from 'peaks-loop-shared/result';
 import { addJsonOption, getErrorMessage, printResult } from '../../cli-helpers.js';
 export function registerStandardsCommand(program, io) {
     const standards = program.command('standards').description('Manage project-local coding standards');

package/dist/cli/commands/dispatch-commands.js

@@ -16,7 +16,7 @@
  */
 import { existsSync } from 'node:fs';
 import { randomUUID } from 'node:crypto';
-import { fail, getErrorMessage, ok } from '../../shared/result.js';
+import { fail, getErrorMessage, ok } from 'peaks-loop-shared/result';
 import { addJsonOption, printResult } from '../cli-helpers.js';
 import { detectInstalledIde } from '../../services/ide/ide-detector.js';
 import { getAdapter } from '../../services/ide/ide-registry.js';
@@ -27,7 +27,7 @@ import { writeInitialDispatchRecord } from '../../services/dispatch/dispatch-rec
 import { evaluatePromptSize } from '../../services/context/context-guard.js';
 import { getCurrentSessionId } from '../../services/skills/skill-presence-service.js';
 import { buildArtifactMeta, buildContextImpact } from '../../services/context/artifact-meta.js';
-import { assertSafeArtifactPath } from '../../services/context/dispatch-context-guard.js';
+import { assertSafeArtifactPath } from 'peaks-loop-shared-channel';
 import { compressPrompt } from '../../services/context/headroom-client.js';
 import { resolveHeadroomOptions } from '../../services/context/headroom-prefs.js';
 import { loadPreferences } from '../../services/preferences/preferences-service.js';

package/dist/cli/commands/dispatch-from-dag.js

@@ -28,7 +28,7 @@
  */
 import { randomUUID } from 'node:crypto';
 import { printResult } from '../cli-helpers.js';
-import { fail, ok } from '../../shared/result.js';
+import { fail, ok } from 'peaks-loop-shared/result';
 import { detectInstalledIde } from '../../services/ide/ide-detector.js';
 import { getAdapter } from '../../services/ide/ide-registry.js';
 import { getCurrentSessionId } from '../../services/skills/skill-presence-service.js';

package/dist/cli/commands/doc-commands.js

@@ -9,7 +9,7 @@
 import { resolve as resolvePath } from 'node:path';
 import { findProjectRoot } from '../../services/config/config-safety.js';
 import { generateSkillFromCommands, gitLogSince, renderSkillMarkdown, suggestChangelog } from '../../services/doc/doc-generator.js';
-import { fail, ok } from '../../shared/result.js';
+import { fail, ok } from 'peaks-loop-shared/result';
 import { addJsonOption, printResult } from '../cli-helpers.js';
 export function registerDocCommands(program, io) {
     const doc = program

package/dist/cli/commands/ecc-commands.js

@@ -1,6 +1,6 @@
-import { downloadToCache, listCachedAgents, readAgentSkill, readCacheManifest, } from '../../services/agent/ecc-cache-service.js';
+import { downloadToCache, listCachedAgents, readAgentSkill, readCacheManifest, } from 'peaks-loop-mut';
 import { addJsonOption, getErrorMessage, printResult } from '../cli-helpers.js';
-import { fail, ok } from '../../shared/result.js';
+import { fail, ok } from 'peaks-loop-shared/result';
 export function registerEccCommands(program, io) {
     const ecc = program
         .command('ecc')

package/dist/cli/commands/evolution-commands.js

@@ -30,7 +30,7 @@ import { EVOLUTION_TARGET_KINDS, } from "../../services/evolution/evolution-type
 import { findProjectRoot } from "../../services/config/config-safety.js";
 import { runIndependentEvaluator, } from "../../services/evolution/independent-evaluator-runner.js";
 import { addJsonOption, getErrorMessage, printResult } from "../cli-helpers.js";
-import { fail, ok } from "../../shared/result.js";
+import { fail, ok } from 'peaks-loop-shared/result';
 /**
  * Parse `--target <kind:id>`. Returns the kind + id, or `null` on
  * failure. Validates `kind` against the EVOLUTION_TARGET_KINDS

package/dist/cli/commands/feedback-commands.js

@@ -17,7 +17,7 @@ import { resolve as resolvePath } from 'node:path';
 import { findProjectRoot } from '../../services/config/config-safety.js';
 import { getCurrentSessionId } from '../../services/skills/skill-presence-service.js';
 import { generatePromotionStub, isPromotionLayer, listUnpromotedFeedback, parseFeedbackMemory, PROMOTION_LAYER_DETAILS, PROMOTION_LAYERS, promoteFeedback } from '../../services/feedback/feedback-promotion-service.js';
-import { fail, ok } from '../../shared/result.js';
+import { fail, ok } from 'peaks-loop-shared/result';
 import { addJsonOption, getErrorMessage, printResult } from '../cli-helpers.js';
 export function registerFeedbackCommands(program, io) {
     const feedback = program

package/dist/cli/commands/final-review-commands.js

@@ -20,7 +20,7 @@
 import { existsSync, statSync } from 'node:fs';
 import { join, resolve } from 'node:path';
 import { addJsonOption, getErrorMessage, printResult } from '../cli-helpers.js';
-import { fail, ok } from '../../shared/result.js';
+import { fail, ok } from 'peaks-loop-shared/result';
 /** Whitelist of supported `--llm-provider` values for `peaks prepare-final-review`. */
 const SUPPORTED_LLM_PROVIDERS = ['stub'];
 function isSupportedLlmProvider(value) {

package/dist/cli/commands/fixture-commands.js

@@ -1,7 +1,7 @@
 import { resolve } from 'node:path';
 import { captureDerivedVariant, captureHistoricalFixture, EDGE_CASE_VARIANTS, ENVELOPE_KINDS } from '../../services/fixture/index.js';
 import { addJsonOption, printResult } from '../cli-helpers.js';
-import { fail, ok } from '../../shared/result.js';
+import { fail, ok } from 'peaks-loop-shared/result';
 function isEnvelopeKind(v) {
     return ENVELOPE_KINDS.includes(v);
 }

package/dist/cli/commands/fork-commands.js

@@ -13,7 +13,7 @@
  */
 import { findProjectRoot } from '../../services/config/config-safety.js';
 import { appendSyncRecord, buildForkStatusReport, makeSyncId, readForkState, recommendStableTags, updateSyncRecordStatus, writeForkState } from '../../services/fork/fork-sync-state.js';
-import { fail, ok } from '../../shared/result.js';
+import { fail, ok } from 'peaks-loop-shared/result';
 import { addJsonOption, printResult } from '../cli-helpers.js';
 export function registerForkCommands(program, io) {
     const fork = program

package/dist/cli/commands/gate-commands.js

@@ -1,5 +1,5 @@
 import { enforceBashCommand, recordGateBypass, GateBypassError } from '../../services/sop/gate-enforce-service.js';
-import { fail, ok } from '../../shared/result.js';
+import { fail, ok } from 'peaks-loop-shared/result';
 import { addJsonOption, getErrorMessage, printResult } from '../cli-helpers.js';
 import { detectIdeFromContext, parseClaudeShapeStdin } from '../../services/ide/hook-translator.js';
 import { getAdapter } from '../../services/ide/ide-registry.js';

package/dist/cli/commands/heartbeat-commands.js

@@ -12,7 +12,7 @@
  * point at a sensitive file outside the runtime tree.
  */
 import { existsSync } from 'node:fs';
-import { fail, getErrorMessage, ok } from '../../shared/result.js';
+import { fail, getErrorMessage, ok } from 'peaks-loop-shared/result';
 import { addJsonOption, printResult } from '../cli-helpers.js';
 import { appendHeartbeat } from '../../services/dispatch/dispatch-record-writer.js';
 import { assertSafeDispatchRecordPath } from '../../services/security/safe-settings-path.js';

package/dist/cli/commands/hook-handle.js

@@ -6,7 +6,7 @@ import { evaluateCodeBan } from '../../services/audit/enforcers/code-ban.js';
 import { isRootWrite } from '../../services/audit/enforcers/no-root-pollution.js';
 import { checkLoginGate } from '../../services/audit/enforcers/login-gate.js';
 import { resolveActiveSkillForCaller } from '../../services/audit/enforcers/active-skill-resolver.js';
-import { fail, ok } from '../../shared/result.js';
+import { fail, ok } from 'peaks-loop-shared/result';
 import { emitDecision, emitHint } from '../../services/hooks/output.js';
 /**
  * Read the hook payload. `PEAKS_HOOK_STDIN` is a test seam (same convention as