Skip to content

chore: bootstrap plugin scaffold (D-00) - #2

Merged
kasunben merged 3 commits into
docs/re-verify-platform-capabilitiesfrom
chore/bootstrap-plugin-scaffold
Jul 16, 2026
Merged

chore: bootstrap plugin scaffold (D-00)#2
kasunben merged 3 commits into
docs/re-verify-platform-capabilitiesfrom
chore/bootstrap-plugin-scaffold

Conversation

@kasunben

@kasunben kasunben commented Jul 16, 2026

Copy link
Copy Markdown
Member

Summary

  • Bootstraps this repo per roadmap.md D-00: package.json, tsconfig.json (extends @sovereignfs/tsconfig/nextjs.json), manifest.json (fs.sovereign.docs, shell: default), a placeholder EmptyState page/layout matching Ledger's under-construction convention, and a README pointing to SPEC.md/roadmap.md.
  • shell: default — consistent with every other type: sovereign product plugin (Ledger, Plainwrite, Tasks, Wallet, Shopper); shell: minimal is only used by the example-minimal demo plugin.
  • No CI workflow in this PR — drafted a composed-clone workflow (checkout this repo into a fresh sovereignfs/sovereign clone, since this plugin depends on workspace-only platform packages and can't be linted/typechecked standalone), then dropped it as premature scaffolding. Neither sibling reference plugin (sovereign-ledger, sovereign-plainwrite) has CI yet either. Tracked in roadmap.md's Deferred section (D-00-ci).

Stacked on #1 (docs/re-verify-platform-capabilities) — this scaffold's manifest permissions and shell choice depend on that PR's corrections. Base should be retargeted to main once #1 merges.

Test plan

  • pnpm exec prettier --check on the new files — clean
  • pnpm exec eslint on the new files — clean
  • pnpm --filter @sovereignfs/sovereign-docs typecheck — clean
  • pnpm generate composes the plugin to runtime/app/(platform)/(plugins)/docs
  • pnpm dev + browser check — /docs renders "Sovereign Docs is under construction" with no extra chrome issues

🤖 Generated with Claude Code

kasunben and others added 3 commits July 16, 2026 20:30
package.json, tsconfig.json (extends @sovereignfs/tsconfig), manifest.json
(id fs.sovereign.docs, shell: default — matching every other type: sovereign
product plugin, not the example-minimal demo), a placeholder EmptyState
page/layout matching Ledger's under-construction convention, a CI workflow
that composes this checkout into a platform clone (this plugin can't
typecheck standalone — workspace-only deps), and a README pointing to
SPEC.md/roadmap.md.

Verified live: pnpm generate composes it to
runtime/app/(platform)/(plugins)/docs, and pnpm dev renders the placeholder
correctly in the browser. prettier, eslint, and tsc --noEmit all pass clean.

Co-Authored-By: Claude Code <noreply@anthropic.com>
This plugin depends on workspace-only platform packages and can't be
lint/typecheck-verified without a platform checkout, so the composed-clone
CI workflow was more scaffolding than value at this stage. Removed for now;
revisit once there's an established pattern for verifying externally-
maintained sovereign plugins in CI.

Co-Authored-By: Claude Code <noreply@anthropic.com>
Co-Authored-By: Claude Code <noreply@anthropic.com>
@kasunben
kasunben marked this pull request as ready for review July 16, 2026 18:56
@kasunben
kasunben merged commit 4df1bd2 into docs/re-verify-platform-capabilities Jul 16, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant