@travetto/llm-support 8.0.0-alpha.20

package/resources/snippets/code/model-query.service.ts.tpl

@@ -0,0 +1,18 @@
+import { Inject, Injectable } from '@travetto/di';
+import type { ModelQuerySupport, Query } from '@travetto/model-query';
+
+import { {{modelName}} } from '../model/{{modelFile}}.ts';
+
+@Injectable()
+export class {{modelName}}QueryService {
+  @Inject()
+  source: ModelQuerySupport;
+
+  queryByQuestion(question: string): Promise<{{modelName}}[]> {
+    const lowered = question.toLowerCase();
+    const query: Query<{{modelName}}> = lowered.includes('recent') ?
+      { where: {}, sort: { createdAt: -1 }, limit: 25 } :
+      { where: {} };
+    return this.source.query({{modelName}}, query);
+  }
+}

package/resources/snippets/code/openapi-client-generation.readme.tpl

@@ -0,0 +1,13 @@
+# Generated API Client
+
+This directory is generated from OpenAPI definitions.
+
+## Regeneration
+
+Run:
+
+```bash
+npx trv openapi:client --input openapi.yml --output src/client
+```
+
+Commit generated changes when API contract updates are intentional.

package/resources/snippets/code/openapi-client-generation.yml.tpl

@@ -0,0 +1,20 @@
+name: openapi-client
+
+on:
+  workflow_dispatch:
+  pull_request:
+    paths:
+      - openapi.yml
+      - openapi.generated.yml
+
+jobs:
+  generate-client:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+      - run: npm ci
+      - run: npx trv openapi:client --input openapi.yml --output src/client
+      - run: git diff --exit-code

package/resources/snippets/code/openapi-spec-pipeline.yml.tpl

@@ -0,0 +1,21 @@
+name: openapi-spec
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  generate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+      - run: npm ci
+      - run: npx trv openapi:spec --format yaml --output openapi.generated.yml
+      - uses: actions/upload-artifact@v4
+        with:
+          name: openapi-spec
+          path: openapi.generated.yml

package/resources/snippets/code/pack-docker-release.yml.tpl

@@ -0,0 +1,21 @@
+name: docker-release
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+      - run: npm ci
+      - run: npx trv pack:docker --tag "$GITHUB_SHA"
+      - run: echo "Publish container image to your registry"

package/resources/snippets/code/project-bootstrap.application.yml.tpl

@@ -0,0 +1,2 @@
+app:
+  name: {{projectName}}

package/resources/snippets/code/project-bootstrap.home-controller.ts.tpl

@@ -0,0 +1,15 @@
+import { Inject } from '@travetto/di';
+import { Controller, Get } from '@travetto/web';
+
+import { HomeService } from '../service/home.ts';
+
+@Controller('/home')
+export class HomeController {
+  @Inject()
+  service: HomeService;
+
+  @Get('/')
+  getHome(): { status: string; message: string } {
+    return { status: 'ok', message: this.service.getMessage() };
+  }
+}

package/resources/snippets/code/project-bootstrap.home-service.ts.tpl

@@ -0,0 +1,8 @@
+import { Injectable } from '@travetto/di';
+
+@Injectable()
+export class HomeService {
+  getMessage(): string {
+    return 'Service is running';
+  }
+}

package/resources/snippets/code/project-bootstrap.monorepo.package.json.tpl

@@ -0,0 +1,12 @@
+{
+  "name": "{{projectName}}",
+  "private": true,
+  "type": "module",
+  "workspaces": [
+    "packages/*"
+  ],
+  "scripts": {
+    "start": "npm run -w {{workspaceName}} start",
+    "test": "npm run -w {{workspaceName}} test"
+  }
+}

package/resources/snippets/code/project-bootstrap.package.json.tpl

@@ -0,0 +1,18 @@
+{
+  "name": "{{projectName}}",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "test": "trv test",
+    "start": "trv web:http"
+  },
+  "dependencies": {
+    "@travetto/di": "^8.0.0-alpha.14",
+    "@travetto/web": "^8.0.0-alpha.16",
+    "@travetto/web-http": "^8.0.0-alpha.17"
+  },
+  "devDependencies": {
+    "@travetto/cli": "^8.0.0-alpha.20",
+    "@travetto/compiler": "^8.0.0-alpha.16"
+  }
+}

