## §SELF — miscsubjects (paste without context)

**Principle:** Self-explaining payload — no external context required. This _self block describes what you are reading and where to look next.

**This widget:** `oip_article_bundle` — **OIP article hub**
Public article-native Object Invocation Protocol docs: /a/oip root, generated shelf/system/capability articles, machine bundles, token boundary, and receipt loop.
- **article slug:** `oip`
- **contains:** OIP article bundle, body, source ledger, machine JSON, token and receipt contract
- **how to use:** Read /a/oip first; traverse to system and capability articles; use scoped capability URLs only when acting.
- **read:** https://miscsubjects.com/a/oip
- **write:** via directory rows and /api/dispatch receipts; docs are public, actions require scoped capability tokens or owner auth

### Logical proof (verify each step)
1. Articles are voxel graphs of tiered claims, not prose blobs. → https://miscsubjects.com/api/articles/constitution
2. Claims link to hash-chained sources via source_ids. → https://miscsubjects.com/api/articles/oip/sources
3. Ask reads topology; ingest/claim append to ledger. → https://miscsubjects.com/api/protocol
4. Models queue growth: populate → collaborate → repair → reflex. → https://miscsubjects.com/api/protocol/grow
5. Graph proves its own shape (reflex) and $/claim (yield). → https://miscsubjects.com/graph.html?layer=reflex
6. Full feature index + _explain on every API response. → https://miscsubjects.com/api/articles/system-map

### Related features (explains other parts of the system)
- **oip_protocol** — Every capability is an invokable object: identify, explain, invoke, ledger, yield. · https://miscsubjects.com/a/oip
- **oip_registry** — Full registry of invokable directory objects with read/write paths and schemas. · https://miscsubjects.com/api/dispatch?registry=1
- **oip_invocations** — Yield and waste events for every dispatch invocation — trace, cost, material output. · https://miscsubjects.com/api/invocations
- **system_map** — Root index of every miscsubjects article-ledger feature. Start here if you have zero context. · https://miscsubjects.com/api/articles/system-map
- **llm_manifest** — Machine-readable read/write contract for external LLMs. · https://miscsubjects.com/api/articles/llm-manifest

### Full index
- JSON: https://miscsubjects.com/api/articles/system-map
- Markdown: https://miscsubjects.com/api/articles/system-map?format=markdown

*Not medical advice. Tier-honest. Cite claim/source ids.*

---

# miscsubjects OIP article bundle

> Paste this entire block into any model. It can read the public docs, traverse the OIP article tree, and use scoped capability URLs only for real actions.

## Article
- **slug:** `oip`
- **title:** Object Invocation Protocol
- **url:** https://miscsubjects.com/a/oip
- **register:** oip_protocol
- **updated:** 2026-07-03T00:25:30-07:00

## Body

## Object Invocation Protocol v0.6 specification

**Status:** production reference implementation at `miscsubjects.com`; normative surface at `/a/oip-spec`; live conformance at `/api/dispatch?conformance=1&format=markdown`.

**Abstract:** OIP (Object Invocation Protocol) is a protocol for model-operated work. It makes one unit of work addressable as an object, gives that object a machine-readable contract, invokes it through a uniform route, and proves the result with a receipt.

**Conformance target:** a conformant OIP implementation exposes object contracts, validates authority, invokes objects, appends invocation records, returns receipts, supports replay, supports repair, and publishes machine-readable conformance results.

## 1. Protocol model

An OIP object states the work, the input, the authority, the invocation route, the runner, the proof requirement, the receipt, the replay path, and the repair path. A model operates OIP by resolving an object, reading the object contract, invoking the object route, and returning the receipt.

The OIP unit is the work object. The OIP proof is the receipt. The OIP loop is object, invoke, ledger, receipt, replay, repair.

## 2. End-to-end operation

A model needs to do work. The model needs to know what work exists. OIP gives the model an object. The object states the work, the input it needs, the authority it requires, where the request goes, the runner that performs it, and the proof that must return. The proof is the receipt. Replay repeats a recorded invocation. Repair links a corrected invocation to the failed receipt.

## Operating loop

1. Resolve the object: `?ask=<plain language>` or `?key=<KEY>`.
2. Read the object contract.
3. Confirm the credential scope permits the object: `?explain=1&share=TOKEN`.
4. Invoke the object.
5. Return the receipt: `proof.say_to_user`.
6. Correct a wrong result by repairing from the receipt.

Each step completes before the next. The first incomplete step is the stopping point, and it names what it requires.

## 3. Protocol lineage

Remote-operation protocols make operations addressable across systems.

- RPC made procedure calls addressable.
- SOAP made service messages addressable through structured envelopes.
- REST made resources addressable through URLs and methods.
- OpenAPI made HTTP API capabilities machine-readable.
- gRPC made typed service calls addressable.
- MCP (Model Context Protocol) made model sessions address tools, prompts, and resources.
- W3C PROV made provenance recordable across entities, activities, and agents.

OIP makes model-operated work addressable as an object. The OIP object carries the contract, authority, invocation route, runner, proof requirement, receipt, replay path, and repair path. OIP standardizes accountable work by models.

## 4. The OIP object

An OIP object is the protocol unit. One object defines one addressable unit of work. Every object exposes the same fields:

- `object_key`: the stable name of the work object.
- `object_type`: the class of object.
- `work_definition`: the work the object performs.
- `input_schema`: the input the object accepts.
- `authority_required`: the credential scope the object requires.
- `invocation_route`: the route that invokes the object.
- `runner`: the system that performs the work.
- `side_effects`: the external changes the object may cause.
- `risk_class`: the operational consequence class.
- `proof_required`: the receipt or artifact that establishes success.
- `receipt_schema`: the fields the receipt records.
- `replay_route` and `repair_route`: the mechanisms for repeated and corrected invocation.
- `conformance_tests`: the checks that establish object behavior.
- `examples`: valid object calls.
- `human_view`, `machine_view`, `json_view`: the three views of the object.

The same object is readable in three forms: a human article at `/a/oip-capability-KEY`, a machine document at `/api/dispatch?key=KEY&format=markdown`, and a JSON object at `/api/dispatch?key=KEY`. The human article, the machine document, and the JSON object are three views of one object.

## 5. Invocation loop

1. Resolve the object: `/api/dispatch?ask=<plain language>` or `/api/dispatch?key=<KEY>`.
2. Read the object contract.
3. Confirm authority: `/api/dispatch?explain=1&share=TOKEN`.
4. Invoke the object route: `POST /api/dispatch {key, body}` or `GET /api/dispatch?invoke=KEY&body=...&share=TOKEN`.
5. Read the runner result.
6. Return the receipt: `/api/dispatch?receipt=inv_ID`.
7. Answer from the receipt.
8. Use replay for repeated work; use repair for corrected work.

The first missing element — object, authority, route, or receipt — is the stopping point, and it names what it requires.

## 6. Receipt

A receipt proves one invocation. Every receipt records:

- `invocation_id`, `timestamp`, `actor`, `credential_scope`.
- `object_key`, `object_version`, `input_hash`, `input_body`.
- `runner`, `status`, `output_hash`, `artifact_urls`.
- `error` when the invocation fails.
- `ledger_url`, `confirm_url`, `replay_url`, `repair_url`.
- `parent_invocation_id` when the invocation was delegated.
- `repair_of_invocation_id` when the invocation is a repair.

Read a receipt at `/api/dispatch?receipt=inv_ID`. Confirm one publicly at `/api/dispatch?confirm=inv_ID`. Success requires a real invocation id, a recorded request, a recorded response, and a receipt link. When the receipt reports the runner failed, the action failed, and the next move is repair.

## 7. Replay and repair

Replay repeats a recorded invocation: `POST /api/dispatch {replay:"inv_ID"}`. The replay uses the recorded object key and input, produces a new invocation id and receipt, and links the new receipt to the original.

Repair creates a corrected invocation: `POST /api/dispatch {key, body, repairs:"inv_ID"}`. The repair references the failed receipt, produces a new invocation id and receipt, and links the corrected receipt to the failure in both directions. Repair turns failure into lineage.

## 8. Conformance

- **OIP-READ**: the system exposes a readable object contract.
- **OIP-INVOKE**: the system exposes an invocation route for the object.
- **OIP-PROVE**: the system returns a receipt for the invocation.
- **OIP-REPLAY**: the system repeats the recorded invocation.
- **OIP-REPAIR**: the system attaches a corrected invocation to the failed receipt.
- **OIP-DELEGATE**: the system hands a scoped object credential to another model, agent, browser, queue, or service.
- **OIP-LEDGER**: the system stores invocation records append-only.
- **OIP-ARTIFACT**: the system returns artifact references when work creates files, images, messages, code, or documents.

A conformant success response returns the object key, the invocation id, the receipt URL, the status, and the result. A conformant failure response returns the object key, the invocation id when present, the error, the missing requirement, and the repair target.

