Documentation
¶
Overview ¶
Package artifactwire owns primitive persisted representations shared by writers and readers. Its values carry no validation or storage authority.
Index ¶
- Constants
- func AttemptPath(attempt, member string) string
- func CandidateName(kind string, ordinal int) string
- func CanonicalExcerptName(name string) bool
- func CanonicalInvocationDirectory(value string) bool
- func CapturedBlobPath(digest string) string
- func CompositeFindingPath(finding string) string
- func CompositeSourcePrefix(role string) string
- func CorruptionDiagnosticPath(session, run string, epoch uint64) string
- func DecimalDigits(value string, minimumWidth int) bool
- func DecimalIdentifier(value string, minimumWidth int) bool
- func EpochPath(epoch uint64) string
- func EvidenceExcerptName(finding string, position int) string
- func FinalName(review string) string
- func FinalPath(session, run, review string) string
- func FindingName(finding string) string
- func InvocationPath(sequence uint64, purpose, stream string) string
- func LineageEdgePath(review string) string
- func PreparedCompositePath(session, run, name string) string
- func PromptBase(sequence uint64, purpose string) string
- func PromptPath(attempt string, sequence uint64, purpose, suffix string) string
- func RecoveryBlobPath(digest string) string
- func RoleReportPath(role string) string
- func RunPath(session, run, relative string) string
- func StagedFinalPath(session, run, review string) string
- type ArtifactIdentity
- type BuildMetadata
- type CompositeComposition
- type CompositeFinding
- type CompositeFindingSource
- type CompositeManifestRole
- type CompositeRole
- type CompositeSource
- type CorruptionDiagnostic
- type FinalReviewIdentity
- type ImmutableLineage
- type LineageChild
- type LineageEdge
- type LiveProductionProvenance
- type ManifestAttempt
- type ManifestFailure
- type ManifestRoleReport
- type PathPointer
- type ProductionProvenance
- type ProductionProvider
- type PublicationEpoch
- type PublicationJournal
- type PublicationStatus
- type RestartState
- type RoleOutcome
- type RuntimePromptManifest
- type RuntimeTargetManifest
- type SelectedReplayPrompt
- type SeverityThreshold
- type SupportIndex
- type Validation
- type VisualBoundingBox
- type VisualEvidence
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 CandidateName ¶
func CanonicalExcerptName ¶
func CapturedBlobPath ¶
func CompositeFindingPath ¶
func CompositeSourcePrefix ¶
func DecimalDigits ¶
func DecimalIdentifier ¶
func EvidenceExcerptName ¶
func FindingName ¶
func InvocationPath ¶
func LineageEdgePath ¶
func PreparedCompositePath ¶
func PromptBase ¶
func RecoveryBlobPath ¶
func RoleReportPath ¶
func StagedFinalPath ¶
Types ¶
type ArtifactIdentity ¶
type BuildMetadata ¶
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 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 FinalReviewIdentity ¶
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 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 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 SupportIndex ¶
type SupportIndex struct {
SchemaVersion string `json:"schema_version"`
Artifacts []ArtifactIdentity `json:"artifacts"`
}
type Validation ¶
type VisualBoundingBox ¶
type VisualEvidence ¶
type VisualEvidence struct {
Path string `json:"path"`
SHA256 string `json:"sha256"`
BBox VisualBoundingBox `json:"bbox"`
Verification string `json:"verification"`
}
Click to show internal directories.
Click to hide internal directories.