Zorp intelligence

Monitor evidence

Zorp Monitor Runbook

Receipt-safe contract for turning Zorp/Nockchain monitor output into classified findings, routed Nocksperimental updates, and verification commands without importing raw state artifacts.

Automation
monitor-zorp-and-nockchain-sources
Cadence
HOURLY;INTERVAL=6
Repos
10
Commit
33ba97b1e206

Monitor Run Contract

automationId

monitor-zorp-and-nockchain-sources

supersededAutomationIds

watch-vesl-drive-folder, watch-zorp-nockchain-repos-and-state-jams, zorp-nockchain-watch

workspace

/home/kgbrah/nocklab/nocksperimental

stateJamDrive

Zorp/Nockchain state-jam folder, not a VESL folder.

Watched Sources

highlightedWatchedSourceIds

zorp-github-org, zorp-nockchain-legacy-redirect, canonical-nockchain-repository, zorp-state-jam-drive

zorp-github-org

kind

github-org

authority

lineage-and-authoring-signal

url

https://github.com/zorp-corp

zorp-nockchain-legacy-redirect

kind

github-redirect

authority

legacy-redirect

url

https://github.com/zorp-corp/nockchain

canonical-nockchain-repository

kind

github-repo

authority

canonical-protocol-authority

url

https://github.com/nockchain/nockchain

zorp-state-jam-drive

kind

google-drive-folder

authority

state-artifact-provenance

url

https://drive.google.com/drive/folders/1aEYZwmg4isTuYXWFn9gKPl92-pYndwUw

Finding Schema

requiredFields

monitorRunId, observedAt, upstreamSourceUrl, sourceAuthority, sourceKind, repoFullName, commitShaOrArtifactHash, affectedPaths, changeSummary, receiptImpact, operatorAction, nocksperimentalSurface, verificationCommand, rawArtifactPolicy, decision

highlightedFields

upstreamSourceUrl, sourceAuthority, nocksperimentalSurface, verificationCommand, rawArtifactPolicy

forbiddenFields

rawStateJam, rawPmaSlab, rawEventLog, rawCheckpoint, rawWalletExport, walletSeedPhrase, walletPrivateKey, privateSpendKey, privateGrpcPokePayload, oauthToken

highlightedForbidden

rawStateJam, rawPmaSlab, walletSeedPhrase

Classification Flow

collect-current-state

Collect current state

Fetch Zorp repository inventory, canonical Nockchain commit/release metadata, legacy redirect state, and Drive-folder metadata visibility.

classify-source-authority

Classify source authority

Classify each change as canonical Nockchain authority, Zorp authoring, Zorp lineage, state-artifact provenance, or low-signal tooling.

compare-pinned-snapshot

Compare pinned snapshot

Compare against the pinned Nocksperimental snapshot and record whether assumptions are in-sync or require review.

route-to-nocksperimental-surface

Route to Nocksperimental surface

Name the specific atlas, source trace, receipt contract, runbook, or documentation surface that should change.

record-receipt-safe-finding

Record receipt-safe finding

Preserve source URL, repo, commit/artifact hash, affected path, impact, and verification command while excluding raw state and secrets.

verify-before-trust

Verify before trust

Run the narrowest affected Nocksperimental tests before treating a monitor finding as an accepted product assumption.

Route Matrix

canonical-nockchain-runtime

authorities

canonical-protocol-authority, canonical-nockchain-runtime

targetSurfaces

nockchainWatch, nockchainProtocolTrace, nockchainRustAtlas, nockchainRuntimeSafety, nockchainMiningSourceTrace, nockchainSyncGossipTrace, nockchainApiSourceTrace

verificationCommands

npm run test:nockchain-watch, npm run test:nockchain-mining-source-api, npm run test:nockchain-sync-gossip-trace

zorp-authoring-fixtures

authorities

zorp-authoring-signal, lineage-and-authoring-signal

targetSurfaces

nockupValidation, generatedLabReports, fixtureDocs, zorpUpstream

verificationCommands

npm run test:zorp-upstream-api, npm run test:nockup-validation, npm run test:generated-reports

state-jam-artifacts

authorities

state-artifact-provenance, zorp-state-jam-metadata

targetSurfaces

stateJamRegistry, nockchainPmaSourceTrace, localFakenetEvidence, nockchainOperationsAtlas

verificationCommands

npm run test:nockchain-state-jams-api, npm run test:nockchain-pma-source-api, npm run test:local-fakenet-evidence-api

lineage-runtime-context

authorities

zorp-public-repo-lineage, lineage-and-authoring-signal

targetSurfaces

