Topogram Todo Template

Topogram template package for starting a generated Todo app.

Usage

npm install --save-dev @topogram/cli
npx topogram doctor
npx topogram template list
npx topogram catalog show todo
npx topogram copy todo ./todo-app
cd ./todo-app
npm install
npm run doctor
npm run check
npm run generate
npm run verify

The public start path is the todo catalog alias. The catalog resolves that alias to the current @topogram/template-todo package version.

This template includes executable implementation provider JavaScript under implementation/. topogram copy copies that code but does not execute it; topogram generate may load it later after local trust metadata is recorded. Use it as trusted code from the @topogram package scope.

The Topogram source includes reusable UI widgets for task summary metrics, task tables, task boards, and task calendars. proj_semantic_ui owns their screen and region placement through widget_bindings, so SvelteKit and React web projections inherit the same widget contract metadata.

Runtime Semantics

This template owns the Todo product semantics for the generated SvelteKit, Hono, and Postgres app. Runtime checks are intentionally template-specific, not engine tests.

The full generated runtime check exercises bearer-demo auth and lifecycle behavior. Manager/admin endpoints such as export read/download/delete require TOPOGRAM_AUTH_ROLES=manager and TOPOGRAM_AUTH_ADMIN=true; web-facing checks still verify user-scoped behavior with the sample auth environment.

Verification

npm run pack:check

See CONSUMER_PROOF.md for the verification standard this repo must keep before publishing the template package.

This runs reusable template conformance with topogram template check, packs the template, creates a disposable starter with topogram copy <template> <target> using , installs the starter, runs npm run doctor, runs npm run source:status, runs npm run template:detach:dry-run, runs npm run check, runs npm run generate, runs the generated app compile check, and verifies the generated app sentinel. This package-level smoke test intentionally uses the packed tarball directly; consumer-facing creation is verified in topogram-demo-todothrough thetodo` catalog alias.

By default the smoke test installs the @topogram/cli version pinned in topogram-cli.version. Override it with:

TOPOGRAM_CLI_PACKAGE_SPEC=/path/to/topogram-cli.tgz npm run pack:check

Release

npm run release:prepare -- 0.1.2
npm run release:check
npm run pack:check

Commit the updated package metadata, then publish with the Publish Template Package GitHub Actions workflow. The workflow publishes the committed version and can create a topogram-template-todo-v<version> tag.

After publishing a template version, update the catalog from this repo instead of hand-editing the todo entry:

npm run catalog:update -- ../topos/topograms.catalog.json

The script verifies package.json and topogram-template.json agree, then updates only the catalog entry with id: "todo" and package @topogram/template-todo. Use --check when you only want to verify the catalog is already aligned:

npm run catalog:update -- ../topos/topograms.catalog.json --check