PrismDevRelOpen the app
Examples: Docs sync

Overview

Example apps

Decision tables

Rule 30 cellStrike dieWise deferralCurrent supportHeader workPlant attunementCapability routePublish gateProposal admissionCompression admissionQuorum commitAddress admissionDataflow policyDraft admissionCoded matmul admissionUTQC row honestyCalculator protocolRequantization clampJCS NFC admissionTwo-seed barDocs sync

Policy decisions

Open policyNamespace authorizationAxiom policyGNAF claim wordingEmporous admissionPortal publication

State machines

MCP task lifecycleContainer lifecycleAtlas walk controlsVault escrow lifecycleRelease lifecycleOrganization lifecycle

// example · Decision tables

Docs sync

Decide what the nightly docs sync does to uor.foundation. The site must never swap its docs for an empty or unchecked release.

Inspired by UOR-Foundation/website (live). The UOR Foundation website, which syncs the Prism SDK docs from PrismPM every six hours and redeploys only when they change.

Pattern: Decision table, OMG DMN 1.5, hit policy FIRST. To write one of your own, follow How to build a decision table app.

What the Docs sync app does1. Request: branch, seed, pages, package, changed 2. 6 rules: the first that matches wins 3. Answer: keep, refuse, unchanged, redeploy 4. Proved: 4 theorems, 49 tests01Requestbranch, seed,pages, package,changed026 rulesthe first thatmatches wins03Answerkeep, refuse,unchanged,redeploy04Proved4 theorems, 49testsWhat the Docs sync app does1. Request: branch, seed, pages, package, changed 2. 6 rules: the first that matches wins 3. Answer: keep, refuse, unchanged, redeploy 4. Proved: 4 theorems, 49 tests01Requestbranch, seed, pages, package,changed026 rulesthe first that matches wins03Answerkeep, refuse, unchanged, redeploy04Proved4 theorems, 49 tests
What the Docs sync app does. A request goes in, the rules decide, and the Lean kernel has already proved what the rules promise.
The data in this figure
StepWhat happens
1. Requestbranch, seed, pages, package, changed
2. 6 rulesthe first that matches wins
3. Answerkeep, refuse, unchanged, redeploy
4. Proved4 theorems, 49 tests
Fingerprint
88d57bb4ebf97249d923d9a1b50679710d4f3c66acad8985468048931ec68170
Acceptance vectors
49
Claims
7

Verified by prismpm verify in the pinned SDK when this site was built.

The prompt

This is the whole input. Raw JSON · Open it in the builder · Download the app (.zip)

The prompt 372 lines
{
  "schema": "prism/prompt/1",
  "pattern": "decisionTable",
  "goal": "Decide what the nightly docs sync does to uor.foundation. The site must never swap its docs for an empty or unchecked release.",
  "repository": "UOR-Foundation/website",
  "license": "NOASSERTION",
  "app": {
    "name": "site-docs-sync",
    "title": "Docs sync",
    "purpose": "Decide whether one run of the Prism docs sync keeps the current docs, refuses to overwrite them, finds nothing changed, or commits and redeploys the site, from the docs-site branch, the seed flag, the pages found, the prism-code package check and whether the generated files changed.",
    "fields": [
      {
        "name": "branch",
        "kind": "choice",
        "values": [
          "present",
          "absent"
        ],
        "means": "whether the docs-site branch of UOR-Foundation/PrismPM exists"
      },
      {
        "name": "seed",
        "kind": "choice",
        "values": [
          "no",
          "yes"
        ],
        "means": "whether the run passes --seed, the one-time import from main's docs/generated"
      },
      {
        "name": "pages",
        "kind": "number",
        "min": 0,
        "max": 10000,
        "means": "Markdown pages found under get-started, guides, api, reference, sdks, concepts, examples or migration"
      },
      {
        "name": "package",
        "kind": "choice",
        "values": [
          "verified",
          "no-release",
          "mismatch",
          "no-skill"
        ],
        "means": "the prism-code npm latest check: verified, no latest release, tarball not matching its registry integrity, or no skill/SKILL.md in it"
      },
      {
        "name": "changed",
        "kind": "choice",
        "values": [
          "yes",
          "no"
        ],
        "means": "whether the generated prism, npm and requests files differ from main"
      }
    ],
    "outcomes": [
      "keep",
      "refuse",
      "unchanged",
      "redeploy"
    ],
    "meanings": {
      "keep": "exit 0 keeping the current docs",
      "refuse": "the sync throws and the current docs are not overwritten",
      "unchanged": "No changes, nothing committed",
      "redeploy": "commit the generated files and run deploy.yml on main"
    },
    "rules": [
      {
        "when": [
          {
            "field": "branch",
            "op": "is",
            "value": "absent"
          },
          {
            "field": "seed",
            "op": "is",
            "value": "no"
          }
        ],
        "then": "keep",
        "why": "scripts/sync-prism-docs.mjs: docs-site branch not found; keeping current docs"
      },
      {
        "when": [
          {
            "field": "pages",
            "op": "=",
            "value": 0
          }
        ],
        "then": "refuse",
        "why": "scripts/sync-prism-docs.mjs: No pages found; refusing to overwrite the current docs"
      },
      {
        "when": [
          {
            "field": "package",
            "op": "is",
            "value": "no-release"
          }
        ],
        "then": "refuse",
        "why": "scripts/sync-prism-docs.mjs: npm registry gave no prism-code latest release; refusing to overwrite the current docs"
      },
      {
        "when": [
          {
            "field": "package",
            "op": "is",
            "value": "mismatch"
          }
        ],
        "then": "refuse",
        "why": "scripts/sync-prism-docs.mjs: the prism-code tarball does not match its registry integrity"
      },
      {
        "when": [
          {
            "field": "package",
            "op": "is",
            "value": "no-skill"
          }
        ],
        "then": "refuse",
        "why": "scripts/sync-prism-docs.mjs: the site publishes the package's skill/SKILL.md byte for byte, and refuses a release without one"
      },
      {
        "when": [
          {
            "field": "changed",
            "op": "is",
            "value": "no"
          }
        ],
        "then": "unchanged",
        "why": ".github/workflows/sync-prism-docs.yml: git diff --quiet on the generated files, then No changes"
      }
    ],
    "otherwise": "redeploy",
    "otherwiseWhy": ".github/workflows/sync-prism-docs.yml: commit the generated files, push, and gh workflow run deploy.yml --ref main",
    "properties": [
      {
        "kind": "never",
        "when": [
          {
            "field": "pages",
            "op": "=",
            "value": 0
          }
        ],
        "then": "redeploy",
        "why": "an empty docs tree never replaces the published docs"
      },
      {
        "kind": "never",
        "when": [
          {
            "field": "package",
            "op": "is",
            "value": "mismatch"
          }
        ],
        "then": "redeploy",
        "why": "a tarball that fails its integrity never sets the versions or skill the site states"
      },
      {
        "kind": "never",
        "when": [
          {
            "field": "changed",
            "op": "is",
            "value": "no"
          }
        ],
        "then": "redeploy",
        "why": "the site is redeployed only when the docs changed"
      },
      {
        "kind": "always",
        "when": [
          {
            "field": "branch",
            "op": "is",
            "value": "absent"
          },
          {
            "field": "seed",
            "op": "is",
            "value": "no"
          }
        ],
        "then": "keep",
        "why": "without the branch, and without --seed, the docs are kept"
      }
    ],
    "examples": [
      {
        "request": "present no 42 verified yes",
        "response": "redeploy"
      },
      {
        "request": "present no 42 verified no",
        "response": "unchanged"
      },
      {
        "request": "absent no 0 no-release yes",
        "response": "keep"
      },
      {
        "request": "absent yes 12 verified yes",
        "response": "redeploy"
      },
      {
        "request": "present no 0 verified yes",
        "response": "refuse"
      },
      {
        "request": "present no 42 mismatch yes",
        "response": "refuse"
      },
      {
        "request": "present no 42 no-skill yes",
        "response": "refuse"
      }
    ]
  },
  "stakeholders": [
    {
      "name": "Site visitor",
      "text": "Reads the Prism SDK docs and their Markdown twins on uor.foundation and needs them to be the current docs-site release, never an empty or unverified one.",
      "concerns": [
        "Correct answers",
        "Integrity of the published app"
      ]
    },
    {
      "name": "Site maintainer",
      "text": "Owns the scheduled sync and needs it to redeploy only on a real change and to fail loudly instead of overwriting.",
      "concerns": [
        "Proved guarantees",
        "Refused malformed requests"
      ]
    }
  ],
  "components": [
    {
      "name": "PrismPM docs-site branch",
      "text": "The branch of UOR-Foundation/PrismPM the docs are pulled from.",
      "kind": "externalSystem"
    },
    {
      "name": "npm registry",
      "text": "Serves prism-code latest, its tarball and its integrity.",
      "kind": "externalSystem"
    },
    {
      "name": "uor.foundation",
      "text": "The React, Vite and Tailwind site deploy.yml publishes to GitHub Pages.",
      "kind": "staticSite"
    }
  ],
  "threats": [
    {
      "name": "Docs wiped by an empty tree",
      "text": "A reorganized or empty docs-site branch overwrites every docs page with nothing.",
      "stride": "denialOfService",
      "asset": "answer",
      "likelihood": "medium",
      "impact": "major",
      "control": {
        "name": "No pages, no overwrite",
        "text": "Zero pages is refused.",
        "evidence": [
          {
            "kind": "proof",
            "reference": "SiteDocsSyncProofs::inv001Holds"
          },
          {
            "kind": "review",
            "reference": "UOR-Foundation/website scripts/sync-prism-docs.mjs"
          }
        ]
      }
    },
    {
      "name": "Tampered prism-code tarball",
      "text": "A tarball that differs from its registry integrity sets the published versions and agent skill.",
      "stride": "tampering",
      "asset": "source",
      "likelihood": "low",
      "impact": "critical",
      "control": {
        "name": "Registry integrity",
        "text": "An integrity mismatch is refused.",
        "evidence": [
          {
            "kind": "proof",
            "reference": "SiteDocsSyncProofs::inv002Holds"
          },
          {
            "kind": "gate",
            "reference": "UOR-Foundation/website scripts/sync-prism-docs.mjs integrity check"
          }
        ]
      }
    },
    {
      "name": "Compromised docs-site branch",
      "text": "Someone with push access to the PrismPM docs-site branch publishes misleading docs.",
      "stride": "spoofing",
      "asset": "source",
      "likelihood": "low",
      "impact": "major",
      "accepted": "The site trusts the PrismPM repository as the docs authority; the generated files are committed, so every change is reviewable in history."
    }
  ],
  "quality": [
    {
      "characteristic": "Reliability",
      "subcharacteristic": "Fault tolerance",
      "requirement": "Every failed check refuses",
      "text": "Each of the four refusals the sync script throws is a rule answering refuse.",
      "measure": "Refusal checks",
      "measureText": "Refusal checks of the sync script the app models.",
      "threshold": 4
    },
    {
      "characteristic": "Performance efficiency",
      "subcharacteristic": "Resource utilization",
      "requirement": "No needless redeploy",
      "text": "A run that changes no generated file does not redeploy.",
      "measure": "Needless redeploys",
      "measureText": "Acceptance vectors with no change answered redeploy.",
      "threshold": 0
    }
  ],
  "journeys": [
    {
      "stakeholder": "Site visitor",
      "steps": [
        "otherwise",
        "REQ-002",
        "INV-001",
        "INV-002"
      ]
    },
    {
      "stakeholder": "Site maintainer",
      "steps": [
        "REQ-001",
        "REQ-003",
        "REQ-004",
        "REQ-005",
        "REQ-006",
        "INV-003",
        "refuse"
      ]
    }
  ],
  "axioms": {
    "inv004Holds": [
      "Classical.choice",
      "Quot.sound",
      "propext"
    ]
  },
  "concerns": []
}

What the app claims

Each claim is a row in model/ids.toml, a scenario and a test, and a theorem the Lean kernel checks. The claims are quoted as the model states them.

Pattern

Decision table: OMG DMN 1.5, hit policy FIRST. The rules are tried in order, and the first one that matches gives the answer. If none matches, the default answer applies. This is a DMN decision table with the FIRST hit policy.

PatternStandardAnswers
Decision tableOMG DMN 1.5, hit policy FIRSTkeep, refuse, unchanged, redeploy
Rules for each answerkeep: 1 rules; refuse: 4 rules; unchanged: 1 rules; redeploy: 0 ruleskeep1refuse4unchanged1redeploy0 + default
Rules for each answer. Each bar counts the rules that give one answer. When no rule matches, the answer is redeploy.
The data in this figure
rules
keep1
refuse4
unchanged1
redeploy0

Behavior

A request is branch, seed, pages, package, changed, separated by spaces. The first rule that matches decides. If none matches, the answer is redeploy. A request over 136 bytes, or in any other form, is answered invalid.

RuleWhenAnswerWhy
REQ-001branch is absent and seed is nokeepscripts/sync-prism-docs.mjs: docs-site branch not found; keeping current docs
REQ-002pages equals 0refusescripts/sync-prism-docs.mjs: No pages found; refusing to overwrite the current docs
REQ-003package is no-releaserefusescripts/sync-prism-docs.mjs: npm registry gave no prism-code latest release; refusing to overwrite the current docs
REQ-004package is mismatchrefusescripts/sync-prism-docs.mjs: the prism-code tarball does not match its registry integrity
REQ-005package is no-skillrefusescripts/sync-prism-docs.mjs: the site publishes the package's skill/SKILL.md byte for byte, and refuses a release without one
REQ-006changed is nounchanged.github/workflows/sync-prism-docs.yml: git diff --quiet on the generated files, then No changes
otherwiseno rule matchesredeploy.github/workflows/sync-prism-docs.yml: commit the generated files, push, and gh workflow run deploy.yml --ref main

Properties Lean proves

Each property is a theorem about the same definitions the app is built from. It is proved for every request, not only the tested ones.

PropertyStatementTheoremWhy
INV-001It never answers redeploy when pages equals 0.SiteDocsSyncProofs::inv001Holdsan empty docs tree never replaces the published docs
INV-002It never answers redeploy when package is mismatch.SiteDocsSyncProofs::inv002Holdsa tarball that fails its integrity never sets the versions or skill the site states
INV-003It never answers redeploy when changed is no.SiteDocsSyncProofs::inv003Holdsthe site is redeployed only when the docs changed
INV-004It always answers keep when branch is absent and seed is no.SiteDocsSyncProofs::inv004Holdswithout the branch, and without --seed, the docs are kept

Architecture

Stakeholders and the concerns each one views the app through (ISO/IEC/IEEE 42010).

StakeholderWho they areConcerns
Site maintainerOwns the scheduled sync and needs it to redeploy only on a real change and to fail loudly instead of overwriting.Proved guarantees, Refused malformed requests
Site visitorReads the Prism SDK docs and their Markdown twins on uor.foundation and needs them to be the current docs-site release, never an empty or unverified one.Correct answers, Integrity of the published app
VerifierAnyone who loads the holo, checks its fingerprint and replays its acceptance vectors before trusting an answer.Integrity of the published app, Refused malformed requests, Proved guarantees

Concerns

What the stakeholders care about, and the model each is viewed in.

ConcernWhat it meansModel
Correct answersEvery well-formed request is answered by the first rule that matches it, or redeploy when none does, as the spec states.quality
Integrity of the published appWhat a visitor runs is the holo the build verified, with its fingerprint and signed provenance beside it.security
Proved guaranteesEach of the 4 properties of the spec holds for every request, proved by the Lean kernel.quality
Refused malformed requestsA request that is not the 5 fields in order, or is longer than 136 bytes, is answered invalid and never guessed.security

Components

9 components and 13 edges between them.

ComponentKindWhat it is
BrowserexternalSystemThe visitor's web browser, which loads the page and runs the Docs sync guest.
Docs sync guestserviceThe Core-Wasm guest built from the model: it answers one request of at most 136 bytes with one answer of at most 64.
Docs sync pagestaticSiteThe page the template publishes: the holo, its fingerprint, its provenance and its acceptance vectors.
GitHub PagesexternalSystemServes the page and the holo from the repository Pages workflow.
npm registryexternalSystemServes prism-code latest, its tarball and its integrity.
Prism buildcliAdapterprismpm verify in the SDK image prismpm.lock pins: it checks every theorem, builds the guest and replays every vector.
PrismPM docs-site branchexternalSystemThe branch of UOR-Foundation/PrismPM the docs are pulled from.
Source repositoryexternalSystemThe repository that holds the prompt, the model and its gate.
uor.foundationstaticSiteThe React, Vite and Tailwind site deploy.yml publishes to GitHub Pages.

Design views

The SDK checks each view against the system model and draws it as OPL and PlantUML.

ViewDiagramViewpoint
Deciding a Docs sync requestopmObjectProcessSite visitor: Correct answers
Components of Docs syncumlComponentSite visitor: Integrity of the published app
Answering a Docs sync requestumlSequenceSite visitor: Correct answers
States of the Docs sync guestumlStateMachineSite maintainer: Refused malformed requests

Features and journeys

12 features. Each names the definitions that do the work and the tests that accept it. Each stakeholder has one journey.

Features and journeys 12 rows
FeatureCallsAccepted by
When branch is absent and seed is no, the answer is keep.SiteDocsSync::rule1, SiteDocsSync::judgeSiteDocsSync::application
When pages equals 0, the answer is refuse.SiteDocsSync::rule2, SiteDocsSync::judgeSiteDocsSync::application
When package is no-release, the answer is refuse.SiteDocsSync::rule3, SiteDocsSync::judgeSiteDocsSync::application
When package is mismatch, the answer is refuse.SiteDocsSync::rule4, SiteDocsSync::judgeSiteDocsSync::application
When package is no-skill, the answer is refuse.SiteDocsSync::rule5, SiteDocsSync::judgeSiteDocsSync::application
When changed is no, the answer is unchanged.SiteDocsSync::rule6, SiteDocsSync::judgeSiteDocsSync::application
When no rule matches, the answer is redeploy.SiteDocsSync::judgeSiteDocsSync::application
A request that is not branch, seed, pages, package, changed in order, separated by single spaces, or is over 136 bytes, is answered invalid.SiteDocsSync::dispatch, SiteDocsSync::decodeField1SiteDocsSync::application
It never answers redeploy when pages equals 0.SiteDocsSync::judgeSiteDocsSyncProofs::inv001Holds
It never answers redeploy when package is mismatch.SiteDocsSync::judgeSiteDocsSyncProofs::inv002Holds
It never answers redeploy when changed is no.SiteDocsSync::judgeSiteDocsSyncProofs::inv003Holds
It always answers keep when branch is absent and seed is no.SiteDocsSync::judgeSiteDocsSyncProofs::inv004Holds

Journeys

The ordered features each stakeholder takes.

StakeholderSteps
Site maintainerREQ-001 → REQ-003 → REQ-004 → REQ-005 → REQ-006 → INV-003 → refuse
Site visitorotherwise → REQ-002 → INV-001 → INV-002
Verifierrefuse → INV-001 → INV-002 → INV-003 → INV-004

Security and threat model

13 threats against 4 assets. Each has a STRIDE category, and either a control with evidence or a risk that is accepted on purpose.

Security and threat model 13 rows
ThreatSTRIDEAssetRiskAnswered by
Answer that breaks INV-001repudiationAnswermedium likelihood, critical impactProof of INV-001: proof SiteDocsSyncProofs::inv001Holds
Answer that breaks INV-002repudiationAnswermedium likelihood, critical impactProof of INV-002: proof SiteDocsSyncProofs::inv002Holds
Answer that breaks INV-003repudiationAnswermedium likelihood, critical impactProof of INV-003: proof SiteDocsSyncProofs::inv003Holds
Answer that breaks INV-004repudiationAnswermedium likelihood, critical impactProof of INV-004: proof SiteDocsSyncProofs::inv004Holds
Compromised docs-site branchspoofingModel sourcelow likelihood, major impactaccepted: The site trusts the PrismPM repository as the docs authority; the generated files are committed, so every change is reviewable in history.
Docs wiped by an empty treedenialOfServiceAnswermedium likelihood, major impactNo pages, no overwrite: proof SiteDocsSyncProofs::inv001Holds; review UOR-Foundation/website scripts/sync-prism-docs.mjs
Granted capabilityinformationDisclosureAnswerlow likelihood, major impactNo capability granted: gate prism-code check refuses an ungranted guest import
Malformed requesttamperingRequest byteshigh likelihood, major impactStrict decoder: gate malformed-request acceptance vectors, replayed in the compiled guest by prismpm verify
Oversized requestdenialOfServiceRequest bytesmedium likelihood, minor impactBounded request: gate acceptance vectors at the request bound, one byte over it, and at the guest allocation bound, replayed by prismpm verify
Substituted holospoofingPublished hololow likelihood, critical impactFingerprint and provenance: gate actions/attest-build-provenance in the pages workflow; gate prism-code check of the holo identities in the page
Substituted hostspoofingPublished hololow likelihood, critical impactaccepted: A page cannot defend against its own host. The holo carries signed build provenance a visitor can check, and the app can be rebuilt from its prompt.
Tampered modeltamperingModel sourcelow likelihood, major impactRegenerated from the prompt: gate prismpm verify in the SDK image prismpm.lock pins; review app/prompt.json
Tampered prism-code tarballtamperingModel sourcelow likelihood, critical impactRegistry integrity: proof SiteDocsSyncProofs::inv002Holds; gate UOR-Foundation/website scripts/sync-prism-docs.mjs integrity check

Quality

ISO/IEC 25010:2023 requirements. Each has a measure and a threshold that a theorem pins.

Quality 8 rows
RequirementCharacteristicMeasureThreshold
Bounded allocation: The guest allocates at most 272 bytes for one request.Performance efficiency: Resource utilizationGuest allocation bytes272
Bounded request: A request over 136 bytes is refused before any field is read.Performance efficiency: Time behaviourRequest bytes read136
Every failed check refuses: Each of the four refusals the sync script throws is a rule answering refuse.Reliability: Fault toleranceRefusal checks4
Every property proved: All 4 properties are theorems the Lean kernel checks.Security: IntegrityUnproved properties0
Every request answered: Every request gets an answer: a rule, redeploy otherwise, or invalid.Functional suitability: Functional completenessUnanswered requests0
Every vector replays: All 49 acceptance vectors replay in the compiled guest, the shortest 0 bytes long.Reliability: FaultlessnessFailed vectors0
Examples answered as stated: Every one of the 7 examples of the spec is answered as it states.Functional suitability: Functional correctnessExample mismatches0
No needless redeploy: A run that changes no generated file does not redeploy.Performance efficiency: Resource utilizationNeedless redeploys0

Compliance

One obligation per standard, each naming its evidence.

StandardSubjectEvidence
ISO/IEC/IEEE 42010:2022Architecture descriptionArchitecture::architectureDescriptionHolds
ISO/PAS 19450:2015 and OMG UML 2.5.1Design viewsDesign::viewOpmDecide, Design::viewUmlComponents, Design::viewUmlRequest, Design::viewUmlStates
ISO/IEC 25010:2023Product qualityQuality::qualityModelHolds
ISO/IEC 27034-1:2011 and ISO/IEC 27005:2022Application security and riskSecurity::controlSet
OMG DMN 1.5, hit policy FIRSTDecision tableSiteDocsSync::judge
OpenSpecRequirementsSiteDocsSync::application
SPDX NOASSERTIONLicensingSiteDocsSync::application

Rendered design views

Written by the SDK from the design records when it verified the app.

design/Design.viewOpmDecide.opl
View: Design::viewOpmDecide
Title: Deciding a Docs sync request
Viewpoint: Architecture::viewpointSiteVisitorCorrectAnswers
Notation: ISO/PAS 19450:2015 OPM, Prism OPL profile

componentBrowser is an object.
componentDocsSyncGuest is an object.
componentDocsSyncGuest can be stateDeciding or stateIdle.
processDecide is a process.
processEncodeAnswer is a process.
processJudge is a process.
processParseRequest is a process.
componentDocsSyncGuest handles processDecide.
processParseRequest requires componentBrowser.
processEncodeAnswer affects componentBrowser.
processJudge invokes processEncodeAnswer.
processParseRequest invokes processJudge.
processDecide zooms into processParseRequest, processJudge, and processEncodeAnswer, in that sequence.
design/Design.viewUmlComponents.puml
@startuml
' UML 2.5.1 component diagram
' view: Design::viewUmlComponents
' viewpoint: Architecture::viewpointSiteVisitorIntegrityOfThePublishedApp
title Components of Docs sync
component "componentBrowser" as c0
component "componentDocsSyncGuest" as c1
component "componentDocsSyncPage" as c2
component "componentGitHubPages" as c3
component "componentNpmRegistry" as c4
component "componentPrismBuild" as c5
component "componentPrismPMDocsSiteBranch" as c6
component "componentSourceRepository" as c7
component "componentUorFoundation" as c8
c0 --> c1 : edgeBrowserToDocsSyncGuest
c1 --> c0 : edgeDocsSyncGuestToBrowser
c1 --> c4 : edgeDocsSyncGuestToNpmRegistry
c1 --> c6 : edgeDocsSyncGuestToPrismPMDocsSiteBranch
c1 --> c8 : edgeDocsSyncGuestToUorFoundation
c2 --> c3 : edgeDocsSyncPageToGitHubPages
c3 --> c0 : edgeGitHubPagesToBrowser
c4 --> c1 : edgeNpmRegistryToDocsSyncGuest
c5 --> c1 : edgePrismBuildToDocsSyncGuest
c5 --> c2 : edgePrismBuildToDocsSyncPage
c6 --> c1 : edgePrismPMDocsSiteBranchToDocsSyncGuest
c7 --> c5 : edgeSourceRepositoryToPrismBuild
c8 --> c1 : edgeUorFoundationToDocsSyncGuest
@enduml
design/Design.viewUmlRequest.puml
@startuml
' UML 2.5.1 sequence diagram
' view: Design::viewUmlRequest
' viewpoint: Architecture::viewpointSiteVisitorCorrectAnswers
title Answering a Docs sync request
participant "componentBrowser" as p0
participant "componentDocsSyncGuest" as p1
p0 -> p1 : processDecide
p1 --> p0 : processDecide
@enduml
design/Design.viewUmlStates.puml
@startuml
' UML 2.5.1 state machine diagram
' view: Design::viewUmlStates
' viewpoint: Architecture::viewpointSiteMaintainerRefusedMalformedRequests
title States of the Docs sync guest
state "stateAnsweredKeep" as s0
state "stateAnsweredRedeploy" as s1
state "stateAnsweredRefuse" as s2
state "stateAnsweredUnchanged" as s3
state "stateDeciding" as s4
state "stateIdle" as s5
state "stateRefused" as s6
[*] --> s5
s5 --> s4 : processParseRequest
s5 --> s6 : processParseRequest
s4 --> s0 : processRule1
s4 --> s2 : processRule2
s4 --> s2 : processRule3
s4 --> s2 : processRule4
s4 --> s2 : processRule5
s4 --> s3 : processRule6
s4 --> s1 : processOtherwise
s0 --> s5 : processEncodeAnswer
s2 --> s5 : processEncodeAnswer
s3 --> s5 : processEncodeAnswer
s1 --> s5 : processEncodeAnswer
s6 --> s5 : processEncodeAnswer
@enduml

Prism source

Every file the builder wrote, laid out as a repository created from UOR-Foundation/template. The language packages and Foundation modules every app shares are in the download.

app/src/Architecture.lex.tex 427 lines
\begin{lexlean}{Architecture}
\useglossary{lexlean.std.bool@1.2.0}
\useglossary{lexlean.std.nat@1.2.0}
\useglossary{prism.arch@1.0.0}
\importmodule{Foundation.Arch}
\title{architectural component}
\begin{semanticmodule}
definition{
  name: standardIso25010,
  parameters: [],
  result: Foundation.Arch::StandardReference,
  body: (record Foundation.Arch::StandardReference {standardIndex := 0, editionIndex := 0, standardId := "ISO-25010-2023", edition := "2023"})
}

definition{
  name: standardIso27005,
  parameters: [],
  result: Foundation.Arch::StandardReference,
  body: (record Foundation.Arch::StandardReference {standardIndex := 1, editionIndex := 0, standardId := "ISO-27005-2022", edition := "2022"})
}

definition{
  name: standardIso27034,
  parameters: [],
  result: Foundation.Arch::StandardReference,
  body: (record Foundation.Arch::StandardReference {standardIndex := 2, editionIndex := 0, standardId := "ISO-27034-1-2011", edition := "2011"})
}

definition{
  name: standardIso42010,
  parameters: [],
  result: Foundation.Arch::StandardReference,
  body: (record Foundation.Arch::StandardReference {standardIndex := 4, editionIndex := 0, standardId := "ISO-42010-2022", edition := "2022"})
}

definition{
  name: stakeholderSiteMaintainer,
  parameters: [],
  result: Foundation.Arch::Stakeholder,
  body: (record Foundation.Arch::Stakeholder {index := 0, name := "Site maintainer", text := "Owns the scheduled sync and needs it to redeploy only on a real change and to fail loudly instead of overwriting."})
}

definition{
  name: stakeholderSiteVisitor,
  parameters: [],
  result: Foundation.Arch::Stakeholder,
  body: (record Foundation.Arch::Stakeholder {index := 1, name := "Site visitor", text := "Reads the Prism SDK docs and their Markdown twins on uor.foundation and needs them to be the current docs-site release, never an empty or unverified one."})
}

definition{
  name: stakeholderVerifier,
  parameters: [],
  result: Foundation.Arch::Stakeholder,
  body: (record Foundation.Arch::Stakeholder {index := 2, name := "Verifier", text := "Anyone who loads the holo, checks its fingerprint and replays its acceptance vectors before trusting an answer."})
}

definition{
  name: concernCorrectAnswers,
  parameters: [],
  result: Foundation.Arch::Concern,
  body: (record Foundation.Arch::Concern {index := 0, name := "Correct answers", text := "Every well-formed request is answered by the first rule that matches it, or redeploy when none does, as the spec states."})
}

definition{
  name: concernIntegrityOfThePublishedApp,
  parameters: [],
  result: Foundation.Arch::Concern,
  body: (record Foundation.Arch::Concern {index := 1, name := "Integrity of the published app", text := "What a visitor runs is the holo the build verified, with its fingerprint and signed provenance beside it."})
}

definition{
  name: concernProvedGuarantees,
  parameters: [],
  result: Foundation.Arch::Concern,
  body: (record Foundation.Arch::Concern {index := 2, name := "Proved guarantees", text := "Each of the 4 properties of the spec holds for every request, proved by the Lean kernel."})
}

definition{
  name: concernRefusedMalformedRequests,
  parameters: [],
  result: Foundation.Arch::Concern,
  body: (record Foundation.Arch::Concern {index := 3, name := "Refused malformed requests", text := "A request that is not the 5 fields in order, or is longer than 136 bytes, is answered invalid and never guessed."})
}

definition{
  name: componentBrowser,
  parameters: [],
  result: Foundation.Arch::Component,
  body: (record Foundation.Arch::Component {index := 0, kind := (ctor Foundation.Arch::ComponentKind.externalSystem), name := "Browser", text := "The visitor's web browser, which loads the page and runs the Docs sync guest."})
}

definition{
  name: componentDocsSyncGuest,
  parameters: [],
  result: Foundation.Arch::Component,
  body: (record Foundation.Arch::Component {index := 1, kind := (ctor Foundation.Arch::ComponentKind.service), name := "Docs sync guest", text := "The Core-Wasm guest built from the model: it answers one request of at most 136 bytes with one answer of at most 64."})
}

definition{
  name: componentDocsSyncPage,
  parameters: [],
  result: Foundation.Arch::Component,
  body: (record Foundation.Arch::Component {index := 2, kind := (ctor Foundation.Arch::ComponentKind.staticSite), name := "Docs sync page", text := "The page the template publishes: the holo, its fingerprint, its provenance and its acceptance vectors."})
}

definition{
  name: componentGitHubPages,
  parameters: [],
  result: Foundation.Arch::Component,
  body: (record Foundation.Arch::Component {index := 3, kind := (ctor Foundation.Arch::ComponentKind.externalSystem), name := "GitHub Pages", text := "Serves the page and the holo from the repository Pages workflow."})
}

definition{
  name: componentNpmRegistry,
  parameters: [],
  result: Foundation.Arch::Component,
  body: (record Foundation.Arch::Component {index := 4, kind := (ctor Foundation.Arch::ComponentKind.externalSystem), name := "npm registry", text := "Serves prism-code latest, its tarball and its integrity."})
}

definition{
  name: componentPrismBuild,
  parameters: [],
  result: Foundation.Arch::Component,
  body: (record Foundation.Arch::Component {index := 5, kind := (ctor Foundation.Arch::ComponentKind.cliAdapter), name := "Prism build", text := "prismpm verify in the SDK image prismpm.lock pins: it checks every theorem, builds the guest and replays every vector."})
}

definition{
  name: componentPrismPMDocsSiteBranch,
  parameters: [],
  result: Foundation.Arch::Component,
  body: (record Foundation.Arch::Component {index := 6, kind := (ctor Foundation.Arch::ComponentKind.externalSystem), name := "PrismPM docs-site branch", text := "The branch of UOR-Foundation/PrismPM the docs are pulled from."})
}

definition{
  name: componentSourceRepository,
  parameters: [],
  result: Foundation.Arch::Component,
  body: (record Foundation.Arch::Component {index := 7, kind := (ctor Foundation.Arch::ComponentKind.externalSystem), name := "Source repository", text := "The repository that holds the prompt, the model and its gate."})
}

definition{
  name: componentUorFoundation,
  parameters: [],
  result: Foundation.Arch::Component,
  body: (record Foundation.Arch::Component {index := 8, kind := (ctor Foundation.Arch::ComponentKind.staticSite), name := "uor.foundation", text := "The React, Vite and Tailwind site deploy.yml publishes to GitHub Pages."})
}

definition{
  name: edgeBrowserToDocsSyncGuest,
  parameters: [],
  result: Foundation.Arch::Edge,
  body: (record Foundation.Arch::Edge {index := 0, fromIndex := 0, toIndex := 1, kind := (ctor Foundation.Arch::EdgeKind.dataFlow)})
}

definition{
  name: edgeDocsSyncGuestToBrowser,
  parameters: [],
  result: Foundation.Arch::Edge,
  body: (record Foundation.Arch::Edge {index := 1, fromIndex := 1, toIndex := 0, kind := (ctor Foundation.Arch::EdgeKind.dataFlow)})
}

definition{
  name: edgeDocsSyncGuestToNpmRegistry,
  parameters: [],
  result: Foundation.Arch::Edge,
  body: (record Foundation.Arch::Edge {index := 2, fromIndex := 1, toIndex := 4, kind := (ctor Foundation.Arch::EdgeKind.dataFlow)})
}

definition{
  name: edgeDocsSyncGuestToPrismPMDocsSiteBranch,
  parameters: [],
  result: Foundation.Arch::Edge,
  body: (record Foundation.Arch::Edge {index := 3, fromIndex := 1, toIndex := 6, kind := (ctor Foundation.Arch::EdgeKind.dataFlow)})
}

definition{
  name: edgeDocsSyncGuestToUorFoundation,
  parameters: [],
  result: Foundation.Arch::Edge,
  body: (record Foundation.Arch::Edge {index := 4, fromIndex := 1, toIndex := 8, kind := (ctor Foundation.Arch::EdgeKind.dataFlow)})
}

definition{
  name: edgeDocsSyncPageToGitHubPages,
  parameters: [],
  result: Foundation.Arch::Edge,
  body: (record Foundation.Arch::Edge {index := 5, fromIndex := 2, toIndex := 3, kind := (ctor Foundation.Arch::EdgeKind.dataFlow)})
}

definition{
  name: edgeGitHubPagesToBrowser,
  parameters: [],
  result: Foundation.Arch::Edge,
  body: (record Foundation.Arch::Edge {index := 6, fromIndex := 3, toIndex := 0, kind := (ctor Foundation.Arch::EdgeKind.dataFlow)})
}

definition{
  name: edgeNpmRegistryToDocsSyncGuest,
  parameters: [],
  result: Foundation.Arch::Edge,
  body: (record Foundation.Arch::Edge {index := 7, fromIndex := 4, toIndex := 1, kind := (ctor Foundation.Arch::EdgeKind.dataFlow)})
}

definition{
  name: edgePrismBuildToDocsSyncGuest,
  parameters: [],
  result: Foundation.Arch::Edge,
  body: (record Foundation.Arch::Edge {index := 8, fromIndex := 5, toIndex := 1, kind := (ctor Foundation.Arch::EdgeKind.dataFlow)})
}

definition{
  name: edgePrismBuildToDocsSyncPage,
  parameters: [],
  result: Foundation.Arch::Edge,
  body: (record Foundation.Arch::Edge {index := 9, fromIndex := 5, toIndex := 2, kind := (ctor Foundation.Arch::EdgeKind.dataFlow)})
}

definition{
  name: edgePrismPMDocsSiteBranchToDocsSyncGuest,
  parameters: [],
  result: Foundation.Arch::Edge,
  body: (record Foundation.Arch::Edge {index := 10, fromIndex := 6, toIndex := 1, kind := (ctor Foundation.Arch::EdgeKind.dataFlow)})
}

definition{
  name: edgeSourceRepositoryToPrismBuild,
  parameters: [],
  result: Foundation.Arch::Edge,
  body: (record Foundation.Arch::Edge {index := 11, fromIndex := 7, toIndex := 5, kind := (ctor Foundation.Arch::EdgeKind.dataFlow)})
}

definition{
  name: edgeUorFoundationToDocsSyncGuest,
  parameters: [],
  result: Foundation.Arch::Edge,
  body: (record Foundation.Arch::Edge {index := 12, fromIndex := 8, toIndex := 1, kind := (ctor Foundation.Arch::EdgeKind.dataFlow)})
}

definition{
  name: viewpointSiteMaintainerProvedGuarantees,
  parameters: [],
  result: Foundation.Arch::Viewpoint,
  body: (record Foundation.Arch::Viewpoint {index := 0, stakeholderIndex := 0, concernIndex := 2, modelKindIndex := 1})
}

definition{
  name: viewpointSiteMaintainerRefusedMalformedRequests,
  parameters: [],
  result: Foundation.Arch::Viewpoint,
  body: (record Foundation.Arch::Viewpoint {index := 1, stakeholderIndex := 0, concernIndex := 3, modelKindIndex := 2})
}

definition{
  name: viewpointSiteVisitorCorrectAnswers,
  parameters: [],
  result: Foundation.Arch::Viewpoint,
  body: (record Foundation.Arch::Viewpoint {index := 2, stakeholderIndex := 1, concernIndex := 0, modelKindIndex := 1})
}

definition{
  name: viewpointSiteVisitorIntegrityOfThePublishedApp,
  parameters: [],
  result: Foundation.Arch::Viewpoint,
  body: (record Foundation.Arch::Viewpoint {index := 3, stakeholderIndex := 1, concernIndex := 1, modelKindIndex := 2})
}

definition{
  name: viewpointVerifierIntegrityOfThePublishedApp,
  parameters: [],
  result: Foundation.Arch::Viewpoint,
  body: (record Foundation.Arch::Viewpoint {index := 4, stakeholderIndex := 2, concernIndex := 1, modelKindIndex := 2})
}

definition{
  name: viewpointVerifierProvedGuarantees,
  parameters: [],
  result: Foundation.Arch::Viewpoint,
  body: (record Foundation.Arch::Viewpoint {index := 5, stakeholderIndex := 2, concernIndex := 2, modelKindIndex := 1})
}

definition{
  name: viewpointVerifierRefusedMalformedRequests,
  parameters: [],
  result: Foundation.Arch::Viewpoint,
  body: (record Foundation.Arch::Viewpoint {index := 6, stakeholderIndex := 2, concernIndex := 3, modelKindIndex := 2})
}

definition{
  name: viewSiteMaintainerProvedGuarantees,
  parameters: [],
  result: Foundation.Arch::View,
  body: (record Foundation.Arch::View {index := 0, viewpointIndex := 0, modelKindIndex := 1})
}

definition{
  name: viewSiteMaintainerRefusedMalformedRequests,
  parameters: [],
  result: Foundation.Arch::View,
  body: (record Foundation.Arch::View {index := 1, viewpointIndex := 1, modelKindIndex := 2})
}

definition{
  name: viewSiteVisitorCorrectAnswers,
  parameters: [],
  result: Foundation.Arch::View,
  body: (record Foundation.Arch::View {index := 2, viewpointIndex := 2, modelKindIndex := 1})
}

definition{
  name: viewSiteVisitorIntegrityOfThePublishedApp,
  parameters: [],
  result: Foundation.Arch::View,
  body: (record Foundation.Arch::View {index := 3, viewpointIndex := 3, modelKindIndex := 2})
}

definition{
  name: viewVerifierIntegrityOfThePublishedApp,
  parameters: [],
  result: Foundation.Arch::View,
  body: (record Foundation.Arch::View {index := 4, viewpointIndex := 4, modelKindIndex := 2})
}

definition{
  name: viewVerifierProvedGuarantees,
  parameters: [],
  result: Foundation.Arch::View,
  body: (record Foundation.Arch::View {index := 5, viewpointIndex := 5, modelKindIndex := 1})
}

definition{
  name: viewVerifierRefusedMalformedRequests,
  parameters: [],
  result: Foundation.Arch::View,
  body: (record Foundation.Arch::View {index := 6, viewpointIndex := 6, modelKindIndex := 2})
}

definition{
  name: componentRecords,
  parameters: [],
  result: (List Foundation.Arch::Component),
  body: (cons (componentBrowser) (cons (componentDocsSyncGuest) (cons (componentDocsSyncPage) (cons (componentGitHubPages) (cons (componentNpmRegistry) (cons (componentPrismBuild) (cons (componentPrismPMDocsSiteBranch) (cons (componentSourceRepository) (cons (componentUorFoundation) (nil Foundation.Arch::Component))))))))))
}

definition{
  name: edgeRecords,
  parameters: [],
  result: (List Foundation.Arch::Edge),
  body: (cons (edgeBrowserToDocsSyncGuest) (cons (edgeDocsSyncGuestToBrowser) (cons (edgeDocsSyncGuestToNpmRegistry) (cons (edgeDocsSyncGuestToPrismPMDocsSiteBranch) (cons (edgeDocsSyncGuestToUorFoundation) (cons (edgeDocsSyncPageToGitHubPages) (cons (edgeGitHubPagesToBrowser) (cons (edgeNpmRegistryToDocsSyncGuest) (cons (edgePrismBuildToDocsSyncGuest) (cons (edgePrismBuildToDocsSyncPage) (cons (edgePrismPMDocsSiteBranchToDocsSyncGuest) (cons (edgeSourceRepositoryToPrismBuild) (cons (edgeUorFoundationToDocsSyncGuest) (nil Foundation.Arch::Edge))))))))))))))
}

definition{
  name: viewpointRecords,
  parameters: [],
  result: (List Foundation.Arch::Viewpoint),
  body: (cons (viewpointSiteMaintainerProvedGuarantees) (cons (viewpointSiteMaintainerRefusedMalformedRequests) (cons (viewpointSiteVisitorCorrectAnswers) (cons (viewpointSiteVisitorIntegrityOfThePublishedApp) (cons (viewpointVerifierIntegrityOfThePublishedApp) (cons (viewpointVerifierProvedGuarantees) (cons (viewpointVerifierRefusedMalformedRequests) (nil Foundation.Arch::Viewpoint))))))))
}

definition{
  name: viewRecords,
  parameters: [],
  result: (List Foundation.Arch::View),
  body: (cons (viewSiteMaintainerProvedGuarantees) (cons (viewSiteMaintainerRefusedMalformedRequests) (cons (viewSiteVisitorCorrectAnswers) (cons (viewSiteVisitorIntegrityOfThePublishedApp) (cons (viewVerifierIntegrityOfThePublishedApp) (cons (viewVerifierProvedGuarantees) (cons (viewVerifierRefusedMalformedRequests) (nil Foundation.Arch::View))))))))
}

definition{
  name: edgesKnown,
  parameters: [count : Nat, records : (List Foundation.Arch::Edge)],
  result: Bool,
  body: (match records
    | List.nil => true
    | List.cons edge rest => (((project edge fromIndex) <? count) && (((project edge toIndex) <? count) && (edgesKnown count rest)))),
  recursive_argument: records
}

definition{
  name: viewpointsKnown,
  parameters: [
    stakeholderCount : Nat,
    concernCount : Nat,
    records : (List Foundation.Arch::Viewpoint)
  ],
  result: Bool,
  body: (match records
    | List.nil => true
    | List.cons viewpoint rest => (((project viewpoint stakeholderIndex) <? stakeholderCount) && (((project viewpoint concernIndex) <? concernCount) && (((project viewpoint modelKindIndex) <? 3) && (viewpointsKnown stakeholderCount concernCount rest))))),
  recursive_argument: records
}

definition{
  name: viewMatches,
  parameters: [view : Foundation.Arch::View, viewpoints : (List Foundation.Arch::Viewpoint)],
  result: Bool,
  body: (match viewpoints
    | List.nil => false
    | List.cons viewpoint rest => ((((project viewpoint index) =? (project view viewpointIndex)) && ((project viewpoint modelKindIndex) =? (project view modelKindIndex))) || (viewMatches view rest))),
  recursive_argument: viewpoints
}

definition{
  name: viewsConform,
  parameters: [
    viewpoints : (List Foundation.Arch::Viewpoint),
    records : (List Foundation.Arch::View)
  ],
  result: Bool,
  body: (match records
    | List.nil => true
    | List.cons view rest => ((viewMatches view viewpoints) && (viewsConform viewpoints rest))),
  recursive_argument: records
}

definition{
  name: architectureValid,
  parameters: [],
  result: Bool,
  body: ((edgesKnown 9 (edgeRecords)) && ((viewpointsKnown 3 4 (viewpointRecords)) && (viewsConform (viewpointRecords) (viewRecords))))
}

theorem{
  name: architectureDescriptionHolds,
  parameters: [],
  statement: ((architectureValid) = true),
  proof: decide{}
}
\end{semanticmodule}
\end{lexlean}
app/src/Compliance.lex.tex 56 lines
\begin{lexlean}{Compliance}
\useglossary{lexlean.std.bool@1.2.0}
\useglossary{lexlean.std.nat@1.2.0}
\useglossary{prism.arch@1.0.0}
\importmodule{Architecture}
\importmodule{Design}
\importmodule{Quality}
\importmodule{Security}
\importmodule{SiteDocsSync}
\title{standards reference}
\begin{semanticmodule}
structure{
  name: Obligation,
  type_parameters: [],
  parameters: [],
  fields: [
    {name: index, type: Nat},
    {name: standard, type: String},
    {name: subject, type: String},
    {name: text, type: String},
    {name: evidence, type: (List String)}
  ]
}

