Skip to content

Commit 8003a55

Browse files
committed
docs: delete hand-written inventory counts across skills, docs, READMEs and comments
A hand-written count of a live inventory (field types, lifecycle events, node types, plugins, locales, metadata types, chart types) teaches nothing the names do not, no gate reads it against the tree, and it drifts the moment the inventory changes. The numbers go; the enumerated names stay where they teach something, and the stale metadata-type table in packages/metadata/README.md gives way to a pointer at the registry that declares the types. Co-Authored-By: Claude <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_017ihL2fNkBkNQ88EMzvcrPW
1 parent aef631b commit 8003a55

37 files changed

Lines changed: 74 additions & 69 deletions

File tree

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
---
2+
'@objectstack/skills': patch
3+
---
4+
5+
docs(skills): hand-written inventory counts are deleted; the names and the source of truth stay
6+
7+
Clause-②: no
8+
Metadata-protocol: none
9+
10+
- **Before.** `objectstack-data` counted its field types ("49") in SKILL.md and in `rules/field-types.md`, and its lifecycle events ("8") in SKILL.md and `references/data-hooks.md`; `objectstack-automation` counted its built-in node types ("20"); `objectui/README.md` counted its plugins ("18"); `objectui/guides/schema-expressions.md` counted the formula registry ("30 functions"); `objectstack-query` counted the aggregate functions ("six"). No gate reads any of those numbers against the tree, so each one goes wrong the moment the inventory moves, and a wrong count misleads the reader more than no count.
11+
- **Now.** The numbers are gone; every enumeration that taught something (the node-type tables, the plugin names, the function table, the aggregate names) stays, and each page still points at the file or schema that is the source of truth. Deletion only: every touched file shrinks under its unchanged token ceiling.
12+
- No schema, key or behaviour changes.

‎content/docs/api/error-catalog.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ navTitle: Error Code Catalog
44
description: Complete reference for all ObjectStack error codes with causes, fixes, and retry strategies
55
---
66

7-
ObjectStack uses a structured error system with **9 error categories** and **56 error codes reachable on the wire**. Every error includes a machine-readable code, HTTP status mapping, and retry guidance.
7+
ObjectStack uses a structured error system of **error categories** and **error codes reachable on the wire**, catalogued in full below. Every error includes a machine-readable code, HTTP status mapping, and retry guidance.
88

99
This catalog documents the **wire face** — the codes a client can actually receive. That is not quite the
1010
`StandardErrorCode` enum: the enum also carries in-process spellings the REST door translates at the

‎content/docs/capabilities/data.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Business data — objects, fields and records
33
navTitle: Manage Business Data
4-
description: Objects, 40+ field types, auto-computed fields, and relationships — every spreadsheet you run the business on, structured and governed
4+
description: Objects, field types, auto-computed fields, and relationships — every spreadsheet you run the business on, structured and governed
55
---
66

77

‎content/docs/capabilities/index.mdx‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,8 +12,8 @@ If you are a developer, the [Build sections](/docs/data-modeling) cover the same
1212
## The capabilities
1313

1414
<Cards>
15-
<Card href="/docs/capabilities/data" title="Manage Business Data" description="Objects, 40+ field types, formula and roll-up fields, relationships from lookups to hierarchies" />
16-
<Card href="/docs/capabilities/views" title="Views — See Data Your Way" description="Nine lenses over the same records: table, kanban, calendar, gantt, map and more — plus saved filters and global search" />
15+
<Card href="/docs/capabilities/data" title="Manage Business Data" description="Objects, field types, formula and roll-up fields, relationships from lookups to hierarchies" />
16+
<Card href="/docs/capabilities/views" title="Views — See Data Your Way" description="Many lenses over the same records: table, kanban, calendar, gantt, map and more — plus saved filters and global search" />
1717
<Card href="/docs/capabilities/forms" title="Forms & Data Quality" description="Wizards, conditional fields, validation on save, legal stage transitions, public web-to-lead forms" />
1818
<Card href="/docs/capabilities/automation" title="Automation" description="Five trigger styles and visual flows: reminders, hand-offs, escalations, and scheduled work that runs itself" />
1919
<Card href="/docs/capabilities/approvals" title="Approvals" description="Seven approver styles, four decision modes including group sign-off, locking, SLA escalation, send-back" />

‎content/docs/capabilities/views.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ One object can carry many named views at once — "My open deals (table)", "East
2727

2828
- **Global search** (`⌘K`) spans objects and understands partial matches — including **pinyin search**, so typing `zhangsan` finds 张三.
2929
- **Filters** combine any fields with and/or logic and a full operator set (equals, contains, greater than, between, is empty…).
30-
- **Relative dates**: "this quarter", "last month", "past 7 days", "next 30 days" — 36 built-in tokens plus custom offsets. A saved view filtered on "this quarter" rolls forward every day by itself.
30+
- **Relative dates**: "this quarter", "last month", "past 7 days", "next 30 days" — built-in tokens plus custom offsets. A saved view filtered on "this quarter" rolls forward every day by itself.
3131
- **Per-person scoping**: views like "My accounts" or "My team's opportunities" resolve per viewer automatically, following the permission model.
3232

