Harness spec 1.2.0: the library's tools fit both projects; the CLI implements it

The CLI's facts in memory, notes_search, note_manage, skills_list,
skill_view and skill_manage are `variables` now, filled with the CLI's own
values (src/tool/spec-vars.ts): every description and parameter list the CLI
sends is word for word what 1.1.0 said, except note and document ids, which
are strings on both sides (a number is still taken). Descriptions are
filled by the prompt texts' rules, parameter descriptions too. `narrow`
says what a project offers of a shared tool's parameters. Memory's changes
are one pure function (applyOps). Conformance: fill, narrow, memory.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
HomerandClaude Opus 5.5 committed 2026-10-20 11:45:14 +00:00
1 parent b7fcb46446
commit 539896494f
23 files changed
+1398 -88

No files matched your search

+88
View File
@@ -0,0 +1,88 @@
{
"about": "A tool description's or a prompt text's `{{variables}}` filled in (`vars`): a value replaces its variable where it stands; a line that is nothing but a bullet and a variable (`- {{name}}`) disappears when the value is empty or blank; a variable with no value at all is an error naming every one missing (`missing`, sorted). Applied to a tool's description and to every `description` inside its parameters. LLeMbas: services/harness_spec.py fill; CLI: prompt/fill.ts fillPrompt.",
"cases": [
{
"text": "Read a page{{files}}",
"vars": {
"files": "."
},
"expect": {
"text": "Read a page."
}
},
{
"text": "Kept across sessions{{kept}}.",
"vars": {
"kept": ""
},
"expect": {
"text": "Kept across sessions."
}
},
{
"text": "- create: one.\n- {{files}}\n- delete: two.",
"vars": {
"files": ""
},
"expect": {
"text": "- create: one.\n- delete: two."
}
},
{
"text": "- create: one.\n- {{files}}\n- delete: two.",
"vars": {
"files": " "
},
"expect": {
"text": "- create: one.\n- delete: two."
}
},
{
"text": "- create: one.\n * {{files}}\n- delete: two.",
"vars": {
"files": "write_file."
},
"expect": {
"text": "- create: one.\n * write_file.\n- delete: two."
}
},
{
"text": "A {{a}} and a {{b}} and {{a}} again",
"vars": {
"a": "x",
"b": "y"
},
"expect": {
"text": "A x and a y and x again"
}
},
{
"text": "Only {{a}} and {{c}} and {{b}}",
"vars": {
"a": "x"
},
"expect": {
"missing": [
"b",
"c"
]
}
},
{
"text": "No variables at all.",
"vars": {},
"expect": {
"text": "No variables at all."
}
},
{
"text": "- not only {{a}} on this line",
"vars": {
"a": ""
},
"expect": {
"text": "- not only on this line"
}
}
]
}
+499
View File
@@ -0,0 +1,499 @@
{
"about": "The memory tool's changes to one target's entries (`entries`, in order) with a size limit (`limit`, characters of the entries joined by \"\\n§\\n\"): one change or a list (`ops`, each `action` add/replace/remove with `content` — or `new_text` — and `old_text`), applied together or not at all; the limit is checked on the result only, and a change that does not grow the entries always goes through. An entry is one fact, at most 400 characters; `old_text` finds an exact entry first, else the one entry containing it. `ok`, the entries after, `message`, `usage`, and `shown` — whether the entries as they were are shown with a refusal, so the model can consolidate. LLeMbas: services/library/memories.py apply_ops; CLI: memory/store.ts applyOps.",
"cases": [
{
"target": "user",
"entries": [],
"limit": 1375,
"ops": [
{
"action": "add",
"content": "Prefers tea."
}
],
"expect": {
"ok": true,
"entries": [
"Prefers tea."
],
"message": "Entry added.",
"usage": "0% — 12/1,375 chars",
"shown": false
}
},
{
"target": "user",
"entries": [
"Prefers tea.",
"Works in Rust and Python.",
"Lives in Trenčín."
],
"limit": 1375,
"ops": [
{
"action": "add",
"content": " Prefers tea. "
}
],
"expect": {
"ok": true,
"entries": [
"Prefers tea.",
"Works in Rust and Python.",
"Lives in Trenčín."
],
"message": "That entry already exists; nothing added.",
"usage": "4% — 60/1,375 chars",
"shown": false
}
},
{
"target": "memory",
"entries": [
"Prefers tea.",
"Works in Rust and Python.",
"Lives in Trenčín."
],
"limit": 2200,
"ops": [
{
"action": "add",
"new_text": "Uses Debian."
}
],
"expect": {
"ok": true,
"entries": [
"Prefers tea.",
"Works in Rust and Python.",
"Lives in Trenčín.",
"Uses Debian."
],
"message": "Entry added.",
"usage": "3% — 75/2,200 chars",
"shown": false
}
},
{
"target": "user",
"entries": [
"Prefers tea.",
"Works in Rust and Python.",
"Lives in Trenčín."
],
"limit": 1375,
"ops": [
{
"action": "add",
"content": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
],
"expect": {
"ok": false,
"entries": [
"Prefers tea.",
"Works in Rust and Python.",
"Lives in Trenčín."
],
"message": "an entry is one fact, under 400 characters; this one is 401. Split it into facts, or keep only what will still matter.",
"usage": "4% — 60/1,375 chars",
"shown": false
}
},
{
"target": "user",
"entries": [
"Prefers tea.",
"Works in Rust and Python.",
"Lives in Trenčín."
],
"limit": 1375,
"ops": [
{
"action": "add",
"content": "one\n§\ntwo"
}
],
"expect": {
"ok": false,
"entries": [
"Prefers tea.",
"Works in Rust and Python.",
"Lives in Trenčín."
],
"message": "a line holding only \"§\" separates entries; it cannot be inside one.",
"usage": "4% — 60/1,375 chars",
"shown": false
}
},
{
"target": "user",
"entries": [
"Prefers tea.",
"Works in Rust and Python.",
"Lives in Trenčín."
],
"limit": 1375,
"ops": [
{
"action": "add",
"content": " "
}
],
"expect": {
"ok": false,
"entries": [
"Prefers tea.",
"Works in Rust and Python.",
"Lives in Trenčín."
],
"message": "add needs content.",
"usage": "4% — 60/1,375 chars",
"shown": false
}
},
{
"target": "user",
"entries": [
"Prefers tea.",
"Works in Rust and Python.",
"Lives in Trenčín."
],
"limit": 1375,
"ops": [
{
"action": "replace",
"old_text": "Rust",
"content": "Works in Rust, Python and Go."
}
],
"expect": {
"ok": true,
"entries": [
"Prefers tea.",
"Works in Rust, Python and Go.",
"Lives in Trenčín."
],
"message": "Entry replaced.",
"usage": "4% — 64/1,375 chars",
"shown": false
}
},
{
"target": "user",
"entries": [
"Prefers tea.",
"Works in Rust and Python.",
"Lives in Trenčín."
],
"limit": 1375,
"ops": [
{
"action": "replace",
"old_text": "in",
"content": "x"
}
],
"expect": {
"ok": false,
"entries": [
"Prefers tea.",
"Works in Rust and Python.",
"Lives in Trenčín."
],
"message": "\"in\" matches more than one entry — use a longer, unique part.",
"usage": "4% — 60/1,375 chars",
"shown": true
}
},
{
"target": "user",
"entries": [
"Prefers tea.",
"Works in Rust and Python.",
"Lives in Trenčín."
],
"limit": 1375,
"ops": [
{
"action": "remove",
"old_text": "coffee"
}
],
"expect": {
"ok": false,
"entries": [
"Prefers tea.",
"Works in Rust and Python.",
"Lives in Trenčín."
],
"message": "no entry contains \"coffee\".",
"usage": "4% — 60/1,375 chars",
"shown": true
}
},
{
"target": "user",
"entries": [
"Prefers tea.",
"Works in Rust and Python.",
"Lives in Trenčín."
],
"limit": 1375,
"ops": [
{
"action": "remove"
}
],
"expect": {
"ok": false,
"entries": [
"Prefers tea.",
"Works in Rust and Python.",
"Lives in Trenčín."
],
"message": "remove needs old_text: a short unique part of the entry to remove.",
"usage": "4% — 60/1,375 chars",
"shown": true
}
},
{
"target": "user",
"entries": [
"Prefers tea.",
"Works in Rust and Python.",
"Lives in Trenčín."
],
"limit": 1375,
"ops": [
{
"action": "replace",
"old_text": "tea",
"content": ""
}
],
"expect": {
"ok": false,
"entries": [
"Prefers tea.",
"Works in Rust and Python.",
"Lives in Trenčín."
],
"message": "replace needs content — the complete new entry.",
"usage": "4% — 60/1,375 chars",
"shown": false
}
},
{
"target": "user",
"entries": [
"coffee",
"Drinks coffee black."
],
"limit": 1375,
"ops": [
{
"action": "remove",
"old_text": "coffee"
}
],
"expect": {
"ok": true,
"entries": [
"Drinks coffee black."
],
"message": "Entry removed.",
"usage": "1% — 20/1,375 chars",
"shown": false
}
},
{
"target": "user",
"entries": [
"Prefers tea.",
"Works in Rust and Python.",
"Lives in Trenčín."
],
"limit": 60,
"ops": [
{
"action": "add",
"content": "Has two cats."
}
],
"expect": {
"ok": false,
"entries": [
"Prefers tea.",
"Works in Rust and Python.",
"Lives in Trenčín."
],
"message": "The user profile would be 76/60 chars. Consolidate in the same call: replace overlapping entries with one shorter entry, or remove stale ones, together with the add.",
"usage": "100% — 60/60 chars",
"shown": true
}
},
{
"target": "memory",
"entries": [
"Prefers tea.",
"Works in Rust and Python.",
"Lives in Trenčín."
],
"limit": 60,
"ops": [
{
"action": "add",
"content": "Has two cats."
}
],
"expect": {
"ok": false,
"entries": [
"Prefers tea.",
"Works in Rust and Python.",
"Lives in Trenčín."
],
"message": "Memory would be 76/60 chars. Consolidate in the same call: replace overlapping entries with one shorter entry, or remove stale ones, together with the add.",
"usage": "100% — 60/60 chars",
"shown": true
}
},
{
"target": "user",
"entries": [
"Prefers tea.",
"Works in Rust and Python.",
"Lives in Trenčín."
],
"limit": 60,
"ops": [
{
"action": "remove",
"old_text": "Rust"
},
{
"action": "add",
"content": "Has two cats."
}
],
"expect": {
"ok": true,
"entries": [
"Prefers tea.",
"Lives in Trenčín.",
"Has two cats."
],
"message": "Applied 2 operations.",
"usage": "80% — 48/60 chars",
"shown": false
}
},
{
"target": "user",
"entries": [
"Prefers tea.",
"Works in Rust and Python.",
"Lives in Trenčín."
],
"limit": 30,
"ops": [
{
"action": "remove",
"old_text": "tea"
}
],
"expect": {
"ok": true,
"entries": [
"Works in Rust and Python.",
"Lives in Trenčín."
],
"message": "Entry removed.",
"usage": "100% — 45/30 chars",
"shown": false
}
},
{
"target": "user",
"entries": [
"Prefers tea.",
"Works in Rust and Python.",
"Lives in Trenčín."
],
"limit": 1375,
"ops": [
{
"action": "add",
"content": "Has two cats."
},
{
"action": "remove",
"old_text": "coffee"
}
],
"expect": {
"ok": false,
"entries": [
"Prefers tea.",
"Works in Rust and Python.",
"Lives in Trenčín."
],
"message": "operation 2: no entry contains \"coffee\". Nothing was changed (the operations go together or not at all).",
"usage": "4% — 60/1,375 chars",
"shown": true
}
},
{
"target": "user",
"entries": [
"Prefers tea.",
"Works in Rust and Python.",
"Lives in Trenčín."
],
"limit": 1375,
"ops": [],
"expect": {
"ok": false,
"entries": [
"Prefers tea.",
"Works in Rust and Python.",
"Lives in Trenčín."
],
"message": "Nothing to do: give action (with content and/or old_text), or operations.",
"usage": "4% — 60/1,375 chars",
"shown": false
}
},
{
"target": "user",
"entries": [
"Prefers tea.",
"Works in Rust and Python.",
"Lives in Trenčín."
],
"limit": 1375,
"ops": [
{
"action": "remove",
"old_text": "Prefers tea."
},
{
"action": "add",
"content": "Prefers green tea."
}
],
"expect": {
"ok": true,
"entries": [
"Works in Rust and Python.",
"Lives in Trenčín.",
"Prefers green tea."
],
"message": "Applied 2 operations.",
"usage": "4% — 66/1,375 chars",
"shown": false
}
}
]
}
+455
View File
@@ -0,0 +1,455 @@
{
"about": "A shared tool's parameters as one project offers them (`narrow`, the tool's `narrow.<project>`): a project may offer a subset and nothing else — `drop` removes optional properties, `enum` keeps some of a property's values. A path names a property; `a.b` is b inside a, `a[].b` is b inside a's array items. Never adds, never retypes. Refused, with `error`: dropping a required property (`required`), a path that is not there (`unknown`), values that are not all among the property's own (`not_subset`). LLeMbas: services/harness_spec.py narrow; CLI: harness.ts narrowParameters.",
"cases": [
{
"parameters": {
"type": "object",
"properties": {
"action": {
"type": "string",
"enum": [
"create",
"edit",
"delete"
]
},
"id": {
"type": "string"
},
"scope": {
"type": "string",
"enum": [
"project",
"global"
]
}
},
"required": [
"action"
]
},
"narrow": {},
"expect": {
"parameters": {
"type": "object",
"properties": {
"action": {
"type": "string",
"enum": [
"create",
"edit",
"delete"
]
},
"id": {
"type": "string"
},
"scope": {
"type": "string",
"enum": [
"project",
"global"
]
}
},
"required": [
"action"
]
}
}
},
{
"parameters": {
"type": "object",
"properties": {
"action": {
"type": "string",
"enum": [
"create",
"edit",
"delete"
]
},
"id": {
"type": "string"
},
"scope": {
"type": "string",
"enum": [
"project",
"global"
]
}
},
"required": [
"action"
]
},
"narrow": {
"drop": [
"scope"
]
},
"expect": {
"parameters": {
"type": "object",
"properties": {
"action": {
"type": "string",
"enum": [
"create",
"edit",
"delete"
]
},
"id": {
"type": "string"
}
},
"required": [
"action"
]
}
}
},
{
"parameters": {
"type": "object",
"properties": {
"action": {
"type": "string",
"enum": [
"create",
"edit",
"delete"
]
},
"id": {
"type": "string"
},
"scope": {
"type": "string",
"enum": [
"project",
"global"
]
}
},
"required": [
"action"
]
},
"narrow": {
"enum": {
"action": [
"create",
"delete"
]
}
},
"expect": {
"parameters": {
"type": "object",
"properties": {
"action": {
"type": "string",
"enum": [
"create",
"delete"
]
},
"id": {
"type": "string"
},
"scope": {
"type": "string",
"enum": [
"project",
"global"
]
}
},
"required": [
"action"
]
}
}
},
{
"parameters": {
"type": "object",
"properties": {
"operations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"action": {
"type": "string",
"enum": [
"create",
"patch",
"write_file",
"delete"
]
},
"name": {
"type": "string"
},
"file_path": {
"type": "string"
}
},
"required": [
"action",
"name"
]
}
}
},
"required": [
"operations"
]
},
"narrow": {
"drop": [
"operations[].file_path"
],
"enum": {
"operations[].action": [
"create",
"patch",
"delete"
]
}
},
"expect": {
"parameters": {
"type": "object",
"properties": {
"operations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"action": {
"type": "string",
"enum": [
"create",
"patch",
"delete"
]
},
"name": {
"type": "string"
}
},
"required": [
"action",
"name"
]
}
}
},
"required": [
"operations"
]
}
}
},
{
"parameters": {
"type": "object",
"properties": {
"action": {
"type": "string",
"enum": [
"create",
"edit",
"delete"
]
},
"id": {
"type": "string"
},
"scope": {
"type": "string",
"enum": [
"project",
"global"
]
}
},
"required": [
"action"
]
},
"narrow": {
"drop": [
"action"
]
},
"expect": {
"error": "required"
}
},
{
"parameters": {
"type": "object",
"properties": {
"action": {
"type": "string",
"enum": [
"create",
"edit",
"delete"
]
},
"id": {
"type": "string"
},
"scope": {
"type": "string",
"enum": [
"project",
"global"
]
}
},
"required": [
"action"
]
},
"narrow": {
"drop": [
"nope"
]
},
"expect": {
"error": "unknown"
}
},
{
"parameters": {
"type": "object",
"properties": {
"operations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"action": {
"type": "string",
"enum": [
"create",
"patch",
"write_file",
"delete"
]
},
"name": {
"type": "string"
},
"file_path": {
"type": "string"
}
},
"required": [
"action",
"name"
]
}
}
},
"required": [
"operations"
]
},
"narrow": {
"drop": [
"operations[].nope"
]
},
"expect": {
"error": "unknown"
}
},
{
"parameters": {
"type": "object",
"properties": {
"action": {
"type": "string",
"enum": [
"create",
"edit",
"delete"
]
},
"id": {
"type": "string"
},
"scope": {
"type": "string",
"enum": [
"project",
"global"
]
}
},
"required": [
"action"
]
},
"narrow": {
"enum": {
"action": [
"create",
"rename"
]
}
},
"expect": {
"error": "not_subset"
}
},
{
"parameters": {
"type": "object",
"properties": {
"action": {
"type": "string",
"enum": [
"create",
"edit",
"delete"
]
},
"id": {
"type": "string"
},
"scope": {
"type": "string",
"enum": [
"project",
"global"
]
}
},
"required": [
"action"
]
},
"narrow": {
"enum": {
"id": [
"a"
]
}
},
"expect": {
"error": "not_subset"
}
}
]
}