definition{
  name: obligations,
  parameters: [],
  result: (List Obligation),
  body: (cons (record Obligation {index := 0, standard := "ISO/IEC/IEEE 42010:2022", subject := "Architecture description", text := "Stakeholders, concerns, viewpoints and views are declared and their references resolve.", evidence := (cons "Architecture::architectureDescriptionHolds" (nil String))}) (cons (record Obligation {index := 1, standard := "ISO/PAS 19450:2015 and OMG UML 2.5.1", subject := "Design views", text := "Every design view is checked by the SDK against the system model before it is rendered.", evidence := (cons "Design::viewOpmDecide" (cons "Design::viewUmlComponents" (cons "Design::viewUmlRequest" (cons "Design::viewUmlStates" (nil String)))))}) (cons (record Obligation {index := 2, standard := "ISO/IEC 25010:2023", subject := "Product quality", text := "Characteristics, subcharacteristics, requirements and measures are numbered and their parents resolve.", evidence := (cons "Quality::qualityModelHolds" (nil String))}) (cons (record Obligation {index := 3, standard := "ISO/IEC 27034-1:2011 and ISO/IEC 27005:2022", subject := "Application security and risk", text := "Every threat has a STRIDE category and a mapped control with evidence, or an accepted risk with its rationale.", evidence := (cons "Security::controlSet" (nil String))}) (cons (record Obligation {index := 4, standard := "OMG DMN 1.5, hit policy FIRST", subject := "Decision table", text := "The 6 rules are tried in order and the first that matches gives the answer; otherwise redeploy.", evidence := (cons "SiteDocsSync::judge" (nil String))}) (cons (record Obligation {index := 5, standard := "OpenSpec", subject := "Requirements", text := "Every rule and property of the spec is a requirement with a scenario in openspec/specs.", evidence := (cons "SiteDocsSync::application" (nil String))}) (cons (record Obligation {index := 6, standard := "SPDX NOASSERTION", subject := "Licensing", text := "The application and its model are offered under NOASSERTION.", evidence := (cons "SiteDocsSync::application" (nil String))}) (nil Obligation))))))))
}

definition{
  name: obligationsEvidenced,
  parameters: [position : Nat, items : (List Obligation)],
  result: Bool,
  body: (match items
    | List.nil => true
    | List.cons item rest => (((project item index) =? position) && (match{
      branches: [
        {body: false, binders: [], constructor: List.nil},
        {body: true, binders: [first, others], constructor: List.cons}
      ],
      scrutinee: (project item evidence)
    } && (obligationsEvidenced (position + 1) rest)))),
  recursive_argument: items
}

theorem{
  name: everyObligationEvidenced,
  parameters: [],
  statement: ((obligationsEvidenced 0 (obligations)) = true),
  proof: decide{}
}
\end{semanticmodule}
\end{lexlean}
app/src/Design.lex.tex 619 lines
\begin{lexlean}{Design}
\useglossary{lexlean.std.bool@1.2.0}
\useglossary{lexlean.std.nat@1.2.0}
\useglossary{prism.arch@1.0.0}
\importmodule{Architecture}
\importmodule{Foundation.Arch}
\title{design view}
\begin{semanticmodule}
definition{
  name: processSendRequest,
  parameters: [],
  result: Foundation.Arch::SystemProcess,
  body: (record Foundation.Arch::SystemProcess {owner := "Architecture::componentBrowser"})
}

definition{
  name: processDecide,
  parameters: [],
  result: Foundation.Arch::SystemProcess,
  body: (record Foundation.Arch::SystemProcess {owner := "Architecture::componentDocsSyncGuest"})
}

definition{
  name: processParseRequest,
  parameters: [],
  result: Foundation.Arch::SystemProcess,
  body: (record Foundation.Arch::SystemProcess {owner := "Architecture::componentDocsSyncGuest"})
}

definition{
  name: processJudge,
  parameters: [],
  result: Foundation.Arch::SystemProcess,
  body: (record Foundation.Arch::SystemProcess {owner := "Architecture::componentDocsSyncGuest"})
}

definition{
  name: processEncodeAnswer,
  parameters: [],
  result: Foundation.Arch::SystemProcess,
  body: (record Foundation.Arch::SystemProcess {owner := "Architecture::componentDocsSyncGuest"})
}

definition{
  name: processBuildAndVerify,
  parameters: [],
  result: Foundation.Arch::SystemProcess,
  body: (record Foundation.Arch::SystemProcess {owner := "Architecture::componentPrismBuild"})
}

definition{
  name: processRule1,
  parameters: [],
  result: Foundation.Arch::SystemProcess,
  body: (record Foundation.Arch::SystemProcess {owner := "Architecture::componentDocsSyncGuest"})
}

definition{
  name: processRule2,
  parameters: [],
  result: Foundation.Arch::SystemProcess,
  body: (record Foundation.Arch::SystemProcess {owner := "Architecture::componentDocsSyncGuest"})
}

definition{
  name: processRule3,
  parameters: [],
  result: Foundation.Arch::SystemProcess,
  body: (record Foundation.Arch::SystemProcess {owner := "Architecture::componentDocsSyncGuest"})
}

definition{
  name: processRule4,
  parameters: [],
  result: Foundation.Arch::SystemProcess,
  body: (record Foundation.Arch::SystemProcess {owner := "Architecture::componentDocsSyncGuest"})
}

definition{
  name: processRule5,
  parameters: [],
  result: Foundation.Arch::SystemProcess,
  body: (record Foundation.Arch::SystemProcess {owner := "Architecture::componentDocsSyncGuest"})
}

definition{
  name: processRule6,
  parameters: [],
  result: Foundation.Arch::SystemProcess,
  body: (record Foundation.Arch::SystemProcess {owner := "Architecture::componentDocsSyncGuest"})
}

definition{
  name: processOtherwise,
  parameters: [],
  result: Foundation.Arch::SystemProcess,
  body: (record Foundation.Arch::SystemProcess {owner := "Architecture::componentDocsSyncGuest"})
}

definition{
  name: stateIdle,
  parameters: [],
  result: Foundation.Arch::SystemState,
  body: (record Foundation.Arch::SystemState {owner := "Architecture::componentDocsSyncGuest"})
}

definition{
  name: stateDeciding,
  parameters: [],
  result: Foundation.Arch::SystemState,
  body: (record Foundation.Arch::SystemState {owner := "Architecture::componentDocsSyncGuest"})
}

definition{
  name: stateRefused,
  parameters: [],
  result: Foundation.Arch::SystemState,
  body: (record Foundation.Arch::SystemState {owner := "Architecture::componentDocsSyncGuest"})
}

definition{
  name: stateAnsweredKeep,
  parameters: [],
  result: Foundation.Arch::SystemState,
  body: (record Foundation.Arch::SystemState {owner := "Architecture::componentDocsSyncGuest"})
}

definition{
  name: stateAnsweredRefuse,
  parameters: [],
  result: Foundation.Arch::SystemState,
  body: (record Foundation.Arch::SystemState {owner := "Architecture::componentDocsSyncGuest"})
}

definition{
  name: stateAnsweredUnchanged,
  parameters: [],
  result: Foundation.Arch::SystemState,
  body: (record Foundation.Arch::SystemState {owner := "Architecture::componentDocsSyncGuest"})
}

definition{
  name: stateAnsweredRedeploy,
  parameters: [],
  result: Foundation.Arch::SystemState,
  body: (record Foundation.Arch::SystemState {owner := "Architecture::componentDocsSyncGuest"})
}

definition{
  name: viewOpmDecide,
  parameters: [],
  result: Foundation.Arch::DesignView,
  body: (record Foundation.Arch::DesignView {title := "Deciding a Docs sync request", viewpoint := "Architecture::viewpointSiteVisitorCorrectAnswers", diagram := (ctor Foundation.Arch::DesignDiagram.opmObjectProcess)})
}

definition{
  name: viewUmlComponents,
  parameters: [],
  result: Foundation.Arch::DesignView,
  body: (record Foundation.Arch::DesignView {title := "Components of Docs sync", viewpoint := "Architecture::viewpointSiteVisitorIntegrityOfThePublishedApp", diagram := (ctor Foundation.Arch::DesignDiagram.umlComponent)})
}

definition{
  name: viewUmlRequest,
  parameters: [],
  result: Foundation.Arch::DesignView,
  body: (record Foundation.Arch::DesignView {title := "Answering a Docs sync request", viewpoint := "Architecture::viewpointSiteVisitorCorrectAnswers", diagram := (ctor Foundation.Arch::DesignDiagram.umlSequence)})
}

definition{
  name: viewUmlStates,
  parameters: [],
  result: Foundation.Arch::DesignView,
  body: (record Foundation.Arch::DesignView {title := "States of the Docs sync guest", viewpoint := "Architecture::viewpointSiteMaintainerRefusedMalformedRequests", diagram := (ctor Foundation.Arch::DesignDiagram.umlStateMachine)})
}

definition{
  name: opmBrowser,
  parameters: [],
  result: Foundation.Arch::OpmThing,
  body: (record Foundation.Arch::OpmThing {view := "Design::viewOpmDecide", kind := (ctor Foundation.Arch::OpmThingKind.object), subject := "Architecture::componentBrowser"})
}

definition{
  name: opmGuest,
  parameters: [],
  result: Foundation.Arch::OpmThing,
  body: (record Foundation.Arch::OpmThing {view := "Design::viewOpmDecide", kind := (ctor Foundation.Arch::OpmThingKind.object), subject := "Architecture::componentDocsSyncGuest"})
}

definition{
  name: opmDecide,
  parameters: [],
  result: Foundation.Arch::OpmThing,
  body: (record Foundation.Arch::OpmThing {view := "Design::viewOpmDecide", kind := (ctor Foundation.Arch::OpmThingKind.process), subject := "Design::processDecide"})
}

definition{
  name: opmParseRequest,
  parameters: [],
  result: Foundation.Arch::OpmThing,
  body: (record Foundation.Arch::OpmThing {view := "Design::viewOpmDecide", kind := (ctor Foundation.Arch::OpmThingKind.process), subject := "Design::processParseRequest"})
}

definition{
  name: opmJudge,
  parameters: [],
  result: Foundation.Arch::OpmThing,
  body: (record Foundation.Arch::OpmThing {view := "Design::viewOpmDecide", kind := (ctor Foundation.Arch::OpmThingKind.process), subject := "Design::processJudge"})
}

definition{
  name: opmEncodeAnswer,
  parameters: [],
  result: Foundation.Arch::OpmThing,
  body: (record Foundation.Arch::OpmThing {view := "Design::viewOpmDecide", kind := (ctor Foundation.Arch::OpmThingKind.process), subject := "Design::processEncodeAnswer"})
}

definition{
  name: opmGuestIdle,
  parameters: [],
  result: Foundation.Arch::OpmState,
  body: (record Foundation.Arch::OpmState {view := "Design::viewOpmDecide", thing := "Architecture::componentDocsSyncGuest", state := "Design::stateIdle"})
}

definition{
  name: opmGuestDeciding,
  parameters: [],
  result: Foundation.Arch::OpmState,
  body: (record Foundation.Arch::OpmState {view := "Design::viewOpmDecide", thing := "Architecture::componentDocsSyncGuest", state := "Design::stateDeciding"})
}

definition{
  name: opmGuestAgent,
  parameters: [],
  result: Foundation.Arch::OpmLink,
  body: (record Foundation.Arch::OpmLink {view := "Design::viewOpmDecide", kind := (ctor Foundation.Arch::OpmLinkKind.agent), source := "Architecture::componentDocsSyncGuest", target := "Design::processDecide"})
}

definition{
  name: opmBrowserInstrument,
  parameters: [],
  result: Foundation.Arch::OpmLink,
  body: (record Foundation.Arch::OpmLink {view := "Design::viewOpmDecide", kind := (ctor Foundation.Arch::OpmLinkKind.instrument), source := "Architecture::componentBrowser", target := "Design::processParseRequest"})
}

definition{
  name: opmParseInvokesJudge,
  parameters: [],
  result: Foundation.Arch::OpmLink,
  body: (record Foundation.Arch::OpmLink {view := "Design::viewOpmDecide", kind := (ctor Foundation.Arch::OpmLinkKind.invocation), source := "Design::processParseRequest", target := "Design::processJudge"})
}

definition{
  name: opmJudgeInvokesEncode,
  parameters: [],
  result: Foundation.Arch::OpmLink,
  body: (record Foundation.Arch::OpmLink {view := "Design::viewOpmDecide", kind := (ctor Foundation.Arch::OpmLinkKind.invocation), source := "Design::processJudge", target := "Design::processEncodeAnswer"})
}

definition{
  name: opmEncodeAffectsBrowser,
  parameters: [],
  result: Foundation.Arch::OpmLink,
  body: (record Foundation.Arch::OpmLink {view := "Design::viewOpmDecide", kind := (ctor Foundation.Arch::OpmLinkKind.effect), source := "Architecture::componentBrowser", target := "Design::processEncodeAnswer"})
}

definition{
  name: opmZoomParseRequest,
  parameters: [],
  result: Foundation.Arch::OpmZoom,
  body: (record Foundation.Arch::OpmZoom {view := "Design::viewOpmDecide", process := "Design::processDecide", subprocess := "Design::processParseRequest", order := 0})
}

definition{
  name: opmZoomJudge,
  parameters: [],
  result: Foundation.Arch::OpmZoom,
  body: (record Foundation.Arch::OpmZoom {view := "Design::viewOpmDecide", process := "Design::processDecide", subprocess := "Design::processJudge", order := 1})
}

definition{
  name: opmZoomEncodeAnswer,
  parameters: [],
  result: Foundation.Arch::OpmZoom,
  body: (record Foundation.Arch::OpmZoom {view := "Design::viewOpmDecide", process := "Design::processDecide", subprocess := "Design::processEncodeAnswer", order := 2})
}

definition{
  name: umlBrowser,
  parameters: [],
  result: Foundation.Arch::UmlComponent,
  body: (record Foundation.Arch::UmlComponent {view := "Design::viewUmlComponents", component := "Architecture::componentBrowser"})
}

definition{
  name: umlDocsSyncGuest,
  parameters: [],
  result: Foundation.Arch::UmlComponent,
  body: (record Foundation.Arch::UmlComponent {view := "Design::viewUmlComponents", component := "Architecture::componentDocsSyncGuest"})
}

definition{
  name: umlDocsSyncPage,
  parameters: [],
  result: Foundation.Arch::UmlComponent,
  body: (record Foundation.Arch::UmlComponent {view := "Design::viewUmlComponents", component := "Architecture::componentDocsSyncPage"})
}

definition{
  name: umlGitHubPages,
  parameters: [],
  result: Foundation.Arch::UmlComponent,
  body: (record Foundation.Arch::UmlComponent {view := "Design::viewUmlComponents", component := "Architecture::componentGitHubPages"})
}

definition{
  name: umlNpmRegistry,
  parameters: [],
  result: Foundation.Arch::UmlComponent,
  body: (record Foundation.Arch::UmlComponent {view := "Design::viewUmlComponents", component := "Architecture::componentNpmRegistry"})
}

definition{
  name: umlPrismBuild,
  parameters: [],
  result: Foundation.Arch::UmlComponent,
  body: (record Foundation.Arch::UmlComponent {view := "Design::viewUmlComponents", component := "Architecture::componentPrismBuild"})
}

definition{
  name: umlPrismPMDocsSiteBranch,
  parameters: [],
  result: Foundation.Arch::UmlComponent,
  body: (record Foundation.Arch::UmlComponent {view := "Design::viewUmlComponents", component := "Architecture::componentPrismPMDocsSiteBranch"})
}

definition{
  name: umlSourceRepository,
  parameters: [],
  result: Foundation.Arch::UmlComponent,
  body: (record Foundation.Arch::UmlComponent {view := "Design::viewUmlComponents", component := "Architecture::componentSourceRepository"})
}

definition{
  name: umlUorFoundation,
  parameters: [],
  result: Foundation.Arch::UmlComponent,
  body: (record Foundation.Arch::UmlComponent {view := "Design::viewUmlComponents", component := "Architecture::componentUorFoundation"})
}

definition{
  name: umlBrowserToDocsSyncGuest,
  parameters: [],
  result: Foundation.Arch::UmlConnector,
  body: (record Foundation.Arch::UmlConnector {view := "Design::viewUmlComponents", edge := "Architecture::edgeBrowserToDocsSyncGuest"})
}

definition{
  name: umlDocsSyncGuestToBrowser,
  parameters: [],
  result: Foundation.Arch::UmlConnector,
  body: (record Foundation.Arch::UmlConnector {view := "Design::viewUmlComponents", edge := "Architecture::edgeDocsSyncGuestToBrowser"})
}

definition{
  name: umlDocsSyncGuestToNpmRegistry,
  parameters: [],
  result: Foundation.Arch::UmlConnector,
  body: (record Foundation.Arch::UmlConnector {view := "Design::viewUmlComponents", edge := "Architecture::edgeDocsSyncGuestToNpmRegistry"})
}

definition{
  name: umlDocsSyncGuestToPrismPMDocsSiteBranch,
  parameters: [],
  result: Foundation.Arch::UmlConnector,
  body: (record Foundation.Arch::UmlConnector {view := "Design::viewUmlComponents", edge := "Architecture::edgeDocsSyncGuestToPrismPMDocsSiteBranch"})
}

definition{
  name: umlDocsSyncGuestToUorFoundation,
  parameters: [],
  result: Foundation.Arch::UmlConnector,
  body: (record Foundation.Arch::UmlConnector {view := "Design::viewUmlComponents", edge := "Architecture::edgeDocsSyncGuestToUorFoundation"})
}

definition{
  name: umlDocsSyncPageToGitHubPages,
  parameters: [],
  result: Foundation.Arch::UmlConnector,
  body: (record Foundation.Arch::UmlConnector {view := "Design::viewUmlComponents", edge := "Architecture::edgeDocsSyncPageToGitHubPages"})
}

definition{
  name: umlGitHubPagesToBrowser,
  parameters: [],
  result: Foundation.Arch::UmlConnector,
  body: (record Foundation.Arch::UmlConnector {view := "Design::viewUmlComponents", edge := "Architecture::edgeGitHubPagesToBrowser"})
}

definition{
  name: umlNpmRegistryToDocsSyncGuest,
  parameters: [],
  result: Foundation.Arch::UmlConnector,
  body: (record Foundation.Arch::UmlConnector {view := "Design::viewUmlComponents", edge := "Architecture::edgeNpmRegistryToDocsSyncGuest"})
}

definition{
  name: umlPrismBuildToDocsSyncGuest,
  parameters: [],
  result: Foundation.Arch::UmlConnector,
  body: (record Foundation.Arch::UmlConnector {view := "Design::viewUmlComponents", edge := "Architecture::edgePrismBuildToDocsSyncGuest"})
}

definition{
  name: umlPrismBuildToDocsSyncPage,
  parameters: [],
  result: Foundation.Arch::UmlConnector,
  body: (record Foundation.Arch::UmlConnector {view := "Design::viewUmlComponents", edge := "Architecture::edgePrismBuildToDocsSyncPage"})
}

definition{
  name: umlPrismPMDocsSiteBranchToDocsSyncGuest,
  parameters: [],
  result: Foundation.Arch::UmlConnector,
  body: (record Foundation.Arch::UmlConnector {view := "Design::viewUmlComponents", edge := "Architecture::edgePrismPMDocsSiteBranchToDocsSyncGuest"})
}

definition{
  name: umlSourceRepositoryToPrismBuild,
  parameters: [],
  result: Foundation.Arch::UmlConnector,
  body: (record Foundation.Arch::UmlConnector {view := "Design::viewUmlComponents", edge := "Architecture::edgeSourceRepositoryToPrismBuild"})
}

definition{
  name: umlUorFoundationToDocsSyncGuest,
  parameters: [],
  result: Foundation.Arch::UmlConnector,
  body: (record Foundation.Arch::UmlConnector {view := "Design::viewUmlComponents", edge := "Architecture::edgeUorFoundationToDocsSyncGuest"})
}

definition{
  name: seqBrowser,
  parameters: [],
  result: Foundation.Arch::UmlLifeline,
  body: (record Foundation.Arch::UmlLifeline {view := "Design::viewUmlRequest", component := "Architecture::componentBrowser", order := 0})
}

definition{
  name: seqDocsSyncGuest,
  parameters: [],
  result: Foundation.Arch::UmlLifeline,
  body: (record Foundation.Arch::UmlLifeline {view := "Design::viewUmlRequest", component := "Architecture::componentDocsSyncGuest", order := 1})
}

definition{
  name: seqRequest,
  parameters: [],
  result: Foundation.Arch::UmlMessage,
  body: (record Foundation.Arch::UmlMessage {view := "Design::viewUmlRequest", kind := (ctor Foundation.Arch::UmlMessageKind.synchronous), order := 0, source := "Architecture::componentBrowser", target := "Architecture::componentDocsSyncGuest", process := "Design::processDecide"})
}

definition{
  name: seqReply,
  parameters: [],
  result: Foundation.Arch::UmlMessage,
  body: (record Foundation.Arch::UmlMessage {view := "Design::viewUmlRequest", kind := (ctor Foundation.Arch::UmlMessageKind.reply), order := 1, source := "Architecture::componentDocsSyncGuest", target := "Architecture::componentBrowser", process := "Design::processDecide"})
}

definition{
  name: stIdle,
  parameters: [],
  result: Foundation.Arch::UmlState,
  body: (record Foundation.Arch::UmlState {view := "Design::viewUmlStates", state := "Design::stateIdle", initial := true})
}

definition{
  name: stDeciding,
  parameters: [],
  result: Foundation.Arch::UmlState,
  body: (record Foundation.Arch::UmlState {view := "Design::viewUmlStates", state := "Design::stateDeciding", initial := false})
}

definition{
  name: stRefused,
  parameters: [],
  result: Foundation.Arch::UmlState,
  body: (record Foundation.Arch::UmlState {view := "Design::viewUmlStates", state := "Design::stateRefused", initial := false})
}

definition{
  name: stAnsweredKeep,
  parameters: [],
  result: Foundation.Arch::UmlState,
  body: (record Foundation.Arch::UmlState {view := "Design::viewUmlStates", state := "Design::stateAnsweredKeep", initial := false})
}

definition{
  name: stAnsweredRefuse,
  parameters: [],
  result: Foundation.Arch::UmlState,
  body: (record Foundation.Arch::UmlState {view := "Design::viewUmlStates", state := "Design::stateAnsweredRefuse", initial := false})
}

definition{
  name: stAnsweredUnchanged,
  parameters: [],
  result: Foundation.Arch::UmlState,
  body: (record Foundation.Arch::UmlState {view := "Design::viewUmlStates", state := "Design::stateAnsweredUnchanged", initial := false})
}

definition{
  name: stAnsweredRedeploy,
  parameters: [],
  result: Foundation.Arch::UmlState,
  body: (record Foundation.Arch::UmlState {view := "Design::viewUmlStates", state := "Design::stateAnsweredRedeploy", initial := false})
}

definition{
  name: trAccept,
  parameters: [],
  result: Foundation.Arch::UmlTransition,
  body: (record Foundation.Arch::UmlTransition {view := "Design::viewUmlStates", order := 0, source := "Design::stateIdle", target := "Design::stateDeciding", trigger := "Design::processParseRequest"})
}

definition{
  name: trRefuse,
  parameters: [],
  result: Foundation.Arch::UmlTransition,
  body: (record Foundation.Arch::UmlTransition {view := "Design::viewUmlStates", order := 1, source := "Design::stateIdle", target := "Design::stateRefused", trigger := "Design::processParseRequest"})
}

