Help us shape the future of Go! Take the 2026 Go Developer Survey

artifactwire

package
v0.1.26 Latest Latest
Warning

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

Go to latest
Published: Oct 31, 2026 License: MIT Imports: 2 Imported by: 0

Documentation

Overview

Package artifactwire owns primitive persisted representations shared by writers and readers. Its values carry no validation or storage authority.

Index

Constants

View Source
const (
	ReviewArtifactV4                = "mulgae-review-artifact.v4"
	ReviewArtifactV4Schema          = "https://mulgae.local/schemas/mulgae-review-artifact.v4.schema.json"
	RunManifestV4                   = "mulgae-run-manifest.v4"
	RunManifestV4Schema             = "https://mulgae.local/schemas/mulgae-run-manifest.v4.schema.json"
	ReviewArtifactV1                = "mulgae-review-artifact.v1"
	ReviewArtifactV1Schema          = "https://mulgae.local/schemas/mulgae-review-artifact.v1.schema.json"
	ReviewArtifactV2                = "mulgae-review-artifact.v2"
	ReviewArtifactV2Schema          = "https://mulgae.local/schemas/mulgae-review-artifact.v2.schema.json"
	ReviewArtifactV3                = "mulgae-review-artifact.v3"
	ReviewArtifactV3Schema          = "https://mulgae.local/schemas/mulgae-review-artifact.v3.schema.json"
	RunManifestV1                   = "mulgae-run-manifest.v1"
	RunManifestV1Schema             = "https://mulgae.local/schemas/mulgae-run-manifest.v1.schema.json"
	RunManifestV2                   = "mulgae-run-manifest.v2"
	RunManifestV2Schema             = "https://mulgae.local/schemas/mulgae-run-manifest.v2.schema.json"
	RunManifestV3                   = "mulgae-run-manifest.v3"
	RunManifestV3Schema             = "https://mulgae.local/schemas/mulgae-run-manifest.v3.schema.json"
	CompositeReviewArtifactV1       = "mulgae-composite-review-artifact.v1"
	CompositeReviewArtifactV1Schema = "https://mulgae.local/schemas/mulgae-composite-review-artifact.v1.schema.json"
	CompositeReviewArtifactV2       = "mulgae-composite-review-artifact.v2"
	CompositeReviewArtifactV2Schema = "https://mulgae.local/schemas/mulgae-composite-review-artifact.v2.schema.json"
	CompositeRunManifestV1          = "mulgae-composite-run-manifest.v1"
	CompositeRunManifestV1Schema    = "https://mulgae.local/schemas/mulgae-composite-run-manifest.v1.schema.json"
	CompositeRunManifestV2          = "mulgae-composite-run-manifest.v2"
	CompositeRunManifestV2Schema    = "https://mulgae.local/schemas/mulgae-composite-run-manifest.v2.schema.json"
	PublicationJournalV1            = "mulgae-publication-journal.v1"
	PublicationStatusV1             = "mulgae-publication-status.v1"
	PublicationEpochV1              = "mulgae-publication-epoch.v1"
	LineageEdgeV1                   = "mulgae-lineage-edge.v1"
	LineageEdgeV2                   = "mulgae-lineage-edge.v2"
	CorruptionDiagnosticV1          = "mulgae-publication-corruption.v1"
	CapturedReviewArchiveV1         = "mulgae-captured-review-archive.v1"
	CapturedReviewArchiveV2         = "mulgae-captured-review-archive.v2"
	RunRecoveryV1                   = "mulgae-run-recovery.v1"
	RunRecoveryV1Schema             = "https://mulgae.local/schemas/mulgae-run-recovery.v1.schema.json"
)

Independent format axes; callers retain version selection.

View Source
const (
	ManifestPath           = "manifest.json"
	JournalPath            = "publication/journal.json"
	StatusPath             = "status.json"
	SupportIndexPath       = "support/index.json"
	ValidatedCandidatePath = "validation/final-candidate.json"
	RecoveryManifestPath   = "recovery/manifest.json"
	CompositeSupportPath   = "support/composite.json"
)

