66 lines (58 loc) · 1.9 KB

Tool Contracts

Tool: get_app_state

Intent: Return current app state.
Job-to-be-done: See current local state.
Know/Do/Show value: Know and Show.
User-visible result: Widget shows current items.
Input schema: Empty object.
Output schema: items array.
Read-only: Yes.
Open-world: No.
Destructive: No.
UI resource: ui://widget/tiny-roll.html.
UI visibility: model and app.
State read: local app state.
State written: none.
Expected errors: server unavailable.
Tests required: smoke and quality gate.
Approval required: No.

Tool: add_item

Intent: Add one local item.
Job-to-be-done: Add one local item.
Know/Do/Show value: Do and Show.
User-visible result: Widget shows the new item.
Input schema: title string from 1 to 120 characters.
Output schema: items array.
Read-only: No.
Open-world: No.
Destructive: No.
UI resource: ui://widget/tiny-roll.html.
UI visibility: model and app.
State read: local app state.
State written: local app state.
Expected errors: empty title.
Tests required: unit test for valid and invalid input.
Approval required: No.

Tool: clear_items

Intent: Clear local sample items.
Job-to-be-done: Clear local sample items.
Know/Do/Show value: Do and Show.
User-visible result: Widget shows empty state.
Input schema: Empty object.
Output schema: items array.
Read-only: No.
Open-world: No.
Destructive: Yes, for local sample state only.
UI resource: ui://widget/tiny-roll.html.
UI visibility: model and app.
State read: local app state.
State written: local app state.
Expected errors: server unavailable.
Tests required: smoke and quality gate.
Approval required: No for local sample state. Yes before real data deletion.

Contract Status

Tool	Complete?	Verified?
get_app_state	Yes	npm run verify
add_item	Yes	npm run verify
clear_items	Yes	npm run verify