scoutline 0.15.0 → 0.16.0

package/dist/commands/repo.d.ts

@@ -23,8 +23,57 @@
  * before reaching the Explorer rather than silently degrading.
  */
 import type { CommandContext, CommandResult } from "../command-invocation.js";
-import type { RepositoryCapability } from "../capabilities/repository.js";
+import type { RepositoryBrief, RepositoryCapability, RepositoryTreeResult, RepoBriefFocus } from "../capabilities/repository.js";
 import type { ExecutionDependencies } from "../lib/execution.js";
+/**
+ * Sealed v1 probe set. Opening the set later is additive — do NOT
+ * mutate this constant at runtime.
+ */
+export declare const REPO_BRIEF_FOCUS: readonly RepoBriefFocus[];
+/**
+ * Probe query constants per DESIGN D7. These are NOT constructed at
+ * call time — they are literal constants so the brief's evidence
+ * chain (search.query inside the envelope) is reproducible byte-for-
+ * byte across providers and reruns.
+ */
+export declare const README_QUERY = "README";
+export declare const MANIFEST_QUERY = "package.json pyproject.toml Cargo.toml go.mod";
+/**
+ * Pure tree-derived file selection (DESIGN D1 / D7 steps 5–8). The
+ * tree is the path inventory — search excerpts carry no paths, so
+ * file selection MUST be tree-derived. The returned `manifests` array
+ * is in canonical kind order; `readme` is the single shallowest
+ * README match. Non-file entries (directories) are ignored even when
+ * their `name` happens to look like a README/manifest.
+ */
+export declare function selectBriefFiles(tree: RepositoryTreeResult): {
+    readme?: string;
+    manifests: string[];
+};
+/**
+ * Parse the `--focus` flag value. Splits on `,`, trims, drops empties,
+ * validates against the sealed `REPO_BRIEF_FOCUS` set, dedupes
+ * preserving first occurrence, and rejects empty-after-processing.
+ *
+ * The error message names the sealed set so a consumer can fix the
+ * value without consulting docs (DESIGN D7 step 3).
+ */
+export declare function parseBriefFocus(raw: string): readonly RepoBriefFocus[];
+/**
+ * Parse the `--depth` flag value. Positive integer (≥ 1); `undefined`
+ * means "unset — use the Explorer's default". Accepts only numbers and
+ * numeric strings (CLI parses flags as strings); every other runtime
+ * type — booleans, null, objects — is rejected BEFORE coercion so a
+ * `true` can never ride `Number(true) === 1` past validation.
+ */
+export declare function parseBriefDepth(raw: unknown): number | undefined;
+/**
+ * Parse the `--max-chars` flag value. Positive integer (≥ 1);
+ * `undefined` means "unset — use the Explorer's default upper bound".
+ * Same runtime-type gate as `parseBriefDepth`: only numbers and numeric
+ * strings are coerced.
+ */
+export declare function parseBriefMaxChars(raw: unknown): number | undefined;
 export interface RepoSearchOptions {
     language?: "en" | "zh";
     maxChars?: number;
@@ -39,6 +88,25 @@ export interface RepoReadOptions {
     maxChars?: number;
     noCache?: boolean;
 }
+export interface RepoBriefOptions {
+    /**
+     * Requested focus, a subset of the sealed `REPO_BRIEF_FOCUS` set, in
+     * caller order. Omitted defaults to all four. Non-empty; each token
+     * must be a sealed member (DESIGN D7 step 3). Duplicate tokens are
+     * collapsed preserving first occurrence, matching `parseBriefFocus`,
+     * so direct handler callers cannot smuggle duplicates into the
+     * envelope's `focus` field.
+     */
+    focus?: readonly RepoBriefFocus[];
+    /** Tree-only scope (DESIGN D3: search/read have no path parameter). */
+    path?: string;
+    /** Tree-only depth; defaults to the Explorer's default (1). */
+    depth?: number;
+    /** Per-call search/read budget; tree is never character-limited. */
+    maxChars?: number;
+    /** Bypasses the response cache for every probe. */
+    noCache?: boolean;
+}
 /**
  * Dependencies injected by `src/index.ts` after Provider selection,
  * capability support check, configuration check, Adapter
@@ -49,6 +117,14 @@ export interface RepoReadOptions {
 export interface RepoHandlerDependencies {
     readonly capability: RepositoryCapability;
     readonly execution: ExecutionDependencies;
+    /**
+     * Invocation-resolved credential values used to redact failed-probe
+     * error messages. Injected by `src/index.ts` already resolved from
+     * the invocation's env (including injected credentials absent from
+     * ambient `process.env`). Omitted → the ambient `configuredSecrets()`
+     * fallback, mirroring `invokeCommand`'s output/error boundary.
+     */
+    readonly secrets?: readonly string[];
 }
 /**
  * Repository Search. Validates parse-level request shape, delegates
@@ -69,5 +145,24 @@ export declare function repoTree(repo: string, options: RepoTreeOptions, deps: R
  * and returns the normalized File result as base data.
  */
 export declare function repoRead(repo: string, path: string, options: RepoReadOptions, deps: RepoHandlerDependencies, _context?: CommandContext): Promise<CommandResult>;
