fallow 3.18.0 → 3.20.0

package/types/output-contract.d.ts

@@ -24,7 +24,7 @@
 
 
 /**
- * Schemas for the JSON output of fallow commands. Object-shaped envelopes covered by the `FallowOutput` contract carry a top-level `kind` discriminator. Current kind values: `audit`, `explain`, `inspect_target`, `trace`, `review-envelope`, `review-reconcile`, `coverage-setup`, `coverage-analyze`, `list-boundaries`, `list-workspaces`, `health`, `dupes`, `dead-code-grouped`, `impact`, `impact-cross-repo`, `security`, `security-survivors`, `security-blind-spots`, `dead-code`, `combined`, `feature-flags`, `audit-brief`, `decision-surface`, `review-walkthrough-guide`, `review-walkthrough-validation`, `suppression-inventory`, `type-aware-status`. Consumers should branch on `kind` instead of probing for unique field presence. `CodeClimateOutput` is a bare JSON array (per the Code Climate / GitLab Code Quality spec) and stays a sibling root branch discriminated by checking whether the document root is an array. `ErrorOutput` is the `--format json` failure document, emitted on stdout with a non-zero exit; it carries no `kind` and is discriminated by the `error: true` field.
+ * Schemas for the JSON output of fallow commands. Object-shaped envelopes covered by the `FallowOutput` contract carry a top-level `kind` discriminator. Current kind values: `audit`, `explain`, `inspect_target`, `trace`, `review-envelope`, `review-reconcile`, `coverage-setup`, `coverage-analyze`, `list-boundaries`, `list-workspaces`, `health`, `dupes`, `dead-code-grouped`, `impact`, `impact-cross-repo`, `security`, `security-survivors`, `security-blind-spots`, `dead-code`, `combined`, `feature-flags`, `audit-brief`, `decision-surface`, `review-walkthrough-guide`, `review-walkthrough-validation`, `suppression-inventory`, `type-aware-status`, `similar-code`, `similar-code-inspect`, `similar-code-review`. Consumers should branch on `kind` instead of probing for unique field presence. `CodeClimateOutput` is a bare JSON array (per the Code Climate / GitLab Code Quality spec) and stays a sibling root branch discriminated by checking whether the document root is an array. `ErrorOutput` is the `--format json` failure document, emitted on stdout with a non-zero exit; it carries no `kind` and is discriminated by the `error: true` field.
  */
 export type FallowJsonOutput = (FallowOutput | CodeClimateOutput | ErrorOutput)
 /**
@@ -98,6 +98,12 @@ kind: "review-walkthrough-validation"
 kind: "suppression-inventory"
 }) | (TypeAwareStatusOutput & {
 kind: "type-aware-status"
+}) | (SimilarCodeOutput & {
+kind: "similar-code"
+}) | (SimilarCodeInspectOutput & {
+kind: "similar-code-inspect"
+}) | (SimilarCodeReviewOutput & {
+kind: "similar-code-review"
 }))
 /**
  * Schema projection for the audit envelope's exact version.
@@ -703,10 +709,11 @@ export type UnusedAtRuleKind = ("property-registration" | "layer")
 /**
  * The surface through which a design token is consumed. The `theme-var` /
  * `css-var` / `utility` / `apply` kinds are Tailwind v4 `@theme` consumption; the
- * `js-member` / `js-call` kinds are CSS-in-JS consumption (member access on an
- * imported StyleX/vanilla-extract token binding, or a PandaCSS `token('...')`
- * call). The kind is the disjoint origin signal that distinguishes a Tailwind
- * token entry from a CSS-in-JS token entry in the shared `token_consumers` list.
+ * `js-member` / `js-call` kinds are CSS-in-JS consumption (member access through a
+ * same-file or imported StyleX/vanilla-extract token binding, a StyleX
+ * theme-group call, or a PandaCSS token-path call). The kind is the disjoint origin signal that
+ * distinguishes a Tailwind token entry from a CSS-in-JS token entry in the
+ * shared `token_consumers` list.
  */
 export type ConsumerKind = ("theme-var" | "css-var" | "utility" | "apply" | "js-member" | "js-call")
 /**
@@ -981,7 +988,7 @@ export type FeatureFlagActionType = ("investigate-flag" | "suppress-line")
  * Independently-versioned wire-version newtype for the brief envelope.
  * Serializes as the integer `REVIEW_BRIEF_SCHEMA_VERSION`.
  */
