peaks-loop 4.0.21 → 4.0.24

package/dist/services/share/bundle-types.d.ts

@@ -105,17 +105,7 @@ export declare const SchemaVersionsMappingSchema: z.ZodObject<{
     bee: z.ZodLiteral<"peaks.bee/1">;
     loop_bee_relation: z.ZodLiteral<"peaks.loop-bee-relation/1">;
     crystallization: z.ZodLiteral<"peaks.crystallization/1">;
-}, "strict", z.ZodTypeAny, {
-    loop: "peaks.loop/1";
-    bee: "peaks.bee/1";
-    loop_bee_relation: "peaks.loop-bee-relation/1";
-    crystallization: "peaks.crystallization/1";
-}, {
-    loop: "peaks.loop/1";
-    bee: "peaks.bee/1";
-    loop_bee_relation: "peaks.loop-bee-relation/1";
-    crystallization: "peaks.crystallization/1";
-}>;
+}, z.core.$strict>;
 export type SchemaVersionsMapping = z.infer<typeof SchemaVersionsMappingSchema>;
 /**
  * The bundle explicitly excludes private run-state, the user's
@@ -130,15 +120,7 @@ export declare const ExclusionManifestSchema: z.ZodObject<{
     private_run_state: z.ZodLiteral<"excluded">;
     personal_memory: z.ZodLiteral<"excluded">;
     state_db_rows: z.ZodLiteral<"excluded">;
-}, "strict", z.ZodTypeAny, {
-    private_run_state: "excluded";
-    personal_memory: "excluded";
-    state_db_rows: "excluded";
-}, {
-    private_run_state: "excluded";
-    personal_memory: "excluded";
-    state_db_rows: "excluded";
-}>;
+}, z.core.$strict>;
 export type ExclusionManifest = z.infer<typeof ExclusionManifestSchema>;
 /**
  * Bundle kind. A bundle is anchored on exactly one asset: either a
@@ -162,181 +144,31 @@ export type PeaksBundleKind = (typeof PEAKS_BUNDLE_KINDS)[number];
  *     canonical literal.
  *   - `exclusion_manifest` declares the three hard excludes.
  */
