@topogram/template-todo 0.1.30

package/implementation/web/screens-reference.js

@@ -0,0 +1,15 @@
+export const TODO_WEB_SCREEN_REFERENCE = {
+  projectListScreenId: "project_list",
+  projectDetailScreenId: "project_detail",
+  projectCreateScreenId: "project_create",
+  projectEditScreenId: "project_edit",
+  userListScreenId: "user_list",
+  userDetailScreenId: "user_detail",
+  userCreateScreenId: "user_create",
+  userEditScreenId: "user_edit",
+  listScreenId: "task_list",
+  detailScreenId: "task_detail",
+  createScreenId: "task_create",
+  editScreenId: "task_edit",
+  exportsScreenId: "task_exports"
+};

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@topogram/template-todo",
+  "version": "0.1.30",
+  "description": "Topogram template pack for starting a generated Todo app.",
+  "private": false,
+  "license": "UNLICENSED",
+  "type": "module",
+  "files": [
+    "topogram-template.json",
+    "topogram",
+    "topogram.project.json",
+    "implementation",
+    "README.md"
+  ],
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "scripts": {
+    "catalog:update": "node ./scripts/update-catalog-version.mjs",
+    "pack:check": "bash ./scripts/verify-template-package.sh",
+    "release:prepare": "bash ./scripts/prepare-release.sh",
+    "release:check": "bash ./scripts/check-release-version.sh"
+  },
+  "devDependencies": {
+    "@topogram/cli": "0.3.34",
+    "@topogram/generator-hono-api": "0.2.6",
+    "@topogram/generator-postgres-db": "0.1.6",
+    "@topogram/generator-sveltekit-web": "0.1.14"
+  }
+}

package/topogram/actors/actor-user.tg

@@ -0,0 +1,6 @@
+actor actor_user {
+  name "User"
+  description "Workspace member interacting with the task system"
+
+  status active
+}

package/topogram/capabilities/cap-complete-task.tg

@@ -0,0 +1,12 @@
+capability cap_complete_task {
+  name "Complete Task"
+  description "Allows a user to mark a task complete"
+
+  actors [actor_user]
+  reads [entity_task]
+  updates [entity_task]
+  input [shape_input_complete_task]
+  output [shape_output_task_detail]
+
+  status active
+}

package/topogram/capabilities/cap-create-project.tg

@@ -0,0 +1,11 @@
+capability cap_create_project {
+  name "Create Project"
+  description "Allows a user to create a new project"
+
+  actors [actor_user]
+  creates [entity_project]
+  input [shape_input_create_project]
+  output [shape_output_project_detail]
+
+  status active
+}

package/topogram/capabilities/cap-create-task.tg

@@ -0,0 +1,14 @@
+capability cap_create_task {
+  name "Create Task"
+  description "Allows a user to create a new task"
+
+  actors [actor_user]
+
+  creates [entity_task]
+  reads [entity_project, entity_user]
+
+  input [shape_input_create_task]
+  output [shape_output_task_detail]
+
+  status active
+}

package/topogram/capabilities/cap-create-user.tg

@@ -0,0 +1,11 @@
+capability cap_create_user {
+  name "Create User"
+  description "Allows a user to create a new user"
+
+  actors [actor_user]
+  creates [entity_user]
+  input [shape_input_create_user]
+  output [shape_output_user_detail]
+
+  status active
+}

package/topogram/capabilities/cap-delete-task.tg

@@ -0,0 +1,12 @@
+capability cap_delete_task {
+  name "Delete Task"
+  description "Allows a user to archive a task through the delete endpoint"
+
+  actors [actor_user]
+  reads [entity_task]
+  deletes [entity_task]
+  input [shape_input_delete_task]
+  output [shape_output_task_detail]
+
+  status active
+}

package/topogram/capabilities/cap-download-task-export.tg

@@ -0,0 +1,10 @@
+capability cap_download_task_export {
+  name "Download Task Export"
+  description "Downloads the completed task export artifact"
+
+  actors [actor_user]
+  reads [entity_task]
+  input [shape_input_get_task_export_job]
+
+  status active
+}

package/topogram/capabilities/cap-export-tasks.tg

@@ -0,0 +1,11 @@
+capability cap_export_tasks {
+  name "Export Tasks"
+  description "Starts an asynchronous export job for tasks"
+
+  actors [actor_user]
+  reads [entity_task, entity_project, entity_user]
+  input [shape_input_export_tasks]
+  output [shape_output_task_export_job]
+
+  status active
+}