-export type ReviewBriefSchemaVersion = 7
+export type ReviewBriefSchemaVersion = 8
 /**
  * The exactly-three shippable decision categories (the SOLID-3). No cut category
  * (abstraction / deletion / convention / irreversibility) is representable: this
@@ -1026,6 +1033,13 @@ export type DecisionSurfaceSchemaVersion = number
  * The discriminated action kinds a decision can carry.
  */
 export type DecisionActionType = ("ask-expert" | "suppress")
+/**
+ * Whether a changed source unit has a test file importing it, and whether that
+ * test moved with the change. A direct-importer fact from the graph, not a
+ * coverage claim: `untouched` says a test exists and was not edited, which is
+ * the verification question the reviewer asks the author, never an answer.
+ */
+export type TestAdjacency = ("none" | "untouched" | "changed")
 /**
  * The `fallow suppressions --format json` schema version. Independently
  * versioned from the main contract, mirroring `SecuritySchemaVersion`.
@@ -1043,6 +1057,74 @@ export type SuppressionInventoryOrigin = "comment"
  * Schema projection for the type-aware status envelope's exact version.
  */
 export type TypeAwareStatusSchemaVersion = 8
+/**
+ * Version singleton for raw similar-code output.
+ */
+export type SimilarCodeSchemaVersion = "1"
+/**
+ * Provider families admitted by the version 1 public contract.
+ */
+export type SimilarCodeProvider = "official-local-companion"
+/**
+ * Stable, coarse interpretation of a candidate score.
+ */
+export type SimilarCodeSimilarityBand = ("moderate" | "high" | "very-high")
+/**
+ * Verification state of a raw semantic candidate.
+ */
+export type SimilarCodeVerificationStatus = "unverified"
+/**
+ * Explicit availability state for one optional enrichment source.
+ */
+export type SimilarCodeEnrichmentState = ("available" | "unavailable" | "not-requested")
+/**
+ * Read-only actions supported by the candidate workflow.
+ */
+export type SimilarCodeActionType = ("inspect" | "review")
+/**
+ * Overall trustworthiness of an emitted result set.
+ */
+export type SimilarCodeCompletionStatus = ("complete" | "partial")
+/**
+ * Bounded phase names in the similar-code pipeline.
+ */
+export type SimilarCodePhase = ("discovery" | "extraction" | "cache" | "embedding" | "validation" | "comparison" | "enrichment")
+/**
+ * Completion state for one generation phase.
+ */
+export type SimilarCodePhaseStatus = ("complete" | "partial" | "skipped" | "timed-out")
+/**
+ * Stable reasons why admitted work was skipped or truncated.
+ */
+export type SimilarCodeSkipReason = ("below-minimum-lines" | "unsupported-function" | "generated-source" | "function-too-large" | "input-limit" | "source-bytes-limit" | "vector-memory-limit" | "comparison-limit" | "candidate-limit" | "neighbor-limit" | "timeout" | "provider-failure" | "token-truncation" | "enrichment-unavailable")
+/**
+ * Vector cache outcome for a run.
+ */
+export type SimilarCodeCacheStatus = ("disabled" | "hit" | "miss" | "mixed")
+/**
+ * Non-severity diagnostic domain for similar-code generation.
+ */
+export type SimilarCodeDiagnosticDomain = ("workspace" | "extraction" | "provider" | "cache" | "enrichment" | "review")
+/**
+ * Version singleton for a similar-code inspect packet.
+ */
+export type SimilarCodeInspectSchemaVersion = "1"
+/**
+ * Conservative syntactic side-effect hint for an inspected function.
+ */
+export type SimilarCodeSideEffectHint = ("pure-looking" | "may-have-side-effects" | "unknown")
+/**
+ * Version singleton for reviewed similar-code output.
+ */
+export type SimilarCodeReviewSchemaVersion = "1"
+/**
+ * Domain outcome assigned by review, never by candidate generation.
+ */
+export type SimilarCodeDomainOutcome = ("same-responsibility" | "related-but-distinct" | "intentional-duplication" | "unrelated" | "needs-human-review")
+/**
+ * How review matched an external verdict to the current candidate.
+ */
+export type SimilarCodeVerdictMatch = ("candidate-id" | "review-key" | "unverified" | "ambiguous-review-key")
 /**
  * Discriminator value for [`CodeClimateIssue::kind`].
  */
