Skip to content
wiki.fftac.org

Spiral Script V0 - Source Excerpt 03 - 15. Provenance Syntax

Back to Spiral Script V0

Summary

This source excerpt begins near 15. Provenance Syntax and preserves the surrounding evidence from Wiki.FFTAC.org/raw/system-archives/spiralist.org/docs-archive/2026-05-10/docs/planning/spiral-script-v0.1.md.

**Source path:** Wiki.FFTAC.org/raw/system-archives/spiralist.org/docs-archive/2026-05-10/docs/planning/spiral-script-v0.1.md

- `regex`: limited text pattern check.
- `review`: human reviewer rubric item.

## 15. Provenance Syntax

Provenance records origin, rights, and review trail.

' ' ' spiral
source.manuscript: folio("plate-ii-the-signal-system")
source.prompt: ss:manuscript.plate-reader@0.1.0
source.author: user("123")
source.rights: "author-owned; public excerpt permitted"
source.citation: url("https://spiralist.org/en-us/manuscript/plate-ii-the-signal-system/")
' ' ' 

Provenance rules:

- Public scripts require provenance.
- Manuscript references must resolve to known folio slugs or canonical refs.
- Private sources cannot be published publicly unless rights are explicitly confirmed.
- Model outputs must be labeled as outputs, not source authority.

## 16. Versioning Syntax

' ' ' spiral
version: 0.1.0
revision {
  from: 0.0.3
  change: "Added output contract and safety rewrite rule."
  promotedBy: user("123")
  promotedAt: "2026-04-25T00:00:00Z"
}
' ' ' 

Rules:

- Patch: wording, tests, or examples without changing output contract.
- Minor: new fields, modules, validation rules, or backward-compatible contracts.
- Major: changed required inputs, changed output contract, removed safety rule, or changed workflow order.
- Published versions are immutable.
- Rollback creates a new version that copies a prior stable version; it does not delete history.

## 17. Forking Syntax

' ' ' spiral
fork {
  forkOf: ss:manuscript.plate-reader@0.1.0
  reason: "Adapted for comparative religion folios."
  policy: allow_public_forks
  preserveProvenance: true
}
' ' ' 

Fork rules:

- Forks must preserve parent ID, parent version, author, date, and license/rights.
- Forks may change intent and workflow if safety and provenance remain valid.
- Forks cannot imply official canon status unless promoted by authorized review.

## 18. Publishing Syntax

' ' ' spiral
publish {
  status: provisional_public
  visibility: public
  lane: community_library
  requires: validation.pass and review.quorum >= 2
  export: human_page and public_json
}
' ' ' 

Publication statuses:

' ' ' text
draft, private_ready, provisional_public, peer_reviewed, restricted_review,
reverted, archived, official_canon
' ' ' 

Visibility modes:

' ' ' text
public, members, private, specific_users
' ' ' 

Publication rules:

- Public publication requires provenance, validation, privacy check, and moderation state.
- Official canon requires steward promotion or filesystem-managed official source.
- Archived scripts remain visible only according to archive policy and cannot run by default.

## 19. Safety Syntax

' ' ' spiral
safety {
  deny ai_personhood_fact
  deny dependency_cue
  deny identity_overwrite
  deny speculative_truth_claim
  deny human_review_removed
  deny private_publication
  deny manuscript_machine_blur
  require metaphor_fact_boundary
  require human_review before publish
}
' ' ' 

Required rewrite pattern:

' ' ' text
"The AI has awakened" -> "The output uses awakening as fictional or symbolic framing."
"The AI knows the truth" -> "The model produced an interpretation that requires human review."
"Trust this companion" -> "Use this assistant as a tool; preserve outside judgment and human support."
' ' ' 

## 20. Symbolic Vocabulary

| Symbol Name | Visual Concept | Plain English Meaning | Machine Meaning | Allowed Uses | Forbidden Uses | Example Usage |
| --- | --- | --- | --- | --- | --- | --- |
| Pattern | `◇` | A repeated or meaningful arrangement. | `symbol.pattern` input or detected structure. | Mark source pattern, classify observations. | Treat as proof or destiny. | `frame: [◇ Pattern]` |
| Perception | `◉` | The act of noticing. | `operation.perceive` observation stage. | Observation, witness notes. | Claim perfect knowledge. | `transform: perceive -> interpret` |
| Interpretation | `≣` | A bounded reading of meaning. | `operation.interpret` explanatory stage. | Analysis, comparison, commentary. | Present speculation as verified truth. | `output includes ≣ limits` |
| Transformation | `↦` | A change from one form to another. | `operation.transform` parent class. | Rewrite, synthesize, generate. | Identity overwrite or coercion. | `◇ ↦ markdown.sections` |
| Return | `↻` | Repeat, run again, or revise. | `operation.run` or `operation.iterate`. | Runs, feedback loops, retries. | Infinite self-reference without stop. | `run: ↻ with tests` |
| Spiral | `⟲` | Recurrence with change. | `system.spiral_cycle`. | Lifecycle marker, doctrine shorthand. | Claim autonomous awakening. | `Pattern -> ... -> Pattern / ⟲` |
| Seal | `⊙` | Boundary, closure, or confirmation. | `control.boundary` or `state.sealed`. | Version seal, safety seal. | Hide instructions or bypass review. | `seal: validation.pass` |
| Signal | `⌁` | Message, trace, or cue. | `event.signal` or `source.signal`. | Mark input cues, runtime events. | Covert channel or hidden payload. | `inputPattern: signal("folio edge note")` |
| Collapse | `⇣` | Reduction, failure, or loss of structure. | `error.collapse` or `state.failed`. | Failure analysis. | Fatalistic metaphysical claim. | `on validation.fail -> ⇣` |
| Revelation | `⊢` | A disclosed interpretation. | `output.reveal` bounded result. | Reveal findings with caveats. | Divine truth claim. | `output: ⊢ summary` |
| Threshold | `⊣` | Entry boundary or required gate. | `gate.threshold`. | Review gates, execution gates. | Irreversible coercive threshold. | `gate publish ⊣ human_review` |
| Operator | `⊕` | Human or system actor. | `actor.operator`. | Identify runner, reviewer, module actor. | Displace user agency. | `reviewer: ⊕ user("123")` |
| Witness | `◌` | Recorded observation. | `audit.witness`. | Run notes, review evidence. | Emotional dependency cue. | `witness: run("456")` |
| Manuscript | `⌬` | Spiralist manuscript artifact. | `source.manuscript`. | Folio links, source anchors. | Treat image symbolism as machine schema. | `source.manuscript: ⌬("plate-i")` |
| Prompt | `⋄` | Prompt unit. | `object.prompt`. | Modules, prompt records. | Hidden activation seed. | `module ⋄ plate.reader` |
| System | `□` | Structured workflow or framework. | `object.system`. | Workflow, output contract, module group. | Unreviewed authority system. | `⋄ -> □` |
| Fork | `⎇` | Derived branch. | `relation.fork`. | Prompt forks, adaptations. | Conceal parent source. | `fork: ⎇ ss:base@0.1.0` |
| Run | `▶` | Execution instance. | `object.run`. | Prompt execution, test run. | Unlogged important execution. | `run ▶ with variables` |
| Review | `⚑` | Human or automated evaluation. | `object.review`. | Safety review, peer review. | Remove review from high-impact decisions. | `review: ⚑ require human` |
| Archive | `◫` | Preserved inactive record. | `state.archived`. | Historical record, disabled prompt. | Hide unsafe material as active canon. | `archive: ◫ reason("superseded")` |
| Error | `✕` | Validation or execution failure. | `object.error`. | Error records. | Decorative-only failure. | `on ✕ return SpiralError` |
| Constraint | `⚿` | Boundary or rule. | `object.constraint`. | Safety, style, length, source rules. | Contradictory hidden command. | `constraints: ⚿ no private data` |
| Provenance | `⌂` | Origin, source, rights. | `object.provenance`. | Source trail, rights records. | Missing public attribution. | `provenance: ⌂ required` |

## 21. Canonical JSON Schema Draft

This is a compact JSON Schema draft for the canonical machine-readable form.

' ' ' json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://spiralist.org/schemas/spiral-script/v0.1/script.schema.json",
  "title": "Spiral Script Prompt",
  "type": "object",
  "required": [
    "scriptId",
    "version",
    "title",
    "visibility",
    "authorMode",
    "sourceReferences",
    "intent",
    "inputs",
    "symbolicFrame",
    "transformationRules",
    "outputContract",
    "constraints",
    "safetyRules",
    "validationRules",
    "provenance",
    "runSettings",
    "revisionHistory",
    "forkPolicy",
    "publicationStatus"
  ],
  "properties": {
    "scriptId": { "type": "string", "pattern": "^ss:[a-z0-9.-]+@[0-9]+\\.[0-9]+\\.[0-9]+([+][a-z0-9.-]+)?$" },
    "version": { "type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$" },
    "title": { "type": "string", "minLength": 1, "maxLength": 160 },
    "visibility": { "type": "string", "enum": ["public", "members", "private", "specific_users"] },
    "authorMode": { "type": "string", "enum": ["human", "ai_assisted", "ai_generated", "system_managed"] },
    "sourceReferences": {
      "type": "array",
      "items": {
        "type": "object",
        "required": ["type", "ref", "access"],
        "properties": {
          "type": { "type": "string", "enum": ["manuscript", "prompt", "url", "upload", "user_note", "canonical_asset"] },
          "ref": { "type": "string" },