neotoma 0.22.2 → 0.23.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (67) hide show
  1. package/README.md +2 -2
  2. package/dist/actions.d.ts.map +1 -1
  3. package/dist/actions.js +58 -54
  4. package/dist/actions.js.map +1 -1
  5. package/dist/config.d.ts +19 -0
  6. package/dist/config.d.ts.map +1 -1
  7. package/dist/config.js +79 -3
  8. package/dist/config.js.map +1 -1
  9. package/dist/docs/developer/mcp/compact_instructions.md +2 -0
  10. package/dist/docs/developer/mcp/instructions.md +30 -3
  11. package/dist/docs/developer/mcp/proxy.md +6 -4
  12. package/dist/docs/foundation/core_identity.md +45 -4
  13. package/dist/docs/foundation/developer_release_principles.md +4 -1
  14. package/dist/docs/foundation/layered_architecture.md +10 -0
  15. package/dist/docs/foundation/mmry_comparison.md +4 -4
  16. package/dist/docs/foundation/problem_statement.md +3 -1
  17. package/dist/docs/foundation/product_positioning.md +21 -17
  18. package/dist/docs/foundation/redlines.md +21 -2
  19. package/dist/docs/foundation/scope_decisions.md +32 -10
  20. package/dist/docs/getting_started/what_is_neotoma.md +1 -1
  21. package/dist/docs/icp/icp_from_functionality.md +4 -2
  22. package/dist/docs/icp/icp_reconciliation.md +12 -1
  23. package/dist/docs/operations/configuration.md +54 -42
  24. package/dist/docs/reference/error_codes.md +27 -0
  25. package/dist/docs/specs/MCP_SPEC.md +1 -1
  26. package/dist/docs/subsystems/conflict_resolution.md +11 -6
  27. package/dist/docs/subsystems/observation_architecture.md +2 -2
  28. package/dist/docs/subsystems/reducer.md +29 -3
  29. package/dist/docs/subsystems/schema_registry.md +11 -0
  30. package/dist/docs/testing/automated_test_catalog.md +20 -9
  31. package/dist/mcp_http_session.d.ts +51 -0
  32. package/dist/mcp_http_session.d.ts.map +1 -0
  33. package/dist/mcp_http_session.js +173 -0
  34. package/dist/mcp_http_session.js.map +1 -0
  35. package/dist/reducers/observation_reducer.d.ts.map +1 -1
  36. package/dist/reducers/observation_reducer.js +24 -6
  37. package/dist/reducers/observation_reducer.js.map +1 -1
  38. package/dist/server.d.ts +31 -2
  39. package/dist/server.d.ts.map +1 -1
  40. package/dist/server.js +189 -16
  41. package/dist/server.js.map +1 -1
  42. package/dist/services/field_canonicalization.d.ts +1 -0
  43. package/dist/services/field_canonicalization.d.ts.map +1 -1
  44. package/dist/services/field_canonicalization.js +15 -9
  45. package/dist/services/field_canonicalization.js.map +1 -1
  46. package/dist/services/interpretation.d.ts +2 -0
  47. package/dist/services/interpretation.d.ts.map +1 -1
  48. package/dist/services/interpretation.js +2 -1
  49. package/dist/services/interpretation.js.map +1 -1
  50. package/dist/services/schema_definitions.d.ts.map +1 -1
  51. package/dist/services/schema_definitions.js +108 -0
  52. package/dist/services/schema_definitions.js.map +1 -1
  53. package/dist/services/schema_registry.d.ts +16 -1
  54. package/dist/services/schema_registry.d.ts.map +1 -1
  55. package/dist/services/schema_registry.js.map +1 -1
  56. package/dist/services/skills/instance_skills.d.ts +137 -0
  57. package/dist/services/skills/instance_skills.d.ts.map +1 -0
  58. package/dist/services/skills/instance_skills.js +381 -0
  59. package/dist/services/skills/instance_skills.js.map +1 -0
  60. package/dist/services/store_warning_rule.d.ts +97 -0
  61. package/dist/services/store_warning_rule.d.ts.map +1 -0
  62. package/dist/services/store_warning_rule.js +175 -0
  63. package/dist/services/store_warning_rule.js.map +1 -0
  64. package/dist/tool_definitions.js +1 -1
  65. package/dist/tool_definitions.js.map +1 -1
  66. package/docs/developer/mcp/instructions.md +30 -3
  67. package/package.json +2 -2