Path spelling is lexical only. Callers validate identities, choose kinds and construct safe paths; no helper cleans or validates its arguments.

View Source
const (
	SupportIndexV1 = "mulgae-run-support-index.v1"
	SupportIndexV2 = "mulgae-run-support-index.v2"
	SupportIndexV4 = "mulgae-run-support-index.v4"
	SupportIndexV3 = "mulgae-run-support-index.v3"
)
View Source
const RuntimePromptManifestV1 = "mulgae-runtime-prompt-manifest.v1"
View Source
const RuntimeTargetManifestV1 = "mulgae-runtime-target-manifest.v1"

Variables

This section is empty.

Functions

func AttemptPath

func AttemptPath(attempt, member string) string

func CandidateName

func CandidateName(kind string, ordinal int) string

func CanonicalExcerptName

func CanonicalExcerptName(name string) bool

func CanonicalInvocationDirectory

func CanonicalInvocationDirectory(value string) bool

func CapturedBlobPath

func CapturedBlobPath(digest string) string

func CompositeFindingPath

func CompositeFindingPath(finding string) string

func CompositeSourcePrefix

func CompositeSourcePrefix(role string) string

func CorruptionDiagnosticPath

func CorruptionDiagnosticPath(session, run string, epoch uint64) string

func DecimalDigits

func DecimalDigits(value string, minimumWidth int) bool

func DecimalIdentifier

func DecimalIdentifier(value string, minimumWidth int) bool

func EpochPath

func EpochPath(epoch uint64) string

func EvidenceExcerptName

func EvidenceExcerptName(finding string, position int) string

func FinalName

func FinalName(review string) string

func FinalPath

func FinalPath(session, run, review string) string

func FindingName

func FindingName(finding string) string

func InvocationPath

func InvocationPath(sequence uint64, purpose, stream string) string

func LineageEdgePath

func LineageEdgePath(review string) string

func PreparedCompositePath

func PreparedCompositePath(session, run, name string) string

func PromptBase

func PromptBase(sequence uint64, purpose string) string

func PromptPath

func PromptPath(attempt string, sequence uint64, purpose, suffix string) string

func RecoveryBlobPath

func RecoveryBlobPath(digest string) string

func RoleReportPath

func RoleReportPath(role string) string

func RunPath

func RunPath(session, run, relative string) string

func StagedFinalPath

func StagedFinalPath(session, run, review string) string

Types

type ArtifactIdentity

type ArtifactIdentity struct {
	Path   string `json:"path"`
	SHA256 string `json:"sha256"`
}

type BuildMetadata

type BuildMetadata struct {
	Version string  `json:"version"`
	Commit  *string `json:"commit"`
}

type CompositeComposition

type CompositeComposition struct {
	Fingerprint                string            `json:"fingerprint"`
	RootRunID                  string            `json:"root_run_id"`
	RootReviewID               string            `json:"root_review_id,omitempty"`
	Sources                    []CompositeSource `json:"sources"`
	RootRecoveryManifestSHA256 string            `json:"root_recovery_manifest_sha256,omitempty"`
	RootSourceKind             string            `json:"root_source_kind,omitempty"`
}

type CompositeFinding

type CompositeFinding struct {
	ID             string                 `json:"id"`
	Fingerprint    string                 `json:"fingerprint"`
	Role           string                 `json:"role"`
	Severity       string                 `json:"severity"`
	Title          string                 `json:"title"`
	Description    string                 `json:"description"`
	Recommendation string                 `json:"recommendation"`
	Confidence     string                 `json:"confidence"`
	Lifecycle      string                 `json:"lifecycle"`
	Source         CompositeFindingSource `json:"source"`
}

type CompositeFindingSource

type CompositeFindingSource struct {
	RunID                  string `json:"run_id"`
	ReviewID               string `json:"review_id,omitempty"`
	AttemptID              string `json:"attempt_id"`
	FindingID              string `json:"finding_id"`
	RecoveryManifestSHA256 string `json:"recovery_manifest_sha256,omitempty"`
	SourceKind             string `json:"source_kind,omitempty"`
}