3333
> **In HotCRM**: twelve view files cover every object — open the Opportunity object and switch between its pipeline kanban, forecast table, and close-date calendar to feel the difference lenses make.

‎content/docs/frontend/architecture-overview.mdx‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -314,20 +314,20 @@ packages/
314314
│ ├── SchemaRenderer.tsx
315315
│ ├── LazyPluginLoader.tsx
316316
│ ├── context/ # All React contexts
317-
│ └── hooks/ # 20+ hooks (useExpression, useActionRunner, etc.)
318-
├── components/ # 91+ Shadcn UI atoms
319-
├── fields/ # 35+ field renderers
317+
│ └── hooks/ # Hooks (useExpression, useActionRunner, etc.)
318+
├── components/ # Shadcn UI atoms
319+
├── fields/ # Field renderers
320320
├── layout/ # AppShell, Header, Sidebar
321321
├── i18n/ # Internationalization
322322
├── auth/ # AuthContext + providers
323323
├── permissions/ # RBAC/ABAC
324-
└── plugin-*/ # 20 plugin packages
324+
└── plugin-*/ # Plugin packages
325325
├── plugin-grid/
326326
├── plugin-kanban/
327327
├── plugin-charts/
328328
├── plugin-dashboard/
329329
├── plugin-form/
330-
└── ... (15 more)
330+
└── ...
331331
```
332332

333333
## Further Reading

‎content/docs/frontend/plugins/index.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ Plugins are lazy-loaded component packages that:
2121

2222
## Official Plugins
2323

24-
ObjectUI provides 14+ official plugins for common use cases:
24+
ObjectUI provides official plugins for common use cases:
2525

2626
### Data Visualization & Dashboards
2727

‎content/docs/plugins/packages.mdx‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ navTitle: Package Overview
44
description: Complete guide to all ObjectStack packages, services, drivers, plugins, and adapters
55
---
66

7-
ObjectStack is organized into **72 package manifests** across multiple categories. This guide provides an overview of the framework packages, services, drivers, plugins, and adapters in the [framework repository](https://github.com/objectstack-ai/objectstack/tree/main/packages).
7+
ObjectStack is organized into package manifests across multiple categories. This guide provides an overview of the framework packages, services, drivers, plugins, and adapters in the [framework repository](https://github.com/objectstack-ai/objectstack/tree/main/packages).
88

99
### Package categories at a glance
1010

@@ -24,7 +24,7 @@ ObjectStack is organized into **72 package manifests** across multiple categorie
2424

2525
**The Constitution** — Protocol schemas, types, and constants for the entire ObjectStack ecosystem.
2626

27-
- **Purpose**: Zod-first schema definitions for all 15 protocol domains
27+
- **Purpose**: Zod-first schema definitions for every protocol domain
2828
- **Exports**: Builder functions (`defineStack`, `defineView`, `defineApp`, `defineFlow`, `defineAgent`, `defineTool`, `defineSkill`) from the root entry, plus `ObjectSchema.create()` for objects from the `@objectstack/spec/data` subpath. Protocol namespaces (Data, UI, System, Automation, AI, API, Identity, Security, Kernel, Marketplace, QA, Contracts, Integration, Studio, Shared) are not re-exported from the top-level entry for tree-shaking reasons — import them from subpaths such as `@objectstack/spec/data` and `@objectstack/spec/ui`.
2929
- **When to use**: Import types, schemas, and builder functions when authoring metadata.
3030
- **Documentation**: [Protocol Reference](/docs/references)

‎content/docs/protocol/kernel/config-resolution.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -146,7 +146,7 @@ settings.registerManifest(crmSettingsManifest);
146146
```
147147

148148
Keys are `snake_case` storage paths inside the namespace — `(namespace, key)`,
149-
not a dotted global path. The full specifier vocabulary (19 types, visibility
149+
not a dotted global path. The full specifier vocabulary (specifier types, visibility
150150
expressions, action buttons, per-key permissions) is documented in the
151151
[Settings Manifest reference](/docs/references/system/settings-manifest).
152152

‎content/docs/protocol/objectql/index.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -111,7 +111,7 @@ fields:
111111

112112
### 2. Fields: Rich Type System
113113

114-
ObjectQL provides 20+ field types that encode business semantics:
114+
ObjectQL's field types encode business semantics:
115115

116116
| Field Type | Business Meaning | Example |
117117
|------------|------------------|---------|

0 commit comments

Comments
 (0)