Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file modified Rule30-Core.pdf
Binary file not shown.
Binary file modified Rule30-Observations.pdf
Binary file not shown.
Binary file modified Rule30-Paper.pdf
Binary file not shown.
10 changes: 5 additions & 5 deletions pdf-manifest.json
Original file line number Diff line number Diff line change
@@ -1,18 +1,18 @@
{
"documents": {
"Core": {
"pdf_sha256": "c0d3552b926faeb1b74cbe6d36d407059a31e073a3907226751a780971c372f2",
"pdf_sha256": "99bfdc208dce94d81e4c4cbb4f24e4f56daaa006175b7d96799e2f79ff24b98e",
"tex_sha256": "a7cd1807077baa1d1ca34015faf500a24477991859427f4db646e5f230fe54e2"
},
"Observations": {
"pdf_sha256": "2a984eee66578dc5dd22049b2dbb0c5d5de652afacd227530771499bf2bc4d62",
"pdf_sha256": "946c0151ff19b9bea418524c9184fd2614ed1d0d8786be167e69be79fadd53c5",
"tex_sha256": "056820f37ac40133e341f46ad6c81125e35981150a1cc86f2063faad3f26fbd4"
},
"Paper": {
"pdf_sha256": "b4e861207713fc915b1f3e7cf8e981951a95cd73cd8968f1d11a6df84e7d00dc",
"pdf_sha256": "29083b380af1b4ba59d478e8f8b1defaa41df051d44a49bc6f1f487a403e774e",
"tex_sha256": "000f988561d9621f9ba2f9a99aba971670864367ebd336e6fbad0e1f71da01cb"
}
},
"generated_at_utc": "2026-11-14T10:01:11.420998+00:00",
"source_digest": "f97eb4afb83521401b5665cd9e9eaba18116700500fd6e3924de66a18cca0ea8"
"generated_at_utc": "2026-11-14T22:17:42.029985+00:00",
"source_digest": "fc66c209c514b0c616f3dea01ec778f54dd19356d13c2c780d455710262fe4b9"
}
9 changes: 9 additions & 0 deletions rule30-api/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -708,3 +708,12 @@ bin/r30 api production --targets # the compiler's target descriptors
bin/r30 verify api # lexlean verify of the API modules (about five minutes; Convert.lex.tex decides 28 conversions, Rule30Core.lex.tex the first rows)
bin/r30 view render [--out DIR] # the current view (the site, statements.json, explainer.json, rule30.svg, the PDFs)
```

## Explicit multi-source memory plans

The additive [environment-plan command](production/ENVIRONMENT-PLAN.md) validates
1–8 pinned source entries before acquiring them sequentially and replacing the
store once. Query operates without checkouts and returns only listed keys in plan
order, with the complete task unchanged and observations carrying no proof authority.
The existing single-source command remains available. The plan increment is
awaiting independent review and qualification.
38 changes: 38 additions & 0 deletions rule30-api/examples/environment-plan-ingest.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
{
"spec": "r30/environment-plan/1",
"operation": "ingest",
"task": {
"id": "memory-interface-example",
"purpose": "prove",
"intent": "prove",
"status": "ready",
"component": "deduction",
"sources": [],
"schema": "Host request constructors",
"sequent": {
"origin": "InterfaceExample.goal",
"theorem": "InterfaceExample.goal",
"premise": 0,
"telescope": "",
"target": "UNVERIFIED INTERFACE FIXTURE: replace with the exact task target",
"kind": "closed"
},
"age": 0,
"weight": 1
},
"query": "Request",
"sources": [
{
"repository": "afflom/rule30",
"revision": "e3be477fded263029479127363f7fb6a3597e7d4",
"path": "lexlean-stdlib/src/Host.lex.tex",
"local_repository": "."
},
{
"repository": "UOR-Foundation/LexLean",
"revision": "9fd01c31e40bb29577833825f902fafcceedb49a",
"path": "examples/production/README.md",
"local_repository": "../LexLean"
}
]
}
36 changes: 36 additions & 0 deletions rule30-api/examples/environment-plan-query.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
{
"spec": "r30/environment-plan/1",
"operation": "query",
"task": {
"id": "memory-interface-example",
"purpose": "prove",
"intent": "prove",
"status": "ready",
"component": "deduction",
"sources": [],
"schema": "Host request constructors",
"sequent": {
"origin": "InterfaceExample.goal",
"theorem": "InterfaceExample.goal",
"premise": 0,
"telescope": "",
"target": "UNVERIFIED INTERFACE FIXTURE: replace with the exact task target",
"kind": "closed"
},
"age": 0,
"weight": 1
},
"query": "Request",
"sources": [
{
"repository": "afflom/rule30",
"revision": "e3be477fded263029479127363f7fb6a3597e7d4",
"path": "lexlean-stdlib/src/Host.lex.tex"
},
{
"repository": "UOR-Foundation/LexLean",
"revision": "9fd01c31e40bb29577833825f902fafcceedb49a",
"path": "examples/production/README.md"
}
]
}
2 changes: 1 addition & 1 deletion rule30-api/lexlean.lock
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
spec = "lexlean/lock/2"
language = "1.2"
compiler_semantics = "59f64efe727898bcf6a337630c38eb4ea7ffc08cd83a49a0ea669c61c3b23587"
project_config_sha256 = "163e328801aa738fabc9a0fb01059000b9bf81d003e2ffa0473fc96869fcda70"
project_config_sha256 = "a3a5a5708da7bc4dfaacf3cd2a52e3d8558e7937d1cc876bc6973558b31acb29"
lean_toolchain = "leanprover/lean4:v4.32.2"

[[workspace_file]]
Expand Down
2 changes: 1 addition & 1 deletion rule30-api/lexlean.toml
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ name = "rule30-api"
language = "1.2"
module_prefix = "Rule30Api"
source_roots = ["src", "stdlib"]
entrypoints = ["src/Api.lex.tex", "src/Application.lex.tex", "src/Architecture.lex.tex", "src/ArtifactIdentity.lex.tex", "src/ArtifactIdentityTraces.lex.tex", "src/Audit.lex.tex", "src/BindingFixture.lex.tex", "src/CandidateBinding.lex.tex", "src/CandidateBindingTraces.lex.tex", "src/CandidateSource.lex.tex", "src/CandidateSourceChecks0.lex.tex", "src/CandidateSourceChecks1.lex.tex", "src/CandidateSourceChecks2.lex.tex", "src/CandidateSourceChecks3.lex.tex", "src/CandidateSourceTraces.lex.tex", "src/ClosedBindingFixture.lex.tex", "src/ClosedGoalChecks0.lex.tex", "src/ClosedGoalChecks1.lex.tex", "src/ClosedGoalChecks2.lex.tex", "src/ClosedGoalChecks3.lex.tex", "src/ClosedGoalChecks4.lex.tex", "src/ClosedGoalChecks5.lex.tex", "src/ClosedGoalTraces.lex.tex", "src/CompilerSnapshot.lex.tex", "src/CompilerSnapshotTraces.lex.tex", "src/Convert.lex.tex", "src/CoreBinding.lex.tex", "src/CoreBindingTraces.lex.tex", "src/CoreNotation.lex.tex", "src/CoreNotationTraces.lex.tex", "src/Discovery.lex.tex", "src/Engine.lex.tex", "src/EnvironmentAcquisition.lex.tex", "src/EnvironmentMemory.lex.tex", "src/EnvironmentMemoryCommand.lex.tex", "src/EnvironmentMemoryTraces.lex.tex", "src/Host.lex.tex", "src/Hypotheses.lex.tex", "src/Json.lex.tex", "src/JsonCanonical.lex.tex", "src/JsonCanonicalTraces.lex.tex", "src/JsonTraces.lex.tex", "src/Observer.lex.tex", "src/Presentation.lex.tex", "src/R30.lex.tex", "src/R30Traces.lex.tex", "src/R30TracesClaims.lex.tex", "src/R30TracesForms.lex.tex", "src/R30TracesRegister.lex.tex", "src/Register.lex.tex", "src/Research.lex.tex", "src/ResearchArchitecture.lex.tex", "src/ResearchCandidate.lex.tex", "src/ResearchCandidateTraces.lex.tex", "src/ResearchCatalog.lex.tex", "src/ResearchCohort.lex.tex", "src/ResearchCohortChecks0.lex.tex", "src/ResearchCohortChecks1.lex.tex", "src/ResearchCohortChecks2.lex.tex", "src/ResearchCohortCommand.lex.tex", "src/ResearchCohortInput.lex.tex", "src/ResearchCohortTraces.lex.tex", "src/ResearchCommand.lex.tex", "src/ResearchCommandTraces.lex.tex", "src/ResearchEvidence.lex.tex", "src/ResearchEvidenceTraces.lex.tex", "src/ResearchExecution.lex.tex", "src/ResearchExecutionTraces.lex.tex", "src/ResearchFactory.lex.tex", "src/ResearchFactoryTraces.lex.tex", "src/ResearchInput.lex.tex", "src/ResearchInputTraces.lex.tex", "src/ResearchJournal.lex.tex", "src/ResearchJournalTraces.lex.tex", "src/ResearchProject.lex.tex", "src/ResearchProjectTraces.lex.tex", "src/ResearchProof.lex.tex", "src/ResearchProofTraces.lex.tex", "src/ResearchRecord.lex.tex", "src/ResearchRunner.lex.tex", "src/ResearchRunnerTraces.lex.tex", "src/ResearchSession.lex.tex", "src/ResearchSessionTraces.lex.tex", "src/ResearchTraces.lex.tex", "src/ResearchVerification.lex.tex", "src/ResearchVerificationChecks0.lex.tex", "src/ResearchVerificationChecks1.lex.tex", "src/ResearchVerificationChecks2.lex.tex", "src/ResearchVerificationChecks3.lex.tex", "src/ResearchVerificationChecks4.lex.tex", "src/ResearchVerificationChecks5.lex.tex", "src/ResearchVerificationChecks6.lex.tex", "src/ResearchVerificationTraces.lex.tex", "src/ResearchWorkspace.lex.tex", "src/ResearchWorkspaceTraces.lex.tex", "src/Rule30Core.lex.tex", "src/Sequences.lex.tex", "src/Standards.lex.tex", "src/Toml.lex.tex", "src/VerificationCommandFixtures.lex.tex", "src/VerificationHashData.lex.tex", "src/VerificationHashFixtures.lex.tex", "src/VerificationHashSteps0.lex.tex", "src/VerificationHashSteps1.lex.tex", "src/VerificationHashSteps2.lex.tex", "src/VerificationHashSteps3.lex.tex", "src/VerificationHashSteps4.lex.tex", "src/VerificationHashSteps5.lex.tex", "src/VerificationIdentityTraces.lex.tex", "src/VerificationJsonData.lex.tex", "src/VerificationJsonFixtures.lex.tex", "src/VerificationJsonSteps0.lex.tex", "src/VerificationJsonSteps1.lex.tex", "src/VerificationJsonSteps10.lex.tex", "src/VerificationJsonSteps11.lex.tex", "src/VerificationJsonSteps2.lex.tex", "src/VerificationJsonSteps3.lex.tex", "src/VerificationJsonSteps4.lex.tex", "src/VerificationJsonSteps5.lex.tex", "src/VerificationJsonSteps6.lex.tex", "src/VerificationJsonSteps7.lex.tex", "src/VerificationJsonSteps8.lex.tex", "src/VerificationJsonSteps9.lex.tex", "src/VerificationMetadataChecks0.lex.tex", "src/VerificationMetadataChecks1.lex.tex", "src/VerificationMetadataTraces.lex.tex", "src/VerificationPolicyChecks0.lex.tex", "src/VerificationPolicyTraces.lex.tex", "src/VerificationProcessChecks0.lex.tex", "src/VerificationProcessTraces.lex.tex", "src/VerificationReport.lex.tex", "src/VerificationReportTraces.lex.tex", "src/VerificationUtf8Fixtures.lex.tex", "src/VerificationUtf8Steps0.lex.tex", "src/VerificationUtf8Steps1.lex.tex", "src/VerificationUtf8Steps2.lex.tex", "src/VerificationUtf8Steps3.lex.tex", "src/VerificationUtf8Steps4.lex.tex", "src/VerificationUtf8Steps5.lex.tex", "src/VerificationUtf8Steps6.lex.tex", "src/VerificationUtf8Steps7.lex.tex", "src/VerificationUtf8Steps8.lex.tex", "src/VerificationUtf8Steps9.lex.tex"]
entrypoints = ["src/Api.lex.tex", "src/Application.lex.tex", "src/Architecture.lex.tex", "src/ArtifactIdentity.lex.tex", "src/ArtifactIdentityTraces.lex.tex", "src/Audit.lex.tex", "src/BindingFixture.lex.tex", "src/CandidateBinding.lex.tex", "src/CandidateBindingTraces.lex.tex", "src/CandidateSource.lex.tex", "src/CandidateSourceChecks0.lex.tex", "src/CandidateSourceChecks1.lex.tex", "src/CandidateSourceChecks2.lex.tex", "src/CandidateSourceChecks3.lex.tex", "src/CandidateSourceTraces.lex.tex", "src/ClosedBindingFixture.lex.tex", "src/ClosedGoalChecks0.lex.tex", "src/ClosedGoalChecks1.lex.tex", "src/ClosedGoalChecks2.lex.tex", "src/ClosedGoalChecks3.lex.tex", "src/ClosedGoalChecks4.lex.tex", "src/ClosedGoalChecks5.lex.tex", "src/ClosedGoalTraces.lex.tex", "src/CompilerSnapshot.lex.tex", "src/CompilerSnapshotTraces.lex.tex", "src/Convert.lex.tex", "src/CoreBinding.lex.tex", "src/CoreBindingTraces.lex.tex", "src/CoreNotation.lex.tex", "src/CoreNotationTraces.lex.tex", "src/Discovery.lex.tex", "src/Engine.lex.tex", "src/EnvironmentAcquisition.lex.tex", "src/EnvironmentMemory.lex.tex", "src/EnvironmentMemoryCommand.lex.tex", "src/EnvironmentMemoryTraces.lex.tex", "src/EnvironmentPlan.lex.tex", "src/EnvironmentPlanCommand.lex.tex", "src/EnvironmentPlanTraces.lex.tex", "src/EnvironmentPlanWireTraces0.lex.tex", "src/EnvironmentPlanWireTraces1.lex.tex", "src/Host.lex.tex", "src/Hypotheses.lex.tex", "src/Json.lex.tex", "src/JsonCanonical.lex.tex", "src/JsonCanonicalTraces.lex.tex", "src/JsonTraces.lex.tex", "src/Observer.lex.tex", "src/Presentation.lex.tex", "src/R30.lex.tex", "src/R30Traces.lex.tex", "src/R30TracesClaims.lex.tex", "src/R30TracesForms.lex.tex", "src/R30TracesRegister.lex.tex", "src/Register.lex.tex", "src/Research.lex.tex", "src/ResearchArchitecture.lex.tex", "src/ResearchCandidate.lex.tex", "src/ResearchCandidateTraces.lex.tex", "src/ResearchCatalog.lex.tex", "src/ResearchCohort.lex.tex", "src/ResearchCohortChecks0.lex.tex", "src/ResearchCohortChecks1.lex.tex", "src/ResearchCohortChecks2.lex.tex", "src/ResearchCohortCommand.lex.tex", "src/ResearchCohortInput.lex.tex", "src/ResearchCohortTraces.lex.tex", "src/ResearchCommand.lex.tex", "src/ResearchCommandTraces.lex.tex", "src/ResearchEvidence.lex.tex", "src/ResearchEvidenceTraces.lex.tex", "src/ResearchExecution.lex.tex", "src/ResearchExecutionTraces.lex.tex", "src/ResearchFactory.lex.tex", "src/ResearchFactoryTraces.lex.tex", "src/ResearchInput.lex.tex", "src/ResearchInputTraces.lex.tex", "src/ResearchJournal.lex.tex", "src/ResearchJournalTraces.lex.tex", "src/ResearchProject.lex.tex", "src/ResearchProjectTraces.lex.tex", "src/ResearchProof.lex.tex", "src/ResearchProofTraces.lex.tex", "src/ResearchRecord.lex.tex", "src/ResearchRunner.lex.tex", "src/ResearchRunnerTraces.lex.tex", "src/ResearchSession.lex.tex", "src/ResearchSessionTraces.lex.tex", "src/ResearchTraces.lex.tex", "src/ResearchVerification.lex.tex", "src/ResearchVerificationChecks0.lex.tex", "src/ResearchVerificationChecks1.lex.tex", "src/ResearchVerificationChecks2.lex.tex", "src/ResearchVerificationChecks3.lex.tex", "src/ResearchVerificationChecks4.lex.tex", "src/ResearchVerificationChecks5.lex.tex", "src/ResearchVerificationChecks6.lex.tex", "src/ResearchVerificationTraces.lex.tex", "src/ResearchWorkspace.lex.tex", "src/ResearchWorkspaceTraces.lex.tex", "src/Rule30Core.lex.tex", "src/Sequences.lex.tex", "src/Standards.lex.tex", "src/Toml.lex.tex", "src/VerificationCommandFixtures.lex.tex", "src/VerificationHashData.lex.tex", "src/VerificationHashFixtures.lex.tex", "src/VerificationHashSteps0.lex.tex", "src/VerificationHashSteps1.lex.tex", "src/VerificationHashSteps2.lex.tex", "src/VerificationHashSteps3.lex.tex", "src/VerificationHashSteps4.lex.tex", "src/VerificationHashSteps5.lex.tex", "src/VerificationIdentityTraces.lex.tex", "src/VerificationJsonData.lex.tex", "src/VerificationJsonFixtures.lex.tex", "src/VerificationJsonSteps0.lex.tex", "src/VerificationJsonSteps1.lex.tex", "src/VerificationJsonSteps10.lex.tex", "src/VerificationJsonSteps11.lex.tex", "src/VerificationJsonSteps2.lex.tex", "src/VerificationJsonSteps3.lex.tex", "src/VerificationJsonSteps4.lex.tex", "src/VerificationJsonSteps5.lex.tex", "src/VerificationJsonSteps6.lex.tex", "src/VerificationJsonSteps7.lex.tex", "src/VerificationJsonSteps8.lex.tex", "src/VerificationJsonSteps9.lex.tex", "src/VerificationMetadataChecks0.lex.tex", "src/VerificationMetadataChecks1.lex.tex", "src/VerificationMetadataTraces.lex.tex", "src/VerificationPolicyChecks0.lex.tex", "src/VerificationPolicyTraces.lex.tex", "src/VerificationProcessChecks0.lex.tex", "src/VerificationProcessTraces.lex.tex", "src/VerificationReport.lex.tex", "src/VerificationReportTraces.lex.tex", "src/VerificationUtf8Fixtures.lex.tex", "src/VerificationUtf8Steps0.lex.tex", "src/VerificationUtf8Steps1.lex.tex", "src/VerificationUtf8Steps2.lex.tex", "src/VerificationUtf8Steps3.lex.tex", "src/VerificationUtf8Steps4.lex.tex", "src/VerificationUtf8Steps5.lex.tex", "src/VerificationUtf8Steps6.lex.tex", "src/VerificationUtf8Steps7.lex.tex", "src/VerificationUtf8Steps8.lex.tex", "src/VerificationUtf8Steps9.lex.tex"]
build_root = ".lexlean"
lockfile = "lexlean.lock"
lean_workspace = "."
Expand Down
72 changes: 72 additions & 0 deletions rule30-api/production/ENVIRONMENT-PLAN.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,72 @@
# Explicit environmental-memory plans

`EnvironmentPlanCommand.step` accepts a bounded corpus through one native Host
command. It supplements the unchanged single-source v1 command. It acquires
observations and returns context; it does not synthesize proofs, crawl GitHub,
or schedule Engine learning.

The executable takes `PRIVATE_STATE_DIRECTORY REQUEST.json`. The caller must
provide a private state directory and an outer execution deadline: lock acquisition
is blocking. Ingestion requires caller-owned local Git repositories. Query needs
only the store and a plan; it never opens those repositories.

The private directory reserves `git-output`, `git-errors`, `store.lock`,
`observations.pending`, and `observations.json`. These paths must not be symlinks
or hardlink aliases of one another or of other files. No competing writer or
adversarial filesystem mutation may touch them during an operation; cooperative
command callers must use the same lock. Inspect retained state and establish
child termination before retrying when cleanup is uncertain. Scratch-file changes
are not a store transaction, and an outer deadline does not establish cleanup.

The native Host driver handles requests synchronously. The pure step function
rejects incompatible event variants, but it does not authenticate arbitrary
forged or replayed responses of the expected variant. Its event protocol assumes
the owned synchronous driver; it is not an authenticated external event service.

The request schema is `r30/environment-plan/1` with exactly these fields:

- `spec`, `operation` (`ingest` or `query`), `task`, `query`, `sources`.
- `task` is the existing complete ready `Research.Task` request shape.
- `query` contains 1–128 bytes.
- `sources` contains 1–8 entries, in retrieval order.
- Each entry has `repository` (claimed owner/name), `revision` (40 lowercase
hexadecimal bytes), and `path` (1–256 safe relative-path bytes).
- Ingestion entries additionally require `local_repository`, a nonempty printable
ASCII path of at most 1024 bytes. Query entries omit that field entirely.

Unknown or duplicate JSON fields, invalid entries, and repeated source keys are
refused. A source key is the exact repository/revision/path triple. Repeating it
with a different local directory is also refused. The entire plan is validated
before locking or starting Git, including entries later in the list.

See `../examples/environment-plan-ingest.json` and
`../examples/environment-plan-query.json`. These are caller-adaptable examples,
not proof requests or successful acquisition receipts. Supply the actual local
checkout paths for ingestion. The example task's unverified target stays unverified.

The command holds the existing store lock and runs `EnvironmentAcquisition`
sequentially, preserving its no-network Git command, exact commit/path/blob
binding, ownership rules, and 4096-byte **whole-file** cap. It accumulates validated
observations in memory. A later acquisition failure or capacity/conflict refusal
performs no store replacement, retaining the prior `observations.json` bytes.
Git output scratch files may have changed and must remain private.

Only after all acquisitions succeed does it serialize once, write
`observations.pending`, rename it over `observations.json`, and require exact
validated readback before success. An unconfirmed replacement or readback is
reported as uncertain. No power-loss durability or fsync guarantee is claimed.
The existing store format, 32-record capacity and 1 MiB serialization/readback
bound are unchanged. Already-known observations remain idempotent.

Both operations return `r30/environment-context/1` with the unchanged task and
sequent, the `observed-sources-not-proof` trust label, and at most eight matching
observations. Only exact keys listed in the plan are eligible; results follow
plan order, independently of store order. Missing keys and nonmatching content
produce no observation; another revision or unselected path cannot substitute.
Repository labels do not authenticate a GitHub origin. Source text stays inert
and has no proof authority.

The production request is `environment-plan-request.json`, selecting only the
new `Rule30Api.EnvironmentPlanCommand.step` export. Official verification still
covers every configured obligation. This source increment is awaiting independent
review and kernel/native qualification; linked-IR checking alone is not acceptance.
18 changes: 18 additions & 0 deletions rule30-api/production/environment-plan-request.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
{
"spec": "lexlean/production-request/1",
"roots": [
{
"package": {
"name": "rule30_environment_plan",
"version": "0.1.0"
},
"root": "Rule30Api.EnvironmentPlanCommand.step",
"targets": [
{
"id": "rust-std",
"digest": "0f5802ea18121b6a7a0d03e999589ce4e5ae812dc2a358432c1bf024a8e53f9f"
}
]
}
]
}
Loading
Loading