peaks-loop 4.1.0 → 4.1.2

package/dist/services/rd/tactical-stage.js

@@ -1,7 +1,6 @@
 /**
  * Per spec §4.3 战术审计 (peaks-rd/战术) — orchestrator.
  * Runs AST gate first; only writes TACT.sig if gate passes.
- * Spec anchor: docs/superpowers/specs/2026-06-21-context-audit-redesign-design.md §4.3
  * (R1-W3 consolidation; previously referenced as §4.2 which is `peaks-mut`).
  */
 import { dirname } from 'node:path';

package/dist/services/rd-swarm/rd-swarm-types.d.ts

@@ -2,7 +2,6 @@
  * rd-swarm-types — the pure declaration surface of the RD swarm dry-run
  * planner (`rd-swarm-service.ts`).
  *
- * Slice rid-013 owns the planner behavior; this module owns only the graph
  * shapes (wave names, task records, conflict groups, and the task-graph
  * envelope). `rd-swarm-service.ts` imports and re-exports every name here, so
  * importers keep resolving them from the original path.

package/dist/services/rd-swarm/rd-swarm-types.js

@@ -2,7 +2,6 @@
  * rd-swarm-types — the pure declaration surface of the RD swarm dry-run
  * planner (`rd-swarm-service.ts`).
  *
- * Slice rid-013 owns the planner behavior; this module owns only the graph
  * shapes (wave names, task records, conflict groups, and the task-graph
  * envelope). `rd-swarm-service.ts` imports and re-exports every name here, so
  * importers keep resolving them from the original path.

package/dist/services/recommendations/installed-capability-detector.d.ts

@@ -3,15 +3,14 @@
  * detector for the capability catalog (`peaks capability status` /
  * `peaks capabilities --source ...`).
  *
- * Slice B1 of 2026-09-09-ecc-dynamic-and-cleanup: the previous
  * `getInstalledCapabilityIds()` returned `[]` unconditionally, so the
  * catalog could never report anything as installed. This module answers
  * the question from evidence that already exists on disk — no install
  * side effect, no network, no subprocess:
  *
- *   - `everything-claude-code.*` — satisfied when the ECC cache is
- *     populated (`~/.peaks/cache/ecc-installed.json` + at least one
- *     cached/materialized agent).
+ *   - `everything-claude-code.*` — satisfied when the ECC agents are readable,
+ *     i.e. `~/.peaks/agents/ecc/` holds at least one agent (landed by
+ *     `peaks ecc install` from the `ecc-universal` dependency).
  *   - a source that maps to an npm package — satisfied when that package
  *     (or its `.bin` shim) is present in the project's `node_modules`.
  *
@@ -23,8 +22,8 @@ export type InstalledCapabilityProbe = {
     readonly projectRoot: string;
     /** Override for tests; defaults to `<projectRoot>/node_modules`. */
     readonly nodeModulesDir?: string;
-    /** Override for tests; defaults to a live ECC cache probe. */
-    readonly eccCacheAvailable?: boolean;
+    /** Override for tests; defaults to a live probe of the materialized copy. */
+    readonly eccAgentsAvailable?: boolean;
 };
 /**
  * Return the capabilityIds whose acquisition is already satisfied.

package/dist/services/recommendations/installed-capability-detector.js

@@ -3,15 +3,14 @@
  * detector for the capability catalog (`peaks capability status` /
  * `peaks capabilities --source ...`).
  *
- * Slice B1 of 2026-09-09-ecc-dynamic-and-cleanup: the previous
  * `getInstalledCapabilityIds()` returned `[]` unconditionally, so the
  * catalog could never report anything as installed. This module answers
  * the question from evidence that already exists on disk — no install
  * side effect, no network, no subprocess:
  *
- *   - `everything-claude-code.*` — satisfied when the ECC cache is
- *     populated (`~/.peaks/cache/ecc-installed.json` + at least one
- *     cached/materialized agent).
+ *   - `everything-claude-code.*` — satisfied when the ECC agents are readable,
+ *     i.e. `~/.peaks/agents/ecc/` holds at least one agent (landed by
+ *     `peaks ecc install` from the `ecc-universal` dependency).
  *   - a source that maps to an npm package — satisfied when that package
  *     (or its `.bin` shim) is present in the project's `node_modules`.
  *
@@ -20,7 +19,7 @@
  */
 import { existsSync } from 'node:fs';
 import { join } from 'node:path';
-import { hasMaterializedEccAgents, listCachedAgents } from 'peaks-loop-mut';
+import { hasMaterializedEccAgents } from 'peaks-loop-mut';
 import { seedCapabilityItems } from './capability-seed-items.js';
 const ECC_SOURCE_ID = 'everything-claude-code';
 /**
@@ -42,12 +41,13 @@ function packagePresent(nodeModulesDir, packageName) {
         return false;
     }
 }
-function eccCacheAvailable() {
+function eccAgentsAvailable() {
     try {
-        // Cached agents imply the manifest + sha dir exist; the materialized
-        // plugin-free copy is checked independently so a hand-populated
-        // `~/.peaks/agents/ecc/` still counts as satisfied.
-        return listCachedAgents().length > 0 || hasMaterializedEccAgents();
+        // The materialized copy is what the LLM can dispatch, so it is the only
+        // evidence that counts. The cache probe this replaced
+        // (`listCachedAgents()`, reading `~/.peaks/cache/ecc-<sha>/`) described
+        // something downloaded but not necessarily usable.
+        return hasMaterializedEccAgents();
     }
     catch {
         return false;
@@ -59,7 +59,7 @@ function eccCacheAvailable() {
  */
 export function detectInstalledCapabilityIds(probe) {
     const nodeModulesDir = probe.nodeModulesDir ?? join(probe.projectRoot, 'node_modules');
-    const eccAvailable = probe.eccCacheAvailable ?? eccCacheAvailable();
+    const eccAvailable = probe.eccAgentsAvailable ?? eccAgentsAvailable();
     const installed = new Set();
     for (const item of seedCapabilityItems) {
         if (item.sourceId === ECC_SOURCE_ID) {

package/dist/services/release/version-precheck-service.d.ts

@@ -1,12 +1,10 @@
 /**
- * rid-010 — peaks release precheck (Phase 4 slice 1).
  *
  * Module path: src/services/release/version-precheck-service.ts
  * Mirrors publish.yml gate-cli-version §(A) — verified in code 2026-10-03, not
  * just per the old comment: `runRootVsShared` covers §(A)'s shared-dist check;
  * §(A′) (runtime RUNTIME_VERSION) has no layer here, and the §(B)
  * tarball-content gate (Layer 5 of the 5-layer root cause) stays CI-only —
- * AC-7 grep test pins publish.yml so §(B) cannot drift silently.
  *
  * 4-layer version precheck. Designed to run BEFORE `peaks release canary` so
  * developers catch CLI_VERSION lag / tag collision / changeset staged /

package/dist/services/release/version-precheck-service.js

@@ -1,12 +1,10 @@
 /**
- * rid-010 — peaks release precheck (Phase 4 slice 1).
  *
  * Module path: src/services/release/version-precheck-service.ts
  * Mirrors publish.yml gate-cli-version §(A) — verified in code 2026-10-03, not
  * just per the old comment: `runRootVsShared` covers §(A)'s shared-dist check;
  * §(A′) (runtime RUNTIME_VERSION) has no layer here, and the §(B)
  * tarball-content gate (Layer 5 of the 5-layer root cause) stays CI-only —
- * AC-7 grep test pins publish.yml so §(B) cannot drift silently.
  *
  * 4-layer version precheck. Designed to run BEFORE `peaks release canary` so
  * developers catch CLI_VERSION lag / tag collision / changeset staged /
@@ -54,7 +52,6 @@ export function runRootVsShared(opts) {
     try {
         const raw = readFileSync(sharedDist, 'utf8');
         // Quote-tolerant: the old double-quote-only regex blanked on prettier's
-        // single-quoted emit (rid 2026-10-03-release-gate-quote-brittle).
         const match = raw.match(/CLI_VERSION\s*=\s*(?:"([^"]+)"|'([^']+)'|`([^`]+)`)/);
         const captured = match?.[1] ?? match?.[2] ?? match?.[3];
         if (captured !== undefined) {

package/dist/services/retrospective/retrospective-index.d.ts

@@ -2,7 +2,6 @@
  * retrospective-index — load `.peaks/retrospective/index.json`, parse to
  * `RetrospectiveEntry[]`, return the index envelope.
  *
- * Slice 023 (R3). Pure read on the hot path: a single `fs.readFile` of
  * the index, no MD-tree fallback. The migration script (G9) is the only
  * writer; this loader is read-only.
  */

package/dist/services/retrospective/retrospective-index.js

@@ -2,7 +2,6 @@
  * retrospective-index — load `.peaks/retrospective/index.json`, parse to
  * `RetrospectiveEntry[]`, return the index envelope.
  *
- * Slice 023 (R3). Pure read on the hot path: a single `fs.readFile` of
  * the index, no MD-tree fallback. The migration script (G9) is the only
  * writer; this loader is read-only.
  */

package/dist/services/retrospective/retrospective-show.d.ts

@@ -3,7 +3,6 @@
  * body on-demand from `artifactPaths` (concatenate with `---` separator),
  * apply `formatMdCompact` by default, return the JSON envelope.
  *
- * Slice 023 (R3). The on-disk MD form is gone after the G9 migration; the
  * body is re-hydrated from the source PRD / RD / QA / TXT artifacts. If
  * a referenced artifact is missing on disk, `show` returns a
  * `ARTIFACT_MISSING` envelope (PRD R3) and does not crash.

package/dist/services/retrospective/retrospective-show.js

@@ -3,7 +3,6 @@
  * body on-demand from `artifactPaths` (concatenate with `---` separator),
  * apply `formatMdCompact` by default, return the JSON envelope.
  *
- * Slice 023 (R3). The on-disk MD form is gone after the G9 migration; the
  * body is re-hydrated from the source PRD / RD / QA / TXT artifacts. If
  * a referenced artifact is missing on disk, `show` returns a
  * `ARTIFACT_MISSING` envelope (PRD R3) and does not crash.

package/dist/services/reviewer/model-family.js

@@ -1,6 +1,5 @@
 /**
  * model-family.ts — derive `modelFamily` from a `modelId` for the G4
- * third-party reviewer. AC-4.4 requires that
  * `third-party-review.json.modelFamily !== karpathy-review.json.modelFamily`,
  * so the family bucket must be stable, provider-distinguishing, and
  * version-tolerant (e.g. `claude-opus-4-8` and `claude-haiku-4-5` both

package/dist/services/reviewer/reviewer-config.js

@@ -1,6 +1,5 @@
 /**
  * reviewer-config.ts — load the `reviewer` section from
- * `~/.peaks/config.json`. AC-4.1 mandates:
  *   - providers[] (>=2 entries; ollama / anthropic / openai supported)
  *   - selection: 'round-robin' | 'hash(rid)' | 'random'
  *   - rdProviderName: string | null

package/dist/services/reviewer/reviewer-service.d.ts

@@ -16,7 +16,6 @@ export declare function extractFirstJsonObject(text: string): unknown | null;
 export declare function runReviewer(input: ReviewerRunInput): Promise<ReviewerRunOutput>;
 /**
  * Compute the distinctness verdict: returns true when the third-party
- * reviewer's modelFamily differs from the karpathy reviewer's. AC-4.4
  * mandates this is a CI gate — equality fails the build.
  */
 export declare function distinctFromKarpathy(thirdPartyFamily: string, karpathyFamily: string): boolean;

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

@@ -1,7 +1,6 @@
 /**
  * reviewer-service.ts — orchestrator for the G4 third-party reviewer.
  *
- * Flow (per AC-4.1 .. AC-4.6):
  *   1. Load `reviewer` section from `~/.peaks/config.json` (reviewer-config).
  *      Missing section => `{ ok: false, reason: 'no-reviewer-config' }`.
  *   2. Pick a provider by selection mode (round-robin / hash / random).
@@ -243,7 +242,6 @@ export async function runReviewer(input) {
         };
     }
     // Stamp modelFamily from the actual modelId we called — prevents the LLM
-    // from lying about its family and bypassing AC-4.4.
     const stamped = {
         ...validated,
         modelId: result.provider.model,
@@ -254,7 +252,6 @@ export async function runReviewer(input) {
 }
 /**
  * Compute the distinctness verdict: returns true when the third-party
- * reviewer's modelFamily differs from the karpathy reviewer's. AC-4.4
  * mandates this is a CI gate — equality fails the build.
  */
 export function distinctFromKarpathy(thirdPartyFamily, karpathyFamily) {

package/dist/services/reviewer/selection-strategies.js

@@ -1,6 +1,5 @@
 /**
  * selection-strategies.ts — pick a provider per rid for the G4 third-party
- * reviewer. AC-4.6 requires:
  *   - `round-robin` cycles across providers across slices
  *   - `hash(rid)` is stable per rid (deterministic replay)
  *   - `random` is uniform over the provider set

package/dist/services/runtime/runtime-detector.js

@@ -1,5 +1,4 @@
 /**
- * Runtime detector — slice S2-a of RD-2.
  *
  * Given the current process environment, decide which vendor (if any)
  * is the active AI runtime. Detection order matters: Claude Code is

package/dist/services/runtime/runtime-service.d.ts

@@ -1,5 +1,4 @@
 /**
- * Runtime service — slice S2-a of RD-2.
  *
  * Orchestrator that wires the runtime detector + vendor adapter
  * registry into a small surface that the CLI commands call. The
@@ -12,7 +11,6 @@
  *  - The service is a thin orchestrator — it does NOT contain any
  *    vendor verb strings (claude / codex / copilot). All vendor verbs
  *    live in `src/services/runtime/vendors/<vendor>.ts`. Verified by
- *    AC-1.
  *  - When `compactVia(id)` is called with an unknown id, the service
  *    returns a "no-op" result with exitCode=0 and a warning instead of
  *    throwing — vendor-neutrality means peaks-loop MUST keep working

package/dist/services/runtime/vendor-adapter.d.ts

@@ -1,5 +1,4 @@
 /**
- * Vendor adapter contract — slice S2-a of RD-2 (2026-07-08 session).
  *
  * Each `VendorAdapter` is a thin wrapper around ONE AI runtime (Claude
  * Code / Codex / Copilot / custom) that knows how to:
@@ -25,11 +24,9 @@
  * orchestrates these adapters (runtime-service.ts) and the CLI commands
  * (`peaks runtime compact --via <id>`) MUST NOT contain vendor verbs.
  *
- * Slice 2026-09-12-auto-compact-vendor-neutrality widened AC-1's scope from
  * `src/services/code/` to ALL of `src/`, and had to change how it is
  * enforced. Both changes came from measurement:
  *
- *   - The old scope excluded the files that carried the defect AC-1
  *     describes — the compact dispatcher (`src/services/context/`) and the
  *     hook installer (`src/services/hooks/`) — so it returned 0 by
  *     construction. A grep over a directory that does not contain the code
@@ -40,15 +37,11 @@
  *     in `src/services/ide/adapters/claude-code-adapter.ts` — the one place
  *     the string is supposed to be. A text grep measures prose, not code.
  *
- * AC-1 is therefore enforced by the AST-based check in
  * `tests/unit/runtime/vendor-neutral-identity-guard.test.ts`: no vendor
  * verb in any STRING LITERAL of `src/` outside the adapter implementations.
  * Parsed, the count is 1 and the single hit is that adapter — which is the
- * property AC-1 was always about.
  *
- * AC-1 covers VERB STRINGS only. The compact path's defects were IDENTITY
  * COMPARISONS (`ideId !== 'claude-code'`), a second shape the same guard
- * file covers and AC-1 never could. Read that guard's header for what
  * neither check catches before treating vendor neutrality as proven.
  *
  * See `.peaks/_runtime/2026-07-08-session-17918f/prd/002-adapter-runtime-and-polyrepo.md`

package/dist/services/runtime/vendors/claude-code.js

@@ -1,5 +1,4 @@
 /**
- * Claude Code vendor adapter — slice S2-a.
  *
  * Stubs the compact verb to `claude --compact` (the canonical vendor
  * verb for Claude Code). The actual binary is invoked via spawn so

package/dist/services/runtime/vendors/codex.js

@@ -1,5 +1,4 @@
 /**
- * Codex vendor adapter — slice S2-a.
  *
  * Stub adapter (PRD out-of-scope: full implementation lands in a
  * future slice). The detect() heuristic is intentionally permissive:

package/dist/services/runtime/vendors/copilot.js

@@ -1,5 +1,4 @@
 /**
- * Copilot vendor adapter — slice S2-a.
  *
  * Stub adapter (PRD out-of-scope: full implementation lands in a
  * future slice). Copilot's compact verb is `copilot compact`

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

@@ -87,7 +87,6 @@ function mapSyncState(syncStatus) {
 }
 function getCurrentArtifactDir(artifactWorkspacePath) {
     const peaksPath = getPeaksPath(artifactWorkspacePath);
-    // Slice 2026-06-29-change-id-root-removal: the `.peaks/_runtime/current-change`
     // binding file is gone. Resolve the active change-id from the workspace
     // session binding instead. When no session is bound, fall back to
     // `unknown-session` (matches the previous behaviour for an unbound workspace).
@@ -102,7 +101,6 @@ function getCurrentArtifactDir(artifactWorkspacePath) {
     };
 }
 function getRetentionChangeDir(artifactWorkspacePath, sliceId) {
-    // Slice 2026-06-29-change-id-root-removal: retention slice dirs
     // remain under the legacy `.peaks/<sliceId>/` shape (they're shipped
     // / frozen artifacts, not session-scoped workspace state). Only the
     // ACTIVE session-dir resolution uses `_runtime/` — retention slices
@@ -163,7 +161,6 @@ function readActiveSkillSessionId(projectRoot) {
  * Read the workspace session binding and return its `sessionId`,
  * or null when the file is missing / malformed.
  *
- * As of slice 2026-06-05-peaks-runtime-layer the canonical home is
  * `<projectRoot>/.peaks/_runtime/session.json`. The legacy
  * `<projectRoot>/.peaks/.session.json` is consulted as a
  * one-minor-release back-compat fallback: if the new path is
@@ -199,7 +196,6 @@ function readSessionJsonBinding(projectRoot) {
  * session does not own the slice.
  */
 function sessionOwnsSlice(projectRoot, sessionId, sliceId) {
-    // As of slice 2026-06-05-change-id-as-unit-of-work, the same
     // session id can live at multiple umbrella locations:
     //   - `.peaks/_runtime/<sessionId>/` (legacy or top-level active)
     //   - `.peaks/retrospective/<sessionId>/` (shipped slice)
@@ -238,7 +234,6 @@ function findSessionOwningSlice(projectRoot, sliceId) {
         return null;
     }
     topLevel.sort();
-    // As of slice 2026-06-05-change-id-as-unit-of-work, shipped slices
     // are archived under `.peaks/retrospective/<dir>/` and dogfood
     // evidence lives under `.peaks/_dogfood/<dir>/`. Both umbrellas host
     // scopes at one level deeper than the top-level `.peaks/_runtime/<dir>/`
@@ -369,7 +364,6 @@ export function getChangeTraceabilityStatus() {
         const artifactPath = resolve(changeDir, ...artifact.path);
         return {
             name: artifact.name,
-            // Slice 2026-06-29-change-id-root-removal: the reported path
             // matches the canonical single-axis layout
             // `.peaks/_runtime/<sid>/...`.
             path: resolve(peaksPath, '_runtime', sessionId ?? '<session-id>', ...artifact.path),

package/dist/services/scan/acceptance-coverage-service.js

@@ -107,10 +107,8 @@ export async function getAcceptanceCoverage(options) {
     if (prdArtifact === null) {
         return { kind: 'prd-not-found' };
     }
-    // As of slice 2026-06-05-change-id-as-unit-of-work, test-cases live
     // under the same change-id dir as the PRD itself (the on-disk scope),
     // not under the body's `- session:` line. Slice
-    // 2026-06-29-change-id-root-removal stripped the legacy
     // `.peaks/_runtime/change/<id>/` indirection — test-cases now live
     // under the canonical session dir `.peaks/_runtime/<sid>/qa/test-cases/`.
     // `prdArtifact.sessionId` is the bare session id (the dir the PRD was

package/dist/services/scan/api-diff-recorded.d.ts

@@ -3,7 +3,6 @@
  * plus the candidate name-grep.
  *
  *   1. `.peaks/_runtime/<sid>/rd/mock-plan.md`  (most recent by mtime)
- *   2. recorded `*-api.types.ts` interfaces     (from (1) + `src/services/types`)
  *   3. the `## API Migration` endpoint list in `.peaks/_runtime/<sid>/txt/*.md`
  *
  * All three are OPTIONAL: absence is reported in the report's `notes`, never

package/dist/services/scan/api-diff-recorded.js

@@ -3,7 +3,6 @@
  * plus the candidate name-grep.
  *
  *   1. `.peaks/_runtime/<sid>/rd/mock-plan.md`  (most recent by mtime)
- *   2. recorded `*-api.types.ts` interfaces     (from (1) + `src/services/types`)
  *   3. the `## API Migration` endpoint list in `.peaks/_runtime/<sid>/txt/*.md`
  *
  * All three are OPTIONAL: absence is reported in the report's `notes`, never

package/dist/services/scan/api-diff-service.d.ts

@@ -1,6 +1,5 @@
 /**
  * S1 / rid=api-diff-report — `peaks scan api-diff <doc>` (design
- * `docs/superpowers/specs/2026-09-12-frontend-acl-contract-design.md` §2.1/§2.3).
  *
  * Read-only. Parses an OpenAPI 3.x document (JSON or YAML — `yaml` is already a
  * runtime dependency) and diffs it against the three sources a consumer project

package/dist/services/scan/api-diff-service.js

@@ -1,6 +1,5 @@
 /**
  * S1 / rid=api-diff-report — `peaks scan api-diff <doc>` (design
- * `docs/superpowers/specs/2026-09-12-frontend-acl-contract-design.md` §2.1/§2.3).
  *
  * Read-only. Parses an OpenAPI 3.x document (JSON or YAML — `yaml` is already a
  * runtime dependency) and diffs it against the three sources a consumer project

package/dist/services/scan/api-diff-types.d.ts

@@ -1,6 +1,5 @@
 /**
  * S1 / rid=api-diff-report — shared types for `peaks scan api-diff <doc>`
- * (design `docs/superpowers/specs/2026-09-12-frontend-acl-contract-design.md`
  * §2.1/§2.3).
  *
  * GOVERNING PRINCIPLE (QA repair): exactness requires BOTH sides to be fully

package/dist/services/scan/api-diff-types.js

@@ -1,6 +1,5 @@
 /**
  * S1 / rid=api-diff-report — shared types for `peaks scan api-diff <doc>`
- * (design `docs/superpowers/specs/2026-09-12-frontend-acl-contract-design.md`
  * §2.1/§2.3).
  *
  * GOVERNING PRINCIPLE (QA repair): exactness requires BOTH sides to be fully

package/dist/services/scan/archetype-detection.d.ts

@@ -30,6 +30,43 @@ export declare function readPackageJsonDeps(projectRoot: string): Promise<{
     deps: Record<string, string>;
 }>;
 export declare function detectBackendFrameworks(deps: Record<string, string>): Promise<string[]>;
+/**
+ * Manifests that only a service writes. Language-diverse on purpose: every
+ * other probe in this file is Node-specific, and a repository whose backend is
+ * Go / Java / Kotlin / Python / Ruby / PHP / Rust has no Node manifest at all,
+ * so a Node-only evidence set reported it as `frontendOnly`.
+ */
+export declare const SERVICE_ONLY_MANIFEST_FILES: string[];
+/**
+ * Manifests a service MAY write and a library or CLI also writes. Counted as
+ * backend evidence only when the file itself names a web framework — the
+ * alternative is a boolean that fires on any Python or Rust directory, which
+ * trades one wrong answer for another.
+ */
+export declare const CONDITIONAL_SERVICE_MANIFESTS: ReadonlyArray<readonly [string, RegExp]>;
+/**
+ * How deep from the project root a service is allowed to sit before its
+ * manifest stops being counted. Two levels covers the layouts that were
+ * invisible (`apps/gateway/package.json`, `services/checkout/requirements.txt`,
+ * `web/` + `cmd/server`), and a deeper walk would read generated trees.
+ */
+export declare const SERVICE_MANIFEST_MAX_DEPTH = 2;
+/**
+ * Backend evidence that lives OUTSIDE the root manifest: a workspace package's
+ * own `package.json`, and any non-Node service manifest.
+ *
+ * Returns `dir: evidence` strings (`apps/gateway: express`, `go.mod`,
+ * `services/checkout: requirements.txt`) rather than a boolean, because the
+ * whole defect this probe closes was a verdict that could not say what it saw.
+ */
+export declare function detectNestedServiceEvidence(projectRoot: string, backendDepNames?: readonly string[]): Promise<string[]>;
+/**
+ * Next.js server actions: `'use server'` in a file under `app/`. Route handlers
+ * under `pages/api` / `app/api` were the only Next backend the detector knew
+ * about, so a Next app that mutates data through actions — the documented
+ * Next.js way — was reported as having no backend at all.
+ */
+export declare function detectNextServerActions(projectRoot: string): Promise<boolean>;
 export declare function detectNextApiRoutes(projectRoot: string, hasNext: boolean): Promise<boolean>;
 export declare function detectBackendDirs(projectRoot: string): Promise<string[]>;
 export declare function detectSwagger(projectRoot: string): Promise<string[]>;