Skip to content

Add completed doc on Iris goals - #19

Open
pgiarrusso-sl wants to merge 1 commit into
mainfrom
paolo/doc-goals
Open

pgiarrusso-sl wants to merge 1 commit into
mainfrom
paolo/doc-goals

Conversation

@pgiarrusso-sl

Copy link
Copy Markdown
Contributor

No description provided.

@skylabs-ai-ci

skylabs-ai-ci Bot commented May 19, 2026

Copy link
Copy Markdown

CI summary (Details)

Active Repos

Repo Job Branch Job Commit Base branch Base commit PR
fmdeps/auto-docs/ paolo/doc-goals 0ea5a96 main d4c3641 #19

Passive Repos

Repo Job Branch Job Commit
./ main 7d2ee30
fmdeps/BRiCk/ main f029bba
fmdeps/auto/ main 0d4c8c4
bluerock/NOVA/ skylabs-proof dc3d314
bluerock/bhv/ skylabs-main c46f5e3
fmdeps/brick-libcpp/ main 2014908
fmdeps/ci/ main 9e6e574
vendored/elpi/ skylabs-master aa4475f
vendored/flocq/ skylabs-master cf9cc84
fmdeps/fm-tools/ main e5188db
psi/protos/ main 8fe3e7c
psi/backend/ main 0b5fea6
psi/ide/ main 6b596cf
psi/data/ main 82cb305
vendored/rocq/ skylabs-master 2ede3c9
fmdeps/rocq-agent-toolkit/ main ac7e4ec
vendored/rocq-elpi/ skylabs-master 103a742
vendored/rocq-equations/ skylabs-main a8c4832
vendored/rocq-ext-lib/ skylabs-master 94a6630
vendored/rocq-iris/ skylabs-master 3ad4ddd
vendored/rocq-lsp/ skylabs-main a8b7272
vendored/rocq-stdlib/ skylabs-master bc07423
vendored/rocq-stdpp/ skylabs-master e01d802
fmdeps/skylabs-fm/ main e8b88a7
vendored/vsrocq/ skylabs-main 5b4527e

Performance

Relative Master MR Change Filename
-0.00% 127178.6 127178.6 -0.0 total
-0.00% 22690.6 22690.6 -0.0 ├ translation units
+0.00% 104488.0 104488.0 +0.0 └ proofs and tests
Full Results
Relative Master MR Change Filename
-0.00% 127178.6 127178.6 -0.0 total
-0.00% 22690.6 22690.6 -0.0 ├ translation units
+0.00% 104488.0 104488.0 +0.0 └ proofs and tests

Comment on lines +34 to +35
Iris assumptions can be named or anonymous. Tactics can use names to act on
specific hypotheses, but otherwise names are not meaningful.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

IIUC, sep-based tactics don't process named resources in the intuitionistic/spatial context. It's probably worth cross-linking to the page where we call this out, cf. "Iris-heavy proofs | Warning: named spatial premises".

Rocq context, `Γp` is the intuitionistic context, `Γs` is the spatial context,
and `Q` is the conclusion.

A plain Iris entailment `P ⊢ Q` can be converted via `iStartProof` to the following Iris goal

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This seems like a useful place to cross-link to the Iris tactic documentation.

@skylabs-ai-ci

skylabs-ai-ci Bot commented May 20, 2026

Copy link
Copy Markdown

CI summary (Details)

Active Repos

Repo Job Branch Job Commit Base branch Base commit PR
fmdeps/auto-docs/ paolo/doc-goals bb5a862 main d4c3641 #19

Passive Repos

Repo Job Branch Job Commit
./ main 7d2ee30
fmdeps/BRiCk/ main f029bba
fmdeps/auto/ main 0d4c8c4
bluerock/NOVA/ skylabs-proof dc3d314
bluerock/bhv/ skylabs-main c46f5e3
fmdeps/brick-libcpp/ main 2014908
fmdeps/ci/ main 9e6e574
vendored/elpi/ skylabs-master aa4475f
vendored/flocq/ skylabs-master cf9cc84
fmdeps/fm-tools/ main e5188db
psi/protos/ main 8fe3e7c
psi/backend/ main 0b5fea6
psi/ide/ main 6b596cf
psi/data/ main 82cb305
vendored/rocq/ skylabs-master 2ede3c9
fmdeps/rocq-agent-toolkit/ main ac7e4ec
vendored/rocq-elpi/ skylabs-master 103a742
vendored/rocq-equations/ skylabs-main a8c4832
vendored/rocq-ext-lib/ skylabs-master 94a6630
vendored/rocq-iris/ skylabs-master 3ad4ddd
vendored/rocq-lsp/ skylabs-main a8b7272
vendored/rocq-stdlib/ skylabs-master bc07423
vendored/rocq-stdpp/ skylabs-master e01d802
fmdeps/skylabs-fm/ main e8b88a7
vendored/vsrocq/ skylabs-main 5b4527e

Performance

Relative Master MR Change Filename
-0.00% 127178.6 127178.6 -0.0 total
-0.00% 22690.6 22690.6 -0.0 ├ translation units
+0.00% 104488.0 104488.0 +0.0 └ proofs and tests
Full Results
Relative Master MR Change Filename
-0.00% 127178.6 127178.6 -0.0 total
-0.00% 22690.6 22690.6 -0.0 ├ translation units
+0.00% 104488.0 104488.0 +0.0 └ proofs and tests

Comment on lines +29 to +32
Here, we must prove `R` assuming `P1`, `P2`, `Q1` and `Q2`.
Assumption `P1` and `P2` can be duplicated or discarded
freely, unlike `Q1` and `Q2`: We say `P1` and `P2` are intuitionistic and form
the intuitionistic context, while `Q1` and `Q2` form the spatial context.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Here, we must prove `R` assuming `P1`, `P2`, `Q1` and `Q2`.
Assumption `P1` and `P2` can be duplicated or discarded
freely, unlike `Q1` and `Q2`: We say `P1` and `P2` are intuitionistic and form
the intuitionistic context, while `Q1` and `Q2` form the spatial context.
The four pieces of this goal are:
1. **Rocq (Pure) Context** -- above the first line. These are variables and assertions in Rocq.
2. **Intuitionistic Ownership** -- above the `` line. These can be freely dropped and duplicated.
3. **Spatial Ownership** -- above the `` line. These represent linear ownership and, in a program verification setting, reflect the "current state" of the program.
4. **Goal** -- below the `` line. This represents the obligation to prove.

Comment on lines +34 to +35
Iris assumptions can be named or anonymous. Tactics can use names to act on
specific hypotheses, but otherwise names are not meaningful.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Iris assumptions can be named or anonymous. Tactics can use names to act on
specific hypotheses, but otherwise names are not meaningful.
Iris assumptions can be named (like `"HP2"` above) or anonymous (using `_` as in `_ : P1`).
Tactics can use names to act on specific hypotheses, e.g. `iDestruct "P2" as "P3"`, but otherwise names are not meaningful.

```rocq
--------------------------------------∗
P -∗ Q
```

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
```

Many tactics, e.g. work, that work on Iris goals will also work when the goal will also work on goals of the form P ⊢ Q.

@gmalecha-at-skylabs

Copy link
Copy Markdown
Contributor

Looks good!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants