Skip to content

Commit 4b8ff84

Browse files
os-steveclaude
andcommitted
docs: re-derive the Support Desk clean-run stats from one real run (#9152)
Both pages printed `Data: 1 Objects 6 Fields`, a line no run can emit: the object count comes from a project whose starter object was deleted and the field count from one where it was kept. Measured against the CLI built at origin/main, scaffolding `support-desk` from the `blank` template exactly as step 1 describes and applying the page's own listings: Data: 2 Objects 6 Fields UI: 1 Apps 1 Views 1 Actions Runtime: 3 plugins `6 Fields` was right all along -- 2 from the scaffolded `note` object plus 4 from the page's ticket. `1 Objects` was the wrong number. Deleting the starter object instead yields `1 Objects 4 Fields`; both variants were run. Also makes the run reconstructible from the page: adds the Support-nav app listing the prose already promises but never showed, and names the starter `note` object the counts depend on. Timings are machine identity, not fixture identity, and are left as #9151 left them. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01XqDQYVU5smx29ts9pAErja
1 parent 739fe5b commit 4b8ff84

2 files changed

Lines changed: 43 additions & 6 deletions

File tree

‎content/docs/deployment/validating-metadata.mdx‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -538,9 +538,11 @@ A clean run walks the registry and reports timing:
538538
✓ Validation passed (64ms)
539539
540540
Support Desk v0.1.0
541+
Minimal ObjectStack environment — a clean slate for building.
541542
542-
Data: 1 Objects 6 Fields
543+
Data: 2 Objects 6 Fields
543544
UI: 1 Apps 1 Views 1 Actions
545+
Runtime: 3 plugins
544546
```
545547

546548
On failure the exit code is non-zero and the error is located and corrective —

‎content/docs/getting-started/build-with-claude-code.mdx‎

Lines changed: 40 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -194,11 +194,44 @@ export const TicketViews = defineView({
194194
});
195195
```
196196

197+
```typescript title="src/apps/support.app.ts"
198+
import { defineApp } from '@objectstack/spec';
199+
200+
export const SupportApp = defineApp({
201+
name: 'support_desk_support',
202+
label: 'Support',
203+
navigation: [
204+
{
205+
id: 'grp_support',
206+
type: 'group',
207+
label: 'Support',
208+
expanded: true,
209+
children: [
210+
{
211+
id: 'nav_open_tickets',
212+
type: 'object',
213+
label: 'Open',
214+
objectName: 'support_desk_ticket',
215+
viewName: 'open',
216+
},
217+
],
218+
},
219+
],
220+
});
221+
```
222+
197223
The agent also **wires the new files into `objectstack.config.ts`** — the object
198-
through the `src/objects/index.ts` barrel, and the action and view via the
199-
`actions:` / `views:` arrays in `defineStack()`. There is no filename-suffix
200-
magic: metadata exists in the app only if the config imports it, so if a
201-
freshly-authored action doesn't show up, the wiring is the first thing to check.
224+
through the `src/objects/index.ts` barrel, and the action, view and app via the
225+
`actions:` / `views:` / `apps:` arrays in `defineStack()`. There is no
226+
filename-suffix magic: metadata exists in the app only if the config imports it,
227+
so if a freshly-authored action doesn't show up, the wiring is the first thing to
228+
check.
229+
230+
What it does **not** touch is the starter `note` object the `blank` template
231+
scaffolded in step 1 (`src/objects/note.object.ts`, two fields). Nothing asked
232+
for it to go, so it stays in the project — which is why the counts below read
233+
**two** objects and **six** fields, not one and four. Delete it once the ticket
234+
object has replaced it and the same run reports `1 Objects 4 Fields`.
202235

203236
This is the same metadata that powers the REST API, the Console UI, **and the MCP
204237
tools exposed to AI** — define it once, and ObjectStack derives the rest.
@@ -255,9 +288,11 @@ Once it's clean:
255288
✓ Validation passed (37ms)
256289
257290
Support Desk v0.1.0
291+
Minimal ObjectStack environment — a clean slate for building.
258292
259-
Data: 1 Objects 6 Fields
293+
Data: 2 Objects 6 Fields
260294
UI: 1 Apps 1 Views 1 Actions
295+
Runtime: 3 plugins
261296
```
262297

263298
<Callout type="tip">

0 commit comments

Comments
 (0)