@topogram/template-todo 0.1.30

package/README.md

@@ -0,0 +1,91 @@
+# Topogram Todo Template
+
+Topogram template package for starting a generated Todo app.
+
+## Usage
+
+```bash
+topogram template list
+topogram catalog show todo
+topogram new ./todo-app --template todo --catalog github:attebury/topograms/topograms.catalog.json
+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 new` 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 components for task summary metrics,
+task tables, task boards, and task calendars. `proj_ui_shared` owns their
+screen and region placement through `ui_components`, so SvelteKit and React web
+projections inherit the same component 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
+
+```bash
+npm run pack:check
+```
+
+See [`CONSUMER_PROOF.md`](./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 new --template
+<tarball>`, 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-todo` through the `todo` catalog alias.
+
+By default the smoke test installs the `@topogram/cli` version pinned in
+`topogram-cli.version`. Override it with:
+
+```bash
+TOPOGRAM_CLI_PACKAGE_SPEC=/path/to/attebury-topogram-0.3.2.tgz npm run pack:check
+```
+
+## Release
+
+```bash
+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:
+
+```bash
+npm run catalog:update -- ../topograms/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:
+
+```bash
+npm run catalog:update -- ../topograms/topograms.catalog.json --check
+```

package/implementation/README.md

@@ -0,0 +1,9 @@
+# Web API DB Implementation
+
+This folder holds template implementation details used by the current generated app bundle.
+
+Examples include:
+
+- seed data
+- runtime metadata
+- backend and web reference implementation choices

package/implementation/backend/reference.js

@@ -0,0 +1,206 @@
+export const TODO_BACKEND_REFERENCE = {
+  serviceName: "topogram-todo-server",
+  renderSeedScript() {
+    const reference = TODO_BACKEND_REFERENCE;
+    const serializedTasks = JSON.stringify(reference.demo.tasks, null, 2).replace(/"NOW"/g, "now");
+    return `import { PrismaClient } from "@prisma/client";
+
+const prisma = new PrismaClient();
+
+const demoUserId = process.env.TOPOGRAM_DEMO_USER_ID || "${reference.demo.userId}";
+const demoProjectId = process.env.TOPOGRAM_DEMO_CONTAINER_ID || "${reference.demo.projectId}";
+const demoTaskId = process.env.TOPOGRAM_DEMO_PRIMARY_ID || "${reference.demo.taskId}";
+
+async function main() {
+  const now = new Date();
+
+  await prisma.user.upsert({
+    where: { email: "${reference.demo.user.email}" },
+    update: {
+      display_name: "${reference.demo.user.displayName}",
+      is_active: true
+    },
+    create: {
+      id: demoUserId,
+      email: "${reference.demo.user.email}",
+      display_name: "${reference.demo.user.displayName}",
+      is_active: true,
+      created_at: now
+    }
+  });
+
+  await prisma.project.upsert({
+    where: { name: "${reference.demo.project.name}" },
+    update: {
+      status: "${reference.demo.project.status}",
+      description: "${reference.demo.project.description}",
+      owner_id: demoUserId
+    },
+    create: {
+      id: demoProjectId,
+      name: "${reference.demo.project.name}",
+      description: "${reference.demo.project.description}",
+      status: "${reference.demo.project.status}",
+      owner_id: demoUserId,
+      created_at: now
+    }
+  });
+
+  const tasks = ${serializedTasks};
+
+  for (const task of tasks) {
+    await prisma.task.upsert({
+      where: { id: task.id },
+      update: {
+        title: task.title,
+        description: task.description,
+        status: task.status,
+        priority: task.priority,
+        owner_id: demoUserId,
+        project_id: demoProjectId,
+        completed_at: task.completed_at,
+        due_at: task.due_at,
+        updated_at: now
+      },
+      create: {
+        id: task.id,
+        title: task.title,
+        description: task.description,
+        status: task.status,
+        priority: task.priority,
+        owner_id: demoUserId,
+        project_id: demoProjectId,
+        created_at: now,
+        updated_at: now,
+        completed_at: task.completed_at,
+        due_at: task.due_at
+      }
+    });
+  }
+
+  console.log(JSON.stringify({
+    ok: true,
+    demoUserId,
+    demoProjectId,
+    demoTaskId,
+    seededTaskCount: tasks.length
+  }, null, 2));
+}
+
+main()
+  .catch((error) => {
+    console.error(error);
+    process.exitCode = 1;
+  })
+  .finally(async () => {
+    await prisma.$disconnect();
+  });
+`;
+  },
+  demo: {
+    userId: "11111111-1111-4111-8111-111111111111",
+    projectId: "22222222-2222-4222-8222-222222222222",
+    taskId: "33333333-3333-4333-8333-333333333333",
+    user: {
+      email: "demo.user@topogram.local",
+      displayName: "Demo User"
+    },
+    project: {
+      name: "Demo Project",
+      description: "Seeded demo project for the generated Todo runtime",
+      status: "active"
+    },
+    tasks: [
+      {
+        id: "33333333-3333-4333-8333-333333333333",
+        title: "Seeded Demo Task",
+        description: "This task was created by the generated demo seed script.",
+        priority: "high",
+        status: "active",
+        completed_at: null,
+        due_at: null
+      },
+      {
+        id: "33333333-3333-4333-8333-333333333334",
+        title: "Plan release notes",
+        description: "Collect the key v0.1 highlights for the generated app bundle.",
+        priority: "medium",
+        status: "draft",
+        completed_at: null,
+        due_at: null
+      },
+      {
+        id: "33333333-3333-4333-8333-333333333335",
+        title: "Review generated OpenAPI",
+        description: "Check that the latest OpenAPI output matches the shipped runtime.",
+        priority: "high",
+        status: "active",
+        completed_at: null,
+        due_at: null
+      },
+      {
+        id: "33333333-3333-4333-8333-333333333336",
+        title: "Write onboarding guide",
+        description: "Summarize the golden path for a new team adopting the generated stack.",
+        priority: "medium",
+        status: "active",
+        completed_at: null,
+        due_at: null
+      },
+      {
+        id: "33333333-3333-4333-8333-333333333337",
+        title: "Verify local process profile",
+        description: "Confirm the no-Docker environment profile still works after recent changes.",
+        priority: "low",
+        status: "completed",
+        completed_at: "NOW",
+        due_at: null
+      },
+      {
+        id: "33333333-3333-4333-8333-333333333338",
+        title: "Create export fixtures",
+        description: "Seed a few realistic export records for smoke testing.",
+        priority: "medium",
+        status: "draft",
+        completed_at: null,
+        due_at: null
+      },
+      {
+        id: "33333333-3333-4333-8333-333333333339",
+        title: "Polish generated homepage",
+        description: "Improve the first-run experience with direct seeded shortcuts.",
+        priority: "low",
+        status: "completed",
+        completed_at: "NOW",
+        due_at: null
+      },
+      {
+        id: "33333333-3333-4333-8333-333333333340",
+        title: "Audit runtime smoke checks",
+        description: "Expand smoke coverage for core task actions.",
+        priority: "high",
+        status: "active",
+        completed_at: null,
+        due_at: null
+      },
+      {
+        id: "33333333-3333-4333-8333-333333333341",
+        title: "Draft deployment checklist",
+        description: "Capture the minimum steps for shipping the generated app.",
+        priority: "medium",
+        status: "draft",
+        completed_at: null,
+        due_at: null
+      },
+      {
+        id: "33333333-3333-4333-8333-333333333342",
+        title: "Capture user feedback",
+        description: "Collect notes from the first walkthrough of the generated UX.",
+        priority: "high",
+        status: "active",
+        completed_at: null,
+        due_at: null
+      }
+    ]
+  }
+};

package/implementation/backend/repository-reference.js

@@ -0,0 +1,74 @@
+export const TODO_BACKEND_REPOSITORY_REFERENCE = {
+  capabilityIds: [
+    "cap_get_project",
+    "cap_list_projects",
+    "cap_create_project",
+    "cap_update_project",
+    "cap_get_user",
+    "cap_list_users",
+    "cap_create_user",
+    "cap_update_user",
+    "cap_get_task",
+    "cap_list_tasks",
+    "cap_create_task",
+    "cap_update_task",
+    "cap_complete_task",
+    "cap_delete_task",
+    "cap_export_tasks",
+    "cap_get_task_export_job"
+  ],
+  preconditionCapabilityIds: [
+    "cap_update_task",
+    "cap_complete_task",
+    "cap_delete_task"
+  ],
+  preconditionResource: {
+    variableName: "currentTask",
+    repositoryMethod: "getTask",
+    inputField: "task_id",
+    versionField: "updated_at"
+  },
+  downloadCapabilityId: "cap_download_task_export",
+  repositoryInterfaceName: "TodoRepository",
+  prismaRepositoryClassName: "PrismaTodoRepository",
+  drizzleRepositoryClassName: "DrizzleTodoRepository",
+  dependencyName: "todoRepository",
+  lookupBindings: [
+    {
+      entityId: "entity_project",
+      route: "/lookups/projects",
+      repositoryMethod: "listProjectOptions"
+    },
+    {
+      entityId: "entity_user",
+      route: "/lookups/users",
+      repositoryMethod: "listUserOptions"
+    }
+  ],
+  export: {
+    filename: "task-export.zip",
+    contentType: "application/zip"
+  },
+  drizzleHint: "Use the Prisma profile for the runnable Todo runtime or fill in the Drizzle query logic here.",
+  drizzleSchemaImports: ["tasksTable", "projectsTable", "usersTable"],
+  additionalTypeNames: [
+    "DownloadTaskExportInput",
+    "DownloadTaskExportResult",
+    "MarkExportJobCompletedInput",
+    "MarkExportJobCompletedResult",
+    "LookupOption"
+  ],
+  additionalTypeDeclarations: [
+    `export interface DownloadTaskExportInput {\n  job_id: string;\n}`,
+    `export interface DownloadTaskExportResult {\n  body: Uint8Array;\n  contentType: string;\n  filename: string;\n}`,
+    `export interface LookupOption {\n  value: string;\n  label: string;\n}`,
+    `export interface MarkExportJobCompletedInput {\n  job_id: string;\n  state: string;\n  download_url?: string;\n  error_message?: string;\n}`,
+    `export interface MarkExportJobCompletedResult {\n  job_id: string;\n  state: string;\n}`
+  ],
+  additionalInterfaceMethods: [
+    "listProjectOptions(): Promise<LookupOption[]>;",
+    "listUserOptions(): Promise<LookupOption[]>;",
+    "downloadTaskExport(input: DownloadTaskExportInput): Promise<DownloadTaskExportResult>;",
+    "markExportJobCompleted(input: MarkExportJobCompletedInput): Promise<MarkExportJobCompletedResult>;"
+  ]
+};