# semantic_operation

> Every PAG keyword record, with what grounds it and how it is checked.

Page: Ontology · Grammar
Canonical: https://banes-lab.com/ontology/grammar#pag-keywords-semantic-operation

Listed in [Ontology · Grammar](https://banes-lab.com/api/pages/ontology/grammar.md), after [node](https://banes-lab.com/ontology/grammar/pag-keywords-node.md) and before [contextual](https://banes-lab.com/ontology/grammar/pag-keywords-contextual.md).

Every PAG keyword record, with what grounds it and how it is checked.

### DISCOVER_RESOURCES

Details

Meaning
Find resources by pattern · the adapter maps GLOB to it

Example
DISCOVER_RESOURCES "<pattern>" INTO <resources>

Grounds
[mode:observation](https://banes-lab.com/records/reasoning/mode-observation.md)

How it is checked

Checked by
a structured-document validator that parses each document against the grammar and reports every defect by its shape

Population
Every agent and template document the validator walks, and every occurrence of the keyword in them

Freshness
A verdict stands until the grammar data or a document that uses the keyword changes

Refusal
The validation stage fails the gate on any defect code, so a document with a malformed keyword does not ship

Observation
None, because a keyword is static text in a document, and nothing observes it while a run executes

Evidence
Watched to fire and to accept: a suite plants a retired head in a real template and validates every agent and template on disk clean

Authoritative side
The grammar data, which every keyword in a document conforms to

Depends on
Not answered

Shape it refuses
Not answered

### READ_RESOURCE

Details

Meaning
Read one resource · the adapter maps READ to it

Example
READ_RESOURCE <resource> INTO <content>

Grounds
[mode:observation](https://banes-lab.com/records/reasoning/mode-observation.md)

How it is checked

Checked by
a structured-document validator that parses each document against the grammar and reports every defect by its shape

Population
Every agent and template document the validator walks, and every occurrence of the keyword in them

Freshness
A verdict stands until the grammar data or a document that uses the keyword changes

Refusal
The validation stage fails the gate on any defect code, so a document with a malformed keyword does not ship

Observation
None, because a keyword is static text in a document, and nothing observes it while a run executes

Evidence
Watched to fire and to accept: a suite plants a retired head in a real template and validates every agent and template on disk clean

Authoritative side
The grammar data, which every keyword in a document conforms to

Depends on
Not answered

Shape it refuses
Not answered

### SEARCH_CONTENT

Details

Meaning
Search content for a term · the adapter maps GREP to it

Example
SEARCH_CONTENT <content> FOR <term> INTO <matches>

Grounds
[mode:observation](https://banes-lab.com/records/reasoning/mode-observation.md)

How it is checked

Checked by
a structured-document validator that parses each document against the grammar and reports every defect by its shape

Population
Every agent and template document the validator walks, and every occurrence of the keyword in them

Freshness
A verdict stands until the grammar data or a document that uses the keyword changes

Refusal
The validation stage fails the gate on any defect code, so a document with a malformed keyword does not ship

Observation
None, because a keyword is static text in a document, and nothing observes it while a run executes

Evidence
Watched to fire and to accept: a suite plants a retired head in a real template and validates every agent and template on disk clean

Authoritative side
The grammar data, which every keyword in a document conforms to

Depends on
Not answered

Shape it refuses
Not answered

### ANALYZE_CONTENT

Details

Meaning
Analyze content against criteria

Example
ANALYZE_CONTENT <content> AGAINST <criteria> INTO <findings>

Grounds
[mode:observation](https://banes-lab.com/records/reasoning/mode-observation.md)

How it is checked

Checked by
a structured-document validator that parses each document against the grammar and reports every defect by its shape

Population
Every agent and template document the validator walks, and every occurrence of the keyword in them

Freshness
A verdict stands until the grammar data or a document that uses the keyword changes

Refusal
The validation stage fails the gate on any defect code, so a document with a malformed keyword does not ship

Observation
None, because a keyword is static text in a document, and nothing observes it while a run executes

Evidence
Watched to fire and to accept: a suite plants a retired head in a real template and validates every agent and template on disk clean

Authoritative side
The grammar data, which every keyword in a document conforms to

Depends on
Not answered

Shape it refuses
Not answered

### EXTRACT_FACTS

Details

Meaning
Isolate fields from content, preserving its meaning

Example
EXTRACT_FACTS <fields> FROM <content> INTO <facts>

Grounds
[mode:abstraction](https://banes-lab.com/records/reasoning/mode-abstraction.md)

How it is checked

Checked by
a structured-document validator that parses each document against the grammar and reports every defect by its shape

Population
Every agent and template document the validator walks, and every occurrence of the keyword in them

Freshness
A verdict stands until the grammar data or a document that uses the keyword changes

Refusal
The validation stage fails the gate on any defect code, so a document with a malformed keyword does not ship

Observation
None, because a keyword is static text in a document, and nothing observes it while a run executes

Evidence
Watched to fire and to accept: a suite plants a retired head in a real template and validates every agent and template on disk clean

Authoritative side
The grammar data, which every keyword in a document conforms to

Depends on
Not answered

Shape it refuses
Not answered

### CALCULATE_METRIC

Details

Meaning
Derive a measure from facts

Example
CALCULATE_METRIC <measure> FROM <facts> INTO <value>

Grounds
[mode:comparison](https://banes-lab.com/records/reasoning/mode-comparison.md)

How it is checked

Checked by
a structured-document validator that parses each document against the grammar and reports every defect by its shape

Population
Every agent and template document the validator walks, and every occurrence of the keyword in them

Freshness
A verdict stands until the grammar data or a document that uses the keyword changes

Refusal
The validation stage fails the gate on any defect code, so a document with a malformed keyword does not ship

Observation
None, because a keyword is static text in a document, and nothing observes it while a run executes

Evidence
Watched to fire and to accept: a suite plants a retired head in a real template and validates every agent and template on disk clean

Authoritative side
The grammar data, which every keyword in a document conforms to

Depends on
Not answered

Shape it refuses
Not answered

### COMPOSE_ARTIFACT

Details

Meaning
Compose an artifact from facts using a shape

Example
COMPOSE_ARTIFACT <artifact> FROM <facts> USING <shape>

Grounds
[mode:construction](https://banes-lab.com/records/reasoning/mode-construction.md)

How it is checked

Checked by
a structured-document validator that parses each document against the grammar and reports every defect by its shape

Population
Every agent and template document the validator walks, and every occurrence of the keyword in them

Freshness
A verdict stands until the grammar data or a document that uses the keyword changes

Refusal
The validation stage fails the gate on any defect code, so a document with a malformed keyword does not ship

Observation
None, because a keyword is static text in a document, and nothing observes it while a run executes

Evidence
Watched to fire and to accept: a suite plants a retired head in a real template and validates every agent and template on disk clean

Authoritative side
The grammar data, which every keyword in a document conforms to

Depends on
Not answered

Shape it refuses
Not answered

### VALIDATE_ARTIFACT

Details

Meaning
Validate an artifact against a schema

Example
VALIDATE_ARTIFACT <artifact> AGAINST <schema>

Grounds
[node:ver-evidence](https://banes-lab.com/records/reasoning/node-ver-evidence.md)

How it is checked

Checked by
a structured-document validator that parses each document against the grammar and reports every defect by its shape

Population
Every agent and template document the validator walks, and every occurrence of the keyword in them

Freshness
A verdict stands until the grammar data or a document that uses the keyword changes

Refusal
The validation stage fails the gate on any defect code, so a document with a malformed keyword does not ship

Observation
None, because a keyword is static text in a document, and nothing observes it while a run executes

Evidence
Watched to fire and to accept: a suite plants a retired head in a real template and validates every agent and template on disk clean

Authoritative side
The grammar data, which every keyword in a document conforms to

Depends on
Not answered

Shape it refuses
Not answered

### PERSIST_ARTIFACT

Details

Meaning
Persist an artifact to a destination · the adapter maps WRITE and EDIT to it; a refusal is named before it

Example
PERSIST_ARTIFACT <artifact> TO <destination>

Grounds
[axis:formalization](https://banes-lab.com/records/reasoning/axis-formalization.md), [node:ver-refusal](https://banes-lab.com/records/reasoning/node-ver-refusal.md)

How it is checked

Checked by
a structured-document validator that parses each document against the grammar and reports every defect by its shape

Population
Every agent and template document the validator walks, and every occurrence of the keyword in them

Freshness
A verdict stands until the grammar data or a document that uses the keyword changes

Refusal
The validation stage fails the gate on any defect code, so a document with a malformed keyword does not ship

Observation
None, because a keyword is static text in a document, and nothing observes it while a run executes

Evidence
Watched to fire and to accept: a suite plants a retired head in a real template and validates every agent and template on disk clean

Authoritative side
The grammar data, which every keyword in a document conforms to

Depends on
Not answered

Shape it refuses
Not answered

### EXECUTE_TOOL

Details

Meaning
Execute a command with a bound · the adapter maps BASH to it

Example
EXECUTE_TOOL <command> WITH timeout: <bound> INTO <result>

Grounds
[axis:formalization](https://banes-lab.com/records/reasoning/axis-formalization.md)

How it is checked

Checked by
a structured-document validator that parses each document against the grammar and reports every defect by its shape

Population
Every agent and template document the validator walks, and every occurrence of the keyword in them

Freshness
A verdict stands until the grammar data or a document that uses the keyword changes

Refusal
The validation stage fails the gate on any defect code, so a document with a malformed keyword does not ship

Observation
None, because a keyword is static text in a document, and nothing observes it while a run executes

Evidence
Watched to fire and to accept: a suite plants a retired head in a real template and validates every agent and template on disk clean

Authoritative side
The grammar data, which every keyword in a document conforms to

Depends on
Not answered

Shape it refuses
Not answered

### REQUEST_DECISION

Details

Meaning
Ask a party to decide · the adapter maps ASK_USER to it, and resolves it absent for a bounded reader

Example
REQUEST_DECISION <party> WITH options: [, **] INTO ** **<choice>**

Grounds
[node:tel-priority](https://banes-lab.com/records/reasoning/node-tel-priority.md), [node:ter-publication](https://banes-lab.com/records/reasoning/node-ter-publication.md)

How it is checked

Checked by
a structured-document validator that parses each document against the grammar and reports every defect by its shape

Population
Every agent and template document the validator walks, and every occurrence of the keyword in them

Freshness
A verdict stands until the grammar data or a document that uses the keyword changes

Refusal
The validation stage fails the gate on any defect code, so a document with a malformed keyword does not ship

Observation
None, because a keyword is static text in a document, and nothing observes it while a run executes

Evidence
Watched to fire and to accept: a suite plants a retired head in a real template and validates every agent and template on disk clean

Authoritative side
The grammar data, which every keyword in a document conforms to

Depends on
Not answered

Shape it refuses
Not answered

### REPORT_RESULT

Details

Meaning
Report an artifact to the parties whose next work it creates

Example
REPORT_RESULT <artifact> TO <parties>

Grounds
[axis:formalization](https://banes-lab.com/records/reasoning/axis-formalization.md)

How it is checked

Checked by
a structured-document validator that parses each document against the grammar and reports every defect by its shape

Population
Every agent and template document the validator walks, and every occurrence of the keyword in them

Freshness
A verdict stands until the grammar data or a document that uses the keyword changes

Refusal
The validation stage fails the gate on any defect code, so a document with a malformed keyword does not ship

Observation
None, because a keyword is static text in a document, and nothing observes it while a run executes

Evidence
Watched to fire and to accept: a suite plants a retired head in a real template and validates every agent and template on disk clean

Authoritative side
The grammar data, which every keyword in a document conforms to

Depends on
Not answered

Shape it refuses
Not answered

## Links to

- [Observation](https://banes-lab.com/records/reasoning/mode-observation.md)
- [Abstraction](https://banes-lab.com/records/reasoning/mode-abstraction.md)
- [Comparison](https://banes-lab.com/records/reasoning/mode-comparison.md)
- [Construction](https://banes-lab.com/records/reasoning/mode-construction.md)
- [Evidence](https://banes-lab.com/records/reasoning/node-ver-evidence.md)
- [Formalization](https://banes-lab.com/records/reasoning/axis-formalization.md)
- [Refusal](https://banes-lab.com/records/reasoning/node-ver-refusal.md)
- [Branch Priority](https://banes-lab.com/records/reasoning/node-tel-priority.md)
- [Publication](https://banes-lab.com/records/reasoning/node-ter-publication.md)