-export declare const BundleManifestSchema: z.ZodEffects<z.ZodObject<{
-    /**
-     * The format constant. Pinned to `"peaks.bundle/1"`. A future
-     * format change is a major bump + a new constant value.
-     */
+export declare const BundleManifestSchema: z.ZodObject<{
     format_constant: z.ZodLiteral<"peaks.bundle/1">;
-    /**
-     * Major version. The reader requires `1`; anything else is a
-     * HARD block. Enforced at the read boundary, not here.
-     */
     format_version_major: z.ZodLiteral<1>;
-    /**
-     * Minor version. Defaults to `0`. Major-compatible bumps are a
-     * non-fatal warn at read time.
-     */
     format_version_minor: z.ZodDefault<z.ZodNumber>;
-    /**
-     * Schema-version mapping. Every required key MUST be present
-     * with its canonical literal; unknown keys are rejected by
-     * `.strict()`.
-     */
     schema_versions: z.ZodObject<{
         loop: z.ZodLiteral<"peaks.loop/1">;
         bee: z.ZodLiteral<"peaks.bee/1">;
         loop_bee_relation: z.ZodLiteral<"peaks.loop-bee-relation/1">;
         crystallization: z.ZodLiteral<"peaks.crystallization/1">;
-    }, "strict", z.ZodTypeAny, {
-        loop: "peaks.loop/1";
-        bee: "peaks.bee/1";
-        loop_bee_relation: "peaks.loop-bee-relation/1";
-        crystallization: "peaks.crystallization/1";
-    }, {
-        loop: "peaks.loop/1";
-        bee: "peaks.bee/1";
-        loop_bee_relation: "peaks.loop-bee-relation/1";
-        crystallization: "peaks.crystallization/1";
+    }, z.core.$strict>;
+    kind: z.ZodEnum<{
+        loop: "loop";
+        bee: "bee";
     }>;
-    /**
-     * Anchor kind. Decides whether `loop_release` or `bee_release`
-     * is required below.
-     */
-    kind: z.ZodEnum<["loop", "bee"]>;
-    /**
-     * The loop_release row. Required when `kind === "loop"`,
-     * omitted (or absent) when `kind === "bee"`. The writer leaves
-     * it `undefined` for `bee` bundles; the JSON shape is allowed
-     * to omit it.
-     */
     loop_release: z.ZodOptional<z.ZodUnknown>;
-    /**
-     * The bee_release row. Required when `kind === "bee"`,
-     * optional for `kind === "loop"` (a loop bundle may include a
-     * main bee inline). When present, the reader uses the service
-     * layer to re-validate the row shape.
-     */
     bee_release: z.ZodOptional<z.ZodUnknown>;
-    /**
-     * Related bee_release rows for the loop kind (main + supporting
-     * + candidate + retired). Empty for `kind === "bee"`.
-     */
-    related_bee_releases: z.ZodDefault<z.ZodArray<z.ZodUnknown, "many">>;
-    /**
-     * Loop↔bee relation rows from `loop_bee_relation`. Always
-     * present (possibly empty).
-     */
-    loop_bee_relations: z.ZodDefault<z.ZodArray<z.ZodUnknown, "many">>;
-    /**
-     * Evidence briefs (crystallization_event rows) that back the
-     * bundle's assets. The receiver uses them to render the
-     * post-import crystallization prompt + a brief for any
-     * subsequent independent evaluation.
-     */
-    evidence_briefs: z.ZodDefault<z.ZodArray<z.ZodUnknown, "many">>;
-    /**
-     * Exclusion manifest — explicit declarations of the three
-     * hard excludes per spec §7A.2.
-     */
+    related_bee_releases: z.ZodDefault<z.ZodArray<z.ZodUnknown>>;
+    loop_bee_relations: z.ZodDefault<z.ZodArray<z.ZodUnknown>>;
+    evidence_briefs: z.ZodDefault<z.ZodArray<z.ZodUnknown>>;
     exclusion_manifest: z.ZodObject<{
         private_run_state: z.ZodLiteral<"excluded">;
         personal_memory: z.ZodLiteral<"excluded">;
         state_db_rows: z.ZodLiteral<"excluded">;
-    }, "strict", z.ZodTypeAny, {
-        private_run_state: "excluded";
-        personal_memory: "excluded";
-        state_db_rows: "excluded";
-    }, {
-        private_run_state: "excluded";
-        personal_memory: "excluded";
-        state_db_rows: "excluded";
-    }>;
-}, "strict", z.ZodTypeAny, {
-    kind: "loop" | "bee";
-    format_constant: "peaks.bundle/1";
-    format_version_major: 1;
-    format_version_minor: number;
-    schema_versions: {
-        loop: "peaks.loop/1";
-        bee: "peaks.bee/1";
-        loop_bee_relation: "peaks.loop-bee-relation/1";
-        crystallization: "peaks.crystallization/1";
-    };
-    related_bee_releases: unknown[];
-    loop_bee_relations: unknown[];
-    evidence_briefs: unknown[];
-    exclusion_manifest: {
-        private_run_state: "excluded";
-        personal_memory: "excluded";
-        state_db_rows: "excluded";
-    };
-    loop_release?: unknown;
-    bee_release?: unknown;
-}, {
-    kind: "loop" | "bee";
-    format_constant: "peaks.bundle/1";
-    format_version_major: 1;
-    schema_versions: {
-        loop: "peaks.loop/1";
-        bee: "peaks.bee/1";
-        loop_bee_relation: "peaks.loop-bee-relation/1";
-        crystallization: "peaks.crystallization/1";
-    };
-    exclusion_manifest: {
-        private_run_state: "excluded";
-        personal_memory: "excluded";
-        state_db_rows: "excluded";
-    };
-    format_version_minor?: number | undefined;
-    loop_release?: unknown;
-    bee_release?: unknown;
-    related_bee_releases?: unknown[] | undefined;
-    loop_bee_relations?: unknown[] | undefined;
-    evidence_briefs?: unknown[] | undefined;
-}>, {
-    kind: "loop" | "bee";
-    format_constant: "peaks.bundle/1";
-    format_version_major: 1;
-    format_version_minor: number;
-    schema_versions: {
-        loop: "peaks.loop/1";
-        bee: "peaks.bee/1";
-        loop_bee_relation: "peaks.loop-bee-relation/1";
-        crystallization: "peaks.crystallization/1";
-    };
-    related_bee_releases: unknown[];
-    loop_bee_relations: unknown[];
-    evidence_briefs: unknown[];
-    exclusion_manifest: {
-        private_run_state: "excluded";
-        personal_memory: "excluded";
-        state_db_rows: "excluded";
-    };
-    loop_release?: unknown;
-    bee_release?: unknown;
-}, {
-    kind: "loop" | "bee";
-    format_constant: "peaks.bundle/1";
-    format_version_major: 1;
-    schema_versions: {
-        loop: "peaks.loop/1";
-        bee: "peaks.bee/1";
-        loop_bee_relation: "peaks.loop-bee-relation/1";
-        crystallization: "peaks.crystallization/1";
-    };
-    exclusion_manifest: {
-        private_run_state: "excluded";
-        personal_memory: "excluded";
-        state_db_rows: "excluded";
-    };
-    format_version_minor?: number | undefined;
-    loop_release?: unknown;
-    bee_release?: unknown;
-    related_bee_releases?: unknown[] | undefined;
-    loop_bee_relations?: unknown[] | undefined;
-    evidence_briefs?: unknown[] | undefined;
-}>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
 export type BundleManifest = z.infer<typeof BundleManifestSchema>;
 /**
  * Strict-parse an unknown value as a BundleManifest. Throws

package/dist/services/share/bundle-types.js

@@ -228,17 +228,23 @@ export const BundleManifestSchema = z
     exclusion_manifest: ExclusionManifestSchema,
 })
     .strict()
-    .refine((m) => {
+    .superRefine((m, ctx) => {
     // kind === 'loop' implies loop_release is required.
-    if (m.kind === "loop" && m.loop_release === undefined)
-        return false;
+    if (m.kind === "loop" && m.loop_release === undefined) {
+        ctx.addIssue({
+            code: 'custom',
+            path: [],
+            message: "bundle manifest is inconsistent: kind='loop' requires loop_release; kind='bee' requires bee_release (spec §7A.2)",
+        });
+    }
     // kind === 'bee' implies bee_release is required.
-    if (m.kind === "bee" && m.bee_release === undefined)
-        return false;
-    return true;
-}, {
-    message: "bundle manifest is inconsistent: kind='loop' requires loop_release; kind='bee' requires bee_release (spec §7A.2)",
-    path: [],
+    if (m.kind === "bee" && m.bee_release === undefined) {
+        ctx.addIssue({
+            code: 'custom',
+            path: [],
+            message: "bundle manifest is inconsistent: kind='loop' requires loop_release; kind='bee' requires bee_release (spec §7A.2)",
+        });
+    }
 });
 /* ---------------------------------------------------------------------- */
 /* Validation helpers                                                      */

package/dist/services/share/run-state-contract.d.ts

@@ -60,37 +60,20 @@ export type RunStateStatus = (typeof RUN_STATE_STATUSES)[number];
  * schema-version bump, not a quiet extension.
  */
 export declare const RunStateContractSchema: z.ZodObject<{
-    /** Stable bee id (kebab-case). */
     bee_id: z.ZodString;
-    /** Current run status (running / paused / done / failed / blocked). */
-    status: z.ZodEnum<["running", "paused", "done", "failed", "blocked"]>;
-    /** Current step name; NL short label. */
+    status: z.ZodEnum<{
+        blocked: "blocked";
+        failed: "failed";
+        running: "running";
+        done: "done";
+        paused: "paused";
+    }>;
     current_step: z.ZodString;
-    /** ISO8601 timestamp the run started. */
     started_at: z.ZodString;
-    /** ISO8601 timestamp of the latest update. */
     updated_at: z.ZodString;
-    /** NL summary of the latest evaluator verdict (or null when none). */
     last_evaluator_verdict: z.ZodNullable<z.ZodString>;
-    /** NL summary of the latest user choice (or null when none). */
     last_user_choice: z.ZodNullable<z.ZodString>;
-}, "strict", z.ZodTypeAny, {
-    status: "blocked" | "failed" | "running" | "done" | "paused";
-    bee_id: string;
-    current_step: string;
-    started_at: string;
-    updated_at: string;
-    last_evaluator_verdict: string | null;
-    last_user_choice: string | null;
-}, {
-    status: "blocked" | "failed" | "running" | "done" | "paused";
-    bee_id: string;
-    current_step: string;
-    started_at: string;
-    updated_at: string;
-    last_evaluator_verdict: string | null;
-    last_user_choice: string | null;
-}>;
+}, z.core.$strict>;
 export type RunStateContract = z.infer<typeof RunStateContractSchema>;
 /**
  * Strict-parse an unknown value as a RunStateContract. Throws

package/dist/services/skill/skill-search-service.d.ts

@@ -24,60 +24,40 @@
  */
 import { z } from 'zod';
 import { skillsDir } from 'peaks-loop-shared/paths';