definition{
  name: trRule1,
  parameters: [],
  result: Foundation.Arch::UmlTransition,
  body: (record Foundation.Arch::UmlTransition {view := "Design::viewUmlStates", order := 2, source := "Design::stateDeciding", target := "Design::stateAnsweredKeep", trigger := "Design::processRule1"})
}

definition{
  name: trRule2,
  parameters: [],
  result: Foundation.Arch::UmlTransition,
  body: (record Foundation.Arch::UmlTransition {view := "Design::viewUmlStates", order := 3, source := "Design::stateDeciding", target := "Design::stateAnsweredRefuse", trigger := "Design::processRule2"})
}

definition{
  name: trRule3,
  parameters: [],
  result: Foundation.Arch::UmlTransition,
  body: (record Foundation.Arch::UmlTransition {view := "Design::viewUmlStates", order := 4, source := "Design::stateDeciding", target := "Design::stateAnsweredRefuse", trigger := "Design::processRule3"})
}

definition{
  name: trRule4,
  parameters: [],
  result: Foundation.Arch::UmlTransition,
  body: (record Foundation.Arch::UmlTransition {view := "Design::viewUmlStates", order := 5, source := "Design::stateDeciding", target := "Design::stateAnsweredRefuse", trigger := "Design::processRule4"})
}

definition{
  name: trRule5,
  parameters: [],
  result: Foundation.Arch::UmlTransition,
  body: (record Foundation.Arch::UmlTransition {view := "Design::viewUmlStates", order := 6, source := "Design::stateDeciding", target := "Design::stateAnsweredRefuse", trigger := "Design::processRule5"})
}

definition{
  name: trRule6,
  parameters: [],
  result: Foundation.Arch::UmlTransition,
  body: (record Foundation.Arch::UmlTransition {view := "Design::viewUmlStates", order := 7, source := "Design::stateDeciding", target := "Design::stateAnsweredUnchanged", trigger := "Design::processRule6"})
}

definition{
  name: trOtherwise,
  parameters: [],
  result: Foundation.Arch::UmlTransition,
  body: (record Foundation.Arch::UmlTransition {view := "Design::viewUmlStates", order := 8, source := "Design::stateDeciding", target := "Design::stateAnsweredRedeploy", trigger := "Design::processOtherwise"})
}

definition{
  name: trResetKeep,
  parameters: [],
  result: Foundation.Arch::UmlTransition,
  body: (record Foundation.Arch::UmlTransition {view := "Design::viewUmlStates", order := 9, source := "Design::stateAnsweredKeep", target := "Design::stateIdle", trigger := "Design::processEncodeAnswer"})
}

definition{
  name: trResetRefuse,
  parameters: [],
  result: Foundation.Arch::UmlTransition,
  body: (record Foundation.Arch::UmlTransition {view := "Design::viewUmlStates", order := 10, source := "Design::stateAnsweredRefuse", target := "Design::stateIdle", trigger := "Design::processEncodeAnswer"})
}

definition{
  name: trResetUnchanged,
  parameters: [],
  result: Foundation.Arch::UmlTransition,
  body: (record Foundation.Arch::UmlTransition {view := "Design::viewUmlStates", order := 11, source := "Design::stateAnsweredUnchanged", target := "Design::stateIdle", trigger := "Design::processEncodeAnswer"})
}

definition{
  name: trResetRedeploy,
  parameters: [],
  result: Foundation.Arch::UmlTransition,
  body: (record Foundation.Arch::UmlTransition {view := "Design::viewUmlStates", order := 12, source := "Design::stateAnsweredRedeploy", target := "Design::stateIdle", trigger := "Design::processEncodeAnswer"})
}

definition{
  name: trResetRefused,
  parameters: [],
  result: Foundation.Arch::UmlTransition,
  body: (record Foundation.Arch::UmlTransition {view := "Design::viewUmlStates", order := 13, source := "Design::stateRefused", target := "Design::stateIdle", trigger := "Design::processEncodeAnswer"})
}
\end{semanticmodule}
\end{lexlean}
app/src/Features.lex.tex 144 lines
\begin{lexlean}{Features}
\useglossary{lexlean.std.bool@1.2.0}
\useglossary{lexlean.std.nat@1.2.0}
\useglossary{prism.arch@1.0.0}
\importmodule{SiteDocsSync}
\importmodule{Architecture}
\importmodule{Foundation.Arch}
\title{feature}
\begin{semanticmodule}
definition{
  name: acceptINV001,
  parameters: [],
  result: String,
  body: "SiteDocsSyncProofs::inv001Holds"
}

definition{
  name: acceptINV002,
  parameters: [],
  result: String,
  body: "SiteDocsSyncProofs::inv002Holds"
}

definition{
  name: acceptINV003,
  parameters: [],
  result: String,
  body: "SiteDocsSyncProofs::inv003Holds"
}

definition{
  name: acceptINV004,
  parameters: [],
  result: String,
  body: "SiteDocsSyncProofs::inv004Holds"
}

definition{
  name: featureRule1,
  parameters: [],
  result: Foundation.Arch::Feature,
  body: (record Foundation.Arch::Feature {statement := "When branch is absent and seed is no, the answer is keep.", calls := (cons "SiteDocsSync::rule1" (cons "SiteDocsSync::judge" (nil String))), acceptance := (cons "SiteDocsSync::application" (nil String))})
}

definition{
  name: featureRule2,
  parameters: [],
  result: Foundation.Arch::Feature,
  body: (record Foundation.Arch::Feature {statement := "When pages equals 0, the answer is refuse.", calls := (cons "SiteDocsSync::rule2" (cons "SiteDocsSync::judge" (nil String))), acceptance := (cons "SiteDocsSync::application" (nil String))})
}

definition{
  name: featureRule3,
  parameters: [],
  result: Foundation.Arch::Feature,
  body: (record Foundation.Arch::Feature {statement := "When package is no-release, the answer is refuse.", calls := (cons "SiteDocsSync::rule3" (cons "SiteDocsSync::judge" (nil String))), acceptance := (cons "SiteDocsSync::application" (nil String))})
}

definition{
  name: featureRule4,
  parameters: [],
  result: Foundation.Arch::Feature,
  body: (record Foundation.Arch::Feature {statement := "When package is mismatch, the answer is refuse.", calls := (cons "SiteDocsSync::rule4" (cons "SiteDocsSync::judge" (nil String))), acceptance := (cons "SiteDocsSync::application" (nil String))})
}

definition{
  name: featureRule5,
  parameters: [],
  result: Foundation.Arch::Feature,
  body: (record Foundation.Arch::Feature {statement := "When package is no-skill, the answer is refuse.", calls := (cons "SiteDocsSync::rule5" (cons "SiteDocsSync::judge" (nil String))), acceptance := (cons "SiteDocsSync::application" (nil String))})
}

definition{
  name: featureRule6,
  parameters: [],
  result: Foundation.Arch::Feature,
  body: (record Foundation.Arch::Feature {statement := "When changed is no, the answer is unchanged.", calls := (cons "SiteDocsSync::rule6" (cons "SiteDocsSync::judge" (nil String))), acceptance := (cons "SiteDocsSync::application" (nil String))})
}

definition{
  name: featureOtherwise,
  parameters: [],
  result: Foundation.Arch::Feature,
  body: (record Foundation.Arch::Feature {statement := "When no rule matches, the answer is redeploy.", calls := (cons "SiteDocsSync::judge" (nil String)), acceptance := (cons "SiteDocsSync::application" (nil String))})
}

definition{
  name: featureRefuseMalformed,
  parameters: [],
  result: Foundation.Arch::Feature,
  body: (record Foundation.Arch::Feature {statement := "A request that is not branch, seed, pages, package, changed in order, separated by single spaces, or is over 136 bytes, is answered invalid.", calls := (cons "SiteDocsSync::dispatch" (cons "SiteDocsSync::decodeField1" (nil String))), acceptance := (cons "SiteDocsSync::application" (nil String))})
}

definition{
  name: featureINV001,
  parameters: [],
  result: Foundation.Arch::Feature,
  body: (record Foundation.Arch::Feature {statement := "It never answers redeploy when pages equals 0.", calls := (cons "SiteDocsSync::judge" (nil String)), acceptance := (cons "Features::acceptINV001" (nil String))})
}

definition{
  name: featureINV002,
  parameters: [],
  result: Foundation.Arch::Feature,
  body: (record Foundation.Arch::Feature {statement := "It never answers redeploy when package is mismatch.", calls := (cons "SiteDocsSync::judge" (nil String)), acceptance := (cons "Features::acceptINV002" (nil String))})
}

definition{
  name: featureINV003,
  parameters: [],
  result: Foundation.Arch::Feature,
  body: (record Foundation.Arch::Feature {statement := "It never answers redeploy when changed is no.", calls := (cons "SiteDocsSync::judge" (nil String)), acceptance := (cons "Features::acceptINV003" (nil String))})
}

definition{
  name: featureINV004,
  parameters: [],
  result: Foundation.Arch::Feature,
  body: (record Foundation.Arch::Feature {statement := "It always answers keep when branch is absent and seed is no.", calls := (cons "SiteDocsSync::judge" (nil String)), acceptance := (cons "Features::acceptINV004" (nil String))})
}

definition{
  name: journeySiteMaintainer,
  parameters: [],
  result: Foundation.Arch::Journey,
  body: (record Foundation.Arch::Journey {actor := "Architecture::stakeholderSiteMaintainer", steps := (cons "Features::featureRule1" (cons "Features::featureRule3" (cons "Features::featureRule4" (cons "Features::featureRule5" (cons "Features::featureRule6" (cons "Features::featureINV003" (cons "Features::featureRefuseMalformed" (nil String))))))))})
}

definition{
  name: journeySiteVisitor,
  parameters: [],
  result: Foundation.Arch::Journey,
  body: (record Foundation.Arch::Journey {actor := "Architecture::stakeholderSiteVisitor", steps := (cons "Features::featureOtherwise" (cons "Features::featureRule2" (cons "Features::featureINV001" (cons "Features::featureINV002" (nil String)))))})
}

definition{
  name: journeyVerifier,
  parameters: [],
  result: Foundation.Arch::Journey,
  body: (record Foundation.Arch::Journey {actor := "Architecture::stakeholderVerifier", steps := (cons "Features::featureRefuseMalformed" (cons "Features::featureINV001" (cons "Features::featureINV002" (cons "Features::featureINV003" (cons "Features::featureINV004" (nil String))))))})
}
\end{semanticmodule}
\end{lexlean}
app/src/Quality.lex.tex 375 lines
\begin{lexlean}{Quality}
\useglossary{lexlean.std.bool@1.2.0}
\useglossary{lexlean.std.nat@1.2.0}
\useglossary{prism.arch@1.0.0}
\useglossary{prism.qual@1.0.0}
\importmodule{Foundation.Qual}
\title{quality measure}
\begin{semanticmodule}
structure{
  name: Named,
  type_parameters: [],
  parameters: [],
  fields: [{name: index, type: Nat}, {name: name, type: String}, {name: text, type: String}]
}

definition{
  name: characteristicFunctionalSuitability,
  parameters: [],
  result: Foundation.Qual::ProductQualityCharacteristic,
  body: (record Foundation.Qual::ProductQualityCharacteristic {index := 0})
}

definition{
  name: characteristicPerformanceEfficiency,
  parameters: [],
  result: Foundation.Qual::ProductQualityCharacteristic,
  body: (record Foundation.Qual::ProductQualityCharacteristic {index := 1})
}

definition{
  name: characteristicReliability,
  parameters: [],
  result: Foundation.Qual::ProductQualityCharacteristic,
  body: (record Foundation.Qual::ProductQualityCharacteristic {index := 2})
}

definition{
  name: characteristicSecurity,
  parameters: [],
  result: Foundation.Qual::ProductQualityCharacteristic,
  body: (record Foundation.Qual::ProductQualityCharacteristic {index := 3})
}

definition{
  name: subcharacteristicFaultTolerance,
  parameters: [],
  result: Foundation.Qual::QualitySubcharacteristic,
  body: (record Foundation.Qual::QualitySubcharacteristic {index := 0, characteristicIndex := 2})
}

definition{
  name: subcharacteristicFaultlessness,
  parameters: [],
  result: Foundation.Qual::QualitySubcharacteristic,
  body: (record Foundation.Qual::QualitySubcharacteristic {index := 1, characteristicIndex := 2})
}

definition{
  name: subcharacteristicFunctionalCompleteness,
  parameters: [],
  result: Foundation.Qual::QualitySubcharacteristic,
  body: (record Foundation.Qual::QualitySubcharacteristic {index := 2, characteristicIndex := 0})
}

definition{
  name: subcharacteristicFunctionalCorrectness,
  parameters: [],
  result: Foundation.Qual::QualitySubcharacteristic,
  body: (record Foundation.Qual::QualitySubcharacteristic {index := 3, characteristicIndex := 0})
}

definition{
  name: subcharacteristicIntegrity,
  parameters: [],
  result: Foundation.Qual::QualitySubcharacteristic,
  body: (record Foundation.Qual::QualitySubcharacteristic {index := 4, characteristicIndex := 3})
}

definition{
  name: subcharacteristicResourceUtilization,
  parameters: [],
  result: Foundation.Qual::QualitySubcharacteristic,
  body: (record Foundation.Qual::QualitySubcharacteristic {index := 5, characteristicIndex := 1})
}

definition{
  name: subcharacteristicTimeBehaviour,
  parameters: [],
  result: Foundation.Qual::QualitySubcharacteristic,
  body: (record Foundation.Qual::QualitySubcharacteristic {index := 6, characteristicIndex := 1})
}

definition{
  name: requirementBoundedAllocation,
  parameters: [],
  result: Foundation.Qual::QualityRequirement,
  body: (record Foundation.Qual::QualityRequirement {index := 0, subcharacteristicIndex := 5})
}

definition{
  name: requirementBoundedRequest,
  parameters: [],
  result: Foundation.Qual::QualityRequirement,
  body: (record Foundation.Qual::QualityRequirement {index := 1, subcharacteristicIndex := 6})
}

definition{
  name: requirementEveryFailedCheckRefuses,
  parameters: [],
  result: Foundation.Qual::QualityRequirement,
  body: (record Foundation.Qual::QualityRequirement {index := 2, subcharacteristicIndex := 0})
}

definition{
  name: requirementEveryPropertyProved,
  parameters: [],
  result: Foundation.Qual::QualityRequirement,
  body: (record Foundation.Qual::QualityRequirement {index := 3, subcharacteristicIndex := 4})
}

definition{
  name: requirementEveryRequestAnswered,
  parameters: [],
  result: Foundation.Qual::QualityRequirement,
  body: (record Foundation.Qual::QualityRequirement {index := 4, subcharacteristicIndex := 2})
}

definition{
  name: requirementEveryVectorReplays,
  parameters: [],
  result: Foundation.Qual::QualityRequirement,
  body: (record Foundation.Qual::QualityRequirement {index := 5, subcharacteristicIndex := 1})
}

definition{
  name: requirementExamplesAnsweredAsStated,
  parameters: [],
  result: Foundation.Qual::QualityRequirement,
  body: (record Foundation.Qual::QualityRequirement {index := 6, subcharacteristicIndex := 3})
}

definition{
  name: requirementNoNeedlessRedeploy,
  parameters: [],
  result: Foundation.Qual::QualityRequirement,
  body: (record Foundation.Qual::QualityRequirement {index := 7, subcharacteristicIndex := 5})
}

definition{
  name: measureExampleMismatches,
  parameters: [],
  result: Foundation.Qual::QualityMeasure,
  body: (record Foundation.Qual::QualityMeasure {index := 0, requirementIndex := 6, threshold := 0})
}

definition{
  name: measureFailedVectors,
  parameters: [],
  result: Foundation.Qual::QualityMeasure,
  body: (record Foundation.Qual::QualityMeasure {index := 1, requirementIndex := 5, threshold := 0})
}

definition{
  name: measureGuestAllocationBytes,
  parameters: [],
  result: Foundation.Qual::QualityMeasure,
  body: (record Foundation.Qual::QualityMeasure {index := 2, requirementIndex := 0, threshold := 272})
}

definition{
  name: measureNeedlessRedeploys,
  parameters: [],
  result: Foundation.Qual::QualityMeasure,
  body: (record Foundation.Qual::QualityMeasure {index := 3, requirementIndex := 7, threshold := 0})
}

definition{
  name: measureRefusalChecks,
  parameters: [],
  result: Foundation.Qual::QualityMeasure,
  body: (record Foundation.Qual::QualityMeasure {index := 4, requirementIndex := 2, threshold := 4})
}

definition{
  name: measureRequestBytesRead,
  parameters: [],
  result: Foundation.Qual::QualityMeasure,
  body: (record Foundation.Qual::QualityMeasure {index := 5, requirementIndex := 1, threshold := 136})
}

definition{
  name: measureUnansweredRequests,
  parameters: [],
  result: Foundation.Qual::QualityMeasure,
  body: (record Foundation.Qual::QualityMeasure {index := 6, requirementIndex := 4, threshold := 0})
}

definition{
  name: measureUnprovedProperties,
  parameters: [],
  result: Foundation.Qual::QualityMeasure,
  body: (record Foundation.Qual::QualityMeasure {index := 7, requirementIndex := 3, threshold := 0})
}

definition{
  name: characteristicNames,
  parameters: [],
  result: (List Named),
  body: (cons (record Named {index := 0, name := "Functional suitability", text := "Functional suitability, as ISO/IEC 25010:2023 defines it, for Docs sync."}) (cons (record Named {index := 1, name := "Performance efficiency", text := "Performance efficiency, as ISO/IEC 25010:2023 defines it, for Docs sync."}) (cons (record Named {index := 2, name := "Reliability", text := "Reliability, as ISO/IEC 25010:2023 defines it, for Docs sync."}) (cons (record Named {index := 3, name := "Security", text := "Security, as ISO/IEC 25010:2023 defines it, for Docs sync."}) (nil Named)))))
}

definition{
  name: subcharacteristicNames,
  parameters: [],
  result: (List Named),
  body: (cons (record Named {index := 0, name := "Fault tolerance", text := "Reliability: Fault tolerance."}) (cons (record Named {index := 1, name := "Faultlessness", text := "Reliability: Faultlessness."}) (cons (record Named {index := 2, name := "Functional completeness", text := "Functional suitability: Functional completeness."}) (cons (record Named {index := 3, name := "Functional correctness", text := "Functional suitability: Functional correctness."}) (cons (record Named {index := 4, name := "Integrity", text := "Security: Integrity."}) (cons (record Named {index := 5, name := "Resource utilization", text := "Performance efficiency: Resource utilization."}) (cons (record Named {index := 6, name := "Time behaviour", text := "Performance efficiency: Time behaviour."}) (nil Named))))))))
}

definition{
  name: requirementNames,
  parameters: [],
  result: (List Named),
  body: (cons (record Named {index := 0, name := "Bounded allocation", text := "The guest allocates at most 272 bytes for one request."}) (cons (record Named {index := 1, name := "Bounded request", text := "A request over 136 bytes is refused before any field is read."}) (cons (record Named {index := 2, name := "Every failed check refuses", text := "Each of the four refusals the sync script throws is a rule answering refuse."}) (cons (record Named {index := 3, name := "Every property proved", text := "All 4 properties are theorems the Lean kernel checks."}) (cons (record Named {index := 4, name := "Every request answered", text := "Every request gets an answer: a rule, redeploy otherwise, or invalid."}) (cons (record Named {index := 5, name := "Every vector replays", text := "All 49 acceptance vectors replay in the compiled guest, the shortest 0 bytes long."}) (cons (record Named {index := 6, name := "Examples answered as stated", text := "Every one of the 7 examples of the spec is answered as it states."}) (cons (record Named {index := 7, name := "No needless redeploy", text := "A run that changes no generated file does not redeploy."}) (nil Named)))))))))
}

definition{
  name: measureNames,
  parameters: [],
  result: (List Named),
  body: (cons (record Named {index := 0, name := "Example mismatches", text := "Examples the guest answers otherwise than they state."}) (cons (record Named {index := 1, name := "Failed vectors", text := "Acceptance vectors whose replay differs from the model."}) (cons (record Named {index := 2, name := "Guest allocation bytes", text := "Most bytes the guest allocates for one request."}) (cons (record Named {index := 3, name := "Needless redeploys", text := "Acceptance vectors with no change answered redeploy."}) (cons (record Named {index := 4, name := "Refusal checks", text := "Refusal checks of the sync script the app models."}) (cons (record Named {index := 5, name := "Request bytes read", text := "Longest request the guest decodes, in bytes."}) (cons (record Named {index := 6, name := "Unanswered requests", text := "Acceptance vectors the guest does not answer."}) (cons (record Named {index := 7, name := "Unproved properties", text := "Properties of the spec without a checked theorem."}) (nil Named)))))))))
}

definition{
  name: subcharacteristicRecords,
  parameters: [],
  result: (List Foundation.Qual::QualitySubcharacteristic),
  body: (cons (subcharacteristicFaultTolerance) (cons (subcharacteristicFaultlessness) (cons (subcharacteristicFunctionalCompleteness) (cons (subcharacteristicFunctionalCorrectness) (cons (subcharacteristicIntegrity) (cons (subcharacteristicResourceUtilization) (cons (subcharacteristicTimeBehaviour) (nil Foundation.Qual::QualitySubcharacteristic))))))))
}

definition{
  name: requirementRecords,
  parameters: [],
  result: (List Foundation.Qual::QualityRequirement),
  body: (cons (requirementBoundedAllocation) (cons (requirementBoundedRequest) (cons (requirementEveryFailedCheckRefuses) (cons (requirementEveryPropertyProved) (cons (requirementEveryRequestAnswered) (cons (requirementEveryVectorReplays) (cons (requirementExamplesAnsweredAsStated) (cons (requirementNoNeedlessRedeploy) (nil Foundation.Qual::QualityRequirement)))))))))
}

definition{
  name: measureRecords,
  parameters: [],
  result: (List Foundation.Qual::QualityMeasure),
  body: (cons (measureExampleMismatches) (cons (measureFailedVectors) (cons (measureGuestAllocationBytes) (cons (measureNeedlessRedeploys) (cons (measureRefusalChecks) (cons (measureRequestBytesRead) (cons (measureUnansweredRequests) (cons (measureUnprovedProperties) (nil Foundation.Qual::QualityMeasure)))))))))
}

definition{
  name: namesNumbered,
  parameters: [position : Nat, names : (List Named)],
  result: Bool,
  body: (match names
    | List.nil => true
    | List.cons item rest => (((project item index) =? position) && (namesNumbered (position + 1) rest))),
  recursive_argument: names
}

definition{
  name: parentsKnown,
  parameters: [count : Nat, records : (List Foundation.Qual::QualitySubcharacteristic)],
  result: Bool,
  body: (match records
    | List.nil => true
    | List.cons item rest => (((project item characteristicIndex) <? count) && (parentsKnown count rest))),
  recursive_argument: records
}

definition{
  name: requirementsKnown,
  parameters: [count : Nat, records : (List Foundation.Qual::QualityRequirement)],
  result: Bool,
  body: (match records
    | List.nil => true
    | List.cons item rest => (((project item subcharacteristicIndex) <? count) && (requirementsKnown count rest))),
  recursive_argument: records
}

definition{
  name: measuresKnown,
  parameters: [count : Nat, records : (List Foundation.Qual::QualityMeasure)],
  result: Bool,
  body: (match records
    | List.nil => true
    | List.cons item rest => (((project item requirementIndex) <? count) && (measuresKnown count rest))),
  recursive_argument: records
}

definition{
  name: thresholdOf,
  parameters: [wanted : Nat, records : (List Foundation.Qual::QualityMeasure)],
  result: Nat,
  body: (match records
    | List.nil => 0
    | List.cons head rest => (if ((project head index) =? wanted) then (project head threshold) else (thresholdOf wanted rest))),
  recursive_argument: records
}

definition{
  name: qualityValid,
  parameters: [],
  result: Bool,
  body: ((namesNumbered 0 (characteristicNames)) && ((namesNumbered 0 (subcharacteristicNames)) && ((namesNumbered 0 (requirementNames)) && ((namesNumbered 0 (measureNames)) && ((parentsKnown 4 (subcharacteristicRecords)) && ((requirementsKnown 7 (requirementRecords)) && (measuresKnown 8 (measureRecords))))))))
}

theorem{
  name: qualityModelHolds,
  parameters: [],
  statement: ((qualityValid) = true),
  proof: decide{}
}

theorem{
  name: measureExampleMismatchesThreshold,
  parameters: [],
  statement: ((thresholdOf 0 (measureRecords)) = 0),
  proof: decide{}
}

theorem{
  name: measureFailedVectorsThreshold,
  parameters: [],
  statement: ((thresholdOf 1 (measureRecords)) = 0),
  proof: decide{}
}

theorem{
  name: measureGuestAllocationBytesThreshold,
  parameters: [],
  statement: ((thresholdOf 2 (measureRecords)) = 272),
  proof: decide{}
}

theorem{
  name: measureNeedlessRedeploysThreshold,
  parameters: [],
  statement: ((thresholdOf 3 (measureRecords)) = 0),
  proof: decide{}
}

theorem{
  name: measureRefusalChecksThreshold,
  parameters: [],
  statement: ((thresholdOf 4 (measureRecords)) = 4),
  proof: decide{}
}

theorem{
  name: measureRequestBytesReadThreshold,
  parameters: [],
  statement: ((thresholdOf 5 (measureRecords)) = 136),
  proof: decide{}
}

theorem{
  name: measureUnansweredRequestsThreshold,
  parameters: [],
  statement: ((thresholdOf 6 (measureRecords)) = 0),
  proof: decide{}
}

theorem{
  name: measureUnprovedPropertiesThreshold,
  parameters: [],
  statement: ((thresholdOf 7 (measureRecords)) = 0),
  proof: decide{}
}
\end{semanticmodule}
\end{lexlean}
app/src/Security.lex.tex 593 lines
\begin{lexlean}{Security}
\useglossary{lexlean.std.bool@1.2.0}
\useglossary{lexlean.std.nat@1.2.0}
\useglossary{prism.arch@1.0.0}
\useglossary{prism.sec@1.0.0}
\importmodule{Foundation.Sec}
\importmodule{Production.ThreatModel}
\importmodule{Architecture}
\title{security threat}
\begin{semanticmodule}
definition{
  name: assetAnswer,
  parameters: [],
  result: Foundation.Sec::Asset,
  body: (record Foundation.Sec::Asset {index := 0, componentIndex := 1})
}

definition{
  name: assetModelSource,
  parameters: [],
  result: Foundation.Sec::Asset,
  body: (record Foundation.Sec::Asset {index := 1, componentIndex := 7})
}

definition{
  name: assetPublishedHolo,
  parameters: [],
  result: Foundation.Sec::Asset,
  body: (record Foundation.Sec::Asset {index := 2, componentIndex := 2})
}

definition{
  name: assetRequestBytes,
  parameters: [],
  result: Foundation.Sec::Asset,
  body: (record Foundation.Sec::Asset {index := 3, componentIndex := 1})
}

definition{
  name: threatAnswerThatBreaksINV001,
  parameters: [],
  result: Foundation.Sec::Threat,
  body: (record Foundation.Sec::Threat {index := 0})
}

definition{
  name: threatAnswerThatBreaksINV002,
  parameters: [],
  result: Foundation.Sec::Threat,
  body: (record Foundation.Sec::Threat {index := 1})
}

definition{
  name: threatAnswerThatBreaksINV003,
  parameters: [],
  result: Foundation.Sec::Threat,
  body: (record Foundation.Sec::Threat {index := 2})
}

definition{
  name: threatAnswerThatBreaksINV004,
  parameters: [],
  result: Foundation.Sec::Threat,
  body: (record Foundation.Sec::Threat {index := 3})
}

definition{
  name: threatCompromisedDocsSiteBranch,
  parameters: [],
  result: Foundation.Sec::Threat,
  body: (record Foundation.Sec::Threat {index := 4})
}

definition{
  name: threatDocsWipedByAnEmptyTree,
  parameters: [],
  result: Foundation.Sec::Threat,
  body: (record Foundation.Sec::Threat {index := 5})
}

definition{
  name: threatGrantedCapability,
  parameters: [],
  result: Foundation.Sec::Threat,
  body: (record Foundation.Sec::Threat {index := 6})
}

definition{
  name: threatMalformedRequest,
  parameters: [],
  result: Foundation.Sec::Threat,
  body: (record Foundation.Sec::Threat {index := 7})
}

definition{
  name: threatOversizedRequest,
  parameters: [],
  result: Foundation.Sec::Threat,
  body: (record Foundation.Sec::Threat {index := 8})
}

definition{
  name: threatSubstitutedHolo,
  parameters: [],
  result: Foundation.Sec::Threat,
  body: (record Foundation.Sec::Threat {index := 9})
}

definition{
  name: threatSubstitutedHost,
  parameters: [],
  result: Foundation.Sec::Threat,
  body: (record Foundation.Sec::Threat {index := 10})
}

definition{
  name: threatTamperedModel,
  parameters: [],
  result: Foundation.Sec::Threat,
  body: (record Foundation.Sec::Threat {index := 11})
}

definition{
  name: threatTamperedPrismCodeTarball,
  parameters: [],
  result: Foundation.Sec::Threat,
  body: (record Foundation.Sec::Threat {index := 12})
}

definition{
  name: riskAnswerThatBreaksINV001,
  parameters: [],
  result: Foundation.Sec::Risk,
  body: (record Foundation.Sec::Risk {index := 0, assetIndex := 0, threatIndex := 0, likelihood := (ctor Foundation.Sec::Likelihood.medium), impact := (ctor Foundation.Sec::Impact.critical)})
}

definition{
  name: riskAnswerThatBreaksINV002,
  parameters: [],
  result: Foundation.Sec::Risk,
  body: (record Foundation.Sec::Risk {index := 1, assetIndex := 0, threatIndex := 1, likelihood := (ctor Foundation.Sec::Likelihood.medium), impact := (ctor Foundation.Sec::Impact.critical)})
}

definition{
  name: riskAnswerThatBreaksINV003,
  parameters: [],
  result: Foundation.Sec::Risk,
  body: (record Foundation.Sec::Risk {index := 2, assetIndex := 0, threatIndex := 2, likelihood := (ctor Foundation.Sec::Likelihood.medium), impact := (ctor Foundation.Sec::Impact.critical)})
}

definition{
  name: riskAnswerThatBreaksINV004,
  parameters: [],
  result: Foundation.Sec::Risk,
  body: (record Foundation.Sec::Risk {index := 3, assetIndex := 0, threatIndex := 3, likelihood := (ctor Foundation.Sec::Likelihood.medium), impact := (ctor Foundation.Sec::Impact.critical)})
}

definition{
  name: riskCompromisedDocsSiteBranch,
  parameters: [],
  result: Foundation.Sec::Risk,
  body: (record Foundation.Sec::Risk {index := 4, assetIndex := 1, threatIndex := 4, likelihood := (ctor Foundation.Sec::Likelihood.low), impact := (ctor Foundation.Sec::Impact.major)})
}

definition{
  name: riskDocsWipedByAnEmptyTree,
  parameters: [],
  result: Foundation.Sec::Risk,
  body: (record Foundation.Sec::Risk {index := 5, assetIndex := 0, threatIndex := 5, likelihood := (ctor Foundation.Sec::Likelihood.medium), impact := (ctor Foundation.Sec::Impact.major)})
}

definition{
  name: riskGrantedCapability,
  parameters: [],
  result: Foundation.Sec::Risk,
  body: (record Foundation.Sec::Risk {index := 6, assetIndex := 0, threatIndex := 6, likelihood := (ctor Foundation.Sec::Likelihood.low), impact := (ctor Foundation.Sec::Impact.major)})
}

definition{
  name: riskMalformedRequest,
  parameters: [],
  result: Foundation.Sec::Risk,
  body: (record Foundation.Sec::Risk {index := 7, assetIndex := 3, threatIndex := 7, likelihood := (ctor Foundation.Sec::Likelihood.high), impact := (ctor Foundation.Sec::Impact.major)})
}

definition{
  name: riskOversizedRequest,
  parameters: [],
  result: Foundation.Sec::Risk,
  body: (record Foundation.Sec::Risk {index := 8, assetIndex := 3, threatIndex := 8, likelihood := (ctor Foundation.Sec::Likelihood.medium), impact := (ctor Foundation.Sec::Impact.minor)})
}

definition{
  name: riskSubstitutedHolo,
  parameters: [],
  result: Foundation.Sec::Risk,
  body: (record Foundation.Sec::Risk {index := 9, assetIndex := 2, threatIndex := 9, likelihood := (ctor Foundation.Sec::Likelihood.low), impact := (ctor Foundation.Sec::Impact.critical)})
}

definition{
  name: riskSubstitutedHost,
  parameters: [],
  result: Foundation.Sec::Risk,
  body: (record Foundation.Sec::Risk {index := 10, assetIndex := 2, threatIndex := 10, likelihood := (ctor Foundation.Sec::Likelihood.low), impact := (ctor Foundation.Sec::Impact.critical)})
}

definition{
  name: riskTamperedModel,
  parameters: [],
  result: Foundation.Sec::Risk,
  body: (record Foundation.Sec::Risk {index := 11, assetIndex := 1, threatIndex := 11, likelihood := (ctor Foundation.Sec::Likelihood.low), impact := (ctor Foundation.Sec::Impact.major)})
}

definition{
  name: riskTamperedPrismCodeTarball,
  parameters: [],
  result: Foundation.Sec::Risk,
  body: (record Foundation.Sec::Risk {index := 12, assetIndex := 1, threatIndex := 12, likelihood := (ctor Foundation.Sec::Likelihood.low), impact := (ctor Foundation.Sec::Impact.critical)})
}

definition{
  name: controlBoundedRequest,
  parameters: [],
  result: Foundation.Sec::ApplicationSecurityControl,
  body: (record Foundation.Sec::ApplicationSecurityControl {index := 0, riskIndex := 8})
}

definition{
  name: controlFingerprintAndProvenance,
  parameters: [],
  result: Foundation.Sec::ApplicationSecurityControl,
  body: (record Foundation.Sec::ApplicationSecurityControl {index := 1, riskIndex := 9})
}

definition{
  name: controlNoCapabilityGranted,
  parameters: [],
  result: Foundation.Sec::ApplicationSecurityControl,
  body: (record Foundation.Sec::ApplicationSecurityControl {index := 2, riskIndex := 6})
}

definition{
  name: controlNoPagesNoOverwrite,
  parameters: [],
  result: Foundation.Sec::ApplicationSecurityControl,
  body: (record Foundation.Sec::ApplicationSecurityControl {index := 3, riskIndex := 5})
}

definition{
  name: controlProofOfINV001,
  parameters: [],
  result: Foundation.Sec::ApplicationSecurityControl,
  body: (record Foundation.Sec::ApplicationSecurityControl {index := 4, riskIndex := 0})
}

definition{
  name: controlProofOfINV002,
  parameters: [],
  result: Foundation.Sec::ApplicationSecurityControl,
  body: (record Foundation.Sec::ApplicationSecurityControl {index := 5, riskIndex := 1})
}

definition{
  name: controlProofOfINV003,
  parameters: [],
  result: Foundation.Sec::ApplicationSecurityControl,
  body: (record Foundation.Sec::ApplicationSecurityControl {index := 6, riskIndex := 2})
}

definition{
  name: controlProofOfINV004,
  parameters: [],
  result: Foundation.Sec::ApplicationSecurityControl,
  body: (record Foundation.Sec::ApplicationSecurityControl {index := 7, riskIndex := 3})
}

definition{
  name: controlRegeneratedFromThePrompt,
  parameters: [],
  result: Foundation.Sec::ApplicationSecurityControl,
  body: (record Foundation.Sec::ApplicationSecurityControl {index := 8, riskIndex := 11})
}

definition{
  name: controlRegistryIntegrity,
  parameters: [],
  result: Foundation.Sec::ApplicationSecurityControl,
  body: (record Foundation.Sec::ApplicationSecurityControl {index := 9, riskIndex := 12})
}

definition{
  name: controlStrictDecoder,
  parameters: [],
  result: Foundation.Sec::ApplicationSecurityControl,
  body: (record Foundation.Sec::ApplicationSecurityControl {index := 10, riskIndex := 7})
}

definition{
  name: controlSet,
  parameters: [],
  result: Production.ThreatModel::ControlSet,
  body: (record Production.ThreatModel::ControlSet {title := "Docs sync security controls", text := "Docs sync answers one request with one answer in a Core-Wasm guest granted no capability. Decide whether one run of the Prism docs sync keeps the current docs, refuses to overwrite them, finds nothing changed, or commits and redeploys the site, from the docs-site branch, the seed flag, the pages found, the prism-code package check and whether the generated files changed.", version := "0.1.0", lastModified := "2026-11-12T18:44:38Z"})
}

definition{
  name: modeledAssetAnswer,
  parameters: [],
  result: Production.ThreatModel::ModeledAsset,
  body: (record Production.ThreatModel::ModeledAsset {asset := "Security::assetAnswer", name := "Answer", text := "The answer the guest returns: one of keep, refuse, unchanged, redeploy, or invalid."})
}

definition{
  name: modeledAssetModelSource,
  parameters: [],
  result: Production.ThreatModel::ModeledAsset,
  body: (record Production.ThreatModel::ModeledAsset {asset := "Security::assetModelSource", name := "Model source", text := "The prompt, the spec and the LexLean model in the repository, from which the holo is built."})
}

definition{
  name: modeledAssetPublishedHolo,
  parameters: [],
  result: Production.ThreatModel::ModeledAsset,
  body: (record Production.ThreatModel::ModeledAsset {asset := "Security::assetPublishedHolo", name := "Published holo", text := "The holo and page the Pages workflow publishes, with its fingerprint and signed provenance."})
}

definition{
  name: modeledAssetRequestBytes,
  parameters: [],
  result: Production.ThreatModel::ModeledAsset,
  body: (record Production.ThreatModel::ModeledAsset {asset := "Security::assetRequestBytes", name := "Request bytes", text := "The bytes a caller sends, at most 136 of them."})
}

definition{
  name: modeledThreatAnswerThatBreaksINV001,
  parameters: [],
  result: Production.ThreatModel::ModeledThreat,
  body: (record Production.ThreatModel::ModeledThreat {threat := "Security::threatAnswerThatBreaksINV001", name := "Answer that breaks INV-001", text := "The guest answers redeploy although pages equals 0, which matters because an empty docs tree never replaces the published docs.", category := (ctor Production.ThreatModel::Stride.repudiation)})
}

definition{
  name: modeledThreatAnswerThatBreaksINV002,
  parameters: [],
  result: Production.ThreatModel::ModeledThreat,
  body: (record Production.ThreatModel::ModeledThreat {threat := "Security::threatAnswerThatBreaksINV002", name := "Answer that breaks INV-002", text := "The guest answers redeploy although package is mismatch, which matters because a tarball that fails its integrity never sets the versions or skill the site states.", category := (ctor Production.ThreatModel::Stride.repudiation)})
}

definition{
  name: modeledThreatAnswerThatBreaksINV003,
  parameters: [],
  result: Production.ThreatModel::ModeledThreat,
  body: (record Production.ThreatModel::ModeledThreat {threat := "Security::threatAnswerThatBreaksINV003", name := "Answer that breaks INV-003", text := "The guest answers redeploy although changed is no, which matters because the site is redeployed only when the docs changed.", category := (ctor Production.ThreatModel::Stride.repudiation)})
}

definition{
  name: modeledThreatAnswerThatBreaksINV004,
  parameters: [],
  result: Production.ThreatModel::ModeledThreat,
  body: (record Production.ThreatModel::ModeledThreat {threat := "Security::threatAnswerThatBreaksINV004", name := "Answer that breaks INV-004", text := "The guest answers keep not when branch is absent and seed is no, which matters because without the branch, and without --seed, the docs are kept.", category := (ctor Production.ThreatModel::Stride.repudiation)})
}

definition{
  name: modeledThreatCompromisedDocsSiteBranch,
  parameters: [],
  result: Production.ThreatModel::ModeledThreat,
  body: (record Production.ThreatModel::ModeledThreat {threat := "Security::threatCompromisedDocsSiteBranch", name := "Compromised docs-site branch", text := "Someone with push access to the PrismPM docs-site branch publishes misleading docs.", category := (ctor Production.ThreatModel::Stride.spoofing)})
}

definition{
  name: modeledThreatDocsWipedByAnEmptyTree,
  parameters: [],
  result: Production.ThreatModel::ModeledThreat,
  body: (record Production.ThreatModel::ModeledThreat {threat := "Security::threatDocsWipedByAnEmptyTree", name := "Docs wiped by an empty tree", text := "A reorganized or empty docs-site branch overwrites every docs page with nothing.", category := (ctor Production.ThreatModel::Stride.denialOfService)})
}

definition{
  name: modeledThreatGrantedCapability,
  parameters: [],
  result: Production.ThreatModel::ModeledThreat,
  body: (record Production.ThreatModel::ModeledThreat {threat := "Security::threatGrantedCapability", name := "Granted capability", text := "The guest reads, stores or sends data beyond the request it answers.", category := (ctor Production.ThreatModel::Stride.informationDisclosure)})
}

definition{
  name: modeledThreatMalformedRequest,
  parameters: [],
  result: Production.ThreatModel::ModeledThreat,
  body: (record Production.ThreatModel::ModeledThreat {threat := "Security::threatMalformedRequest", name := "Malformed request", text := "A request with a missing, extra, unknown or badly written field is answered as if it were well formed.", category := (ctor Production.ThreatModel::Stride.tampering)})
}

definition{
  name: modeledThreatOversizedRequest,
  parameters: [],
  result: Production.ThreatModel::ModeledThreat,
  body: (record Production.ThreatModel::ModeledThreat {threat := "Security::threatOversizedRequest", name := "Oversized request", text := "A request longer than 136 bytes makes the guest parse or allocate without bound.", category := (ctor Production.ThreatModel::Stride.denialOfService)})
}

definition{
  name: modeledThreatSubstitutedHolo,
  parameters: [],
  result: Production.ThreatModel::ModeledThreat,
  body: (record Production.ThreatModel::ModeledThreat {threat := "Security::threatSubstitutedHolo", name := "Substituted holo", text := "A holo other than the one the build verified is served under the app address.", category := (ctor Production.ThreatModel::Stride.spoofing)})
}

definition{
  name: modeledThreatSubstitutedHost,
  parameters: [],
  result: Production.ThreatModel::ModeledThreat,
  body: (record Production.ThreatModel::ModeledThreat {threat := "Security::threatSubstitutedHost", name := "Substituted host", text := "Something other than the repository Pages workflow serves pages under its address.", category := (ctor Production.ThreatModel::Stride.spoofing)})
}

definition{
  name: modeledThreatTamperedModel,
  parameters: [],
  result: Production.ThreatModel::ModeledThreat,
  body: (record Production.ThreatModel::ModeledThreat {threat := "Security::threatTamperedModel", name := "Tampered model", text := "The model the holo is built from differs from the reviewed prompt and spec.", category := (ctor Production.ThreatModel::Stride.tampering)})
}

definition{
  name: modeledThreatTamperedPrismCodeTarball,
  parameters: [],
  result: Production.ThreatModel::ModeledThreat,
  body: (record Production.ThreatModel::ModeledThreat {threat := "Security::threatTamperedPrismCodeTarball", name := "Tampered prism-code tarball", text := "A tarball that differs from its registry integrity sets the published versions and agent skill.", category := (ctor Production.ThreatModel::Stride.tampering)})
}

definition{
  name: modeledControlBoundedRequest,
  parameters: [],
  result: Production.ThreatModel::ModeledControl,
  body: (record Production.ThreatModel::ModeledControl {control := "Security::controlBoundedRequest", name := "Bounded request", text := "dispatch answers invalid for a request over 136 bytes before reading a field, and the guest allocates at most 272.", evidence := (cons (record Production.ThreatModel::Evidence {kind := (ctor Production.ThreatModel::EvidenceKind.gate), reference := "acceptance vectors at the request bound, one byte over it, and at the guest allocation bound, replayed by prismpm verify"}) (nil Production.ThreatModel::Evidence))})
}

definition{
  name: modeledControlFingerprintAndProvenance,
  parameters: [],
  result: Production.ThreatModel::ModeledControl,
  body: (record Production.ThreatModel::ModeledControl {control := "Security::controlFingerprintAndProvenance", name := "Fingerprint and provenance", text := "The page verifies the holo digests before it runs, and the build signs its provenance as the repository workflow.", evidence := (cons (record Production.ThreatModel::Evidence {kind := (ctor Production.ThreatModel::EvidenceKind.gate), reference := "actions/attest-build-provenance in the pages workflow"}) (cons (record Production.ThreatModel::Evidence {kind := (ctor Production.ThreatModel::EvidenceKind.gate), reference := "prism-code check of the holo identities in the page"}) (nil Production.ThreatModel::Evidence)))})
}

definition{
  name: modeledControlNoCapabilityGranted,
  parameters: [],
  result: Production.ThreatModel::ModeledControl,
  body: (record Production.ThreatModel::ModeledControl {control := "Security::controlNoCapabilityGranted", name := "No capability granted", text := "prism.toml grants the holo nothing and the model declares capabilitiesEmpty, so a guest import of any host capability is refused.", evidence := (cons (record Production.ThreatModel::Evidence {kind := (ctor Production.ThreatModel::EvidenceKind.gate), reference := "prism-code check refuses an ungranted guest import"}) (nil Production.ThreatModel::Evidence))})
}

definition{
  name: modeledControlNoPagesNoOverwrite,
  parameters: [],
  result: Production.ThreatModel::ModeledControl,
  body: (record Production.ThreatModel::ModeledControl {control := "Security::controlNoPagesNoOverwrite", name := "No pages, no overwrite", text := "Zero pages is refused.", evidence := (cons (record Production.ThreatModel::Evidence {kind := (ctor Production.ThreatModel::EvidenceKind.proof), reference := "SiteDocsSyncProofs::inv001Holds"}) (cons (record Production.ThreatModel::Evidence {kind := (ctor Production.ThreatModel::EvidenceKind.review), reference := "UOR-Foundation/website scripts/sync-prism-docs.mjs"}) (nil Production.ThreatModel::Evidence)))})
}

definition{
  name: modeledControlProofOfINV001,
  parameters: [],
  result: Production.ThreatModel::ModeledControl,
  body: (record Production.ThreatModel::ModeledControl {control := "Security::controlProofOfINV001", name := "Proof of INV-001", text := "It never answers redeploy when pages equals 0. The Lean kernel proves it for every request.", evidence := (cons (record Production.ThreatModel::Evidence {kind := (ctor Production.ThreatModel::EvidenceKind.proof), reference := "SiteDocsSyncProofs::inv001Holds"}) (nil Production.ThreatModel::Evidence))})
}

definition{
  name: modeledControlProofOfINV002,
  parameters: [],
  result: Production.ThreatModel::ModeledControl,
  body: (record Production.ThreatModel::ModeledControl {control := "Security::controlProofOfINV002", name := "Proof of INV-002", text := "It never answers redeploy when package is mismatch. The Lean kernel proves it for every request.", evidence := (cons (record Production.ThreatModel::Evidence {kind := (ctor Production.ThreatModel::EvidenceKind.proof), reference := "SiteDocsSyncProofs::inv002Holds"}) (nil Production.ThreatModel::Evidence))})
}

definition{
  name: modeledControlProofOfINV003,
  parameters: [],
  result: Production.ThreatModel::ModeledControl,
  body: (record Production.ThreatModel::ModeledControl {control := "Security::controlProofOfINV003", name := "Proof of INV-003", text := "It never answers redeploy when changed is no. The Lean kernel proves it for every request.", evidence := (cons (record Production.ThreatModel::Evidence {kind := (ctor Production.ThreatModel::EvidenceKind.proof), reference := "SiteDocsSyncProofs::inv003Holds"}) (nil Production.ThreatModel::Evidence))})
}

definition{
  name: modeledControlProofOfINV004,
  parameters: [],
  result: Production.ThreatModel::ModeledControl,
  body: (record Production.ThreatModel::ModeledControl {control := "Security::controlProofOfINV004", name := "Proof of INV-004", text := "It always answers keep when branch is absent and seed is no. The Lean kernel proves it for every request.", evidence := (cons (record Production.ThreatModel::Evidence {kind := (ctor Production.ThreatModel::EvidenceKind.proof), reference := "SiteDocsSyncProofs::inv004Holds"}) (nil Production.ThreatModel::Evidence))})
}

definition{
  name: modeledControlRegeneratedFromThePrompt,
  parameters: [],
  result: Production.ThreatModel::ModeledControl,
  body: (record Production.ThreatModel::ModeledControl {control := "Security::controlRegeneratedFromThePrompt", name := "Regenerated from the prompt", text := "The model is written from the prompt by the builder, and the build checks every theorem and replays every vector in the pinned SDK.", evidence := (cons (record Production.ThreatModel::Evidence {kind := (ctor Production.ThreatModel::EvidenceKind.gate), reference := "prismpm verify in the SDK image prismpm.lock pins"}) (cons (record Production.ThreatModel::Evidence {kind := (ctor Production.ThreatModel::EvidenceKind.review), reference := "app/prompt.json"}) (nil Production.ThreatModel::Evidence)))})
}

definition{
  name: modeledControlRegistryIntegrity,
  parameters: [],
  result: Production.ThreatModel::ModeledControl,
  body: (record Production.ThreatModel::ModeledControl {control := "Security::controlRegistryIntegrity", name := "Registry integrity", text := "An integrity mismatch is refused.", evidence := (cons (record Production.ThreatModel::Evidence {kind := (ctor Production.ThreatModel::EvidenceKind.proof), reference := "SiteDocsSyncProofs::inv002Holds"}) (cons (record Production.ThreatModel::Evidence {kind := (ctor Production.ThreatModel::EvidenceKind.gate), reference := "UOR-Foundation/website scripts/sync-prism-docs.mjs integrity check"}) (nil Production.ThreatModel::Evidence)))})
}

definition{
  name: modeledControlStrictDecoder,
  parameters: [],
  result: Production.ThreatModel::ModeledControl,
  body: (record Production.ThreatModel::ModeledControl {control := "Security::controlStrictDecoder", name := "Strict decoder", text := "Every field is decoded exactly: choices from their list, numbers as plain decimal digits within their bounds, single spaces between fields; anything else is invalid.", evidence := (cons (record Production.ThreatModel::Evidence {kind := (ctor Production.ThreatModel::EvidenceKind.gate), reference := "malformed-request acceptance vectors, replayed in the compiled guest by prismpm verify"}) (nil Production.ThreatModel::Evidence))})
}

definition{
  name: mappingOversizedRequest,
  parameters: [],
  result: Production.ThreatModel::ThreatMapping,
  body: (record Production.ThreatModel::ThreatMapping {threat := "Security::threatOversizedRequest", controls := (cons "Security::controlBoundedRequest" (nil String))})
}

definition{
  name: mappingSubstitutedHolo,
  parameters: [],
  result: Production.ThreatModel::ThreatMapping,
  body: (record Production.ThreatModel::ThreatMapping {threat := "Security::threatSubstitutedHolo", controls := (cons "Security::controlFingerprintAndProvenance" (nil String))})
}

definition{
  name: mappingGrantedCapability,
  parameters: [],
  result: Production.ThreatModel::ThreatMapping,
  body: (record Production.ThreatModel::ThreatMapping {threat := "Security::threatGrantedCapability", controls := (cons "Security::controlNoCapabilityGranted" (nil String))})
}

definition{
  name: mappingDocsWipedByAnEmptyTree,
  parameters: [],
  result: Production.ThreatModel::ThreatMapping,
  body: (record Production.ThreatModel::ThreatMapping {threat := "Security::threatDocsWipedByAnEmptyTree", controls := (cons "Security::controlNoPagesNoOverwrite" (nil String))})
}

definition{
  name: mappingAnswerThatBreaksINV001,
  parameters: [],
  result: Production.ThreatModel::ThreatMapping,
  body: (record Production.ThreatModel::ThreatMapping {threat := "Security::threatAnswerThatBreaksINV001", controls := (cons "Security::controlProofOfINV001" (nil String))})
}

definition{
  name: mappingAnswerThatBreaksINV002,
  parameters: [],
  result: Production.ThreatModel::ThreatMapping,
  body: (record Production.ThreatModel::ThreatMapping {threat := "Security::threatAnswerThatBreaksINV002", controls := (cons "Security::controlProofOfINV002" (nil String))})
}

definition{
  name: mappingAnswerThatBreaksINV003,
  parameters: [],
  result: Production.ThreatModel::ThreatMapping,
  body: (record Production.ThreatModel::ThreatMapping {threat := "Security::threatAnswerThatBreaksINV003", controls := (cons "Security::controlProofOfINV003" (nil String))})
}

definition{
  name: mappingAnswerThatBreaksINV004,
  parameters: [],
  result: Production.ThreatModel::ThreatMapping,
  body: (record Production.ThreatModel::ThreatMapping {threat := "Security::threatAnswerThatBreaksINV004", controls := (cons "Security::controlProofOfINV004" (nil String))})
}

definition{
  name: mappingTamperedModel,
  parameters: [],
  result: Production.ThreatModel::ThreatMapping,
  body: (record Production.ThreatModel::ThreatMapping {threat := "Security::threatTamperedModel", controls := (cons "Security::controlRegeneratedFromThePrompt" (nil String))})
}

definition{
  name: mappingTamperedPrismCodeTarball,
  parameters: [],
  result: Production.ThreatModel::ThreatMapping,
  body: (record Production.ThreatModel::ThreatMapping {threat := "Security::threatTamperedPrismCodeTarball", controls := (cons "Security::controlRegistryIntegrity" (nil String))})
}

definition{
  name: mappingMalformedRequest,
  parameters: [],
  result: Production.ThreatModel::ThreatMapping,
  body: (record Production.ThreatModel::ThreatMapping {threat := "Security::threatMalformedRequest", controls := (cons "Security::controlStrictDecoder" (nil String))})
}

definition{
  name: acceptedCompromisedDocsSiteBranch,
  parameters: [],
  result: Production.ThreatModel::AcceptedRisk,
  body: (record Production.ThreatModel::AcceptedRisk {threat := "Security::threatCompromisedDocsSiteBranch", rationale := "The site trusts the PrismPM repository as the docs authority; the generated files are committed, so every change is reviewable in history."})
}

definition{
  name: acceptedSubstitutedHost,
  parameters: [],
  result: Production.ThreatModel::AcceptedRisk,
  body: (record Production.ThreatModel::AcceptedRisk {threat := "Security::threatSubstitutedHost", rationale := "A page cannot defend against its own host. The holo carries signed build provenance a visitor can check, and the app can be rebuilt from its prompt."})
}
\end{semanticmodule}
\end{lexlean}
app/src/SiteDocsSync.lex.tex 275 lines
\begin{lexlean}{SiteDocsSync}
\useglossary{lexlean.std.bool@1.2.0}
\useglossary{lexlean.std.nat@1.2.0}
\useglossary{prism.arch@1.0.0}
\importmodule{Foundation.Bytes}
\importmodule{Foundation.View.Text.V1.Model}
\title{Text application model}
\begin{semanticmodule}
definition{name: branchPresent, parameters: [], result: Nat, body: 0}

definition{name: branchAbsent, parameters: [], result: Nat, body: 1}

definition{name: seedNo, parameters: [], result: Nat, body: 0}

definition{name: seedYes, parameters: [], result: Nat, body: 1}

definition{name: packageVerified, parameters: [], result: Nat, body: 0}

definition{name: packageNoRelease, parameters: [], result: Nat, body: 1}

definition{name: packageMismatch, parameters: [], result: Nat, body: 2}

definition{name: packageNoSkill, parameters: [], result: Nat, body: 3}

definition{name: changedYes, parameters: [], result: Nat, body: 0}

definition{name: changedNo, parameters: [], result: Nat, body: 1}

definition{name: answerKeep, parameters: [], result: Nat, body: 0}

definition{name: answerRefuse, parameters: [], result: Nat, body: 1}

definition{name: answerUnchanged, parameters: [], result: Nat, body: 2}

definition{name: answerRedeploy, parameters: [], result: Nat, body: 3}

structure{
  name: Request,
  type_parameters: [],
  parameters: [],
  fields: [
    {name: branch, type: Nat},
    {name: seed, type: Nat},
    {name: pages, type: Nat},
    {name: package, type: Nat},
    {name: changed, type: Nat}
  ]
}

definition{
  name: byteAt,
  parameters: [s : Bytes, i : Nat],
  result: (Option Nat),
  body: (match (prim index s i : (Option UInt8))
    | Option.none => (ctor Option.none [Nat])
    | Option.some b => (ctor Option.some [Nat] (prim to_nat b : Nat))),
  axioms: [Quot.sound, propext]
}

definition{
  name: digitsValue,
  parameters: [s : Bytes, i : Nat, acc : Nat, fuel : Nat],
  result: (Option Nat),
  body: (match fuel
    | Nat.zero => (ctor Option.some [Nat] acc)
    | Nat.succ rest => (match (byteAt s i)
      | Option.none => (ctor Option.none [Nat])
      | Option.some d => (if ((d <? 48) || (57 <? d)) then (ctor Option.none [Nat]) else (digitsValue s (i + 1) ((prim multiply acc 10 : Nat) + (prim subtract d 48 : Nat)) rest)))),
  axioms: [Quot.sound, propext],
  recursive_argument: fuel
}

definition{
  name: parseDigits,
  parameters: [s : Bytes],
  result: (Option Nat),
  body: (if ((Foundation.Bytes::byteLength s) =? 0) then (ctor Option.none [Nat]) else (if (18 <? (Foundation.Bytes::byteLength s)) then (ctor Option.none [Nat]) else (match (byteAt s 0)
    | Option.none => (ctor Option.none [Nat])
    | Option.some lead => (if ((lead =? 48) && (1 <? (Foundation.Bytes::byteLength s))) then (ctor Option.none [Nat]) else (digitsValue s 0 0 (Foundation.Bytes::byteLength s)))))),
  axioms: [Quot.sound, propext]
}

definition{
  name: parseNumber,
  parameters: [value : Bytes],
  result: (Option Nat),
  body: (parseDigits value),
  axioms: [Quot.sound, propext]
}

definition{
  name: parseBranch,
  parameters: [value : Bytes],
  result: (Option Nat),
  body: (if (prim equal value 0x70726573656e74 : Bool) then (ctor Option.some [Nat] (branchPresent)) else (if (prim equal value 0x616273656e74 : Bool) then (ctor Option.some [Nat] (branchAbsent)) else (ctor Option.none [Nat])))
}

definition{
  name: parseSeed,
  parameters: [value : Bytes],
  result: (Option Nat),
  body: (if (prim equal value 0x6e6f : Bool) then (ctor Option.some [Nat] (seedNo)) else (if (prim equal value 0x796573 : Bool) then (ctor Option.some [Nat] (seedYes)) else (ctor Option.none [Nat])))
}

definition{
  name: parsePages,
  parameters: [value : Bytes],
  result: (Option Nat),
  body: (match (parseNumber value)
    | Option.none => (ctor Option.none [Nat])
    | Option.some parsed => (if (10000 <? parsed) then (ctor Option.none [Nat]) else (ctor Option.some [Nat] parsed))),
  axioms: [Quot.sound, propext]
}

definition{
  name: parsePackage,
  parameters: [value : Bytes],
  result: (Option Nat),
  body: (if (prim equal value 0x7665726966696564 : Bool) then (ctor Option.some [Nat] (packageVerified)) else (if (prim equal value 0x6e6f2d72656c65617365 : Bool) then (ctor Option.some [Nat] (packageNoRelease)) else (if (prim equal value 0x6d69736d61746368 : Bool) then (ctor Option.some [Nat] (packageMismatch)) else (if (prim equal value 0x6e6f2d736b696c6c : Bool) then (ctor Option.some [Nat] (packageNoSkill)) else (ctor Option.none [Nat])))))
}

definition{
  name: parseChanged,
  parameters: [value : Bytes],
  result: (Option Nat),
  body: (if (prim equal value 0x796573 : Bool) then (ctor Option.some [Nat] (changedYes)) else (if (prim equal value 0x6e6f : Bool) then (ctor Option.some [Nat] (changedNo)) else (ctor Option.none [Nat])))
}

definition{
  name: sliceOf,
  parameters: [s : Bytes, start : Nat, count : Nat],
  result: Bytes,
  body: (match (prim slice s start count : (Option Bytes))
    | Option.none => 0x
    | Option.some part => part)
}

definition{
  name: fieldEnd,
  parameters: [s : Bytes, i : Nat, fuel : Nat],
  result: Nat,
  body: (match fuel
    | Nat.zero => i
    | Nat.succ rest => (match (byteAt s i)
      | Option.none => i
      | Option.some d => (if (d =? 32) then i else (fieldEnd s (i + 1) rest)))),
  axioms: [Quot.sound, propext],
  recursive_argument: fuel
}

definition{
  name: decodeField5,
  parameters: [s : Bytes, start : Nat, v1 : Nat, v2 : Nat, v3 : Nat, v4 : Nat],
  result: (Option Request),
  body: (let e : Nat := (fieldEnd s start (Foundation.Bytes::byteLength s)); (match (parseChanged (sliceOf s start (prim subtract e start : Nat)))
    | Option.none => (ctor Option.none [Request])
    | Option.some v5 => (if (e =? (Foundation.Bytes::byteLength s)) then (ctor Option.some [Request] (record Request {branch := v1, seed := v2, pages := v3, package := v4, changed := v5})) else (ctor Option.none [Request])))),
  axioms: [Quot.sound, propext]
}

definition{
  name: decodeField4,
  parameters: [s : Bytes, start : Nat, v1 : Nat, v2 : Nat, v3 : Nat],
  result: (Option Request),
  body: (let e : Nat := (fieldEnd s start (Foundation.Bytes::byteLength s)); (match (parsePackage (sliceOf s start (prim subtract e start : Nat)))
    | Option.none => (ctor Option.none [Request])
    | Option.some v4 => (if (e <? (Foundation.Bytes::byteLength s)) then (decodeField5 s (e + 1) v1 v2 v3 v4) else (ctor Option.none [Request])))),
  axioms: [Quot.sound, propext]
}

definition{
  name: decodeField3,
  parameters: [s : Bytes, start : Nat, v1 : Nat, v2 : Nat],
  result: (Option Request),
  body: (let e : Nat := (fieldEnd s start (Foundation.Bytes::byteLength s)); (match (parsePages (sliceOf s start (prim subtract e start : Nat)))
    | Option.none => (ctor Option.none [Request])
    | Option.some v3 => (if (e <? (Foundation.Bytes::byteLength s)) then (decodeField4 s (e + 1) v1 v2 v3) else (ctor Option.none [Request])))),
  axioms: [Quot.sound, propext]
}

definition{
  name: decodeField2,
  parameters: [s : Bytes, start : Nat, v1 : Nat],
  result: (Option Request),
  body: (let e : Nat := (fieldEnd s start (Foundation.Bytes::byteLength s)); (match (parseSeed (sliceOf s start (prim subtract e start : Nat)))
    | Option.none => (ctor Option.none [Request])
    | Option.some v2 => (if (e <? (Foundation.Bytes::byteLength s)) then (decodeField3 s (e + 1) v1 v2) else (ctor Option.none [Request])))),
  axioms: [Quot.sound, propext]
}

definition{
  name: decodeField1,
  parameters: [s : Bytes, start : Nat],
  result: (Option Request),
  body: (let e : Nat := (fieldEnd s start (Foundation.Bytes::byteLength s)); (match (parseBranch (sliceOf s start (prim subtract e start : Nat)))
    | Option.none => (ctor Option.none [Request])
    | Option.some v1 => (if (e <? (Foundation.Bytes::byteLength s)) then (decodeField2 s (e + 1) v1) else (ctor Option.none [Request])))),
  axioms: [Quot.sound, propext]
}

definition{
  name: rule1,
  parameters: [request : Request],
  result: Bool,
  body: (((project request branch) =? (branchAbsent)) && ((project request seed) =? (seedNo)))
}

definition{
  name: rule2,
  parameters: [request : Request],
  result: Bool,
  body: ((project request pages) =? 0)
}

definition{
  name: rule3,
  parameters: [request : Request],
  result: Bool,
  body: ((project request package) =? (packageNoRelease))
}

definition{
  name: rule4,
  parameters: [request : Request],
  result: Bool,
  body: ((project request package) =? (packageMismatch))
}

definition{
  name: rule5,
  parameters: [request : Request],
  result: Bool,
  body: ((project request package) =? (packageNoSkill))
}

definition{
  name: rule6,
  parameters: [request : Request],
  result: Bool,
  body: ((project request changed) =? (changedNo))
}

definition{
  name: judge,
  parameters: [request : Request],
  result: Nat,
  body: (if (rule1 request) then (answerKeep) else (if (rule2 request) then (answerRefuse) else (if (rule3 request) then (answerRefuse) else (if (rule4 request) then (answerRefuse) else (if (rule5 request) then (answerRefuse) else (if (rule6 request) then (answerUnchanged) else (answerRedeploy)))))))
}

definition{
  name: encodeAnswer,
  parameters: [code : Nat],
  result: Bytes,
  body: (if (code =? (answerKeep)) then 0x6b656570 else (if (code =? (answerRefuse)) then 0x726566757365 else (if (code =? (answerUnchanged)) then 0x756e6368616e676564 else (if (code =? (answerRedeploy)) then 0x72656465706c6f79 else 0x696e76616c6964))))
}

definition{
  name: dispatch,
  parameters: [value : Bytes],
  result: Bytes,
  body: (if (136 <? (Foundation.Bytes::byteLength value)) then 0x696e76616c6964 else (match (decodeField1 value 0)
    | Option.none => 0x696e76616c6964
    | Option.some request => (encodeAnswer (judge request)))),
  axioms: [Quot.sound, propext]
}

