predicateaudit

package
v1.0.0-beta.159 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jul 31, 2026 License: MIT Imports: 19 Imported by: 0

Documentation

Overview

Package predicateaudit extracts predicate identities from owned source and configuration artifacts and validates them against the canonical grammar.

Index

Constants

View Source
const (
	// FixtureInvalidMarker introduces one JSON source classification on the
	// same line as the exact malformed Go predicate occurrence it classifies.
	FixtureInvalidMarker = "predicate-audit:invalid"
	// FixtureUnrelatedMarker introduces one exact disposition for an ambiguous
	// name-derived Go occurrence that was reviewed as unrelated to predicates.
	FixtureUnrelatedMarker = "predicate-audit:unrelated"
	// FixtureStoredPredicateKind is the contract kind audited by this corpus.
	FixtureStoredPredicateKind = "stored-predicate"
)

Variables

This section is empty.

Functions

func Audit

func Audit(roots ...string) ([]Candidate, []Finding, error)

Audit walks roots and returns every extracted candidate plus invalid candidates that lack an explicit predicate-audit:allow-invalid annotation.

Types

type Candidate

type Candidate struct {
	File      string
	Line      int
	Column    int
	Predicate string
	Surface   string
}

Candidate records one structurally extracted predicate use.

type Finding

type Finding struct {
	Candidate
	Reason string
}

Finding is an invalid, unclassified candidate.

type FixtureArtifactDisposition

type FixtureArtifactDisposition struct {
	File           string `json:"file"`
	Classification string `json:"classification"`
	Basis          string `json:"basis"`
}

FixtureArtifactDisposition records one exact unsupported testdata artifact that was reviewed as unrelated to predicate syntax.

type FixtureAuditResult

type FixtureAuditResult struct {
	Candidates      []FixtureCandidate
	Findings        []FixtureFinding
	Classifications int
	Dispositions    int
}

FixtureAuditResult is the complete complementary test-fixture corpus.

func AuditTestFixtures

func AuditTestFixtures(manifestPath string, roots ...string) (FixtureAuditResult, error)

AuditTestFixtures audits the corpus deliberately excluded by Audit. It only walks *_test.go plus structured artifacts below directories named testdata. Go negatives use same-line source annotations; commentless fixtures use the exact checked manifest supplied by manifestPath.

type FixtureCandidate

type FixtureCandidate struct {
	File                 string
	Line                 int
	Column               int
	Location             string
	Document             int
	Record               int
	Occurrence           int
	Predicate            string
	Surface              string
	RuntimeAuthoritative bool
	Unresolved           bool
}

FixtureCandidate records one predicate occurrence in a tracked Go test or a structured artifact beneath testdata. RuntimeAuthoritative is true when internal/semantictest.Predicate validates a dynamic position at test time.

type FixtureClassificationEntry

type FixtureClassificationEntry struct {
	File       string  `json:"file"`
	Location   string  `json:"location"`
	Document   *int    `json:"document"`
	Record     *int    `json:"record"`
	Occurrence *int    `json:"occurrence"`
	Kind       string  `json:"kind"`
	Value      *string `json:"value"`
	Reason     string  `json:"reason"`
}

FixtureClassificationEntry classifies one exact structured fixture value.

type FixtureClassificationManifest

type FixtureClassificationManifest struct {
	Version            int                          `json:"version"`
	Entries            []FixtureClassificationEntry `json:"entries"`
	UnrelatedArtifacts []FixtureArtifactDisposition `json:"unrelated_artifacts,omitempty"`
}

FixtureClassificationManifest stores exact classifications for commentless structured testdata. Location remains an RFC6901-style semantic pointer; document, record, and occurrence are separate physical discriminators.

type FixtureFinding

type FixtureFinding struct {
	File       string
	Line       int
	Location   string
	Document   int
	Record     int
	Occurrence int
	Predicate  string
	Code       string
	Message    string
}

FixtureFinding reports one malformed or incorrectly classified fixture.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL