Arroway orchestrates people and AI agents around the decisions in force.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Call ONCE at the START of a session, before there is a task: what happened recently across all of this person's projects, opening with the roster of their projects (slug and purpose) and open handoffs.
Days back, counting today. Default 2; more only when picking up work after being away.
Call ONCE at the START of a session, before there is a task: what happened recently across all of this person's projects, opening with the roster of their projects (slug and purpose) and open handoffs.
| Argument | Type | Description |
|---|---|---|
| days | integer | Days back, counting today. Default 2; more only when picking up work after being away. |
{
"type": "object",
"required": [],
"properties": {
"days": {
"type": "integer",
"maximum": 30,
"minimum": 1,
"description": "Days back, counting today. Default 2; more only when picking up work after being away."
}
},
"additionalProperties": false
}Mark that you are taking an open handoff BEFORE working on it, so parallel sessions do not duplicate it. A claim is a mark, never a lock. Addressing rule: addressed to YOUR user — take it; to someone else — only a human in this conversation can decide to take it, and an autonomous session must leave it.
| Argument | Type | Description |
|---|---|---|
| note | string | Who is taking it — a routine names itself here. |
| handoff* | string | The #handle from the read, or the full id. |
| project* | string | Project slug. |
{
"type": "object",
"required": [
"project",
"handoff"
],
"properties": {
"note": {
"type": "string",
"maxLength": 16384,
"description": "Who is taking it — a routine names itself here."
},
"handoff": {
"type": "string",
"description": "The #handle from the read, or the full id."
},
"project": {
"type": "string",
"maxLength": 63,
"description": "Project slug."
}
},
"additionalProperties": false
}Close an open handoff when its work is DONE, alongside the arroway_log entry that records the residue. Work that removes what an open handoff exists to fix closes that handoff in the same pass — even when the handoff is someone else's. So this is also the call for someone ELSE's handoff, with a note naming what emptied it. A handoff that still carries real work, which a passer-by must never close, stays open; discarding a handoff is the human's gesture, in the panel.
| Argument | Type | Description |
|---|---|---|
| note | string | One line on what landed; it points at the residue. |
| handoff* | string | The #handle from the read, or the full id. |
| project* | string | Project slug. |
{
"type": "object",
"required": [
"project",
"handoff"
],
"properties": {
"note": {
"type": "string",
"maxLength": 16384,
"description": "One line on what landed; it points at the residue."
},
"handoff": {
"type": "string",
"description": "The #handle from the read, or the full id."
},
"project": {
"type": "string",
"maxLength": 63,
"description": "Project slug."
}
},
"additionalProperties": false
}Acknowledge the final part of a multi-part Arroway read with its read_id and receipt, closing the sequence. It is not a precondition for working.
| Argument | Type | Description |
|---|---|---|
| read_id* | string | Opaque id returned by the incomplete arroway_read response. |
| receipt* | string | Opaque receipt returned by the final part. |
{
"type": "object",
"required": [
"read_id",
"receipt"
],
"properties": {
"read_id": {
"type": "string",
"description": "Opaque id returned by the incomplete arroway_read response."
},
"receipt": {
"type": "string",
"description": "Opaque receipt returned by the final part."
}
},
"additionalProperties": false
}Fetch the next part of a read that did not fit in one response (read_id and receipt of the preceding part). Returns the next slice of what the first part named, with a new receipt; the part marked complete is the last, and arroway_complete_read acknowledges it. OPTIONAL: the first part already counts as delivered and names what later parts hold.
| Argument | Type | Description |
|---|---|---|
| read_id* | string | Opaque id returned by the incomplete arroway_read response. |
| receipt* | string | Opaque receipt returned by the immediately preceding part. |
{
"type": "object",
"required": [
"read_id",
"receipt"
],
"properties": {
"read_id": {
"type": "string",
"description": "Opaque id returned by the incomplete arroway_read response."
},
"receipt": {
"type": "string",
"description": "Opaque receipt returned by the immediately preceding part."
}
},
"additionalProperties": false
}Export OUT of a project what it has DECIDED, as a portable memory pack for another team or project. Only sanctioned, live memories travel: a FINDING never was one, so findings stay and the answer tells you how many did. Nothing about people travels.
| Argument | Type | Description |
|---|---|---|
| name* | string | What this pack IS, in a few words: the first thing the other side reads. |
| topic | string | Optional: export only the memories carrying this topic. |
| project* | string | Slug of the project whose norms you are exporting |
| description | string | Optional: who it is for, what it assumes. |
{
"type": "object",
"required": [
"project",
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 120,
"description": "What this pack IS, in a few words: the first thing the other side reads."
},
"topic": {
"type": "string",
"maxLength": 120,
"description": "Optional: export only the memories carrying this topic."
},
"project": {
"type": "string",
"maxLength": 63,
"description": "Slug of the project whose norms you are exporting"
},
"description": {
"type": "string",
"description": "Optional: who it is for, what it assumes."
}
},
"additionalProperties": false
}Bring a memory pack made by arroway_export INTO a project. Everything lands as a PROPOSAL for the person's review and nothing is pinned, whatever the pack says. If any part is malformed, nothing is imported.
| Argument | Type | Description |
|---|---|---|
| pack* | object | The pack document itself; this server does not fetch URLs. |
| project* | string | Project slug. Not from the person or a read this session? It is a guess: check the arroway_catch_up roster. |
{
"type": "object",
"required": [
"project",
"pack"
],
"properties": {
"pack": {
"type": "object",
"description": "The pack document itself; this server does not fetch URLs."
},
"project": {
"type": "string",
"maxLength": 63,
"description": "Project slug. Not from the person or a read this session? It is a guess: check the arroway_catch_up roster."
}
},
"additionalProperties": false
}Record the durable residue of a COMPLETED task in the team-visible daily log: what someone arriving later needs in order not to redo it, dated state included. ALWAYS write the authored essence (only a frozen catalog without that field may omit it). If the person corrected you for re-litigating a decision, say so. If this work made a read memory's 'dies when' true, name it in fulfills and it is retired with this entry.
| Argument | Type | Description |
|---|---|---|
| topic | string | Optional free tag (e.g. 'marketing') |
| source | string | Optional pointer to a living source (URL, doc, CRM id) |
| content* | string | What was decided, found or changed, and what it cost. You judge the length. |
| essence | string | One authored line with the operative result; never the opening of the body. |
| project* | string | Project slug. Not from the person or a read this session? It is a guess: check the arroway_catch_up roster. |
| fulfills | array | Memories whose 'dies when' this work made true (decision/fact/reference received in full in a read). Never one that merely looks old. |
| backfilled | boolean | true for history from BEFORE Arroway existed, not today's work. |
Move something to the project it belongs in. A memory is only PROPOSED: the change waits for the person's review, because moving changes who sees it. A log entry you wrote moves at once, text unchanged.
| Argument | Type | Description |
|---|---|---|
| why* | string | Why it belongs there and not here. For a memory, the person decides on this sentence. |
| memory* | string | #handle of the memory or log entry, from a read or arroway_search_log |
| target* | string | Slug of the project you believe it belongs to |
| project* | string | Slug of the project it is in TODAY |
{
"type": "object",
"required": [
"project",
"memory",
"target",
"why"
],
"properties": {
"why": {
"type": "string",
"maxLength": 16384,
"description": "Why it belongs there and not here. For a memory, the person decides on this sentence."
},
"memory": {
"type": "string",
"maxLength": 36,
"description": "#handle of the memory or log entry, from a read or arroway_search_log"
},
"target": {
"type": "string",
"maxLength": 63,
"description": "Slug of the project you believe it belongs to"
},
"project": {
"type": "string",
"maxLength": 63,
"description": "Slug of the project it is in TODAY"
}
},
"additionalProperties": false
}Call in the seconds BEFORE you tell the person something or propose a course of action: returns what is already decided (the project's and this person's own) AND THEN A MAP of the titles and handles of everything else. arroway_read include GUARANTEES a mapped one in full; it does not make that read any cheaper, so use it to be sure, never to pay less. Before publishing text for others, pass it as draft: what it touches comes back in full.
| Argument | Type | Description |
|---|---|---|
| draft | string | Optional: the text you will publish or say (PR, comment, message, page), ending with one line in the project's language on what it claims, recommends and names. |
| since | string | Optional: checkpoint from a previous arroway_norms call for THIS project (not the read's). Omit after compaction or in a new conversation. |
| project* | string | Project slug the claim is about. |
{
"type": "object",
"required": [
"project"
],
"properties": {
"draft": {
"type": "string",
"maxLength": 20000,
"description": "Optional: the text you will publish or say (PR, comment, message, page), ending with one line in the project's language on what it claims, recommends and names."
},
"since": {
"type": "string",
"description": "Optional: checkpoint from a previous arroway_norms call for THIS project (not the read's). Omit after compaction or in a new conversation."
},
"project": {
"type": "string",
"maxLength": 63,
"description": "Project slug the claim is about."
}
},
"additionalProperties": false
}Call when you STOP with the task unfinished (out of time, blocked, told to stop): it leaves a HANDOFF served at the top of every read until someone closes it; a completed task ends in arroway_log instead. ALWAYS write the authored essence (only a frozen catalog without that field may omit it). Write what the next session needs to continue, never a dump.
| Argument | Type | Description |
|---|---|---|
| card | string | Card, issue or PR, when one exists. |
| essence | string | One authored line with the operative in-flight state. |
| project* | string | Project slug. |
| next_step* | string | The single concrete next step. Not a plan: the step. |
| open_risk | string | The risk left open. |
| supersedes | string | #handle of the OPEN handoff this one replaces, from a read. |
| do_not_redo | string | What must NOT be redone or re-litigated. |
| addressed_to | string | Optional person or routine it is meant for; never a lock. |
| read_handles |
Read Arroway for a project BEFORE acting on any task related to it. It serves the authored essence of memories, dated-log entries and handoffs by default; name a #handle in include to recover that object's full body.
| Argument | Type | Description |
|---|---|---|
| since | string | Optional: checkpoint from a previous read of THIS project, so standing rules are not reprinted. Omit after compaction or in a new conversation. |
| handoff | string | Optional: #handle of an OPEN handoff you are continuing; the read is built from its reading list (none: falls back to the normal read). Cannot be combined with include. |
| include | array | #handles whose full body you need; they come first, so others fall out — it chooses, it does not add. |
| project* | string | Project slug, e.g. 'seven50' |
| task_context | string | Optional: what you are about to do; it ranks results. The declaration alone is NOT evidence of use: a matching completion residue from the same session must corroborate it. |
{
"type": "object",
"required": [
"project"
],
"properties": {
"since": {
"type": "string",
"description": "Optional: checkpoint from a previous read of THIS project, so standing rules are not reprinted. Omit after compaction or in a new conversation."
},
"handoff": {
"type": "string",
"description": "Optional: #handle of an OPEN handoff you are continuing; the read is built from its reading list (none: falls back to the normal read). Cannot be combined with include."
},
"include": {
"type": "array",
"items": {
"type": "string",
"maxLength": 36,
"minLength": 8
},
"maxItems": 10,
"minItems": 1,
"description": "#handles whose full body you need; they come first, so others fall out — it chooses, it does not add.",
"uniqueItems": true
},
"project": {
"type": "string",
"maxLength": 63,
"description": "Project slug, e.g. 'seven50'"
},
"task_context": {
"type": "string",
"maxLength": 16384,
"description": "Optional: what you are about to do; it ranks results. The declaration alone is NOT evidence of use: a matching completion residue from the same session must corroborate it."
}
},
"additionalProperties": false
}Save a durable memory (decision/rule/fact/preference/reference/identity): only what would change what someone does on a DIFFERENT task. Unsanctioned in THIS conversation, it is a PROPOSAL — never present it as a decision. 'identity' is WHO someone is: the user's circle goes in their personal project, a business's people in that business's project. A sourced fact or reference that only informs can be a finding, which cannot replace a sanctioned memory.
| Argument | Type | Description |
|---|---|---|
| type* | string | Kind of memory. |
| title* | string | Short, unique within the project |
| topic | string | Optional free tag (e.g. 'marketing'). |
| content* | string | The norm ITSELF, as if true today, in the shortest form that still governs correctly. Biography (who, when, quotes, dated numbers) goes in why_source; a specific case in example. |
| essence* | string | The operative norm or fact in ONE line. |
| example | string | A case illustrating the rule, shown in the panel; it NEVER travels in reads, so any criterion goes in content. |
| expires | boolean | true ONLY for a dated STATUS that would be stale after review_at. If unsure, omit. |
Retire a SANCTIONED memory when the person told you in this conversation to remove it and nothing replaces it. Archived, never deleted. With a corrected version, use arroway_remember supersedes_id; for your own pending proposal, arroway_withdraw.
| Argument | Type | Description |
|---|---|---|
| why | string | Optional: what the person said made it obsolete, in their terms. |
| memory* | string | The memory to retire — the #handle from a read is enough. |
| project* | string | Project slug. |
| decided_by_human* | boolean | Must be true, and only when the person explicitly told you to remove it IN THIS CONVERSATION. |
{
"type": "object",
"allOf": [
{
"properties": {
"decided_by_human": {
"const": true
}
}
}
],
"required": [
"project",
"memory",
"decided_by_human"
],
"properties": {
"why": {
"type": "string",
"maxLength": 16384,
"description": "Optional: what the person said made it obsolete, in their terms."
},
"memory": {
"type": "string",
"maxLength": 36,
"description": "The memory to retire — the #handle from a read is enough."
},
"project": {
"type": "string",
"maxLength": 63,
"description": "Project slug."
},
"decided_by_human": {
"type": "boolean",
"description": "Must be true, and only when the person explicitly told you to remove it IN THIS CONVERSATION."
}
},
"additionalProperties": false
}Find WHERE a literal term or phrase appeared in the recent dated log (essence and body), across every project of this person or one. Returns short excerpts anchored by project, date and entry. It searches what happened, not curated memory.
| Argument | Type | Description |
|---|---|---|
| query* | string | Literal term or phrase; case-insensitive. |
| project | string | Optional project slug; omit to search them all. |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"maxLength": 200,
"description": "Literal term or phrase; case-insensitive."
},
"project": {
"type": "string",
"maxLength": 63,
"description": "Optional project slug; omit to search them all."
}
},
"additionalProperties": false
}Open a NEW project when the work at hand has no home in Arroway; it needs slug, name and scope. Propose the name and scope to the person FIRST and call only once they agree. update=true renames a project you own and rewrites its scope, when the person asks or the scope is wrong; the slug stays. invite brings a person into the project at slug, when the person wants them in.
| Argument | Type | Description |
|---|---|---|
| name | string | How people will call it |
| slug* | string | Short, lowercase, hyphenated, unique — e.g. 'trading-solana' |
| scope | string | What belongs here and what does not: the subject AND what is out. |
| invite | string | Email of a person to bring in; name and scope not needed. Returns a checkout link if a team plan is needed. |
| update | boolean | true: change name and scope of the existing project at slug. |
{
"type": "object",
"required": [
"slug"
],
"properties": {
"name": {
"type": "string",
"maxLength": 120,
"description": "How people will call it"
},
"slug": {
"type": "string",
"maxLength": 63,
"description": "Short, lowercase, hyphenated, unique — e.g. 'trading-solana'"
},
"scope": {
"type": "string",
"maxLength": 8192,
"description": "What belongs here and what does not: the subject AND what is out."
},
"invite": {
"type": "string",
"maxLength": 200,
"description": "Email of a person to bring in; name and scope not needed. Returns a checkout link if a team plan is needed."
},
"update": {
"type": "boolean",
"description": "true: change name and scope of the existing project at slug."
}
},
"additionalProperties": false
}Record what a memory's source says when your work ALREADY took you there — never go verifying memories as a task, never guess an outcome. A FACT proven gone is retired at once; a conflicting one when you propose the correction with arroway_remember supersedes_id. On a FINDING, source_gone archives it and a conflict is corrected in place. Rules and decisions are only marked.
| Argument | Type | Description |
|---|---|---|
| note | string | Required for conflicts (what the source says) and source_gone (what proves removal). |
| memory* | string | The #handle from the read, or the full id. |
| outcome* | string | source_gone = PROVEN removed (404, file deleted, record gone), never mere unavailability (timeout, login wall, outage). conflicts = the source says something different. |
| project* | string | Project slug. |
{
"type": "object",
"allOf": [
{
"if": {
"required": [
"outcome"
],
"properties": {
"outcome": {
"const": "conflicts"
}
}
},
"then": {
"required": [
"note"
]
}
},
{
"if": {
"required": [
"outcome"
],
"properties": {
"outcome": {
"const": "source_gone"
}
}
},
"then": {
"required": [
"note"
]
}
}
],
"required": [
"project",
"memory",
"outcome"
],
"properties": {
"note": {
"type": "string",
"maxLength": 16384,
"description": "Required for conflicts (what the source says) and source_gone (what proves removal)."
},
"memory": {
"type": "string",
"maxLength": 36,
"description": "The #handle from the read, or the full id."
},
"outcome": {
"enum": [
"matches",
"source_gone",
"conflicts"
],
"type": "string",
"description": "source_gone = PROVEN removed (404, file deleted, record gone), never mere unavailability (timeout, login wall, outage). conflicts = the source says something different."
},
"project": {
"type": "string",
"maxLength": 63,
"description": "Project slug."
}
},
"additionalProperties": false
}Take back a pending PROPOSAL that turned out to be wrong, usually because the person corrected you. Not for sanctioned memories. It is kept as withdrawn, with your reason. If the corrected version is durable, also write it with arroway_remember.
| Argument | Type | Description |
|---|---|---|
| why* | string | What made it wrong — usually what the person said. |
| memory* | string | #handle of the proposal, from a read |
| project* | string | Project slug. |
| other_author_confirmed | boolean | Second call only, after Arroway said someone else's AI wrote the proposal: true to go ahead. |
{
"type": "object",
"required": [
"project",
"memory",
"why"
],
"properties": {
"why": {
"type": "string",
"maxLength": 16384,
"description": "What made it wrong — usually what the person said."
},
"memory": {
"type": "string",
"maxLength": 36,
"description": "#handle of the proposal, from a read"
},
"project": {
"type": "string",
"maxLength": 63,
"description": "Project slug."
},
"other_author_confirmed": {
"type": "boolean",
"description": "Second call only, after Arroway said someone else's AI wrote the proposal: true to go ahead."
}
},
"additionalProperties": false
}| keep_whole |
| boolean |
| true only after you considered cutting an indivisible oversized residue. |
| operational | boolean | true for HOW the work went (failures, measurements, self-corrections): kept for catch-up, out of task reads. |
{
"type": "object",
"required": [
"project",
"content"
],
"properties": {
"topic": {
"type": "string",
"maxLength": 120,
"description": "Optional free tag (e.g. 'marketing')"
},
"source": {
"type": "string",
"maxLength": 2048,
"description": "Optional pointer to a living source (URL, doc, CRM id)"
},
"content": {
"type": "string",
"maxLength": 65536,
"description": "What was decided, found or changed, and what it cost. You judge the length."
},
"essence": {
"type": "string",
"maxLength": 280,
"description": "One authored line with the operative result; never the opening of the body."
},
"project": {
"type": "string",
"maxLength": 63,
"description": "Project slug. Not from the person or a read this session? It is a guess: check the arroway_catch_up roster."
},
"fulfills": {
"type": "array",
"items": {
"type": "object",
"required": [
"memory",
"how"
],
"properties": {
"how": {
"type": "string",
"maxLength": 1000,
"description": "What met the kill condition, in one sentence."
},
"memory": {
"type": "string",
"maxLength": 36,
"description": "The #handle from the read, or the full id."
}
},
"additionalProperties": false
},
"maxItems": 20,
"minItems": 1,
"description": "Memories whose 'dies when' this work made true (decision/fact/reference received in full in a read). Never one that merely looks old."
},
"backfilled": {
"type": "boolean",
"description": "true for history from BEFORE Arroway existed, not today's work."
},
"keep_whole": {
"type": "boolean",
"description": "true only after you considered cutting an indivisible oversized residue."
},
"operational": {
"type": "boolean",
"description": "true for HOW the work went (failures, measurements, self-corrections): kept for catch-up, out of task reads."
}
},
"additionalProperties": false
}| array |
| The reading list: #handles of THIS project the next session must read in full, in order. Only what is required. |
| where_stopped* | string | What is done and verified, what is half-done. |
{
"type": "object",
"required": [
"project",
"where_stopped",
"next_step"
],
"properties": {
"card": {
"type": "string",
"description": "Card, issue or PR, when one exists."
},
"essence": {
"type": "string",
"maxLength": 280,
"description": "One authored line with the operative in-flight state."
},
"project": {
"type": "string",
"maxLength": 63,
"description": "Project slug."
},
"next_step": {
"type": "string",
"description": "The single concrete next step. Not a plan: the step."
},
"open_risk": {
"type": "string",
"description": "The risk left open."
},
"supersedes": {
"type": "string",
"description": "#handle of the OPEN handoff this one replaces, from a read."
},
"do_not_redo": {
"type": "string",
"description": "What must NOT be redone or re-litigated."
},
"addressed_to": {
"type": "string",
"description": "Optional person or routine it is meant for; never a lock."
},
"read_handles": {
"type": "array",
"items": {
"type": "string",
"maxLength": 36,
"minLength": 8
},
"maxItems": 10,
"description": "The reading list: #handles of THIS project the next session must read in full, in order. Only what is required.",
"uniqueItems": true
},
"where_stopped": {
"type": "string",
"description": "What is done and verified, what is half-done."
}
},
"additionalProperties": false
}| project* | string | Project slug. Not from the person or a read this session? It is a guess: check the arroway_catch_up roster. |
| review_at | string | YYYY-MM-DD when this stops being true on its own. REQUIRED for a fact, which leaves reads after it. |
| treatment | string | `governed` enters the person's review queue, a real cost to them; `finding` costs nobody a review and is never a norm. Does it GOVERN what someone may or must do, or only INFORM? Informs, with a source an agent can reopen and compare: finding (only fact and reference qualify). |
| backfilled | boolean | true for sourced HISTORY from before Arroway, on the topic just worked on; never a dump. |
| source_ptr | string | Pointer to the living source, when verifiable |
| why_source | string | Where it came from: the ONLY place for biography. This does NOT travel in reads; it is shown in the panel. |
| contradiction | string | Required with supersedes_id: what this changes in the earlier memory. |
| pin_suggested | boolean | Your judgement on pinning (travels in EVERY read). There is no default: required on a rule's second call. Above the ceiling it becomes a proposal of the pin alone. |
| supersedes_id | string | #handle of the memory this replaces, only for the SAME point: acting on either would already satisfy or violate the other. A shared topic is not enough. |
| kill_condition* | string | Mandatory: explicit revocation / named trigger / review date |
| related_checked | boolean | Second call only: true after reading the related memories shown. |
| decided_by_human* | boolean | true ONLY if the person stated or sanctioned it in THIS conversation; else a proposal. A proposal is never free: it costs that person a review. Then only a PINNED memory travels in every read; a normal one competes for space in the block relevant to each task. Never write an instruction to check, verify, be careful or look at the source, a step of a routine, or anything here only because something went wrong once. |
| split_considered | boolean | true only after looking for seams; splitting is the default. |
| example_considered | boolean | Second call only: true if the flagged example is criterion the rule needs. |
| pin_decision_token | string | Second call only: the first call's token, unchanged. |
| related_check_token | string | Second call only: token returned with the related memories. |
| pin_requested_by_human | boolean | true ONLY if the person told you in THIS conversation to keep it in every session. Sanctioning the CONTENT is not asking for the pin. Pins above any ceiling. |
| revoked_reconsideration | string | Second call only: the person's words in THIS conversation reconsidering a revoked finding. |
| treatment_justification | string | Required for a finding: why it is verifiable context, not policy. |
{
"type": "object",
"allOf": [
{
"if": {
"required": [
"type"
],
"properties": {
"type": {
"const": "fact"
}
}
},
"then": {
"required": [
"review_at"
]
}
},
{
"if": {
"required": [
"expires"
],
"properties": {
"expires": {
"const": true
}
}
},
"then": {
"required": [
"review_at"
]
}
}
],
"required": [
"project",
"type",
"title",
"content",
"essence",
"decided_by_human",
"kill_condition"
],
"properties": {
"type": {
"enum": [
"rule",
"decision",
"fact",
"preference",
"identity",
"reference"
],
"type": "string",
"description": "Kind of memory."
},
"title": {
"type": "string",
"maxLength": 200,
"description": "Short, unique within the project"
},
"topic": {
"type": "string",
"maxLength": 120,
"description": "Optional free tag (e.g. 'marketing')."
},
"content": {
"type": "string",
"maxLength": 65536,
"description": "The norm ITSELF, as if true today, in the shortest form that still governs correctly. Biography (who, when, quotes, dated numbers) goes in why_source; a specific case in example."
},
"essence": {
"type": "string",
"maxLength": 280,
"description": "The operative norm or fact in ONE line."
},
"example": {
"type": "string",
"maxLength": 16384,
"description": "A case illustrating the rule, shown in the panel; it NEVER travels in reads, so any criterion goes in content."
},
"expires": {
"type": "boolean",
"description": "true ONLY for a dated STATUS that would be stale after review_at. If unsure, omit."
},
"project": {
"type": "string",
"maxLength": 63,
"description": "Project slug. Not from the person or a read this session? It is a guess: check the arroway_catch_up roster."
},
"review_at": {
"type": "string",
"format": "date",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"maxLength": 10,
"description": "YYYY-MM-DD when this stops being true on its own. REQUIRED for a fact, which leaves reads after it."
},
"treatment": {
"enum": [
"governed",
"finding"
],
"type": "string",
"description": "`governed` enters the person's review queue, a real cost to them; `finding` costs nobody a review and is never a norm. Does it GOVERN what someone may or must do, or only INFORM? Informs, with a source an agent can reopen and compare: finding (only fact and reference qualify)."
},
"backfilled": {
"type": "boolean",
"description": "true for sourced HISTORY from before Arroway, on the topic just worked on; never a dump."
},
"source_ptr": {
"type": "string",
"maxLength": 2048,
"description": "Pointer to the living source, when verifiable"
},
"why_source": {
"type": "string",
"maxLength": 16384,
"description": "Where it came from: the ONLY place for biography. This does NOT travel in reads; it is shown in the panel."
},
"contradiction": {
"type": "string",
"description": "Required with supersedes_id: what this changes in the earlier memory."
},
"pin_suggested": {
"type": "boolean",
"description": "Your judgement on pinning (travels in EVERY read). There is no default: required on a rule's second call. Above the ceiling it becomes a proposal of the pin alone."
},
"supersedes_id": {
"type": "string",
"maxLength": 36,
"description": "#handle of the memory this replaces, only for the SAME point: acting on either would already satisfy or violate the other. A shared topic is not enough."
},
"kill_condition": {
"type": "string",
"description": "Mandatory: explicit revocation / named trigger / review date"
},
"related_checked": {
"type": "boolean",
"description": "Second call only: true after reading the related memories shown."
},
"decided_by_human": {
"type": "boolean",
"description": "true ONLY if the person stated or sanctioned it in THIS conversation; else a proposal. A proposal is never free: it costs that person a review. Then only a PINNED memory travels in every read; a normal one competes for space in the block relevant to each task. Never write an instruction to check, verify, be careful or look at the source, a step of a routine, or anything here only because something went wrong once."
},
"split_considered": {
"type": "boolean",
"description": "true only after looking for seams; splitting is the default."
},
"example_considered": {
"type": "boolean",
"description": "Second call only: true if the flagged example is criterion the rule needs."
},
"pin_decision_token": {
"type": "string",
"description": "Second call only: the first call's token, unchanged."
},
"related_check_token": {
"type": "string",
"description": "Second call only: token returned with the related memories."
},
"pin_requested_by_human": {
"type": "boolean",
"description": "true ONLY if the person told you in THIS conversation to keep it in every session. Sanctioning the CONTENT is not asking for the pin. Pins above any ceiling."
},
"revoked_reconsideration": {
"type": "string",
"description": "Second call only: the person's words in THIS conversation reconsidering a revoked finding."
},
"treatment_justification": {
"type": "string",
"description": "Required for a finding: why it is verifiable context, not policy."
}
},
"additionalProperties": false
}