definition{
  name: application,
  parameters: [],
  result: Foundation.View.Text.V1.Model::TextApplication,
  body: (record Foundation.View.Text.V1.Model::TextApplication {profile := "prismpm/text-application/1", name := "Docs sync", cargoName := "prism-site-docs-sync", cargoVersion := "0.1.0", cargoDescription := "Decide whether one run of the Prism docs sync keeps the current docs, refuses to overwrite them, finds nothing changed, or commits and redeploys the site, from the docs-site branch, the seed flag, the", cargoRepository := "https://github.com/UOR-Foundation/PrismPM", cargoHomepage := "https://github.com/UOR-Foundation/PrismPM", libraryRoots := (cons "PrismSiteDocsSync.SiteDocsSync.dispatch" (nil String)), acceptanceVectors := (cons (record Foundation.View.Text.V1.Model::AcceptanceVector {request := 0x70726573656e74206e6f20343220766572696669656420796573, response := 0x72656465706c6f79}) (cons (record Foundation.View.Text.V1.Model::AcceptanceVector {request := 0x70726573656e74206e6f203432207665726966696564206e6f, response := 0x756e6368616e676564}) (cons (record Foundation.View.Text.V1.Model::AcceptanceVector {request := 0x616273656e74206e6f2030206e6f2d72656c6561736520796573, response := 0x6b656570}) (cons (record Foundation.View.Text.V1.Model::AcceptanceVector {request := 0x616273656e742079657320313220766572696669656420796573, response := 0x72656465706c6f79}) (cons (record Foundation.View.Text.V1.Model::AcceptanceVector {request := 0x70726573656e74206e6f203020766572696669656420796573, response := 0x726566757365}) (cons (record Foundation.View.Text.V1.Model::AcceptanceVector {request := 0x70726573656e74206e6f203432206d69736d6174636820796573, response := 0x726566757365}) (cons (record Foundation.View.Text.V1.Model::AcceptanceVector {request := 0x70726573656e74206e6f203432206e6f2d736b696c6c20796573, response := 0x726566757365}) (cons (record Foundation.View.Text.V1.Model::AcceptanceVector {request := 0x70726573656e74206e6f2030207665726966696564206e6f, response := 0x726566757365}) (cons (record Foundation.View.Text.V1.Model::AcceptanceVector {request := 0x70726573656e74206e6f2030206e6f2d72656c6561736520796573, response := 0x726566757365}) (cons (record Foundation.View.Text.V1.Model::AcceptanceVector {request := 0x70726573656e74206e6f2030206e6f2d72656c65617365206e6f, response := 0x726566757365}) (cons (record Foundation.View.Text.V1.Model::AcceptanceVector {request := 0x70726573656e74206e6f2030206d69736d6174636820796573, response := 0x726566757365}) (cons (record Foundation.View.Text.V1.Model::AcceptanceVector {request := 0x70726573656e74206e6f2030206d69736d61746368206e6f, response := 0x726566757365}) (cons (record Foundation.View.Text.V1.Model::AcceptanceVector {request := 0x70726573656e74206e6f2030206e6f2d736b696c6c20796573, response := 0x726566757365}) (cons (record Foundation.View.Text.V1.Model::AcceptanceVector {request := 0x70726573656e74206e6f2030206e6f2d736b696c6c206e6f, response := 0x726566757365}) (cons (record Foundation.View.Text.V1.Model::AcceptanceVector {request := 0x70726573656e74206e6f203120766572696669656420796573, response := 0x72656465706c6f79}) (cons (record Foundation.View.Text.V1.Model::AcceptanceVector {request := 0x70726573656e74206e6f2031207665726966696564206e6f, response := 0x756e6368616e676564}) (cons (record Foundation.View.Text.V1.Model::AcceptanceVector {request := 0x70726573656e74206e6f2031206e6f2d72656c6561736520796573, response := 0x726566757365}) (cons (record Foundation.View.Text.V1.Model::AcceptanceVector {request := 0x70726573656e74206e6f2031206e6f2d72656c65617365206e6f, response := 0x726566757365}) (cons (record Foundation.View.Text.V1.Model::AcceptanceVector {request := 0x70726573656e74206e6f2031206d69736d6174636820796573, response := 0x726566757365}) (cons (record Foundation.View.Text.V1.Model::AcceptanceVector {request := 0x70726573656e74206e6f2031206d69736d61746368206e6f, response := 0x726566757365}) (cons (record Foundation.View.Text.V1.Model::AcceptanceVector {request := 0x70726573656e74206e6f2031206e6f2d736b696c6c20796573, response := 0x726566757365}) (cons (record Foundation.View.Text.V1.Model::AcceptanceVector {request := 0x70726573656e74206e6f2031206e6f2d736b696c6c206e6f, response := 0x726566757365}) (cons (record Foundation.View.Text.V1.Model::AcceptanceVector {request := 0x70726573656e7420796573203020766572696669656420796573, response := 0x726566757365}) (cons (record Foundation.View.Text.V1.Model::AcceptanceVector {request := 0x70726573656e74207965732030207665726966696564206e6f, response := 0x726566757365}) (cons (record Foundation.View.Text.V1.Model::AcceptanceVector {request := 0x70726573656e74207965732030206e6f2d72656c6561736520796573, response := 0x726566757365}) (cons (record Foundation.View.Text.V1.Model::AcceptanceVector {request := 0x70726573656e74207965732030206e6f2d72656c65617365206e6f, response := 0x726566757365}) (cons (record Foundation.View.Text.V1.Model::AcceptanceVector {request := 0x70726573656e74207965732030206d69736d6174636820796573, response := 0x726566757365}) (cons (record Foundation.View.Text.V1.Model::AcceptanceVector {request := 0x70726573656e74207965732030206d69736d61746368206e6f, response := 0x726566757365}) (cons (record Foundation.View.Text.V1.Model::AcceptanceVector {request := 0x70726573656e74207965732030206e6f2d736b696c6c20796573, response := 0x726566757365}) (cons (record Foundation.View.Text.V1.Model::AcceptanceVector {request := 0x70726573656e74207965732030206e6f2d736b696c6c206e6f, response := 0x726566757365}) (cons (record Foundation.View.Text.V1.Model::AcceptanceVector {request := 0x, response := 0x696e76616c6964}) (cons (record Foundation.View.Text.V1.Model::AcceptanceVector {request := 0xff, response := 0x696e76616c6964}) (cons (record Foundation.View.Text.V1.Model::AcceptanceVector {request := 0x70726573656e74206e6f2030207665726966696564, response := 0x696e76616c6964}) (cons (record Foundation.View.Text.V1.Model::AcceptanceVector {request := 0x70726573656e74206e6f20302076657269666965642079657320796573, response := 0x696e76616c6964}) (cons (record Foundation.View.Text.V1.Model::AcceptanceVector {request := 0x70726573656e7420206e6f202030202076657269666965642020796573, response := 0x696e76616c6964}) (cons (record Foundation.View.Text.V1.Model::AcceptanceVector {request := 0x756e6b6e6f776e206e6f203020766572696669656420796573, response := 0x696e76616c6964}) (cons (record Foundation.View.Text.V1.Model::AcceptanceVector {request := 0x70726573656e7420756e6b6e6f776e203020766572696669656420796573, response := 0x696e76616c6964}) (cons (record Foundation.View.Text.V1.Model::AcceptanceVector {request := 0x70726573656e74206e6f20303720766572696669656420796573, response := 0x696e76616c6964}) (cons (record Foundation.View.Text.V1.Model::AcceptanceVector {request := 0x70726573656e74206e6f202d3120766572696669656420796573, response := 0x696e76616c6964}) (cons (record Foundation.View.Text.V1.Model::AcceptanceVector {request := 0x70726573656e74206e6f202b3120766572696669656420796573, response := 0x696e76616c6964}) (cons (record Foundation.View.Text.V1.Model::AcceptanceVector {request := 0x70726573656e74206e6f203130303030303030303030303030303030303020766572696669656420796573, response := 0x696e76616c6964}) (cons (record Foundation.View.Text.V1.Model::AcceptanceVector {request := 0x70726573656e74206e6f20d9a120766572696669656420796573, response := 0x696e76616c6964}) (cons (record Foundation.View.Text.V1.Model::AcceptanceVector {request := 0x70726573656e74206e6f207820766572696669656420796573, response := 0x696e76616c6964}) (cons (record Foundation.View.Text.V1.Model::AcceptanceVector {request := 0x70726573656e74206e6f20313030303120766572696669656420796573, response := 0x696e76616c6964}) (cons (record Foundation.View.Text.V1.Model::AcceptanceVector {request := 0x70726573656e74206e6f203020756e6b6e6f776e20796573, response := 0x696e76616c6964}) (cons (record Foundation.View.Text.V1.Model::AcceptanceVector {request := 0x70726573656e74206e6f203020766572696669656420756e6b6e6f776e, response := 0x696e76616c6964}) (cons (record Foundation.View.Text.V1.Model::AcceptanceVector {request := 0x78787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878, response := 0x696e76616c6964}) (cons (record Foundation.View.Text.V1.Model::AcceptanceVector {request := 0x7878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878, response := 0x696e76616c6964}) (cons (record Foundation.View.Text.V1.Model::AcceptanceVector {request := 0x7878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878787878, response := 0x696e76616c6964}) (nil Foundation.View.Text.V1.Model::AcceptanceVector)))))))))))))))))))))))))))))))))))))))))))))))))), entryRoot := "PrismSiteDocsSync.SiteDocsSync.dispatch", coreContract := "hologram:guest/core-wasm@1", requestMaximum := (136 : UInt32), responseMaximum := (64 : UInt32), guestAllocationMaximum := (272 : UInt32), capabilitiesEmpty := true, fatArchive := true, primaryLayer := (0 : UInt8), viewLayer := (1 : UInt8), view := (record Foundation.View.Text.V1.Model::TextView {title := "Docs sync", heading := "Docs sync", inputLabel := "Request: branch seed pages package changed", submitLabel := "Decide", outputLabel := "Answer", inputError := "Invalid request", responseError := "Invalid response"})})
}
\end{semanticmodule}
\end{lexlean}
app/src/SiteDocsSyncProofs.lex.tex 169 lines
\begin{lexlean}{SiteDocsSyncProofs}
\useglossary{lexlean.std.bool@1.2.0}
\useglossary{lexlean.std.nat@1.2.0}
\useglossary{prism.arch@1.0.0}
\importmodule{SiteDocsSync}
\title{Text application model}
\begin{semanticmodule}
definition{
  name: breaksInv001,
  parameters: [request : SiteDocsSync::Request],
  result: Bool,
  body: ((((((((project request branch) <? 2) && ((project request seed) <? 2)) && ((project request pages) <=? 10000)) && ((project request package) <? 4)) && ((project request changed) <? 2)) && ((project request pages) =? 0)) && ((SiteDocsSync::judge request) =? (SiteDocsSync::answerRedeploy)))
}

theorem{
  name: inv001Holds,
  parameters: [request : SiteDocsSync::Request],
  statement: ((breaksInv001 request) = false),
  proof: linear_arithmetic{
    definitions: [
      SiteDocsSync::answerKeep,
      SiteDocsSync::answerRedeploy,
      SiteDocsSync::answerRefuse,
      SiteDocsSync::answerUnchanged,
      SiteDocsSync::branchAbsent,
      SiteDocsSync::branchPresent,
      SiteDocsSync::changedNo,
      SiteDocsSync::changedYes,
      SiteDocsSync::judge,
      SiteDocsSync::packageMismatch,
      SiteDocsSync::packageNoRelease,
      SiteDocsSync::packageNoSkill,
      SiteDocsSync::packageVerified,
      SiteDocsSync::rule1,
      SiteDocsSync::rule2,
      SiteDocsSync::rule3,
      SiteDocsSync::rule4,
      SiteDocsSync::rule5,
      SiteDocsSync::rule6,
      SiteDocsSync::seedNo,
      SiteDocsSync::seedYes,
      breaksInv001
    ]
  },
  axioms: [Quot.sound, propext]
}

definition{
  name: breaksInv002,
  parameters: [request : SiteDocsSync::Request],
  result: Bool,
  body: ((((((((project request branch) <? 2) && ((project request seed) <? 2)) && ((project request pages) <=? 10000)) && ((project request package) <? 4)) && ((project request changed) <? 2)) && ((project request package) =? (SiteDocsSync::packageMismatch))) && ((SiteDocsSync::judge request) =? (SiteDocsSync::answerRedeploy)))
}

theorem{
  name: inv002Holds,
  parameters: [request : SiteDocsSync::Request],
  statement: ((breaksInv002 request) = false),
  proof: linear_arithmetic{
    definitions: [
      SiteDocsSync::answerKeep,
      SiteDocsSync::answerRedeploy,
      SiteDocsSync::answerRefuse,
      SiteDocsSync::answerUnchanged,
      SiteDocsSync::branchAbsent,
      SiteDocsSync::branchPresent,
      SiteDocsSync::changedNo,
      SiteDocsSync::changedYes,
      SiteDocsSync::judge,
      SiteDocsSync::packageMismatch,
      SiteDocsSync::packageNoRelease,
      SiteDocsSync::packageNoSkill,
      SiteDocsSync::packageVerified,
      SiteDocsSync::rule1,
      SiteDocsSync::rule2,
      SiteDocsSync::rule3,
      SiteDocsSync::rule4,
      SiteDocsSync::rule5,
      SiteDocsSync::rule6,
      SiteDocsSync::seedNo,
      SiteDocsSync::seedYes,
      breaksInv002
    ]
  },
  axioms: [Quot.sound, propext]
}

definition{
  name: breaksInv003,
  parameters: [request : SiteDocsSync::Request],
  result: Bool,
  body: ((((((((project request branch) <? 2) && ((project request seed) <? 2)) && ((project request pages) <=? 10000)) && ((project request package) <? 4)) && ((project request changed) <? 2)) && ((project request changed) =? (SiteDocsSync::changedNo))) && ((SiteDocsSync::judge request) =? (SiteDocsSync::answerRedeploy)))
}

theorem{
  name: inv003Holds,
  parameters: [request : SiteDocsSync::Request],
  statement: ((breaksInv003 request) = false),
  proof: linear_arithmetic{
    definitions: [
      SiteDocsSync::answerKeep,
      SiteDocsSync::answerRedeploy,
      SiteDocsSync::answerRefuse,
      SiteDocsSync::answerUnchanged,
      SiteDocsSync::branchAbsent,
      SiteDocsSync::branchPresent,
      SiteDocsSync::changedNo,
      SiteDocsSync::changedYes,
      SiteDocsSync::judge,
      SiteDocsSync::packageMismatch,
      SiteDocsSync::packageNoRelease,
      SiteDocsSync::packageNoSkill,
      SiteDocsSync::packageVerified,
      SiteDocsSync::rule1,
      SiteDocsSync::rule2,
      SiteDocsSync::rule3,
      SiteDocsSync::rule4,
      SiteDocsSync::rule5,
      SiteDocsSync::rule6,
      SiteDocsSync::seedNo,
      SiteDocsSync::seedYes,
      breaksInv003
    ]
  },
  axioms: [Quot.sound, propext]
}

definition{
  name: breaksInv004,
  parameters: [request : SiteDocsSync::Request],
  result: Bool,
  body: (((((((((project request branch) <? 2) && ((project request seed) <? 2)) && ((project request pages) <=? 10000)) && ((project request package) <? 4)) && ((project request changed) <? 2)) && ((project request branch) =? (SiteDocsSync::branchAbsent))) && ((project request seed) =? (SiteDocsSync::seedNo))) && (not ((SiteDocsSync::judge request) =? (SiteDocsSync::answerKeep))))
}

theorem{
  name: inv004Holds,
  parameters: [request : SiteDocsSync::Request],
  statement: ((breaksInv004 request) = false),
  proof: linear_arithmetic{
    definitions: [
      SiteDocsSync::answerKeep,
      SiteDocsSync::answerRedeploy,
      SiteDocsSync::answerRefuse,
      SiteDocsSync::answerUnchanged,
      SiteDocsSync::branchAbsent,
      SiteDocsSync::branchPresent,
      SiteDocsSync::changedNo,
      SiteDocsSync::changedYes,
      SiteDocsSync::judge,
      SiteDocsSync::packageMismatch,
      SiteDocsSync::packageNoRelease,
      SiteDocsSync::packageNoSkill,
      SiteDocsSync::packageVerified,
      SiteDocsSync::rule1,
      SiteDocsSync::rule2,
      SiteDocsSync::rule3,
      SiteDocsSync::rule4,
      SiteDocsSync::rule5,
      SiteDocsSync::rule6,
      SiteDocsSync::seedNo,
      SiteDocsSync::seedYes,
      breaksInv004
    ]
  },
  axioms: [Classical.choice, Quot.sound, propext]
}
\end{semanticmodule}
\end{lexlean}
app/lexlean.toml 43 lines
spec = "lexlean/project/1"
name = "prism-site-docs-sync"
language = "1.2"
module_prefix = "PrismSiteDocsSync"
source_roots = ["src"]
entrypoints = ["src/Architecture.lex.tex", "src/Compliance.lex.tex", "src/Design.lex.tex", "src/Features.lex.tex", "src/Quality.lex.tex", "src/Security.lex.tex", "src/SiteDocsSync.lex.tex", "src/SiteDocsSyncProofs.lex.tex"]
build_root = ".lexlean"
lockfile = "lexlean.lock"
lean_workspace = "."
lean_toolchain = "leanprover/lean4:v4.32.1"

[[lexicon_source]]
package = "lexlean.std.nat"
kind = "builtin"

[[lexicon_source]]
package = "prism.arch"
kind = "path"
path = "language/prism.arch"

[[lexicon_source]]
package = "prism.qual"
kind = "path"
path = "language/prism.qual"

[[lexicon_source]]
package = "prism.sec"
kind = "path"
path = "language/prism.sec"

[limits]
max_file_bytes = 4194304
max_total_source_bytes = 67108864
max_primitive_atoms = 2000000
max_token_lattice_edges = 4000000
max_parse_states = 4000000
max_ir_nodes = 2000000
max_scope_depth = 1024
max_import_depth = 128
max_diagnostics = 256
max_child_output_bytes = 16777216
child_timeout_ms = 300000
app/prompt.json 373 lines
{
  "schema": "prism/prompt/1",
  "pattern": "decisionTable",
  "goal": "Decide what the nightly docs sync does to uor.foundation. The site must never swap its docs for an empty or unchecked release.",
  "repository": "UOR-Foundation/website",
  "license": "NOASSERTION",
  "app": {
    "name": "site-docs-sync",
    "title": "Docs sync",
    "purpose": "Decide whether one run of the Prism docs sync keeps the current docs, refuses to overwrite them, finds nothing changed, or commits and redeploys the site, from the docs-site branch, the seed flag, the pages found, the prism-code package check and whether the generated files changed.",
    "fields": [
      {
        "name": "branch",
        "kind": "choice",
        "values": [
          "present",
          "absent"
        ],
        "means": "whether the docs-site branch of UOR-Foundation/PrismPM exists"
      },
      {
        "name": "seed",
        "kind": "choice",
        "values": [
          "no",
          "yes"
        ],
        "means": "whether the run passes --seed, the one-time import from main's docs/generated"
      },
      {
        "name": "pages",
        "kind": "number",
        "min": 0,
        "max": 10000,
        "means": "Markdown pages found under get-started, guides, api, reference, sdks, concepts, examples or migration"
      },
      {
        "name": "package",
        "kind": "choice",
        "values": [
          "verified",
          "no-release",
          "mismatch",
          "no-skill"
        ],
        "means": "the prism-code npm latest check: verified, no latest release, tarball not matching its registry integrity, or no skill/SKILL.md in it"
      },
      {
        "name": "changed",
        "kind": "choice",
        "values": [
          "yes",
          "no"
        ],
        "means": "whether the generated prism, npm and requests files differ from main"
      }
    ],
    "outcomes": [
      "keep",
      "refuse",
      "unchanged",
      "redeploy"
    ],
    "meanings": {
      "keep": "exit 0 keeping the current docs",
      "refuse": "the sync throws and the current docs are not overwritten",
      "unchanged": "No changes, nothing committed",
      "redeploy": "commit the generated files and run deploy.yml on main"
    },
    "rules": [
      {
        "when": [
          {
            "field": "branch",
            "op": "is",
            "value": "absent"
          },
          {
            "field": "seed",
            "op": "is",
            "value": "no"
          }
        ],
        "then": "keep",
        "why": "scripts/sync-prism-docs.mjs: docs-site branch not found; keeping current docs"
      },
      {
        "when": [
          {
            "field": "pages",
            "op": "=",
            "value": 0
          }
        ],
        "then": "refuse",
        "why": "scripts/sync-prism-docs.mjs: No pages found; refusing to overwrite the current docs"
      },
      {
        "when": [
          {
            "field": "package",
            "op": "is",
            "value": "no-release"
          }
        ],
        "then": "refuse",
        "why": "scripts/sync-prism-docs.mjs: npm registry gave no prism-code latest release; refusing to overwrite the current docs"
      },
      {
        "when": [
          {
            "field": "package",
            "op": "is",
            "value": "mismatch"
          }
        ],
        "then": "refuse",
        "why": "scripts/sync-prism-docs.mjs: the prism-code tarball does not match its registry integrity"
      },
      {
        "when": [
          {
            "field": "package",
            "op": "is",
            "value": "no-skill"
          }
        ],
        "then": "refuse",
        "why": "scripts/sync-prism-docs.mjs: the site publishes the package's skill/SKILL.md byte for byte, and refuses a release without one"
      },
      {
        "when": [
          {
            "field": "changed",
            "op": "is",
            "value": "no"
          }
        ],
        "then": "unchanged",
        "why": ".github/workflows/sync-prism-docs.yml: git diff --quiet on the generated files, then No changes"
      }
    ],
    "otherwise": "redeploy",
    "otherwiseWhy": ".github/workflows/sync-prism-docs.yml: commit the generated files, push, and gh workflow run deploy.yml --ref main",
    "properties": [
      {
        "kind": "never",
        "when": [
          {
            "field": "pages",
            "op": "=",
            "value": 0
          }
        ],
        "then": "redeploy",
        "why": "an empty docs tree never replaces the published docs"
      },
      {
        "kind": "never",
        "when": [
          {
            "field": "package",
            "op": "is",
            "value": "mismatch"
          }
        ],
        "then": "redeploy",
        "why": "a tarball that fails its integrity never sets the versions or skill the site states"
      },
      {
        "kind": "never",
        "when": [
          {
            "field": "changed",
            "op": "is",
            "value": "no"
          }
        ],
        "then": "redeploy",
        "why": "the site is redeployed only when the docs changed"
      },
      {
        "kind": "always",
        "when": [
          {
            "field": "branch",
            "op": "is",
            "value": "absent"
          },
          {
            "field": "seed",
            "op": "is",
            "value": "no"
          }
        ],
        "then": "keep",
        "why": "without the branch, and without --seed, the docs are kept"
      }
    ],
    "examples": [
      {
        "request": "present no 42 verified yes",
        "response": "redeploy"
      },
      {
        "request": "present no 42 verified no",
        "response": "unchanged"
      },
      {
        "request": "absent no 0 no-release yes",
        "response": "keep"
      },
      {
        "request": "absent yes 12 verified yes",
        "response": "redeploy"
      },
      {
        "request": "present no 0 verified yes",
        "response": "refuse"
      },
      {
        "request": "present no 42 mismatch yes",
        "response": "refuse"
      },
      {
        "request": "present no 42 no-skill yes",
        "response": "refuse"
      }
    ]
  },
  "stakeholders": [
    {
      "name": "Site visitor",
      "text": "Reads the Prism SDK docs and their Markdown twins on uor.foundation and needs them to be the current docs-site release, never an empty or unverified one.",
      "concerns": [
        "Correct answers",
        "Integrity of the published app"
      ]
    },
    {
      "name": "Site maintainer",
      "text": "Owns the scheduled sync and needs it to redeploy only on a real change and to fail loudly instead of overwriting.",
      "concerns": [
        "Proved guarantees",
        "Refused malformed requests"
      ]
    }
  ],
  "components": [
    {
      "name": "PrismPM docs-site branch",
      "text": "The branch of UOR-Foundation/PrismPM the docs are pulled from.",
      "kind": "externalSystem"
    },
    {
      "name": "npm registry",
      "text": "Serves prism-code latest, its tarball and its integrity.",
      "kind": "externalSystem"
    },
    {
      "name": "uor.foundation",
      "text": "The React, Vite and Tailwind site deploy.yml publishes to GitHub Pages.",
      "kind": "staticSite"
    }
  ],
  "threats": [
    {
      "name": "Docs wiped by an empty tree",
      "text": "A reorganized or empty docs-site branch overwrites every docs page with nothing.",
      "stride": "denialOfService",
      "asset": "answer",
      "likelihood": "medium",
      "impact": "major",
      "control": {
        "name": "No pages, no overwrite",
        "text": "Zero pages is refused.",
        "evidence": [
          {
            "kind": "proof",
            "reference": "SiteDocsSyncProofs::inv001Holds"
          },
          {
            "kind": "review",
            "reference": "UOR-Foundation/website scripts/sync-prism-docs.mjs"
          }
        ]
      }
    },
    {
      "name": "Tampered prism-code tarball",
      "text": "A tarball that differs from its registry integrity sets the published versions and agent skill.",
      "stride": "tampering",
      "asset": "source",
      "likelihood": "low",
      "impact": "critical",
      "control": {
        "name": "Registry integrity",
        "text": "An integrity mismatch is refused.",
        "evidence": [
          {
            "kind": "proof",
            "reference": "SiteDocsSyncProofs::inv002Holds"
          },
          {
            "kind": "gate",
            "reference": "UOR-Foundation/website scripts/sync-prism-docs.mjs integrity check"
          }
        ]
      }
    },
    {
      "name": "Compromised docs-site branch",
      "text": "Someone with push access to the PrismPM docs-site branch publishes misleading docs.",
      "stride": "spoofing",
      "asset": "source",
      "likelihood": "low",
      "impact": "major",
      "accepted": "The site trusts the PrismPM repository as the docs authority; the generated files are committed, so every change is reviewable in history."
    }
  ],
  "quality": [
    {
      "characteristic": "Reliability",
      "subcharacteristic": "Fault tolerance",
      "requirement": "Every failed check refuses",
      "text": "Each of the four refusals the sync script throws is a rule answering refuse.",
      "measure": "Refusal checks",
      "measureText": "Refusal checks of the sync script the app models.",
      "threshold": 4
    },
    {
      "characteristic": "Performance efficiency",
      "subcharacteristic": "Resource utilization",
      "requirement": "No needless redeploy",
      "text": "A run that changes no generated file does not redeploy.",
      "measure": "Needless redeploys",
      "measureText": "Acceptance vectors with no change answered redeploy.",
      "threshold": 0
    }
  ],
  "journeys": [
    {
      "stakeholder": "Site visitor",
      "steps": [
        "otherwise",
        "REQ-002",
        "INV-001",
        "INV-002"
      ]
    },
    {
      "stakeholder": "Site maintainer",
      "steps": [
        "REQ-001",
        "REQ-003",
        "REQ-004",
        "REQ-005",
        "REQ-006",
        "INV-003",
        "refuse"
      ]
    }
  ],
  "axioms": {
    "inv004Holds": [
      "Classical.choice",
      "Quot.sound",
      "propext"
    ]
  },
  "concerns": []
}
model/ids.toml 65 lines
# model/ids.toml --- the conformance ID register.
#
# Every ID this repository claims, in one place, so that nothing is referenced
# without being defined. `CONFORMANCE.md` is generated from this file. A test
# whose name ends in an ID not listed here fails `check-model`, and an ID listed
# here with no scenario and no test fails it too (CM-02).
#
# `level` is the honesty level (R2):
#   some-true  a fact reproduced from an authority; not established here
#   build      constructed here and validated against its oracle
#   open       measured and reported, never asserted
#
# Every row here has a scenario in `features/suites/` and a test whose name ends
# in the ID, lowercased with underscores (R3, CM-02). There is no "pending"
# state: a capability that is not built does not get a row, and every row in this
# file is built.
#
# The first row is the template's own Prism application in `app/` (TC-01).
# A capability starts with a row here; `just new-capability` writes the row,
# its scenario and its failing test in the order `AGENTS.md` sets out.