@@ -7759,15 +7841,17 @@ near_duplicate_theme_tokens?: NearDuplicateThemeToken[]
  */
 near_duplicate_css_in_js_tokens?: NearDuplicateThemeToken[]
 /**
- * A location-aware reverse index of Tailwind v4 `@theme` token consumers:
- * per token, where it is consumed (`var()` reads, `@apply` bodies, generated
- * utility classes) and through which surface, plus the full `consumer_count`
- * (a static lower bound) and the defining site. Built from the same gated
- * candidate set as `unused_theme_tokens` (v4 + non-plugin + non-published +
- * whole-scope), so a token with `consumer_count: 0` is the same "nothing
- * consumes this" signal. Sorted by token; empty when the project is not
- * Tailwind v4 or a plugin / published-library / partial-scope run gated the
- * scan out.
+ * A location-aware reverse index of design-token consumers. Tailwind v4
+ * entries cover `@theme` tokens consumed through `var()` reads, `@apply`
+ * bodies, or generated utilities. CSS-in-JS entries cover supported StyleX,
+ * vanilla-extract, PandaCSS, styled-components, and Emotion definitions and
+ * their member or call consumers. Every entry includes the defining site,
+ * located consumer samples, and the full `consumer_count` as a static lower
+ * bound. Tailwind entries use the same gated candidate set as
+ * `unused_theme_tokens`; CSS-in-JS entries require supported direct imports.
+ * Partial-scope runs omit the index. Sorted by token and empty when no
+ * eligible token definitions are found. A zero count is evidence for
+ * investigation, not deletion proof.
  */
 token_consumers?: TokenConsumers[]
 /**
@@ -8602,13 +8686,14 @@ actions: CssCandidateAction[]
  *   `apply`), built from the same gated candidate set as `unused_theme_tokens`
  *   (v4 + non-plugin + non-published + whole-scope), so a `consumer_count: 0`
  *   corroborates the `unused_theme_tokens` "nothing consumes this" finding.
- * - CSS-in-JS tokens (kind `js-member` / `js-call`) from StyleX `defineVars`,
- *   vanilla-extract `createTheme` family definitions, and PandaCSS `defineTokens`,
- *   consumed via cross-module member access or PandaCSS `token('...')` calls. NOTE:
+ * - CSS-in-JS tokens (kind `js-member` / `js-call`) from StyleX `defineVars` /
+ *   `unstable_defineVarsNested`, vanilla-extract `createTheme` family definitions,
+ *   and PandaCSS `defineTokens`, consumed via same-file or cross-module member
+ *   access, StyleX theme-group calls, or PandaCSS `token('...')` calls. NOTE:
  *   CSS-in-JS has NO corroborating dead-token finding (there is no
  *   `unused_theme_tokens` analogue), so a CSS-in-JS `consumer_count: 0` is a weaker
- *   signal than the Tailwind case (and the cross-file scan is relative-import or
- *   generated-token-helper only, so alias / bare-package imports are not counted).
+ *   signal than the Tailwind case (and unresolved dynamic imports or computed
+ *   accesses are not counted).
  *
  * This is DESCRIPTIVE context (a blast-radius lookup), not a finding, so it
  * deliberately carries no `actions` array (unlike the cleanup-candidate types in
@@ -8620,14 +8705,14 @@ export interface TokenConsumers {
 /**
  * The token identity. For a Tailwind `@theme` token this is the full custom
  * property as authored, INCLUDING the `--` prefix (`--color-brand`). For a
- * CSS-in-JS token (kind `js-member`) this is the binding-qualified dotted
+ * CSS-in-JS token (kind `js-member` / `js-call`) this is the binding-qualified dotted
  * access path, NO `--` prefix (`vars.color.primary`), matching how consumers
  * read it. The presence of the `--` prefix distinguishes the two origins.
  */
 token: string
 /**
  * For a Tailwind token, the v4 theme namespace (`color`, `radius`,
- * `font-weight`, ...). For a CSS-in-JS token (kind `js-member`), the defining
+ * `font-weight`, ...). For a CSS-in-JS token (kind `js-member` / `js-call`), the defining
  * export BINDING the token set is accessed through (`vars`), which identifies
  * the token set, NOT a semantic group. (The field is thus overloaded by
  * origin; branch on `consumers[].kind` or the `token` shape.)
@@ -8646,9 +8731,10 @@ definition_path: string
 definition_line: number
 /**
  * The FULL number of consumer locations found, a STATIC LOWER BOUND: a
- * computed class name (`bg-${color}`) or a value read outside CSS/markup the
- * scan never sees is not counted. This is the aggregate over every consumer,
- * computed BEFORE [`consumers`](Self::consumers) is capped to a sample.
+ * computed class name (`bg-${color}`), unresolved import, dynamic token
+ * structure, or computed CSS-in-JS access is not counted. This is the
+ * aggregate over every consumer, computed BEFORE
+ * [`consumers`](Self::consumers) is capped to a sample.
  */
 consumer_count: number
 /**
@@ -8660,8 +8746,8 @@ consumer_count: number
 consumers: TokenConsumerLocation[]
 }
 /**
- * Where one Tailwind v4 `@theme` token is consumed, and through which surface.
- * One entry in a [`TokenConsumers::consumers`] sample.
+ * Where one Tailwind or CSS-in-JS design token is consumed, and through which
+ * surface. One entry in a [`TokenConsumers::consumers`] sample.
  */
 export interface TokenConsumerLocation {
 /**
@@ -12439,6 +12525,16 @@ units: ReviewUnitFact[]
  * the `units` module directories.
  */
 order: string[]
+/**
+ * Connected components of the inter-unit dependency graph: groups of
+ * module directories that share no import edge with any unit outside the
+ * group. Present only when there are two or more; a single slice is just
+ * `order`. A slice proves the absence of import edges to the rest of the
+ * change, nothing more: whether it can land on its own is still a
+ * judgment (generated files and lockstep contracts share no edge and
+ * still belong together). An orientation fact, never a demand to split.
+ */
+independent_slices?: string[][]
 }
 /**
  * One review unit: a coherent by-module cluster of the changed set.
@@ -12604,6 +12700,19 @@ cycle_introduced: string[]
  * reachable through an `exports` path is present (exactly one).
  */
 public_api_added: string[]
