@wrtnlabs/evidence 0.0.0 → 0.1.0

package/lib/structures/IEvidenceReview.d.ts

@@ -4,47 +4,52 @@ import type { IEvidenceTargetStatement } from "./IEvidenceTargetStatement";
  * A recorded review of an acknowledgement and the content of its cited scope.
  *
  * Graph evaluation pairs a review by semantic host, resolved target, and
- * acknowledgement kind. Required reviews must also carry the current fingerprint
- * of that target and its structural subtree. Matching target text alone cannot
- * compensate for an unrelated host or the wrong review kind.
+ * acknowledgement kind. Required reviews must also carry the current
+ * fingerprint of that target and its structural subtree. Matching target text
+ * alone cannot compensate for an unrelated host or the wrong review kind.
  *
  * Reviews remain separate from acknowledgements because they never discharge
- * coverage. Missing fingerprints are retained for diagnostics, and semantic edits
- * can expire a previously valid review. The checker validates this record and
- * content token; it does not prove the prose true or establish who reviewed it.
+ * coverage. Missing fingerprints are retained for diagnostics, and semantic
+ * edits can expire a previously valid review. The checker validates this record
+ * and content token; it does not prove the prose true or establish who reviewed
+ * it.
  *
  * @example
- * // @evidence ../api.ts#send Exercises successful delivery.
- * // @evidenceReview ../api.ts#send #<current-fingerprint> Checked delivery errors.
- * // The review supplements the evidence statement instead of replacing it.
+ *   // @evidence ../api.ts#send Exercises successful delivery.
+ *   // @evidenceReview ../api.ts#send #<current-fingerprint> Checked delivery errors.
+ *   // The review supplements the evidence statement instead of replacing it.
  */
 export interface IEvidenceReview extends IEvidenceTargetStatement {
     /**
      * Identity of this parsed review statement.
      *
      * Resolution records join to the review table through this ID. It is separate
-     * from the acknowledgement being reviewed, even when host and target coincide.
+     * from the acknowledgement being reviewed, even when host and target
+     * coincide.
      */
     id: string;
     /**
      * Acknowledgement kind validated by this review.
      *
-     * Positive evidence needs a positive review; exclusions need exclusion reviews.
-     * The wrong kind produces a pairing finding rather than satisfying review policy.
+     * Positive evidence needs a positive review; exclusions need exclusion
+     * reviews. The wrong kind produces a pairing finding rather than satisfying
+     * review policy.
      */
     reviews: EvidenceAcknowledgementKind;
     /**
      * Content fingerprint recorded by the review author, when supplied.
      *
-     * Omission remains a parseable review state. A reference requiring review reports
-     * a missing token or a stale token against the current target fingerprint.
+     * Omission remains a parseable review state. A reference requiring review
+     * reports a missing token or a stale token against the current target
+     * fingerprint.
      */
     fingerprint?: string;
     /**
      * Nonempty prose describing the recorded verification.
      *
-     * Tag parsing requires explanatory text. Graph policy checks pairing and content
-     * freshness without judging whether the described verification actually occurred.
+     * Tag parsing requires explanatory text. Graph policy checks pairing and
+     * content freshness without judging whether the described verification
+     * actually occurred.
      */
     description: string;
 }

package/lib/structures/IEvidenceSourceAddress.d.ts

