Skip to content

docs: re-derive the Support Desk clean-run stats from one real run#9262

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
os-steve merged 1 commit into from
Aug 17, 2026
+43 −6
Merged

docs: re-derive the Support Desk clean-run stats from one real run #9262

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 3 additions & 1 deletion content/docs/deployment/validating-metadata.mdx
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -538,9 +538,11 @@ A clean run walks the registry and reports timing:
✓ Validation passed (64ms)

Support Desk v0.1.0
Minimal ObjectStack environment — a clean slate for building.

Data: 1 Objects 6 Fields
Data: 2 Objects 6 Fields
UI: 1 Apps 1 Views 1 Actions
Runtime: 3 plugins
```

On failure the exit code is non-zero and the error is located and corrective —
Expand Down
45 changes: 40 additions & 5 deletions content/docs/getting-started/build-with-claude-code.mdx
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -194,11 +194,44 @@ export const TicketViews = defineView({
});
```

```typescript title="src/apps/support.app.ts"
import { defineApp } from '@objectstack/spec';

export const SupportApp = defineApp({
name: 'support_desk_support',
label: 'Support',
navigation: [
{
id: 'grp_support',
type: 'group',
label: 'Support',
expanded: true,
children: [
{
id: 'nav_open_tickets',
type: 'object',
label: 'Open',
objectName: 'support_desk_ticket',
viewName: 'open',
},
],
},
],
});
```

The agent also **wires the new files into `objectstack.config.ts`** — the object
through the `src/objects/index.ts` barrel, and the action and view via the
`actions:` / `views:` arrays in `defineStack()`. There is no filename-suffix
magic: metadata exists in the app only if the config imports it, so if a
freshly-authored action doesn't show up, the wiring is the first thing to check.
through the `src/objects/index.ts` barrel, and the action, view and app via the
`actions:` / `views:` / `apps:` arrays in `defineStack()`. There is no
filename-suffix magic: metadata exists in the app only if the config imports it,
so if a freshly-authored action doesn't show up, the wiring is the first thing to
check.

What it does **not** touch is the starter `note` object the `blank` template
scaffolded in step 1 (`src/objects/note.object.ts`, two fields). Nothing asked
for it to go, so it stays in the project — which is why the counts below read
**two** objects and **six** fields, not one and four. Delete it once the ticket
object has replaced it and the same run reports `1 Objects 4 Fields`.

This is the same metadata that powers the REST API, the Console UI, **and the MCP
tools exposed to AI** — define it once, and ObjectStack derives the rest.
Expand DownExpand Up@@ -255,9 +288,11 @@ Once it's clean:
✓ Validation passed (37ms)

Support Desk v0.1.0
Minimal ObjectStack environment — a clean slate for building.

Data: 1 Objects 6 Fields
Data: 2 Objects 6 Fields
UI: 1 Apps 1 Views 1 Actions
Runtime: 3 plugins
```

<Callout type="tip">
Expand Down
Loading