package/topogram/capabilities/cap-get-project.tg

@@ -0,0 +1,11 @@
+capability cap_get_project {
+  name "Get Project"
+  description "Allows a user to fetch a single project by id"
+
+  actors [actor_user]
+  reads [entity_project]
+  input [shape_input_get_project]
+  output [shape_output_project_detail]
+
+  status active
+}

package/topogram/capabilities/cap-get-task-export-job.tg

@@ -0,0 +1,11 @@
+capability cap_get_task_export_job {
+  name "Get Task Export Job"
+  description "Fetches the current status of a task export job"
+
+  actors [actor_user]
+  reads [entity_task]
+  input [shape_input_get_task_export_job]
+  output [shape_output_task_export_status]
+
+  status active
+}

package/topogram/capabilities/cap-get-task.tg

@@ -0,0 +1,11 @@
+capability cap_get_task {
+  name "Get Task"
+  description "Allows a user to fetch a single task by id"
+
+  actors [actor_user]
+  reads [entity_task]
+  input [shape_input_get_task]
+  output [shape_output_task_detail]
+
+  status active
+}

package/topogram/capabilities/cap-get-user.tg

@@ -0,0 +1,11 @@
+capability cap_get_user {
+  name "Get User"
+  description "Allows a user to fetch a single user by id"
+
+  actors [actor_user]
+  reads [entity_user]
+  input [shape_input_get_user]
+  output [shape_output_user_detail]
+
+  status active
+}

package/topogram/capabilities/cap-list-projects.tg

@@ -0,0 +1,11 @@
+capability cap_list_projects {
+  name "List Projects"
+  description "Allows a user to list projects"
+
+  actors [actor_user]
+  reads [entity_project]
+  input [shape_input_list_projects]
+  output [shape_output_project_detail]
+
+  status active
+}

package/topogram/capabilities/cap-list-tasks.tg

@@ -0,0 +1,11 @@
+capability cap_list_tasks {
+  name "List Tasks"
+  description "Allows a user to list tasks"
+
+  actors [actor_user]
+  reads [entity_task, entity_project, entity_user]
+  input [shape_input_list_tasks]
+  output [shape_output_task_detail]
+
+  status active
+}

package/topogram/capabilities/cap-list-users.tg

@@ -0,0 +1,11 @@
+capability cap_list_users {
+  name "List Users"
+  description "Allows a user to list users"
+
+  actors [actor_user]
+  reads [entity_user]
+  input [shape_input_list_users]
+  output [shape_output_user_detail]
+
+  status active
+}

package/topogram/capabilities/cap-update-project.tg

@@ -0,0 +1,12 @@
+capability cap_update_project {
+  name "Update Project"
+  description "Allows a user to update mutable project fields"
+
+  actors [actor_user]
+  reads [entity_project]
+  updates [entity_project]
+  input [shape_input_update_project]
+  output [shape_output_project_detail]
+
+  status active
+}

package/topogram/capabilities/cap-update-task.tg

@@ -0,0 +1,12 @@
+capability cap_update_task {
+  name "Update Task"
+  description "Allows a user to update mutable task fields"
+
+  actors [actor_user]
+  reads [entity_task]
+  updates [entity_task]
+  input [shape_input_update_task]
+  output [shape_output_task_detail]
+
+  status active
+}

package/topogram/capabilities/cap-update-user.tg

@@ -0,0 +1,12 @@
+capability cap_update_user {
+  name "Update User"
+  description "Allows a user to update mutable user fields"
+
+  actors [actor_user]
+  reads [entity_user]
+  updates [entity_user]
+  input [shape_input_update_user]
+  output [shape_output_user_detail]
+
+  status active
+}

package/topogram/components/component-ui-task-board.tg

@@ -0,0 +1,33 @@
+component component_ui_task_board {
+  name "Task Board"
+  description "Reusable kanban-style task board grouped by status"
+  category collection
+
+  props {
+    columns array required
+    loading boolean optional default false
+    selected_id text optional default null
+  }
+
+  events {
+    card_select shape_output_task_card
+    card_move shape_input_update_task
+  }
+
+  slots {
+    toolbar "Board actions"
+    empty_state "Empty board content"
+  }
+
+  behavior [selection, grouping, drag_drop, optimistic_update]
+  behaviors {
+    selection mode single state selected_id emits card_select
+    grouping fields [status]
+    drag_drop axis horizontal reorder true
+    optimistic_update actions [cap_update_task] rollback true
+  }
+  patterns [board_view, resource_cards]
+  regions [results, toolbar]
+  version "1.0"
+  status active
+}