@@ -16,15 +16,15 @@ export interface IEvidenceSourceAddress {
     /**
      * Case-sensitive, slash-separated path relative to the population root.
      *
-     * Population globs and root-relative artifact targets use this spelling rather
-     * than the file's physical path.
+     * Population globs and root-relative artifact targets use this spelling
+     * rather than the file's physical path.
      */
     relative: string;
     /**
      * Display path expressed from the configuration directory.
      *
-     * Across volumes it remains absolute because a relative filesystem path cannot
-     * represent that relationship.
+     * Across volumes it remains absolute because a relative filesystem path
+     * cannot represent that relationship.
      */
     display: string;
     /**

package/lib/structures/IEvidenceSourceDiagnostic.d.ts

@@ -1,16 +1,18 @@
 /**
  * Filesystem discovery failure retained in a source snapshot.
  *
- * A failed read, unstable source, or unresolved path boundary prevents the loader
- * from certifying a complete population. Adapters can preserve this failure when
- * producing graph diagnostics instead of silently omitting the affected file.
+ * A failed read, unstable source, or unresolved path boundary prevents the
+ * loader from certifying a complete population. Adapters can preserve this
+ * failure when producing graph diagnostics instead of silently omitting the
+ * affected file.
  */
 export interface IEvidenceSourceDiagnostic {
     /**
      * Stable category of the failed discovery operation.
      *
-     * Callers can distinguish access, spelling, encoding, and snapshot-consistency
-     * failures without interpreting platform-specific message text.
+     * Callers can distinguish access, spelling, encoding, and
+     * snapshot-consistency failures without interpreting platform-specific
+     * message text.
      */
     code: "root-unreadable" | "path-unreadable" | "case-mismatch" | "symlink-cycle" | "not-file" | "invalid-encoding" | "source-changed";
     /**

package/lib/structures/IEvidenceSourceFile.d.ts

@@ -1,4 +1,5 @@
 import type { IEvidenceSourceAddress } from "./IEvidenceSourceAddress";
+import type { IEvidenceSourceFingerprintRoot } from "./IEvidenceSourceFingerprintRoot";
 /**
  * Captured UTF-8 file content with every selected logical address preserved.
  *
@@ -15,36 +16,57 @@ export interface IEvidenceSourceFile {
     /**
      * Filesystem identity used to deduplicate the captured source.
      *
-     * Discovery uses device/inode identity where available and falls back to realpath.
-     * Logical aliases and hard links can therefore share this ID without losing paths.
+     * Discovery uses device/inode identity where available and falls back to
+     * realpath. Logical aliases and hard links can therefore share this ID
+     * without losing paths.
      */
     id: string;
     /**
      * Canonical path used to read this file's bytes.
      *
-     * This path anchors physical declaration sites. Hard-linked paths may share the
-     * same source ID, while logical citation paths remain in `addresses`.
+     * This path anchors physical declaration sites. Hard-linked paths may share
+     * the same source ID, while logical citation paths remain in `addresses`.
      */
     physicalPath: string;
+    /**
+     * Checkout-stable declaring path used by semantic review fingerprints.
+     *
+     * Filesystem discovery selects a deterministic logical address relative to
+     * the configuration directory. It stays independent of device/inode identity
+     * and canonical link targets while still distinguishing separate declaring
+     * files.
+     */
+    fingerprintPath: string;
+    /**
+     * Portable mapping for an adapter-owned physical population root.
+     *
+     * Filesystem snapshots provide this when the configured root was resolved.
+     * Remote and caller-authored snapshots may omit it when their unit IDs do not
+     * contain a physical root or when file-derived normalization is sufficient.
+     */
+    fingerprintRoot?: IEvidenceSourceFingerprintRoot;
     /**
      * Decoded source text with its original line endings and byte-order mark.
      *
      * Declaration ranges and documentation mappings refer to this exact string.
-     * Normalize only where a later semantic digest requires it, not before extraction.
+     * Normalize only where a later semantic digest requires it, not before
+     * extraction.
      */
     content: string;
     /**
      * SHA-256 of the original file bytes for cache invalidation.
      *
-     * This detects source changes, including edits irrelevant to one unit's semantic
-     * fingerprint. Review tokens are constructed separately from unit content.
+     * This detects source changes, including edits irrelevant to one unit's
+     * semantic fingerprint. Review tokens are constructed separately from unit
+     * content.
      */
     digest: string;
     /**
      * Logical addresses retained in deterministic path order.
      *
      * Physical deduplication must preserve each selected alias for target lookup.
-     * Address metadata distinguishes selection spelling from the canonical read path.
+     * Address metadata distinguishes selection spelling from the canonical read
+     * path.
      */
     addresses: IEvidenceSourceAddress[];
 }

package/lib/structures/IEvidenceSourceFingerprintRoot.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Physical and checkout-stable identities of one source population root.
+ *
+ * Adapters can retain the physical root in process-local unit IDs while review
+ * fingerprints replace it with the configured logical path carried here.
+ */
+export interface IEvidenceSourceFingerprintRoot {
+    /**
+     * Canonical filesystem directory used by the adapter during this analysis.
+     *
+     * Symlink and junction resolution may make this differ from the configured
+     * logical root even though both identify the same selected population.
+     */
+    physicalPath: string;
+    /**
+     * Configuration-relative logical path that identifies the population root.
+     *
+     * This path moves with a checkout and still distinguishes separately declared
+     * roots within the same Evidence configuration.
+     */
+    fingerprintPath: string;
+}

package/lib/structures/IEvidenceSourceFingerprintRoot.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/structures/IEvidenceSourceLocation.d.ts

@@ -3,8 +3,8 @@ import type { IEvidenceSourceRange } from "./IEvidenceSourceRange";
  * Source coordinate suitable for both declarations and file-level failures.
  *
  * Extraction can identify a file even when reading or parsing it fails before a
- * span exists. The optional range preserves that distinction instead of inventing
- * a line number for diagnostics without a concrete source position.
+ * span exists. The optional range preserves that distinction instead of
+ * inventing a line number for diagnostics without a concrete source position.
  */
 export interface IEvidenceSourceLocation {
     /**

package/lib/structures/IEvidenceSourcePosition.d.ts

@@ -8,15 +8,16 @@
  * rather than byte offsets or visual editor columns.
  *
  * @example
- * // In "A😀\r\nB", B begins at offset 5, line 2, column 1.
- * // The emoji contributes two code units and the CRLF contributes two more.
+ *   // In "A😀\r\nB", B begins at offset 5, line 2, column 1.
+ *   // The emoji contributes two code units and the CRLF contributes two more.
  */
 export interface IEvidenceSourcePosition {
     /**
      * Zero-based UTF-16 offset into the captured source string.
      *
-     * This is suitable for `String.slice` without byte conversion. Surrogate pairs
-     * occupy two positions, so a code-point count cannot substitute for the offset.
+     * This is suitable for `String.slice` without byte conversion. Surrogate
+     * pairs occupy two positions, so a code-point count cannot substitute for the
+     * offset.
      */
     offset: number;
     /**

package/lib/structures/IEvidenceSourceRange.d.ts

@@ -2,13 +2,17 @@ import type { IEvidenceSourcePosition } from "./IEvidenceSourcePosition";
 /**
  * A half-open span in the original captured source string.
  *
- * The inclusive start and exclusive end match JavaScript slicing. Both positions
- * retain diagnostic coordinates in the same unnormalized UTF-16 text, so adapters
- * can expose serializable locations without retaining their parser nodes.
+ * The inclusive start and exclusive end match JavaScript slicing. Both
+ * positions retain diagnostic coordinates in the same unnormalized UTF-16 text,
+ * so adapters can expose serializable locations without retaining their parser
+ * nodes.
  *
  * @example
- * const fragment: string = content.slice(range.start.offset, range.end.offset);
- * // Equal offsets describe an empty span, such as an inserted missing token.
+ *   const fragment: string = content.slice(
+ *     range.start.offset,
+ *     range.end.offset,
+ *   );
+ *   // Equal offsets describe an empty span, such as an inserted missing token.
  */
 export interface IEvidenceSourceRange {
     /**

package/lib/structures/IEvidenceSourceRoot.d.ts

@@ -2,9 +2,10 @@
  * Configured, logical, and physical locations of a source population's root.
  *
  * Relative roots resolve from the configuration directory, while directory
- * symlinks and Windows junctions can redirect the physical scan. These spellings
- * remain separate so discovery can enforce boundaries and diagnostics can still
- * explain the path the user configured, including roots that cannot be read.
+ * symlinks and Windows junctions can redirect the physical scan. These
+ * spellings remain separate so discovery can enforce boundaries and diagnostics
+ * can still explain the path the user configured, including roots that cannot
+ * be read.
  */
 export interface IEvidenceSourceRoot {
     /**
@@ -24,15 +25,17 @@ export interface IEvidenceSourceRoot {
     /**
      * Canonical directory used for scanning when discovery resolves the root.
      *
-     * Omission records that no directory could be resolved. The logical path remains
-     * available for diagnostics and watch recovery of a missing or repaired root.
+     * Omission records that no directory could be resolved. The logical path
+     * remains available for diagnostics and watch recovery of a missing or
+     * repaired root.
      */
     physical?: string;
     /**
-     * User-facing root path relative to the configuration directory where possible.
+     * User-facing root path relative to the configuration directory where
+     * possible.
      *
-     * Cross-volume paths remain absolute. This presentation choice does not replace
-     * logical or physical identity during source discovery.
+     * Cross-volume paths remain absolute. This presentation choice does not
+     * replace logical or physical identity during source discovery.
      */
     display: string;
 }

package/lib/structures/IEvidenceSourceSnapshot.d.ts

@@ -5,9 +5,10 @@ import type { IEvidenceSourceRoot } from "./IEvidenceSourceRoot";
 /**
  * Captured discovery result for one configured source selection.
  *
- * The loader resolves a root, applies ordered globs, reads files, and deduplicates
- * physical identities while preserving logical addresses. Adapters consume this
- * snapshot so declaration positions and content come from the same source revision.
+ * The loader resolves a root, applies ordered globs, reads files, and
+ * deduplicates physical identities while preserving logical addresses. Adapters
+ * consume this snapshot so declaration positions and content come from the same
+ * source revision.
  *
  * Dependencies include locations needed to observe new files and repairs.
  * Diagnostics and completeness distinguish an empty successful selection from a
@@ -25,8 +26,9 @@ export interface IEvidenceSourceSnapshot {
     /**
      * Captured physical files ordered by their first selected address.
      *
-     * The list can be partial after failure. Inspect `complete` before treating it
-     * as the full source population, even when some files were loaded successfully.
+     * The list can be partial after failure. Inspect `complete` before treating
+     * it as the full source population, even when some files were loaded
+     * successfully.
      */
     files: IEvidenceSourceFile[];
     /**
@@ -46,8 +48,9 @@ export interface IEvidenceSourceSnapshot {
     /**
      * Whether discovery completed without failures.
      *
-     * An empty successful glob selection remains complete. Missing roots, unreadable
-     * files, or other discovery failures cannot be concealed by an empty file list.
+     * An empty successful glob selection remains complete. Missing roots,
+     * unreadable files, or other discovery failures cannot be concealed by an
+     * empty file list.
      */
     complete: boolean;
 }

package/lib/structures/IEvidenceSupportedDatabaseLanguage.d.ts

@@ -4,9 +4,9 @@ import type { IEvidenceLanguageGrammar } from "./IEvidenceLanguageGrammar";
 /**
  * Database capability entry guaranteed to have a certified schema adapter.
  *
- * Supported-database queries use this narrower shape after excluding grammar-only
- * entries. The required adapter contract lets callers inspect extraction and
- * target-address boundaries without another availability check.
+ * Supported-database queries use this narrower shape after excluding
+ * grammar-only entries. The required adapter contract lets callers inspect
+ * extraction and target-address boundaries without another availability check.
  */
 export interface IEvidenceSupportedDatabaseLanguage {
     /**
@@ -24,13 +24,15 @@ export interface IEvidenceSupportedDatabaseLanguage {
     /**
      * Grammar variants and logical filename rules associated with the adapter.
      *
-     * These describe syntax selection without implying that metadata inspection loads WASM.
+     * These describe syntax selection without implying that metadata inspection
+     * loads WASM.
      */
     grammars: IEvidenceLanguageGrammar[];
     /**
      * Guaranteed schema extraction and documentation-host contract.
      *
-     * This includes selectors, address policy, and explicit unsupported capabilities.
+     * This includes selectors, address policy, and explicit unsupported
+     * capabilities.
      */
     adapter: IEvidenceDatabaseLanguageAdapter;
 }

package/lib/structures/IEvidenceSupportedLanguage.d.ts

@@ -6,7 +6,8 @@ import type { IEvidenceLanguageGrammar } from "./IEvidenceLanguageGrammar";
  *
  * Supported-language queries narrow the broader grammar catalog to entries that
  * can extract Evidence inventories. Consumers can inspect adapter boundaries
- * directly without mistaking a grammar-only entry for implemented graph support.
+ * directly without mistaking a grammar-only entry for implemented graph
+ * support.
  */
 export interface IEvidenceSupportedLanguage {
     /**
@@ -18,7 +19,8 @@ export interface IEvidenceSupportedLanguage {
     /**
      * Display name accompanying the family discriminator.
      *
-     * It is intended for capability reports rather than target or identity matching.
+     * It is intended for capability reports rather than target or identity
+     * matching.
      */
     name: string;
     /**

package/lib/structures/IEvidenceSwaggerClaim.d.ts

@@ -3,9 +3,9 @@ import type { IEvidenceClaimBase } from "./IEvidenceClaimBase";
  * Swagger/OpenAPI operations that cite evidence from their descriptions.
  *
  * Each HTTP method and path identifies one semantic operation host. Description
- * text provides its annotation carrier, but host participation does not depend on
- * already having written documentation; otherwise undocumented operations could
- * disappear from policies that require every selected host to answer.
+ * text provides its annotation carrier, but host participation does not depend
+ * on already having written documentation; otherwise undocumented operations
+ * could disappear from policies that require every selected host to answer.
  *
  * - File globs select local JSON/YAML documents. Each operation is a host
  *   addressed as METHOD:/path.

package/lib/structures/IEvidenceSwaggerReference.d.ts

@@ -4,11 +4,11 @@ import type { IEvidenceReferenceBase } from "./IEvidenceReferenceBase";
  *
  * Each operation is a separate unit addressed by a whitespace-free
  * `METHOD:/path` token. The document boundary belongs to the reference entry,
- * allowing identical operation tokens in different documents to impose independent
- * coverage requirements.
+ * allowing identical operation tokens in different documents to impose
+ * independent coverage requirements.
  *
  * @example
- * GET:/users/{id}
+ *   GET:/users/{id}
  */
 export interface IEvidenceSwaggerReference extends IEvidenceReferenceBase<"swagger", "operation"> {
     /**
@@ -17,7 +17,8 @@ export interface IEvidenceSwaggerReference extends IEvidenceReferenceBase<"swagg
      * - Relative paths resolve from root. Absolute paths are accepted; Windows
      *   drive-relative paths are invalid.
      * - Remote loading and document normalization failures are reported.
-     * - Use separate reference entries for independent coverage of multiple documents.
+     * - Use separate reference entries for independent coverage of multiple
+     *   documents.
      */
     file: string;
 }

package/lib/structures/IEvidenceTagParseResult.d.ts

@@ -5,9 +5,10 @@ import type { IEvidenceWithdrawal } from "./IEvidenceWithdrawal";
 /**
  * Annotation records extracted from one mapped documentation host.
  *
- * Acknowledgements, reviews, and withdrawals remain separate because they affect
- * coverage, freshness, and public visibility respectively. Invalid annotations
- * retain diagnostics instead of being accepted as evidence or discarded silently.
+ * Acknowledgements, reviews, and withdrawals remain separate because they
+ * affect coverage, freshness, and public visibility respectively. Invalid
+ * annotations retain diagnostics instead of being accepted as evidence or
+ * discarded silently.
  */
 export interface IEvidenceTagParseResult {
     /**
@@ -25,7 +26,8 @@ export interface IEvidenceTagParseResult {
     /**
      * Accepted directives withdrawing documented declarations from public API.
      *
-     * Extraction records the original locations for inherited exclusion diagnostics.
+     * Extraction records the original locations for inherited exclusion
+     * diagnostics.
      */
     withdrawals: IEvidenceWithdrawal[];
     /**

package/lib/structures/IEvidenceTargetResolution.d.ts

@@ -6,10 +6,10 @@ import type { IEvidenceWithdrawal } from "./IEvidenceWithdrawal";
 /**
  * Resolution outcome for an authored target within one reference population.
  *
- * The resolver retains attempted addresses and candidate units even when it cannot
- * accept a unique visible target. Diagnostics distinguish malformed spelling,
- * unavailable files, selection boundaries, and incomplete extraction so callers
- * do not report every failure as a missing member.
+ * The resolver retains attempted addresses and candidate units even when it
+ * cannot accept a unique visible target. Diagnostics distinguish malformed
+ * spelling, unavailable files, selection boundaries, and incomplete extraction
+ * so callers do not report every failure as a missing member.
  */
 export interface IEvidenceTargetResolution {
     /**
@@ -22,9 +22,9 @@ export interface IEvidenceTargetResolution {
     /**
      * Candidate public addresses produced by the artifact's target grammar.
      *
-     * File-qualified targets can produce several absolute paths when a merged host
-     * retains multiple origins. Synthetic artifact grammars retain their own file
-     * keys, and malformed targets may produce no addresses.
+     * File-qualified targets can produce several absolute paths when a merged
+     * host retains multiple origins. Synthetic artifact grammars retain their own
+     * file keys, and malformed targets may produce no addresses.
      */
     addresses: IEvidenceAddress[];
     /**

package/lib/structures/IEvidenceTargetStatement.d.ts

@@ -2,8 +2,8 @@ import type { IEvidenceSourceLocation } from "./IEvidenceSourceLocation";
 /**
  * Source attachment and target text shared by acknowledgements and reviews.
  *
- * Parsing establishes where a statement was written while leaving its target
- * in authored form. Artifact-specific resolution later interprets the token from
+ * Parsing establishes where a statement was written while leaving its target in
+ * authored form. Artifact-specific resolution later interprets the token from
  * the host's source context. Sharing these fields does not let a review satisfy
  * coverage: the derived record still determines the statement's role.
  */
@@ -18,15 +18,17 @@ export interface IEvidenceTargetStatement {
     /**
      * Target token preserved as written in the annotation.
      *
-     * The referenced artifact determines its grammar and lookup rules. Keeping the
-     * authored spelling allows diagnostics to explain aliases and invalid targets.
+     * The referenced artifact determines its grammar and lookup rules. Keeping
+     * the authored spelling allows diagnostics to explain aliases and invalid
+     * targets.
      */
     target: string;
     /**
      * Original source position of the complete statement.
      *
-     * Decoded documentation maps this location back to captured source characters,
-     * allowing a finding to identify the annotation rather than only its host.
+     * Decoded documentation maps this location back to captured source
+     * characters, allowing a finding to identify the annotation rather than only
+     * its host.
      */
     location: IEvidenceSourceLocation;
 }

package/lib/structures/IEvidenceUnit.d.ts

@@ -5,31 +5,34 @@ import type { IEvidenceWithdrawal } from "./IEvidenceWithdrawal";
 /**
  * A semantic declaration that can participate in evidence coverage.
  *
- * Adapters create units for their public declarations, such as a class, database
- * column, Markdown heading, or API operation. Coverage counts these identities,
- * not their exported names: exposing a declaration through two aliases leaves
- * one unit, while overloads merge only when the language establishes one family.
+ * Adapters create units for their public declarations, such as a class,
+ * database column, Markdown heading, or API operation. Coverage counts these
+ * identities, not their exported names: exposing a declaration through two
+ * aliases leaves one unit, while overloads merge only when the language
+ * establishes one family.
  *
- * Ownership, addressing, and source position are separate. `parentId` establishes
- * structural containment; public addresses live in the inventory; `sites` records
- * the physical declarations. Population selection and withdrawal follow parent
- * links, so punctuation in a name cannot manufacture an ancestor.
+ * Ownership, addressing, and source position are separate. `parentId`
+ * establishes structural containment; public addresses live in the inventory;
+ * `sites` records the physical declarations. Population selection and
+ * withdrawal follow parent links, so punctuation in a name cannot manufacture
+ * an ancestor.
  *
- * The same unit can serve as a claim host and as a reference target in different
- * populations. Its review fingerprint belongs to its content and structural
- * subtree, independently of those selections or aliases.
+ * The same unit can serve as a claim host and as a reference target in
+ * different populations. Its review fingerprint belongs to its content and
+ * structural subtree, independently of those selections or aliases.
  *
  * @example
- * // Exporting Client as PublicClient adds an address, not another class unit.
- * // Client.send keeps the same parentId through either exported name.
- * // A member named "send.request" occupies one identity segment, not two.
+ *   // Exporting Client as PublicClient adds an address, not another class unit.
+ *   // Client.send keeps the same parentId through either exported name.
+ *   // A member named "send.request" occupies one identity segment, not two.
  */
 export interface IEvidenceUnit {
     /**
      * Adapter-established identity of the declaration.
      *
      * Overloads or merged declarations share this ID only when language rules
-     * establish one unit. Public aliases and population selectors never change it.
+     * establish one unit. Public aliases and population selectors never change
+     * it.
      */
     id: string;
     /**
@@ -43,14 +46,16 @@ export interface IEvidenceUnit {
      * Artifact language or format that defines this declaration.
      *
      * The discriminator determines the adapter and selector family. It does not
-     * indicate whether a particular population uses the unit as claim or reference.
+     * indicate whether a particular population uses the unit as claim or
+     * reference.
      */
     type: EvidenceArtifactType;
     /**
      * Selector category assigned by the adapter.
      *
      * Configuration uses this category to choose required units. An unselected
-     * parent can remain addressable as a scope without adding to that denominator.
+     * parent can remain addressable as a scope without adding to that
+     * denominator.
      */
     symbol: EvidenceSymbol;
     /**
@@ -60,7 +65,7 @@ export interface IEvidenceUnit {
      * `parentId` remains authoritative for its structural ownership.
      *
      * @example
-     * ["Client", "send.request"] // The last segment is one literal member name.
+     *   ["Client", "send.request"]; // The last segment is one literal member name.
      */
     identity: string[];
     /**
@@ -82,7 +87,8 @@ export interface IEvidenceUnit {
      * Physical declarations contributing to this identity.
      *
      * Overloads and merged declarations retain their individual sites for host
-     * ownership checks and fingerprint content, even though coverage counts one unit.
+     * ownership checks and fingerprint content, even though coverage counts one
+     * unit.
      */
     sites: IEvidenceUnitSite[];
     /**