Repository navigation
Commit 9657318
docs: scaffold examples pin exact; verify README names the scheduled-work switch (#25659)
Part of #25510
Clause-②: no
Metadata-protocol: none
These are two docs fixes the devx lane owed, with no code change.
## What changed
- **`content/docs/protocol/kernel/plugin-spec.mdx`**
- The plugin `package.json` example now pins `@objectstack/core` and
`@objectstack/cli` to exact `18.0.0`. Before, it showed `^17.0.0`.
- The paragraph under it now says the scaffolders pin each
`@objectstack/*` dependency exactly to the generating CLI's version
(`getCliVersion()`), never as a caret range. That is what PR #25539 made
them write.
- **`content/docs/upgrading.mdx`, step 2:** a project scaffolded since
18.1.0 is exact-pinned. A project on a caret range (`^18.0.0`, what
older scaffolds wrote) still moves at the lockfile step.
- **`packages/verify/README.md`:** after the `flows.run(…, { system:
true })` passage, the README now says three things:
- that call works with scheduled work off;
- a local stack arms time-triggered flows on their own cadence only with
`OS_AUTOMATION_SCHEDULED_WORK_ENABLED=true`;
- package-authored scheduled work is off by default in every posture.
The #25442 evaluation read "disabled by deployment policy" on a local
verify stack with the variable unset. Ruling D on that card asked for
this sentence to ride the next docs PR.
- **`.changeset/25442-verify-readme-scheduled-work.md`:** a patch for
`@objectstack/verify`, because `README.md` ships in its tarball
(`files`).
Sources were read on `main` at the time of writing:
- `packages/cli/src/commands/init.ts:37` (`getCliVersion`) and `:57`
(`pkgVersion`);
- `packages/cli/src/commands/create.ts:166`
(`objectstackDependencySpec`);
- `content/docs/deployment/environment-variables.mdx:103`.
## Out of scope
The rest of #25510 is the template baseline and
`scripts/sync-template-versions.mjs`. That work is in its own card
thread, whose PR carries `Fixes #25510`. This PR only says `Part of`, so
the Duplicate Fix Guard is not engaged.
## Local verification
Run on `origin/main` `baae6ed14e` plus this commit:
- `node scripts/pm/dispatch-gates.mjs --ran`: 88 derived families
accounted for, 79 run (all exit 0), 9 NOT MEASURED.
- The 9 NOT MEASURED families need build artifacts this worktree does
not have (`json-schema`, `dist`):
- `check:dts-closure`, `check:dual-build-cjs-loads`,
`check:lean-entry-closure`, `check:sourcemap-no-sources-content`,
`check:docs-transcript-drift`;
- the spec `check:docs` and `check:skill-examples`;
- the lint `check:doc-formula-expressions` and
`check:doc-security-posture`.
None of them reads the three edited files. CI runs them.
- The docs families ran and passed: `check:doc-authoring`,
`check:doc-anchors`, `check:docs-single-h1`,
`check:published-readme-links`, `check:docs-redirects`,
`check-doc-frontmatter` and `check-issue-citations`.
---
🤖 Generated with [Claude Code](https://claude.com/claude-code)
https://claude.ai/code/session_01LKHDniRQSWjRJyDtacwpEd
Co-authored-by: Claude <noreply@anthropic.com>1 parent 2c523d0 commit 9657318
4 files changed
Lines changed: 31 additions & 9 deletions
File tree
- .changeset
- content/docs
- protocol/kernel
- packages/verify
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
| 1 | + | |
| 2 | + | |
| 3 | + | |
| 4 | + | |
| 5 | + | |
| 6 | + | |
| 7 | + | |
| 8 | + | |
| 9 | + | |
| 10 | + | |
| 11 | + | |
| 12 | + | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
716 | 716 | | |
717 | 717 | | |
718 | 718 | | |
719 | | - | |
| 719 | + | |
720 | 720 | | |
721 | 721 | | |
722 | 722 | | |
723 | | - | |
| 723 | + | |
724 | 724 | | |
725 | 725 | | |
726 | 726 | | |
| |||
739 | 739 | | |
740 | 740 | | |
741 | 741 | | |
742 | | - | |
| 742 | + | |
743 | 743 | | |
744 | | - | |
745 | | - | |
746 | | - | |
747 | | - | |
| 744 | + | |
| 745 | + | |
| 746 | + | |
| 747 | + | |
| 748 | + | |
| 749 | + | |
| 750 | + | |
748 | 751 | | |
749 | 752 | | |
750 | 753 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
78 | 78 | | |
79 | 79 | | |
80 | 80 | | |
81 | | - | |
82 | | - | |
| 81 | + | |
| 82 | + | |
| 83 | + | |
83 | 84 | | |
84 | 85 | | |
85 | 86 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
351 | 351 | | |
352 | 352 | | |
353 | 353 | | |
| 354 | + | |
| 355 | + | |
| 356 | + | |
| 357 | + | |
| 358 | + | |
| 359 | + | |
354 | 360 | | |
355 | 361 | | |
356 | 362 | | |
| |||
0 commit comments