package/topogram/components/component-ui-task-calendar.tg

@@ -0,0 +1,30 @@
+component component_ui_task_calendar {
+  name "Task Calendar"
+  description "Reusable calendar view for scheduled tasks"
+  category collection
+
+  props {
+    events array required
+    loading boolean optional default false
+    selected_id text optional default null
+  }
+
+  events {
+    event_select shape_output_task_card
+  }
+
+  slots {
+    toolbar "Calendar controls"
+    empty_state "Empty calendar content"
+  }
+
+  behavior [selection, filtering]
+  behaviors {
+    selection mode single state selected_id emits event_select
+    filtering fields [status, ownerId]
+  }
+  patterns [calendar_view]
+  regions [results, toolbar]
+  version "1.0"
+  status active
+}

package/topogram/components/component-ui-task-summary.tg

@@ -0,0 +1,23 @@
+component component_ui_task_summary {
+  name "Task Summary"
+  description "Reusable summary metrics for task workload state"
+  category display
+
+  props {
+    metrics object required
+    loading boolean optional default false
+  }
+
+  slots {
+    empty_state "Summary unavailable content"
+  }
+
+  behavior [realtime_update]
+  behaviors {
+    realtime_update source cap_list_tasks merge replace
+  }
+  patterns [summary_stats]
+  regions [hero, summary]
+  version "1.0"
+  status active
+}

package/topogram/components/component-ui-task-table.tg

@@ -0,0 +1,34 @@
+component component_ui_task_table {
+  name "Task Table"
+  description "Reusable tabular task collection with selection, sorting, filtering, and export affordances"
+  category collection
+
+  props {
+    rows array required
+    selected_ids array optional default []
+    loading boolean optional default false
+  }
+
+  events {
+    row_select shape_output_task_card
+    export_request shape_input_export_tasks
+  }
+
+  slots {
+    toolbar "Table actions and filters"
+    empty_state "Empty task list content"
+  }
+
+  behavior [selection, sorting, filtering, pagination, bulk_action]
+  behaviors {
+    selection mode multi state selected_ids emits row_select
+    sorting fields [title, status, priority, dueAt, created_at] default [created_at, desc]
+    filtering fields [project_id, owner_id, status]
+    pagination mode cursor page_size 25
+    bulk_action actions [cap_export_tasks] state selected_ids emits export_request
+  }
+  patterns [resource_table, data_grid_view]
+  regions [results, toolbar]
+  version "1.0"
+  status active
+}

package/topogram/decisions/decision-task-ownership.tg

@@ -0,0 +1,9 @@
+decision dec_task_ownership {
+  name "Active task ownership is singular"
+  description "Active tasks use one accountable owner"
+
+  context [accountability, simplified_workflows, cleaner_ui]
+  consequences [easier_reporting, less_flexible_collaboration]
+
+  status accepted
+}

package/topogram/docs/glossary/user.md

@@ -0,0 +1,22 @@
+---
+id: user
+kind: glossary
+title: User
+status: canonical
+summary: Workspace member who can own projects and be assigned tasks.
+aliases:
+  - owner
+  - assignee
+related_entities:
+  - entity_user
+related_capabilities:
+  - cap_create_user
+  - cap_update_user
+tags:
+  - naming
+  - identity
+---
+
+A user is a workspace member who can be assigned tasks and may own projects.
+
+Legacy product language sometimes says "owner" for both task assignment and project ownership, but the canonical Topogram term is `user`. The task and project models keep `owner_id` as the relationship field name because that reflects current product semantics, while the resource itself remains `entity_user`.

package/topogram/docs/journeys/task-creation-and-ownership.md