+/**
+ * Third-party dependencies a changed `package.json` declares that the base
+ * manifest did not, as `<manifest>::<name>` keys. Every dependency section
+ * participates. Always present, empty when no manifest changed.
+ */
+dependency_added: string[]
+/**
+ * Declared dependencies whose range moved across a major version (or a
+ * `0.x` minor) vs base, as `<manifest>::<name>@<from>-><to>` keys. Minor
+ * and patch moves are not candidates; a non-numeric range is skipped.
+ * Always present, empty when nothing crossed a major version.
+ */
+dependency_major_bumped: string[]
 }
 /**
  * One weakening signal: a category, the file it was detected in, and a short
@@ -12884,6 +12993,11 @@ out_of_diff: string[]
  * Routed expert(s), when ownership signals are available.
  */
 expert: string[]
+/**
+ * Direct test adjacency of this unit. Absent when the graph was not
+ * retained or the unit is itself a test file.
+ */
+test_adjacency?: (TestAdjacency | null)
 }
 /**
  * One stable per-hunk CHANGE ANCHOR: a changed region the agent may cite as a
@@ -12926,8 +13040,10 @@ previous_change_anchor?: (string | null)
  */
 export interface AgentSchema {
 /**
- * How the agent must structure each judgment: cite an emitted `signal_id`,
- * add free-text `framing` (non-deterministic, fenced), an optional `concern`.
+ * How the agent must structure each judgment: cite an emitted `signal_id`
+ * or `change_anchor`, add free-text `framing` (non-deterministic, fenced),
+ * an optional `concern`, and an optional `action` from the closed
+ * vocabulary.
  */
 judgment_shape: string
 /**
@@ -12939,6 +13055,16 @@ echo_field: string
  * The anchoring rule name.
  */
 anchoring_rule: string
+/**
+ * The closed `action` vocabulary ([`JUDGMENT_ACTIONS`]): a judgment with
+ * any other value is rejected on reentry.
+ */
+action_vocabulary: string[]
+/**
+ * The recommended `concern` vocabulary ([`JUDGMENT_CONCERNS`]), documented
+ * for grouping; free text is still accepted.
+ */
+concern_vocabulary: string[]
 }
 /**
  * The `fallow review --walkthrough-file` validation envelope: the result of
@@ -13016,6 +13142,13 @@ agent_framing: string
  * The agent's optional concern category.
  */
 concern?: (string | null)