+/**
+ * Repository Brief. Composes the three Explorer operations into one
+ * schema-version-1 envelope (DESIGN D2/D3/D4). Fixed probe order:
+ * tree → search("README") → search(manifest names) → read loop (README
+ * first, then manifests in canonical kind order, cap 4 total reads).
+ *
+ * Parse-level validation (DESIGN D7): `validateRepo`, `--depth` and
+ * `--max-chars` positive integers, `--focus` a non-empty subset of the
+ * sealed set (default all four). Forwarding (DESIGN D3): `--no-cache`
+ * to every call; `--max-chars` to searches/reads only (the tree is
+ * never character-limited); `--depth`/`--path` to the tree only.
+ *
+ * Every Explorer call runs settled (DESIGN D6): a throw becomes a
+ * `failed` probe record and the brief continues. Exit policy: ≥1 probe
+ * `ok` → `{kind: "data"}` (exit 0); every probe terminal and failed →
+ * the last error is rethrown so the executor routes it through the
+ * standard stderr boundary (exit 1).
+ */
+export declare function repoBrief(repo: string, options: RepoBriefOptions, deps: RepoHandlerDependencies, _context?: CommandContext): Promise<CommandResult<RepositoryBrief>>;
 export declare const REPO_HELP: string;
 //# sourceMappingURL=repo.d.ts.map

package/dist/commands/repo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repo.d.ts","sourceRoot":"","sources":["../../src/commands/repo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AA2BjE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,qBAAqB,CAAC;CAC3C;AAMD;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,iBAAiB,EAC1B,IAAI,EAAE,uBAAuB,EAC7B,QAAQ,CAAC,EAAE,cAAc,GACxB,OAAO,CAAC,aAAa,CAAC,CAaxB;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,eAAe,EACxB,IAAI,EAAE,uBAAuB,EAC7B,QAAQ,CAAC,EAAE,cAAc,GACxB,OAAO,CAAC,aAAa,CAAC,CAgBxB;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,eAAe,EACxB,IAAI,EAAE,uBAAuB,EAC7B,QAAQ,CAAC,EAAE,cAAc,GACxB,OAAO,CAAC,aAAa,CAAC,CAUxB;AAcD,eAAO,MAAM,SAAS,QAoEd,CAAC"}
+{"version":3,"file":"repo.d.ts","sourceRoot":"","sources":["../../src/commands/repo.ts"],"names":[],"mappings":"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"}

package/dist/commands/repo.js

@@ -25,6 +25,7 @@
 import { OUTPUT_MODES } from "../lib/output.js";
 import { explorerSearch, explorerReadFile, explorerTree } from "./repository-explorer.js";
 import { ValidationError } from "../lib/errors.js";
+import { configuredSecrets, redactCredentialString } from "../lib/redact.js";
 // ---------------------------------------------------------------------------
 // Parse-level validation
 // ---------------------------------------------------------------------------
@@ -40,6 +41,179 @@ function validateRepo(repo) {
     }
 }
 // ---------------------------------------------------------------------------
+// Repository Brief — constants and pure helpers (DESIGN D1, D7; SCHEMA.md)
+//
+// These helpers are exported for unit testing and are pure (no I/O,
+// no Provider, no env). The handler composition in `repoBrief` is a
+// separate ticket that wires them into the Explorer envelope.
+// ---------------------------------------------------------------------------
+/**
+ * Sealed v1 probe set. Opening the set later is additive — do NOT
+ * mutate this constant at runtime.
+ */
+export const REPO_BRIEF_FOCUS = [
+    "structure",
+    "readme",
+    "manifest",
+    "files",
+];
+/**
+ * Probe query constants per DESIGN D7. These are NOT constructed at
+ * call time — they are literal constants so the brief's evidence
+ * chain (search.query inside the envelope) is reproducible byte-for-
+ * byte across providers and reruns.
+ */
+export const README_QUERY = "README";
+export const MANIFEST_QUERY = "package.json pyproject.toml Cargo.toml go.mod";
+/**
+ * Canonical manifest-kind priority order (DESIGN D7 step 8). The
+ * README, when present, is always selected first; manifests follow in
+ * this exact order, capped so total reads ≤ 4.
+ */
+const MANIFEST_KIND_ORDER = [
+    "package.json",
+    "pyproject.toml",
+    "Cargo.toml",
+    "go.mod",
+];
+/** Hard cap on total read probes (1 README + up to 3 manifests). */
+const BRIEF_READ_CAP = 4;
+/** README basename pattern per DESIGN D7 step 6 (case-insensitive). */
+const README_BASENAME_RE = /^readme(?:\.[a-z0-9]+)?$/i;
+/**
+ * Compute the depth (number of segments past root) of a
+ * repository-relative POSIX path. Root (`""`) has depth 0; `"a/b"`
+ * has depth 2; `"a"` has depth 1.
+ */
+function pathDepth(path) {
+    if (path.length === 0)
+        return 0;
+    // For non-empty paths the depth IS the segment count returned by
+    // split("/").length — no subtraction: the root ("") already returned
+    // 0 above, so "a" → 1 and "a/b" → 2, matching the JSDoc.
+    return path.split("/").length;
+}
+/** Last segment of a repository-relative POSIX path (basename). */
+function basenameOf(path) {
+    const segments = path.split("/");
+    return segments[segments.length - 1] ?? "";
+}
+/**
+ * Pick the winning entry for a given match predicate using D7's
+ * selection rule: minimum depth; ties broken by first occurrence in
+ * (snapshot order, then entry order) — i.e. BFS / provider order,
+ * which is stable for a given Provider response.
+ *
+ * The predicate is invoked with `(path, basename, kind)`; non-file
+ * entries (directories) are filtered out before the predicate runs.
+ */
+function selectWinnerByDepth(tree, predicate) {
+    let best;
+    for (const snapshot of tree.snapshots) {
+        for (const entry of snapshot.entries) {
+            if (entry.kind !== "file")
+                continue;
+            if (!predicate(entry.path, basenameOf(entry.path), entry.kind))
+                continue;
+            const depth = pathDepth(entry.path);
+            if (best === undefined || depth < best.depth) {
+                best = { path: entry.path, depth };
+            }
+        }
+    }
+    return best ? { path: best.path } : undefined;
+}
+/**
+ * Pure tree-derived file selection (DESIGN D1 / D7 steps 5–8). The
+ * tree is the path inventory — search excerpts carry no paths, so
+ * file selection MUST be tree-derived. The returned `manifests` array
+ * is in canonical kind order; `readme` is the single shallowest
+ * README match. Non-file entries (directories) are ignored even when
+ * their `name` happens to look like a README/manifest.
+ */
+export function selectBriefFiles(tree) {
+    const readme = selectWinnerByDepth(tree, (_path, basename) => README_BASENAME_RE.test(basename));
+    const manifests = [];
+    for (const kind of MANIFEST_KIND_ORDER) {
+        if (manifests.length + (readme ? 1 : 0) >= BRIEF_READ_CAP)
+            break;
+        const winner = selectWinnerByDepth(tree, (_path, basename) => basename === kind);
+        if (winner)
+            manifests.push(winner.path);
+    }
+    return {
+        ...(readme ? { readme: readme.path } : {}),
+        manifests,
+    };
+}
+/**
+ * Parse the `--focus` flag value. Splits on `,`, trims, drops empties,
+ * validates against the sealed `REPO_BRIEF_FOCUS` set, dedupes
+ * preserving first occurrence, and rejects empty-after-processing.
+ *
+ * The error message names the sealed set so a consumer can fix the
+ * value without consulting docs (DESIGN D7 step 3).
+ */
+export function parseBriefFocus(raw) {
+    const tokens = raw
+        .split(",")
+        .map((t) => t.trim())
+        .filter((t) => t.length > 0);
+    if (tokens.length === 0) {
+        throw new ValidationError("--focus must include at least one of: structure, readme, manifest, files");
+    }
+    const seen = new Set();
+    const out = [];
+    for (const token of tokens) {
+        if (!REPO_BRIEF_FOCUS.includes(token)) {
+            throw new ValidationError(`Unknown --focus value "${token}". Allowed: ${REPO_BRIEF_FOCUS.join(", ")}`);
+        }
+        const focus = token;
+        if (seen.has(focus))
+            continue;
+        seen.add(focus);
+        out.push(focus);
+    }
+    return out;
+}
+/**
+ * Parse the `--depth` flag value. Positive integer (≥ 1); `undefined`
+ * means "unset — use the Explorer's default". Accepts only numbers and
+ * numeric strings (CLI parses flags as strings); every other runtime
+ * type — booleans, null, objects — is rejected BEFORE coercion so a
+ * `true` can never ride `Number(true) === 1` past validation.
+ */
+export function parseBriefDepth(raw) {
+    if (raw === undefined)
+        return undefined;
+    if (typeof raw !== "number" && typeof raw !== "string") {
+        throw new ValidationError("--depth must be a positive integer");
+    }
+    const value = typeof raw === "number" ? raw : Number(raw);
+    if (!Number.isFinite(value) || !Number.isInteger(value) || value < 1) {
+        throw new ValidationError("--depth must be a positive integer");
+    }
+    return value;
+}
+/**
+ * Parse the `--max-chars` flag value. Positive integer (≥ 1);
+ * `undefined` means "unset — use the Explorer's default upper bound".
+ * Same runtime-type gate as `parseBriefDepth`: only numbers and numeric
+ * strings are coerced.
+ */
+export function parseBriefMaxChars(raw) {
+    if (raw === undefined)
+        return undefined;
+    if (typeof raw !== "number" && typeof raw !== "string") {
+        throw new ValidationError("--max-chars must be a positive integer");
+    }
+    const value = typeof raw === "number" ? raw : Number(raw);
+    if (!Number.isFinite(value) || !Number.isInteger(value) || value < 1) {
+        throw new ValidationError("--max-chars must be a positive integer");
+    }
+    return value;
+}
+// ---------------------------------------------------------------------------
 // Handlers — thin wrappers over the Explorer
 // ---------------------------------------------------------------------------
 /**
@@ -82,6 +256,234 @@ export async function repoRead(repo, path, options, deps, _context) {
     const result = await explorerReadFile(deps.capability, { repository: repo, path }, { noCache: options.noCache, maxChars: options.maxChars }, deps.execution);
     return { kind: "data", data: result };
 }
+/**
+ * Run one Explorer call inside the settled wrapper (DESIGN D6): a throw
+ * becomes a `failed` probe record (stable code + redacted message) and
+ * the brief continues. On success the probe is recorded `ok`.
+ */
+async function settleProbe(probes, kind, label, fn, secrets) {
+    try {
+        const value = await fn();
+        probes.push({ kind, label, status: "ok" });
+        return { ok: true, value };
+    }
+    catch (error) {
+        probes.push({ kind, label, status: "failed", error: probeErrorInfo(error, secrets) });
+        return { ok: false, error };
+    }
+}
+/**
+ * Derive the stable code + redacted message for a probe failure record.
+ * Mirrors the standard stderr boundary (`formatErrorOutput`): a shaped
+ * error's `code` string is preserved, everything else falls back to
+ * `UNKNOWN_ERROR`; the message is redacted against the invocation's
+ * resolved credentials (threaded via `RepoHandlerDependencies.secrets`
+ * so injected-environment credentials absent from ambient `process.env`
+ * are still covered) so no credential-shaped substring leaks into the
+ * envelope.
+ */
+function probeErrorInfo(error, secrets) {
+    const code = error !== null &&
+        typeof error === "object" &&
+        typeof error.code === "string"
+        ? error.code
+        : "UNKNOWN_ERROR";
+    const rawMessage = error instanceof Error ? error.message : String(error);
+    return { code, message: redactCredentialString(rawMessage, [...secrets]) };
+}
+/**
+ * Tree-derived structural signals (SCHEMA.md `RepoBriefDetected`). Every
+ * field is `null` when the tree probe failed or was focus-excluded —
+ * never guessed from search excerpts. `manifestKinds` lists every
+ * present kind in canonical order, independent of the 4-read selection
+ * cap (the cap is a read-budget, not a detection signal).
+ */
+function detectBriefSignals(tree) {
+    let hasReadme = false;
+    for (const snapshot of tree.snapshots) {
+        for (const entry of snapshot.entries) {
+            if (entry.kind !== "file")
+                continue;
+            if (README_BASENAME_RE.test(basenameOf(entry.path))) {
+                hasReadme = true;
+            }
+        }
+    }
+    const manifestKinds = [];
+    for (const kind of MANIFEST_KIND_ORDER) {
+        const winner = selectWinnerByDepth(tree, (_path, basename) => basename === kind);
+        if (winner)
+            manifestKinds.push(kind);
+    }
+    return {
+        hasReadme,
+        hasManifest: manifestKinds.length > 0,
+        manifestKinds,
+    };
+}
+/**
+ * Repository Brief. Composes the three Explorer operations into one
+ * schema-version-1 envelope (DESIGN D2/D3/D4). Fixed probe order:
+ * tree → search("README") → search(manifest names) → read loop (README
+ * first, then manifests in canonical kind order, cap 4 total reads).
+ *
+ * Parse-level validation (DESIGN D7): `validateRepo`, `--depth` and
+ * `--max-chars` positive integers, `--focus` a non-empty subset of the
+ * sealed set (default all four). Forwarding (DESIGN D3): `--no-cache`
+ * to every call; `--max-chars` to searches/reads only (the tree is
+ * never character-limited); `--depth`/`--path` to the tree only.
+ *
+ * Every Explorer call runs settled (DESIGN D6): a throw becomes a
+ * `failed` probe record and the brief continues. Exit policy: ≥1 probe
+ * `ok` → `{kind: "data"}` (exit 0); every probe terminal and failed →
+ * the last error is rethrown so the executor routes it through the
+ * standard stderr boundary (exit 1).
+ */
+export async function repoBrief(repo, options, deps, _context) {
+    validateRepo(repo);
+    // Bind the parsed values: the VALIDATED (coerced) numbers are what
+    // every probe receives — a direct caller's numeric string never leaks
+    // downstream as a string.
+    const depth = parseBriefDepth(options.depth);
+    const maxChars = parseBriefMaxChars(options.maxChars);
+    const focus = options.focus === undefined ? [...REPO_BRIEF_FOCUS] : [...new Set(options.focus)];
+    if (focus.length === 0) {
+        throw new ValidationError("--focus must include at least one of: structure, readme, manifest, files");
+    }
+    for (const token of focus) {
+        if (!REPO_BRIEF_FOCUS.includes(token)) {
+            throw new ValidationError(`Unknown --focus value "${token}". Allowed: ${REPO_BRIEF_FOCUS.join(", ")}`);
+        }
+    }
+    const wantsStructure = focus.includes("structure");
+    const wantsReadme = focus.includes("readme");
+    const wantsManifest = focus.includes("manifest");
+    const wantsFiles = focus.includes("files");
+    const probes = [];
+    let lastError = undefined;
+    // Invocation-resolved credentials for failed-probe redaction. Direct
+    // handler callers that omit `deps.secrets` get the ambient fallback
+    // (same posture as `invokeCommand`'s error boundary).
+    const secrets = deps.secrets ?? configuredSecrets();
+    // Probe 1: tree — always runs (read-path selection and `detected`
+    // both derive from it; DESIGN D1).
+    const treeProbe = await settleProbe(probes, "tree", "tree", () => explorerTree(deps.capability, { repository: repo, path: options.path, depth }, { noCache: options.noCache }, deps.execution), secrets);
+    if (!treeProbe.ok)
+        lastError = treeProbe.error;
+    // Probe 2: search("README") — only under `readme` focus.
+    let docs;
+    if (wantsReadme) {
+        const probe = await settleProbe(probes, "search", "search:readme", () => explorerSearch(deps.capability, { repository: repo, query: README_QUERY }, { noCache: options.noCache, maxChars }, deps.execution), secrets);
+        if (probe.ok)
+            docs = probe.value;
+        else
+            lastError = probe.error;
+    }
+    else {
+        probes.push({
+            kind: "search",
+            label: "search:readme",
+            status: "skipped",
+            reason: "focus-excluded",
+        });
+    }
+    // Probe 3: search(manifest names) — only under `manifest` focus.
+    let entryPoints;
+    if (wantsManifest) {
+        const probe = await settleProbe(probes, "search", "search:manifest", () => explorerSearch(deps.capability, { repository: repo, query: MANIFEST_QUERY }, { noCache: options.noCache, maxChars }, deps.execution), secrets);
+        if (probe.ok)
+            entryPoints = probe.value;
+        else
+            lastError = probe.error;
+    }
+    else {
+        probes.push({
+            kind: "search",
+            label: "search:manifest",
+            status: "skipped",
+            reason: "focus-excluded",
+        });
+    }
+    // Probe 4: read loop — only under `files` focus, using Ticket 1's
+    // deterministic tree-derived selection (DESIGN D1/D7 steps 5-8).
+    const files = [];
+    if (wantsFiles) {
+        if (treeProbe.ok) {
+            const selection = selectBriefFiles(treeProbe.value);
+            const readPaths = [];
+            if (selection.readme !== undefined)
+                readPaths.push(selection.readme);
+            readPaths.push(...selection.manifests);
+            if (readPaths.length === 0) {
+                // The stage was requested but the tree-derived selection is
+                // empty (no README, no manifest): record the terminal
+                // `read:<files>` sentinel so a focus-requested read stage ALWAYS
+                // ends in a read record (SCHEMA: probes is total over requested
+                // stages). `no-selection` distinguishes this from focus-excluded
+                // and dependency-failed.
+                probes.push({
+                    kind: "read",
+                    label: "read:<files>",
+                    status: "skipped",
+                    reason: "no-selection",
+                });
+            }
+            for (const path of readPaths) {
+                const probe = await settleProbe(probes, "read", `read:${path}`, () => explorerReadFile(deps.capability, { repository: repo, path }, { noCache: options.noCache, maxChars }, deps.execution), secrets);
+                if (probe.ok) {
+                    files.push({
+                        path: probe.value.path,
+                        content: probe.value.content,
+                        truncated: probe.value.truncated,
+                        originalContentLength: probe.value.originalContentLength,
+                    });
+                }
+                else {
+                    lastError = probe.error;
+                }
+            }
+        }
+        else {
+            // The tree failed; read selection has no path inventory to run
+            // against, so the files probe is recorded as dependency-failed.
+            probes.push({
+                kind: "read",
+                label: "read:<files>",
+                status: "skipped",
+                reason: "dependency-failed",
+            });
+        }
+    }
+    else {
+        probes.push({
+            kind: "read",
+            label: "read:<files>",
+            status: "skipped",
+            reason: "focus-excluded",
+        });
+    }
+    // Exit policy (DESIGN D6): ≥1 probe `ok` → data (exit 0), because
+    // degradations are data in `coverage`, not stderr noise. Otherwise
+    // rethrow the last error so the executor surfaces it via the standard
+    // stderr boundary (exit 1).
+    if (!probes.some((p) => p.status === "ok")) {
+        throw lastError;
+    }
+    const brief = {
+        schemaVersion: 1,
+        repository: repo,
+        focus,
+        coverage: { probes },
+        ...(wantsStructure && treeProbe.ok ? { tree: treeProbe.value } : {}),
+        ...(wantsReadme && docs !== undefined ? { docs } : {}),
+        ...(wantsManifest && entryPoints !== undefined ? { entryPoints } : {}),
+        ...(wantsFiles && files.length > 0 ? { files } : {}),
+        detected: treeProbe.ok
+            ? detectBriefSignals(treeProbe.value)
+            : { hasReadme: null, hasManifest: null, manifestKinds: null },
+    };
+    return { kind: "data", data: brief };
+}
 // ---------------------------------------------------------------------------
 // Help
 // ---------------------------------------------------------------------------