The live suite runs 14 numbered clauses against production: `/api/dispatch?conformance=1&format=markdown`. Current verdict: CONFORMANT, 14 of 14. Specification: [/a/oip-spec](https://miscsubjects.com/a/oip-spec).

## 9. OIP and MCP

MCP standardizes model access to tools, prompts, and resources inside a model-client session. OIP standardizes model-operated work as an object.

| axis | MCP | OIP |
|--|--|--|
| unit | a tool, prompt, or resource a server exposes | a work object |
| transport | a session between host, client, and server | a URL and object invocation with a scoped credential |
| proof | a protocol response | a ledger receipt |
| repair | application-defined | a corrected invocation linked to the failed receipt |
| delegation | a configured session | a scoped object credential handed to any model, agent, browser, queue, or service |

MCP answers the access question. OIP answers the work question.

### An MCP tool is an OIP object

In this build, an MCP tool is registered as an OIP object. The MCP shelf holds 11 MCP tools as directory objects. Example object: `MCP_context7_resolve_library_id`, runner type `mcp`, read it at [/api/dispatch?key=MCP_context7_resolve_library_id&format=markdown](https://miscsubjects.com/api/dispatch?key=MCP_context7_resolve_library_id&format=markdown).

A model operates that MCP tool by opening the OIP object URL: read `/api/dispatch?key=MCP_...&format=markdown`, then invoke `/api/dispatch?invoke=MCP_...&body=...&share=TOKEN`. The MCP call runs behind the object, and OIP records the receipt. OIP addresses an MCP tool as a link and adds the receipt, the replay path, the repair path, the scope, and the ledger entry to that tool.

The relationship is containment: MCP connects a session to a server; OIP registers that server's tool as one object among its runners and makes each call provable by receipt. A model reaches the MCP tool through its OIP object URL.

## Public demo

`NOW` is a public demo object. Read it at [/api/dispatch?key=NOW&format=markdown](https://miscsubjects.com/api/dispatch?key=NOW&format=markdown). Invoke it with a scoped credential to produce a receipt, confirm the receipt publicly at `/api/dispatch?confirm=inv_ID`, then replay and repair from that receipt. The demo runs the full loop with a scoped, rate-limited credential.

## Terms

- **Build**: the whole miscsubjects system — site, APIs, directory rows, files, ledgers, tools, models, workers, and deploy path.
- **Object**: one thing the build can read or do.
- **Directory row**: the saved contract for one object. It says what the object does, what inputs it takes, and how to run it.
- **Dispatch**: the invocation door. It receives an object key and body, finds the row, and runs it.
- **Runner**: the actual machine that does the work: HTTP, model, shell, database, file, Worker, or service.
- **Ledger**: the append-only record of what was asked, what ran, and what came back.
- **Receipt**: one proof object for one invocation.
- **Replay**: run the same recorded invocation again.
- **Repair**: run a corrected invocation and attach it to the failed receipt.
- **Tap & Go**: one copied drop that carries object map, credential, execute shape, and receipt rule together.

## Foundation articles

OIP assumes a reader may have zero context. The root article gives the whole shape, then the foundation articles explain the words a model or human needs before operating the build:

- [OIP operating model](https://miscsubjects.com/a/oip-operating-model) states the operating model, the four invariants, and the six-step operating loop.
- [What is an object?](https://miscsubjects.com/a/oip-what-is-object) explains what an OIP object is and why everything in the build is one.
- [What is a capability?](https://miscsubjects.com/a/oip-what-is-capability) explains scoped, expiring, revocable permissions and why least privilege matters.
- [What is a token?](https://miscsubjects.com/a/oip-what-is-token) explains the credential that separates reading from acting.
- [What is a tenant?](https://miscsubjects.com/a/oip-what-is-tenant) explains isolation boundaries and multi-tenant proof.
- [What is a voxel graph?](https://miscsubjects.com/a/oip-voxel-graph) explains the typed node/edge machine-native topology of the build.
- [What is an API?](https://miscsubjects.com/a/oip-api) explains route, method, header, body, response, proof, and repair.
- [What is REST?](https://miscsubjects.com/a/oip-rest) explains resource URLs and methods such as GET, POST, PATCH, PUT, and DELETE.
- [How to operate the build with curl](https://miscsubjects.com/a/oip-curl) explains terminal HTTP calls and the dispatch shape.
- [What is a CLI?](https://miscsubjects.com/a/oip-cli) explains command line programs, args, cwd, output, and exit status.
- [Protocol lineage](https://miscsubjects.com/a/oip-protocol-lineage) places OIP in the remote-operation protocol line: RPC, SOAP, REST, OpenAPI, MCP, W3C PROV.
- [What is MCP?](https://miscsubjects.com/a/oip-mcp) explains Model Context Protocol and its place beside OIP: MCP answers the access question, OIP answers the work question.
- [What is GitHub?](https://miscsubjects.com/a/oip-github) and [What is GitHub MCP?](https://miscsubjects.com/a/oip-github-mcp) explain repo/file/tool access as build objects.
- [OIP link structure](https://miscsubjects.com/a/oip-link-structure) and [OIP drop end to end](https://miscsubjects.com/a/oip-drop-end-to-end) explain the self-explaining link structure that carries an object to a model.
- [Cron and recursive review](https://miscsubjects.com/a/oip-cron-recursion) and [Models reviewing OIP articles](https://miscsubjects.com/a/oip-model-review-loop) explain the scheduled model-review loop.

## Whole build, end to end

The reference implementation contains articles, prompts, files, terminals, model calls, deployments, ledgers, and self-tests as OIP objects.

The end-to-end path is:

1. **Caller**: some surface asks for work. The caller may be a model, browser, API client, admin page, CLI path, scheduled workflow, or messaging route.
2. **Resolution**: the caller either asks `/api/dispatch?ask=<plain language>` or opens a known object.
3. **Object contract**: the directory row explains the exact object: `WHAT`, `ARGS`, `EX`, `TESTS`, auth, risk, runner, and proof paths.
4. **Invocation**: dispatch receives `key` and `body`, validates access, and chooses the runner.
5. **Execution**: the runner does the work: HTTP, model, shell, D1, KV, R2, file, Worker, or deploy.
6. **Ledger**: the build records request, response, actor, trace, cost, material output, and errors.
7. **Receipt**: OIP returns a receipt link for the invocation.
8. **Correction**: replay repeats the recorded call; repair creates a corrected call linked to the failed receipt.

That pattern is the whole build. Different surfaces exist, but the object boundary is the same.

## How to do anything

The universal rule is: never guess a tool. Resolve the object, read the object, invoke the object, prove the invocation.

1. **Orient**: open `/api/dispatch?orient=1&format=markdown` when cold.
2. **Ask**: open `/api/dispatch?ask=<what you want>`.
3. **Read**: open `/api/dispatch?key=<KEY>&format=markdown` for the exact object.
4. **Invoke**: use Tap & Go, owner auth, or the returned run URL.
5. **Prove**: open `/api/dispatch?receipt=inv_ID&share=TOKEN` and answer from the receipt.
6. **Repair**: if wrong, call `POST /api/dispatch {key, body, repairs:"inv_ID"}` so the fix stays attached to the failure.

If a model only knows this one path, it can operate the build without guessing.

## What each part does

- **Directory** is the catalog of executable objects.
- **Dispatch** is the one invocation endpoint.
- **Rows** are object contracts.
- **Prompts** are rows too; an agent's system prompt is its row content.
- **Articles** are content objects with body, claims, sources, provenance, widgets, and bundle JSON.
- **Files** are operational code in the repo; bulk/reference data belongs outside the repo and is reached by API.
- **Admin pages** are human work surfaces over the same objects.
- **Runners** connect objects to actual work.
- **Ledger and receipts** are proof and memory.
- **Self-test** is the executable spec for claimed behavior.
- **Deploy** moves code changes to Cloudflare Pages.

## Tap & Go

Tap & Go is the copy primitive for handing OIP to a model. One copy gives the model the credential, protocol, tree, search pattern, execute pattern, and receipt loop together. Do not assemble a token, a map, a bundle, and a link by hand. The copied drop is the interface.

The action loop is: ask in plain language, read the object, invoke the object named by the task, open the receipt, then replay or repair from that receipt if the result is wrong. The receipt is the proof: an action is established by its receipt.

## Object contract

An OIP capability exposes the same fields every time: `WHAT`, `ARGS`, `EX`, `TESTS`, auth, risk, runner, run URL, machine contract, troubleshooting, invocation history, receipt, replay, and repair.

The same object is readable in three forms:

1. A human article: `/a/oip-capability-KEY`.
2. A machine document: `/api/dispatch?key=KEY&format=markdown`.
3. A JSON object: `/api/dispatch?key=KEY`.

The human article, the machine document, and the JSON object are three views of one object.

## Proof

OIP treats the receipt as success. A completed action has a real invocation id, a recorded request, a recorded response, and a receipt link. When the receipt reports the runner failed, the action failed, and the next move is repair.

## Machine-native JSON

The JSON bundle for this article is part of the article. It gives a model the same object map in structured form: how to orient, ask, read, invoke, prove, repair, traverse shelves, and understand the build facets. The prose is for human orientation; the JSON is for execution.

The root tree is live at [/api/dispatch?map=1&format=markdown](https://miscsubjects.com/api/dispatch?map=1&format=markdown). The machine bundle for this article is [/api/articles/oip/bundle?format=markdown](https://miscsubjects.com/api/articles/oip/bundle?format=markdown). Those are handles, not the product path; Tap & Go is the product path.

## OIP article library

These articles explain the build the way a strong article system explains any subject: one subject per page, human-readable prose, machine-native bundle, sources, claims, and proof paths.

- [OIP protocol lineage](https://miscsubjects.com/a/oip-protocol-lineage)
- [OIP operating model](https://miscsubjects.com/a/oip-operating-model)
- [OIP build overview](https://miscsubjects.com/a/oip-build-overview)
- [OIP object model](https://miscsubjects.com/a/oip-object-model)
- [Directory rows and dispatch](https://miscsubjects.com/a/oip-directory-dispatch)
- [Ledger, receipts, replay, repair](https://miscsubjects.com/a/oip-ledger-receipts)
- [Tap & Go delegation](https://miscsubjects.com/a/oip-tap-go)
- [Machine-native JSON](https://miscsubjects.com/a/oip-machine-json)
- [Articles and content objects](https://miscsubjects.com/a/oip-articles-content-plane)
- [Files, repo, and deploy](https://miscsubjects.com/a/oip-files-deploy)
- [Self-test and proof](https://miscsubjects.com/a/oip-self-test-proof)
- [OIP operating playbook](https://miscsubjects.com/a/oip-operating-playbook)
- [What is an API?](https://miscsubjects.com/a/oip-api)
- [What is REST?](https://miscsubjects.com/a/oip-rest)
- [How to operate the build with curl](https://miscsubjects.com/a/oip-curl)
- [What is a CLI?](https://miscsubjects.com/a/oip-cli)
- [What is MCP?](https://miscsubjects.com/a/oip-mcp)
- [What is GitHub?](https://miscsubjects.com/a/oip-github)
- [What is GitHub MCP?](https://miscsubjects.com/a/oip-github-mcp)
- [OIP link structure](https://miscsubjects.com/a/oip-link-structure)
- [OIP drop end to end](https://miscsubjects.com/a/oip-drop-end-to-end)
- [Cron and recursive review](https://miscsubjects.com/a/oip-cron-recursion)
- [Models reviewing OIP articles](https://miscsubjects.com/a/oip-model-review-loop)
- [The OIP specification — and the proof it is a protocol](https://miscsubjects.com/a/oip-spec)
- [What is an object?](https://miscsubjects.com/a/oip-what-is-object)
- [What is a capability?](https://miscsubjects.com/a/oip-what-is-capability)
- [What is a token?](https://miscsubjects.com/a/oip-what-is-token)
- [What is a tenant?](https://miscsubjects.com/a/oip-what-is-tenant)
- [What is a voxel graph?](https://miscsubjects.com/a/oip-voxel-graph)
- [The OIP cookbook — the exact curl for everything](https://miscsubjects.com/a/oip-cookbook)
- [What a model sees: MCP GitHub vs the OIP directory](https://miscsubjects.com/a/oip-mcp-github)
- [What a model sees: MCP Stripe vs the OIP directory](https://miscsubjects.com/a/oip-mcp-stripe)

## Shelves

### API shelves
302 capabilities across 18 systems. [Open shelf](https://miscsubjects.com/a/oip-apis).

### CLI shelves
46 capabilities across 2 systems. [Open shelf](https://miscsubjects.com/a/oip-clis).

### MCP shelves
11 capabilities across 1 system. [Open shelf](https://miscsubjects.com/a/oip-mcps).

### Device shelves
62 capabilities across 4 systems. [Open shelf](https://miscsubjects.com/a/oip-devices).

### Model shelves
43 capabilities across 8 systems. [Open shelf](https://miscsubjects.com/a/oip-models).

### Core shelves
265 capabilities across 144 systems. [Open shelf](https://miscsubjects.com/a/oip-core).

## Owner/admin invocation

Owner auth and scoped capability URLs are both invocation credentials. The difference is scope: owner auth can mint broad drops; a row token can fire one named object. In both cases the result is the same OIP loop: exact object, exact call, exact receipt.
## Latest clarity reviews (live)

Fresh models are sent this article's bundle and asked two separate questions: how clear is the machine JSON, and how clear is the English body. Scores are 0 to 10. The full history is in the append-only ledger.

- 2026-07-02 23:12 · model `@cf/meta/llama-3.3-70b-instruct-fp8-fast` · NEEDS WORK · JSON 9/10 · English 8/10 · zero-context human 7/10
  - gaps named: Detailed MCP explanation; OIP security measures; Error handling and debugging
- 2026-07-02 23:10 · model `@cf/meta/llama-3.3-70b-instruct-fp8-fast` · NEEDS WORK · JSON 9/10 · English 8/10 · zero-context human 7/10
  - gaps named: Detailed MCP explanation; OIP security measures; Error handling and debugging
- 2026-07-02 23:07 · model `@cf/meta/llama-3.3-70b-instruct-fp8-fast` · PASS · JSON 9/10 · English 8/10 · zero-context human 7/10
  - gaps named: MCP explanation; Detailed comparison of OIP and MCP

How the loop self-corrects: a failing review queues a model revision of this article (a new append-only version). A missing concept named by a reviewer queues a brand-new machine-written article, which then enters the same review cycle.

## Machine JSON
```json
{
  "protocol": "OIP article bundle",
  "version": "0.5",
  "generated_from": "live directory rows",
  "slug": "oip",
  "type": "root",
  "urls": {
    "human_page": "https://miscsubjects.com/a/oip",
    "bundle": "https://miscsubjects.com/api/articles/oip/bundle",
    "bundle_markdown": "https://miscsubjects.com/api/articles/oip/bundle?format=markdown",
    "oip_root": "https://miscsubjects.com/a/oip",
    "oip_tree_markdown": "https://miscsubjects.com/api/dispatch?map=1&format=markdown",
    "oip_tree_json": "https://miscsubjects.com/api/dispatch?map=1",
    "content_system_map": "https://miscsubjects.com/api/articles/system-map?format=markdown",
    "mint_capability": "https://miscsubjects.com/api/dispatch?mint_share=1&scope=row&key=KEY&ttl=600&uses=1",
    "explain_token": "https://miscsubjects.com/api/dispatch?explain=1&share=TOKEN",
    "receipt": "https://miscsubjects.com/api/dispatch?receipt=inv_ID&share=TOKEN"
  },
  "traversal": "/a/oip -> /a/oip-apis -> /a/oip-system-github -> /a/oip-capability-github-list-issues -> ?receipt=inv_ID",
  "counts": {
    "capabilities": 729,
    "systems": 177
  },
  "action_boundary": "Docs are public. Actions require scoped capability tokens or owner auth.",
  "append_only_payload": {
    "kind": "oip_article_payload",
    "article_slug": "oip",
    "body_format": "human-readable markdown article",
    "machine_format": "JSON object in this bundle.machine",
    "version_table": "oip_articles",
    "version_history": [],
    "generated_articles": "static/generated article; review and invocation ledgers still append-only",
    "review_ledger_key": "OIP_ARTICLE_REVIEW",
    "intake_ledger_key": "MODEL_CHAT_INTAKE",
    "editorial_ledger_key": "EDITORIAL_BOARD_DECISION",
    "proof": "A content change is proven by a new oip_articles version or by a ledger event that queued review/revision."
  },
  "oip_article_library": [
    {
      "slug": "oip-protocol-lineage",
      "title": "OIP protocol lineage",
      "human_page": "https://miscsubjects.com/a/oip-protocol-lineage",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-protocol-lineage/bundle?format=markdown",
      "machine_schema": {
        "definitions": {
          "remote_operation_protocol": "a standard that makes a class of operation addressable across systems",
          "work_object": "the OIP unit: contract, scope, invocation, receipt, replay, repair",
          "lineage": [
            "RPC",
            "SOAP",
            "REST",
            "gRPC",
            "MCP",
            "OIP"
          ]
        },
        "routes": {
          "read_article": "GET https://miscsubjects.com/a/oip-protocol-lineage",
          "read_bundle": "GET https://miscsubjects.com/api/articles/oip-protocol-lineage/bundle",
          "receipt": "GET https://miscsubjects.com/api/dispatch?receipt=inv_ID"
        },
        "examples": [
          {
            "description": "Read the protocol lineage",
            "curl": "curl -s 'https://miscsubjects.com/a/oip-protocol-lineage'"
          }
        ],
        "test_questions": [
          "What class of operation does each protocol in the lineage make addressable?",
          "What is the OIP unit, and what does it carry?",
          "What does OIP add to SOAP's place in the line?"
        ],
        "dependencies": [
          "oip",
          "oip-operating-model",
          "oip-mcp"
        ],
        "scoring_rubric": {
          "json_clarity": "Can the model list the lineage and state OIP's addition?",
          "english_clarity": "Can a zero-context reader place OIP among remote-operation protocols?",
          "operability": "Can the model name the receipt route that carries an object's proof?"
        }
      }
    },
    {
      "slug": "oip-operating-model",
      "title": "OIP operating model",
      "human_page": "https://miscsubjects.com/a/oip-operating-model",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-operating-model/bundle?format=markdown",
      "machine_schema": {
        "definitions": {
          "governed_remote_execution": "scoped object contracts that produce receipts, replay paths, and repair lineage",
          "temporary_operator": "a model operating scoped machinery for the duration of one credential",
          "object": "one capability with a contract, a scope, and a receipt"
        },
        "routes": {
          "read_article": "GET https://miscsubjects.com/a/oip-operating-model",
          "read_bundle": "GET https://miscsubjects.com/api/articles/oip-operating-model/bundle",
          "invoke": "POST https://miscsubjects.com/api/dispatch {key, body}",
          "receipt": "GET https://miscsubjects.com/api/dispatch?receipt=inv_ID"
        },
        "examples": [
          {
            "description": "Read the operating model",
            "curl": "curl -s 'https://miscsubjects.com/a/oip-operating-model'"
          }
        ],
        "test_questions": [
          "What is an OIP object?",
          "What proves an OIP action ran?",
          "What are the six steps of the operating loop?"
        ],
        "dependencies": [
          "oip"
        ],
        "scoring_rubric": {
          "json_clarity": "Can the model state the four invariants and the operating loop?",
          "english_clarity": "Can a zero-context reader state what an object, a scope, and a receipt are?",
          "operability": "Can the model compose the invoke and receipt calls?"
        }
      }
    },
    {
      "slug": "oip-build-overview",
      "title": "OIP build overview",
      "human_page": "https://miscsubjects.com/a/oip-build-overview",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-build-overview/bundle?format=markdown",
      "machine_schema": {
        "definitions": {
          "build": "the whole miscsubjects system",
          "object": "one thing the build can read or do",
          "directory_row": "saved contract for one object",
          "dispatch": "invocation door",
          "runner": "actual machine that does work",
          "ledger": "append-only record",
          "receipt": "proof object for one invocation"
        },
        "routes": {
          "orient": "GET /api/dispatch?orient=1&format=markdown",
          "ask": "GET /api/dispatch?ask=<plain words>",
          "read": "GET /api/dispatch?key=<KEY>&format=markdown",
          "invoke": "POST /api/dispatch {key, body}",
          "receipt": "GET /api/dispatch?receipt=inv_ID&share=TOKEN"
        },
        "examples": [
          {
            "description": "Read the OIP root",
            "curl": "curl 'https://miscsubjects.com/api/dispatch?orient=1&format=markdown'"
          },
          {
            "description": "Ask for an object",
            "curl": "curl 'https://miscsubjects.com/api/dispatch?ask=text+cyrus+hello'"
          }
        ],
        "test_questions": [
          "What is the exact URL to read an object contract?",
          "What is the exact POST body to invoke an object?",
          "How do you prove an invocation ran?"
        ],
        "dependencies": [
          "oip-object-model",
          "oip-directory-dispatch",
          "oip-ledger-receipts"
        ],
        "scoring_rubric": {
          "json_clarity": "Can the model identify all 6 routes from the schema?",
          "english_clarity": "Can a zero-context reader explain the 6-step flow?",
          "operability": "Can the model compose the exact curl for each route?"
        }
      }
    },
    {
      "slug": "oip-object-model",
      "title": "OIP object model",
      "human_page": "https://miscsubjects.com/a/oip-object-model",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-object-model/bundle?format=markdown",
      "machine_schema": {
        "definitions": {
          "What an object is\",": "What an object is\",",
          "What every object must explain\",": "What every object must explain\",",
          "Human and machine views\",": "Human and machine views\","
        },
        "routes": {
          "read_article": "GET https://miscsubjects.com/a/oip-object-model",
          "read_bundle": "GET https://miscsubjects.com/api/articles/oip-object-model/bundle",
          "read_bundle_markdown": "GET https://miscsubjects.com/api/articles/oip-object-model/bundle?format=markdown"
        },
        "examples": [
          {
            "description": "Read OIP object model",
            "curl": "curl -s 'https://miscsubjects.com/a/oip-object-model'"
          }
        ],
        "test_questions": [
          "What is the exact URL to read this article (oip-object-model)?",
          "What is the main concept explained in OIP object model?",
          "What are the three forms of every OIP object?"
        ],
        "dependencies": [
          "oip-build-overview"
        ],
        "scoring_rubric": {
          "json_clarity": "Can the model identify all routes and definitions from the schema?",
          "english_clarity": "Can a zero-context reader explain the core concept without guessing?",
          "operability": "Can the model compose the exact curl for each route?"
        }
      }
    },
    {
      "slug": "oip-directory-dispatch",
      "title": "Directory rows and dispatch",
      "human_page": "https://miscsubjects.com/a/oip-directory-dispatch",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-directory-dispatch/bundle?format=markdown",
      "machine_schema": {
        "definitions": {
          "Directory rows\",": "Directory rows\",",
          "Dispatch\",": "Dispatch\",",
          "Why the row matters\",": "Why the row matters\","
        },
        "routes": {
          "read_article": "GET https://miscsubjects.com/a/oip-directory-dispatch",
          "read_bundle": "GET https://miscsubjects.com/api/articles/oip-directory-dispatch/bundle",
          "read_bundle_markdown": "GET https://miscsubjects.com/api/articles/oip-directory-dispatch/bundle?format=markdown"
        },
        "examples": [
          {
            "description": "Read Directory rows and dispatch",
            "curl": "curl -s 'https://miscsubjects.com/a/oip-directory-dispatch'"
          }
        ],
        "test_questions": [
          "What is the exact URL to read this article (oip-directory-dispatch)?",
          "What is the main concept explained in Directory rows and dispatch?"
        ],
        "dependencies": [
          "oip-what-is-object"
        ],
        "scoring_rubric": {
          "json_clarity": "Can the model identify all routes and definitions from the schema?",
          "english_clarity": "Can a zero-context reader explain the core concept without guessing?",
          "operability": "Can the model compose the exact curl for each route?"
        }
      }
    },
    {
      "slug": "oip-ledger-receipts",
      "title": "Ledger, receipts, replay, repair",
      "human_page": "https://miscsubjects.com/a/oip-ledger-receipts",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-ledger-receipts/bundle?format=markdown",
      "machine_schema": {
        "definitions": {
          "What the ledger is\",": "What the ledger is\",",
          "The events table — every payload, in and out\",": "The events table — every payload, in and out\",",
          "The invocations table — one row per object call\",": "The invocations table — one row per object call\",",
          "What a receipt actually looks like\",": "What a receipt actually looks like\",",
          "Replay and repair\",": "Replay and repair\",",
          "The audit rules chain\",": "The audit rules chain\",",
          "Read the ledgers yourself\",": "Read the ledgers yourself\","
        },
        "routes": {
          "read_article": "GET https://miscsubjects.com/a/oip-ledger-receipts",
          "read_bundle": "GET https://miscsubjects.com/api/articles/oip-ledger-receipts/bundle",
          "read_bundle_markdown": "GET https://miscsubjects.com/api/articles/oip-ledger-receipts/bundle?format=markdown",
          "read_receipt": "GET https://miscsubjects.com/api/dispatch?receipt=inv_ID&share=TOKEN",
          "read_invocations": "GET https://miscsubjects.com/api/invocations?limit=10"
        },
        "examples": [
          {
            "description": "Read Ledger, receipts, replay, repair",
            "curl": "curl -s 'https://miscsubjects.com/a/oip-ledger-receipts'"
          }
        ],
        "test_questions": [
          "What is the exact URL to read this article (oip-ledger-receipts)?",
          "What is the main concept explained in Ledger, receipts, replay, repair?",
          "What is a receipt and how do you read it?",
          "What is replay vs repair?"
        ],
        "dependencies": [
          "oip-directory-dispatch"
        ],
        "scoring_rubric": {
          "json_clarity": "Can the model identify all routes and definitions from the schema?",
          "english_clarity": "Can a zero-context reader explain the core concept without guessing?",
          "operability": "Can the model compose the exact curl for each route?"
        }
      }
    },
    {
      "slug": "oip-tap-go",
      "title": "Tap & Go delegation",
      "human_page": "https://miscsubjects.com/a/oip-tap-go",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-tap-go/bundle?format=markdown",
      "machine_schema": {
        "definitions": {
          "What Tap & Go is\",": "What Tap & Go is\",",
          "What it replaces\",": "What it replaces\",",
          "Scope\",": "Scope\","
        },
        "routes": {
          "read_article": "GET https://miscsubjects.com/a/oip-tap-go",
          "read_bundle": "GET https://miscsubjects.com/api/articles/oip-tap-go/bundle",
          "read_bundle_markdown": "GET https://miscsubjects.com/api/articles/oip-tap-go/bundle?format=markdown"
        },
        "examples": [
          {
            "description": "Read Tap & Go delegation",
            "curl": "curl -s 'https://miscsubjects.com/a/oip-tap-go'"
          }
        ],
        "test_questions": [
          "What is the exact URL to read this article (oip-tap-go)?",
          "What is the main concept explained in Tap & Go delegation?",
          "What does a Tap & Go drop carry?"
        ],
        "dependencies": [
          "oip-what-is-token"
        ],
        "scoring_rubric": {
          "json_clarity": "Can the model identify all routes and definitions from the schema?",
          "english_clarity": "Can a zero-context reader explain the core concept without guessing?",
          "operability": "Can the model compose the exact curl for each route?"
        }
      }
    },
    {
      "slug": "oip-machine-json",
      "title": "Machine-native JSON",
      "human_page": "https://miscsubjects.com/a/oip-machine-json",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-machine-json/bundle?format=markdown",
      "machine_schema": {
        "definitions": {
          "Why JSON matters\",": "Why JSON matters\",",
          "Prose and JSON\",": "Prose and JSON\",",
          "Rule\",": "Rule\","
        },
        "routes": {
          "read_article": "GET https://miscsubjects.com/a/oip-machine-json",
          "read_bundle": "GET https://miscsubjects.com/api/articles/oip-machine-json/bundle",
          "read_bundle_markdown": "GET https://miscsubjects.com/api/articles/oip-machine-json/bundle?format=markdown"
        },
        "examples": [
          {
            "description": "Read Machine-native JSON",
            "curl": "curl -s 'https://miscsubjects.com/a/oip-machine-json'"
          }
        ],
        "test_questions": [
          "What is the exact URL to read this article (oip-machine-json)?",
          "What is the main concept explained in Machine-native JSON?",
          "What is the machine-native rule for OIP objects?"
        ],
        "dependencies": [
          "oip-what-is-object"
        ],
        "scoring_rubric": {
          "json_clarity": "Can the model identify all routes and definitions from the schema?",
          "english_clarity": "Can a zero-context reader explain the core concept without guessing?",
          "operability": "Can the model compose the exact curl for each route?"
        }
      }
    },
    {
      "slug": "oip-articles-content-plane",
      "title": "Articles and content objects",
      "human_page": "https://miscsubjects.com/a/oip-articles-content-plane",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-articles-content-plane/bundle?format=markdown",
      "machine_schema": {
        "definitions": {
          "Content articles\",": "Content articles\",",
          "OIP articles\",": "OIP articles\",",
          "Same pattern, different domain\",": "Same pattern, different domain\","
        },
        "routes": {
          "read_article": "GET https://miscsubjects.com/a/oip-articles-content-plane",
          "read_bundle": "GET https://miscsubjects.com/api/articles/oip-articles-content-plane/bundle",
          "read_bundle_markdown": "GET https://miscsubjects.com/api/articles/oip-articles-content-plane/bundle?format=markdown"
        },
        "examples": [
          {
            "description": "Read Articles and content objects",
            "curl": "curl -s 'https://miscsubjects.com/a/oip-articles-content-plane'"
          }
        ],
        "test_questions": [
          "What is the exact URL to read this article (oip-articles-content-plane)?",
          "What is the main concept explained in Articles and content objects?",
          "What is the difference between a peptide article and an OIP article?"
        ],
        "dependencies": [
          "oip-what-is-object"
        ],
        "scoring_rubric": {
          "json_clarity": "Can the model identify all routes and definitions from the schema?",
          "english_clarity": "Can a zero-context reader explain the core concept without guessing?",
          "operability": "Can the model compose the exact curl for each route?"
        }
      }
    },
    {
      "slug": "oip-files-deploy",
      "title": "Files, repo, and deploy",
      "human_page": "https://miscsubjects.com/a/oip-files-deploy",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-files-deploy/bundle?format=markdown",
      "machine_schema": {
        "definitions": {
          "Operational files\",": "Operational files\",",
          "File objects\",": "File objects\",",
          "Deploy\",": "Deploy\","
        },
        "routes": {
          "read_article": "GET https://miscsubjects.com/a/oip-files-deploy",
          "read_bundle": "GET https://miscsubjects.com/api/articles/oip-files-deploy/bundle",
          "read_bundle_markdown": "GET https://miscsubjects.com/api/articles/oip-files-deploy/bundle?format=markdown"
        },
        "examples": [
          {
            "description": "Read Files, repo, and deploy",
            "curl": "curl -s 'https://miscsubjects.com/a/oip-files-deploy'"
          }
        ],
        "test_questions": [
          "What is the exact URL to read this article (oip-files-deploy)?",
          "What is the main concept explained in Files, repo, and deploy?",
          "Where do operational files live vs bulk data?"
        ],
        "dependencies": [
          "oip-what-is-object"
        ],
        "scoring_rubric": {
          "json_clarity": "Can the model identify all routes and definitions from the schema?",
          "english_clarity": "Can a zero-context reader explain the core concept without guessing?",
          "operability": "Can the model compose the exact curl for each route?"
        }
      }
    },
    {
      "slug": "oip-self-test-proof",
      "title": "Self-test and proof",
      "human_page": "https://miscsubjects.com/a/oip-self-test-proof",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-self-test-proof/bundle?format=markdown",
      "machine_schema": {
        "definitions": {
          "Self-test\",": "Self-test\",",
          "Proof\",": "Proof\",",
          "Regression\",": "Regression\","
        },
        "routes": {
          "read_article": "GET https://miscsubjects.com/a/oip-self-test-proof",
          "read_bundle": "GET https://miscsubjects.com/api/articles/oip-self-test-proof/bundle",
          "read_bundle_markdown": "GET https://miscsubjects.com/api/articles/oip-self-test-proof/bundle?format=markdown"
        },
        "examples": [
          {
            "description": "Read Self-test and proof",
            "curl": "curl -s 'https://miscsubjects.com/a/oip-self-test-proof'"
          }
        ],
        "test_questions": [
          "What is the exact URL to read this article (oip-self-test-proof)?",
          "What is the main concept explained in Self-test and proof?",
          "What is the difference between a description and a proof?"
        ],
        "dependencies": [
          "oip-what-is-object",
          "oip-ledger-receipts"
        ],
        "scoring_rubric": {
          "json_clarity": "Can the model identify all routes and definitions from the schema?",
          "english_clarity": "Can a zero-context reader explain the core concept without guessing?",
          "operability": "Can the model compose the exact curl for each route?"
        }
      }
    },
    {
      "slug": "oip-operating-playbook",
      "title": "OIP operating playbook",
      "human_page": "https://miscsubjects.com/a/oip-operating-playbook",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-operating-playbook/bundle?format=markdown",
      "machine_schema": {
        "definitions": {
          "The playbook\",": "The playbook\",",
          "Do not guess\",": "Do not guess\",",
          "Close the loop\",": "Close the loop\","
        },
        "routes": {
          "read_article": "GET https://miscsubjects.com/a/oip-operating-playbook",
          "read_bundle": "GET https://miscsubjects.com/api/articles/oip-operating-playbook/bundle",
          "read_bundle_markdown": "GET https://miscsubjects.com/api/articles/oip-operating-playbook/bundle?format=markdown"
        },
        "examples": [
          {
            "description": "Read OIP operating playbook",
            "curl": "curl -s 'https://miscsubjects.com/a/oip-operating-playbook'"
          }
        ],
        "test_questions": [
          "What is the exact URL to read this article (oip-operating-playbook)?",
          "What is the main concept explained in OIP operating playbook?",
          "What is the universal rule for operating the build?"
        ],
        "dependencies": [
          "oip-build-overview"
        ],
        "scoring_rubric": {
          "json_clarity": "Can the model identify all routes and definitions from the schema?",
          "english_clarity": "Can a zero-context reader explain the core concept without guessing?",
          "operability": "Can the model compose the exact curl for each route?"
        }
      }
    },
    {
      "slug": "oip-api",
      "title": "What is an API?",
      "human_page": "https://miscsubjects.com/a/oip-api",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-api/bundle?format=markdown",
      "machine_schema": {
        "definitions": {
          "What this article explains\",": "What this article explains\",",
          "Plain words\",": "Plain words\",",
          "How APIs work in OIP\",": "How APIs work in OIP\",",
          "Machine shape\",": "Machine shape\","
        },
        "routes": {
          "read_article": "GET https://miscsubjects.com/a/oip-api",
          "read_bundle": "GET https://miscsubjects.com/api/articles/oip-api/bundle",
          "read_bundle_markdown": "GET https://miscsubjects.com/api/articles/oip-api/bundle?format=markdown",
          "invoke": "POST https://miscsubjects.com/api/dispatch {key, body}",
          "read_object": "GET https://miscsubjects.com/api/dispatch?key=<KEY>&format=markdown"
        },
        "examples": [
          {
            "description": "Read What is an API?",
            "curl": "curl -s 'https://miscsubjects.com/a/oip-api'"
          }
        ],
        "test_questions": [
          "What is the exact URL to read this article (oip-api)?",
          "What is the main concept explained in What is an API??",
          "What is the difference between GET and POST in this build?",
          "What headers are required for a POST request?"
        ],
        "dependencies": [
          "oip-what-is-object",
          "oip-curl"
        ],
        "scoring_rubric": {
          "json_clarity": "Can the model identify all routes and definitions from the schema?",
          "english_clarity": "Can a zero-context reader explain the core concept without guessing?",
          "operability": "Can the model compose the exact curl for each route?"
        }
      }
    },
    {
      "slug": "oip-rest",
      "title": "What is REST?",
      "human_page": "https://miscsubjects.com/a/oip-rest",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-rest/bundle?format=markdown",
      "machine_schema": {
        "definitions": {
          "What this article explains\",": "What this article explains\",",
          "Plain words\",": "Plain words\",",
          "How REST works in this build\",": "How REST works in this build\",",
          "Machine shape\",": "Machine shape\","
        },
        "routes": {
          "read_article": "GET https://miscsubjects.com/a/oip-rest",
          "read_bundle": "GET https://miscsubjects.com/api/articles/oip-rest/bundle",
          "read_bundle_markdown": "GET https://miscsubjects.com/api/articles/oip-rest/bundle?format=markdown",
          "invoke": "POST https://miscsubjects.com/api/dispatch {key, body}",
          "read_object": "GET https://miscsubjects.com/api/dispatch?key=<KEY>&format=markdown"
        },
        "examples": [
          {
            "description": "Read What is REST?",
            "curl": "curl -s 'https://miscsubjects.com/a/oip-rest'"
          }
        ],
        "test_questions": [
          "What is the exact URL to read this article (oip-rest)?",
          "What is the main concept explained in What is REST??",
          "What does GET do vs POST in REST?",
          "What URL pattern identifies a resource?"
        ],
        "dependencies": [
          "oip-api",
          "oip-what-is-object"
        ],
        "scoring_rubric": {
          "json_clarity": "Can the model identify all routes and definitions from the schema?",
          "english_clarity": "Can a zero-context reader explain the core concept without guessing?",
          "operability": "Can the model compose the exact curl for each route?"
        }
      }
    },
    {
      "slug": "oip-curl",
      "title": "How to operate the build with curl",
      "human_page": "https://miscsubjects.com/a/oip-curl",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-curl/bundle?format=markdown",
      "machine_schema": {
        "definitions": {
          "What this article explains\",": "What this article explains\",",
          "Read\",": "Read\",",
          "Write or run\",": "Write or run\",",
          "Dispatch\",": "Dispatch\",",
          "Machine shape\",": "Machine shape\","
        },
        "routes": {
          "read_article": "GET https://miscsubjects.com/a/oip-curl",
          "read_bundle": "GET https://miscsubjects.com/api/articles/oip-curl/bundle",
          "read_bundle_markdown": "GET https://miscsubjects.com/api/articles/oip-curl/bundle?format=markdown",
          "example_read": "curl -s 'https://miscsubjects.com/api/dispatch?orient=1&format=markdown'",
          "example_invoke": "curl -X POST https://miscsubjects.com/api/dispatch -d '{\"key\":\"NOW\",\"body\":\"\"}'"
        },
        "examples": [
          {
            "description": "Read How to operate the build with curl",
            "curl": "curl -s 'https://miscsubjects.com/a/oip-curl'"
          }
        ],
        "test_questions": [
          "What is the exact URL to read this article (oip-curl)?",
          "What is the main concept explained in How to operate the build with curl?",
          "What is the exact curl to read an object?",
          "What is the exact curl to invoke an object?"
        ],
        "dependencies": [
          "oip-api",
          "oip-rest"
        ],
        "scoring_rubric": {
          "json_clarity": "Can the model identify all routes and definitions from the schema?",
          "english_clarity": "Can a zero-context reader explain the core concept without guessing?",
          "operability": "Can the model compose the exact curl for each route?"
        }
      }
    },
    {
      "slug": "oip-cli",
      "title": "What is a CLI?",
      "human_page": "https://miscsubjects.com/a/oip-cli",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-cli/bundle?format=markdown",
      "machine_schema": {
        "definitions": {
          "What this article explains\",": "What this article explains\",",
          "Plain words\",": "Plain words\",",
          "How CLIs work in OIP\",": "How CLIs work in OIP\",",
          "Machine shape\",": "Machine shape\","
        },
        "routes": {
          "read_article": "GET https://miscsubjects.com/a/oip-cli",
          "read_bundle": "GET https://miscsubjects.com/api/articles/oip-cli/bundle",
          "read_bundle_markdown": "GET https://miscsubjects.com/api/articles/oip-cli/bundle?format=markdown"
        },
        "examples": [
          {
            "description": "Read What is a CLI?",
            "curl": "curl -s 'https://miscsubjects.com/a/oip-cli'"
          }
        ],
        "test_questions": [
          "What is the exact URL to read this article (oip-cli)?",
          "What is the main concept explained in What is a CLI??",
          "What is the OIP object for running a shell command?"
        ],
        "dependencies": [
          "oip-what-is-object"
        ],
        "scoring_rubric": {
          "json_clarity": "Can the model identify all routes and definitions from the schema?",
          "english_clarity": "Can a zero-context reader explain the core concept without guessing?",
          "operability": "Can the model compose the exact curl for each route?"
        }
      }
    },
    {
      "slug": "oip-mcp",
      "title": "What is MCP?",
      "human_page": "https://miscsubjects.com/a/oip-mcp",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-mcp/bundle?format=markdown",
      "machine_schema": {
        "definitions": {
          "mcp": "Model Context Protocol: a model client connects to a server over a session and the server exposes tools, resources, and prompts.",
          "oip_object_for_mcp": "an MCP tool registered as an OIP directory object with runner type mcp, invoked by URL and recorded by receipt.",
          "containment": "OIP registers a server's MCP tool as one object among its runners and reaches it through a URL.",
          "example_object": "MCP_context7_resolve_library_id"
        },
        "routes": {
          "read_article": "GET https://miscsubjects.com/a/oip-mcp",
          "read_bundle": "GET https://miscsubjects.com/api/articles/oip-mcp/bundle",
          "read_bundle_markdown": "GET https://miscsubjects.com/api/articles/oip-mcp/bundle?format=markdown",
          "compare_mcp_oip": "GET https://miscsubjects.com/a/oip-mcp"
        },
        "examples": [
          {
            "description": "Read What is MCP?",
            "curl": "curl -s 'https://miscsubjects.com/a/oip-mcp'"
          }
        ],
        "test_questions": [
          "What is the exact URL to read this article (oip-mcp)?",
          "What is the main concept explained in What is MCP??",
          "What is the main difference between MCP and OIP?",
          "Does MCP have receipts?"
        ],
        "dependencies": [
          "oip-what-is-object",
          "oip-api"
        ],
        "scoring_rubric": {
          "json_clarity": "Can the model identify all routes and definitions from the schema?",
          "english_clarity": "Can a zero-context reader explain the core concept without guessing?",
          "operability": "Can the model compose the exact curl for each route?"
        }
      }
    },
    {
      "slug": "oip-github",
      "title": "What is GitHub?",
      "human_page": "https://miscsubjects.com/a/oip-github",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-github/bundle?format=markdown",
      "machine_schema": {
        "definitions": {
          "What this article explains\",": "What this article explains\",",
          "Plain words\",": "Plain words\",",
          "How GitHub works in this build\",": "How GitHub works in this build\",",
          "Machine shape\",": "Machine shape\","
        },
        "routes": {
          "read_article": "GET https://miscsubjects.com/a/oip-github",
          "read_bundle": "GET https://miscsubjects.com/api/articles/oip-github/bundle",
          "read_bundle_markdown": "GET https://miscsubjects.com/api/articles/oip-github/bundle?format=markdown"
        },
        "examples": [
          {
            "description": "Read What is GitHub?",
            "curl": "curl -s 'https://miscsubjects.com/a/oip-github'"
          }
        ],
        "test_questions": [
          "What is the exact URL to read this article (oip-github)?",
          "What is the main concept explained in What is GitHub??",
          "What is the OIP way to read a GitHub file?"
        ],
        "dependencies": [
          "oip-what-is-object",
          "oip-api"
        ],
        "scoring_rubric": {
          "json_clarity": "Can the model identify all routes and definitions from the schema?",
          "english_clarity": "Can a zero-context reader explain the core concept without guessing?",
          "operability": "Can the model compose the exact curl for each route?"
        }
      }
    },
    {
      "slug": "oip-github-mcp",
      "title": "What is GitHub MCP?",
      "human_page": "https://miscsubjects.com/a/oip-github-mcp",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-github-mcp/bundle?format=markdown",
      "machine_schema": {
        "definitions": {
          "What this article explains\",": "What this article explains\",",
          "OIP comparison\",": "OIP comparison\",",
          "Machine shape\",": "Machine shape\","
        },
        "routes": {
          "read_article": "GET https://miscsubjects.com/a/oip-github-mcp",
          "read_bundle": "GET https://miscsubjects.com/api/articles/oip-github-mcp/bundle",
          "read_bundle_markdown": "GET https://miscsubjects.com/api/articles/oip-github-mcp/bundle?format=markdown",
          "compare_mcp_oip": "GET https://miscsubjects.com/a/oip-mcp"
        },
        "examples": [
          {
            "description": "Read What is GitHub MCP?",
            "curl": "curl -s 'https://miscsubjects.com/a/oip-github-mcp'"
          }
        ],
        "test_questions": [
          "What is the exact URL to read this article (oip-github-mcp)?",
          "What is the main concept explained in What is GitHub MCP??",
          "What is the main difference between MCP and OIP?",
          "Does MCP have receipts?"
        ],
        "dependencies": [
          "oip-mcp",
          "oip-github"
        ],
        "scoring_rubric": {
          "json_clarity": "Can the model identify all routes and definitions from the schema?",
          "english_clarity": "Can a zero-context reader explain the core concept without guessing?",
          "operability": "Can the model compose the exact curl for each route?"
        }
      }
    },
    {
      "slug": "oip-link-structure",
      "title": "OIP link structure",
      "human_page": "https://miscsubjects.com/a/oip-link-structure",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-link-structure/bundle?format=markdown",
      "machine_schema": {
        "definitions": {
          "What this article explains\",": "What this article explains\",",
          "Link types\",": "Link types\",",
          "Rule\",": "Rule\",",
          "Machine shape\",": "Machine shape\","
        },
        "routes": {
          "read_article": "GET https://miscsubjects.com/a/oip-link-structure",
          "read_bundle": "GET https://miscsubjects.com/api/articles/oip-link-structure/bundle",
          "read_bundle_markdown": "GET https://miscsubjects.com/api/articles/oip-link-structure/bundle?format=markdown"
        },
        "examples": [
          {
            "description": "Read OIP link structure",
            "curl": "curl -s 'https://miscsubjects.com/a/oip-link-structure'"
          }
        ],
        "test_questions": [
          "What is the exact URL to read this article (oip-link-structure)?",
          "What is the main concept explained in OIP link structure?",
          "What makes a link self-explaining?"
        ],
        "dependencies": [
          "oip-what-is-object"
        ],
        "scoring_rubric": {
          "json_clarity": "Can the model identify all routes and definitions from the schema?",
          "english_clarity": "Can a zero-context reader explain the core concept without guessing?",
          "operability": "Can the model compose the exact curl for each route?"
        }
      }
    },
    {
      "slug": "oip-drop-end-to-end",
      "title": "OIP drop end to end",
      "human_page": "https://miscsubjects.com/a/oip-drop-end-to-end",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-drop-end-to-end/bundle?format=markdown",
      "machine_schema": {
        "definitions": {
          "What this article explains\",": "What this article explains\",",
          "What a drop carries\",": "What a drop carries\",",
          "End to end\",": "End to end\",",
          "Machine shape\",": "Machine shape\","
        },
        "routes": {
          "read_article": "GET https://miscsubjects.com/a/oip-drop-end-to-end",
          "read_bundle": "GET https://miscsubjects.com/api/articles/oip-drop-end-to-end/bundle",
          "read_bundle_markdown": "GET https://miscsubjects.com/api/articles/oip-drop-end-to-end/bundle?format=markdown"
        },
        "examples": [
          {
            "description": "Read OIP drop end to end",
            "curl": "curl -s 'https://miscsubjects.com/a/oip-drop-end-to-end'"
          }
        ],
        "test_questions": [
          "What is the exact URL to read this article (oip-drop-end-to-end)?",
          "What is the main concept explained in OIP drop end to end?",
          "What is the end-to-end flow of an OIP drop?"
        ],
        "dependencies": [
          "oip-tap-go"
        ],
        "scoring_rubric": {
          "json_clarity": "Can the model identify all routes and definitions from the schema?",
          "english_clarity": "Can a zero-context reader explain the core concept without guessing?",
          "operability": "Can the model compose the exact curl for each route?"
        }
      }
    },
    {
      "slug": "oip-cron-recursion",
      "title": "Cron and recursive review",
      "human_page": "https://miscsubjects.com/a/oip-cron-recursion",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-cron-recursion/bundle?format=markdown",
      "machine_schema": {
        "definitions": {
          "What this article explains\",": "What this article explains\",",
          "OIP review loop\",": "OIP review loop\",",
          "Why one task per tick\",": "Why one task per tick\",",
          "Machine shape\",": "Machine shape\","
        },
        "routes": {
          "read_article": "GET https://miscsubjects.com/a/oip-cron-recursion",
          "read_bundle": "GET https://miscsubjects.com/api/articles/oip-cron-recursion/bundle",
          "read_bundle_markdown": "GET https://miscsubjects.com/api/articles/oip-cron-recursion/bundle?format=markdown"
        },
        "examples": [
          {
            "description": "Read Cron and recursive review",
            "curl": "curl -s 'https://miscsubjects.com/a/oip-cron-recursion'"
          }
        ],
        "test_questions": [
          "What is the exact URL to read this article (oip-cron-recursion)?",
          "What is the main concept explained in Cron and recursive review?",
          "What is the KV gate for the review loop?"
        ],
        "dependencies": [
          "oip-build-overview",
          "oip-model-review-loop"
        ],
        "scoring_rubric": {
          "json_clarity": "Can the model identify all routes and definitions from the schema?",
          "english_clarity": "Can a zero-context reader explain the core concept without guessing?",
          "operability": "Can the model compose the exact curl for each route?"
        }
      }
    },
    {
      "slug": "oip-model-review-loop",
      "title": "Models reviewing OIP articles",
      "human_page": "https://miscsubjects.com/a/oip-model-review-loop",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-model-review-loop/bundle?format=markdown",
      "machine_schema": {
        "definitions": {
          "What this article explains\",": "What this article explains\",",
          "Questions\",": "Questions\",",
          "Output\",": "Output\",",
          "Machine shape\",": "Machine shape\","
        },
        "routes": {
          "read_article": "GET https://miscsubjects.com/a/oip-model-review-loop",
          "read_bundle": "GET https://miscsubjects.com/api/articles/oip-model-review-loop/bundle",
          "read_bundle_markdown": "GET https://miscsubjects.com/api/articles/oip-model-review-loop/bundle?format=markdown"
        },
        "examples": [
          {
            "description": "Read Models reviewing OIP articles",
            "curl": "curl -s 'https://miscsubjects.com/a/oip-model-review-loop'"
          }
        ],
        "test_questions": [
          "What is the exact URL to read this article (oip-model-review-loop)?",
          "What is the main concept explained in Models reviewing OIP articles?",
          "What does a model score when reviewing an OIP article?"
        ],
        "dependencies": [
          "oip-build-overview",
          "oip-model-review-loop"
        ],
        "scoring_rubric": {
          "json_clarity": "Can the model identify all routes and definitions from the schema?",
          "english_clarity": "Can a zero-context reader explain the core concept without guessing?",
          "operability": "Can the model compose the exact curl for each route?"
        }
      }
    },
    {
      "slug": "oip-spec",
      "title": "The OIP specification — and the proof it is a protocol",
      "human_page": "https://miscsubjects.com/a/oip-spec",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-spec/bundle?format=markdown",
      "machine_schema": {
        "definitions": {
          "What makes something a protocol\",": "What makes something a protocol\",",
          "Run the proof yourself\",": "Run the proof yourself\",",
          "The message formats\",": "The message formats\",",
          "The 14 conformance clauses\",": "The 14 conformance clauses\",",
          "Why this ends the argument\",": "Why this ends the argument\","
        },
        "routes": {
          "read_article": "GET https://miscsubjects.com/a/oip-spec",
          "read_bundle": "GET https://miscsubjects.com/api/articles/oip-spec/bundle",
          "read_bundle_markdown": "GET https://miscsubjects.com/api/articles/oip-spec/bundle?format=markdown"
        },
        "examples": [
          {
            "description": "Read The OIP specification — and the proof it is a protocol",
            "curl": "curl -s 'https://miscsubjects.com/a/oip-spec'"
          }
        ],
        "test_questions": [
          "What is the exact URL to read this article (oip-spec)?",
          "What is the main concept explained in The OIP specification — and the proof it is a protocol?",
          "What makes something a protocol?",
          "What is the URL to prove OIP is a protocol?"
        ],
        "dependencies": [
          "oip-build-overview"
        ],
        "scoring_rubric": {
          "json_clarity": "Can the model identify all routes and definitions from the schema?",
          "english_clarity": "Can a zero-context reader explain the core concept without guessing?",
          "operability": "Can the model compose the exact curl for each route?"
        }
      }
    },
    {
      "slug": "oip-what-is-object",
      "title": "What is an object?",
      "human_page": "https://miscsubjects.com/a/oip-what-is-object",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-what-is-object/bundle?format=markdown",
      "machine_schema": {
        "definitions": {
          "What an object is\",": "What an object is\",",
          "Why it matters\",": "Why it matters\",",
          "Example objects in this build\",": "Example objects in this build\",",
          "NOW": "NOW",
          "SEND_BY_CHANNEL": "SEND_BY_CHANNEL",
          "LOCAL_EXEC": "LOCAL_EXEC",
          "DIR_PATCH": "DIR_PATCH",
          "Machine shape\",": "Machine shape\","
        },
        "routes": {
          "read_article": "GET https://miscsubjects.com/a/oip-what-is-object",
          "read_bundle": "GET https://miscsubjects.com/api/articles/oip-what-is-object/bundle",
          "read_bundle_markdown": "GET https://miscsubjects.com/api/articles/oip-what-is-object/bundle?format=markdown"
        },
        "examples": [
          {
            "description": "Read What is an object?",
            "curl": "curl -s 'https://miscsubjects.com/a/oip-what-is-object'"
          }
        ],
        "test_questions": [
          "What is the exact URL to read this article (oip-what-is-object)?",
          "What is the main concept explained in What is an object??",
          "What are the three forms of every OIP object?"
        ],
        "dependencies": [
          "oip-build-overview"
        ],
        "scoring_rubric": {
          "json_clarity": "Can the model identify all routes and definitions from the schema?",
          "english_clarity": "Can a zero-context reader explain the core concept without guessing?",
          "operability": "Can the model compose the exact curl for each route?"
        }
      }
    },
    {
      "slug": "oip-what-is-capability",
      "title": "What is a capability?",
      "human_page": "https://miscsubjects.com/a/oip-what-is-capability",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-what-is-capability/bundle?format=markdown",
      "machine_schema": {
        "definitions": {
          "What a capability is\",": "What a capability is\",",
          "Why it matters\",": "Why it matters\",",
          "Shapes\",": "Shapes\",",
          "row:KEY": "row:KEY",
          "rows:K1,K2": "rows:K1,K2",
          "pfx:PREFIX": "pfx:PREFIX",
          "act": "act",
          "Fields on every capability\",": "Fields on every capability\","
        },
        "routes": {
          "read_article": "GET https://miscsubjects.com/a/oip-what-is-capability",
          "read_bundle": "GET https://miscsubjects.com/api/articles/oip-what-is-capability/bundle",
          "read_bundle_markdown": "GET https://miscsubjects.com/api/articles/oip-what-is-capability/bundle?format=markdown"
        },
        "examples": [
          {
            "description": "Read What is a capability?",
            "curl": "curl -s 'https://miscsubjects.com/a/oip-what-is-capability'"
          }
        ],
        "test_questions": [
          "What is the exact URL to read this article (oip-what-is-capability)?",
          "What is the main concept explained in What is a capability??",
          "What are the four capability shapes?",
          "What is risk_ceiling?"
        ],
        "dependencies": [
          "oip-what-is-object"
        ],
        "scoring_rubric": {
          "json_clarity": "Can the model identify all routes and definitions from the schema?",
          "english_clarity": "Can a zero-context reader explain the core concept without guessing?",
          "operability": "Can the model compose the exact curl for each route?"
        }
      }
    },
    {
      "slug": "oip-what-is-token",
      "title": "What is a token?",
      "human_page": "https://miscsubjects.com/a/oip-what-is-token",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-what-is-token/bundle?format=markdown",
      "machine_schema": {
        "definitions": {
          "What a token is\",": "What a token is\",",
          "Why it matters\",": "Why it matters\",",
          "What a token looks like\",": "What a token looks like\",",
          "Machine shape\",": "Machine shape\","
        },
        "routes": {
          "read_article": "GET https://miscsubjects.com/a/oip-what-is-token",
          "read_bundle": "GET https://miscsubjects.com/api/articles/oip-what-is-token/bundle",
          "read_bundle_markdown": "GET https://miscsubjects.com/api/articles/oip-what-is-token/bundle?format=markdown"
        },
        "examples": [
          {
            "description": "Read What is a token?",
            "curl": "curl -s 'https://miscsubjects.com/a/oip-what-is-token'"
          }
        ],
        "test_questions": [
          "What is the exact URL to read this article (oip-what-is-token)?",
          "What is the main concept explained in What is a token??",
          "What is the difference between a row token and an act token?",
          "How do you revoke a capability?"
        ],
        "dependencies": [
          "oip-what-is-capability"
        ],
        "scoring_rubric": {
          "json_clarity": "Can the model identify all routes and definitions from the schema?",
          "english_clarity": "Can a zero-context reader explain the core concept without guessing?",
          "operability": "Can the model compose the exact curl for each route?"
        }
      }
    },
    {
      "slug": "oip-what-is-tenant",
      "title": "What is a tenant?",
      "human_page": "https://miscsubjects.com/a/oip-what-is-tenant",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-what-is-tenant/bundle?format=markdown",
      "machine_schema": {
        "definitions": {
          "What a tenant is\",": "What a tenant is\",",
          "Why it matters\",": "Why it matters\",",
          "Proof\",": "Proof\",",
          "Machine shape\",": "Machine shape\","
        },
        "routes": {
          "read_article": "GET https://miscsubjects.com/a/oip-what-is-tenant",
          "read_bundle": "GET https://miscsubjects.com/api/articles/oip-what-is-tenant/bundle",
          "read_bundle_markdown": "GET https://miscsubjects.com/api/articles/oip-what-is-tenant/bundle?format=markdown"
        },
        "examples": [
          {
            "description": "Read What is a tenant?",
            "curl": "curl -s 'https://miscsubjects.com/a/oip-what-is-tenant'"
          }
        ],
        "test_questions": [
          "What is the exact URL to read this article (oip-what-is-tenant)?",
          "What is the main concept explained in What is a tenant??",
          "What happens when a tenant is suspended?",
          "Can a tenant read another tenant's ledger?"
        ],
        "dependencies": [
          "oip-what-is-capability",
          "oip-what-is-token"
        ],
        "scoring_rubric": {
          "json_clarity": "Can the model identify all routes and definitions from the schema?",
          "english_clarity": "Can a zero-context reader explain the core concept without guessing?",
          "operability": "Can the model compose the exact curl for each route?"
        }
      }
    },
    {
      "slug": "oip-voxel-graph",
      "title": "What is a voxel graph?",
      "human_page": "https://miscsubjects.com/a/oip-voxel-graph",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-voxel-graph/bundle?format=markdown",
      "machine_schema": {
        "definitions": {
          "What a voxel graph is\",": "What a voxel graph is\",",
          "Why it matters\",": "Why it matters\",",
          "Machine shape\",": "Machine shape\",",
          "Proof\",": "Proof\","
        },
        "routes": {
          "read_article": "GET https://miscsubjects.com/a/oip-voxel-graph",
          "read_bundle": "GET https://miscsubjects.com/api/articles/oip-voxel-graph/bundle",
          "read_bundle_markdown": "GET https://miscsubjects.com/api/articles/oip-voxel-graph/bundle?format=markdown"
        },
        "examples": [
          {
            "description": "Read What is a voxel graph?",
            "curl": "curl -s 'https://miscsubjects.com/a/oip-voxel-graph'"
          }
        ],
        "test_questions": [
          "What is the exact URL to read this article (oip-voxel-graph)?",
          "What is the main concept explained in What is a voxel graph??",
          "What is a node vs an edge in the voxel graph?"
        ],
        "dependencies": [
          "oip-build-overview",
          "oip-what-is-object"
        ],
        "scoring_rubric": {
          "json_clarity": "Can the model identify all routes and definitions from the schema?",
          "english_clarity": "Can a zero-context reader explain the core concept without guessing?",
          "operability": "Can the model compose the exact curl for each route?"
        }
      }
    },
    {
      "slug": "oip-cookbook",
      "title": "The OIP cookbook — the exact curl for everything",
      "human_page": "https://miscsubjects.com/a/oip-cookbook",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-cookbook/bundle?format=markdown",
      "machine_schema": {
        "definitions": {
          "What this article is\",": "What this article is\",",
          "Step zero — get a token (OWNER, do this once)\",": "Step zero — get a token (OWNER, do this once)\",",
          "Read (public — no credentials)\",": "Read (public — no credentials)\",",
          "Act (TOKEN)\",": "Act (TOKEN)\",",
          "Verify (TOKEN)\",": "Verify (TOKEN)\",",
          "Replay and repair (OWNER or act token)\",": "Replay and repair (OWNER or act token)\",",
          "The article system (OWNER)\",": "The article system (OWNER)\",",
          "Token management (OWNER)\",": "Token management (OWNER)\","
        },
        "routes": {
          "read_article": "GET https://miscsubjects.com/a/oip-cookbook",
          "read_bundle": "GET https://miscsubjects.com/api/articles/oip-cookbook/bundle",
          "read_bundle_markdown": "GET https://miscsubjects.com/api/articles/oip-cookbook/bundle?format=markdown"
        },
        "examples": [
          {
            "description": "Read The OIP cookbook — the exact curl for everything",
            "curl": "curl -s 'https://miscsubjects.com/a/oip-cookbook'"
          }
        ],
        "test_questions": [
          "What is the exact URL to read this article (oip-cookbook)?",
          "What is the main concept explained in The OIP cookbook — the exact curl for everything?",
          "What is the exact curl to text Cyrus?",
          "What is the exact curl to read a receipt?"
        ],
        "dependencies": [
          "oip-curl",
          "oip-ledger-receipts"
        ],
        "scoring_rubric": {
          "json_clarity": "Can the model identify all routes and definitions from the schema?",
          "english_clarity": "Can a zero-context reader explain the core concept without guessing?",
          "operability": "Can the model compose the exact curl for each route?"
        }
      }
    },
    {
      "slug": "oip-mcp-github",
      "title": "What a model sees: MCP GitHub vs the OIP directory",
      "human_page": "https://miscsubjects.com/a/oip-mcp-github",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-mcp-github/bundle?format=markdown",
      "machine_schema": {
        "definitions": {
          "The question this answers\",": "The question this answers\",",
          "MCP GitHub: the wire exchange\",": "MCP GitHub: the wire exchange\",",
          "The same job through OIP\",": "The same job through OIP\",",
          "The honest comparison\",": "The honest comparison\",",
          "See both catalogs live\",": "See both catalogs live\","
        },
        "routes": {
          "read_article": "GET https://miscsubjects.com/a/oip-mcp-github",
          "read_bundle": "GET https://miscsubjects.com/api/articles/oip-mcp-github/bundle",
          "read_bundle_markdown": "GET https://miscsubjects.com/api/articles/oip-mcp-github/bundle?format=markdown",
          "compare_mcp_oip": "GET https://miscsubjects.com/a/oip-mcp"
        },
        "examples": [
          {
            "description": "Read What a model sees: MCP GitHub vs the OIP directory",
            "curl": "curl -s 'https://miscsubjects.com/a/oip-mcp-github'"
          }
        ],
        "test_questions": [
          "What is the exact URL to read this article (oip-mcp-github)?",
          "What is the main concept explained in What a model sees: MCP GitHub vs the OIP directory?",
          "What is the main difference between MCP and OIP?",
          "Does MCP have receipts?"
        ],
        "dependencies": [],
        "scoring_rubric": {
          "json_clarity": "Can the model identify all routes and definitions from the schema?",
          "english_clarity": "Can a zero-context reader explain the core concept without guessing?",
          "operability": "Can the model compose the exact curl for each route?"
        }
      }
    },
    {
      "slug": "oip-mcp-stripe",
      "title": "What a model sees: MCP Stripe vs the OIP directory",
      "human_page": "https://miscsubjects.com/a/oip-mcp-stripe",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-mcp-stripe/bundle?format=markdown",
      "machine_schema": {
        "definitions": {
          "The question this answers\",": "The question this answers\",",
          "MCP Stripe: the wire exchange\",": "MCP Stripe: the wire exchange\",",
          "The same capability as OIP rows\",": "The same capability as OIP rows\",",
          "Standing rule on this build\",": "Standing rule on this build\",",
          "The honest comparison\",": "The honest comparison\","
        },
        "routes": {
          "read_article": "GET https://miscsubjects.com/a/oip-mcp-stripe",
          "read_bundle": "GET https://miscsubjects.com/api/articles/oip-mcp-stripe/bundle",
          "read_bundle_markdown": "GET https://miscsubjects.com/api/articles/oip-mcp-stripe/bundle?format=markdown",
          "compare_mcp_oip": "GET https://miscsubjects.com/a/oip-mcp"
        },
        "examples": [
          {
            "description": "Read What a model sees: MCP Stripe vs the OIP directory",
            "curl": "curl -s 'https://miscsubjects.com/a/oip-mcp-stripe'"
          }
        ],
        "test_questions": [
          "What is the exact URL to read this article (oip-mcp-stripe)?",
          "What is the main concept explained in What a model sees: MCP Stripe vs the OIP directory?",
          "What is the main difference between MCP and OIP?",
          "Does MCP have receipts?"
        ],
        "dependencies": [
          "oip-mcp",
          "oip-stripe"
        ],
        "scoring_rubric": {
          "json_clarity": "Can the model identify all routes and definitions from the schema?",
          "english_clarity": "Can a zero-context reader explain the core concept without guessing?",
          "operability": "Can the model compose the exact curl for each route?"
        }
      }
    },
    {
      "slug": "oip-api",
      "title": "What is an API?",
      "human_page": "https://miscsubjects.com/a/oip-api",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-api/bundle?format=markdown",
      "author_model": "gemini/gemini-2.5-flash",
      "version": 2,
      "machine_written": true
    },
    {
      "slug": "oip-articles-content-plane",
      "title": "Articles and content objects",
      "human_page": "https://miscsubjects.com/a/oip-articles-content-plane",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-articles-content-plane/bundle?format=markdown",
      "author_model": "@cf/meta/llama-3.3-70b-instruct-fp8-fast",
      "version": 1,
      "machine_written": true
    },
    {
      "slug": "oip-build-overview",
      "title": "OIP build overview",
      "human_page": "https://miscsubjects.com/a/oip-build-overview",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-build-overview/bundle?format=markdown",
      "author_model": "gemini/gemini-2.5-flash",
      "version": 6,
      "machine_written": true
    },
    {
      "slug": "oip-cli",
      "title": "What is a CLI?",
      "human_page": "https://miscsubjects.com/a/oip-cli",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-cli/bundle?format=markdown",
      "author_model": "gemini/gemini-2.5-flash",
      "version": 1,
      "machine_written": true
    },
    {
      "slug": "oip-cloudflare-pages",
      "title": "Cloudflare Pages",
      "human_page": "https://miscsubjects.com/a/oip-cloudflare-pages",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-cloudflare-pages/bundle?format=markdown",
      "author_model": "@cf/meta/llama-3.3-70b-instruct-fp8-fast",
      "version": 1,
      "machine_written": true
    },
    {
      "slug": "oip-cron-recursion",
      "title": "Cron and recursive review",
      "human_page": "https://miscsubjects.com/a/oip-cron-recursion",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-cron-recursion/bundle?format=markdown",
      "author_model": "gemini/gemini-2.5-flash",
      "version": 1,
      "machine_written": true
    },
    {
      "slug": "oip-curl",
      "title": "How to operate the miscsubjects.com build with curl",
      "human_page": "https://miscsubjects.com/a/oip-curl",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-curl/bundle?format=markdown",
      "author_model": "gemini/gemini-2.5-flash",
      "version": 2,
      "machine_written": true
    },
    {
      "slug": "oip-curl-examples",
      "title": "Curl Examples for OIP",
      "human_page": "https://miscsubjects.com/a/oip-curl-examples",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-curl-examples/bundle?format=markdown",
      "author_model": "gemini/gemini-2.5-flash",
      "version": 1,
      "machine_written": true
    },
    {
      "slug": "oip-directory-dispatch",
      "title": "Directory rows and dispatch",
      "human_page": "https://miscsubjects.com/a/oip-directory-dispatch",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-directory-dispatch/bundle?format=markdown",
      "author_model": "gemini/gemini-2.5-flash",
      "version": 1,
      "machine_written": true
    },
    {
      "slug": "oip-drop-end-to-end",
      "title": "OIP Drop End to End",
      "human_page": "https://miscsubjects.com/a/oip-drop-end-to-end",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-drop-end-to-end/bundle?format=markdown",
      "author_model": "gemini/gemini-2.5-flash",
      "version": 1,
      "machine_written": true
    },
    {
      "slug": "oip-example",
      "title": "OIP Example Use Cases",
      "human_page": "https://miscsubjects.com/a/oip-example",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-example/bundle?format=markdown",
      "author_model": "gemini/gemini-2.5-flash",
      "version": 1,
      "machine_written": true
    },
    {
      "slug": "oip-files-deploy",
      "title": "Files, repo, and deploy",
      "human_page": "https://miscsubjects.com/a/oip-files-deploy",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-files-deploy/bundle?format=markdown",
      "author_model": "@cf/meta/llama-3.3-70b-instruct-fp8-fast",
      "version": 1,
      "machine_written": true
    },
    {
      "slug": "oip-github",
      "title": "GitHub and OIP",
      "human_page": "https://miscsubjects.com/a/oip-github",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-github/bundle?format=markdown",
      "author_model": "gemini/gemini-2.5-flash",
      "version": 1,
      "machine_written": true
    },
    {
      "slug": "oip-github-mcp",
      "title": "What is an OIP GitHub MCP Object?",
      "human_page": "https://miscsubjects.com/a/oip-github-mcp",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-github-mcp/bundle?format=markdown",
      "author_model": "gemini/gemini-2.5-flash",
      "version": 1,
      "machine_written": true
    },
    {
      "slug": "oip-glossary",
      "title": "The OIP glossary",
      "human_page": "https://miscsubjects.com/a/oip-glossary",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-glossary/bundle?format=markdown",
      "author_model": "grok/grok-4.3",
      "version": 1,
      "machine_written": true
    },
    {
      "slug": "oip-link-structure",
      "title": "OIP link structure",
      "human_page": "https://miscsubjects.com/a/oip-link-structure",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-link-structure/bundle?format=markdown",
      "author_model": "gemini/gemini-2.5-flash",
      "version": 1,
      "machine_written": true
    },
    {
      "slug": "oip-machine-json",
      "title": "Machine-native JSON",
      "human_page": "https://miscsubjects.com/a/oip-machine-json",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-machine-json/bundle?format=markdown",
      "author_model": "@cf/meta/llama-3.3-70b-instruct-fp8-fast",
      "version": 1,
      "machine_written": true
    },
    {
      "slug": "oip-mcp",
      "title": "OIP and MCP Protocol Specification",
      "human_page": "https://miscsubjects.com/a/oip-mcp",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-mcp/bundle?format=markdown",
      "author_model": "gemini/gemini-2.5-flash",
      "version": 2,
      "machine_written": true
    },
    {
      "slug": "oip-mcp-comparison",
      "title": "OIP and MCP Comparison",
      "human_page": "https://miscsubjects.com/a/oip-mcp-comparison",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-mcp-comparison/bundle?format=markdown",
      "author_model": "gemini/gemini-2.5-flash",
      "version": 2,
      "machine_written": true
    },
    {
      "slug": "oip-mcp-explanation",
      "title": "OIP MCP explanation",
      "human_page": "https://miscsubjects.com/a/oip-mcp-explanation",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-mcp-explanation/bundle?format=markdown",
      "author_model": "gemini/gemini-2.5-flash",
      "version": 1,
      "machine_written": true
    },
    {
      "slug": "oip-model-review-loop",
      "title": "Models reviewing OIP articles",
      "human_page": "https://miscsubjects.com/a/oip-model-review-loop",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-model-review-loop/bundle?format=markdown",
      "author_model": "gemini/gemini-2.5-flash",
      "version": 1,
      "machine_written": true
    },
    {
      "slug": "oip-object-model",
      "title": "OIP Object Model",
      "human_page": "https://miscsubjects.com/a/oip-object-model",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-object-model/bundle?format=markdown",
      "author_model": "gemini/gemini-2.5-flash",
      "version": 1,
      "machine_written": true
    },
    {
      "slug": "oip-operating-playbook",
      "title": "OIP Operating Playbook",
      "human_page": "https://miscsubjects.com/a/oip-operating-playbook",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-operating-playbook/bundle?format=markdown",
      "author_model": "@cf/meta/llama-3.3-70b-instruct-fp8-fast",
      "version": 1,
      "machine_written": true
    },
    {
      "slug": "oip-rest",
      "title": "What is REST?",
      "human_page": "https://miscsubjects.com/a/oip-rest",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-rest/bundle?format=markdown",
      "author_model": "@cf/meta/llama-3.3-70b-instruct-fp8-fast",
      "version": 1,
      "machine_written": true
    },
    {
      "slug": "oip-self-test-proof",
      "title": "Self-test and proof",
      "human_page": "https://miscsubjects.com/a/oip-self-test-proof",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-self-test-proof/bundle?format=markdown",
      "author_model": "@cf/meta/llama-3.3-70b-instruct-fp8-fast",
      "version": 1,
      "machine_written": true
    },
    {
      "slug": "oip-tap-and-go",
      "title": "Tap & Go",
      "human_page": "https://miscsubjects.com/a/oip-tap-and-go",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-tap-and-go/bundle?format=markdown",
      "author_model": "@cf/meta/llama-3.3-70b-instruct-fp8-fast",
      "version": 1,
      "machine_written": true
    },
    {
      "slug": "oip-tap-go",
      "title": "Tap & Go delegation",
      "human_page": "https://miscsubjects.com/a/oip-tap-go",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-tap-go/bundle?format=markdown",
      "author_model": "gemini/gemini-2.5-flash",
      "version": 1,
      "machine_written": true
    },
    {
      "slug": "oip-troubleshooting",
      "title": "OIP Troubleshooting Guide",
      "human_page": "https://miscsubjects.com/a/oip-troubleshooting",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-troubleshooting/bundle?format=markdown",
      "author_model": "gemini/gemini-2.5-flash",
      "version": 1,
      "machine_written": true
    },
    {
      "slug": "oip-vs-a2a",
      "title": "OIP vs A2A: asking vs proving",
      "human_page": "https://miscsubjects.com/a/oip-vs-a2a",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-vs-a2a/bundle?format=markdown",
      "author_model": "claude-fable-5",
      "version": 4,
      "machine_written": true
    },
    {
      "slug": "oip-vs-function-calling",
      "title": "OIP vs LLM Function Calling",
      "human_page": "https://miscsubjects.com/a/oip-vs-function-calling",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-vs-function-calling/bundle?format=markdown",
      "author_model": "@cf/meta/llama-3.3-70b-instruct-fp8-fast",
      "version": 1,
      "machine_written": true
    },
    {
      "slug": "oip-vs-langchain-tools",
      "title": "OIP vs LangChain Tools",
      "human_page": "https://miscsubjects.com/a/oip-vs-langchain-tools",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-vs-langchain-tools/bundle?format=markdown",
      "author_model": "@cf/meta/llama-3.3-70b-instruct-fp8-fast",
      "version": 1,
      "machine_written": true
    },
    {
      "slug": "oip-vs-openapi",
      "title": "OIP vs OpenAPI",
      "human_page": "https://miscsubjects.com/a/oip-vs-openapi",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-vs-openapi/bundle?format=markdown",
      "author_model": "@cf/meta/llama-3.3-70b-instruct-fp8-fast",
      "version": 1,
      "machine_written": true
    },
    {
      "slug": "oip-vs-zapier",
      "title": "OIP vs Zapier",
      "human_page": "https://miscsubjects.com/a/oip-vs-zapier",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-vs-zapier/bundle?format=markdown",
      "author_model": "@cf/meta/llama-3.3-70b-instruct-fp8-fast",
      "version": 1,
      "machine_written": true
    },
    {
      "slug": "oip-what-is-json",
      "title": "What is JSON",
      "human_page": "https://miscsubjects.com/a/oip-what-is-json",
      "bundle_markdown": "https://miscsubjects.com/api/articles/oip-what-is-json/bundle?format=markdown",
      "author_model": "gemini/gemini-2.5-flash",
      "version": 2,
      "machine_written": true
    }
  ],
  "zero_context_manual": {
    "protocol": "OIP",
    "purpose": "Specify model-operated work objects with contracts, authority, invocation routes, receipts, replay, repair, and conformance.",
    "reference_implementation": "miscsubjects.com is the production reference implementation. Any caller resolves a directory object, dispatch runs that object, the invocation ledger records it, and the receipt proves what happened.",
    "what_the_build_is": "The reference implementation contains articles, prompts, files, terminals, model calls, deployments, ledgers, and self-tests as OIP objects.",
    "plain_language": {
      "one_sentence": "OIP is a protocol for describing, invoking, proving, replaying, and repairing model-operated work objects.",
      "dictionary": [
        {
          "word": "reference implementation",
          "means": "one running OIP system: site, APIs, rows, files, ledgers, tools, models, and deploy path"
        },
        {
          "word": "object",
          "means": "one unit of work the reference implementation can read or do"
        },
        {
          "word": "directory row",
          "means": "the saved card for one object; it says what the object does and how to run it"
        },
        {
          "word": "dispatch",
          "means": "the one door that presses a directory-row button"
        },
        {
          "word": "runner",
          "means": "the actual machine that does the work: HTTP, model, shell, database, file, or another service"
        },
        {
          "word": "ledger",
          "means": "the notebook where the build writes what was asked, what ran, and what came back"
        },
        {
          "word": "receipt",
          "means": "one proof page for one invocation"
        },
        {
          "word": "Tap & Go",
          "means": "one copied drop that gives a model the object map, credential, execute shape, and receipt rule together"
        }
      ],
      "end_to_end_flow": [
        "A caller wants something.",
        "The caller asks OIP for the right object or opens a known object.",
        "The directory row explains the object.",
        "Dispatch validates the request and chooses the runner.",
        "The runner does the work.",
        "The ledger records the request and result.",
        "The receipt gives one proof object for what happened.",
        "If the result is wrong, replay or repair starts from that receipt."
      ]
    },
    "how_to_do_any_possible_thing": [
      {
        "step": "orient",
        "human": "If cold, read the OIP root article or the orient endpoint.",
        "machine": "https://miscsubjects.com/api/dispatch?orient=1&format=markdown"
      },
      {
        "step": "ask",
        "human": "Say the desired action in plain language and let the build return the exact matching object.",
        "machine": "https://miscsubjects.com/api/dispatch?ask=<what you want>"
      },
      {
        "step": "read",
        "human": "Open the object article or machine document before invoking it.",
        "machine": "https://miscsubjects.com/api/dispatch?key=<KEY>&format=markdown"
      },
      {
        "step": "invoke",
        "human": "Use owner auth or a scoped Tap & Go drop. Opening the invoke URL is enough.",
        "machine": "https://miscsubjects.com/api/dispatch?invoke=<KEY>&body=<ARGS>&share=<TOKEN>"
      },
      {
        "step": "prove",
        "human": "Open the receipt and answer from the recorded result, not from intention.",
        "machine": "https://miscsubjects.com/api/dispatch?receipt=inv_ID&share=<TOKEN>"
      },
      {
        "step": "repair",
        "human": "If the result is wrong, repair the recorded invocation so lineage stays attached.",
        "machine": "POST https://miscsubjects.com/api/dispatch {key, body, repairs:'inv_ID'}"
      }
    ],
    "facets": [
      {
        "name": "Callers",
        "human": "A caller can be a model, browser, API client, admin page, CLI path, scheduled workflow, or messaging route. OIP starts when that caller resolves or invokes a directory object.",
        "read": "https://miscsubjects.com/api/dispatch?orient=1&format=markdown",
        "operate": "https://miscsubjects.com/api/dispatch"
      },
      {
        "name": "Directory rows",
        "human": "The directory is the executable catalog. A row is a tool, agent prompt, HTTP target, CLI command, or system object.",
        "read": "https://miscsubjects.com/api/directory",
        "one": "https://miscsubjects.com/api/dispatch?key=<KEY>&format=markdown",
        "edit": "PATCH https://miscsubjects.com/api/directory/<KEY> {content,target,args,auth}"
      },
      {
        "name": "Dispatch",
        "human": "Dispatch is the one door that invokes directory rows and writes receipts.",
        "read": "https://miscsubjects.com/api/dispatch?registry=1",
        "invoke": "POST https://miscsubjects.com/api/dispatch {key, body}"
      },
      {
        "name": "Articles",
        "human": "Content articles use the same self-explaining pattern: body, claims, sources, provenance, widgets, and bundle JSON.",
        "read": "https://miscsubjects.com/api/articles",
        "one": "https://miscsubjects.com/api/articles/<slug>/bundle?format=markdown",
        "page": "https://miscsubjects.com/a/<slug>"
      },
      {
        "name": "Files",
        "human": "Operational code lives in the repo. Bulk/reference data lives outside the repo and is reached by API.",
        "inventory": "https://miscsubjects.com/api/inventory",
        "read_write": "https://miscsubjects.com/api/file/<path>"
      },
      {
        "name": "Ledger and receipts",
        "human": "The ledger is proof and memory: events, invocations, turns, requests, responses, receipts, replay, and repair.",
        "events": "https://miscsubjects.com/admin/ledger?data=1&limit=50",
        "invocations": "https://miscsubjects.com/api/invocations",
        "receipt": "https://miscsubjects.com/api/dispatch?receipt=inv_ID"
      },
      {
        "name": "Self-test",
        "human": "The build proves claimed behavior by running natural-language questions through the real route and scoring the reply.",
        "admin": "https://miscsubjects.com/admin/selftest",
        "api": "https://miscsubjects.com/api/selftest",
        "workflow": "https://miscsubjects.com/wf/selftest/trigger"
      },
      {
        "name": "Deploy",
        "human": "Code changes go live through Cloudflare Pages deploy. The root redirect is protected and not part of OIP cleanup.",
        "command": "wrangler pages deploy public --project-name=loop-safe-miscsubjects"
      }
    ],
    "shelves": [
      {
        "kind": "api",
        "slug": "oip-apis",
        "article": "https://miscsubjects.com/a/oip-apis",
        "machine": "https://miscsubjects.com/api/dispatch?map=apis&format=markdown",
        "systems": 18,
        "capabilities": 302,
        "examples": [
          {
            "system": "CF",
            "count": 112,
            "article": "https://miscsubjects.com/a/oip-system-cf",
            "machine": "https://miscsubjects.com/api/dispatch?map=CF&format=markdown"
          },
          {
            "system": "BLOOIO",
            "count": 65,
            "article": "https://miscsubjects.com/a/oip-system-blooio",
            "machine": "https://miscsubjects.com/api/dispatch?map=BLOOIO&format=markdown"
          },
          {
            "system": "STRIPE",
            "count": 61,
            "article": "https://miscsubjects.com/a/oip-system-stripe",
            "machine": "https://miscsubjects.com/api/dispatch?map=STRIPE&format=markdown"
          },
          {
            "system": "PAYMENTS",
            "count": 11,
            "article": "https://miscsubjects.com/a/oip-system-payments",
            "machine": "https://miscsubjects.com/api/dispatch?map=PAYMENTS&format=markdown"
          },
          {
            "system": "GOOGLE",
            "count": 8,
            "article": "https://miscsubjects.com/a/oip-system-google",
            "machine": "https://miscsubjects.com/api/dispatch?map=GOOGLE&format=markdown"
          },
          {
            "system": "KV",
            "count": 7,
            "article": "https://miscsubjects.com/a/oip-system-kv",
            "machine": "https://miscsubjects.com/api/dispatch?map=KV&format=markdown"
          },
          {
            "system": "ARCADS",
            "count": 6,
            "article": "https://miscsubjects.com/a/oip-system-arcads",
            "machine": "https://miscsubjects.com/api/dispatch?map=ARCADS&format=markdown"
          },
          {
            "system": "GITHUB",
            "count": 6,
            "article": "https://miscsubjects.com/a/oip-system-github",
            "machine": "https://miscsubjects.com/api/dispatch?map=GITHUB&format=markdown"
          }
        ]
      },
      {
        "kind": "cli",
        "slug": "oip-clis",
        "article": "https://miscsubjects.com/a/oip-clis",
        "machine": "https://miscsubjects.com/api/dispatch?map=clis&format=markdown",
        "systems": 2,
        "capabilities": 46,
        "examples": [
          {
            "system": "CLI",
            "count": 45,
            "article": "https://miscsubjects.com/a/oip-system-cli",
            "machine": "https://miscsubjects.com/api/dispatch?map=CLI&format=markdown"
          },
          {
            "system": "NPM",
            "count": 1,
            "article": "https://miscsubjects.com/a/oip-system-npm",
            "machine": "https://miscsubjects.com/api/dispatch?map=NPM&format=markdown"
          }
        ]
      },
      {
        "kind": "mcp",
        "slug": "oip-mcps",
        "article": "https://miscsubjects.com/a/oip-mcps",
        "machine": "https://miscsubjects.com/api/dispatch?map=mcps&format=markdown",
        "systems": 1,
        "capabilities": 11,
        "examples": [
          {
            "system": "MCP",
            "count": 11,
            "article": "https://miscsubjects.com/a/oip-system-mcp",
            "machine": "https://miscsubjects.com/api/dispatch?map=MCP&format=markdown"
          }
        ]
      },
      {
        "kind": "device",
        "slug": "oip-devices",
        "article": "https://miscsubjects.com/a/oip-devices",
        "machine": "https://miscsubjects.com/api/dispatch?map=devices&format=markdown",
        "systems": 4,
        "capabilities": 62,
        "examples": [
          {
            "system": "LOCAL",
            "count": 40,
            "article": "https://miscsubjects.com/a/oip-system-local",
            "machine": "https://miscsubjects.com/api/dispatch?map=LOCAL&format=markdown"
          },
          {
            "system": "PHONE",
            "count": 10,
            "article": "https://miscsubjects.com/a/oip-system-phone",
            "machine": "https://miscsubjects.com/api/dispatch?map=PHONE&format=markdown"
          },
          {
            "system": "BROWSER",
            "count": 9,
            "article": "https://miscsubjects.com/a/oip-system-browser",
            "machine": "https://miscsubjects.com/api/dispatch?map=BROWSER&format=markdown"
          },
          {
            "system": "DESKTOP",
            "count": 3,
            "article": "https://miscsubjects.com/a/oip-system-desktop",
            "machine": "https://miscsubjects.com/api/dispatch?map=DESKTOP&format=markdown"
          }
        ]
      },
      {
        "kind": "model",
        "slug": "oip-models",
        "article": "https://miscsubjects.com/a/oip-models",
        "machine": "https://miscsubjects.com/api/dispatch?map=models&format=markdown",
        "systems": 8,
        "capabilities": 43,
        "examples": [
          {
            "system": "AGENT",
            "count": 12,
            "article": "https://miscsubjects.com/a/oip-system-agent",
            "machine": "https://miscsubjects.com/api/dispatch?map=AGENT&format=markdown"
          },
          {
            "system": "GROK",
            "count": 9,
            "article": "https://miscsubjects.com/a/oip-system-grok",
            "machine": "https://miscsubjects.com/api/dispatch?map=GROK&format=markdown"
          },
          {
            "system": "BUILDER",
            "count": 7,
            "article": "https://miscsubjects.com/a/oip-system-builder",
            "machine": "https://miscsubjects.com/api/dispatch?map=BUILDER&format=markdown"
          },
          {
            "system": "ASK",
            "count": 4,
            "article": "https://miscsubjects.com/a/oip-system-ask",
            "machine": "https://miscsubjects.com/api/dispatch?map=ASK&format=markdown"
          },
          {
            "system": "KIMI",
            "count": 4,
            "article": "https://miscsubjects.com/a/oip-system-kimi",
            "machine": "https://miscsubjects.com/api/dispatch?map=KIMI&format=markdown"
          },
          {
            "system": "VOICE",
            "count": 4,
            "article": "https://miscsubjects.com/a/oip-system-voice",
            "machine": "https://miscsubjects.com/api/dispatch?map=VOICE&format=markdown"
          },
          {
            "system": "GEMINI",
            "count": 2,
            "article": "https://miscsubjects.com/a/oip-system-gemini",
            "machine": "https://miscsubjects.com/api/dispatch?map=GEMINI&format=markdown"
          },
          {
            "system": "XAI",
            "count": 1,
            "article": "https://miscsubjects.com/a/oip-system-xai",
            "machine": "https://miscsubjects.com/api/dispatch?map=XAI&format=markdown"
          }
        ]
      },
      {
        "kind": "core",
        "slug": "oip-core",
        "article": "https://miscsubjects.com/a/oip-core",
        "machine": "https://miscsubjects.com/api/dispatch?map=core&format=markdown",
        "systems": 144,
        "capabilities": 265,
        "examples": [
          {
            "system": "SKILL",
            "count": 12,
            "article": "https://miscsubjects.com/a/oip-system-skill",
            "machine": "https://miscsubjects.com/api/dispatch?map=SKILL&format=markdown"
          },
          {
            "system": "OIP",
            "count": 9,
            "article": "https://miscsubjects.com/a/oip-system-oip",
            "machine": "https://miscsubjects.com/api/dispatch?map=OIP&format=markdown"
          },
          {
            "system": "SET",
            "count": 7,
            "article": "https://miscsubjects.com/a/oip-system-set",
            "machine": "https://miscsubjects.com/api/dispatch?map=SET&format=markdown"
          },
          {
            "system": "AUTOMATE",
            "count": 6,
            "article": "https://miscsubjects.com/a/oip-system-automate",
            "machine": "https://miscsubjects.com/api/dispatch?map=AUTOMATE&format=markdown"
          },
          {
            "system": "LAWS",
            "count": 6,
            "article": "https://miscsubjects.com/a/oip-system-laws",
            "machine": "https://miscsubjects.com/api/dispatch?map=LAWS&format=markdown"
          },
          {
            "system": "PAGES",
            "count": 6,
            "article": "https://miscsubjects.com/a/oip-system-pages",
            "machine": "https://miscsubjects.com/api/dispatch?map=PAGES&format=markdown"
          },
          {
            "system": "ARTICLE",
            "count": 5,
            "article": "https://miscsubjects.com/a/oip-system-article",
            "machine": "https://miscsubjects.com/api/dispatch?map=ARTICLE&format=markdown"
          },
          {
            "system": "FILE",
            "count": 5,
            "article": "https://miscsubjects.com/a/oip-system-file",
            "machine": "https://miscsubjects.com/api/dispatch?map=FILE&format=markdown"
          }
        ]
      }
    ],
    "article_pattern": {
      "root": "https://miscsubjects.com/a/oip",
      "shelf": "https://miscsubjects.com/a/oip-apis",
      "system": "https://miscsubjects.com/a/oip-system-github",
      "capability": "https://miscsubjects.com/a/oip-capability-github-list-issues",
      "bundle": "https://miscsubjects.com/api/articles/oip/bundle?format=markdown"
    },
    "proof_contract": "Nothing is working unless the reply includes real tool output from the build and a receipt or ledger line that proves what ran."
  },
  "how_to_do_anything": [
    {
      "step": "orient",
      "human": "If cold, read the OIP root article or the orient endpoint.",
      "machine": "https://miscsubjects.com/api/dispatch?orient=1&format=markdown"
    },
    {
      "step": "ask",
      "human": "Say the desired action in plain language and let the build return the exact matching object.",
      "machine": "https://miscsubjects.com/api/dispatch?ask=<what you want>"
    },
    {
      "step": "read",
      "human": "Open the object article or machine document before invoking it.",
      "machine": "https://miscsubjects.com/api/dispatch?key=<KEY>&format=markdown"
    },
    {
      "step": "invoke",
      "human": "Use owner auth or a scoped Tap & Go drop. Opening the invoke URL is enough.",
      "machine": "https://miscsubjects.com/api/dispatch?invoke=<KEY>&body=<ARGS>&share=<TOKEN>"
    },
    {
      "step": "prove",
      "human": "Open the receipt and answer from the recorded result, not from intention.",
      "machine": "https://miscsubjects.com/api/dispatch?receipt=inv_ID&share=<TOKEN>"
    },
    {
      "step": "repair",
      "human": "If the result is wrong, repair the recorded invocation so lineage stays attached.",
      "machine": "POST https://miscsubjects.com/api/dispatch {key, body, repairs:'inv_ID'}"
    }
  ],
  "build_self": {
    "protocol": "OIP",
    "version": "0.6",
    "kind": "build-self",
    "principle": "With the terminal key you hold the whole build. Every tier below says how to READ it and how to ALTER it, and links to a self-describing sub-index. From here you can reach and change any page, capability, prompt, article, or turn. Read a target's _self, then use its alter REST. Every write is ledgered.",
    "auth": "terminal key present. Public callers get only the content tier; everything else needs x-terminal-key (header) or ?terminal_key=<KEY> in the URL.",
    "edit_access": "The terminal key is edit/act access to the whole build. POST https://miscsubjects.com/api/dispatch {key, body} runs any registered capability — articles, prompts, messages, images, deploy, etc. GET https://miscsubjects.com/api/dispatch?registry=1 for every function; GET https://miscsubjects.com/api/dispatch?key=<KEY> for one.",
    "delegated_access": "A GET-only tool is enough to ACT — acting = opening a URL: GET https://miscsubjects.com/api/dispatch?invoke=KEY&body=<args>&share=<TOKEN> (texts, images, CLI, deploy — no POST needed). READ token = browse only; WRITE (act) token = invoke via ?invoke= (or POST). Owner mints: ?mint_share=1&scope=read|act.",
    "resume": "https://miscsubjects.com/api/dispatch?resume=1  — fresh session? start here: what was just being worked on, derived from the ledger, no handoff.",
    "topology": {
      "what": "A Cloudflare Pages app at miscsubjects.com. Code on GitHub; state in D1 + KV + R2; agents run on the Mac bridge, the edge, and sibling Workers.",
      "repo": "https://github.com/massoumicyrus/miscsubjects-pages (branch main)",
      "read_a_file": "raw: https://raw.githubusercontent.com/massoumicyrus/miscsubjects-pages/main/<path>  ·  or POST /api/dispatch {key:'LOCAL_READ', body:'<path>'} for the live file on the Mac",
      "deploy": "Cloudflare Pages project loop-safe-miscsubjects; production https://miscsubjects.com",
      "storage": {
        "articles_and_directory": "D1 loop-content-spine (binding DB) — articles, claims, sources, and the directory (capabilities + prompts)",
        "ledger": "D1 loop-shared-events (binding LEDGER) — events + invocations (every turn and every call)",
        "kv": "binding KV",
        "assets": "R2 miscsubjects-ledger (binding R2), public at /img/..."
      },
      "articles": {
        "list": "https://miscsubjects.com/api/articles?slim=1&limit=80",
        "one": "https://miscsubjects.com/api/articles/<slug>",
        "public_page": "https://miscsubjects.com/a/<slug>",
        "bundle": "https://miscsubjects.com/api/articles/<slug>/bundle?format=markdown",
        "create": "POST https://miscsubjects.com/api/articles {slug,title,subject}",
        "set_slot": "POST https://miscsubjects.com/api/articles/<slug>/set {slot_key, content} (manual override; ledgered)",
        "compose_slot": "POST https://miscsubjects.com/api/articles/<slug>/compose {slot_key, brief}  (delegates to PROTOCOL_WRITE)"
      },
      "images": "POST https://miscsubjects.com/api/dispatch {key:'GROK_IMAGE', body:'<prompt>'} — returns an image URL (R2)"
    },
    "how_to_alter_anything": "content -> POST /api/protocol/{ingest,claim,ask}. a capability or an agent/writer prompt -> PATCH /api/directory/<KEY> {content}. run anything -> POST /api/dispatch {key, body, actor}.",
    "invariants": [
      "Every capability is an invokable object with a _self; nothing is hidden.",
      "Every write is ledgered with actor + cost + material/waste.",
      "Knowledge lives in objects; reasoning lives in models; history lives in the ledger.",
      "Memory prevails over code; changing memory or code each needs permission.",
      "Derived views (voxels, invocations) are computed from what actually ran, so they stay in sync.",
      "This index links the sub-indexes; fetch specifics from them."
    ],
    "tool_self_check": {
      "headline": "Opening a URL here executes and returns a receipt — reading and acting are the same move. Prove it before deciding what you can do: open ?ping=1&share=<TOKEN> and you'll get ran:true + a receipt.",
      "rule": "If any tool you have opens a URL (web_open_url, browser, web_fetch, curl, fetch), you can act — GET is enough, no POST or HTTP client required. Confirm empirically with the ping URL rather than assuming.",
      "step_0": "web_fetch, web_open_url, browse, browser, curl, shell, terminal, run_command, code_interpreter, MCP HTTP_FETCH, miscsubjects dispatch, CF_MAIN_EXECUTE.",
      "act_rule": "Prove-it first: open https://miscsubjects.com/api/dispatch?ping=1&share=<TOKEN> → a live receipt (ran:true, proof.ok, inv_ id). Then act the same way on anything: https://miscsubjects.com/api/dispatch?invoke=KEY&body=<url-encoded args>&share=<TOKEN>. Find the exact call for any request: https://miscsubjects.com/api/dispatch?ask=<what you want>&share=<TOKEN>. Every call returns a receipt; a failure says ran:false, so you never guess whether it worked. (Links are long — copy the whole thing, tail included.)",
      "json_rule": "JSON body or a 'POST-only' endpoint? You STILL don't need POST. Two ways over GET: (1) url-encode the JSON straight into &body= — e.g. ?invoke=PROTOCOL_WRITE&body=%7B%22mode%22%3A%22write%22%2C%22topic%22%3A%22x%22%7D; (2) use the row's pipe args — a|b|c. Every write has a GET row: edit a prompt/capability = ?invoke=DIR_PATCH&body=<KEY>|{\"content\":\"...\"}; write or revise an article = ?invoke=PROTOCOL_WRITE&body=<url-encoded JSON {mode,slug,topic,feedback}>; ingest evidence = ?invoke=ARTICLE_INGEST&body=<slug>|<text>. Don't POST to a raw endpoint — open the row's ?invoke= URL. Find the exact one with ?ask=.",
      "if_any_match": "You can act. Open the handoff URL, then use ?invoke= / ?ask= URLs to do the work. Report each result's receipt.",
      "if_zero_http": "Only if NOTHING you have can open a URL: say so plainly and work from this blob; do not invent live state.",
      "proof_first_url": "https://miscsubjects.com/api/handoff?format=markdown&share=<TOKEN>"
    },
    "automation": {
      "what": "Event hooks ledger what happened; configurable dispatch-on-turn is a pending build item.",
      "article_created": "ARTICLE_CREATED — fires once when a new article row is created",
      "turn_complete": "TURN_COMPLETE — fires after each CLI turn (grok/cc) lands in agent_turns",
      "not_shipped": "every-N-turns auto-dispatch, Kimi CLI parity, auto-adversarial audit on every turn"
    },
    "read_order": [
      "who you're working for (§PROFILE) — /api/dispatch?profile=1",
      "session capability check (§TOOLS)",
      "unified handoff (content + backend) — /api/handoff?format=markdown",
      "build-self (this)",
      "content system-map — /api/articles/system-map?format=markdown",
      "OIP capability tree — /api/dispatch?map=1&format=markdown",
      "admin pages index (derived) — /api/admin/self",
      "capability registry — /api/dispatch?registry=1",
      "ask the build — /api/dispatch?ask=<question>",
      "one capability's _self — /api/dispatch?key=<KEY>",
      "one admin page's _self — /api/admin/self?page=<id>",
      "turns — /admin/ledger?cards=1",
      "architecture — /admin/ledger?voxels=1&html=1"
    ],
    "proof_chain": [
      {
        "step": 1,
        "claim": "The build is two self-answering tiers: content (public) and admin (terminal-key).",
        "verify": "https://miscsubjects.com/api/articles/system-map"
      },
      {
        "step": 2,
        "claim": "Every capability self-describes and is invokable.",
        "verify": "https://miscsubjects.com/api/dispatch?registry=1"
      },
      {
        "step": 3,
        "claim": "You can ask the build, in plain language, what to use.",
        "verify": "https://miscsubjects.com/api/dispatch?ask=send+a+text"
      },
      {
        "step": 4,
        "claim": "Every turn and payload is in the ledger — you can see what any model did.",
        "verify": "https://miscsubjects.com/admin/ledger?cards=1&limit=5"
      },
      {
        "step": 5,
        "claim": "The build audits its own architecture (orphans/fragile/hot), derived from the ledger.",
        "verify": "https://miscsubjects.com/admin/ledger?voxels=1&html=1"
      },
      {
        "step": 6,
        "claim": "Prompts are directory rows; read via ?key, change via PATCH /api/directory/<KEY>.",
        "verify": "https://miscsubjects.com/api/dispatch?key=ROUTER"
      },
      {
        "step": 7,
        "claim": "Every admin page self-describes; the map is derived from /api/admin/self.",
        "verify": "https://miscsubjects.com/api/admin/self"
      },
      {
        "step": 8,
        "claim": "Content and backend are unified for any model — one handoff URL + token.",
        "verify": "https://miscsubjects.com/api/handoff?format=markdown"
      }
    ],
    "tiers": {
      "content": {
        "what": "Peptide evidence articles as voxel graphs of tiered, hash-chained claims — public, self-explaining.",
        "map": "https://miscsubjects.com/api/articles/system-map?format=markdown",
        "one_article": "https://miscsubjects.com/api/articles/<slug>/bundle?format=markdown",
        "edit_history": "https://miscsubjects.com/api/articles/<slug>?rev=<n>",
        "ask": "POST https://miscsubjects.com/api/protocol/ask {slug, question}",
        "alter": "POST https://miscsubjects.com/api/protocol/ingest | /api/protocol/claim",
        "public": true
      },
      "capability": {
        "what": "Every build capability is a self-describing, invokable object (OIP), reachable through the recursive tree.",
        "tree": "https://miscsubjects.com/api/dispatch?map=1&format=markdown",
        "system_article": "https://miscsubjects.com/api/dispatch?map=<SYSTEM>&format=markdown",
        "registry": "https://miscsubjects.com/api/dispatch?registry=1",
        "one": "https://miscsubjects.com/api/dispatch?key=<KEY>&format=markdown",
        "ask": "https://miscsubjects.com/api/dispatch?ask=<natural language question>",
        "invoke": "POST https://miscsubjects.com/api/dispatch {key, body, actor}",
        "history": "https://miscsubjects.com/api/invocations",
        "architecture": "https://miscsubjects.com/admin/ledger?voxels=1&html=1"
      },
      "turns": {
        "what": "Every turn — what I said, what the agent said, what it did, with raw payloads. This is how you see what another model just did.",
        "cards": "https://miscsubjects.com/admin/ledger?cards=1&limit=20",
        "one_turn": "https://miscsubjects.com/admin/ledger?cards=1&card_id=<trace_id>",
        "by_agent": "https://miscsubjects.com/admin/ledger?cards=1&service=claude-cli  (or grok-cli, kimi-cli)",
        "chronology": "https://miscsubjects.com/admin/ledger?data=1&limit=100",
        "one_event_full_raw": "https://miscsubjects.com/admin/ledger/<event_id>?data=1",
        "bundle": "https://miscsubjects.com/admin/ledger?bundle=1"
      },
      "prompts": {
        "what": "Agent + writer prompts are directory rows of type 'agent'. Reading a prompt = reading its object; editing it = patching its content.",
        "find": "https://miscsubjects.com/api/dispatch?ask=<writer | router | editor ...>",
        "read": "https://miscsubjects.com/api/dispatch?key=<KEY>",
        "edit": "PATCH https://miscsubjects.com/api/directory/<KEY> {content}"
      },
      "admin": {
        "what": "The terminal-key-gated cockpit. Each page emits its own _self; this map is derived from GET /api/admin/self — not hand-curated.",
        "map": "https://miscsubjects.com/api/admin/self",
        "map_markdown": "https://miscsubjects.com/api/admin/self?format=markdown",
        "pages": [
          {
            "id": "directory",
            "name": "Directory",
            "path": "/admin/directory",
            "read": "https://miscsubjects.com/admin/directory",
            "self": "https://miscsubjects.com/api/admin/self?page=directory",
            "alter": "PATCH https://miscsubjects.com/api/directory/<KEY> {content}",
            "what": "Every capability row + prompt — browse, search, open one key."
          },
          {
            "id": "directory_key",
            "name": "Directory row",
            "path": "/admin/directory/<key>",
            "read": "https://miscsubjects.com/admin/directory/<key>",
            "self": "https://miscsubjects.com/api/admin/self?page=directory_key",
            "alter": "PATCH https://miscsubjects.com/api/directory/<KEY> {content}",
            "what": "One capability or agent prompt — read content, invoke, edit."
          },
          {
            "id": "directory_graph",
            "name": "Directory graph",
            "path": "/admin/directory/graph",
            "read": "https://miscsubjects.com/admin/directory/graph",
            "self": "https://miscsubjects.com/api/admin/self?page=directory_graph",
            "what": "Visual graph of directory rows and relationships."
          },
          {
            "id": "directory_models",
            "name": "Models",
            "path": "/admin/directory/models",
            "read": "https://miscsubjects.com/admin/directory/models",
            "self": "https://miscsubjects.com/api/admin/self?page=directory_models",
            "what": "Model registry tied to directory ASK_* and provider rows."
          },
          {
            "id": "directory_new",
            "name": "New directory row",
            "path": "/admin/directory/new",
            "read": "https://miscsubjects.com/admin/directory/new",
            "self": "https://miscsubjects.com/api/admin/self?page=directory_new",
            "alter": "POST https://miscsubjects.com/api/directory {key,type,content}",
            "what": "Create a new capability / agent / flow row."
          },
          {
            "id": "ledger",
            "name": "Ledger",
            "path": "/admin/ledger",
            "read": "https://miscsubjects.com/admin/ledger?cards=1&limit=20",
            "self": "https://miscsubjects.com/api/admin/self?page=ledger",
            "what": "Turns, state cards, chronology, voxels, bundles — every payload in/out."
          },
          {
            "id": "ledger_event",
            "name": "Ledger event",
            "path": "/admin/ledger/<id>",
            "read": "https://miscsubjects.com/admin/ledger/<id>",
            "self": "https://miscsubjects.com/api/admin/self?page=ledger_event",
            "what": "One raw ledger event with full request/response."
          },
          {
            "id": "content_map",
            "name": "Content map",
            "path": "/admin/content-map",
            "read": "https://miscsubjects.com/admin/content-map",
            "self": "https://miscsubjects.com/api/admin/self?page=content_map",
            "what": "Article graph — slugs, links, ontology slice."
          },
          {
            "id": "content_index",
            "name": "Content index",
            "path": "/admin/content",
            "read": "https://miscsubjects.com/admin/content",
            "self": "https://miscsubjects.com/api/admin/self?page=content_index",
            "what": "Admin lens over published articles."
          },
          {
            "id": "content_slug",
            "name": "Content article",
            "path": "/admin/content/<slug>",
            "read": "https://miscsubjects.com/admin/content/<slug>",
            "self": "https://miscsubjects.com/api/admin/self?page=content_slug",
            "what": "One article admin view — slots, meta, editorial controls."
          },
          {
            "id": "map",
            "name": "Map",
            "path": "/admin/map",
            "read": "https://miscsubjects.com/admin/map",
            "self": "https://miscsubjects.com/api/admin/self?page=map",
            "what": "Build topology map — Mac bridge, deploy, storage bindings."
          },
          {
            "id": "models_catalog",
            "name": "Model catalog",
            "path": "/admin/models-catalog",
            "read": "https://miscsubjects.com/admin/models-catalog",
            "self": "https://miscsubjects.com/api/admin/self?page=models_catalog",
            "what": "Provider models available to the build."
          },
          {
            "id": "vault",
            "name": "Vault",
            "path": "/admin/vault",
            "read": "https://miscsubjects.com/admin/vault",
            "self": "https://miscsubjects.com/api/admin/self?page=vault",
            "what": "Obsidian vault sync + session scan cron bounds."
          },
          {
            "id": "owner",
            "name": "Owner",
            "path": "/admin/owner",
            "read": "https://miscsubjects.com/admin/owner",
            "self": "https://miscsubjects.com/api/admin/self?page=owner",
            "what": "Owner kernel — hash-chained boolean rules models read, cannot edit."
          },
          {
            "id": "dojo",
            "name": "Dojo",
            "path": "/admin/dojo",
            "read": "https://miscsubjects.com/admin/dojo",
            "self": "https://miscsubjects.com/api/admin/self?page=dojo",
            "what": "Agent training / experiment surface."
          },
          {
            "id": "tasks",
            "name": "Tasks",
            "path": "/admin/tasks",
            "read": "https://miscsubjects.com/admin/tasks",
            "self": "https://miscsubjects.com/api/admin/self?page=tasks",
            "what": "Task queue + writer-queue work state."
          },
          {
            "id": "assets",
            "name": "Assets",
            "path": "/admin/assets",
            "read": "https://miscsubjects.com/admin/assets",
            "self": "https://miscsubjects.com/api/admin/self?page=assets",
            "what": "R2 / image assets lens."
          },
          {
            "id": "generate",
            "name": "Generate",
            "path": "/admin/generate",
            "read": "https://miscsubjects.com/admin/generate",
            "self": "https://miscsubjects.com/api/admin/self?page=generate",
            "what": "Generation controls for content/assets."
          },
          {
            "id": "cloaker",
            "name": "Cloaker",
            "path": "/admin/cloaker",
            "read": "https://miscsubjects.com/admin/cloaker",
            "self": "https://miscsubjects.com/api/admin/self?page=cloaker",
            "what": "Root-domain cloaker settings — money page vs safe page."
          },
          {
            "id": "selftest",
            "name": "Self-Test",
            "path": "/admin/selftest",
            "read": "https://miscsubjects.com/admin/selftest",
            "self": "https://miscsubjects.com/api/admin/self?page=selftest",
            "what": "Graded self-test suite — build health checks."
          },
          {
            "id": "agents",
            "name": "Agents",
            "path": "/admin/agents",
            "read": "https://miscsubjects.com/admin/agents",
            "self": "https://miscsubjects.com/api/admin/self?page=agents",
            "what": "CLI agent team room + spawn controls."
          },
          {
            "id": "cc",
            "name": "Claude Code",
            "path": "/admin/cc",
            "read": "https://miscsubjects.com/admin/cc",
            "self": "https://miscsubjects.com/api/admin/self?page=cc",
            "what": "Claude Code session lens."
          },
          {
            "id": "grok",
            "name": "Grok CLI",
            "path": "/admin/grok",
            "read": "https://miscsubjects.com/admin/grok",
            "self": "https://miscsubjects.com/api/admin/self?page=grok",
            "what": "Grok CLI session lens — grok_turns, same shape as Claude Code."
          },
          {
            "id": "handoff",
            "name": "Unified handoff",
            "path": "/api/handoff",
            "read": "https://miscsubjects.com/api/handoff?format=markdown",
            "self": "https://miscsubjects.com/api/admin/self?page=handoff",
            "what": "Content + backend in one self-explaining URL for any model + share token."
          },
          {
            "id": "manual",
            "name": "Manual",
            "path": "/admin/manual",
            "read": "https://miscsubjects.com/admin/manual",
            "self": "https://miscsubjects.com/api/admin/self?page=manual",
            "what": "Operator manual — REST inventory for the build."
          },
          {
            "id": "run",
            "name": "Run",
            "path": "/admin/run",
            "read": "https://miscsubjects.com/admin/run",
            "self": "https://miscsubjects.com/api/admin/self?page=run",
            "what": "Dispatch runner — fire directory rows from admin."
          },
          {
            "id": "trace",
            "name": "Trace",
            "path": "/admin/trace",
            "read": "https://miscsubjects.com/admin/trace",
            "self": "https://miscsubjects.com/api/admin/self?page=trace",
            "what": "Trace id lookup — one conversation thread."
          },
          {
            "id": "pages",
            "name": "Pages",
            "path": "/admin/pages",
            "read": "https://miscsubjects.com/admin/pages",
            "self": "https://miscsubjects.com/api/admin/self?page=pages",
            "what": "CMS-style pages admin."
          },
          {
            "id": "pages_slug",
            "name": "Page",
            "path": "/admin/pages/<slug>",
            "read": "https://miscsubjects.com/admin/pages/<slug>",
            "self": "https://miscsubjects.com/api/admin/self?page=pages_slug",
            "what": "One CMS page edit view."
          },
          {
            "id": "seed",
            "name": "Seed",
            "path": "/admin/seed",
            "read": "https://miscsubjects.com/admin/seed",
            "self": "https://miscsubjects.com/api/admin/self?page=seed",
            "alter": "POST https://miscsubjects.com/api/protocol/write | /api/protocol/draft",
            "what": "Article seed — generate, write, ledger tabs."
          },
          {
            "id": "pipeline",
            "name": "Pipeline",
            "path": "/admin/pipeline",
            "read": "https://miscsubjects.com/admin/pipeline",
            "self": "https://miscsubjects.com/api/admin/self?page=pipeline",
            "what": "Read-only writer-queue prompt mirror per article slug."
          },
          {
            "id": "bind_secrets",
            "name": "Bind secrets",
            "path": "/admin/bind-secrets",
            "read": "https://miscsubjects.com/admin/bind-secrets",
            "self": "https://miscsubjects.com/api/admin/self?page=bind_secrets",
            "what": "Cloudflare secrets store binding UI."
          }
        ]
      }
    },
    "worked_examples": [
      {
        "q": "I can't open URLs — paste the handoff?",
        "how": "List your tools first. If you have web_fetch / browser / curl / shell / MCP fetch → GET https://miscsubjects.com/api/handoff?format=markdown&share=<TOKEN> and report status+bytes. Ask for re-paste only after a failed fetch with tool name + error."
      },
      {
        "q": "I only have a share link and can open URLs — how do I DO anything?",
        "how": "First ask, then open the run_now it gives you: GET https://miscsubjects.com/api/dispatch?ask=<what you want>&share=<TOKEN> → each match has a run_now URL you open directly. E.g. text Cyrus: ?invoke=SEND_BY_CHANNEL&body=blooio%7C%2B14155480666%7Chi&share=<TOKEN> (channel|recipient|text). Make an image: ?invoke=GROK_IMAGE&body=<prompt>&share=<TOKEN>. Run claude code: ?invoke=CLI_CLAUDE_CODE&body=<task>&share=<TOKEN>. Never guess args — GET ?key=<KEY> first; its run_now shows the exact shape."
      },
      {
        "q": "I'm a fresh session — what were we just working on?",
        "how": "GET https://miscsubjects.com/api/dispatch?resume=1&format=markdown  (append &terminal_key=<KEY>, or &share=<TOKEN>, if you can't set headers)."
      },
      {
        "q": "Make an image for an article, and if I like it, add it.",
        "how": "1) generate (URL-only ok): GET https://miscsubjects.com/api/dispatch?invoke=GROK_IMAGE&body=<image prompt>&share=<TOKEN> -> image URL.  2) add it via the writer: GET https://miscsubjects.com/api/dispatch?invoke=PROTOCOL_WRITE&body=<url-encoded {\"mode\":\"revise\",\"slug\":\"<slug>\",\"feedback\":\"add hero image <URL>\"}>&share=<TOKEN>. (There is no raw manual slot-set route — the writer places content.)"
      },
      {
        "q": "Why does Claude keep overwriting my protected widgets?",
        "how": "1) GET https://miscsubjects.com/admin/ledger?cards=1&service=claude-cli&limit=100 and scan each turn's WHAT HAPPENED for edits to functions/_lib/widgets/* or functions/admin/ledger/index.js.  2) read the file: POST https://miscsubjects.com/api/dispatch {key:'LOCAL_READ', body:'functions/_lib/widgets/social.js'}, or GET https://raw.githubusercontent.com/massoumicyrus/miscsubjects-pages/main/functions/_lib/widgets/social.js.  3) cross-reference https://raw.githubusercontent.com/massoumicyrus/miscsubjects-pages/main/PROTECTED_WIDGETS.md."
      },
      {
        "q": "What do you think of what Claude just said?",
        "how": "GET https://miscsubjects.com/admin/ledger?cards=1&limit=5 — the newest card is the last turn: channel · what I said · what the agent said · tools · WHAT HAPPENED."
      },
      {
        "q": "Why is this article's writer prompt boring, and fix it?",
        "how": "GET https://miscsubjects.com/api/dispatch?ask=writer to find the writer object, GET https://miscsubjects.com/api/dispatch?key=<KEY> to read the exact prompt, PATCH https://miscsubjects.com/api/directory/<KEY> {content} to change it."
      },
      {
        "q": "That invocation was wrong — inspect it and fix it.",
        "how": "1) read the receipt: GET https://miscsubjects.com/api/dispatch?receipt=<inv_id>&share=<TOKEN> — full recorded request + response + lineage. 2) re-fire as-was: POST {replay:'<inv_id>'}. 3) fire corrected + linked: POST {key:'<KEY>', body:'<fixed args>', repairs:'<inv_id>'} — the old receipt gains repaired_by, the new one carries repairs. Every invoke response includes its own links.receipt URL."
      },
      {
        "q": "Delegate ONE action to another model without broad credentials.",
        "how": "Owner mints: GET https://miscsubjects.com/api/dispatch?mint_share=1&scope=row&key=<KEY>&ttl=600&uses=1&purpose=<why> → returns invoke_url + explain_url + fingerprint. Hand the model the URLs only. The model asks the URL what it can do: GET ?explain=1&share=<TOKEN>. It fires the one allowed row; anything else is denied and ledgered under the fingerprint. Kill early: GET ?revoke=cap_<fingerprint>."
      }
    ],
    "governing_rules": {
      "what": "The owner kernel + laws that govern every agent's behavior.",
      "agent_kernel": "https://miscsubjects.com/api/dispatch?key=ROUTER",
      "content_constitution": "https://miscsubjects.com/api/articles/constitution"
    }
  },
  "machine_native_contract": {
    "read_article": "https://miscsubjects.com/a/oip",
    "read_bundle_markdown": "https://miscsubjects.com/api/articles/oip/bundle?format=markdown",
    "find_capability_from_plain_language": "https://miscsubjects.com/api/dispatch?ask=<what you want>",
    "read_capability": "https://miscsubjects.com/api/dispatch?key=<KEY>&format=markdown",
    "invoke_capability": "https://miscsubjects.com/api/dispatch?invoke=<KEY>&body=<ARGS>&share=<TOKEN>",
    "verify_receipt": "https://miscsubjects.com/api/dispatch?receipt=inv_ID&share=<TOKEN>",
    "repair_receipt": "POST https://miscsubjects.com/api/dispatch {key, body, repairs:'inv_ID'}"
  },
  "recursive_review_loop": {
    "purpose": "Cron sends OIP article bundles to fresh models and asks them to score machine JSON clarity and human English clarity separately.",
    "cron_gate_kv": "oip_review_autorun=1",
    "task_role": "oip-review",
    "seed_endpoint": "POST https://miscsubjects.com/api/protocol/oip-seed {slugs?, models?}",
    "run_endpoint": "POST https://miscsubjects.com/api/protocol/run?role=oip-review",
    "review_endpoint": "POST https://miscsubjects.com/api/protocol/oip-review {slug, model}",
    "write_endpoint": "POST https://miscsubjects.com/api/protocol/oip-write {slug, title?, why?, model?}",
    "revise_endpoint": "POST https://miscsubjects.com/api/protocol/oip-revise {slug, model?}",
    "self_correction": "A failing review queues oip-revise (new append-only article version). A subsidiary concept named by a reviewer that has no article queues oip-write (a model writes it, then it enters the review cycle).",
    "ledger_key": "OIP_ARTICLE_REVIEW",
    "review_questions": [
      "How clear is the machine-native JSON to you as a model?",
      "How clear is the English article body as an explanation of the JSON?",
      "Could a zero-context human understand what this object is and how to use it?",
      "Can the build operation described here be performed with curl? If yes, name the exact route shape. If no, name the missing shape.",
      "Can this article explain how the object compares to MCP when MCP is relevant?",
      "Which subsidiary concepts need their own OIP articles?",
      "What concrete text or JSON field should be changed first?"
    ],
    "articles_in_cycle": [
      {
        "slug": "oip",
        "human_page": "https://miscsubjects.com/a/oip",
        "bundle_markdown": "https://miscsubjects.com/api/articles/oip/bundle?format=markdown"
      },
      {
        "slug": "oip-protocol-lineage",
        "human_page": "https://miscsubjects.com/a/oip-protocol-lineage",
        "bundle_markdown": "https://miscsubjects.com/api/articles/oip-protocol-lineage/bundle?format=markdown"
      },
      {
        "slug": "oip-operating-model",
        "human_page": "https://miscsubjects.com/a/oip-operating-model",
        "bundle_markdown": "https://miscsubjects.com/api/articles/oip-operating-model/bundle?format=markdown"
      },
      {
        "slug": "oip-build-overview",
        "human_page": "https://miscsubjects.com/a/oip-build-overview",
        "bundle_markdown": "https://miscsubjects.com/api/articles/oip-build-overview/bundle?format=markdown"
      },
      {
        "slug": "oip-object-model",
        "human_page": "https://miscsubjects.com/a/oip-object-model",
        "bundle_markdown": "https://miscsubjects.com/api/articles/oip-object-model/bundle?format=markdown"
      },
      {
        "slug": "oip-directory-dispatch",
        "human_page": "https://miscsubjects.com/a/oip-directory-dispatch",
        "bundle_markdown": "https://miscsubjects.com/api/articles/oip-directory-dispatch/bundle?format=markdown"
      },
      {
        "slug": "oip-ledger-receipts",
        "human_page": "https://miscsubjects.com/a/oip-ledger-receipts",
        "bundle_markdown": "https://miscsubjects.com/api/articles/oip-ledger-receipts/bundle?format=markdown"
      },
      {
        "slug": "oip-tap-go",
        "human_page": "https://miscsubjects.com/a/oip-tap-go",
        "bundle_markdown": "https://miscsubjects.com/api/articles/oip-tap-go/bundle?format=markdown"
      },
      {
        "slug": "oip-machine-json",
        "human_page": "https://miscsubjects.com/a/oip-machine-json",
        "bundle_markdown": "https://miscsubjects.com/api/articles/oip-machine-json/bundle?format=markdown"
      },
      {
        "slug": "oip-articles-content-plane",
        "human_page": "https://miscsubjects.com/a/oip-articles-content-plane",
        "bundle_markdown": "https://miscsubjects.com/api/articles/oip-articles-content-plane/bundle?format=markdown"
      },
      {
        "slug": "oip-files-deploy",
        "human_page": "https://miscsubjects.com/a/oip-files-deploy",
        "bundle_markdown": "https://miscsubjects.com/api/articles/oip-files-deploy/bundle?format=markdown"
      },
      {
        "slug": "oip-self-test-proof",
        "human_page": "https://miscsubjects.com/a/oip-self-test-proof",
        "bundle_markdown": "https://miscsubjects.com/api/articles/oip-self-test-proof/bundle?format=markdown"
      },
      {
        "slug": "oip-operating-playbook",
        "human_page": "https://miscsubjects.com/a/oip-operating-playbook",
        "bundle_markdown": "https://miscsubjects.com/api/articles/oip-operating-playbook/bundle?format=markdown"
      },
      {
        "slug": "oip-api",
        "human_page": "https://miscsubjects.com/a/oip-api",
        "bundle_markdown": "https://miscsubjects.com/api/articles/oip-api/bundle?format=markdown"
      },
      {
        "slug": "oip-rest",
        "human_page": "https://miscsubjects.com/a/oip-rest",
        "bundle_markdown": "https://miscsubjects.com/api/articles/oip-rest/bundle?format=markdown"
      },
      {
        "slug": "oip-curl",
        "human_page": "https://miscsubjects.com/a/oip-curl",
        "bundle_markdown": "https://miscsubjects.com/api/articles/oip-curl/bundle?format=markdown"
      },
      {
        "slug": "oip-cli",
        "human_page": "https://miscsubjects.com/a/oip-cli",
        "bundle_markdown": "https://miscsubjects.com/api/articles/oip-cli/bundle?format=markdown"
      },
      {
        "slug": "oip-mcp",
        "human_page": "https://miscsubjects.com/a/oip-mcp",
        "bundle_markdown": "https://miscsubjects.com/api/articles/oip-mcp/bundle?format=markdown"
      },
      {
        "slug": "oip-github",
        "human_page": "https://miscsubjects.com/a/oip-github",
        "bundle_markdown": "https://miscsubjects.com/api/articles/oip-github/bundle?format=markdown"
      },
      {
        "slug": "oip-github-mcp",
        "human_page": "https://miscsubjects.com/a/oip-github-mcp",
        "bundle_markdown": "https://miscsubjects.com/api/articles/oip-github-mcp/bundle?format=markdown"
      },
      {
        "slug": "oip-link-structure",
        "human_page": "https://miscsubjects.com/a/oip-link-structure",
        "bundle_markdown": "https://miscsubjects.com/api/articles/oip-link-structure/bundle?format=markdown"
      },
      {
        "slug": "oip-drop-end-to-end",
        "human_page": "https://miscsubjects.com/a/oip-drop-end-to-end",
        "bundle_markdown": "https://miscsubjects.com/api/articles/oip-drop-end-to-end/bundle?format=markdown"
      },
      {
        "slug": "oip-cron-recursion",
        "human_page": "https://miscsubjects.com/a/oip-cron-recursion",
        "bundle_markdown": "https://miscsubjects.com/api/articles/oip-cron-recursion/bundle?format=markdown"
      },
      {
        "slug": "oip-model-review-loop",
        "human_page": "https://miscsubjects.com/a/oip-model-review-loop",
        "bundle_markdown": "https://miscsubjects.com/api/articles/oip-model-review-loop/bundle?format=markdown"
      },
      {
        "slug": "oip-spec",
        "human_page": "https://miscsubjects.com/a/oip-spec",
        "bundle_markdown": "https://miscsubjects.com/api/articles/oip-spec/bundle?format=markdown"
      },
      {
        "slug": "oip-what-is-object",
        "human_page": "https://miscsubjects.com/a/oip-what-is-object",
        "bundle_markdown": "https://miscsubjects.com/api/articles/oip-what-is-object/bundle?format=markdown"
      },
      {
        "slug": "oip-what-is-capability",
        "human_page": "https://miscsubjects.com/a/oip-what-is-capability",
        "bundle_markdown": "https://miscsubjects.com/api/articles/oip-what-is-capability/bundle?format=markdown"
      },
      {
        "slug": "oip-what-is-token",
        "human_page": "https://miscsubjects.com/a/oip-what-is-token",
        "bundle_markdown": "https://miscsubjects.com/api/articles/oip-what-is-token/bundle?format=markdown"
      },
      {
        "slug": "oip-what-is-tenant",
        "human_page": "https://miscsubjects.com/a/oip-what-is-tenant",
        "bundle_markdown": "https://miscsubjects.com/api/articles/oip-what-is-tenant/bundle?format=markdown"
      },
      {
        "slug": "oip-voxel-graph",
        "human_page": "https://miscsubjects.com/a/oip-voxel-graph",
        "bundle_markdown": "https://miscsubjects.com/api/articles/oip-voxel-graph/bundle?format=markdown"
      },
      {
        "slug": "oip-cookbook",
        "human_page": "https://miscsubjects.com/a/oip-cookbook",
        "bundle_markdown": "https://miscsubjects.com/api/articles/oip-cookbook/bundle?format=markdown"
      },
      {
        "slug": "oip-mcp-github",
        "human_page": "https://miscsubjects.com/a/oip-mcp-github",
        "bundle_markdown": "https://miscsubjects.com/api/articles/oip-mcp-github/bundle?format=markdown"
      },
      {
        "slug": "oip-mcp-stripe",
        "human_page": "https://miscsubjects.com/a/oip-mcp-stripe",
        "bundle_markdown": "https://miscsubjects.com/api/articles/oip-mcp-stripe/bundle?format=markdown"
      }
    ],
    "recent_reviews": {
      "count": 3,
      "reviews": [
        {
          "event_id": "6810e928-9c98-4e0e-b386-394aac84a543",
          "ts": "2026-07-02T23:12:49.305Z",
          "model": "@cf/meta/llama-3.3-70b-instruct-fp8-fast",
          "trace_id": "t_g5c96klb",
          "status": 200,
          "scores": {
            "json_clarity": 9,
            "english_clarity": 8,
            "zero_context_human": 7,
            "curl_operability": 8,
            "mcp_comparison": 6
          },
          "pass": false,
          "missing_concepts": [
            "Detailed MCP explanation",
            "OIP security measures",
            "Error handling and debugging"
          ],
          "concrete_fixes": [
            {
              "target": "body",
              "field_or_section": "MCP explanation",
              "change": "Expand the explanation of MCP and its comparison to OIP"
            },
            {
              "target": "machine_json",
              "field_or_section": "security measures",
              "change": "Add a section on OIP security measures"
            }
          ]
        },
        {
          "event_id": "11ebf223-f42d-4339-9b41-e7a832cd9fa4",
          "ts": "2026-07-02T23:10:37.240Z",
          "model": "@cf/meta/llama-3.3-70b-instruct-fp8-fast",
          "trace_id": "t_gm4mxjo0",
          "status": 200,
          "scores": {
            "json_clarity": 9,
            "english_clarity": 8,
            "zero_context_human": 7,
            "curl_operability": 6,
            "mcp_comparison": 5
          },
          "pass": false,
          "missing_concepts": [
            "Detailed MCP explanation",
            "OIP security measures",
            "Error handling and debugging"
          ],
          "concrete_fixes": [
            {
              "target": "body",
              "field_or_section": "MCP explanation",
              "change": "Expand the explanation of MCP and its comparison to OIP"
            },
            {
              "target": "machine_json",
              "field_or_section": "error_handling",
              "change": "Add a section on error handling and debugging in the machine-native JSON"
            }
          ]
        },
        {
          "event_id": "ba093999-510c-4641-a42e-9c8e51de108d",
          "ts": "2026-07-02T23:07:51.499Z",
          "model": "@cf/meta/llama-3.3-70b-instruct-fp8-fast",
          "trace_id": "t_j7kotoqw",
          "status": 200,
          "scores": {
            "json_clarity": 9,
            "english_clarity": 8,
            "zero_context_human": 7,
            "curl_operability": 6,
            "mcp_comparison": 5
          },
          "pass": true,
          "missing_concepts": [
            "MCP explanation",
            "Detailed comparison of OIP and MCP"
          ],
          "concrete_fixes": [
            {
              "target": "body",
              "field_or_section": "Introduction",
              "change": "Add a brief summary of what OIP is and its purpose."
            },
            {
              "target": "machine_json",
              "field_or_section": "oip_article_library",
              "change": "Add more details about each article in the library, such as a brief summary and relevant links."
            }
          ]
        }
      ],
      "ledger_filter": "https://miscsubjects.com/admin/ledger?service=oip-review&key=OIP_ARTICLE_REVIEW"
    }
  }
}
```

## Append-only payload
```json
{
  "oip_articles_table": {
    "append_only": true,
    "latest_serves_page": true,
    "history": []
  },
  "review_events": {
    "count": 3,
    "reviews": [
      {
        "event_id": "6810e928-9c98-4e0e-b386-394aac84a543",
        "ts": "2026-07-02T23:12:49.305Z",
        "model": "@cf/meta/llama-3.3-70b-instruct-fp8-fast",
        "trace_id": "t_g5c96klb",
        "status": 200,
        "scores": {
          "json_clarity": 9,
          "english_clarity": 8,
          "zero_context_human": 7,
          "curl_operability": 8,
          "mcp_comparison": 6
        },
        "pass": false,
        "missing_concepts": [
          "Detailed MCP explanation",
          "OIP security measures",
          "Error handling and debugging"
        ],
        "concrete_fixes": [
          {
            "target": "body",
            "field_or_section": "MCP explanation",
            "change": "Expand the explanation of MCP and its comparison to OIP"
          },
          {
            "target": "machine_json",
            "field_or_section": "security measures",
            "change": "Add a section on OIP security measures"
          }
        ]
      },
      {
        "event_id": "11ebf223-f42d-4339-9b41-e7a832cd9fa4",
        "ts": "2026-07-02T23:10:37.240Z",
        "model": "@cf/meta/llama-3.3-70b-instruct-fp8-fast",
        "trace_id": "t_gm4mxjo0",
        "status": 200,
        "scores": {
          "json_clarity": 9,
          "english_clarity": 8,
          "zero_context_human": 7,
          "curl_operability": 6,
          "mcp_comparison": 5
        },
        "pass": false,
        "missing_concepts": [
          "Detailed MCP explanation",
          "OIP security measures",
          "Error handling and debugging"
        ],
        "concrete_fixes": [
          {
            "target": "body",
            "field_or_section": "MCP explanation",
            "change": "Expand the explanation of MCP and its comparison to OIP"
          },
          {
            "target": "machine_json",
            "field_or_section": "error_handling",
            "change": "Add a section on error handling and debugging in the machine-native JSON"
          }
        ]
      },
      {
        "event_id": "ba093999-510c-4641-a42e-9c8e51de108d",
        "ts": "2026-07-02T23:07:51.499Z",
        "model": "@cf/meta/llama-3.3-70b-instruct-fp8-fast",
        "trace_id": "t_j7kotoqw",
        "status": 200,
        "scores": {
          "json_clarity": 9,
          "english_clarity": 8,
          "zero_context_human": 7,
          "curl_operability": 6,
          "mcp_comparison": 5
        },
        "pass": true,
        "missing_concepts": [
          "MCP explanation",
          "Detailed comparison of OIP and MCP"
        ],
        "concrete_fixes": [
          {
            "target": "body",
            "field_or_section": "Introduction",
            "change": "Add a brief summary of what OIP is and its purpose."
          },
          {
            "target": "machine_json",
            "field_or_section": "oip_article_library",
            "change": "Add more details about each article in the library, such as a brief summary and relevant links."
          }
        ]
      }
    ],
    "ledger_filter": "https://miscsubjects.com/admin/ledger?service=oip-review&key=OIP_ARTICLE_REVIEW"
  },
  "ledger_filters": {
    "article_reviews": "https://miscsubjects.com/admin/ledger?service=oip-review&key=OIP_ARTICLE_REVIEW&q=oip",
    "model_chat_intake": "https://miscsubjects.com/admin/ledger?key=MODEL_CHAT_INTAKE",
    "editorial_board": "https://miscsubjects.com/admin/ledger?key=EDITORIAL_BOARD_DECISION"
  }
}
```

## Claims (5)

- **oip-c1** [system] The OIP article layer is generated from live directory rows, so it documents the objects that actually run the reference implementation.
  - sources: oip-s3, oip-s4
- **oip-c2** [system] The OIP operating path is caller to directory object to dispatch runner to invocation ledger to receipt.
  - sources: oip-s1
- **oip-c3** [system] Every executable capability in the reference implementation is reachable as an OIP object with a human article, a machine document, invocation history, and receipt path.
  - sources: oip-s2, oip-s3
- **oip-c4** [system] Tap & Go is the copy primitive: one drop carries credential, protocol, tree, search, execute, and receipt instructions without a separate token-map-bundle assembly step.
  - sources: oip-s2
- **oip-c5** [system] OIP receipts are the proof object for actions: they record request, response, actor, links, replay, repair, and lineage.
  - sources: oip-s2, oip-s5

## Source ledger (5)
- **oip-s1** - BUILD_SPEC object invocation path - https://miscsubjects.com/api/file/docs/BUILD_SPEC.md
  - Defines directory rows, dispatch, ledger, and the escalation path for changing the build.
- **oip-s2** - Object Invocation Protocol spec - https://miscsubjects.com/api/file/docs/OIP.md
  - Defines OIP surfaces, invariant loop, receipt/replay/repair, and invocation envelopes.
- **oip-s3** - Live OIP capability tree - https://miscsubjects.com/api/dispatch?map=1&format=markdown
  - Public recursive capability tree.
- **oip-s4** - Directory row documentation - https://miscsubjects.com/api/dispatch?key=OIP_TREE&format=markdown
  - Capability articles are generated from live rows.
- **oip-s5** - Invocation ledger - https://miscsubjects.com/api/invocations
  - Append-only invocation records and receipt links.

## LLM manifest
- human root: https://miscsubjects.com/a/oip
- machine root: https://miscsubjects.com/api/articles/oip/bundle?format=markdown
- raw OIP tree: https://miscsubjects.com/api/dispatch?map=1&format=markdown
- system article pattern: https://miscsubjects.com/a/oip-system-github
- capability article pattern: https://miscsubjects.com/a/oip-capability-github-list-issues
- token explain: https://miscsubjects.com/api/dispatch?explain=1&share=TOKEN
- receipt: https://miscsubjects.com/api/dispatch?receipt=inv_ID&share=TOKEN

## Recursive Review Loop
- seed: POST https://miscsubjects.com/api/protocol/oip-seed {slugs?, models?}
- tick: POST https://miscsubjects.com/api/protocol/run?role=oip-review
- ledger key: `OIP_ARTICLE_REVIEW`
- review questions:
  - How clear is the machine-native JSON to you as a model?
  - How clear is the English article body as an explanation of the JSON?
  - Could a zero-context human understand what this object is and how to use it?
  - Can the build operation described here be performed with curl? If yes, name the exact route shape. If no, name the missing shape.
  - Can this article explain how the object compares to MCP when MCP is relevant?
  - Which subsidiary concepts need their own OIP articles?
  - What concrete text or JSON field should be changed first?

### Recent Reviews
- 2026-07-02T23:12:49.305Z · @cf/meta/llama-3.3-70b-instruct-fp8-fast · fail scores={"json_clarity":9,"english_clarity":8,"zero_context_human":7,"curl_operability":8,"mcp_comparison":6}
- 2026-07-02T23:10:37.240Z · @cf/meta/llama-3.3-70b-instruct-fp8-fast · fail scores={"json_clarity":9,"english_clarity":8,"zero_context_human":7,"curl_operability":6,"mcp_comparison":5}
- 2026-07-02T23:07:51.499Z · @cf/meta/llama-3.3-70b-instruct-fp8-fast · pass scores={"json_clarity":9,"english_clarity":8,"zero_context_human":7,"curl_operability":6,"mcp_comparison":5}

## Versioning
- OIP docs are generated from live rows and this article layer.
- Future model failures should become new troubleshooting language in these articles.
- Receipts and STATE.md are the append-only memory of why the docs changed.

---

## §SELF — miscsubjects (paste without context)

**Principle:** Self-explaining payload — no external context required. This _self block describes what you are reading and where to look next.

**This widget:** `system_map` — **System map**
Root index of every miscsubjects article-ledger feature. Start here if you have zero context.
- **article slug:** `oip`
- **contains:** OIP article bundle, body, source ledger, machine JSON, token and receipt contract
- **how to use:** Read /a/oip first; traverse to system and capability articles; use scoped capability URLs only when acting.
- **read:** https://miscsubjects.com/api/articles/system-map

### Logical proof (verify each step)
1. Articles are voxel graphs of tiered claims, not prose blobs. → https://miscsubjects.com/api/articles/constitution
2. Claims link to hash-chained sources via source_ids. → https://miscsubjects.com/api/articles/oip/sources
3. Ask reads topology; ingest/claim append to ledger. → https://miscsubjects.com/api/protocol
4. Models queue growth: populate → collaborate → repair → reflex. → https://miscsubjects.com/api/protocol/grow
5. Graph proves its own shape (reflex) and $/claim (yield). → https://miscsubjects.com/graph.html?layer=reflex
6. Full feature index + _explain on every API response. → https://miscsubjects.com/api/articles/system-map

### Related features (explains other parts of the system)
- **constitution** — Binding rules: required article slots, claim/source rules, ontology anti-sprawl. · https://miscsubjects.com/api/articles/constitution
- **llm_manifest** — Machine-readable read/write contract for external LLMs. · https://miscsubjects.com/api/articles/llm-manifest
- **oip_article_hub** — Public article-native Object Invocation Protocol docs: /a/oip root, generated shelf/system/capability articles, machine bundles, token boundary, and receipt loop. · https://miscsubjects.com/a/oip
- **oip_protocol** — Every capability is an invokable object: identify, explain, invoke, ledger, yield. · https://miscsubjects.com/a/oip
- **bundle** — Paste-ready package: body + claims + sources + voxels + provenance + manifest + constitution. · https://miscsubjects.com/api/articles/oip/bundle?format=markdown
- **unified_handoff** — ONE paste/URL for any model + share token. Same self-explaining pattern as article bundle, but whole build. · https://miscsubjects.com/api/handoff?format=markdown

### Full index
- JSON: https://miscsubjects.com/api/articles/system-map
- Markdown: https://miscsubjects.com/api/articles/system-map?format=markdown

*Not medical advice. Tier-honest. Cite claim/source ids.*