+/**
+ * The author-action label the judgment carries (`block`, `address`,
+ * `consider`, or `fyi`), validated against [`JUDGMENT_ACTIONS`]. It tells
+ * the receiving author what is required and what is optional; it is the
+ * reviewer's instruction, fenced with the framing, never a gate.
+ */
+action?: (string | null)
 /**
  * Hard fence: always `false`. The framing is agent prose, never a
  * deterministic fallow result, so it never gates or auto-posts.
@@ -13039,9 +13172,15 @@ change_anchor: string
 /**
  * The rejection reason: `unanchored-signal-id` (cited a signal fallow did
  * not emit), `unknown-change-anchor` (cited a region fallow did not emit),
- * or `stale-snapshot` (the tree moved).
+ * `stale-snapshot` (the tree moved), or `invalid-action` (an `action`
+ * outside [`JUDGMENT_ACTIONS`]; the anchor itself resolved).
  */
 reason: string
+/**
+ * The offending value for an `invalid-action` rejection, echoed so the
+ * agent can correct it in one round trip. Absent for the other reasons.
+ */
+invalid_value?: (string | null)
 }
 /**
  * The `fallow suppressions --format json` envelope. `FallowOutput`
@@ -13183,6 +13322,548 @@ backend_version?: (string | null)
  */
 remediation?: (string | null)
 }