@@ -101,6 +503,7 @@ Commands:
   search <owner/repo> <query>   Search docs and code in repository
   tree <owner/repo>             Get repository directory structure
   read <owner/repo> <path>      Read a file from repository
+  brief <owner/repo>            Compose tree + search + read into one envelope
 
 Search Options:
   --language <lang>   Result language: en (default) or zh
@@ -113,6 +516,15 @@ Tree Options:
 Read Options:
   --max-chars <n>     Truncate file content to <n> chars
 
+Brief Options:
+  --focus <list>              Subset of: structure, readme, manifest, files
+                              (default: all four; comma-separated, order preserved)
+  --path <path>               Tree scope (search/read have no path parameter)
+  --depth <n>                 Tree traversal depth (default: 1)
+  --max-chars <n>             Per-call search/read character budget (forwarded
+                              to every search and read probe; the tree is
+                              never character-limited)
+
 Common Options:
   --no-cache                 Bypass the response cache for this invocation
   --provider <id>            Override the active Provider (zai | minimax | tavily | exa)
@@ -137,6 +549,12 @@ Output format (intentional schema-version-1 migration):
              originalContentLength}
   - tree:   {schemaVersion, repository, path, depth,
              snapshots:[{repository, path, entries:[{name, path, kind}]}]}
+  - brief:  {schemaVersion, repository, focus, coverage:{probes},
+             tree?, docs?, entryPoints?, files?, detected:{hasReadme,
+             hasManifest, manifestKinds}}  (sections gated by --focus;
+             coverage.probes records every probe attempt as ok/failed/
+             skipped). Tree is never character-limited; --max-chars
+             applies per call to searches and reads only.
   Root path is the empty string "". --max-chars applies only to
   search/read content; tree is never character-limited.
   Output modes for repo results:
@@ -153,6 +571,8 @@ Examples:
   scoutline repo tree vercel/next.js --path packages --depth 2
   scoutline repo read anthropics/anthropic-sdk-python src/anthropic/client.py
   scoutline repo read facebook/react README.md --max-chars 3000
+  scoutline repo brief facebook/react
+  scoutline repo brief facebook/react --focus structure,readme
   scoutline --provider minimax repo search owner/repo query   # UNSUPPORTED_CAPABILITY
 
 Notes:

package/dist/commands/repo.js.map

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