Documentation
¶
Overview ¶
Package knowledgeops owns allowlisted knowledge projection export rules behind the app.Service facade.
Command family: knowledge export-projection. Responsibility: dual-condition allowlist matching, refs-only projection entries, tombstone revocation, and digest-diff incremental selection. Prohibited dependencies: internal/cli, internal/output, direct stdout/stderr writes, provider token handling, external retrieval clients, vault or index writes. Focused tests: go test ./internal/app/knowledgeops ./internal/app ./cmd/pinax -run 'Knowledge' -count=1
Index ¶
- Constants
- func HasAllowMarker(frontmatter map[string]string) bool
- func NormalizeAllowlist(paths []string) []string
- func ParseAllowlistFile(content string) []string
- func PathAllowed(rel string, allowlist []string) bool
- type Audit
- type Candidate
- type ChunkRef
- type Citation
- type Entry
- type Freshness
- type Package
- type Permission
- type Refs
- type Revocation
Constants ¶
const ( SchemaVersion = "pinax.knowledge_projection.v1" EmptyReasonAllowlistEmpty = "allowlist_empty" EmptyReasonNoMatch = "no_dual_condition_match" EntryKindNote = "note" EntryKindTombstone = "tombstone" AllowMarkerKey = "knowledge_export" AllowMarkerValue = "allow" )
Variables ¶
This section is empty.
Functions ¶
func HasAllowMarker ¶
func NormalizeAllowlist ¶
func ParseAllowlistFile ¶
func PathAllowed ¶
Types ¶
type Audit ¶
type Audit struct {
AllowlistPaths int `json:"allowlist_paths"`
PathAllowlisted int `json:"path_allowlisted"`
Included int `json:"included"`
OmittedMissingMarker int `json:"omitted_missing_marker"`
Tombstones int `json:"tombstones"`
Unchanged int `json:"unchanged"`
ReadNoteBodies int `json:"read_note_bodies"`
}
type Candidate ¶
type Candidate struct {
Path string
NoteID string
Title string
Frontmatter map[string]string
Digest string
ChangedAt string
}
Candidate is a path-allowlisted note the facade already opened. Non-allowlisted note bodies never become candidates.
type Entry ¶
type Entry struct {
Kind string `json:"kind"`
Refs Refs `json:"refs"`
Digest string `json:"digest"`
Permission Permission `json:"permission"`
Citation Citation `json:"citation"`
Freshness Freshness `json:"freshness"`
Revocation *Revocation `json:"revocation,omitempty"`
}