package/resources/snippets/code/repo-version-release.yml.tpl

@@ -0,0 +1,25 @@
+name: repo-version-release
+
+on:
+  workflow_dispatch:
+    inputs:
+      mode:
+        description: Release mode
+        required: true
+        default: changed
+      level:
+        description: Semver level
+        required: true
+        default: patch
+
+jobs:
+  version:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+      - run: npm ci
+      - run: npx trv repo:version --mode "${{ inputs.mode }}" --level "${{ inputs.level }}"
+      - run: git status --short

package/resources/snippets/code/rest-rpc-client.client.ts.tpl

@@ -0,0 +1,8 @@
+import { Injectable } from '@travetto/di';
+
+@Injectable()
+export class {{clientName}} {
+  getEndpoint(): string {
+    return '/{{routePath}}';
+  }
+}

package/resources/snippets/code/rest-rpc-client.index.ts.tpl

@@ -0,0 +1 @@
+export { {{clientName}} } from './{{clientFile}}.ts';

package/resources/snippets/code/workflow-cloudfront-deploy.yml.tpl

@@ -0,0 +1,18 @@
+name: Deploy UI (CloudFront)
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+jobs:
+  deploy-ui:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+      - run: npm ci
+      - run: npm run build
+      - run: echo "Sync to S3 and invalidate CloudFront here"

package/resources/snippets/code/workflow-gcp-deploy.yml.tpl

@@ -0,0 +1,18 @@
+name: Deploy API (GCP)
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+jobs:
+  deploy-api:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+      - run: npm ci
+      - run: npm run build
+      - run: echo "Deploy API to GCP here"

package/resources/snippets/core-aws-lambda-package-and-deploy.md

@@ -0,0 +1,21 @@
+<!-- json
+{
+  "sourceId": "core-aws-lambda-package-and-deploy",
+  "repositoryId": "travetto",
+  "filePath": "module/web-aws-lambda/src",
+  "capabilityTags": ["aws", "lambda", "packaging", "deploy"],
+  "operationIds": ["aws-lambda-package-and-deploy"],
+  "applicability": ["framework-native"],
+  "notes": [
+    "Package and deploy Lambda artifacts through CI with explicit environment controls."
+  ]
+}
+-->
+
+# core-aws-lambda-package-and-deploy
+
+- Source: `module/web-aws-lambda/src`
+- Capability tags: aws, lambda, packaging, deploy
+- Applicability: framework-native
+- Notes:
+  - Package and deploy Lambda artifacts through CI with explicit environment controls.

package/resources/snippets/core-email-compiler-pattern.md

@@ -0,0 +1,21 @@
+<!-- json
+{
+  "sourceId": "core-email-compiler-pattern",
+  "repositoryId": "travetto",
+  "filePath": "module/email-compiler/src/service.ts",
+  "capabilityTags": ["email", "compiler", "rendering"],
+  "operationIds": ["email-render-pipeline"],
+  "applicability": ["framework-native"],
+  "notes": [
+    "Reference compiler pipeline for transforming template sources into renderable outputs."
+  ]
+}
+-->
+
+# core-email-compiler-pattern
+
+- Source: `module/email-compiler/src/service.ts`
+- Capability tags: email, compiler, rendering
+- Applicability: framework-native
+- Notes:
+  - Reference compiler pipeline for transforming template sources into renderable outputs.

package/resources/snippets/core-email-module-contract.md

@@ -0,0 +1,21 @@
+<!-- json
+{
+  "sourceId": "core-email-module-contract",
+  "repositoryId": "travetto",
+  "filePath": "module/email/src/types.ts",
+  "capabilityTags": ["email", "template", "contract"],
+  "operationIds": ["email-create-template", "email-context-schema"],
+  "applicability": ["framework-native"],
+  "notes": [
+    "Reference email payload and template contract conventions."
+  ]
+}
+-->
+
+# core-email-module-contract
+
+- Source: `module/email/src/types.ts`
+- Capability tags: email, template, contract
+- Applicability: framework-native
+- Notes:
+  - Reference email payload and template contract conventions.

package/resources/snippets/core-email-nodemailer-provider.md

@@ -0,0 +1,21 @@
+<!-- json
+{
+  "sourceId": "core-email-nodemailer-provider",
+  "repositoryId": "travetto",
+  "filePath": "module/email-nodemailer/src/service.ts",
+  "capabilityTags": ["email", "provider", "transport", "nodemailer"],
+  "operationIds": ["email-transport-provider", "email-send-flow"],
+  "applicability": ["framework-native"],
+  "notes": [
+    "Reference runtime provider wiring and transport integration points."
+  ]
+}
+-->
+
+# core-email-nodemailer-provider
+
+- Source: `module/email-nodemailer/src/service.ts`
+- Capability tags: email, provider, transport, nodemailer
+- Applicability: framework-native
+- Notes:
+  - Reference runtime provider wiring and transport integration points.

package/resources/snippets/core-eslint-ruleset.md

@@ -0,0 +1,21 @@
+<!-- json
+{
+  "sourceId": "core-eslint-ruleset",
+  "repositoryId": "travetto",
+  "filePath": "module/eslint/support/eslint.config.ts",
+  "capabilityTags": ["quality", "lint", "eslint", "fix"],
+  "operationIds": ["enable-linting"],
+  "applicability": ["framework-native"],
+  "notes": [
+    "Reference lint baseline setup and autofix-friendly rule composition."
+  ]
+}
+-->
+
+# core-eslint-ruleset
+
+- Source: `module/eslint/support/eslint.config.ts`
+- Capability tags: quality, lint, eslint, fix
+- Applicability: framework-native
+- Notes:
+  - Reference lint baseline setup and autofix-friendly rule composition.

package/resources/snippets/core-openapi-client-generation.md

@@ -0,0 +1,21 @@
+<!-- json
+{
+  "sourceId": "core-openapi-client-generation",
+  "repositoryId": "travetto",
+  "filePath": "module/openapi/src",
+  "capabilityTags": ["openapi", "client", "generation"],
+  "operationIds": ["openapi-client-generation"],
+  "applicability": ["framework-native"],
+  "notes": [
+    "Regenerate and validate OpenAPI clients in CI when contracts change."
+  ]
+}
+-->
+
+# core-openapi-client-generation
+
+- Source: `module/openapi/src`
+- Capability tags: openapi, client, generation
+- Applicability: framework-native
+- Notes:
+  - Regenerate and validate OpenAPI clients in CI when contracts change.

package/resources/snippets/core-openapi-spec-pipeline.md

@@ -0,0 +1,21 @@
+<!-- json
+{
+  "sourceId": "core-openapi-spec-pipeline",
+  "repositoryId": "travetto",
+  "filePath": "openapi.yml",
+  "capabilityTags": ["openapi", "pipeline", "ci"],
+  "operationIds": ["openapi-spec-pipeline"],
+  "applicability": ["framework-native"],
+  "notes": [
+    "Generate OpenAPI specs in CI and publish them as artifacts for downstream consumption."
+  ]
+}
+-->
+
+# core-openapi-spec-pipeline
+
+- Source: `openapi.yml`
+- Capability tags: openapi, pipeline, ci
+- Applicability: framework-native
+- Notes:
+  - Generate OpenAPI specs in CI and publish them as artifacts for downstream consumption.

package/resources/snippets/core-pack-docker-release.md

@@ -0,0 +1,21 @@
+<!-- json
+{
+  "sourceId": "core-pack-docker-release",
+  "repositoryId": "travetto",
+  "filePath": "module/pack/src",
+  "capabilityTags": ["docker", "pack", "release", "ci"],
+  "operationIds": ["pack-docker-release"],
+  "applicability": ["framework-native"],
+  "notes": [
+    "Build and publish Docker images from Travetto pack:docker in CI workflows."
+  ]
+}
+-->
+
+# core-pack-docker-release
+
+- Source: `module/pack/src`
+- Capability tags: docker, pack, release, ci
+- Applicability: framework-native
+- Notes:
+  - Build and publish Docker images from Travetto pack:docker in CI workflows.

package/resources/snippets/core-repo-version-release.md