type CompositeManifestRole

type CompositeManifestRole struct {
	Role        string `json:"role"`
	Path        string `json:"path"`
	SHA256      string `json:"sha256"`
	ByteLength  int    `json:"byte_length"`
	AttemptID   string `json:"attempt_id"`
	SourceRunID string `json:"source_run_id"`
}

type CompositeRole

type CompositeRole struct {
	Role                         string   `json:"role"`
	Required                     bool     `json:"required"`
	Outcome                      string   `json:"outcome"`
	AttemptID                    string   `json:"attempt_id"`
	ProviderInstance             string   `json:"provider_instance"`
	ValidFindingIDs              []string `json:"valid_finding_ids"`
	SourceRunID                  string   `json:"source_run_id"`
	SourceReviewID               string   `json:"source_review_id,omitempty"`
	SourceRecoveryManifestSHA256 string   `json:"source_recovery_manifest_sha256,omitempty"`
	SourceKind                   string   `json:"source_kind,omitempty"`
}

type CompositeSource

type CompositeSource struct {
	Kind                   string `json:"kind"`
	Role                   string `json:"role"`
	RunID                  string `json:"run_id"`
	ReviewID               string `json:"review_id,omitempty"`
	AttemptID              string `json:"attempt_id"`
	RoleReportSHA256       string `json:"role_report_sha256"`
	RecoveryManifestSHA256 string `json:"recovery_manifest_sha256,omitempty"`
	SourceKind             string `json:"source_kind,omitempty"`
}

type CorruptionDiagnostic

type CorruptionDiagnostic struct {
	SchemaVersion    string   `json:"schema_version"`
	SessionID        string   `json:"session_id"`
	RunID            string   `json:"run_id"`
	ObservationEpoch uint64   `json:"observation_epoch"`
	ReasonCodes      []string `json:"reason_codes"`
}

type FinalReviewIdentity

type FinalReviewIdentity struct {
	ReviewID string `json:"review_id"`
	Path     string `json:"path"`
	SHA256   string `json:"sha256"`
}

type ImmutableLineage

type ImmutableLineage struct {
	ParentRunID                  *string `json:"parent_run_id"`
	SourceRunID                  *string `json:"source_run_id"`
	SourceReviewID               *string `json:"source_review_id"`
	SourceRecoveryManifestSHA256 *string `json:"source_recovery_manifest_sha256,omitempty"`
	SourceKind                   string  `json:"source_kind,omitempty"`
	SourceAttemptID              *string `json:"source_attempt_id,omitempty"`
	SourceFindingRef             *string `json:"source_finding_ref"`
	ReplayMode                   *string `json:"replay_mode"`
	LineageEdgePath              string  `json:"lineage_edge_path"`
	LineageEdgeSHA256            string  `json:"lineage_edge_sha256"`
}

type LineageChild

type LineageChild struct {
	SessionID string `json:"session_id"`
	RunID     string `json:"run_id"`
	ReviewID  string `json:"review_id"`
}

type LineageEdge

type LineageEdge struct {
	SchemaVersion                string       `json:"schema_version"`
	EdgeID                       string       `json:"edge_id"`
	Child                        LineageChild `json:"child"`
	ParentRunID                  *string      `json:"parent_run_id"`
	SourceRunID                  *string      `json:"source_run_id"`
	SourceReviewID               *string      `json:"source_review_id"`
	SourceRecoveryManifestSHA256 *string      `json:"source_recovery_manifest_sha256,omitempty"`
	SourceKind                   string       `json:"source_kind,omitempty"`
	SourceAttemptID              *string      `json:"source_attempt_id,omitempty"`
	SourceFindingRef             *string      `json:"source_finding_ref"`
	ReplayMode                   *string      `json:"replay_mode"`
}

type LiveProductionProvenance

type LiveProductionProvenance struct {
	BuildProduct          string               `json:"build_product"`
	BuildVersion          string               `json:"build_version"`
	BuildCommit           string               `json:"build_commit"`
	ObjectiveSHA256       *string              `json:"objective_sha256"`
	ObjectivePresent      bool                 `json:"objective_present"`
	SourceIdentitySHA256  string               `json:"source_identity_sha256"`
	SourceTerminalReceipt string               `json:"source_terminal_receipt"`
	Providers             []ProductionProvider `json:"providers"`
}

type ManifestAttempt

type ManifestAttempt struct {
	AttemptID        string `json:"attempt_id"`
	Role             string `json:"role"`
	ProviderInstance string `json:"provider_instance"`
	SelectedAs       string `json:"selected_as"`
	State            string `json:"state"`
	ParseState       string `json:"parse_state"`
	ValidationState  string `json:"validation_state"`
	Path             string `json:"path"`
	InvocationCount  int    `json:"invocation_count"`
}

type ManifestFailure

type ManifestFailure struct {
	Class      string  `json:"class"`
	Stage      string  `json:"stage"`
	ReasonCode string  `json:"reason_code"`
	AttemptID  *string `json:"attempt_id"`
}

type ManifestRoleReport

type ManifestRoleReport struct {
	Role             string `json:"role"`
	Path             string `json:"path"`
	SHA256           string `json:"sha256"`
	ByteLength       int    `json:"byte_length"`
	ProviderInstance string `json:"provider_instance"`
	AttemptID        string `json:"attempt_id"`
	ContentType      string `json:"content_type"`
	Transport        string `json:"transport"`
}

type PathPointer

type PathPointer struct {
	Path string `json:"path"`
}

type ProductionProvenance

type ProductionProvenance struct {
	BuildProduct             string               `json:"build_product"`
	BuildVersion             string               `json:"build_version"`
	BuildCommit              string               `json:"build_commit"`
	ObjectiveSHA256          *string              `json:"objective_sha256"`
	ObjectivePresent         bool                 `json:"objective_present"`
	SnapshotManifestSHA256   string               `json:"snapshot_manifest_sha256"`
	WorkspaceTerminalReceipt string               `json:"workspace_terminal_receipt"`
	Providers                []ProductionProvider `json:"providers"`
}

type ProductionProvider

type ProductionProvider struct {
	Family                    string   `json:"family"`
	Instance                  string   `json:"instance"`
	Version                   string   `json:"version"`
	Executable                string   `json:"executable"`
	ExecutableSHA256          string   `json:"executable_sha256"`
	Launcher                  string   `json:"launcher"`
	LauncherSHA256            string   `json:"launcher_sha256"`
	ProfileGeneration         string   `json:"profile_generation"`
	AdapterProfile            string   `json:"adapter_profile"`
	QualificationReceiptIDs   []string `json:"qualification_receipt_ids"`
	PacketTransportReceiptIDs []string `json:"packet_transport_receipt_ids"`
	NamespaceTerminalReceipt  string   `json:"namespace_terminal_receipt"`
}

type PublicationEpoch

type PublicationEpoch struct {
	SchemaVersion string           `json:"schema_version"`
	StoreEpoch    uint64           `json:"store_epoch"`
	Manifest      ArtifactIdentity `json:"manifest"`
	LineageEdge   ArtifactIdentity `json:"lineage_edge"`
	FinalReview   ArtifactIdentity `json:"final_review"`
}

type PublicationJournal

type PublicationJournal struct {
	SchemaVersion string `json:"schema_version"`
	RestartState
}

type PublicationStatus

type PublicationStatus struct {
	SchemaVersion        string `json:"schema_version"`
	PublicationStatus    string `json:"publication_status"`
	PublicationAuthority string `json:"publication_authority"`
	RestartState
}

type RestartState

type RestartState struct {
	SessionID                string           `json:"session_id"`
	RunID                    string           `json:"run_id"`
	PersistedJournalState    string           `json:"persisted_journal_state"`
	ExpectedStaged           ArtifactIdentity `json:"expected_staged"`
	ExpectedFinal            ArtifactIdentity `json:"expected_final"`
	ValidatedCandidateSHA256 string           `json:"validated_candidate_sha256"`
	StoreEpoch               uint64           `json:"store_epoch"`
	NormalExit               int              `json:"normal_exit"`
	ManifestPath             string           `json:"manifest_path"`
	LineageEdgePath          string           `json:"lineage_edge_path"`
	EpochPath                string           `json:"epoch_path"`
}

