specguard-mcp 0.1.39 → 0.1.41

package/README.md

@@ -40,7 +40,7 @@ refuses to boot and takes the tools that needed no configuration down with it.
 | `SPECGUARD_TIMEOUT_MS` | HTTP tools | `30000` | how long a call to SpecGuard may take |
 
 `SPECGUARD_ENDPOINT` and `SPECGUARD_API_KEY` are the same variables
-[`specguard-rspec`](https://github.com/yatfa-ai/specguard-rspec) uses to ship a run, so a repository
+[`specguard-ruby`](https://github.com/yatfa-ai/specguard-ruby) uses to ship a run, so a repository
 that already posts telemetry to SpecGuard already has them. `SPECGUARD_USER_API_KEY` is **not** one
 of them — the gem has no notion of a user key — so that one is minted and set here for the first
 time.
@@ -199,14 +199,15 @@ before any request is made.
 | `repeated_description` | open ONE repeated description and list the examples that all share it |
 | `unstable_test` | open ONE flaky test and list its outcome run by run across the window, newest run first (needs `branch`) |
 | `commit_sha` | anchor the answer on ONE named run instead of the repository's newest one — every run-grain block moves with it, `history` does not |
+| `layer` | narrow ONLY `latest_run.slowest_examples` to one declared layer (`unit`, `integration`, `request`, `system` or `undeclared`) — see below |
 | `unannotated_examples` | `true` to list the individual tests carrying no `@intent` — the examples behind the annotated ratio, each labelled with what SpecGuard reads of it — and, in the same answer, which areas carry the most of them |
 
 `branch` narrows `history` only — `latest_run` always names the repository's newest run, which on a
 busy repo may be on another branch. That is a property of the endpoint, not of this bridge — and
 `commit_sha` is the remedy: it names WHICH RUN to describe, where `branch` asks about a series. Every
-run-grain block re-anchors together (`latest_run` and its rollups, the four run-grain drill-ins —
-`spec_directory_files`, `spec_file_examples`, `repeated_description_examples`, `unannotated_examples`
-— `shards`, both growth windows, `previous_test_run`); `history` does not, so the
+run-grain block re-anchors together (`latest_run` and its rollups, the five run-grain drill-ins —
+`spec_directory_files`, `spec_file_examples`, `repeated_description_examples`, `unannotated_examples`,
+`slowest_examples` — `shards`, both growth windows, `previous_test_run`); `history` does not, so the
 `history[0] == latest_run` identity holds
 on a default call and is **not** expected to hold under an explicit ask. Nor does `unstable_test_runs`,
 which is read over the branch window rather than off the anchored run. (`unannotated_directories`,
@@ -224,8 +225,8 @@ successful response is about the commit you named.
 it: `unstable_tests` (which tests failed intermittently across the window rather than consistently)
 and `directory_growth` (how each area moved between the two **endpoints** of the window). The
 per-area comparisons against the **previous run** — `directory_run_growth` at the example-count
-grain and `directory_runtime_growth` at the runtime grain — are a different question and take no
-branch at all: they scope to the latest run's own branch by construction, so a plain unparameterised
+grain, `directory_runtime_growth` at the runtime grain, and `layer_run_growth` for the declared-layer
+mix — are a different question and take no branch at all: they scope to the latest run's own branch by construction, so a plain unparameterised
 call already carries them. The two grains are independent, which is why both ship: making an
 existing spec slow adds zero examples and shows up only in the runtime pair, and splitting one slow
 spec into four fast ones is `+3` examples and *less* time.
@@ -233,8 +234,8 @@ spec into four fast ones is `+3` examples and *less* time.
 `spec_directories` ranks the heaviest areas but stops at the area grain, so it says *where* the time
 went and not *which files* spent it. `spec_directory` is the next question: pass a path exactly as
 served in `latest_run.spec_directories.rows[].path` and `latest_run.spec_directory_files` opens with
-the files in that one directory (`total_seconds`, `recorded_count`, `timed_count` each), plus the
-**area's** own `file_count`/`recorded_count`/`timed_count` and the `limit` the row list was cut at —
+the files in that one directory (`total_seconds`, `recorded_count`, `timed_count`, `layer_counts`
+each), plus the **area's** own `layer_counts`, `file_count`/`recorded_count`/`timed_count` and the `limit` the row list was cut at —
 those totals describe the whole area, not the returned page, so don't re-derive them from `rows`.
 Omit the argument and the key is `null`, meaning *you did not ask*; an area the run recorded nothing
 for answers `rows: []` rather than an error, so a renamed or deleted directory is an empty result and
@@ -250,7 +251,8 @@ two are the answer to the question the area-grain comparisons dead-end on — `s
 most and not *which examples* inside them spent it. `spec_file` is the next question: pass a path
 exactly as served in `latest_run.spec_files.rows[].path` and `latest_run.spec_file_examples` opens
 with up to 50 of that file's individual examples, cut by **duration** (`name`, `file_path`,
-`line_number`, `spec_file_path`, `duration_seconds`, `outcome` each), plus the **file's** own
+`line_number`, `spec_file_path`, `duration_seconds`, `outcome`, `intent_layer`, `declared_intent`
+each — eight fields), plus the **file's** own
 `recorded_count`/`timed_count` and the `limit` the row list was cut at — those totals describe the
 whole file, not the returned page, so don't re-derive them from `rows`. Omit the argument and the
 key is `null`, meaning *you did not ask*; a path that matched nothing answers `rows: []` rather than
@@ -260,7 +262,7 @@ an error, so a renamed or deleted spec file and a stale bookmark are empty resul
 ranking — but names the description and the files it was seen in, not *which* examples say the same
 thing. `repeated_description` is the next question: pass a description exactly as served in
 `latest_run.repeated_descriptions.rows[].name` and `latest_run.repeated_description_examples` opens
-with up to 25 of that group's members (the same six fields), plus the **group's** own
+with up to 25 of that group's members (the same eight fields), plus the **group's** own
 `recorded_count`/`timed_count` and the `limit` the row list was cut at — again totals for the whole
 group and not for the returned page. This is the **only** way to reach a group's members:
 `slowest_examples` is the run-wide top ten and rarely contains them, and walking `spec_file` over
@@ -281,6 +283,14 @@ description's rows run by run in window order, **newest run first**, up to 200 (
 `recorded_count`/`reported_outcome_count`/`unreported_outcome_count`, the window's `run_count` and
 the `limit` the row list was cut at.
 
+Every row of `unstable_tests.rows[]` and of `unstable_tests.shared_description_rows[]` also carries
+`declared_layers` — the sorted distinct set of `@intent layer:` values that test's examples declared
+anywhere in the window. `[]` means no run in the window declared one: it is not `unreadable` and not
+a measured `unit`. A partially annotated test lists only what was declared, and more than one entry
+means the test changed layer mid-window. It is declared-only — the stored column, never inferred from
+the spec path or `files_seen`. The `unstable_test_runs` drill-in rows do **not** carry a layer, so
+read `declared_layers` off the ranking row.
+
 Note the two ways it differs from the drill-ins above. The answer lands **inside** the flakiness
 block — `unstable_tests.unstable_test_runs`, not under `latest_run.*` — and `branch` is a hard
 prerequisite rather than a suggestion: `unstable_tests` is `null` without it, so `unstable_test` sent
@@ -316,7 +326,51 @@ never render that subtraction as blindness. A derived reading is genuinely weake
 one — no preconditions, a behavior written for a test runner's output rather than declared, and a
 layer inferred from the directory — so report it as inferred and never as equivalent. And
 `authored` never replaces `annotated_ratio`: "how much of this suite has a human-written intent" is
-still that figure, off the run's own counters. It is the one argument
+still that figure, off the run's own counters.
+
+**Which layer the suite declares is a third, separate question**, answered on every response by
+`latest_run.layer_counts`, a sibling of `intent_readings`: five operands — `unit`, `integration`,
+`request`, `system` and `undeclared` — that sum to `intent_readings.recorded`. It is `null`, **not
+five zeros**, when the run stored no per-example rows, because a zero would read as a measured none.
+The layers are **declared only** — an `@intent` annotation said so — and **never inferred from the
+directory path**: a test under `spec/models` that declared nothing is `undeclared`, and `undeclared`
+is **not** `unreadable` (a test can be perfectly readable and declare no layer). The operands carry no
+pyramid verdict; reading the mix is yours. **Where the machine time went by layer** is
+`latest_run.layer_durations`, a sibling of `layer_counts` with the same five keys, each
+`{total_seconds, timed_count}`. `total_seconds` is `null`, **not 0**, for a layer with no timed example,
+so an untimed layer is not a free one; `timed_count` (at most that layer's `layer_counts` entry) is the
+real denominator for any average. The whole key is `null` when the run stored no per-example rows. It is
+a **sum** of example durations — machine time and **not wall clock** — so it can exceed
+`duration_seconds` on a parallel or sharded run. The layer is **declared only**, never inferred from the
+path, and the operands carry no pyramid verdict. **Which tests those are**: pass `layer`
+(`unit`, `integration`, `request`, `system` or `undeclared`) to narrow `latest_run.slowest_examples`
+— and only that block — to one declared layer; it is echoed as `slowest_examples.layer` only when
+asked, `recorded_count`/`timed_count`/`reported_outcome_count` become that layer's own counts, any
+other value is read by the server as no ask (so it is forwarded unvalidated), and `rows: []` with
+`recorded_count: 0` means that layer has no examples while `slowest_examples: null` means the run
+recorded nothing. **How the declared-layer mix moved since the previous
+run** is `layer_run_growth`, with its contract block `layer_run_growth_window` — both **top-level
+siblings of `directory_run_growth`**, not inside `latest_run` (the delta is not in
+`latest_run.layer_counts`). They compare the latest run with the previous run **on the latest run's own
+branch**, so no `branch` is needed, and `commit_sha` re-anchors them with the rest of the run-grain
+blocks. `layer_run_growth` is `null` in **every** non-comparable state — **never a block of zeros**, so
+`null` is not "no change" — and `layer_run_growth_window.state` names why: `latest_unmeasured`,
+`previous_unmeasured`, `assembled_differently`, `neither_recorded`, `previous_unrecorded`,
+`latest_unrecorded`, or `comparable`, plus `no_latest_run` (CI never reported) and `no_previous_run`
+(the first run on the branch). `layer_run_growth_window.comparable` is true exactly when
+`layer_run_growth` is non-null; the window also carries `basis`, `branch`, `anchor_commit_sha` and
+`baseline_commit_sha`. When comparable, `layer_run_growth` is
+`{layers, baseline_recorded_count, anchor_recorded_count}`, where `layers` holds `unit`, `integration`,
+`request`, `system` and `undeclared`, each `{baseline_count, anchor_count, change}`. A layer that did not
+move reads `change: 0` — a **measured zero**, not an absence — and the five `change` values sum to
+`anchor_recorded_count` minus `baseline_recorded_count`. The layers are **declared only**, never inferred
+from the path, `undeclared` is **not** `unreadable`, and the operands carry no pyramid verdict. The same
+`layer_counts` rides each row of
+`spec_directories`, the `spec_directory_files` area block and each of its file rows, and every
+per-example row of `slowest_examples`, `spec_file_examples` and `repeated_description_examples`
+carries `intent_layer` and `declared_intent` (`{entity, action, behavior}` or `null`, declared only).
+
+The `unannotated_examples` flag is the one argument
 here that is a **flag rather than a name** — pass `true`, not a value — because it opens a
 *population* rather than a pick: `total_specs` minus `annotated_specs` is a subtraction, and a
 subtraction has no line to name. Which population is still yours to choose: sent alone the flag
@@ -324,8 +378,8 @@ opens the whole run, and sent **together with** `spec_file` or `spec_directory`
 file, that area, or the AND of the two — those two keep opening their own blocks as well, so
 narrowing this one is additional rather than instead. `latest_run.unannotated_examples` opens with
 up to 100 of the unannotated examples **of whatever you asked for** (`name`, `file_path`,
-`line_number`, `spec_file_path`, `reading` and `derived_intent` each — six fields, and not the
-per-example drill-ins' six: no `duration_seconds` and no `outcome`), plus that
+`line_number`, `spec_file_path`, `reading` and `derived_intent` each — six fields, unlike the
+per-example drill-ins' eight: no `duration_seconds`, no `outcome`, no `intent_layer`), plus that
 same population's own `recorded_count`, `derived_count` and `unreadable_count`, the `limit` the row
 list was cut at, and
 `spec_file`/`spec_directory` **echoed back** as the server read them — `null` for each one you did
@@ -500,7 +554,7 @@ blank value is no ask: passing an empty string and omitting the argument make th
 | --- | --- |
 | `q` | keep only repositories whose `full_name` (`org/repo`) contains this substring, case-insensitively. A plain substring, not a pattern — the LIKE wildcards `%`/`_` are escaped server-side, so `org/my_repo` matches itself. A match-less ask is an empty list, not an error |
 | `role` | `"owned"` or `"shared"` — one half of the list's mix: the repositories this person owns, or the ones shared with them. Mind the spelling: the *ask* values are `owned`/`shared`, while each entry's `role` field reads `owner`/`member` — `role: "owner"` is not a valid ask and settles to no ask (full list, no error). Under the `sga_…` agent key the ask settles to no ask for every value: ownership is a person fact and the key speaks for nobody, so the full granted list is served |
-| `sort` | `"stale"` — re-order stalest-first: repositories CI has never ingested a run for first, then least-recently-ingested, with `full_name` breaking ties so two calls agree element for element. The same entries, a different order; the default order stays `full_name` ascending |
+| `sort` | `"stale"` — re-order stalest-first: repositories CI has never ingested a run for first, then least-recently-ingested, with `full_name` breaking ties so two calls agree element for element. `"annotated"` — re-order least-annotated share first: a suite measured at 0-of-N leads, repositories with no run or an unmeasured suite come last (never ranked as 0%), and `full_name` breaks ties. The same entries, a different order; the default order stays `full_name` ascending |
 
 The body comes back as SpecGuard serves it — `{"repositories": […]}`, each entry carrying `id`,
 `full_name`, `name`, `registered_at`, `role`, `delivery_health` and `latest_run`, ordered by
@@ -726,6 +780,13 @@ its last-known path and the weight the latest run measured.
 | --- | --- |
 | `behavior` | **required** — the behavior phrase, in plain words (e.g. "rejects an expired password reset token"). Trimmed and sent as `near`. Blank or whitespace-only is refused before any request, and so is a phrase containing a NUL (`\u0000`) character: the server would read either as no ask and answer the whole overview with `near: null`, which would look like an answered ask |
 | `repository` | ask THIS repository (its numeric id from `list_repositories`) under the **agent key** (`SPECGUARD_AGENT_API_KEY`, `sga_…`), or — when no agent key is set — the **user key** (`SPECGUARD_USER_API_KEY`, `sgu_…`), instead of the one the `sgk_…` key resolves to — omit it for the default, `sgk_`-keyed ask |
+| `limit` | optional integer page size, **1–50** — omit it for the default page of 10. Sent as `&limit=<n>` only when supplied, so an ask without it is the same request as before. The server clamps the ask to 50 and reports the value it applied as `limit` in the `near` block; a non-integer, zero or negative value is refused before any request |
+
+**The answer is a page, not the set.** Read `truncated` and `limit` in the returned `near` block:
+`limit` is the page size the server applied, and `truncated: true` means **more matches exist than
+were returned** — a full page of 10 may be "10 of 37". When `truncated` is true, re-ask the **same
+phrase** with a larger `limit` (max 50) before paraphrasing it: a repeated phrase is cache-served and
+free, while each paraphrase is a novel phrase and one billed embed.
 
 **What the answer is not.** It ranks *stored* tests nearest the phrase and **never answers "is this
 already tested?"** — it never gates a write and never issues a verdict. A hit near the phrase is not
@@ -1194,7 +1255,7 @@ npm run typecheck  # types only
 ## Related repositories
 
 - [`specguard`](https://github.com/yatfa-ai/specguard) — the platform: ingest API + Hotwire dashboard
-- [`specguard-rspec`](https://github.com/yatfa-ai/specguard-rspec) — Ruby client (RSpec formatter + `@intent` linter)
+- [`specguard-ruby`](https://github.com/yatfa-ai/specguard-ruby) — Ruby client (RSpec formatter, Minitest reporter + `@intent` linter)
 - [`open-test-intent`](https://github.com/yatfa-ai/open-test-intent) — the annotation protocol SpecGuard consumes
 
 ## License

package/dist/src/config.d.ts

@@ -19,7 +19,7 @@
  *
  * == SPECGUARD_ENDPOINT, with SPECGUARD_URL as an accepted alias
  *
- * `SPECGUARD_ENDPOINT` is the name the shipped `specguard-rspec` gem already
+ * `SPECGUARD_ENDPOINT` is the name the shipped `specguard-ruby` gem already
  * reads, so a repository whose CI posts runs to SpecGuard has it set — that is
  * the whole reason this server borrows the name rather than coining one. The
  * SPGD-310 brief writes it as `SPECGUARD_URL`, so that spelling is accepted
@@ -222,7 +222,7 @@ export declare const REPOSITORY_CREDENTIAL: Credential;
 /**
  * The `sgu_` key: a person, and a variable nothing else in the toolchain reads.
  *
- * `specguard-rspec` ships runs with an `sgk_` key and has no notion of this one,
+ * `specguard-ruby` ships runs with an `sgk_` key and has no notion of this one,
  * so an operator who already has CI reporting to SpecGuard does NOT already
  * have this variable — which is why the message says where to mint one rather
  * than assuming it is lying around.

package/dist/src/config.js

@@ -47,7 +47,7 @@ export const REPOSITORY_CREDENTIAL = {
 /**
  * The `sgu_` key: a person, and a variable nothing else in the toolchain reads.
  *
- * `specguard-rspec` ships runs with an `sgk_` key and has no notion of this one,
+ * `specguard-ruby` ships runs with an `sgk_` key and has no notion of this one,
  * so an operator who already has CI reporting to SpecGuard does NOT already
  * have this variable — which is why the message says where to mint one rather
  * than assuming it is lying around.

package/dist/src/support/specguard-api.js

@@ -272,7 +272,7 @@ async function requestUserAgent() {
  * ONE TOTAL BUDGET, not one per phase. `requestTimeoutMs` bounds the whole call:
  * headers and body share it, so a response whose headers took 29s of a 30s
  * budget has 1s left in which to deliver its body. The sibling transport in
- * `specguard-rspec` (`lib/specguard/rspec/transport.rb`) gives each phase its own
+ * `specguard-ruby` (`lib/specguard/client/transport.rb`) gives each phase its own
  * full `@timeout` because `Net::HTTP` exposes exactly that knob and no other;
  * here the deadline is ours to place, and a single total is both stricter and
  * the thing an operator who set one number actually meant.

package/dist/src/tools/args.d.ts

@@ -66,6 +66,17 @@ export declare function optionalString(value: unknown, field: string): string |
  */
 export declare function requireString(value: unknown, field: string): string;
 export declare function optionalBoolean(value: unknown, field: string): boolean | undefined;
+/**
+ * A positive integer, or nothing.
+ *
+ * Accepts only a finite JSON number with no fractional part that is >= 1. A
+ * numeric string ("10"), a float (2.5), zero, a negative, NaN and Infinity all
+ * throw `ArgumentError` — the same class every other shape check here throws.
+ * No upper bound is applied: a ceiling is the callee's to own (the server
+ * clamps and reports the value it applied), and the one a tool's schema
+ * advertises is the schema's to declare, not this helper's to duplicate.
+ */
+export declare function optionalPositiveInteger(value: unknown, field: string): number | undefined;
 /**
  * An optional array of non-blank strings, or nothing.
  *

package/dist/src/tools/args.js

@@ -93,6 +93,26 @@ export function optionalBoolean(value, field) {
         throw new ArgumentError(`\`${field}\` must be a boolean.`);
     return value;
 }
+/**
+ * A positive integer, or nothing.
+ *
+ * Accepts only a finite JSON number with no fractional part that is >= 1. A
+ * numeric string ("10"), a float (2.5), zero, a negative, NaN and Infinity all
+ * throw `ArgumentError` — the same class every other shape check here throws.
+ * No upper bound is applied: a ceiling is the callee's to own (the server
+ * clamps and reports the value it applied), and the one a tool's schema
+ * advertises is the schema's to declare, not this helper's to duplicate.
+ */
+export function optionalPositiveInteger(value, field) {
+    if (value === undefined || value === null)
+        return undefined;
+    if (typeof value !== "number" || !Number.isInteger(value)) {
+        throw new ArgumentError(`\`${field}\` must be an integer.`);
+    }
+    if (value < 1)
+        throw new ArgumentError(`\`${field}\` must be at least 1.`);
+    return value;
+}
 /**
  * An optional array of non-blank strings, or nothing.
  *

package/dist/src/tools/args.js.map

@@ -1 +1 @@
-{"version":3,"file":"args.js","sourceRoot":"","sources":["../../../src/tools/args.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../../../src/tools/args.ts"],"names":[],"mappings":"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"}

package/dist/src/tools/find-tests-near-behavior.js

@@ -1,6 +1,6 @@
 import { ArgumentError } from "../errors.js";
 import { getJsonObject, repositoryTarget } from "../support/specguard-api.js";
-import { optionalString, requireString } from "./args.js";
+import { optionalPositiveInteger, optionalString, requireString } from "./args.js";
 /**
  * `GET /api/v1/repository?near=<behavior phrase>` as a tool — the bridge half
  * of roadmap SPGD-1102 ("Ask the suite map"), slice 3. The platform half
@@ -45,6 +45,12 @@ const findTestsNearBehavior = {
         "The server embeds your phrase and ranks the repository's stored test identities by similarity, " +
         "returning the top hits in the `near` block — each with its similarity, `signal_source`, last-known " +
         "path and the weight the latest run measured. " +
+        "THE ANSWER IS A PAGE, NOT THE SET: the default page is 10 hits. READ `truncated` AND `limit` in the " +
+        "returned `near` block — `limit` is the page size the server APPLIED (it clamps your ask to 50) and " +
+        "`truncated: true` means MORE matches exist than were returned, so a full page of 10 may be \"10 of " +
+        "37\". When `truncated` is true, re-ask the SAME phrase with a larger optional `limit` (max 50) " +
+        "BEFORE paraphrasing it: a repeated phrase is cache-served and free, while each paraphrase is a " +
+        "novel phrase and one billed embed. " +
         "WHAT THE ANSWER IS NOT: it ranks STORED tests nearest the phrase and NEVER answers \"is this " +
         "already tested?\". It never gates a write and never issues a verdict — a hit near the phrase is not " +
         "coverage, and an empty answer is not proof of absence. `similarity_floor` is the near-duplicate " +
@@ -108,6 +114,18 @@ const findTestsNearBehavior = {
                     "indistinguishable from one that does not exist. " +
                     "Omit it — or pass a blank — and the call is the singular one under SPECGUARD_API_KEY.",
             },
+            limit: {
+                type: "integer",
+                minimum: 1,
+                maximum: 50,
+                description: "OPTIONAL page size: how many hits to return in the `near` block. Omit it for the " +
+                    "default page of 10. The server clamps the ask to 50 and reports the value it applied " +
+                    "as `limit` in the `near` block, beside `truncated` — read both: `truncated: true` " +
+                    "means more matches exist than were returned, and asking again with a larger `limit` " +
+                    "(same phrase, so cache-served and free) is cheaper than paraphrasing it (a novel " +
+                    "phrase, one billed embed). Must be an integer >= 1; anything else is refused before " +
+                    "any request.",
+            },
         },
         required: ["behavior"],
         additionalProperties: false,
@@ -123,8 +141,15 @@ const findTestsNearBehavior = {
                 "like an answered ask. Remove the character and send the phrase again.");
         }
         const repository = optionalString(args["repository"], "repository");
+        const limit = optionalPositiveInteger(args["limit"], "limit");
         const { api, path } = repositoryTarget(context.config, repository);
-        const overview = await getJsonObject(api, path, { near: behavior }, context.fetch);
+        // `limit` rides the wire only when supplied, so an ask without it is
+        // byte-identical to the request this tool made before `limit` existed. The
+        // server owns the clamp (50) and reports the applied value in `near.limit`.
+        const query = { near: behavior };
+        if (limit !== undefined)
+            query["limit"] = String(limit);
+        const overview = await getJsonObject(api, path, query, context.fetch);
         return {
             text: JSON.stringify(overview, null, 2),
             structured: overview,

package/dist/src/tools/find-tests-near-behavior.js.map

@@ -1 +1 @@
-{"version":3,"file":"find-tests-near-behavior.js","sourceRoot":"","sources":["../../../src/tools/find-tests-near-behavior.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAG1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,qBAAqB,GAAmB;IAC5C,IAAI,EAAE,0BAA0B;IAEhC,KAAK,EAAE,4BAA4B;IAEnC,WAAW,EACT,mGAAmG;QACnG,iGAAiG;QACjG,qGAAqG;QACrG,+CAA+C;QAC/C,+FAA+F;QAC/F,sGAAsG;QACtG,kGAAkG;QAClG,oGAAoG;QACpG,sGAAsG;QACtG,uGAAuG;QACvG,0DAA0D;QAC1D,sGAAsG;QACtG,mGAAmG;QACnG,sGAAsG;QACtG,qGAAqG;QACrG,oGAAoG;QACpG,oGAAoG;QACpG,qFAAqF;QACrF,oGAAoG;QACpG,oGAAoG;QACpG,4EAA4E;QAC5E,iGAAiG;QACjG,kGAAkG;QAClG,kGAAkG;QAClG,mGAAmG;QACnG,sBAAsB;QACtB,kGAAkG;QAClG,mGAAmG;QACnG,sEAAsE;QACtE,mGAAmG;QACnG,oGAAoG;QACpG,oGAAoG;QACpG,mGAAmG;QACnG,mGAAmG;QACnG,8FAA8F;QAC9F,oGAAoG;QACpG,oGAAoG;QACpG,0DAA0D;QAC1D,qGAAqG;QACrG,oGAAoG;QACpG,oFAAoF;IAEtF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,uFAAuF;oBACvF,uFAAuF;oBACvF,0FAA0F;oBAC1F,0FAA0F;oBAC1F,kFAAkF;oBAClF,oDAAoD;aACvD;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,mFAAmF;oBACnF,iFAAiF;oBACjF,6CAA6C;oBAC7C,wFAAwF;oBACxF,6EAA6E;oBAC7E,+EAA+E;oBAC/E,qFAAqF;oBACrF,kFAAkF;oBAClF,2EAA2E;oBAC3E,kDAAkD;oBAClD,uFAAuF;aAC1F;SACF;QACD,QAAQ,EAAE,CAAC,UAAU,CAAC;QACtB,oBAAoB,EAAE,KAAK;KAC5B;IAED,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO;QACrB,uEAAuE;QACvE,oEAAoE;QACpE,gBAAgB;QAChB,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC,CAAC;QAC7D,IAAI,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,aAAa,CACrB,2FAA2F;gBACzF,2FAA2F;gBAC3F,uEAAuE,CAC1E,CAAC;QACJ,CAAC;QACD,MAAM,UAAU,GAAG,cAAc,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC,CAAC;QACpE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAEnE,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QAEnF,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;YACvC,UAAU,EAAE,QAAQ;SACrB,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,eAAe,qBAAqB,CAAC"}
+{"version":3,"file":"find-tests-near-behavior.js","sourceRoot":"","sources":["../../../src/tools/find-tests-near-behavior.ts"],"names":[],"mappings":"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"}

package/dist/src/tools/index.d.ts

@@ -12,7 +12,7 @@ import type { ToolDefinition } from "./types.js";
  * == What is in the bootstrap, and why only these two
  *
  *   - `lint_intent_annotations` wraps `specguard-lint` (shipped:
- *     `specguard-rspec/bin/specguard-lint`, SPGD-12 §1).
+ *     `specguard-ruby/bin/specguard-lint`, SPGD-12 §1).
  *   - `get_repository_overview` wraps `GET /api/v1/repository` (shipped:
  *     `specguard/config/routes.rb`).
  *

package/dist/src/tools/index.js

@@ -32,7 +32,7 @@ import updateRepositoryMemberPermissions from "./update-repository-member-permis
  * == What is in the bootstrap, and why only these two
  *
  *   - `lint_intent_annotations` wraps `specguard-lint` (shipped:
- *     `specguard-rspec/bin/specguard-lint`, SPGD-12 §1).
+ *     `specguard-ruby/bin/specguard-lint`, SPGD-12 §1).
  *   - `get_repository_overview` wraps `GET /api/v1/repository` (shipped:
  *     `specguard/config/routes.rb`).
  *

package/dist/src/tools/list-repositories.d.ts

@@ -61,7 +61,9 @@ import type { ToolDefinition } from "./types.js";
  * and `?role=shared` (the exact partition of the accessible set into owned and
  * shared halves), and `?sort=stale` (never-ingested repositories first, then
  * least-recently-ingested, `github_full_name` breaking ties so the order is
- * deterministic). The concern's own comment says the endpoint reads them "for
+ * deterministic) or `?sort=annotated` (least-annotated share first; a
+ * repository with no run or an unmeasured suite last, never ranked as 0%; a
+ * suite measured at 0-of-N first; `github_full_name` breaking ties). The concern's own comment says the endpoint reads them "for
  * a machine" — and this bridge IS that machine, so they are forwarded here
  * rather than re-invented.
  *
@@ -159,8 +161,8 @@ import type { ToolDefinition } from "./types.js";
  * The order is `full_name` ascending, which the controller picks as the only
  * column a client can page or diff against without SpecGuard promising an id
  * ordering it has not designed — and `?sort=stale` re-sequences exactly that
- * loaded set rather than issuing a different query, so the entries never
- * change, only their order does. It is stated here for the same reason the
+ * loaded set rather than issuing a different query (as does `?sort=annotated`),
+ * so the entries never change, only their order does. It is stated here for the same reason the
  * other tool states its orders: a list whose order is a coincidence and a list
  * whose order is a contract look identical in a response body.
  */

package/dist/src/tools/list-repositories.js

@@ -62,7 +62,9 @@ import { optionalString } from "./args.js";
  * and `?role=shared` (the exact partition of the accessible set into owned and
  * shared halves), and `?sort=stale` (never-ingested repositories first, then
  * least-recently-ingested, `github_full_name` breaking ties so the order is
- * deterministic). The concern's own comment says the endpoint reads them "for
+ * deterministic) or `?sort=annotated` (least-annotated share first; a
+ * repository with no run or an unmeasured suite last, never ranked as 0%; a
+ * suite measured at 0-of-N first; `github_full_name` breaking ties). The concern's own comment says the endpoint reads them "for
  * a machine" — and this bridge IS that machine, so they are forwarded here
  * rather than re-invented.
  *
