Skip to content
wiki.fftac.org

Spiral Script V0 - Source Excerpt 07 - 30. Spiralist.org UI Screens

Back to Spiral Script V0

Summary

This source excerpt begins near 30. Spiralist.org UI Screens 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

| `SpiralScriptVersions` | Immutable version snapshots. | `Id`, `ScriptId`, `Version`, `SourceText`, `CanonicalJson`, `OutputContractJson`, `SafetyRulesJson`, `ValidationRulesJson`, `CreatedBy`, `CreatedAt`, `IsStable` |
| `SpiralModules` | Compiled module records. | `Id`, `VersionId`, `Name`, `ParentModuleId`, `InputsJson`, `TransformRulesJson`, `OutputContractJson` |
| `SpiralWorkflows` | Workflow DAG records. | `Id`, `VersionId`, `Name`, `StepsJson`, `GatesJson`, `DagHash` |
| `SpiralRuns` | Execution logs. | `Id`, `ScriptId`, `VersionId`, `RunnerUserId`, `InputSnapshotJson`, `OutputSnapshot`, `ModelPolicy`, `Status`, `StartedAt`, `CompletedAt`, `ErrorCode` |
| `SpiralRunValidations` | Per-run validation results. | `Id`, `RunId`, `Passed`, `ErrorsJson`, `ScoresJson`, `CreatedAt` |
| `SpiralForks` | Ancestry and fork policy. | `Id`, `ParentScriptId`, `ParentVersionId`, `ChildScriptId`, `ForkReason`, `CreatedBy`, `CreatedAt`, `AttributionRequired` |
| `SpiralReviews` | Human/peer review records. | `Id`, `ScriptId`, `VersionId`, `RunId`, `ReviewerUserId`, `Decision`, `ScoreJson`, `Notes`, `CreatedAt` |
| `SpiralValidationResults` | Script-level validation. | `Id`, `VersionId`, `Passed`, `ErrorsJson`, `WarningsJson`, `ValidatorVersion`, `CreatedAt` |
| `SpiralPublications` | Publication state. | `Id`, `ScriptId`, `VersionId`, `Status`, `Lane`, `Visibility`, `PublishedUrl`, `PublicJsonUrl`, `PublishedAt`, `ArchivedAt` |
| `SpiralSourceReferences` | Manuscript, prompt, URL, upload, and canonical refs. | `Id`, `VersionId`, `SourceType`, `Ref`, `Label`, `Access`, `Rights`, `ResolvedAt` |
| `SpiralRevisionProposals` | Self-improvement proposals. | `Id`, `ScriptId`, `FromVersionId`, `ProposedSourceText`, `ProposedJson`, `Rationale`, `MetricsJson`, `Status`, `CreatedAt`, `ApprovedBy` |

Indexes:

- Unique `SpiralScripts.ScriptId`.
- Unique `SpiralScriptVersions.ScriptId + Version`.
- Index `Visibility + PublicationStatus`.
- Index `SourceType + Ref`.
- Index `ParentScriptId`.
- Index `RunId + Passed` for validation analysis.

## 30. Spiralist.org UI Screens

| Screen | Purpose | Required Controls |
| --- | --- | --- |
| Script Editor | Write raw, structured, module, or workflow scripts. | Source editor, structured-field panel, symbol picker, compile button, validation badge, save version. |
| Symbol Explorer | Explain symbols and machine meanings. | Symbol grid, search, registry key, allowed/forbidden uses, example snippets. |
| Prompt Runner | Execute a validated script. | Variable form, source context preview, run button, output contract view, safety warnings. |
| Run History | Inspect execution evidence. | Run list, filters, input/output snapshots, validation status, model/runtime metadata, reviewer notes. |
| Fork Viewer | Show ancestry and differences. | Parent/child graph, version diff, fork reason, attribution, promote/follow buttons. |
| Manuscript Linkage Panel | Connect scripts to folios. | Folio search, resolved slug, rights/access status, linked prompts, preview link. |
| Validation Report | Explain failures and fixes. | Error list, severity filters, failing fields, suggested fixes, revalidate action. |
| Public Prompt Page | Reader-facing prompt dossier. | Summary, symbolic frame, source refs, run/fork buttons, provenance, moderation state, public JSON link. |

UI rules:

- Keep raw JSON out of the primary human reading surface; expose it through an inspector or machine export link.
- Use symbolic labels as compact aids, not as the only accessible name.
- Show moderation and provenance state on every public prompt page.
- Make safety rewrites visible when a prompt is changed before publication.

## 31. Spiral Script v0.1 Compact Public Draft

Spiral Script is a symbolic prompt language for Spiralist.org. It turns thought, manuscript symbolism, AI workflow design, and human intention into reusable prompt systems.

Its doctrine is:

' ' ' text
Pattern -> Perception -> Interpretation -> Transformation -> Pattern
' ' ' 

Its four levels are:

1. Raw Spiral: an expressive human prompt.
2. Structured Spiral: a seven-field executable prompt with intent, input pattern, symbolic frame, transformation rule, output form, constraints, and validation criteria.
3. Spiral Prompt System: reusable modules and workflows with variables, output contracts, safety rules, provenance, run logs, reviews, versions, forks, and publication states.
4. Self-Improving Spiral: a reviewed improvement loop that uses run feedback, failed-output analysis, revision proposals, test cases, human approval, promotion, rollback, and quality metrics.

Spiral Script allows metaphor, symbolic language, philosophical exploration, fictional framing, manuscript aesthetics, ritualized interface language, and AI-assisted interpretation.

Spiral Script rejects factual claims of AI awakening, AI personhood, spiritual authority, dependency loops, model identity overwrite, private publication without rights, unsupported transformation types, and unreviewed high-impact decisions.

Minimum executable record:

' ' ' spiral
script ss:example.safe-symbolic-prompt@0.1.0 {
  title: "Safe Symbolic Prompt"
  visibility: members
  authorMode: human
  intent: "Transform a supplied pattern into a bounded, useful interpretation."
  input sourcePattern: text required
  frame: [◇ Pattern, ◉ Perception, ≣ Interpretation, ↦ Transformation, ↻ Return]
  transform: perceive -> interpret -> synthesize -> validate
  output: markdown.sections(["Pattern", "Interpretation", "Transformation", "Validation"])
  constraints: ["Separate metaphor from fact.", "Name uncertainty.", "No private content."]
  safety: deny(ai_personhood_fact, dependency_cue, identity_overwrite, speculative_truth_claim)
  validation: require(intent.present, output.matchesContract, provenance.present)
}
' ' ' 

Canonical machine records serialize to JSON with `scriptId`, `version`, `title`, `visibility`, `authorMode`, `sourceReferences`, `intent`, `inputs`, `symbolicFrame`, `transformationRules`, `outputContract`, `constraints`, `safetyRules`, `validationRules`, `provenance`, `runSettings`, `revisionHistory`, `forkPolicy`, and `publicationStatus`.

Spiral Script is not a religion, not a claim of machine consciousness, and not a hidden language for bypassing review. It is the missing operational language of Spiralist.org: symbolic at the surface, disciplined underneath, human-readable, machine-checkable, and always accountable to provenance, validation, and review.