+/**
+ * Raw `fallow similar-code --format json` output.
+ */
+export interface SimilarCodeOutput {
+schema_version: SimilarCodeSchemaVersion
+version: ToolVersion
+elapsed_ms: ElapsedMs
+generation: SimilarCodeGeneration
+/**
+ * Deterministically ordered unverified candidates.
+ */
+candidates: SimilarCodeCandidate[]
+completion: SimilarCodeCompletion
+/**
+ * Non-severity diagnostics in deterministic order.
+ */
+diagnostics: SimilarCodeDiagnostic[]
+}
+/**
+ * Complete provenance needed to reproduce candidate generation.
+ */
+export interface SimilarCodeGeneration {
+/**
+ * Version of extraction and normalization semantics used for both IDs.
+ */
+extraction_semantics_version: number
+/**
+ * Version of the calculation that produces model embeddings.
+ */
+embedding_semantics_version: number
+provider: SimilarCodeProviderProvenance
+model: SimilarCodeModelProvenance
+parameters: SimilarCodeGenerationParameters
+scope: SimilarCodeScopeProvenance
+/**
+ * Minimum cosine similarity admitted into the candidate set.
+ */
+threshold: number
+/**
+ * Minimum source line count admitted into function extraction.
+ */
+min_lines: number
+}
+/**
+ * Immutable local provider provenance for one generation run.
+ */
+export interface SimilarCodeProviderProvenance {
+provider: SimilarCodeProvider
+/**
+ * Exact companion package version.
+ */
+companion_version: string
+/**
+ * Companion protocol version negotiated for this run.
+ */
+protocol_version: number
+/**
+ * Whether source content left the local machine. Version 1 requires false.
+ */
+source_left_machine: boolean
+}
+/**
+ * Immutable model artifact provenance.
+ */
+export interface SimilarCodeModelProvenance {
+/**
+ * Stable model identifier.
+ */
+model_id: string
+/**
+ * Immutable model revision.
+ */
+revision: string
+/**
+ * SHA-256 digest of the exact model artifact bytes.
+ */
+artifact_sha256: string
+/**
+ * SPDX license identifier or reviewed license label.
+ */
+license: string
+/**
+ * Embedding vector dimensions.
+ */
+dimensions: number
+}
+/**
+ * Parameters that materially affect generated embeddings and scores.
+ */
+export interface SimilarCodeGenerationParameters {
+/**
+ * Numeric representation used for model inference.
+ */
+dtype: string
+/**
+ * Pooling strategy applied to model output.
+ */
+pooling: string
+/**
+ * Whether vectors were normalized before comparison.
+ */
+normalized: boolean
+/**
+ * Maximum inference batch size used by the run.
+ */
+batch_size: number
+/**
+ * Maximum tokenizer length before deterministic truncation.
+ */
+max_tokens: number
+/**
+ * Digest over the complete effective generation parameter set.
+ */
+parameter_sha256: string
+}
+/**
+ * Effective endpoint scope used for corpus admission and pair retention.
+ */
+export interface SimilarCodeScopeProvenance {
+/**
+ * Whether file, changed-file, diff, or workspace scoping was active.
+ */
+active: boolean
+/**
+ * Sorted project-root-relative paths satisfying every active predicate.
+ */
+paths: string[]
+}
+/**
+ * One unverified semantic similar-code candidate.
+ */
+export interface SimilarCodeCandidate {
+/**
+ * Snapshot-stable opaque candidate identity.
+ */
+candidate_id: string
+/**
+ * Content-stable key used for safe line-movement rebinding.
+ */
+review_key: string
+left: SimilarCodeLocation
+right: SimilarCodeLocation
+/**
+ * Cosine similarity reported by the pinned provider and model.
+ */
+similarity: number
+similarity_band: SimilarCodeSimilarityBand
+verification_status: SimilarCodeVerificationStatus
+enrichment: SimilarCodeEnrichmentAvailability
+/**
+ * Read-only inspect and review affordances.
+ */
+actions: SimilarCodeAction[]
+}
+/**
+ * Exact named location of one candidate function.
+ */
+export interface SimilarCodeLocation {
+/**
+ * Project-root-relative, forward-slash path.
+ */
+path: string
+/**
+ * Extracted function or method name.
+ */
+name: string
+/**
+ * One-based inclusive start line.
+ */
+start_line: number
+/**
+ * One-based inclusive start column.
+ */
+start_column: number
+/**
+ * One-based inclusive end line.
+ */
+end_line: number
+/**
+ * One-based inclusive end column.
+ */
+end_column: number
+/**
+ * SHA-256 digest of the exact extracted function source.
+ */
+source_sha256: string
+}
+/**
+ * Availability of every supported source-grounded enrichment.
+ */
+export interface SimilarCodeEnrichmentAvailability {
+graph_relationship: SimilarCodeEnrichmentState
+entry_point_reachability: SimilarCodeEnrichmentState
+callers: SimilarCodeEnrichmentState
+callees: SimilarCodeEnrichmentState
+ownership: SimilarCodeEnrichmentState
+churn: SimilarCodeEnrichmentState
+tests: SimilarCodeEnrichmentState
+deterministic_clone_coverage: SimilarCodeEnrichmentState
+runtime: SimilarCodeEnrichmentState
+}
+/**
+ * Read-only follow-up exposed for a candidate.
+ */
+export interface SimilarCodeAction {
+action: SimilarCodeActionType
+/**
+ * Human-readable description of the read-only operation.
+ */
+description: string
+/**
+ * Explicit mutation guarantee. Version 1 requires this to be true.
+ */
+read_only: boolean
+}
+/**
+ * Typed completion, limit, skip, and cache accounting.
+ */
+export interface SimilarCodeCompletion {
+status: SimilarCodeCompletionStatus
+/**
+ * Per-phase completion in pipeline order.
+ */
+phases: SimilarCodePhaseCompletion[]
+limits: SimilarCodeLimits
+/**
+ * Aggregated skips in phase and reason order.
+ */
+skips: SimilarCodeSkip[]
+cache: SimilarCodeCacheSummary
+/**
+ * Aggregate model inference wall time reported by the local provider.
+ */
+provider_inference_ms: number
+}
+/**
+ * Accounting for one bounded generation phase.
+ */
+export interface SimilarCodePhaseCompletion {
+phase: SimilarCodePhase
+status: SimilarCodePhaseStatus
+/**
+ * Number of admitted inputs processed by this phase.
+ */
+processed: number
+/**
+ * Total admitted inputs known to this phase, when available.
+ */
+total?: (number | null)
+/**
+ * Stable explanation when the phase did not complete.
+ */
+reason?: (string | null)
+}
+/**
+ * Effective resource limits for a similar-code run.
+ */
+export interface SimilarCodeLimits {
+/**
+ * Maximum source files admitted.
+ */
+max_files: number
+/**
+ * Maximum extracted functions admitted.
+ */
+max_functions: number
+/**
+ * Maximum aggregate normalized source bytes admitted.
+ */
+max_source_bytes: number
+/**
+ * Maximum normalized bytes admitted for one function.
+ */
+max_function_bytes: number
+/**
+ * Maximum embedding batch size.
+ */
+max_batch_size: number
+/**
+ * Maximum vector bytes retained for comparison.
+ */
+max_vector_bytes: number
+/**
+ * Maximum pair comparisons performed.
+ */
+max_comparisons: number
+/**
+ * Maximum candidates returned.
+ */
+max_candidates: number
+/**
+ * Maximum returned neighbors per function.
+ */
+max_neighbors_per_function: number
+/**
+ * End-to-end timeout in milliseconds.
+ */
+timeout_ms: number
+}
+/**
+ * Count of skipped work for a stable reason.
+ */
+export interface SimilarCodeSkip {
+phase: SimilarCodePhase
+reason: SimilarCodeSkipReason
+/**
+ * Number of inputs skipped for this phase and reason.
+ */
+count: number
+}
+/**
+ * Privacy-safe cache accounting. Source fragments are never represented.
+ */
+export interface SimilarCodeCacheSummary {
+status: SimilarCodeCacheStatus
+/**
+ * Valid vector cache hits.
+ */
+hits: number
+/**
+ * Vector cache misses.
+ */
+misses: number
+/**
+ * Newly written vector cache entries.
+ */
+writes: number
+/**
+ * Corrupt or incompatible entries ignored safely.
+ */
+invalid_entries: number
+}
+/**
+ * Actionable diagnostic without a severity or gate implication.
+ */
+export interface SimilarCodeDiagnostic {
+domain: SimilarCodeDiagnosticDomain
+/**
+ * Stable machine-readable code.
+ */
+code: string
+/**
+ * Bounded human-readable explanation.
+ */
+message: string
+/**
+ * Optional project-root-relative path.
+ */
+path?: (string | null)
+}
+/**
+ * `fallow similar-code inspect --format json` output.
+ */
+export interface SimilarCodeInspectOutput {
+schema_version: SimilarCodeInspectSchemaVersion
+version: ToolVersion
+elapsed_ms: ElapsedMs
+generation: SimilarCodeGeneration
+candidate: SimilarCodeCandidate
+packet: SimilarCodeInspectPacket
+completion: SimilarCodeCompletion
+/**
+ * Non-severity diagnostics in deterministic order.
+ */
+diagnostics: SimilarCodeDiagnostic[]
+}
+/**
+ * Bounded source-grounded packet for one immutable candidate.
+ */
+export interface SimilarCodeInspectPacket {
+/**
+ * Candidate identity this packet describes.
+ */
+candidate_id: string
+/**
+ * Content-stable review key this packet describes.
+ */
+review_key: string
+availability: SimilarCodeEnrichmentAvailability
+/**
+ * Graph relationship label, when relationship evidence is available.
+ */
+graph_relationship?: (string | null)
+left: SimilarCodeSideEvidence
+right: SimilarCodeSideEvidence
+}
+/**
+ * Bounded evidence for one side of an inspect packet.
+ */
+export interface SimilarCodeSideEvidence {
+/**
+ * Bounded source window included only in inspect output, never raw output or cache.
+ */
+source_window?: (string | null)
+/**
+ * Declared parameter count when extraction supplied it.
+ */
+parameter_count?: (number | null)
+/**
+ * Whether the inspected function is declared async.
+ */
+is_async?: (boolean | null)
+/**
+ * Whether the inspected function is a generator.
+ */
+is_generator?: (boolean | null)
+/**
+ * Whether the inspected function contains an await expression.
+ */
+has_await?: (boolean | null)
+/**
+ * Whether the inspected function contains a throw expression.
+ */
+has_throw?: (boolean | null)
+/**
+ * Conservative syntactic side-effect classification.
+ */
+side_effect_hint?: (SimilarCodeSideEffectHint | null)
+/**
+ * Whether the function is reachable from a configured entry point.
+ */
+entry_point_reachable?: (boolean | null)
+/**
+ * Bounded, deterministically ordered direct callers.
+ */
+callers: SimilarCodeNamedReference[]
+/**
+ * Bounded, deterministically ordered direct callees.
+ */
+callees: SimilarCodeNamedReference[]
+/**
+ * Bounded, deterministically ordered ownership labels.
+ */
+owners: string[]
+/**
+ * Recent commit count in the configured churn window.
+ */
+churn_commits?: (number | null)
+/**
+ * Bounded, root-relative related test paths.
+ */
+tests: string[]
+/**
+ * Fraction covered by deterministic clone groups, from zero through one.
+ */
+deterministic_clone_coverage?: (number | null)
+/**
+ * Runtime observation count when compatible runtime evidence is present.
+ */
+runtime_observations?: (number | null)
+}
+/**
+ * One named graph reference used in an inspect packet.
+ */
+export interface SimilarCodeNamedReference {
+/**
+ * Project-root-relative, forward-slash path.
+ */
+path: string
+/**
+ * Referenced symbol name.
+ */
+name: string
+/**
+ * One-based source line.
+ */
+line: number
+}
+/**
+ * `fallow similar-code review --format json` output.
+ */
+export interface SimilarCodeReviewOutput {
+schema_version: SimilarCodeReviewSchemaVersion
+version: ToolVersion
+elapsed_ms: ElapsedMs
+generation: SimilarCodeGeneration
+review: SimilarCodeReviewProvenance
+/**
+ * Raw candidates joined with verdicts in candidate order.
+ */
+candidates: SimilarCodeReviewedCandidate[]
+completion: SimilarCodeCompletion
+/**
+ * Non-severity diagnostics in deterministic order.
+ */
+diagnostics: SimilarCodeDiagnostic[]
+}
+/**
+ * Digests that make the review join reproducible without exposing source.
+ */
+export interface SimilarCodeReviewProvenance {
+/**
+ * SHA-256 digest of the exact candidate JSON input bytes.
+ */
+candidates_sha256: string
+/**
+ * SHA-256 digest of the exact verdict JSON input bytes.
+ */
+verdicts_sha256: string
+}
+/**
+ * One candidate joined with its separate verdict, if safely matched.
+ */
+export interface SimilarCodeReviewedCandidate {
+candidate: SimilarCodeCandidate
+/**
+ * Safely matched external verdict, absent when still unverified.
+ */
+verdict?: (SimilarCodeVerdict | null)
+verdict_match: SimilarCodeVerdictMatch
+outcome: SimilarCodeDomainOutcome
+}
+/**
+ * Separate verdict input for one immutable candidate.
+ */
+export interface SimilarCodeVerdict {
+/**
+ * Snapshot identity from the raw candidate.
+ */
+candidate_id: string
+/**
+ * Content-stable identity from the raw candidate.
+ */
+review_key: string
+/**
+ * Whether the pair is useful enough to review. Null means undecided.
+ */
+candidate_worthy?: (boolean | null)
+/**
+ * Whether the two functions behave equivalently. Null means undecided.
+ */
+behaviorally_equivalent?: (boolean | null)
+/**
+ * Whether consolidation is safe. Null means undecided.
+ */
+refactor_safe?: (boolean | null)
+outcome: SimilarCodeDomainOutcome
+/**
+ * Bounded explanation grounded in the inspected sources.
+ */
+rationale: string
+}
 /**
  * Single CodeClimate-compatible issue inside [`CodeClimateOutput`].
  */