package/dist/config.d.ts CHANGED
@@ -23,6 +23,25 @@ export declare const config: {
23
23
  mcpTokenEncryptionKey: string;
24
24
  /** When true, MCP clients receive the compact instruction block (same body as runtime fallback) instead of the full fenced block from docs — for dual-host setups that already load workspace Neotoma rules. */
25
25
  mcpCompactInstructions: boolean;
26
+ /**
27
+ * When false, MCP `initialize` skips the graph-stored skill lookup entirely
28
+ * and the instructions block is byte-identical to what it was before
29
+ * instance skill hints existed (#2046).
30
+ *
31
+ * Defaults to ON, unlike `mcpCompactInstructions` above. The feature exists
32
+ * because a hosted instance's skills are otherwise undiscoverable to an
33
+ * MCP-only client, and a discovery fix that an operator has to find and
34
+ * enable does not fix discovery. Instances with no `skill` rows already
35
+ * render nothing, so the default costs them one bounded read and no
36
+ * instruction bytes; the flag is the escape hatch for an operator who wants
37
+ * the section gone regardless.
38
+ *
39
+ * Note the polarity: this reads the env var for an explicit OFF, where the
40
+ * compact flag reads it for an explicit ON. Only `0`/`false` disable it, so
41
+ * an unset or unparseable value keeps the documented default rather than
42
+ * silently turning the feature off.
43
+ */
44
+ mcpInstanceSkillHints: boolean;
26
45
  oauthClientId: string;
27
46
  /**
28
47
  * Additional exact callback URLs an operator trusts to receive an authorization
@@ -1 +1 @@
1
- {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAqQA,eAAO,MAAM,MAAM;;;;eAIO,QAAQ,GAAG,QAAQ;IAC3C,0FAA0F;;IAE1F,6DAA6D;;;;;;;;;;;;;;;;IA4B7D,gNAAgN;;;IAKhN;;;;;;;;;;;OAWG;;;;;;;;;;;;;;;;CAgCJ,CAAC;AAEF;;;GAGG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAsBpC"}
1
+ {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAgUA,eAAO,MAAM,MAAM;;;;eAIO,QAAQ,GAAG,QAAQ;IAC3C,0FAA0F;;IAE1F,6DAA6D;;;;;;;;;;;;;;;;IA4B7D,gNAAgN;;IAIhN;;;;;;;;;;;;;;;;;OAiBG;;;IAMH;;;;;;;;;;;OAWG;;;;;;;;;;;;;;;;CAgCJ,CAAC;AAEF;;;GAGG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAsBpC"}
package/dist/config.js CHANGED
@@ -16,21 +16,77 @@ function resolveUserEnvPath() {
16
16
  return null;
17
17
  return join(homeDir, ".config", "neotoma", ".env");
18
18
  }
19
+ /**
20
+ * Is this process test-shaped (issue #2387)?
21
+ *
22
+ * `VITEST` is set by the vitest runner in workers; `NODE_ENV=test` is set by
23
+ * `vitest.global_setup.ts` and is the conventional signal a child process
24
+ * inherits. `NEOTOMA_REQUIRE_EXPLICIT_DATA_DIR=1` lets any caller demand the
25
+ * same strictness without pretending to be a test.
26
+ */
27
+ function requiresExplicitDataDir() {
28
+ if (process.env.NEOTOMA_REQUIRE_EXPLICIT_DATA_DIR?.trim() === "1")
29
+ return true;
30
+ if (process.env.VITEST?.trim())
31
+ return true;
32
+ return process.env.NODE_ENV?.trim() === "test";
33
+ }
34
+ /** Deliberate opt-in that re-permits the user-level fallback under test (issue #2387). */
35
+ function userEnvFallbackAllowedInTest() {
36
+ return process.env.NEOTOMA_ALLOW_USER_ENV_IN_TEST?.trim() === "1";
37
+ }
38
+ /**
39
+ * Refuse the `~/.config/neotoma/.env` data-directory fallback in a test-shaped
40
+ * process (issue #2387).
41
+ *
42
+ * A CLI child spawned by a test does not necessarily inherit `NEOTOMA_DATA_DIR`.
43
+ * Without this guard such a child hydrated the variable from the user-level
44
+ * config and then read and wrote the data directory it names — the operator's
45
+ * real database — silently and with exit code 0. A test that passes against
46
+ * residue in real data is green for the wrong reason twice over, and the write
47
+ * itself is invisible because nothing fails.
48
+ *
49
+ * So: stop, name the variable to set, and exit non-zero. Non-test processes are
50
+ * untouched — the interactive CLI and the server keep hydrating exactly as
51
+ * before — and `NEOTOMA_ALLOW_USER_ENV_IN_TEST=1` re-permits it for the rare
52
+ * test that genuinely means to exercise the fallback.
53
+ */
54
+ function refuseUserEnvFallbackUnderTest(userEnvPath, configuredDataDir) {
55
+ const message = [
56
+ "[neotoma] Refusing to resolve the data directory from the user-level config while running under test.",
57
+ ` A test-shaped process (VITEST / NODE_ENV=test / NEOTOMA_REQUIRE_EXPLICIT_DATA_DIR=1) has no explicit NEOTOMA_DATA_DIR,`,
58
+ ` so ${userEnvPath} would have pointed it at a data directory holding real data.`,
59
+ "",
60
+ " Set NEOTOMA_DATA_DIR to a test-scoped directory in the environment of this process",
61
+ " (and pass it explicitly to any CLI child process the test spawns).",
62
+ " To exercise the user-level fallback on purpose, set NEOTOMA_ALLOW_USER_ENV_IN_TEST=1.",
63
+ ].join("\n");
64
+ process.stderr.write(`${message}\n`);
65
+ // Length, not content: the configured path may name a real operator directory.
66
+ process.stderr.write(`[neotoma] (refused user-level data directory: ${configuredDataDir.length} chars, not used)\n`);
67
+ process.exit(1);
68
+ }
19
69
  function hydrateDataDirFromUserEnvConfig() {
20
70
  if (process.env.NEOTOMA_DATA_DIR?.trim())
21
71
  return;
22
72
  const userEnvPath = resolveUserEnvPath();
23
73
  if (!userEnvPath || !existsSync(userEnvPath))
24
74
  return;
75
+ let configuredDataDir;
25
76
  try {
26
77
  const parsed = dotenv.parse(readFileSync(userEnvPath, "utf-8"));
27
- const configuredDataDir = parsed.NEOTOMA_DATA_DIR?.trim();
28
- if (configuredDataDir)
29
- process.env.NEOTOMA_DATA_DIR = configuredDataDir;
78
+ configuredDataDir = parsed.NEOTOMA_DATA_DIR?.trim();
30
79
  }
31
80
  catch {
32
81
  // Ignore invalid user env files and continue with existing fallbacks.
82
+ return;
83
+ }
84
+ if (!configuredDataDir)
85
+ return;
86
+ if (requiresExplicitDataDir() && !userEnvFallbackAllowedInTest()) {
87
+ refuseUserEnvFallbackUnderTest(userEnvPath, configuredDataDir);
33
88
  }
89
+ process.env.NEOTOMA_DATA_DIR = configuredDataDir;
34
90
  }
35
91
  function isNeotomaRepoRoot(candidate) {
36
92
  if (!candidate)
@@ -272,6 +328,26 @@ export const config = {
272
328
  /** When true, MCP clients receive the compact instruction block (same body as runtime fallback) instead of the full fenced block from docs — for dual-host setups that already load workspace Neotoma rules. */
273
329
  mcpCompactInstructions: (process.env.NEOTOMA_MCP_COMPACT_INSTRUCTIONS || "").toLowerCase() === "1" ||
274
330
  (process.env.NEOTOMA_MCP_COMPACT_INSTRUCTIONS || "").toLowerCase() === "true",
331
+ /**
332
+ * When false, MCP `initialize` skips the graph-stored skill lookup entirely
333
+ * and the instructions block is byte-identical to what it was before
334
+ * instance skill hints existed (#2046).
335
+ *
336
+ * Defaults to ON, unlike `mcpCompactInstructions` above. The feature exists
337
+ * because a hosted instance's skills are otherwise undiscoverable to an
338
+ * MCP-only client, and a discovery fix that an operator has to find and
339
+ * enable does not fix discovery. Instances with no `skill` rows already
340
+ * render nothing, so the default costs them one bounded read and no
341
+ * instruction bytes; the flag is the escape hatch for an operator who wants
342
+ * the section gone regardless.
343
+ *
344
+ * Note the polarity: this reads the env var for an explicit OFF, where the
345
+ * compact flag reads it for an explicit ON. Only `0`/`false` disable it, so
346
+ * an unset or unparseable value keeps the documented default rather than
347
+ * silently turning the feature off.
348
+ */
349
+ mcpInstanceSkillHints: !((process.env.NEOTOMA_MCP_INSTANCE_SKILL_HINTS || "").toLowerCase() === "0" ||
350
+ (process.env.NEOTOMA_MCP_INSTANCE_SKILL_HINTS || "").toLowerCase() === "false"),
275
351
  oauthClientId: process.env.NEOTOMA_OAUTH_CLIENT_ID || "",
276
352
  /**
277
353
  * Additional exact callback URLs an operator trusts to receive an authorization
@@ -1 +1 @@
1
- {"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}
@@ -47,6 +47,8 @@ The Neotoma server has two compact-mode payloads:
47
47
 
48
48
  Both contain the same `MCP_INTERACTION_INSTRUCTIONS_COMPACT_BODY_LINES` content. The header line differs so agents and operators can distinguish an intentional compact deployment from a fallback caused by a broken doc path.
49
49
 
50
+ Compact mode also narrows the `[INSTANCE SKILLS]` section appended for graph-stored skills: names are listed without descriptions, and the section header says so while still instructing agents to match ordinary user intent against the catalog before fetching the selected skill body. See the `Instance-stored skills` entry under `[INITIALIZATION]` in [`instructions.md`](./instructions.md) for both rendered examples. That section is controlled independently by `NEOTOMA_MCP_INSTANCE_SKILL_HINTS` (default on; set `0` to omit it entirely).
51
+
50
52
  ---
51
53
 
52
54
  ## Setting the environment variable
@@ -54,7 +54,7 @@ Entities **`entities[]` shape:** put every intended observation field at the **t
54
54
  MCP tool choice: prefer **`store`** for all writes (entities-only, file-only, or combined). Deprecated MCP aliases `store_structured` and `store_unstructured` call the same handler as **`store`** until removed; use **`store`** in new prompts and configs.
55
55
  Relationship batching: define ALL known links in the **`store`** `relationships` array whenever possible. Use { relationship_type, source_index, target_index } for entities in the same request, or { relationship_type, source_entity_id, target_entity_id } for existing entities already known by id. If you need to link an existing conversation/message/source entity to newly created entities, prefer re-including the existing entity in `entities` by stable identity fields and linking by index, or use id-based relationship entries in the same store call. If relationships must be created after a store response, use create_relationships with a relationships array; do not issue one create_relationship call per link when batching is possible.
56
56
  Interpretation batching: when an agent extracts entities from a stored source (file, email, API detail payload, transcript, or other raw artifact), prefer one **`store`** call with `interpretation: { source_id | source_ref, interpretation_config }` plus any `relationships`. Use `source_ref: "unstructured"` for the raw file source in a combined file+entities store, and `source_ref: "structured"` only when intentionally interpreting the generated JSON source. Use `create_interpretation` when the source already exists and you are adding a post-hoc interpretation; use list_interpretations to review interpretation runs for a source. Omit `interpretation` for ordinary user-stated/chat-native structured facts; those observations intentionally keep `interpretation_id = NULL`.
57
- Immutability: observations and sources are immutable after creation. correct creates a new priority-1000 observation that wins in snapshot reduction; it does not edit or delete prior observations.
57
+ Immutability: observations and sources are immutable after creation. correct creates a new priority-1000 observation; it does not edit or delete prior observations. The correction supersedes lower-priority observations, while a higher-priority source remains authoritative and an equal-priority tie follows the schema's source-kind precedence before deterministic recency. After correct, independently retrieve the entity snapshot and field provenance; verify the intended value and the new correction observation materialized before claiming the correction took effect.
58
58
  Turn identity: use host conversation_id/thread_id/session_id and turn_id when available. If the host does not provide them, derive ONE stable synthetic conversation id for the visible chat/thread and reuse it for every turn in that thread; combine it with a monotonically increasing turn index or per-turn timestamp. Put that stable value on the `conversation` entity as `conversation_id`; set message `turn_key = "{conversation_id}:{turn_id}"`; set idempotency_key unique per turn (e.g. conversation-{conversation_id}-{turn_id}-{timestamp_ms}). conversation_id MUST be unique per conversation but stable within that conversation; do not mint a new conversation entity for each user message in the same visible chat. Unscoped turn_keys like "cursor:1" cause cross-conversation entity collisions where unrelated messages merge into the same agent_message entity. When the host provides only a generic session prefix, append a conversation-distinguishing suffix (e.g. timestamp of first message, or a short hash of the conversation title) and keep that suffix stable for the thread.
59
59
  Session UUID bridge (Claude Code): in Claude Code contexts the SessionStart hook creates a `conversation` entity keyed by the raw session UUID while the MCP agent creates a slug-keyed entity (conversation_id = derived slug). Call `get_session_identity` once per session — at user-phase Step 2 retrieval or Step 3 store time — and include `session_uuid: <UUID returned by get_session_identity>` on the slug-keyed `conversation` entity. This cross-references the hook-created UUID entity and the agent-created slug entity so timeline events, observations, and conversation_turn rows written by hooks can be correlated with the MCP conversation without server-side coalescing. FORBIDDEN: omitting `session_uuid` on the `conversation` entity in Claude Code contexts when `get_session_identity` is available and returns a session UUID.
60
60
  Fallback IDs: if the host provides no conversation_id/turn_id at all, derive a stable synthetic conversation id from the visible thread context (e.g. "chat-<topic-or-first-message-hash>-<session-start-timestamp>") and reuse it; use idempotency_key "conversation-{synthetic_conversation_id}-<turn>-<timestamp_ms>" and turn_key "{synthetic_conversation_id}:<turn>" (e.g. chat-neotoma-hooks-2026-05-05:5). When no topic or thread context is available, use a session-epoch-scoped fallback: turn_key "chat-<session_epoch_ms>:<turn>" (e.g. chat-1747344000000:1) and idempotency_key "conversation-chat-<session_epoch_ms>-<turn>-<timestamp_ms>", where session_epoch_ms is the millisecond timestamp of the first message in the current session (fixed for the session lifetime). FORBIDDEN: using a fresh fallback conversation id or generic "chat:<turn>" prefix for every message in one UI conversation. FORBIDDEN: using bare "chat:<turn>" (without a session-epoch or other session-distinguishing suffix) as a turn_key fallback — bare chat:N values reuse across sessions and cause cross-session entity merges.
@@ -280,10 +280,37 @@ Forward compatibility: treat an unrecognized `reason_code` as a hard denial and
280
280
 
281
281
  [INITIALIZATION]
282
282
  Session orientation: at the start of every session, call `get_session_identity` to obtain the authenticated user and session UUID (used to cross-reference hook-created conversation entities — see [STORE RECIPES] Session UUID bridge). Call `list_entity_types` (no keyword) to warm the session type cache so entity-type reuse and schema checks run against known types without a discovery round-trip mid-task. Both calls are bounded reads; execute them together before the first user-message store.
283
- Available skills: when the MCP `initialize` response carries `serverInfo._neotoma.available_skills` (an array of skill name strings), treat every listed skill as immediately available for the current harness session — do not re-discover or re-install them. Invoke a skill by its name (e.g. `/store-data`, `/remember-codebase`) when the user's request matches its purpose. If `available_skills` is absent or empty, skills may still be present; check the harness skills directory or ask the user.
284
- Skills loaded at initialize: skills surfaced via `serverInfo._neotoma.available_skills` are installed by `neotoma setup` and already linked into the harness skills directory. They cover: `ensure-neotoma` (self-check and setup), `query-memory` (search and retrieve entities), `store-data` (structured entity storage with provenance), `remember-codebase` (index a repo into Neotoma), `remember-contacts`, `remember-conversations`, `remember-email`, `remember-finances`, `remember-calendar`, `remember-meetings`, `recover-sqlite-database` (corruption repair). The active list may differ — prefer the `available_skills` array from `initialize` over this static enumeration.
283
+ Available skills: `serverInfo._neotoma.available_skills` is an array of skill name strings that this session may use. It is a UNION of two sources that are invoked differently, so the array alone tells you a skill EXISTS, not how to run it. A name that also appears in the instructions block's `[INSTANCE SKILLS]` section is graph-stored and its body must be fetched before use (see `Instance-stored skills` below). Every other name is a local skill, already installed and linked into the harness skills directory — invoke it directly by name (e.g. `/store-data`, `/remember-codebase`) when the user's request matches its purpose, and do not re-discover or re-install it. If `available_skills` is absent or empty, skills may still be present: check the harness skills directory or ask the user. If `serverInfo._neotoma.skills_unavailable` is true, the graph-stored skill lookup FAILED for this session — an empty or local-only array then means unknown, not none; say so rather than telling the user this instance has no skills.
284
+ Skills loaded at initialize: the LOCAL half of `available_skills` is installed by `neotoma setup` and already linked into the harness skills directory. It typically covers: `ensure-neotoma` (self-check and setup), `query-memory` (search and retrieve entities), `store-data` (structured entity storage with provenance), `remember-codebase` (index a repo into Neotoma), `remember-contacts`, `remember-conversations`, `remember-email`, `remember-finances`, `remember-calendar`, `remember-meetings`, `recover-sqlite-database` (corruption repair). The active list may differ — prefer the `available_skills` array from `initialize` over this static enumeration, and note that on a hosted instance none of these may be present locally.
285
285
  Skill auto-loading at session start. On every MCP `initialize`, the harness MUST detect available skills in the active workspace (`.claude/skills/`, `.cursor/skills/`, `.codex/skills/`, or the harness's documented skill registry path) and ensure they are registered with the agent context. If skills are already detected, this is a no-op. Emit a log/trace entry naming auto-loaded vs already-present skills. This requirement is idempotent and applies regardless of whether the user explicitly invoked a skill in the prior turn.
286
286
  Instance skills / scripts materialization (CLI-only, no MCP tool — writing files to the invoking machine's local filesystem has no server-side equivalent; see `docs/developer/cli_reference.md` and `docs/skills/skill_strategy.md`): `neotoma skills sync --include-instance-skills` / `--include-instance-scripts` / `--approve-scripts` (deprecated hidden alias: `--approve`) fetch instance-stored `skill` entities (and their `EMBEDS`'d script attachments, hash-pin gated) into the local harness skill directories. There is no MCP-side equivalent tool for this capability; do not infer one exists.
287
+ Instance-stored skills: skills stored in the graph as `skill` entities have NO body on disk, so they cannot be invoked by name the way a local skill can. When the instructions block carries an `[INSTANCE SKILLS]` section, every name listed there is graph-stored, and the section gives names and descriptions ONLY. Use that catalog for ordinary intent matching first: the user does not need to say Neotoma, Ateles, a skill name, or an entity ID. Resolve the authorized instance context from the session; if one listed skill clearly matches the user's request, select it, and if several could match, clarify only that ambiguity. Before running the selected skill, fetch its full markdown body with `retrieve_entity_by_identifier` using `entity_type: "skill"`, `by: "name"`, and `identifier` set to the skill name; the body is the snapshot's `content` field. Follow that body's constraints, execution steps, and readback requirements once fetched. Do not assume a graph-stored skill has a local file, and do not attempt to materialize any script it references — fetch and follow the markdown only. The fetch call shape is:
288
+
289
+ { "name": "retrieve_entity_by_identifier",
290
+ "arguments": { "entity_type": "skill", "by": "name", "identifier": "audit-graph" } }
291
+
292
+ A rendered section looks like this (full mode). The count in the header is the number of skills the instance holds, which may exceed the number of lines listed:
293
+
294
+ [INSTANCE SKILLS]
295
+ This instance stores 2 skills as `skill` entities in the graph. They are available to this session even though no local skills directory is present. Names and descriptions only are listed below. Match ordinary user intent against this catalog; the user does not need to say Neotoma, Ateles, a skill name, or an entity id. If one skill clearly matches the authorized instance context, select it; if several could match, clarify only that ambiguity. To run one, first fetch its full body with retrieve_entity_by_identifier with entity_type "skill", by "name", and identifier set to the skill name, then follow that body's constraints, execution steps, and readback requirements.
296
+ - audit-graph — Audit the graph for undeclared fragments.
297
+ - capture-meeting — (no description)
298
+
299
+ Under `NEOTOMA_MCP_COMPACT_INSTRUCTIONS`, descriptions are omitted and the header says so:
300
+
301
+ [INSTANCE SKILLS]
302
+ This instance stores 2 skills as `skill` entities in the graph. They are available to this session even though no local skills directory is present. Names only are listed below. Match ordinary user intent against this catalog; the user does not need to say Neotoma, Ateles, a skill name, or an entity id. If one skill clearly matches the authorized instance context, select it; if several could match, clarify only that ambiguity. To run one, first fetch its full body with retrieve_entity_by_identifier with entity_type "skill", by "name", and identifier set to the skill name, then follow that body's constraints, execution steps, and readback requirements.
303
+ - audit-graph
304
+ - capture-meeting
305
+
306
+ The list is capped, and truncation is stated rather than silent — a 5-skill instance rendered at a cap of 3 ends with an explicit remainder line:
307
+
308
+ - audit-graph — Audit the graph for undeclared fragments.
309
+ - capture-meeting — Record a meeting into the graph.
310
+ - draft-reply — Draft a reply from stored context.
311
+ …and 2 more (fetch by name as above).
312
+
313
+ If the section is replaced by a note saying the skills could not be read, the lookup failed: treat this instance's skills as unknown, do not report that it has none, and retry on a later connection. The section is emitted by default and can be turned off with `NEOTOMA_MCP_INSTANCE_SKILL_HINTS=0`, in which case the instructions carry no `[INSTANCE SKILLS]` section at all.
287
314
 
288
315
  [ONBOARDING]
289
316
  Discovery flow: when Neotoma has little or no data (first run or empty state), follow the onboarding sequence from install.md — (1) ask the user which data types matter most (project files, chat transcripts, meeting notes, notes/journals, code context, email, financial docs, custom paths) and which mode they prefer (quick win, guided, power user); (2) discover high-value local files by scanning shallowly — rank by entity density, temporal signals, recency, and relationship potential per docs/foundation/file_ranking_heuristic.md; (3) group results into domains (not file counts) and explain why each was selected and what timeline value it could unlock; (4) let the user confirm per-folder or per-file with an expected reconstruction preview; (5) ingest confirmed files and reconstruct the strongest timeline with provenance (each event traced to a specific source file); (6) show the timeline immediately — not a file count; (7) offer one follow-up query specific to the reconstructed entity and 2–4 leveraged next actions; (8) demonstrate correction. See docs/developer/agent_onboarding_confirmation.md for the full specification.
@@ -73,14 +73,16 @@ HTTP and stdio transports share the same **`NeotomaServer`** `initialize` behavi
73
73
 
74
74
  Streamable HTTP MCP keeps each session in **process memory** (`mcpTransports` in `src/actions.ts`). The stdio proxy captures **`mcp-session-id`** from the **`initialize`** response and attaches it to later tool calls.
75
75
 
76
- As of neotoma#1923, an unknown/expired session returns **404** (not 503), per the [MCP Streamable HTTP session management spec](https://modelcontextprotocol.io/specification/2025-11-25/basic/transports#session-management) — this lets spec-compliant clients auto-reinitialize instead of treating the server as unavailable. Servers predating that fix return 503 for the same condition; `neotoma mcp proxy` recognizes both.
76
+ As of neotoma#2100, an **authenticated** `POST /mcp` that carries an unknown/expired `mcp-session-id` **recovers in place**: the server mints a new in-memory transport, completes a server-side initialize handshake, serves the original JSON-RPC call, and returns a **new** `mcp-session-id`. Sessions are still **not** persisted to SQLite — a restart clears the map, and the next authenticated POST heals without forcing a client restart. `GET`/`DELETE` with an unknown session, and POST with no session header on a non-`initialize` body, still return 404/400.
77
+
78
+ As of neotoma#1923, remaining unknown/expired session errors return **404** (not 503), per the [MCP Streamable HTTP session management spec](https://modelcontextprotocol.io/specification/2025-11-25/basic/transports#session-management) — this lets spec-compliant clients auto-reinitialize instead of treating the server as unavailable. Servers predating that fix return 503 for the same condition; `neotoma mcp proxy` recognizes both.
77
79
 
78
80
  | Symptom | Typical cause | What to do |
79
81
  | ------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
80
82
  | **400** — no session header on a non-`initialize` POST | Proxy never stored an id (failed init, stripped response header) or client skipped `initialize` | Restart the MCP server in the IDE; confirm proxy stderr shows a successful downstream `initialize` and that your reverse proxy **forwards** `mcp-session-id` on responses and requests (custom headers are not hop-by-hop but some templates hide unknown headers). |
81
- | **404** (or, against an older server, **503**) — session header present but unknown on this instance | **Load-balanced replicas** without affinity: `initialize` hit instance A, `tools/call` hit B | Use **sticky sessions** for `POST /mcp` (same as [`/mcp/oauth`](../subsystems/auth.md) guidance), scale MCP to **one** API replica for `/mcp`, or terminate TLS on a single Node process. |
82
- | **404** (or **503**) — same, while using **`neotoma mcp proxy`** | Transient replica drift or API restart after the IDE finished `initialize` | The proxy **replays `initialize` to downstream once** (without emitting a second `initialize` on stdout), captures a fresh `mcp-session-id`, and **retries the failing RPC once**. If the second attempt still fails, fix infra (sticky sessions / single `/mcp` worker) or restart the MCP client. |
83
- | **404** / **503** / **400** after deploy or restart | In-memory map cleared | Restart the MCP client once so `initialize` runs again. |
83
+ | **404** (or, against an older server, **503**) — session header present but unknown on this instance | **Process restart** cleared in-memory sessions, or a stale client id after recover failed | Prefer a server with #2100 recover-in-place (authenticated POST heals and returns a new `mcp-session-id`). Otherwise restart the MCP client so `initialize` runs again. Multi-replica sticky sessions only apply if you actually run multiple `/mcp` workers. |
84
+ | **404** (or **503**) — same, while using **`neotoma mcp proxy`** | Transient API restart after the IDE finished `initialize` (or an older server without #2100) | The proxy **replays `initialize` to downstream once** (without emitting a second `initialize` on stdout), captures a fresh `mcp-session-id`, and **retries the failing RPC once**. If the second attempt still fails, fix infra or restart the MCP client. |
85
+ | **404** / **503** / **400** after deploy or restart | In-memory map cleared | With #2100, the next authenticated tool call should recover transparently. Without it, restart the MCP client once so `initialize` runs again. |
84
86
  | `handshake_unreachable` — the first `initialize` never reached a server (CONNECT_TIMEOUT, ECONNREFUSED, socket closed) | Backend down, restarting, or the wrong `--downstream-url` | The proxy already retried with backoff (neotoma#2321) and the backend stayed unreachable for the whole window. Check `/health` and the downstream URL, then restart the MCP client once the backend answers. |
85
87
  | `handshake_server_error` — the first `initialize` reached the server, which failed internally (5xx, or `-32603` through a 200) | Substrate crash surfacing through the handshake (e.g. neotoma#2316's "DB request aborted by caller") | Also already retried. The server is broken rather than refusing you: check server logs and `/health`, redeploy if needed, then restart the MCP client. |
86
88
  | `handshake_auth_rejected` — the first `initialize` was refused for authentication (401) | Invalid/expired bearer, encryption-mode token required, unauthenticated POST, or invalid `X-Connection-Id` | **Not retried, deliberately** — a replay cannot fix a credential. Fix the credential: re-run `neotoma auth mcp-token`, or remove `Authorization` / `X-Connection-Id` from `mcp.json` and reconnect. |
@@ -1,12 +1,52 @@
1
1
  # Neotoma Core Identity
2
2
 
3
3
  ## What Neotoma Is
4
- Neotoma is a **state layer** — a privacy-first, idempotent, cross-platform data substrate that stores, serves, and signals structured state for AI-native workflows.
5
- It is:
4
+
5
+ Neotoma is **the system of record for AI agents** — the designated place where a fact about agent-held state is settled, such that any disagreeing copy elsewhere is by definition stale.
6
+
7
+ The category is an **authority claim**, not a mechanism claim. A bank's ledger does not compete on "providing versioning"; it decides what your balance is, and every other copy reconciles to it. Neotoma's claim is the same in kind: when an agent, a tool, or a person disagrees with Neotoma about what is currently true, Neotoma is right and the other copy is out of date. Everything in [Core Responsibilities](#core-responsibilities) below is *how* that claim is honoured — versioned observations, deterministic reduction, field-level provenance, corrections-win. None of it is *what the claim is*. A system that merely stored versions would be a state layer; a system whose stored version is the one that counts is a system of record.
8
+
9
+ The authority is exercised through six powers, stated in the vision-phase table in [`README.md`](../../README.md) as **P2 — Authority over state**:
10
+
11
+ | Power | What it settles |
12
+ |---|---|
13
+ | **Domain ownership** | Which principal's word governs a given slice of state |
14
+ | **Correction rights** | Who may overrule a recorded fact, and whose overrule stands |
15
+ | **Supersession** | Which assertion replaced which, so "current" is a determinable fact rather than a guess |
16
+ | **Policy ownership** | Who sets the rules by which the previous three are decided |
17
+ | **Temporary grants** | Authority lent for a bounded scope and duration, then withdrawn |
18
+ | **Disclosure logs** | What was released to whom, so the exercise of authority is itself on the record |
19
+
20
+ Today the **mechanisms** exist (corrections always win, `SUPERSEDES` relationships, per-operation access controls) while the **semantics** — who may correct what, scoped by domain — are future work. That gap is the honest status of the category claim and is tracked as P2 in the README's vision-phase table; it is not a reason to state the category as something smaller.
21
+
22
+ ### What the authority covers, and what it does not
23
+
24
+ The claim is bounded, and the boundary is load-bearing:
25
+
26
+ - **In scope: agent-generated and agent-held state** — observations, inferences, entity resolutions, corrections, decisions, and the contextual records agents read and write across tools and sessions. For these, Neotoma is authoritative.
27
+ - **Out of scope: an adopter's operational business data.** An adopter's own Postgres remains the system of record for business data; Neotoma sits between their agents and that database rather than replacing it (see [`../icp/primary_icp.md`](../icp/primary_icp.md), "Integration surface framing"). The **Postgres-authoritative, Neotoma-as-rebuildable-derived-layer** posture is explicitly supported ([`substrate_and_applications.md`](substrate_and_applications.md)), and it does not weaken the claim — the domain over which Neotoma is authoritative is agent state, not every fact an adopter holds.
28
+
29
+ Reading the noun without that boundary produces a contradiction the foundation does not intend: that Neotoma both is and is not the system of record. It is, for agent state; it is not, for an adopter's business records.
30
+
31
+ ### Relation to the State Layer invariant
32
+
33
+ "State layer" is **retired as Neotoma's category noun** (decided 2026-08-21; see [`product_positioning.md`](product_positioning.md)). It remains correct and in active use as the name of an **architectural invariant** — the State Layer / Operational Layer boundary in [`layered_architecture.md`](layered_architecture.md), which holds that Neotoma stores and signals but never decides, infers, or acts.
34
+
35
+ The two are not in tension, and the distinction is worth stating precisely because it is easy to collapse:
36
+
37
+ - **As a category noun**, "state layer" describes a *mechanism* and invites the buyer to compare storage mechanisms. That is the comparison Neotoma loses by entering, because it concedes that the question is how state is stored rather than whose copy counts.
38
+ - **As an invariant**, "state layer" describes a *constraint on Neotoma's own behaviour*. That constraint is what makes the authority claim credible: an arbiter that also reasons and acts on its own behalf is not an arbiter. Neotoma can be authoritative about state precisely because it never decides what state means.
39
+
40
+ So: retire the noun from every definition that leads with it; keep the invariant wherever it names the boundary.
41
+
42
+ Subordinate descriptions, each of which explains how the authority is exercised rather than restating the category:
43
+
6
44
  - The **lowest-level, canonical source of truth** for any data that benefits from deterministic state evolution — personal records, professional context, project metadata, external facts, and third-party data the user chooses to track (see [`what_to_store.md`](what_to_store.md))
7
45
  - A **substrate** for AI-native computing
8
46
  - A **privacy-first structured memory system** that transforms fragmented data into structured, queryable truth via dual-path ingestion
9
- - The **state layer** beneath any operational layer — agents, pipelines, orchestration systems, and custom applications that read truth from Neotoma and write results back as observations
47
+ - The authoritative record **beneath any operational layer** — agents, pipelines, orchestration systems, and custom applications that read truth from Neotoma and write results back as observations, under the State Layer invariant described above
48
+
49
+ None of these is the category. Led with, each one invites a mechanism comparison — against a database, a cache, or a retrieval-memory vendor — on an axis Neotoma does not need to win.
10
50
  **Core Architectural Choices (Defensible Differentiators):**
11
51
  1. **Privacy-First:** User-controlled memory, no provider access, never used for training
12
52
  2. **Idempotent/Verifiable Domain (Creates Verifiable Domain for Personal Data):** Same operation → same final state, always (reproducible, explainable, no hallucinations, no duplicates). Hash-based entity IDs ensure deterministic, tamper-evident records.
@@ -25,7 +65,8 @@ These architectural choices are defensible because competitors (model providers,
25
65
  The commitments that protect these choices, and the moves that would cross them, are named in [`redlines.md`](redlines.md).
26
66
 
27
67
  ### Core Responsibilities
28
- Neotoma focuses exclusively on:
68
+
69
+ These are the mechanisms by which the authority claim above is honoured. They are not the identity: a competitor could implement every one of them and still not be the place where a fact is settled. Neotoma focuses exclusively on:
29
70
  1. **Ingestion** — Dual-path ingestion: user-provided file uploads (explicit, never automatic) and agent interactions where users provide contextual data via MCP `ingest` action, enabling incremental memory growth as agent usage scales
30
71
  2. **Normalization** — Format conversion, text extraction, OCR (file uploads only)
31
72
  3. **Extraction** — Deterministic field extraction via rule-based parsing (file uploads) or direct property assignment (agent interactions)
@@ -47,7 +47,7 @@ Characteristics:
47
47
  - Coordinating state across tools
48
48
  - Managing evolving context over time
49
49
  - Experiencing drift, conflicts, or unreproducible decisions
50
- - Comfortable with infrastructure-level abstractions
50
+ - Reasons comfortably about state, provenance, and correctness — without wanting to own the infrastructure that provides them (revised 2026-09-15 per the O1 durable-ICP decision; previously "comfortable with infrastructure-level abstractions", which named the early-adopter cohort rather than the buyer. See `../icp/primary_icp.md`.)
51
51
 
52
52
  Typical environments:
53
53
 
@@ -64,6 +64,7 @@ Not the target user:
64
64
  - Note-taking workflows
65
65
  - Productivity tooling
66
66
  - Personal knowledge management
67
+ - Builders who want to own the state layer themselves (an early-adopter cohort and a validator of the problem — not the buyer)
67
68
 
68
69
  Required signal:
69
70
 
@@ -176,6 +177,8 @@ Correct reaction:
176
177
 
177
178
  > This looks serious but maybe not for me.
178
179
 
180
+ **One reaction that is never correct: "this looks serious, but I can't get it installed."** Narrow ICP means narrow on *who has the problem*, never narrow on *who can survive the setup*. Depth belongs in the architecture and in what the product will tell you about its own state — not in the install path. Selecting for people who can fight through an install selects for the builder cohort the durable ICP explicitly excludes. (Added 2026-09-15; see `scope_decisions.md` SD-001 amendment.)
181
+
179
182
  Incorrect reaction:
180
183
 
181
184
  > This looks like another AI memory tool.
@@ -1,5 +1,15 @@
1
1
  # Neotoma as the State Layer
2
2
 
3
+ > **"State layer" here is an architectural invariant, not Neotoma's category
4
+ > noun.** As a category noun it was retired on 2026-08-21 in favour of *the
5
+ > system of record for AI agents*; as the name of the State Layer / Operational
6
+ > Layer boundary described below, it is correct and in active use. The two are
7
+ > complementary: the invariant — that Neotoma stores and signals but never
8
+ > decides, infers, or acts — is what makes the authority claim credible, since
9
+ > an arbiter that also acts on its own behalf is not an arbiter. See
10
+ > [`core_identity.md`](core_identity.md) § "Relation to the State Layer
11
+ > invariant".
12
+
3
13
  ## Core architectural model
4
14
 
5
15
  Neotoma is the **state layer**: a deterministic, event-sourced, reducer-driven world model. Anything sitting above Neotoma is an **operational layer** — agents, pipelines, orchestration systems, custom applications. The boundary is a single, simple invariant:
@@ -3,7 +3,7 @@
3
3
  **Overall Assessment: Complementary, Not Competitive**
4
4
  mmry.io and Neotoma operate in adjacent but distinct market segments with minimal direct competition:
5
5
  - **Different Data Domains:** mmry indexes web content (social media, videos, bookmarks); Neotoma structures personal data (PDFs, images, receipts, agent-created data)
6
- - **Different User Problems:** mmry solves "I can't find that thing I saw online"; Neotoma solves "AI agents have no memory across sessions"
6
+ - **Different User Problems:** mmry solves "I can't find that thing I saw online"; Neotoma solves "my agents disagree about what is true, and nothing settles it" — an authority problem, not a recall one (`never_say_the_agent_forgot`, 2026-08-21)
7
7
  - **Different Value Propositions:** mmry enables rediscovery of consumed web content; Neotoma enables structured memory for AI agents
8
8
  - **Different Integration Models:** mmry uses optional local inference (Ollama); Neotoma uses core MCP integration for agent memory
9
9
  **Competitive Risk: Low**
@@ -19,10 +19,10 @@ mmry.io and Neotoma operate in adjacent but distinct market segments with minima
19
19
  **Market Context:**
20
20
  Both products address fragmented personal data but through fundamentally different lenses:
21
21
  - mmry = horizontal search tool for web content consumption
22
- - Neotoma = use-case-specific memory substrate for AI-native workflows
22
+ - Neotoma = the system of record for AI agents — authority over what is currently true, not breadth of recall
23
23
  ## Executive Summary
24
24
  **mmry.io** is a privacy-first personal search engine that indexes content you've already seen online (Twitter, Reddit, YouTube, bookmarks) to enable search across your digital history.
25
- **Neotoma** is a deterministic state layer that transforms fragmented personal data into structured, queryable knowledge for AI agents via MCP.
25
+ **Neotoma** is the system of record for AI agents: the place where a fact about agent-held state is settled, built on deterministic, versioned writes and exposed to agents via MCP.
26
26
  Both products address fragmented personal data, but serve fundamentally different use cases: mmry focuses on **searching web content you've consumed**, while Neotoma focuses on **structuring documents and conversation context for AI agents**.
27
27
  ## Core Value Propositions
28
28
  ### mmry.io
@@ -132,7 +132,7 @@ Both products address fragmented personal data, but serve fundamentally differen
132
132
  | **Primary Use** | Rediscovering web content you've seen | Structuring documents for AI agent memory |
133
133
  | **Structure** | Indexed text/media | Schema-first structured records with entities and timelines |
134
134
  | **AI Integration** | Optional local inference (Ollama) | Core MCP integration for agent memory |
135
- | **Target Problem** | "I can't find that thing I saw online" | "AI agents have no memory across sessions" |
135
+ | **Target Problem** | "I can't find that thing I saw online" | "My agents disagree about what is true, and nothing settles it" |
136
136
  | **User Workflow** | Import web content → Search | Upload documents / Agent conversations → Structured memory → AI access |
137
137
  | **Coordination model** | None — search-only, polling | Event-driven signaling: agents subscribe to entity changes; substrate emits webhooks/SSE on writes (best-effort delivery; no other tool in homebrew or VC-funded competitive set offers this) |
138
138
  | **Architecture model** | Search engine — indexes existing web content for recall; no write surface, no state evolution, no agent integration beyond optional local inference | Data-plane substrate — stores, serves, and signals canonical state; action-plane tools (Gmail MCP, Slack, etc.) consume state from Neotoma rather than managing their own; scales at O(P+W) rather than O(P×W) per-pipeline-per-service integrations |
@@ -8,7 +8,7 @@ This document defines that problem. For the felt-experience mapping to ICP vocab
8
8
 
9
9
  The ICP wires together multi-agent stacks (Claude Code, Cursor, ChatGPT, custom scripts) across personal and professional domains — finances, contacts, content, health, code, BD pipelines. State does not survive the seams:
10
10
 
11
- - **Across sessions:** Agents lose what they knew yesterday. The user re-explains context every cold start.
11
+ - **Across sessions:** Nothing was committed to a record. A fact that lived only in one session's context was never written anywhere authoritative, so there is nothing to retrieve and nothing to correct — the user re-establishes it every cold start. (Stated this way deliberately: an agent "forgetting" is the recall framing, which any retrieval vendor answers with better recall. See `never_say_the_agent_forgot`, decided 2026-08-21.)
12
12
  - **Across tools:** A correction made in Claude is invisible in Cursor; a decision recorded in ChatGPT is absent when the next agent runs.
13
13
  - **Across agents in a pipeline:** Agent A's output feeds Agent B, but there is no shared, verifiable substrate guaranteeing what Agent B reads is what Agent A meant to write.
14
14
  - **Across time:** Last-write-wins silently overwrites earlier observations; contradictions go undetected; supersession (a later fact should replace an earlier one) fails without trace.
@@ -17,6 +17,8 @@ Provider memory (ChatGPT Memory, Claude Memory, Gemini Personal Context) is conv
17
17
 
18
18
  **No system holds canonical, deterministic, cross-tool state that agents can write to and read from with integrity guarantees.**
19
19
 
20
+ Stated as the category problem: **there is no designated place where a fact about agent state is settled.** Every failure above is a consequence of that absence rather than a separate defect. When no copy is authoritative, "which one is current?" has no answer in principle — not merely an answer that is expensive to compute. Better recall cannot supply one, because recall returns what was found, not what counts. That is why the answer is an authority claim (see [`core_identity.md`](core_identity.md)) rather than a better memory mechanism.
21
+
20
22
  ## 6.2 The Chronic Tax: Re-Prompting and Manual Sync
21
23
 
22
24
  Day to day, the ICP pays a diffuse tax in attention and repetition:
@@ -9,20 +9,24 @@ This section maps Neotoma to April Dunford’s five core positioning choices plu
9
9
  | **Competitive alternatives** | Homebrew SQLite/Postgres, git + markdown stacks, flat JSON/YAML, one-off agent memory implementations, and VC-funded retrieval memory (Mem0, Zep, LangChain-style patterns). Provider-native chat memory is a parallel alternative for conversation-only use cases. See §7.4. |
10
10
  | **Unique attributes** | Privacy-first user-controlled architecture; deterministic, schema-first extraction with hash-based IDs and reproducible state; cross-tool MCP access; versioned observations with field-level provenance and immutability guarantees. See §7.2. |
11
11
  | **Value themes** | Two primary themes: (1) **Tax removal** — stop being the human sync layer; subsumes continuity (one memory across tools) and sovereignty (your data, your control). (2) **State integrity** — prove your agent isn't operating on bad data; subsumes accountability (reconstruct what an agent knew at decision time). All copy should clearly serve one of these two themes. Pain-forward phrasing in §7.3. |
12
- | **Best-fit customers** | One archetype — the **personal agentic OS builder/operator** — in three operational modes: debugging infrastructure, building pipelines, operating across tools. Not three separate personas. See `docs/icp/primary_icp.md`. Evaluator context in §7.5 (agents with tool use “get it” faster than search-only evals). |
13
- | **Market category** | Primary external frame: **cross-tool memory for AI agents** (ICP vocabulary). Architecture frame ("deterministic state layer," "DPME") used internally and after the fold. Previously: Named category hypothesis: **Deterministic Personal Memory Engine (DPME)** (§7.2) — a *new category* play with a higher education tax; use when the audience already grasps the stack diagram. |
12
+ | **Best-fit customers** | One archetype — the **personal agentic OS builder/operator** — in three operational modes: debugging infrastructure, building pipelines, operating across tools. Not three separate personas. **"Power user" is retired** as a buyer term (it names both the core ICP and an explicit non-target in live docs) and **"indie hacker" is a narrower subsegment, not a synonym**; see [`../icp/README.md`](../icp/README.md) for the canonical statement, the synonym mapping, and the open ICP questions. See `docs/icp/primary_icp.md`. Evaluator context in §7.5 (agents with tool use “get it” faster than search-only evals). |
13
+ | **Market category** | **The system of record for AI agents** — single category noun, with the definite article, on every surface (decided 2026-08-21, superseding "shared governed state layer" and retiring the other ten nouns the positioning audit counted: state layer, agent memory, deterministic memory, memory system, memory graph, memory infrastructure, truth layer, truth engine, substrate, Rosetta Stone, DPME). The category is an **authority claim**, not a mechanism claim — see [`core_identity.md`](core_identity.md). Rationale: legible to technical buyers at near-zero education tax, and it makes **correctness rather than recall** the category criterion, which is the criterion Neotoma can win on. "Cross-tool memory for AI agents" is retired as a category frame: it names the retrieval category and invites comparison against retrieval-memory vendors on recall. |
14
14
  | **Relevant trends** | Proliferation of LLM apps that need private data + feedback loops; localhost / private-environment agents; agent evaluation and AEO as a discovery path (§7.1, §7.5). |
15
- | **Positioning statement (internal)** | For people building an operating system for their AI agents, Neotoma is the deterministic, privacy-first memory layer that gives cross-tool agents shared, verifiable state—not another notes app or provider-locked chat memory. |
16
- | **Extended positioning (coordination-aware)** | For operators running distributed agent fleets, Neotoma is the state layer that gives agents shared, verifiable state and real-time awareness of state changes — enabling agent-to-agent coordination without centralized orchestration. (Use after the user has adopted Neotoma for memory; coordination is a power-user expansion of state integrity, not a new value theme.) |
15
+ | **Positioning statement (internal)** | For people building an operating system for their AI agents, Neotoma is the system of record for AI agents — the deterministic, privacy-first place where a fact about agent-held state is settled, giving cross-tool agents shared, verifiable state — not another notes app or provider-locked chat memory. (Was "the deterministic, privacy-first memory layer"; "memory layer" names the buyer's job to be done, never Neotoma's category — see [`docs/icp/README.md`](../icp/README.md) §1.) |
16
+ | **Extended positioning (coordination-aware)** | For operators running distributed agent fleets, Neotoma is the system of record that gives agents shared, verifiable state and real-time awareness of state changes — enabling agent-to-agent coordination without centralized orchestration. (Use after the user has adopted Neotoma for memory; coordination is an advanced-adoption expansion of state integrity, not a new value theme.) |
17
17
  | **Key proof points** | Field evaluator quotes ("State integrity, not retrieval quality — that's the gap nobody else is filling"); open docs and repo checks on append-only/versioned models; memory guarantees table; MCP integration surface. See §7.2 and §7.5. |
18
- | **Primary message (external)** | "Your agents forget. Neotoma makes them remember." Lead with pain using ICP vocabulary; architecture terms only after the fold. Aligned with §7.3 (“your agents forget what they knew yesterday,” “one memory across AI tools,” “CI/CD for agent state”) before layering architecture terms. |
18
+ | **Primary message (external)** | Lead with the **integrity** failure, never the recall failure. Copy must never say an agent *forgot* — forgetting is the recall framing and any retrieval vendor answers it with better recall (decided 2026-08-21, `never_say_the_agent_forgot`). The accurate framing is that nothing was committed to a record: a fact held in context was never written anywhere authoritative, so there is nothing to forget and nothing to correct. Three non-overlapping scenarios: WRITE ("neither the fact nor the fix stuck"), DIVERGENCE ("your agents disagree silently"), RECONSTRUCTION ("you cannot reconstruct why"). **Retired:** "Your agents forget. Neotoma makes them remember." and "your agents forget what they knew yesterday" — both concede the recall axis. Every scenario must pass the competitor test: if mem0, Zep, or any retrieval vendor could plausibly claim to solve it, it frames their category and must be rewritten. |
19
19
  | **Sales narrative** | Problem: fragmented tool-specific memory and non-replayable state → old way: files, CRUD DBs, or retrieval-only memory → new way: structured, versioned substrate with provenance → proof: guarantees, cross-tool access, deterministic behavior. |
20
20
  | **Content strategy** | Comparison and guarantee pages for agent evaluation; stack-level narrative (substrate beneath LLM apps); case-style stories for homebrew migration; avoid leading cold audiences with “deterministic” before felt pain (§7.3). |
21
21
 
22
22
  **Positioning quality (0–10 rubric from the skill): ~8.** Differentiation, alternatives, and value themes are strong. Homepage now leads with ICP pain vocabulary and tax-removal framing. Remaining gaps: category education for DPME with new audiences; expanding proof points beyond single evaluator quote.
23
23
 
24
24
  ## 7.1 Positioning
25
- Neotoma is **not a PKM or app**. Neotoma is:
25
+
26
+ Neotoma is **the system of record for AI agents**, and **not a PKM or app**.
27
+
28
+ The descriptions below are *supporting* frames. None of them may lead a definition or stand in as the category noun — each one was counted in the 2026-08-21 positioning audit as a competing noun, and all were retired in favour of the single one above:
29
+
26
30
  - A **substrate** for AI tools
27
31
  - A **structured memory system** for personal/professional data (documents + agent-created data)
28
32
  - A **data foundation** beneath all AI interactions
@@ -31,12 +35,12 @@ Neotoma is **not a PKM or app**. Neotoma is:
31
35
 
32
36
  Neotoma serves both human-in-the-loop workflows (people using AI tools) and agentic systems that need a deterministic, queryable memory substrate (agent frameworks, orchestration pipelines, observability stacks).
33
37
 
34
- **Marketing positioning:**
35
- - "Structured personal data memory for AI agents"
36
- - "Memory infrastructure for agentic systems"
37
- - "Cross-platform memory that works with all your AI tools"
38
- - "The truth engine behind your AI tools"
39
- - "The foundation for agent-native personal computing"
38
+ **Marketing positioning** — *historical; retained for provenance, not for use.* Every line below leads with memory or recall and therefore frames the retrieval category. Replace with problem-led copy per the Primary message row in §7.0:
39
+ - ~~"Structured personal data memory for AI agents"~~
40
+ - ~~"Memory infrastructure for agentic systems"~~
41
+ - ~~"Cross-platform memory that works with all your AI tools"~~
42
+ - ~~"The truth engine behind your AI tools"~~
43
+ - ~~"The foundation for agent-native personal computing"~~
40
44
  - "The private data substrate that LLM app layers depend on for context engineering"
41
45
 
42
46
  **Substrate Positioning in LLM Stack:**
@@ -176,7 +180,7 @@ Retrieval-augmented memory: vector embeddings, semantic search, probabilistic ma
176
180
 
177
181
  Across the entire homebrew and VC-funded competitive set above, none provide event-driven coordination between agents. Every alternative requires consumers to poll: re-querying on intervals or at session start to discover state changes. SQLite has no notification mechanism. Git+markdown has no change feed beyond commit polling. Flat JSON files have no way to signal a writer. Custom-built memory systems virtually never include subscription/webhook infrastructure (the build-in-house explosion in §7.4 confirms this — each developer reinvents memory primitives but stops short of event delivery). VC-funded memory systems optimize retrieval, not coordination.
178
182
 
179
- Neotoma's substrate-level event emission (`philosophy.md` §5.9) closes this gap: agents subscribe to entity changes and receive webhook/SSE delivery, converting polling-based coordination into event-driven awareness. This is a power-user expansion of state integrity for operators running distributed agent fleets — see §7.6 messaging principles for how to lead with state integrity and layer coordination after adoption.
183
+ Neotoma's substrate-level event emission (`philosophy.md` §5.9) closes this gap: agents subscribe to entity changes and receive webhook/SSE delivery, converting polling-based coordination into event-driven awareness. This is an advanced-adoption expansion of state integrity for operators running distributed agent fleets — see §7.6 messaging principles for how to lead with state integrity and layer coordination after adoption.
180
184
 
181
185
  ### Positioning against adjacent categories
182
186
 
@@ -351,9 +355,9 @@ Consolidated inventory of short-form phrases. Use for hero copy, subheadlines, C
351
355
 
352
356
  | Phrase | Origin | Best slot |
353
357
  |--------|--------|-----------|
354
- | "The state layer for AI agents." | Footer tagline | Tagline, meta descriptions |
355
- | "System of record for AI agents." | Synthesis from feedback | Category creation, blog, HN |
356
- | "Truth Layer." | Evaluator | Technical shorthand, architecture discussions |
358
+ | **"The system of record for AI agents."** | **DECIDED 2026-08-21 — the category noun** | **Every surface: tagline, meta descriptions, nav, footer, category creation, blog, HN. Always with the definite article.** |
359
+ | ~~"The state layer for AI agents."~~ | Former footer tagline | **RETIRED** — names the mechanism, not the authority |
360
+ | ~~"Truth Layer."~~ | Evaluator | **RETIRED** as a noun; the underlying idea survives in the category above |
357
361
  | "git for what your agents know." | Hero subcopy | Analogy for developers, social |
358
362
  | "Those tools store files. Neotoma understands files." | Positioning doc | Competitive contrast (PKM/notes tools) |
359
363
  | "Other memory solutions give your agents a notepad. Neotoma gives them a ledger." | Proposed | Competitive contrast (Mem0/Zep), social, blog |
@@ -362,7 +366,7 @@ Consolidated inventory of short-form phrases. Use for hero copy, subheadlines, C
362
366
  | "Your agents don't have a memory problem. They have a state problem." | Proposed | Reframing opener, blog, HN comments |
363
367
  | "The nervous system for your agent fleet." | Simon feedback analysis | Power users running distributed agents; after the fold |
364
368
  | "Your agents don't just remember. They sense." | Proposed | Upgrade from passive memory to active coordination; after the fold |
365
- | "A state layer that signals, not just stores." | Proposed | Technical positioning, architecture discussions; after the fold |
369
+ | "A system of record that signals, not just stores." | Proposed (reworded from "state layer", 2026-09-15) | Technical positioning, architecture discussions; after the fold |
366
370
  | "Your strategy is state. Neotoma stores it." | Proposed (state-layer reframe 2026-05-08) | Positioning vs. ad-hoc plan/decision storage; technical audiences who confuse strategy with state-management |
367
371
 
368
372
  **Note on the "nervous system" metaphor:** It belongs only on marketing/positioning surfaces (this doc, blog content, README hero copy, social). Foundation and architecture docs (`core_identity.md`, `philosophy.md`, `layered_architecture.md`, `architecture.md`, `product_principles.md`, `composability_analysis.md`, `data_models.md`) use precise architectural language — "event emission," "subscription," "webhook delivery," "fire-and-forget signaling" — not biological analogies. This keeps the substrate/marketing boundary defensible and pre-empts metaphor-induced scope creep (learning, adaptation, autonomy implications).