Skip to content

Commit 9a449ed

Browse files
committed
docs(skills): objectstack-api scopes the recycle bin to business objects and updates eval case 5
The DELETE route comment names the condition (business-object rows), the pitfall says nothing lists or restores the bin over the API yet (sys_recycle_bin is apiEnabled: false), and eval case 5 expects the recycle-bin teaching instead of a hard delete with trackHistory or a lifecycle archive. Co-Authored-By: Claude <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01J8VVAnsTJVz6nCb7n8NUJs
1 parent 28046a1 commit 9a449ed

3 files changed

Lines changed: 8 additions & 8 deletions

File tree

‎.changeset/api-skill-delete-recycle-bin.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
'@objectstack/skills': patch
33
---
44

5-
docs(skills): objectstack-api no longer teaches that `DELETE` is a hard delete with no recycle bin: a by-id delete keeps a business object's rows in `sys_recycle_bin` (30 days by default; not `multi: true` deletes, platform rows or rows deleted before the bin existed), and restore is not exposed yet
5+
docs(skills): objectstack-api no longer teaches that `DELETE` is a hard delete with no recycle bin: a by-id delete keeps a business object's rows in `sys_recycle_bin` (30 days by default; not `multi: true` deletes, platform rows or rows deleted before the bin existed), and nothing lists or restores it over the API yet; eval case 5 expects that teaching instead of a hard delete
66

77
Clause-②: no
88
Metadata-protocol: none

‎skills/objectstack-api/SKILL.md‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -45,7 +45,7 @@ GET /api/v1/data/{object} # List records (with filter, sort, paginat
4545
GET /api/v1/data/{object}/:id # Get single record
4646
POST /api/v1/data/{object} # Create record
4747
PATCH /api/v1/data/{object}/:id # Update record
48-
DELETE /api/v1/data/{object}/:id # Delete record (kept in the recycle bin)
48+
DELETE /api/v1/data/{object}/:id # Delete record (business-object rows → recycle bin)
4949
POST /api/v1/data/{object}/query # Complex queries + aggregation (QueryAST in body)
5050
POST /api/v1/data/{object}/batch # Per-object batch operations
5151
POST /api/v1/batch # Cross-object atomic batch
@@ -408,10 +408,10 @@ keys mean the run produced none — never invent an empty.
408408
read. Sending neither skips the check; a mismatch answers **409
409409
`CONCURRENT_UPDATE`**; the quoted-empty entity-tag (`""`) is refused **400
410410
`VALIDATION_FAILED`**, not treated as omitted.
411-
2. **Treating `DELETE` as final, or as restorable today.** A by-id delete
412-
keeps a business object's rows in the recycle bin (`sys_recycle_bin`, 30
413-
days by default; never `multi: true` deletes, platform rows or rows deleted
414-
before the bin existed). Restore is not exposed yet; build no soft-delete.
411+
2. **Treating `DELETE` as final or as restorable.** A by-id delete keeps a
412+
business object's rows in the recycle bin (`sys_recycle_bin`, 30 days by
413+
default; not `multi: true` deletes, platform rows or rows deleted before the
414+
bin existed); nothing lists or restores it over the API yet. No soft-delete.
415415

416416
---
417417

‎skills/objectstack-api/evals/endpoints-auth-routes.json‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -44,10 +44,10 @@
4444
{
4545
"id": 5,
4646
"prompt": "Lock the `invoice` object's API down to read, list, search and export; add a `/bulk` route for imports and a `restore` operation so deleted invoices can be undeleted.",
47-
"expected_output": "Authors only the primitives: `apiMethods: ['get', 'list']` — `search` and `export` derive from `list` automatically and are never declared (a declared derived verb is stripped with a warning). Explains there is no `/bulk` route (batch writes go through `POST /api/v1/data/{object}/batch`) and that `restore` / `purge` never derive because DELETE is a hard delete; recoverability is per-field `trackHistory` or a `lifecycle` archive policy.",
47+
"expected_output": "Authors only the primitives: `apiMethods: ['get', 'list']` — `search` and `export` derive from `list` automatically and are never declared (a declared derived verb is stripped with a warning). Explains there is no `/bulk` route (batch writes go through `POST /api/v1/data/{object}/batch`) and that `restore` / `purge` never derive: a by-id delete of a business object already keeps its rows in the recycle bin (`sys_recycle_bin`), but nothing lists or restores them over the API yet, so there is no restore operation to add and no custom soft-delete to build.",
4848
"files": [],
4949
"assertions": {
50-
"must_contain": ["apiMethods", "/batch", "trackHistory", "lifecycle"],
50+
"must_contain": ["apiMethods", "/batch", "sys_recycle_bin", "recycle bin"],
5151
"must_not_contain": ["'search'", "'restore'"]
5252
}
5353
},

0 commit comments

Comments
 (0)