@@ -0,0 +1,57 @@
+---
+id: task_creation_and_ownership
+kind: journey
+title: Task Creation And Ownership
+status: canonical
+summary: A user creates a task in an active project, assigns clear ownership, and can immediately find it again to keep work moving.
+actors:
+  - user
+related_actors:
+  - actor_user
+success_outcome: The new task is captured in the right project with valid ownership and remains easy to review and update.
+related_entities:
+  - entity_task
+  - entity_project
+  - entity_user
+related_capabilities:
+  - cap_create_task
+  - cap_get_task
+  - cap_list_tasks
+  - cap_update_task
+related_rules:
+  - rule_no_task_creation_in_archived_project
+  - rule_only_active_users_may_own_tasks
+related_projections:
+  - proj_api
+  - proj_ui_shared
+  - proj_ui_web
+failure_signals:
+  - The user can create a task in an archived project.
+  - The user can assign a task to an inactive owner.
+  - The newly created task is hard to find from the normal task list or detail flow.
+tags:
+  - journey
+  - task-management
+  - ownership
+---
+
+This journey captures the most common Todo flow: turning a piece of work into a tracked task with clear ownership.
+
+The user intent is not just to persist a row. The user needs confidence that the task belongs to the correct project, follows ownership rules, and shows up immediately in the standard list and detail views used to manage work.
+
+## Happy Path
+
+1. The user starts from an active project and opens the new-task flow.
+2. The user enters the task details, including priority and an optional owner.
+3. The system accepts the task only if the project can still receive new work and the owner is active.
+4. The user can immediately find the new task in task list and task detail surfaces.
+5. The user can keep the flow moving by updating the task as work progresses.
+
+## Alternate Paths
+
+- If the project has already been archived, task creation should stop before the new task is accepted.
+- If the chosen owner is inactive, the flow should block invalid assignment instead of creating ambiguous accountability.
+
+## Change Review Notes
+
+Review this journey when changing task creation rules, ownership semantics, project archival behavior, task list visibility, or the create/update task UI flow.

package/topogram/entities/entity-project.tg

@@ -0,0 +1,28 @@
+ entity entity_project {
+  name "Project"
+  description "A grouping container for tasks"
+
+  fields {
+    id uuid required
+    name string required
+    description text optional
+    status project_status required default active
+    owner_id uuid optional
+    created_at datetime required
+  }
+
+  keys {
+    primary [id]
+    unique [name]
+  }
+
+  relations {
+    owner_id references entity_user.id
+  }
+
+  invariants {
+    name length <= 120
+  }
+
+  status active
+}

package/topogram/entities/entity-task.tg

@@ -0,0 +1,38 @@
+entity entity_task {
+  name "Task"
+  description "A unit of work tracked in the Todo domain and surfaced in the generated demo"
+
+  fields {
+    id uuid required
+    title string required
+    description text optional
+    status task_status required default draft
+    priority task_priority required default medium
+    owner_id uuid optional
+    project_id uuid required
+    created_at datetime required
+    updated_at datetime required
+    completed_at datetime optional
+    due_at datetime optional
+  }
+
+  keys {
+    primary [id]
+    index [project_id, status]
+    index [owner_id, status]
+  }
+
+  relations {
+    owner_id references entity_user.id
+    project_id references entity_project.id
+  }
+
+  invariants {
+    completed_at requires status == completed
+    status == active implies owner_id is required
+    status == draft implies completed_at is null
+    title length <= 200
+  }
+
+  status active
+}

package/topogram/entities/entity-user.tg

@@ -0,0 +1,24 @@
+entity entity_user {
+  name "User"
+  description "A person who can own tasks"
+
+  fields {
+    id uuid required
+    email string required
+    display_name string required
+    is_active boolean required default true
+    created_at datetime required
+  }
+
+  keys {
+    primary [id]
+    unique [email]
+  }
+
+  invariants {
+    email format == email
+    display_name length <= 120
+  }
+
+  status active
+}

package/topogram/enums/enum-export-job-status.tg

@@ -0,0 +1,3 @@
+enum export_job_status {
+  values [accepted, running, completed, failed, expired]
+}

package/topogram/enums/enum-project-status.tg

@@ -0,0 +1,3 @@
+enum project_status {
+  values [active, archived]
+}

package/topogram/enums/enum-task-priority.tg

@@ -0,0 +1,3 @@
+enum task_priority {
+  values [low, medium, high]
+}

package/topogram/enums/enum-task-status.tg

@@ -0,0 +1,3 @@
+enum task_status {
+  values [draft, active, completed, archived]
+}

package/topogram/operations/operation-task-creation-monitoring.tg

@@ -0,0 +1,10 @@
+operation op_task_creation_monitoring {
+  name "Task creation monitoring"
+  description "Runtime monitoring for task creation"
+
+  observes [cap_create_task]
+  metrics [task_creation_latency, task_creation_failure_rate]
+  alerts [high_task_creation_failure_rate]
+
+  status active
+}