@@ -0,0 +1,21 @@
+<!-- json
+{
+  "sourceId": "core-repo-version-release",
+  "repositoryId": "travetto",
+  "filePath": "module/repo/src",
+  "capabilityTags": ["repo", "version", "release", "monorepo"],
+  "operationIds": ["repo-version-release"],
+  "applicability": ["framework-native"],
+  "notes": [
+    "Automate monorepo version updates using repo:version with explicit release inputs."
+  ]
+}
+-->
+
+# core-repo-version-release
+
+- Source: `module/repo/src`
+- Capability tags: repo, version, release, monorepo
+- Applicability: framework-native
+- Notes:
+  - Automate monorepo version updates using repo:version with explicit release inputs.

package/resources/snippets/core-upload-pattern.md

@@ -0,0 +1,21 @@
+<!-- json
+{
+  "sourceId": "core-upload-pattern",
+  "repositoryId": "travetto",
+  "filePath": "module/web-upload/doc/simple-controller.ts",
+  "capabilityTags": ["upload", "web", "controller"],
+  "operationIds": ["enable-file-upload"],
+  "applicability": ["framework-native"],
+  "notes": [
+    "Reference upload decorator and file input handling patterns."
+  ]
+}
+-->
+
+# core-upload-pattern
+
+- Source: `module/web-upload/doc/simple-controller.ts`
+- Capability tags: upload, web, controller
+- Applicability: framework-native
+- Notes:
+  - Reference upload decorator and file input handling patterns.

package/resources/snippets/core-web-controller-pattern.md

@@ -0,0 +1,23 @@
+<!-- json
+{
+  "sourceId": "core-web-controller-pattern",
+  "repositoryId": "travetto",
+  "filePath": "module/web/support/test/suite/controller.ts",
+  "capabilityTags": ["web", "controller", "route", "decorators"],
+  "operationIds": ["create-web-route"],
+  "applicability": ["framework-native"],
+  "notes": [
+    "Reference controller decorator and endpoint parameter binding patterns.",
+    "Use for generated route/controller/service starter output."
+  ]
+}
+-->
+
+# core-web-controller-pattern
+
+- Source: `module/web/support/test/suite/controller.ts`
+- Capability tags: web, controller, route, decorators
+- Applicability: framework-native
+- Notes:
+  - Reference controller decorator and endpoint parameter binding patterns.
+  - Use for generated route/controller/service starter output.

package/resources/snippets/core-work-pool-pattern.md

@@ -0,0 +1,23 @@
+<!-- json
+{
+  "sourceId": "core-work-pool-pattern",
+  "repositoryId": "travetto",
+  "filePath": "module/worker/src/pool.ts",
+  "capabilityTags": ["worker", "async", "workpool"],
+  "operationIds": ["email-send-flow"],
+  "applicability": ["framework-native"],
+  "notes": [
+    "Use for async workload orchestration and progress-aware execution.",
+    "Reference when generating worker-backed send flows."
+  ]
+}
+-->
+
+# core-work-pool-pattern
+
+- Source: `module/worker/src/pool.ts`
+- Capability tags: worker, async, workpool
+- Applicability: framework-native
+- Notes:
+  - Use for async workload orchestration and progress-aware execution.
+  - Reference when generating worker-backed send flows.

package/resources/snippets/embracinglife-cloudfront-deploy.md

@@ -0,0 +1,21 @@
+<!-- json
+{
+  "sourceId": "embracinglife-cloudfront-deploy",
+  "repositoryId": "v2-embracing-life",
+  "filePath": ".github/workflows/deploy-ui.yml",
+  "capabilityTags": ["workflow", "aws", "cloudfront", "s3"],
+  "operationIds": ["workflow-cloudfront-deploy"],
+  "applicability": ["sample-project"],
+  "notes": [
+    "Reference UI deployment sync and invalidation workflow pattern."
+  ]
+}
+-->
+
+# embracinglife-cloudfront-deploy
+
+- Source: `.github/workflows/deploy-ui.yml`
+- Capability tags: workflow, aws, cloudfront, s3
+- Applicability: sample-project
+- Notes:
+  - Reference UI deployment sync and invalidation workflow pattern.

package/resources/snippets/embracinglife-gcp-deploy.md

@@ -0,0 +1,21 @@
+<!-- json
+{
+  "sourceId": "embracinglife-gcp-deploy",
+  "repositoryId": "v2-embracing-life",
+  "filePath": ".github/workflows/deploy-api.yml",
+  "capabilityTags": ["workflow", "gcp", "deploy", "cloud-run"],
+  "operationIds": ["workflow-gcp-deploy"],
+  "applicability": ["sample-project"],
+  "notes": [
+    "Reference Cloud Run deployment workflow structure and artifact push strategy."
+  ]
+}
+-->
+
+# embracinglife-gcp-deploy
+
+- Source: `.github/workflows/deploy-api.yml`
+- Capability tags: workflow, gcp, deploy, cloud-run
+- Applicability: sample-project
+- Notes:
+  - Reference Cloud Run deployment workflow structure and artifact push strategy.

package/resources/snippets/recipe-auth-google-oauth.md

@@ -0,0 +1,21 @@
+<!-- json
+{
+  "sourceId": "recipe-auth-google-oauth",
+  "repositoryId": "recipe-manager",
+  "filePath": "modules/api/src/web/auth.config.ts",
+  "capabilityTags": ["auth", "oauth", "passport", "google"],
+  "operationIds": ["enable-auth-session"],
+  "applicability": ["sample-project"],
+  "notes": [
+    "Reference Google OAuth strategy wiring and principal mapping."
+  ]
+}
+-->
+
+# recipe-auth-google-oauth
+
+- Source: `modules/api/src/web/auth.config.ts`
+- Capability tags: auth, oauth, passport, google
+- Applicability: sample-project
+- Notes:
+  - Reference Google OAuth strategy wiring and principal mapping.

package/resources/snippets/recipe-indexed-model-pattern.md

@@ -0,0 +1,21 @@
+<!-- json
+{
+  "sourceId": "recipe-indexed-model-pattern",
+  "repositoryId": "recipe-manager",
+  "filePath": "modules/api/src/model/recipe.ts",
+  "capabilityTags": ["model", "indexed", "query"],
+  "operationIds": ["model-indexed-assistant", "model-query-assistant"],
+  "applicability": ["sample-project"],
+  "notes": [
+    "Reference sorted/keyed/unique index usage and query-centric model design."
+  ]
+}
+-->
+
+# recipe-indexed-model-pattern
+
+- Source: `modules/api/src/model/recipe.ts`
+- Capability tags: model, indexed, query
+- Applicability: sample-project
+- Notes:
+  - Reference sorted/keyed/unique index usage and query-centric model design.

package/resources/snippets/recipe-upload-presigned.md

@@ -0,0 +1,21 @@
+<!-- json
+{
+  "sourceId": "recipe-upload-presigned",
+  "repositoryId": "recipe-manager",
+  "filePath": "modules/api/src/web/image.ts",
+  "capabilityTags": ["upload", "presigned-url", "blob"],
+  "operationIds": ["enable-file-upload"],
+  "applicability": ["sample-project"],
+  "notes": [
+    "Reference presigned upload URL generation and validation patterns."
+  ]
+}
+-->
+
+# recipe-upload-presigned
+
+- Source: `modules/api/src/web/image.ts`
+- Capability tags: upload, presigned-url, blob
+- Applicability: sample-project
+- Notes:
+  - Reference presigned upload URL generation and validation patterns.

package/resources/snippets/todo-app-test-pattern.md

@@ -0,0 +1,21 @@
+<!-- json
+{
+  "sourceId": "todo-app-test-pattern",
+  "repositoryId": "travetto",
+  "filePath": "related/todo-app/test/service.ts",
+  "capabilityTags": ["test", "suite", "service"],
+  "operationIds": ["generate-test-suite"],
+  "applicability": ["sample-project"],
+  "notes": [
+    "Reference integration-focused suite layout with injected services."
+  ]
+}
+-->
+
+# todo-app-test-pattern
+
+- Source: `related/todo-app/test/service.ts`
+- Capability tags: test, suite, service
+- Applicability: sample-project
+- Notes:
+  - Reference integration-focused suite layout with injected services.