@@ -160,8 +162,8 @@ import { optionalString } from "./args.js";
  * The order is `full_name` ascending, which the controller picks as the only
  * column a client can page or diff against without SpecGuard promising an id
  * ordering it has not designed — and `?sort=stale` re-sequences exactly that
- * loaded set rather than issuing a different query, so the entries never
- * change, only their order does. It is stated here for the same reason the
+ * loaded set rather than issuing a different query (as does `?sort=annotated`),
+ * so the entries never change, only their order does. It is stated here for the same reason the
  * other tool states its orders: a list whose order is a coincidence and a list
  * whose order is a contract look identical in a response body.
  */
@@ -198,9 +200,11 @@ const listRepositories = {
         "`role: \"owned\"` or `\"shared\"` (one half of the owned/shared mix — note the ask is " +
         "spelled `owned`, not the response field's `owner`; under the AGENT key this ask settles " +
         "to the no-ask, because ownership is a person fact and the key speaks for nobody), and " +
-        "`sort: \"stale\"` (repositories " +
+        "`sort` (`\"stale\"`: repositories " +
         "CI has never ingested a run for first, then least-recently-ingested, `full_name` " +
-        "breaking ties). Omit them all and the request is the plain full list. " +
+        "breaking ties; `\"annotated\"`: least-annotated share first, repositories with no run " +
+        "or an unmeasured suite last — never ranked as 0% — a suite measured at 0-of-N first, " +
+        "`full_name` breaking ties). Omit them all and the request is the plain full list. " +
         "Ordered by `full_name` ascending unless `sort` asks otherwise, and stable across calls " +
         "either way. " +
         "The set is exactly what the key behind it may see — a repository outside the credential's " +
@@ -252,16 +256,20 @@ const listRepositories = {
             },
             sort: {
                 type: "string",
-                enum: ["stale"],
-                description: "Re-order the list stalest-first. The default order is `full_name` ascending, which " +
+                enum: ["stale", "annotated"],
+                description: "Re-order the list. The default order is `full_name` ascending, which " +
                     "is stable across calls but says nothing about what needs attention; `stale` puts " +
                     "the repositories CI has NEVER ingested a run for FIRST (never-ingested is the " +
                     "stalest state on this list, not a zero), then least-recently-ingested, newest last, " +
                     "with `github_full_name` breaking ties so two calls with the same data agree element " +
                     "for element. " +
+                    "`annotated` puts the LEAST-annotated suites first (annotated share of the latest " +
+                    "run, ascending): a suite measured at 0-of-N leads, and repositories CI has never " +
+                    "reported a run for, or whose suite was not measured, come LAST — an unmeasured suite " +
+                    "is never ranked as 0% — with `github_full_name` breaking ties. " +
                     "It re-sequences the loaded set rather than issuing a different query: the same " +
-                    "entries, a different order. `stale` is the only ordering the endpoint names — there " +
-                    "is deliberately no word for the default, because omitting the argument already " +
+                    "entries, a different order. `stale` and `annotated` are the sole sort words the endpoint " +
+                    "names — there is deliberately no word for the default, because omitting the argument already " +
                     "means it. " +
                     "Any other value a schema-bypassing client sends settles to the server's no-ask clamp " +
                     "(default order, no error); blank (or null) is no ask, byte-identical to omitting the " +

package/dist/src/tools/list-repositories.js.map

@@ -1 +1 @@
-{"version":3,"file":"list-repositories.js","sourceRoot":"","sources":["../../../src/tools/list-repositories.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"list-repositories.js","sourceRoot":"","sources":["../../../src/tools/list-repositories.ts"],"names":[],"mappings":"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"}

package/dist/src/tools/repository-overview.d.ts

@@ -173,12 +173,12 @@ import type { ToolDefinition } from "./types.js";
  * one CHOOSES THAT RUN, which the controller states in those terms: `?branch=`
  * asks about a SERIES, this asks WHICH RUN. It is read once, in that memo, so
  * every run-grain block moves together — `latest_run` and its rollups, the
- * four RUN-GRAIN drill-ins (`spec_directory_files`, `spec_file_examples`,
- * `repeated_description_examples` and `unannotated_examples`, the flag-style
- * rung documented below), `shards`, both growth windows and
- * `previous_test_run`.
+ * five RUN-GRAIN drill-ins (`spec_directory_files`, `spec_file_examples`,
+ * `repeated_description_examples`, `unannotated_examples` — the flag-style
+ * rung documented below — and `slowest_examples`, which `layer` narrows),
+ * `shards`, both growth windows and `previous_test_run`.
  *
- * That is four of the FIVE drill-ins on this tool, and the excluded one is
+ * That is five of the SIX drill-ins on this tool, and the excluded one is
  * worth naming because it is the composition an agent will actually try:
  * `unstable_test_runs` is read over the BRANCH WINDOW (`history_runs`), not off
  * the anchored run, so it does not move with this parameter. Sent together,
@@ -325,7 +325,7 @@ import type { ToolDefinition } from "./types.js";
  * is an ABSENCE of data. Serving `rows: []` here instead would spend a
  * distinction a client has no other way to make.
  *
- * THE `commit_sha` ROSTERS above and in README.md CORRECTLY STAY AT FOUR, and
+ * THE `commit_sha` ROSTERS above and in README.md COUNT ONE KEY PER DRILL-IN PARAMETER (five, with `layer`), and
  * the reason is the roster's UNIT, not anything about this block's shape. That
  * roster carries ONE REPRESENTATIVE KEY PER DRILL-IN PARAMETER, not one entry
  * per response key: `spec_directory` opens THREE blocks (see its own

package/dist/src/tools/repository-overview.js

@@ -174,12 +174,12 @@ import { optionalBoolean, optionalString } from "./args.js";
  * one CHOOSES THAT RUN, which the controller states in those terms: `?branch=`
  * asks about a SERIES, this asks WHICH RUN. It is read once, in that memo, so
  * every run-grain block moves together — `latest_run` and its rollups, the
- * four RUN-GRAIN drill-ins (`spec_directory_files`, `spec_file_examples`,
- * `repeated_description_examples` and `unannotated_examples`, the flag-style
- * rung documented below), `shards`, both growth windows and
- * `previous_test_run`.
+ * five RUN-GRAIN drill-ins (`spec_directory_files`, `spec_file_examples`,
+ * `repeated_description_examples`, `unannotated_examples` — the flag-style
+ * rung documented below — and `slowest_examples`, which `layer` narrows),
+ * `shards`, both growth windows and `previous_test_run`.
  *
- * That is four of the FIVE drill-ins on this tool, and the excluded one is
+ * That is five of the SIX drill-ins on this tool, and the excluded one is
  * worth naming because it is the composition an agent will actually try:
  * `unstable_test_runs` is read over the BRANCH WINDOW (`history_runs`), not off
  * the anchored run, so it does not move with this parameter. Sent together,
@@ -326,7 +326,7 @@ import { optionalBoolean, optionalString } from "./args.js";
  * is an ABSENCE of data. Serving `rows: []` here instead would spend a
  * distinction a client has no other way to make.
  *
- * THE `commit_sha` ROSTERS above and in README.md CORRECTLY STAY AT FOUR, and
+ * THE `commit_sha` ROSTERS above and in README.md COUNT ONE KEY PER DRILL-IN PARAMETER (five, with `layer`), and
  * the reason is the roster's UNIT, not anything about this block's shape. That
  * roster carries ONE REPRESENTATIVE KEY PER DRILL-IN PARAMETER, not one entry
  * per response key: `spec_directory` opens THREE blocks (see its own
@@ -480,7 +480,7 @@ const getRepositoryOverview = {
         "which areas of the suite grew or shrank and which got slower or faster since the previous run " +
         "on the same branch (the per-area comparisons, at BOTH the example-count grain and the " +
         "runtime grain — an area where an existing spec was made slow gains no examples and appears " +
-        "only in the runtime one), " +
+        "only in the runtime one — and how the run-wide declared-layer mix moved, `layer_run_growth`), " +
         "the recent run history for growth over time, and the branches that have runs. " +
         "Everything above is answered about ONE repository, and WHICH one has two spellings: by " +
         "default it is the repository the configured sgk_… repository key resolves to, and passing " +
@@ -496,6 +496,12 @@ const getRepositoryOverview = {
         "`repeated_description` to see the examples that all share one repeated description, or " +
         "`unstable_test` (alongside `branch`) to see one flaky test's outcome run by run, which is " +
         "the only way to tell a regression from genuine flakiness. " +
+        "Every row of `unstable_tests.rows[]` AND of `unstable_tests.shared_description_rows[]` also " +
+        "carries `declared_layers` — the sorted DISTINCT set of `@intent layer:` values that test's " +
+        "examples declared anywhere in the window. `[]` means no run in the window declared one: NOT " +
+        "`unreadable`, and NOT a measured `unit`. A partially annotated test lists only what was " +
+        "declared, and more than one entry means the test changed layer mid-window. It is " +
+        "DECLARED-ONLY — the stored column, never inferred from the spec path or `files_seen`. " +
         "All of those describe the repository's NEWEST run, which on a busy repository may be another " +
         "branch's: pass `commit_sha` to be answered about ONE named run instead — after pushing a " +
         "commit and waiting for CI, say — then read `run_anchor` to confirm which run you were served, " +
@@ -511,6 +517,43 @@ const getRepositoryOverview = {
         "is the ONLY figure on this endpoint that means tests SpecGuard can say nothing about. Never " +
         "read `total_specs - annotated_specs` as that population — on a suite that has never been " +
         "annotated it is the whole suite, and almost all of it is readable. " +
+        "WHICH LAYER THE SUITE DECLARES IS A THIRD, SEPARATE QUESTION, answered on every response by " +
+        "`latest_run.layer_counts`, a sibling of `intent_readings`: five operands — `unit`, " +
+        "`integration`, `request`, `system` and `undeclared` — that sum to `intent_readings.recorded`. " +
+        "It is `null`, NOT five zeros, when the run stored no per-example rows, because a zero would " +
+        "read as a measured none. The layers are DECLARED only — an `@intent` annotation said so — and " +
+        "NEVER inferred from the directory path, so a test under `spec/models` that declared nothing " +
+        "is `undeclared`; and `undeclared` is NOT `unreadable` (a test can be perfectly readable and " +
+        "declare no layer). The operands carry no pyramid verdict; reading the mix is yours. " +
+        "WHERE THE MACHINE TIME WENT BY LAYER is `latest_run.layer_durations`, a sibling of `layer_counts` " +
+        "with the same five keys, each `{total_seconds, timed_count}`. `total_seconds` is `null`, NOT 0, for " +
+        "a layer with no timed example, so an untimed layer is not a free one; `timed_count` (at most that " +
+        "layer's `layer_counts` entry) is the real denominator for any average. The whole key is `null` when " +
+        "the run stored no per-example rows. It is a SUM of example durations — machine time and NOT wall " +
+        "clock — so it can exceed `duration_seconds` on a parallel or sharded run. The layer is DECLARED " +
+        "only, never inferred from the path, and the operands carry no pyramid verdict. " +
+        "HOW THE DECLARED-LAYER MIX MOVED SINCE THE PREVIOUS RUN is `layer_run_growth`, with its contract " +
+        "block `layer_run_growth_window` — both TOP-LEVEL siblings of `directory_run_growth`, NOT inside " +
+        "`latest_run` (the delta is not in `latest_run.layer_counts`). They compare the latest run with the " +
+        "previous run ON THE LATEST RUN'S OWN BRANCH, so no `branch` is needed, and `commit_sha` re-anchors " +
+        "them with the rest of the run-grain blocks exactly as it does the area pair. `layer_run_growth` is " +
+        "`null` in EVERY non-comparable state — NEVER a block of zeros, so `null` is not \"no change\" — and " +
+        "`layer_run_growth_window.state` names why: `latest_unmeasured`, `previous_unmeasured`, " +
+        "`assembled_differently`, `neither_recorded`, `previous_unrecorded`, `latest_unrecorded`, or " +
+        "`comparable`, plus `no_latest_run` (CI never reported) and `no_previous_run` (the first run on the " +
+        "branch). `layer_run_growth_window.comparable` is true exactly when `layer_run_growth` is non-null; " +
+        "the window also carries `basis`, `branch`, `anchor_commit_sha` and `baseline_commit_sha`. When " +
+        "comparable, `layer_run_growth` is `{layers, baseline_recorded_count, anchor_recorded_count}`, where " +
+        "`layers` holds `unit`, `integration`, `request`, `system` and `undeclared`, each " +
+        "`{baseline_count, anchor_count, change}`. A layer that did not move reads `change: 0` — a measured " +
+        "zero, not an absence — and the five `change` values sum to `anchor_recorded_count` minus " +
+        "`baseline_recorded_count`. The layers are DECLARED only, never inferred from the path, and " +
+        "`undeclared` is NOT `unreadable`; the operands carry no pyramid verdict, so reading the shift is " +
+        "yours. The same " +
+        "`layer_counts` rides each row of `spec_directories`, the `spec_directory_files` area block " +
+        "and each of its file rows, and every per-example row of `slowest_examples`, " +
+        "`spec_file_examples` and `repeated_description_examples` carries `intent_layer` and " +
+        "`declared_intent` (`{entity, action, behavior}` or `null`, declared only). " +
         "TWO BLOCKS COME BACK ON EVERY RESPONSE — no parameter to pass, no flag to set — and they " +
         "answer what everything above silently depends on: is SpecGuard still being fed? " +
         "`delivery_health` is why the figures may be STALE: `refusing` is a comparison of stamps, not a " +
@@ -651,7 +694,8 @@ const getRepositoryOverview = {
                     "`unstable_tests` (which tests failed intermittently across the window rather than " +
                     "consistently) and `directory_growth` (how each area moved between the two ENDPOINTS of " +
                     "that window). The per-area comparisons against the PREVIOUS RUN — `directory_run_growth` " +
-                    "and `directory_runtime_growth` — need no branch and take none; they scope to the latest " +
+                    "and `directory_runtime_growth`, and the declared-layer mix pair `layer_run_growth` / " +
+                    "`layer_run_growth_window` — need no branch and take none; they scope to the latest " +
                     "run's own branch by construction, so a plain call already carries them.",
             },
             spec_directory: {
@@ -660,7 +704,9 @@ const getRepositoryOverview = {
                     "went by directory but not which files inside it spent it. Use a path exactly as served " +
                     "in `latest_run.spec_directories.rows[].path`. Asking populates " +
                     "`latest_run.spec_directory_files` — the spec files in that one directory with their " +
-                    "`total_seconds`/`recorded_count`/`timed_count`, plus the AREA's own `file_count`, " +
+                    "`total_seconds`/`recorded_count`/`timed_count` and a `layer_counts` split of the declared " +
+                    "layers (the same five operands as `latest_run.layer_counts`), plus the AREA's own " +
+                    "`layer_counts`, `file_count`, " +
                     "`recorded_count`, `timed_count` and the `limit` the row list was cut at (the totals " +
                     "describe the whole area, not the returned page, so do not re-derive them from `rows`). " +
                     "The one ask opens THREE blocks, each in its own grain: `spec_directory_files` for which " +
@@ -687,7 +733,8 @@ const getRepositoryOverview = {
                     "`latest_run.spec_files.rows[].path`. Asking populates " +
                     "`latest_run.spec_file_examples` — up to 50 of that file's individual examples cut by " +
                     "DURATION, each with `name`, `file_path`, `line_number`, `spec_file_path`, " +
-                    "`duration_seconds` and `outcome`, plus the FILE's own `recorded_count` and " +
+                    "`duration_seconds`, `outcome`, `intent_layer` and `declared_intent` (EIGHT fields), " +
+                    "plus the FILE's own `recorded_count` and " +
                     "`timed_count` and the `limit` the row list was cut at (the totals describe the whole " +
                     "file, not the returned page, so do not re-derive them from `rows`). " +
                     "SENT TOGETHER WITH `unannotated_examples`, it also narrows THAT worklist to this file — " +
@@ -704,8 +751,8 @@ const getRepositoryOverview = {
                     "the same thing. Use a description exactly as served in " +
                     "`latest_run.repeated_descriptions.rows[].name`. Asking populates " +
                     "`latest_run.repeated_description_examples` — up to 25 of that group's members, each " +
-                    "with `name`, `file_path`, `line_number`, `spec_file_path`, `duration_seconds` and " +
-                    "`outcome`, plus the GROUP's own `recorded_count` and `timed_count` and the `limit` " +
+                    "with `name`, `file_path`, `line_number`, `spec_file_path`, `duration_seconds`, " +
+                    "`outcome`, `intent_layer` and `declared_intent` (EIGHT fields), plus the GROUP's own `recorded_count` and `timed_count` and the `limit` " +
                     "the row list was cut at (the totals describe the whole group, not the returned page, " +
                     "so do not re-derive them from `rows`). This is the ONLY way to reach a group's " +
                     "members: `slowest_examples` is the run-wide top ten and rarely contains them, and " +
@@ -742,6 +789,8 @@ const getRepositoryOverview = {
                     "`commit_sha`/`test_run_id`, never off its index: a run that recorded nothing under " +
                     "the description contributes no row and a description carried by two examples in one " +
                     "run contributes two, so `rows` is not one entry per run. " +
+                    "These drill-in rows do NOT carry a layer: read `declared_layers` off the ranking row " +
+                    "(`unstable_tests.rows[]`), not here. " +
                     "`branch` IS REQUIRED WITH IT, unlike every other argument here: `unstable_tests` is " +
                     "served only for a branch-narrowed window, so this parameter sent alone leaves the " +
                     "whole containing block `null` and there is nothing to drill into — not an empty " +
@@ -754,15 +803,15 @@ const getRepositoryOverview = {
             commit_sha: {
                 type: "string",
                 description: "Anchor the whole answer on ONE run, naming it by commit sha. This is a DIFFERENT KIND " +
-                    "OF ASK from every other argument here: the five above narrow what is served ABOUT a run " +
+                    "OF ASK from every other argument here: the drill-in arguments narrow what is served ABOUT a run " +
                     "that was already chosen for you, and this one CHOOSES THAT RUN. `branch` asks about a " +
                     "SERIES; this asks WHICH RUN. Use a sha exactly as served in " +
                     "`latest_run.commit_sha`, `history[].commit_sha` or " +
                     "`unstable_tests.unstable_test_runs.rows[].commit_sha`. " +
                     "Everything at run grain re-anchors together: `latest_run` and its five rollups, the " +
-                    "four RUN-GRAIN drill-ins (`spec_directory_files`, `spec_file_examples`, " +
-                    "`repeated_description_examples` and `unannotated_examples`), `shards`, both per-area " +
-                    "growth windows and `previous_test_run`. " +
+                    "five RUN-GRAIN drill-ins (`spec_directory_files`, `spec_file_examples`, " +
+                    "`repeated_description_examples`, `unannotated_examples` and `slowest_examples` — the " +
+                    "block `layer` narrows), `shards`, both per-area growth windows and `previous_test_run`. " +
                     "`unstable_test_runs` is the one drill-in that does NOT move with " +
                     "it: it is read over the branch window rather than off the anchored run, so sending " +
                     "this with `unstable_test` still gives you that test across the whole window. " +
@@ -823,8 +872,9 @@ const getRepositoryOverview = {
                     "one is additional, not instead. " +
                     "Asking populates `latest_run.unannotated_examples` — up to 100 of the unannotated " +
                     "examples OF WHATEVER YOU ASKED FOR, each with `name`, `file_path`, `line_number` and " +
-                    "`spec_file_path`, `reading` and `derived_intent` (SIX fields: no `duration_seconds` and " +
-                    "no `outcome`, unlike the per-example drill-ins above), plus that same population's own " +
+                    "`spec_file_path`, `reading` and `derived_intent` (SIX fields: no `duration_seconds`, no " +
+                    "`outcome` and no `intent_layer`, unlike the per-example drill-ins above, which carry " +
+                    "EIGHT), plus that same population's own " +
                     "`recorded_count`, `derived_count` and `unreadable_count`, the " +
                     "`limit` the row list was cut at, and `spec_file`/`spec_directory` ECHOED BACK as the " +
                     "server READ them — `null` for each one you did not send. " +
@@ -888,6 +938,26 @@ const getRepositoryOverview = {
                     "same as omitting it and sends nothing at all: declining is not sending, which is how " +
                     "every other argument here is declined too — none of them has an \"off\" value.",
             },
+            layer: {
+                type: "string",
+                description: "Narrow ONE block to one DECLARED test layer: `latest_run.slowest_examples` — the " +
+                    "run-wide slowest-examples ranking — and NOTHING else. It does NOT narrow " +
+                    "`spec_file_examples`, `spec_directory_files`, `unannotated_examples` or " +
+                    "`repeated_description_examples`. Use it after `latest_run.layer_durations` shows one " +
+                    "layer holding most of the machine time (say `request`) and you need to know WHICH " +
+                    "tests. Values: `unit`, `integration`, `request`, `system` or `undeclared` (a test that " +
+                    "declared no layer). Any other value is read by the server as NO ASK — never a 400 or " +
+                    "404 — so it is forwarded unvalidated and a typo silently returns the un-narrowed " +
+                    "ranking: check that `slowest_examples.layer` is echoed back. That echo is present ONLY " +
+                    "when a layer was asked (the key is ABSENT otherwise). With a layer asked, " +
+                    "`recorded_count`, `timed_count` and `reported_outcome_count` are that LAYER's own " +
+                    "counts (`recorded_count` equals `layer_counts[layer]`, `timed_count` equals " +
+                    "`layer_durations[layer].timed_count`), not the run's. A layer with no examples answers " +
+                    "`rows: []` and `recorded_count: 0`, while `slowest_examples: null` still means the run " +
+                    "recorded nothing at all. Layers are DECLARED only (an `@intent` annotation said so), " +
+                    "never inferred from the file path. It is at RUN GRAIN, so it moves with `commit_sha`. " +
+                    "A blank value sends nothing.",
+            },
         },
         additionalProperties: false,
     },
@@ -902,6 +972,10 @@ const getRepositoryOverview = {
         const repeatedDescription = optionalString(args["repeated_description"], "repeated_description");
         const unstableTest = optionalString(args["unstable_test"], "unstable_test");
         const commitSha = optionalString(args["commit_sha"], "commit_sha");
+        // Forwarded UNVALIDATED, deliberately: the server reads any value outside
+        // the five declared layers as no ask (never a 400/404), so an enum check
+        // here would only add a second, divergent opinion about what is valid.
+        const layer = optionalString(args["layer"], "layer");
         // A BOOLEAN, and deliberately not stringified below. The server reads only
         // whether the key is PRESENT — `?unannotated_examples=false` opens the block
         // exactly as `=true` does — and `getJson` omits only `undefined`, so sending
@@ -926,6 +1000,7 @@ const getRepositoryOverview = {
             repeated_description: repeatedDescription,
             unstable_test: unstableTest,
             commit_sha: commitSha,
+            layer,
             unannotated_examples: unannotatedExamples === true ? "true" : undefined,
         }, context.fetch);
         return {

package/dist/src/tools/repository-overview.js.map

@@ -1 +1 @@
-{"version":3,"file":"repository-overview.js","sourceRoot":"","sources":["../../../src/tools/repository-overview.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"repository-overview.js","sourceRoot":"","sources":["../../../src/tools/repository-overview.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specguard-mcp",
-  "version": "0.1.39",
+  "version": "0.1.41",
   "description": "MCP server exposing SpecGuard suite intelligence to AI coding agents",
   "license": "ISC",
   "type": "module",