palinode_save
Save important facts, decisions, insights, or project updates to a git-versioned memory for recall across sessions.
Instructions
Save a memory to Palinode. Use for important facts, decisions, insights, or project updates worth remembering across sessions. Provide either type (one of the enum values) or ps=true for the ProjectSnapshot shortcut — exactly one is required. If this call times out, the save may still have committed server-side: call palinode_search with a distinctive phrase from your content to confirm before retrying, so you don't create a duplicate entry.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ps | No | Shorthand for type=ProjectSnapshot — matches the CLI `--ps` flag and the `/ps` slash command. If true, `type` may be omitted (or set to ProjectSnapshot redundantly); other type values conflict and error. | |
| core | No | If true, this memory is always injected at session start (core memory). | |
| slug | No | Optional URL-safe filename slug (auto-generated if omitted) | |
| type | No | Memory type. Required unless `ps=true` is given. | |
| title | No | Optional human-readable title. Stored in frontmatter and used in list/search displays. | |
| claims | No | Claim-level source anchors: list of {text, source_id, span:{quote, quote_hash}} bindings resolving each claim to the source span that justifies it. claim_id is derived on save; read back via palinode_blame with claims=true. | |
| source | No | Source surface that created this memory. | |
| content | Yes | The memory content to save (markdown supported) | |
| project | No | Project slug shorthand — e.g. 'palinode' becomes entity 'project/palinode'. Pairs with `palinode_session_end`'s `project` field for consistent project tagging across save and session-end. | |
| sources | No | Source-citation anchors: list of {ref, quote, quote_hash} for passages this memory cites. | |
| entities | No | Related entity refs e.g. ['person/alice', 'project/alpha'] | |
| metadata | No | Additional frontmatter fields to merge into the saved memory. | |
| priority | No | Human-assigned memory priority (1–5). Stored as `priority` frontmatter; missing means normal (3). | |
| backed_by | No | Refs (category/slug) that support/back this memory (evidence links). | |
| epistemic | No | Epistemic marker: 'fact' (observed/verified), 'inference' (derived, lower trust), 'open_question' (unresolved), or 'unverified' (asserted but not checked). Omit to leave the memory unmarked (no claim is made — not treated as fact). | |
| confidence | No | Confidence in this memory's accuracy (0.0-1.0). | |
| contradicts | No | Refs (category/slug) this memory conflicts with; neither wins — surfaced for review. | |
| external_refs | No | SDLC object references such as github_pr or jira_issue. | |
| update_policy | No | Save behavior: append episodic memory or replace a living document. |