nella_add_assumption

Record an assumption about the codebase so Nella can invalidate it automatically when related files change.

Parameters

Parameter	Type	Required	Description
`type`	`string`	Yes	One of `schema`, `interface`, `dependency`, `behavior`, `config`, `structure`, `other`.
`description`	`string`	Yes	Human-readable description of the assumption.
`relatedFiles`	`string[]`	No	Related files or glob patterns. Matching is handled by the core assumption tracker with `minimatch`.
`confidence`	`number`	No	Confidence from `0` to `1`. Default: `0.8`.

Example

nella_add_assumption({
  type: "interface",
  description: "User model has id, name, and email string fields",
  relatedFiles: ["src/types.ts", "src/models/*.ts"],
  confidence: 0.9,
});

Response Shape

## Assumption Recorded

✅ Successfully recorded assumption:

- **ID**: asmp_xyz789
- **Type**: interface
- **Description**: User model has id, name, and email string fields
- **Related files**: src/types.ts, src/models/*.ts
- **Confidence**: 90%

Notes

Paths are normalized to forward-slash form before storage.
The assumption does not need relatedFiles, but providing them is what enables automatic invalidation on file changes.

See Context Tools.