type RoleOutcome

type RoleOutcome struct {
	Role             string   `json:"role"`
	Required         bool     `json:"required"`
	Outcome          string   `json:"outcome"`
	AttemptID        *string  `json:"attempt_id"`
	ProviderInstance *string  `json:"provider_instance"`
	SelectedVia      *string  `json:"selected_via"`
	ValidFindingIDs  []string `json:"valid_finding_ids"`
	FailureReason    *string  `json:"failure_reason"`
	Limitations      []string `json:"limitations"`
}

type RuntimePromptManifest

type RuntimePromptManifest struct {
	SchemaVersion         string            `json:"schema_version"`
	Target                ArtifactIdentity  `json:"target"`
	Stdin                 ArtifactIdentity  `json:"stdin"`
	CompleteStdinSHA256   string            `json:"complete_stdin_sha256"`
	TemplateID            string            `json:"template_id"`
	TemplateVersion       string            `json:"template_version"`
	TemplateSHA256        string            `json:"template_sha256"`
	SourceInvocationID    string            `json:"source_invocation_id"`
	ExecutionInvocationID string            `json:"execution_invocation_id"`
	Scope                 string            `json:"scope"`
	Role                  string            `json:"role"`
	AdapterProfile        string            `json:"adapter_profile"`
	AdapterParameters     map[string]string `json:"adapter_parameters"`
}

type RuntimeTargetManifest

type RuntimeTargetManifest struct {
	SchemaVersion         string                 `json:"schema_version"`
	Target                ArtifactIdentity       `json:"target"`
	CapturedArchive       *ArtifactIdentity      `json:"captured_archive,omitempty"`
	ArtistBrief           *ArtifactIdentity      `json:"artist_brief,omitempty"`
	ArtistVisualAssets    *ArtifactIdentity      `json:"artist_visual_assets,omitempty"`
	TargetKind            string                 `json:"target_kind"`
	RepositoryID          string                 `json:"repository_id"`
	BaseObjectID          string                 `json:"base_object_id"`
	HeadObjectID          string                 `json:"head_object_id"`
	HeadTreeObjectID      string                 `json:"head_tree_object_id"`
	IndexTreeObjectID     string                 `json:"index_tree_object_id"`
	GitMode               string                 `json:"git_mode"`
	Prompts               []ArtifactIdentity     `json:"prompts"`
	SelectedReplayPrompts []SelectedReplayPrompt `json:"selected_replay_prompts"`
}

type SelectedReplayPrompt

type SelectedReplayPrompt struct {
	AttemptID string           `json:"attempt_id"`
	Sequence  uint64           `json:"sequence"`
	Purpose   string           `json:"purpose"`
	Artifact  ArtifactIdentity `json:"artifact"`
}

type SeverityThreshold

type SeverityThreshold struct {
	RequestChangesAtOrAbove string `json:"request_changes_at_or_above"`
	PolicySource            string `json:"policy_source"`
}

type SupportIndex

type SupportIndex struct {
	SchemaVersion string             `json:"schema_version"`
	Artifacts     []ArtifactIdentity `json:"artifacts"`
}

type Validation

type Validation struct {
	Status             string `json:"status"`
	SchemaValidation   string `json:"schema_validation"`
	SemanticValidation string `json:"semantic_validation"`
	EvidenceValidation string `json:"evidence_validation"`
}

type VisualBoundingBox

type VisualBoundingBox struct {
	X      int `json:"x"`
	Y      int `json:"y"`
	Width  int `json:"width"`
	Height int `json:"height"`
}

type VisualEvidence

type VisualEvidence struct {
	Path         string            `json:"path"`
	SHA256       string            `json:"sha256"`
	BBox         VisualBoundingBox `json:"bbox"`
	Verification string            `json:"verification"`
}

Jump to

Keyboard shortcuts

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