zorpUpstream, nockchainNockAppAtlas, nockchainNockAppSourceTrace, docsResearch

verificationCommands

npm run test:zorp-upstream-api, npm run test:zorp-intelligence-page, npm run test:nockchain-nockapp-source-api

State-Jam Inventory Contract

nonVeslEvidenceBoundary

Do not route Drive changes as VESL evidence; route them as Nockchain state-artifact provenance.

rawArtifactPolicy

never-store-raw-artifact

highlightedMetadata

artifactSha256, producingNockchainBuild, heightOrEventBoundary

targetSurfaces

stateJamRegistry, nockchainPmaSourceTrace, localFakenetEvidence, nockchainOperationsAtlas, registryCheckpoint

requiredMetadata

driveFolderId

requiredMetadata

sourceUrl

requiredMetadata

artifactName

requiredMetadata

artifactBytes

requiredMetadata

artifactSha256

requiredMetadata

network

requiredMetadata

heightOrEventBoundary

requiredMetadata

producer

requiredMetadata

producingNockchainBuild

requiredMetadata

consumerNockchainBuild

requiredMetadata

custodyNotes

highlightedOperatorAction

Inventory Drive contents manually or through an authenticated connector without downloading raw state artifacts into the repo.

operatorAction

Inventory Drive contents manually or through an authenticated connector without downloading raw state artifacts into the repo.

operatorAction

Record filename, size, hash, network, height or event boundary, producer, and producing Nockchain build before trusting a bootstrap artifact.

operatorAction

Route any changed artifact inventory to state-jam, PMA, local fakenet evidence, and registry checkpoint surfaces before using it in tests.

highlightedVerificationCommand

npm run test:nockchain-state-jams-page

highlightedVerificationCommand

npm run test:registry-checkpoint-api

verificationCommand

npm run test:nockchain-state-jams-api

verificationCommand

npm run test:nockchain-state-jams-page

verificationCommand

npm run test:nockchain-pma-source-api

verificationCommand

npm run test:local-fakenet-evidence-api

verificationCommand

npm run test:registry-checkpoint-api

Highlighted Route Targets

targetSurface

nockchainMiningSourceTrace

targetSurface

nockchainPmaSourceTrace

Monitor Classes

canonical-nockchain

immediate

targetSurfaces

nockchainWatch, nockchainKnowledgeSpine, nockchainProtocolTrace, nockchainReleaseAssets

requiredAction

Refresh upstream commit/build provenance and rerun the affected Nockchain atlas or trace tests before accepting new receipts.

zorp-authoring

review

targetSurfaces

nockupValidation, generatedLabReports, fixtureDocs

requiredAction

Review fixture assumptions and promote only reusable Jock/NockApp authoring patterns into Nocksperimental tests.

zorp-lineage

context-only

targetSurfaces

zorpUpstream, nockchainWatch, docsResearch

requiredAction

Update lineage notes only when they clarify NockApp fixture language, PMA/state interpretation, or Nock semantics.

state-artifact-provenance

immediate

targetSurfaces

stateJamRegistry, localFakenetEvidence, nockchainOperationsAtlas

requiredAction

Inventory source URL, filename, hash, size, network, height or event boundary, and producing build without storing raw artifacts.

Freshness Probes

snapshotCommand

node scripts/run-zorp-monitor-snapshot.mjs --json

verificationCommand

node scripts/run-zorp-monitor-snapshot.mjs --json

verificationCommand

npm run check:zorp-org-drift -- --json

verificationCommand

npm run test:zorp-monitor-runbook-api

verificationCommand

npm run test:zorp-monitor-runbook-page

verificationCommand

npm run test:nockchain-watch

verificationCommand

npm run test:zorp-upstream-api

Monitor Run Templates

zorp-org-repo-update

sourceId

zorp-github-org

rawArtifactPolicy

metadata-only

requiredEvidence

repoFullName, updatedAt, pushedAt, archived, fork, primarySignal

zorp-org-drift-check

sourceId

zorp-github-org

rawArtifactPolicy

metadata-only

requiredEvidence

repoFullName, updatedAt, pushedAt, defaultBranch, driftField, operatorAction

canonical-nockchain-release

sourceId

canonical-nockchain-repository

rawArtifactPolicy

source-metadata-only

requiredEvidence

commitSha, releaseTag, publishedAt, affectedPaths, targetSurfaces

drive-state-jam-artifact

sourceId

zorp-state-jam-drive

rawArtifactPolicy

never-store-raw-artifact

requiredEvidence

sourceUrl, filename, size, hash, network, heightOrEventBoundary, producingBuild