spec = "template/1"

[[id]]
id = "SD-01"
level = "build"
suite = "site_docs_sync"
statement = "The app never answers redeploy when pages equals 0"

[[id]]
id = "SD-02"
level = "build"
suite = "site_docs_sync"
statement = "The app never answers redeploy when package is mismatch"

[[id]]
id = "SD-03"
level = "build"
suite = "site_docs_sync"
statement = "The app never answers redeploy when changed is no"

[[id]]
id = "SD-04"
level = "build"
suite = "site_docs_sync"
statement = "The app always answers keep when branch is absent and seed is no"

[[id]]
id = "SD-05"
level = "build"
suite = "site_docs_sync"
statement = "The architecture description declares every stakeholder, concern, component, edge, viewpoint and view it references"

[[id]]
id = "SD-06"
level = "build"
suite = "site_docs_sync"
statement = "The ISO/IEC 25010 quality model numbers every characteristic, subcharacteristic, requirement and measure, and every parent it names is declared"

[[id]]
id = "SD-07"
level = "build"
suite = "site_docs_sync"
statement = "Every compliance obligation is numbered in order and names its evidence"
features/suites/site_docs_sync.feature 44 lines
Feature: site_docs_sync

  This repository's Prism application, in app/, generated by prism-code from its
  spec: Decide whether one run of the Prism docs sync keeps the current docs, refuses to overwrite them, finds nothing changed, or commits and redeploys the site, from the docs-site branch, the seed flag, the pages found, the prism-code package check and whether the generated files changed.

  @SD-01 @build
  Scenario: The app never answers redeploy when pages equals 0
    Given the model in app/src/SiteDocsSync.lex.tex
    When the Lean kernel checks inv001Holds during prismpm verify
    Then no request meets breaksInv001

  @SD-02 @build
  Scenario: The app never answers redeploy when package is mismatch
    Given the model in app/src/SiteDocsSync.lex.tex
    When the Lean kernel checks inv002Holds during prismpm verify
    Then no request meets breaksInv002

  @SD-03 @build
  Scenario: The app never answers redeploy when changed is no
    Given the model in app/src/SiteDocsSync.lex.tex
    When the Lean kernel checks inv003Holds during prismpm verify
    Then no request meets breaksInv003

  @SD-04 @build
  Scenario: The app always answers keep when branch is absent and seed is no
    Given the model in app/src/SiteDocsSync.lex.tex
    When the Lean kernel checks inv004Holds during prismpm verify
    Then no request meets breaksInv004
  @SD-05 @build
  Scenario: The architecture description declares every stakeholder, concern, component, edge, viewpoint and view it references
    Given the model in app/src/Architecture.lex.tex
    When the Lean kernel checks architectureDescriptionHolds during prismpm verify
    Then the architecture description declares every stakeholder, concern, component, edge, viewpoint and view it references
  @SD-06 @build
  Scenario: The ISO/IEC 25010 quality model numbers every characteristic, subcharacteristic, requirement and measure, and every parent it names is declared
    Given the model in app/src/Quality.lex.tex
    When the Lean kernel checks qualityModelHolds during prismpm verify
    Then the ISO/IEC 25010 quality model numbers every characteristic, subcharacteristic, requirement and measure, and every parent it names is declared
  @SD-07 @build
  Scenario: Every compliance obligation is numbered in order and names its evidence
    Given the model in app/src/Compliance.lex.tex
    When the Lean kernel checks everyObligationEvidenced during prismpm verify
    Then every compliance obligation is numbered in order and names its evidence
crates/conformance/tests/site_docs_sync.rs 132 lines
//! The `site_docs_sync` suite: one test per scenario in `features/suites/site_docs_sync.feature`.
//!
//! Written by the Prism-DevRel builder from the app's prompt. The theorems are
//! checked by the Lean kernel when `just vv` runs `prismpm verify` on `app/`.
//! What these tests hold fixed is what each theorem is about, so a weakened
//! statement that still verifies fails the gate.

use std::path::PathBuf;

fn root() -> PathBuf {
    PathBuf::from(env!("CARGO_MANIFEST_DIR"))
        .ancestors()
        .nth(2)
        .expect("crates/conformance is two below the root")
        .to_path_buf()
}

/// The body of the top-level declaration named `name`, up to its closing brace.
fn declaration<'a>(model: &'a str, name: &str) -> &'a str {
    let start = model
        .find(&format!("\n  name: {name},\n"))
        .unwrap_or_else(|| panic!("{name} is not declared"));
    let end = model[start..]
        .find("\n}\n")
        .unwrap_or_else(|| panic!("{name} is not closed"));
    &model[start..start + end]
}

fn module(path: &str) -> String {
    std::fs::read_to_string(root().join(path)).expect("the module")
}

/// The condition no request may meet, and the theorem that says none does.
fn pinned(breaks: &str, condition: &str, theorem: &str) {
    let model = module("app/src/SiteDocsSyncProofs.lex.tex");
    let found = declaration(&model, breaks);
    assert!(
        found.contains(condition),
        "the condition of {breaks} changed:\n{found}"
    );
    let holds = declaration(&model, theorem);
    let statement = format!("statement: (({breaks} request) = false),");
    assert!(
        holds.contains(&statement),
        "{theorem} must state that no request meets {breaks}:\n{holds}"
    );
}

/// A facet theorem: proved by `decide`, about exactly this predicate.
fn holds(path: &str, theorem: &str, statement: &str) {
    let model = module(path);
    let found = declaration(&model, theorem);
    assert!(
        found.contains(&format!("statement: {statement},")),
        "{theorem} must state {statement}:\n{found}"
    );
    assert!(
        found.contains("proof: decide{}"),
        "{theorem} is proved by decide"
    );
}

/// `SD-01`: The app never answers redeploy when pages equals 0
#[test]
fn site_docs_sync_sd_01() {
    pinned(
        "breaksInv001",
        "body: ((((((((project request branch) <? 2) && ((project request seed) <? 2)) && ((project request pages) <=? 10000)) && ((project request package) <? 4)) && ((project request changed) <? 2)) && ((project request pages) =? 0)) && ((SiteDocsSync::judge request) =? (SiteDocsSync::answerRedeploy)))",
        "inv001Holds",
    );
}

/// `SD-02`: The app never answers redeploy when package is mismatch
#[test]
fn site_docs_sync_sd_02() {
    pinned(
        "breaksInv002",
        "body: ((((((((project request branch) <? 2) && ((project request seed) <? 2)) && ((project request pages) <=? 10000)) && ((project request package) <? 4)) && ((project request changed) <? 2)) && ((project request package) =? (SiteDocsSync::packageMismatch))) && ((SiteDocsSync::judge request) =? (SiteDocsSync::answerRedeploy)))",
        "inv002Holds",
    );
}

/// `SD-03`: The app never answers redeploy when changed is no
#[test]
fn site_docs_sync_sd_03() {
    pinned(
        "breaksInv003",
        "body: ((((((((project request branch) <? 2) && ((project request seed) <? 2)) && ((project request pages) <=? 10000)) && ((project request package) <? 4)) && ((project request changed) <? 2)) && ((project request changed) =? (SiteDocsSync::changedNo))) && ((SiteDocsSync::judge request) =? (SiteDocsSync::answerRedeploy)))",
        "inv003Holds",
    );
}

/// `SD-04`: The app always answers keep when branch is absent and seed is no
#[test]
fn site_docs_sync_sd_04() {
    pinned(
        "breaksInv004",
        "body: (((((((((project request branch) <? 2) && ((project request seed) <? 2)) && ((project request pages) <=? 10000)) && ((project request package) <? 4)) && ((project request changed) <? 2)) && ((project request branch) =? (SiteDocsSync::branchAbsent))) && ((project request seed) =? (SiteDocsSync::seedNo))) && (not ((SiteDocsSync::judge request) =? (SiteDocsSync::answerKeep))))",
        "inv004Holds",
    );
}

/// `SD-05`: The architecture description declares every stakeholder, concern, component, edge, viewpoint and view it references
#[test]
fn site_docs_sync_sd_05() {
    holds(
        "app/src/Architecture.lex.tex",
        "architectureDescriptionHolds",
        "((architectureValid) = true)",
    );
}

/// `SD-06`: The ISO/IEC 25010 quality model numbers every characteristic, subcharacteristic, requirement and measure, and every parent it names is declared
#[test]
fn site_docs_sync_sd_06() {
    holds(
        "app/src/Quality.lex.tex",
        "qualityModelHolds",
        "((qualityValid) = true)",
    );
}

/// `SD-07`: Every compliance obligation is numbered in order and names its evidence
#[test]
fn site_docs_sync_sd_07() {
    holds(
        "app/src/Compliance.lex.tex",
        "everyObligationEvidenced",
        "((obligationsEvidenced 0 (obligations)) = true)",
    );
}
site/app.json 114 lines
{
  "name": "Docs sync",
  "shortName": "Docs",
  "live": "https://uor-foundation.github.io/website/",
  "purpose": "Decide whether one run of the Prism docs sync keeps the current docs, refuses to overwrite them, finds nothing changed, or commits and redeploys the site, from the docs-site branch, the seed flag, the pages found, the prism-code package check and whether the generated files changed. Send branch, seed, pages, package or changed, separated by spaces; it answers keep, refuse, unchanged or redeploy, and invalid request for anything else.",
  "inputLabel": "Request: branch seed pages package changed",
  "placeholder": "present no 42 verified yes",
  "submitLabel": "Decide",
  "outputLabel": "Answer",
  "answers": {
    "positive": [
      "keep"
    ],
    "negative": [
      "refuse",
      "unchanged",
      "redeploy"
    ],
    "refusal": "invalid request"
  },
  "promise": {
    "headline": "Says conformant exactly when every policy file matches its lock.",
    "detail": "Each of the six universal policy files is compared with the digest the lock records, and any file that drifted is named."
  },
  "claim": "SD-01: the app never answers redeploy when pages equals 0. SD-02: the app never answers redeploy when package is mismatch. SD-03: the app never answers redeploy when changed is no. SD-04: the app always answers keep when branch is absent and seed is no.",
  "proposition": {
    "name": "judge",
    "text": "judge request :=\n  branch is absent and seed is no → keep\n  pages equals 0 → refuse\n  package is no-release → refuse\n  package is mismatch → refuse\n  package is no-skill → refuse\n  changed is no → unchanged\n  otherwise → redeploy",
    "plain": "Decide whether one run of the Prism docs sync keeps the current docs, refuses to overwrite them, finds nothing changed, or commits and redeploys the site, from the docs-site branch, the seed flag, the pages found, the prism-code package check and whether the generated files changed."
  },
  "theorems": [
    {
      "name": "inv001Holds",
      "statement": "no request meets breaksInv001: the app never answers redeploy when pages equals 0",
      "how": "Proved by linear arithmetic, checked by the Lean kernel on the UOR MCP server and again by prismpm verify in CI",
      "where": "app/src/SiteDocsSyncProofs.lex.tex"
    },
    {
      "name": "inv002Holds",
      "statement": "no request meets breaksInv002: the app never answers redeploy when package is mismatch",
      "how": "Proved by linear arithmetic, checked by the Lean kernel on the UOR MCP server and again by prismpm verify in CI",
      "where": "app/src/SiteDocsSyncProofs.lex.tex"
    },
    {
      "name": "inv003Holds",
      "statement": "no request meets breaksInv003: the app never answers redeploy when changed is no",
      "how": "Proved by linear arithmetic, checked by the Lean kernel on the UOR MCP server and again by prismpm verify in CI",
      "where": "app/src/SiteDocsSyncProofs.lex.tex"
    },
    {
      "name": "inv004Holds",
      "statement": "no request meets breaksInv004: the app always answers keep when branch is absent and seed is no",
      "how": "Proved by linear arithmetic, checked by the Lean kernel on the UOR MCP server and again by prismpm verify in CI",
      "where": "app/src/SiteDocsSyncProofs.lex.tex"
    }
  ],
  "pinned": [
    {
      "name": "site_docs_sync_sd_01",
      "what": "SD-01's condition and the theorem that no request meets it. A string-matching test, not a theorem: a planted defect fails it.",
      "where": "crates/conformance/tests/site_docs_sync.rs"
    },
    {
      "name": "site_docs_sync_sd_02",
      "what": "SD-02's condition and the theorem that no request meets it. A string-matching test, not a theorem: a planted defect fails it.",
      "where": "crates/conformance/tests/site_docs_sync.rs"
    },
    {
      "name": "site_docs_sync_sd_03",
      "what": "SD-03's condition and the theorem that no request meets it. A string-matching test, not a theorem: a planted defect fails it.",
      "where": "crates/conformance/tests/site_docs_sync.rs"
    },
    {
      "name": "site_docs_sync_sd_04",
      "what": "SD-04's condition and the theorem that no request meets it. A string-matching test, not a theorem: a planted defect fails it.",
      "where": "crates/conformance/tests/site_docs_sync.rs"
    }
  ],
  "trusted": [
    {
      "name": "SDK image",
      "value": "the digest prismpm.lock pins; see the bootstrap workflow's log"
    },
    {
      "name": "Lean toolchain",
      "value": "leanprover/lean4:v4.32.1"
    },
    {
      "name": "LexLean compiler semantics",
      "value": "5262e5b4c8b5668ae7066ad686757a6bb7f80c941d515fb9d586894fbc7de69a"
    },
    {
      "name": "prism-code runtime, vendored",
      "value": "0.2.0, see try/vendor/prism-code/VENDOR.md"
    },
    {
      "name": "Your browser",
      "value": "runs the WebAssembly guest and this page"
    }
  ],
  "attestations": {
    "proof": {
      "id": "not recorded: the proof ran in the SDK image, not on the UOR MCP server",
      "url": "https://github.com/UOR-Foundation/website/actions/workflows/bootstrap.yml"
    },
    "build": {
      "id": "printed by prismpm verify in every pages run",
      "url": "https://github.com/UOR-Foundation/website/actions/workflows/pages.yml"
    }
  },
  "repository": "https://github.com/UOR-Foundation/website",
  "report": "https://github.com/UOR-Foundation/website/blob/main/TEMPLATE-VERIFICATION.md"
}
openspec/specs/site-docs-sync/spec.md 196 lines
# site-docs-sync Specification

<!-- Generated by Prism from prism/spec.json. Change the app through your agent with /prism, not by editing this file. -->

## Purpose

Docs sync: Decide whether one run of the Prism docs sync keeps the current docs, refuses to overwrite them, finds nothing changed, or commits and redeploys the site, from the docs-site branch, the seed flag, the pages found, the prism-code package check and whether the generated files changed.

## Requirements

### Requirement: Never redeploy when pages equals 0

The app SHALL NOT answer `redeploy` when pages equals 0, because an empty docs tree never replaces the published docs.

Verified: to be proved by Lean for every request (INV-001, theorem `inv001Holds`).

#### Scenario: INV-001 holds

- **WHEN** the request is `absent no 0 no-release yes` (an acceptance example)
- **THEN** the answer SHALL NOT be `redeploy`
- **AND** the app answers `keep`, decided by REQ-001

### Requirement: Never redeploy when package is mismatch

The app SHALL NOT answer `redeploy` when package is mismatch, because a tarball that fails its integrity never sets the versions or skill the site states.

Verified: to be proved by Lean for every request (INV-002, theorem `inv002Holds`).

#### Scenario: INV-002 holds

- **WHEN** the request is `present no 42 mismatch yes` (an acceptance example)
- **THEN** the answer SHALL NOT be `redeploy`
- **AND** the app answers `refuse`, decided by REQ-004

### Requirement: Never redeploy when changed is no

The app SHALL NOT answer `redeploy` when changed is no, because the site is redeployed only when the docs changed.

Verified: to be proved by Lean for every request (INV-003, theorem `inv003Holds`).

#### Scenario: INV-003 holds

- **WHEN** the request is `present no 42 verified no` (an acceptance example)
- **THEN** the answer SHALL NOT be `redeploy`
- **AND** the app answers `unchanged`, decided by REQ-006

### Requirement: Always keep when branch is absent and seed is no

The app SHALL answer `keep` when branch is absent and seed is no, because without the branch, and without --seed, the docs are kept.

Verified: to be proved by Lean for every request (INV-004, theorem `inv004Holds`).

#### Scenario: INV-004 holds

- **WHEN** the request is `absent no 0 no-release yes` (an acceptance example)
- **THEN** the answer SHALL be `keep`
- **AND** the app answers `keep`, decided by REQ-001

### Requirement: REQ-001 keep when branch is absent and seed is no

The app SHALL answer `keep` when branch is absent and seed is no, because scripts/sync-prism-docs.mjs: docs-site branch not found; keeping current docs.

Verified: tested by the acceptance vectors (`rule1`).

#### Scenario: REQ-001 decides

- **WHEN** the request is `absent no 0 no-release yes` (an acceptance example)
- **THEN** the answer SHALL be `keep`, decided by REQ-001

### Requirement: REQ-002 refuse when pages equals 0

The app SHALL answer `refuse` when pages equals 0 and no earlier rule matches, because scripts/sync-prism-docs.mjs: No pages found; refusing to overwrite the current docs.

Verified: tested by the acceptance vectors (`rule2`).

#### Scenario: REQ-002 decides

- **WHEN** the request is `present no 0 verified yes` (an acceptance example)
- **THEN** the answer SHALL be `refuse`, decided by REQ-002

### Requirement: REQ-003 refuse when package is no-release

The app SHALL answer `refuse` when package is no-release and no earlier rule matches, because scripts/sync-prism-docs.mjs: npm registry gave no prism-code latest release; refusing to overwrite the current docs.

Verified: tested by the acceptance vectors (`rule3`).

#### Scenario: REQ-003 decides

- **WHEN** the request is `present no 1 no-release yes`
- **THEN** the answer SHALL be `refuse`, decided by REQ-003

### Requirement: REQ-004 refuse when package is mismatch

The app SHALL answer `refuse` when package is mismatch and no earlier rule matches, because scripts/sync-prism-docs.mjs: the prism-code tarball does not match its registry integrity.

Verified: tested by the acceptance vectors (`rule4`).

#### Scenario: REQ-004 decides

- **WHEN** the request is `present no 42 mismatch yes` (an acceptance example)
- **THEN** the answer SHALL be `refuse`, decided by REQ-004

### Requirement: REQ-005 refuse when package is no-skill

The app SHALL answer `refuse` when package is no-skill and no earlier rule matches, because scripts/sync-prism-docs.mjs: the site publishes the package's skill/SKILL.md byte for byte, and refuses a release without one.

Verified: tested by the acceptance vectors (`rule5`).

#### Scenario: REQ-005 decides

- **WHEN** the request is `present no 42 no-skill yes` (an acceptance example)
- **THEN** the answer SHALL be `refuse`, decided by REQ-005

### Requirement: REQ-006 unchanged when changed is no

The app SHALL answer `unchanged` when changed is no and no earlier rule matches, because .github/workflows/sync-prism-docs.yml: git diff --quiet on the generated files, then No changes.

Verified: tested by the acceptance vectors (`rule6`).

#### Scenario: REQ-006 decides

- **WHEN** the request is `present no 42 verified no` (an acceptance example)
- **THEN** the answer SHALL be `unchanged`, decided by REQ-006

### Requirement: Otherwise redeploy

The app SHALL answer `redeploy` when no rule matches, because .github/workflows/sync-prism-docs.yml: commit the generated files, push, and gh workflow run deploy.yml --ref main.

Verified: tested by the acceptance vectors.

#### Scenario: No rule matches

- **WHEN** the request is `present no 42 verified yes` (an acceptance example)
- **THEN** the answer SHALL be `redeploy`

### Requirement: The first matching rule decides

The app SHALL try REQ-001, REQ-002, REQ-003, REQ-004, REQ-005, REQ-006 in that order, and the first rule that matches SHALL decide.

Verified: tested by the acceptance vectors.

#### Scenario: Two rules match

- **WHEN** the request is `absent no 0 no-release yes` (an acceptance example)
- **THEN** the answer SHALL be `keep`, decided by REQ-001, the earlier rule

### Requirement: Request and answers

The app SHALL read one request as one line of 5 fields separated by single spaces, in this order, and SHALL answer exactly one of `keep`, `refuse`, `unchanged`, `redeploy`, or `invalid` for anything else.

| Field | Accepts | Means |
| --- | --- | --- |
| `branch` | `present`, `absent` | whether the docs-site branch of UOR-Foundation/PrismPM exists |
| `seed` | `no`, `yes` | whether the run passes --seed, the one-time import from main's docs/generated |
| `pages` | whole number from 0 up to 10000 | Markdown pages found under get-started, guides, api, reference, sdks, concepts, examples or migration |
| `package` | `verified`, `no-release`, `mismatch`, `no-skill` | the prism-code npm latest check: verified, no latest release, tarball not matching its registry integrity, or no skill/SKILL.md in it |
| `changed` | `yes`, `no` | whether the generated prism, npm and requests files differ from main |

| Answer | Means |
| --- | --- |
| `keep` | exit 0 keeping the current docs |
| `refuse` | the sync throws and the current docs are not overwritten |
| `unchanged` | No changes, nothing committed |
| `redeploy` | commit the generated files and run deploy.yml on main |
| `invalid` | the request is malformed |

Verified: reading a request is tested, not proved.

#### Scenario: A malformed request is invalid

- **WHEN** the request is not 5 fields in this order
- **THEN** the answer SHALL be `invalid`

## Examples

- `present no 42 verified yes` gives `redeploy`
- `present no 42 verified no` gives `unchanged`
- `absent no 0 no-release yes` gives `keep`
- `absent yes 12 verified yes` gives `redeploy`
- `present no 0 verified yes` gives `refuse`
- `present no 42 mismatch yes` gives `refuse`
- `present no 42 no-skill yes` gives `refuse`

## What is proved and what is tested

Lean proves each property marked proved above, for every request that decodes, with no exceptions and no sampling. The proof is about `judge`, the function the WebAssembly guest runs, because both come from the same model.

The parsing of requests is tested, not proved: the acceptance vectors in the app replay through the built guest, including malformed and oversized requests.

Nothing here says the rules are the right rules. That is the part only you can judge.

## Files

- `prism/spec.json` is this spec as data.
- `src/SiteDocsSync.lex.tex` is the LexLean model generated from it. It is the single source of the app.

how-to guideBuildexampleMarkdown

Words on this page 7
record
One entry in a facet: a component, a threat, a measure or a journey step, with the place in the source it came from.
Lean kernel
The small checker at the heart of the Lean prover. It accepts a proof only if every step follows the rules.
theorem
A statement about the model that the Lean kernel has checked, so it holds for every input, not only the ones tested.
SDK
Software development kit. Here, the PrismPM container image that builds, checks and verifies Prism models.
stakeholder
A person or group with an interest in the system, as ISO/IEC/IEEE 42010 defines it.
UOR
Universal Object Reference: the UOR Foundation's framework for naming any object by its content.
decision table
A table of rules, as in OMG DMN 1.5: each row says which inputs lead to which outcome.