-export declare const SkillSearchInputSchema: z.ZodEffects<z.ZodObject<{
+export declare const SkillSearchInputSchema: z.ZodObject<{
     query: z.ZodOptional<z.ZodString>;
     tag: z.ZodOptional<z.ZodString>;
-    domain: z.ZodOptional<z.ZodEnum<["code", "content", "doctor", "research", "triage", "sop", "audit", "final-review", "resume", "status", "test", "ide", "slice-decompose", "issue-fix-orchestrator", "perf-audit", "security-audit", "reviewer"]>>;
-    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-    includeInternal: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-}, "strip", z.ZodTypeAny, {
-    limit: number;
-    includeInternal: boolean;
-    query?: string | undefined;
-    tag?: string | undefined;
-    domain?: "code" | "status" | "resume" | "audit" | "content" | "test" | "ide" | "research" | "doctor" | "triage" | "sop" | "final-review" | "slice-decompose" | "issue-fix-orchestrator" | "perf-audit" | "security-audit" | "reviewer" | undefined;
-}, {
-    query?: string | undefined;
-    limit?: number | undefined;
-    tag?: string | undefined;
-    domain?: "code" | "status" | "resume" | "audit" | "content" | "test" | "ide" | "research" | "doctor" | "triage" | "sop" | "final-review" | "slice-decompose" | "issue-fix-orchestrator" | "perf-audit" | "security-audit" | "reviewer" | undefined;
-    includeInternal?: boolean | undefined;
-}>, {
-    limit: number;
-    includeInternal: boolean;
-    query?: string | undefined;
-    tag?: string | undefined;
-    domain?: "code" | "status" | "resume" | "audit" | "content" | "test" | "ide" | "research" | "doctor" | "triage" | "sop" | "final-review" | "slice-decompose" | "issue-fix-orchestrator" | "perf-audit" | "security-audit" | "reviewer" | undefined;
-}, {
-    query?: string | undefined;
-    limit?: number | undefined;
-    tag?: string | undefined;
-    domain?: "code" | "status" | "resume" | "audit" | "content" | "test" | "ide" | "research" | "doctor" | "triage" | "sop" | "final-review" | "slice-decompose" | "issue-fix-orchestrator" | "perf-audit" | "security-audit" | "reviewer" | undefined;
-    includeInternal?: boolean | undefined;
-}>;
+    domain: z.ZodOptional<z.ZodEnum<{
+        code: "code";
+        status: "status";
+        resume: "resume";
+        audit: "audit";
+        content: "content";
+        test: "test";
+        ide: "ide";
+        research: "research";
+        doctor: "doctor";
+        triage: "triage";
+        sop: "sop";
+        "final-review": "final-review";
+        "slice-decompose": "slice-decompose";
+        "issue-fix-orchestrator": "issue-fix-orchestrator";
+        "perf-audit": "perf-audit";
+        "security-audit": "security-audit";
+        reviewer: "reviewer";
+    }>>;
+    limit: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    includeInternal: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+}, z.core.$strip>;
 export type SkillSearchInput = z.input<typeof SkillSearchInputSchema>;
 export declare const SkillSearchResultSchema: z.ZodObject<{
     name: z.ZodString;
     description: z.ZodString;
-    triggers: z.ZodArray<z.ZodString, "many">;
-    tags: z.ZodArray<z.ZodString, "many">;
+    triggers: z.ZodArray<z.ZodString>;
+    tags: z.ZodArray<z.ZodString>;
     domain: z.ZodString;
     matchScore: z.ZodNumber;
-}, "strip", z.ZodTypeAny, {
-    name: string;
-    description: string;
-    domain: string;
-    triggers: string[];
-    tags: string[];
-    matchScore: number;
-}, {
-    name: string;
-    description: string;
-    domain: string;
-    triggers: string[];
-    tags: string[];
-    matchScore: number;
-}>;
+}, z.core.$strip>;
 export type SkillSearchResult = z.infer<typeof SkillSearchResultSchema>;
 /**
  * Search the in-tree skill pool. Validates `input` against

package/dist/services/skill/skill-search-service.js

@@ -51,8 +51,8 @@ export const SkillSearchInputSchema = z
     query: z.string().min(1).max(500).optional(),
     tag: z.string().min(1).max(100).optional(),
     domain: z.enum(SKILL_DOMAINS).optional(),
-    limit: z.number().int().min(1).max(100).optional().default(20),
-    includeInternal: z.boolean().optional().default(false)
+    limit: z.number().int().min(1).max(100).default(20).optional(),
+    includeInternal: z.boolean().default(false).optional()
 })
     .refine((v) => v.query !== undefined || v.tag !== undefined || v.domain !== undefined, { message: 'At least one of --query / --tag / --domain is required' });
 export const SkillSearchResultSchema = z.object({

package/dist/services/skills/hooks-settings-service.d.ts

@@ -173,6 +173,15 @@ export declare const HOOK_CODE_GATE_COMMAND = "peaks code-gate --json";
  * is also the inverse for uninstall: `removeHookInstall` rebuilds the deny
  * list by filtering out anything whose wrapped form matches one of these
  * ids.
+ *
+ * Slice rid-skill-persistence-001 (2026-08-12): four additional skills
+ * denied so the superpowers chain cannot silently override peaks-code.
+ * All four are referenced by `superpowers:using-superpowers` as the
+ * "bug → systematic-debugging / TDD / verification-before-completion /
+ * recursion via using-superpowers" auto-routing pattern — denying the
+ * trigger removes the auto-routing surface while leaving all four
+ * still readable as reference material from
+ * `references/external-skill-invocation.md`.
  */
 export declare const SUPERPOWERS_DENIED_SKILLS: ReadonlyArray<string>;
 /**

package/dist/services/skills/hooks-settings-service.js

@@ -298,13 +298,43 @@ function resolveLegacySentinels(ide) {
  * is also the inverse for uninstall: `removeHookInstall` rebuilds the deny
  * list by filtering out anything whose wrapped form matches one of these
  * ids.
+ *
+ * Slice rid-skill-persistence-001 (2026-08-12): four additional skills
+ * denied so the superpowers chain cannot silently override peaks-code.
+ * All four are referenced by `superpowers:using-superpowers` as the
+ * "bug → systematic-debugging / TDD / verification-before-completion /
+ * recursion via using-superpowers" auto-routing pattern — denying the
+ * trigger removes the auto-routing surface while leaving all four
+ * still readable as reference material from
+ * `references/external-skill-invocation.md`.
  */
 export const SUPERPOWERS_DENIED_SKILLS = [
     // superpowers:using-git-worktrees is the chain's "ground zero" — its
     // SKILL.md (lines 47-99) literally instructs the LLM to run
     // `git worktree add`. Denying this Skill at the IDE layer prevents the
     // LLM from ever receiving that prompt.
-    'superpowers:using-git-worktrees'
+    'superpowers:using-git-worktrees',
+    // Slice rid-skill-persistence-001: deny the "bug → systematic-debugging"
+    // auto-route. Without this entry the chain can preempt the current bee
+    // any time a bug report surfaces. Reference-only via
+    // references/external-skill-invocation.md §systematic-debugging.
+    'superpowers:systematic-debugging',
+    // Slice rid-skill-persistence-001: deny the TDD trigger that the chain
+    // pairs with bug reports (write-a-failing-test-first). Reference-only
+    // via references/external-skill-invocation.md §test-driven-development.
+    'superpowers:test-driven-development',
+    // Slice rid-skill-persistence-001: deny the verification-before-
+    // completion trigger that the chain uses to override "declare done"
+    // claims from peaks-code. Reference-only via
+    // references/external-skill-invocation.md §verification-before-completion.
+    'superpowers:verification-before-completion',
+    // Slice rid-skill-persistence-001: deny the recursive chain entrypoint
+    // itself. Without this entry the chain auto-spawns another
+    // "using-superpowers" Skill call right after the previous chain step,
+    // creating the recursive override pattern that peaks-loop's L1 guard
+    // cannot see through. Reference-only via
+    // references/external-skill-invocation.md §using-superpowers.
+    'superpowers:using-superpowers'
 ];
 function formatSuperpowersDenyEntry(skillId) {
     return `UseSkill(${skillId})`;

package/dist/services/skills/skill-presence-service.d.ts

@@ -132,7 +132,31 @@ export declare function checkStalePresence(opts?: {
  * clearing it prevents peaks-code Step 1 from picking up a stale
  * `mode` field that the user never explicitly chose.
  *
+ * Slice rid-skill-persistence-001 (2026-08-12): added an outerSessionId
+ * intent-source guard at the top of the function. The user constraint
+ * (preserved in `.peaks/memory/2026-08-11-peaks-code-skill-persistence-pause.md`)
+ * requires that "the current bee (peaks-code) can only be replaced or
+ * cleared when the user explicitly asks, or when the user invokes
+ * another non-bee Peaks skill; superpowers auto-hits, plain bug
+ * reports, compact, and outer-session rotations must NOT change the
+ * bee." Per the constraint, the `currentOuterSessionId` argument
+ * doubles as the caller-binding intent source: when the harness env
+ * var is set (`PEAKS_OUTER_SESSION_ID` or `CLAUDE_CODE_SESSION_ID`),
+ * the call was user-explicit and the existing 3-branch logic is
+ * authoritative; when the env var is absent (currentOuterSessionId
+ * is `undefined`), the rotation is system-triggered and MUST NOT
+ * mutate user-explicit presence state.
+ *
+ * The guard is the minimal surface that satisfies the user constraint
+ * while preserving the existing reconnect + live-different-outer +
+ * stale-clear behavior for the user-explicit path. No new arguments,
+ * no signature change — the 2 existing call sites
+ * (`init-command.ts:329-334`, `primer-command.ts:128-133`) keep
+ * working unchanged.
+ *
  * Only clears when:
+ *   - the caller supplies a user-explicit intent source
+ *     (`currentOuterSessionId !== undefined`), AND
  *   - the recorded outer session id does NOT match the current outer
  *     session id (i.e. the presence IS stale), AND
  *   - the recorded outer session id matches the just-rotated-out

package/dist/services/skills/skill-presence-service.js

@@ -439,7 +439,31 @@ export function checkStalePresence(opts) {
  * clearing it prevents peaks-code Step 1 from picking up a stale
  * `mode` field that the user never explicitly chose.
  *
+ * Slice rid-skill-persistence-001 (2026-08-12): added an outerSessionId
+ * intent-source guard at the top of the function. The user constraint
+ * (preserved in `.peaks/memory/2026-08-11-peaks-code-skill-persistence-pause.md`)
+ * requires that "the current bee (peaks-code) can only be replaced or
+ * cleared when the user explicitly asks, or when the user invokes
+ * another non-bee Peaks skill; superpowers auto-hits, plain bug
+ * reports, compact, and outer-session rotations must NOT change the
+ * bee." Per the constraint, the `currentOuterSessionId` argument
+ * doubles as the caller-binding intent source: when the harness env
+ * var is set (`PEAKS_OUTER_SESSION_ID` or `CLAUDE_CODE_SESSION_ID`),
+ * the call was user-explicit and the existing 3-branch logic is
+ * authoritative; when the env var is absent (currentOuterSessionId
+ * is `undefined`), the rotation is system-triggered and MUST NOT
+ * mutate user-explicit presence state.
+ *
+ * The guard is the minimal surface that satisfies the user constraint
+ * while preserving the existing reconnect + live-different-outer +
+ * stale-clear behavior for the user-explicit path. No new arguments,
+ * no signature change — the 2 existing call sites
+ * (`init-command.ts:329-334`, `primer-command.ts:128-133`) keep
+ * working unchanged.
+ *
  * Only clears when:
+ *   - the caller supplies a user-explicit intent source
+ *     (`currentOuterSessionId !== undefined`), AND
  *   - the recorded outer session id does NOT match the current outer
  *     session id (i.e. the presence IS stale), AND
  *   - the recorded outer session id matches the just-rotated-out
@@ -452,6 +476,15 @@ export function checkStalePresence(opts) {
  * decide what the "rotated-out" id was.
  */
 export function clearStalePresenceOnRotation(opts) {
+    // Slice rid-skill-persistence-001 (2026-08-12): user-explicit intent
+    // guard. When the caller has no caller-binding outerSessionId
+    // (env vars unset, system-triggered rotation), refuse the mutation
+    // up-front — the recorded presence may belong to a user-explicit
+    // invocation and auto-clear would silently destroy user intent.
+    // See `.peaks/memory/2026-08-11-peaks-code-skill-persistence-pause.md`.
+    if (opts.currentOuterSessionId === undefined) {
+        return { cleared: false, reason: 'no-intent-source' };
+    }
     const result = readSkillPresenceFromLease(opts.projectRootOverride);
     if (result === null) {
         return { cleared: false, reason: 'no-presence' };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "peaks-loop",
-  "version": "4.0.21",
+  "version": "4.0.24",
   "description": "Loop Engineering CLI — workflow primitive / loop guards / evaluators / slice orchestration",
   "author": "SquabbyZ",
   "keywords": [
@@ -95,16 +95,17 @@
   "dependencies": {
     "@alibaba-group/open-code-review": "^1.8.9",
     "@colbymchenry/codegraph": "0.7.10",
+    "@upstash/context7-mcp": "^4.0.2",
     "better-sqlite3": "^12.11.1",
     "commander": "^12.1.0",
     "fzf": "^0.5.2",
     "headroom-ai": "0.22.4",
     "yaml": "^2.9.0",
-    "zod": "^3.25.76",
-    "peaks-loop-internal-runtime": "0.0.6",
-    "peaks-loop-mut": "0.1.23",
-    "peaks-loop-shared": "0.0.55",
-    "peaks-loop-shared-channel": "0.0.27"
+    "zod": "^4.4.3",
+    "peaks-loop-internal-runtime": "0.0.9",
+    "peaks-loop-mut": "0.1.22",
+    "peaks-loop-shared": "0.0.58",
+    "peaks-loop-shared-channel": "0.0.26"
   },
   "devDependencies": {
     "@changesets/cli": "2.31.1",
@@ -123,8 +124,7 @@
     "tsx": "^4.19.2",
     "typescript": "^5.7.2",
     "vite": "^6.0.0",
-    "vitest": "^4.1.10",
-    "zod-to-json-schema": "^3.25.2"
+    "vitest": "^4.1.10"
   },
   "scripts": {
     "build": "node ./scripts/sync-version.mjs && node ./scripts/clean-dist.mjs && pnpm -r --filter \"./packages/*\" run build && tsc -p tsconfig.build.json && node ./scripts/copy-templates.mjs && node ./scripts/check-build-integrity.mjs",