@treeseed/sdk 0.10.23 → 0.10.25

package/dist/treeseed/template-catalog/catalog.fixture.json

@@ -47,6 +47,483 @@
       "relatedBooks": [],
       "relatedKnowledge": [],
       "relatedObjectives": []
+    },
+    {
+      "id": "starter-research",
+      "displayName": "TreeSeed Research",
+      "description": "First-party TreeSeed starter for freestanding research projects and knowledge-pack publishing.",
+      "summary": "A research starter for building source-backed books, gathered assets, synthesis notes, and reusable knowledge packs.",
+      "status": "live",
+      "featured": true,
+      "category": "starter",
+      "audience": [
+        "researchers",
+        "maintainers"
+      ],
+      "tags": [
+        "starter",
+        "research",
+        "books",
+        "knowledge-packs",
+        "agents"
+      ],
+      "publisher": {
+        "id": "treeseed",
+        "name": "TreeSeed",
+        "url": "https://treeseed.ai"
+      },
+      "publisherVerified": true,
+      "templateVersion": "1.0.0",
+      "templateApiVersion": 1,
+      "minCliVersion": "0.1.1",
+      "minCoreVersion": "0.1.2",
+      "fulfillment": {
+        "mode": "git",
+        "source": {
+          "kind": "git",
+          "repoUrl": "https://github.com/treeseed-ai/starter-research.git",
+          "directory": ".",
+          "ref": "staging",
+          "integrity": "pending-external-repo"
+        },
+        "hooksPolicy": "builtin_only",
+        "supportsReconcile": true
+      },
+      "offer": {
+        "priceModel": "free",
+        "license": "AGPL-3.0-only",
+        "support": "community"
+      },
+      "launchRequirements": {
+        "version": 1,
+        "hosts": [
+          {
+            "kind": "host",
+            "key": "sourceRepository",
+            "type": "repository",
+            "required": true,
+            "compatibleProviders": ["github"],
+            "displayName": "Source repository",
+            "purpose": "Create and push the generated research project repository.",
+            "defaultSelection": "team-default",
+            "configWrites": [
+              { "target": "treeseed.site.yaml", "path": "hosting.hostBindings.sourceRepository.provider", "valueFrom": "selectedHost.provider" },
+              { "target": "treeseed.site.yaml", "path": "hosting.hostBindings.sourceRepository.owner", "valueFrom": "selectedHost.github.owner" },
+              { "target": "treeseed.site.yaml", "path": "hosting.hostBindings.sourceRepository.repository", "valueFrom": "derived.repositoryName" }
+            ],
+            "environmentWrites": [
+              { "env": "GITHUB_TOKEN", "valueFrom": "selectedHost.token", "targets": ["github-secret"], "scopes": ["staging", "prod"], "sensitivity": "secret" }
+            ]
+          },
+          {
+            "kind": "host",
+            "key": "publicWeb",
+            "type": "web",
+            "required": true,
+            "compatibleProviders": ["cloudflare"],
+            "displayName": "Public web host",
+            "purpose": "Deploy the research site, previews, content storage, and web runtime resources.",
+            "defaultSelection": "managed",
+            "configWrites": [
+              { "target": "treeseed.site.yaml", "path": "hosting.hostBindings.publicWeb.provider", "valueFrom": "selectedHost.provider" },
+              { "target": "treeseed.site.yaml", "path": "surfaces.web.provider", "valueFrom": "selectedHost.provider" },
+              { "target": "treeseed.site.yaml", "path": "surfaces.web.environments.prod.domain", "valueFrom": "launchInput.domains.productionDomain", "writeWhen": "host-selected" },
+              { "target": "treeseed.site.yaml", "path": "surfaces.web.environments.staging.domain", "valueFrom": "launchInput.domains.stagingDomain", "writeWhen": "host-selected" }
+            ],
+            "environmentWrites": [
+              { "env": "TREESEED_PUBLIC_WEB_PROVIDER", "valueFrom": "selectedHost.provider", "targets": ["github-variable", "cloudflare-var"], "scopes": ["staging", "prod"], "sensitivity": "plain" }
+            ]
+          },
+          {
+            "kind": "host",
+            "key": "transactionalEmail",
+            "type": "email",
+            "required": false,
+            "compatibleProviders": ["smtp"],
+            "displayName": "Transactional email",
+            "purpose": "Send form, account, and research project notification email.",
+            "defaultSelection": "managed",
+            "configWrites": [
+              { "target": "treeseed.site.yaml", "path": "hosting.hostBindings.transactionalEmail.provider", "valueFrom": "selectedHost.provider", "writeWhen": "host-selected" }
+            ],
+            "environmentWrites": [
+              { "env": "SMTP_HOST", "valueFrom": "selectedHost.smtpHost", "targets": ["github-secret", "railway-secret"], "scopes": ["staging", "prod"], "sensitivity": "secret" }
+            ]
+          }
+        ]
+      },
+      "relatedBooks": [],
+      "relatedKnowledge": [],
+      "relatedObjectives": []
+    },
+    {
+      "id": "starter-engineering",
+      "displayName": "TreeSeed Engineering",
+      "description": "First-party TreeSeed starter for integrated software guidance, docs, and engineering agents.",
+      "summary": "An engineering starter for guiding software projects with research, architecture, implementation, review, and release agents.",
+      "status": "live",
+      "featured": true,
+      "category": "starter",
+      "audience": [
+        "engineers",
+        "maintainers"
+      ],
+      "tags": [
+        "starter",
+        "engineering",
+        "software",
+        "docs",
+        "agents"
+      ],
+      "publisher": {
+        "id": "treeseed",
+        "name": "TreeSeed",
+        "url": "https://treeseed.ai"
+      },
+      "publisherVerified": true,
+      "templateVersion": "1.0.0",
+      "templateApiVersion": 1,
+      "minCliVersion": "0.1.1",
+      "minCoreVersion": "0.1.2",
+      "fulfillment": {
+        "mode": "git",
+        "source": {
+          "kind": "git",
+          "repoUrl": "https://github.com/treeseed-ai/starter-engineering.git",
+          "directory": ".",
+          "ref": "staging",
+          "integrity": "pending-external-repo"
+        },
+        "hooksPolicy": "builtin_only",
+        "supportsReconcile": true
+      },
+      "offer": {
+        "priceModel": "free",
+        "license": "AGPL-3.0-only",
+        "support": "community"
+      },
+      "launchRequirements": {
+        "version": 1,
+        "hosts": [
+          {
+            "kind": "host",
+            "key": "sourceRepository",
+            "type": "repository",
+            "required": true,
+            "compatibleProviders": ["github"],
+            "displayName": "Source repository",
+            "purpose": "Create and push the generated engineering project repository.",
+            "defaultSelection": "team-default",
+            "configWrites": [
+              { "target": "treeseed.site.yaml", "path": "hosting.hostBindings.sourceRepository.provider", "valueFrom": "selectedHost.provider" },
+              { "target": "treeseed.site.yaml", "path": "hosting.hostBindings.sourceRepository.owner", "valueFrom": "selectedHost.github.owner" },
+              { "target": "treeseed.site.yaml", "path": "hosting.hostBindings.sourceRepository.repository", "valueFrom": "derived.repositoryName" }
+            ],
+            "environmentWrites": [
+              { "env": "GITHUB_TOKEN", "valueFrom": "selectedHost.token", "targets": ["github-secret"], "scopes": ["staging", "prod"], "sensitivity": "secret" }
+            ]
+          },
+          {
+            "kind": "host",
+            "key": "publicWeb",
+            "type": "web",
+            "required": true,
+            "compatibleProviders": ["cloudflare"],
+            "displayName": "Public web host",
+            "purpose": "Deploy the engineering site, previews, content storage, and web runtime resources.",
+            "defaultSelection": "managed",
+            "configWrites": [
+              { "target": "treeseed.site.yaml", "path": "hosting.hostBindings.publicWeb.provider", "valueFrom": "selectedHost.provider" },
+              { "target": "treeseed.site.yaml", "path": "surfaces.web.provider", "valueFrom": "selectedHost.provider" },
+              { "target": "treeseed.site.yaml", "path": "surfaces.web.environments.prod.domain", "valueFrom": "launchInput.domains.productionDomain", "writeWhen": "host-selected" },
+              { "target": "treeseed.site.yaml", "path": "surfaces.web.environments.staging.domain", "valueFrom": "launchInput.domains.stagingDomain", "writeWhen": "host-selected" }
+            ],
+            "environmentWrites": [
+              { "env": "TREESEED_PUBLIC_WEB_PROVIDER", "valueFrom": "selectedHost.provider", "targets": ["github-variable", "cloudflare-var"], "scopes": ["staging", "prod"], "sensitivity": "plain" }
+            ]
+          },
+          {
+            "kind": "host",
+            "key": "transactionalEmail",
+            "type": "email",
+            "required": false,
+            "compatibleProviders": ["smtp"],
+            "displayName": "Transactional email",
+            "purpose": "Send form, account, and engineering project notification email.",
+            "defaultSelection": "managed",
+            "configWrites": [
+              { "target": "treeseed.site.yaml", "path": "hosting.hostBindings.transactionalEmail.provider", "valueFrom": "selectedHost.provider", "writeWhen": "host-selected" }
+            ],
+            "environmentWrites": [
+              { "env": "SMTP_HOST", "valueFrom": "selectedHost.smtpHost", "targets": ["github-secret", "railway-secret"], "scopes": ["staging", "prod"], "sensitivity": "secret" }
+            ]
+          }
+        ]
+      },
+      "relatedBooks": [],
+      "relatedKnowledge": [],
+      "relatedObjectives": []
+    },
+    {
+      "id": "starter-information-hub",
+      "displayName": "TreeSeed Information Hub",
+      "description": "First-party TreeSeed starter for recurring information retrieval, distillation, and downstream distribution.",
+      "summary": "An information distribution starter for retrieving updates over time, distilling derived knowledge, and packaging it for downstream projects.",
+      "status": "live",
+      "featured": true,
+      "category": "starter",
+      "audience": [
+        "curators",
+        "maintainers"
+      ],
+      "tags": [
+        "starter",
+        "information-hub",
+        "distribution",
+        "knowledge-packs",
+        "agents"
+      ],
+      "publisher": {
+        "id": "treeseed",
+        "name": "TreeSeed",
+        "url": "https://treeseed.ai"
+      },
+      "publisherVerified": true,
+      "templateVersion": "1.0.0",
+      "templateApiVersion": 1,
+      "minCliVersion": "0.1.1",
+      "minCoreVersion": "0.1.2",
+      "fulfillment": {
+        "mode": "git",
+        "source": {
+          "kind": "git",
+          "repoUrl": "https://github.com/treeseed-ai/starter-information-hub.git",
+          "directory": ".",
+          "ref": "staging",
+          "integrity": "pending-external-repo"
+        },
+        "hooksPolicy": "builtin_only",
+        "supportsReconcile": true
+      },
+      "offer": {
+        "priceModel": "free",
+        "license": "AGPL-3.0-only",
+        "support": "community"
+      },
+      "launchRequirements": {
+        "version": 1,
+        "hosts": [
+          {
+            "kind": "host",
+            "key": "sourceRepository",
+            "type": "repository",
+            "required": true,
+            "compatibleProviders": ["github"],
+            "displayName": "Source repository",
+            "purpose": "Create and push the generated information hub project repository.",
+            "defaultSelection": "team-default",
+            "configWrites": [
+              { "target": "treeseed.site.yaml", "path": "hosting.hostBindings.sourceRepository.provider", "valueFrom": "selectedHost.provider" },
+              { "target": "treeseed.site.yaml", "path": "hosting.hostBindings.sourceRepository.owner", "valueFrom": "selectedHost.github.owner" },
+              { "target": "treeseed.site.yaml", "path": "hosting.hostBindings.sourceRepository.repository", "valueFrom": "derived.repositoryName" }
+            ],
+            "environmentWrites": [
+              { "env": "GITHUB_TOKEN", "valueFrom": "selectedHost.token", "targets": ["github-secret"], "scopes": ["staging", "prod"], "sensitivity": "secret" }
+            ]
+          },
+          {
+            "kind": "host",
+            "key": "publicWeb",
+            "type": "web",
+            "required": true,
+            "compatibleProviders": ["cloudflare"],
+            "displayName": "Public web host",
+            "purpose": "Deploy the information hub site, previews, content storage, and web runtime resources.",
+            "defaultSelection": "managed",
+            "configWrites": [
+              { "target": "treeseed.site.yaml", "path": "hosting.hostBindings.publicWeb.provider", "valueFrom": "selectedHost.provider" },
+              { "target": "treeseed.site.yaml", "path": "surfaces.web.provider", "valueFrom": "selectedHost.provider" },
+              { "target": "treeseed.site.yaml", "path": "surfaces.web.environments.prod.domain", "valueFrom": "launchInput.domains.productionDomain", "writeWhen": "host-selected" },
+              { "target": "treeseed.site.yaml", "path": "surfaces.web.environments.staging.domain", "valueFrom": "launchInput.domains.stagingDomain", "writeWhen": "host-selected" }
+            ],
+            "environmentWrites": [
+              { "env": "TREESEED_PUBLIC_WEB_PROVIDER", "valueFrom": "selectedHost.provider", "targets": ["github-variable", "cloudflare-var"], "scopes": ["staging", "prod"], "sensitivity": "plain" }
+            ]
+          },
+          {
+            "kind": "host",
+            "key": "transactionalEmail",
+            "type": "email",
+            "required": false,
+            "compatibleProviders": ["smtp"],
+            "displayName": "Transactional email",
+            "purpose": "Send form, account, and information hub project notification email.",
+            "defaultSelection": "managed",
+            "configWrites": [
+              { "target": "treeseed.site.yaml", "path": "hosting.hostBindings.transactionalEmail.provider", "valueFrom": "selectedHost.provider", "writeWhen": "host-selected" }
+            ],
+            "environmentWrites": [
+              { "env": "SMTP_HOST", "valueFrom": "selectedHost.smtpHost", "targets": ["github-secret", "railway-secret"], "scopes": ["staging", "prod"], "sensitivity": "secret" }
+            ]
+          }
+        ]
+      },
+      "relatedBooks": [],
+      "relatedKnowledge": [],
+      "relatedObjectives": []
+    },
+    {
+      "id": "market-control-plane",
+      "displayName": "TreeSeed Market Control Plane",
+      "description": "Draft first-party template requirements for deploying the TreeSeed Market control plane with dynamic host and Railway resource selection.",
+      "summary": "A draft control-plane template that models the Market web/API, operations runner, and PostgreSQL resource roles without hardcoded provider accounts.",
+      "status": "draft",
+      "featured": false,
+      "category": "reference-app",
+      "audience": [
+        "operators",
+        "platform-teams"
+      ],
+      "tags": [
+        "market",
+        "control-plane",
+        "railway",
+        "postgres",
+        "operations-runner"
+      ],
+      "publisher": {
+        "id": "treeseed",
+        "name": "TreeSeed",
+        "url": "https://treeseed.ai"
+      },
+      "publisherVerified": true,
+      "templateVersion": "0.1.0",
+      "templateApiVersion": 1,
+      "minCliVersion": "0.1.1",
+      "minCoreVersion": "0.1.2",
+      "fulfillment": {
+        "mode": "git",
+        "source": {
+          "kind": "git",
+          "repoUrl": "https://github.com/treeseed-ai/market.git",
+          "directory": ".",
+          "ref": "main",
+          "integrity": "draft-requirements-only"
+        },
+        "hooksPolicy": "builtin_only",
+        "supportsReconcile": true
+      },
+      "offer": {
+        "priceModel": "free",
+        "license": "AGPL-3.0-only",
+        "support": "community"
+      },
+      "launchRequirements": {
+        "version": 1,
+        "hosts": [
+          {
+            "kind": "host",
+            "key": "sourceRepository",
+            "type": "repository",
+            "required": true,
+            "compatibleProviders": ["github"],
+            "displayName": "Source repository",
+            "purpose": "Create and push the Market control-plane repository.",
+            "defaultSelection": "team-default",
+            "configWrites": [
+              { "target": "treeseed.site.yaml", "path": "hosting.hostBindings.sourceRepository.provider", "valueFrom": "selectedHost.provider" },
+              { "target": "treeseed.site.yaml", "path": "hosting.hostBindings.sourceRepository.owner", "valueFrom": "selectedHost.github.owner" },
+              { "target": "treeseed.site.yaml", "path": "hosting.hostBindings.sourceRepository.repository", "valueFrom": "derived.repositoryName" }
+            ],
+            "environmentWrites": [
+              { "env": "GITHUB_TOKEN", "valueFrom": "selectedHost.token", "targets": ["github-secret"], "scopes": ["staging", "prod"], "sensitivity": "secret" }
+            ]
+          },
+          {
+            "kind": "host",
+            "key": "publicWeb",
+            "type": "web",
+            "required": true,
+            "compatibleProviders": ["cloudflare"],
+            "displayName": "Public web host",
+            "purpose": "Deploy the Market web surface and public control-plane routes.",
+            "defaultSelection": "managed",
+            "configWrites": [
+              { "target": "treeseed.site.yaml", "path": "hosting.hostBindings.publicWeb.provider", "valueFrom": "selectedHost.provider" },
+              { "target": "treeseed.site.yaml", "path": "hosting.kind", "valueFrom": "literal.market_control_plane" },
+              { "target": "treeseed.site.yaml", "path": "surfaces.web.provider", "valueFrom": "selectedHost.provider" },
+              { "target": "treeseed.site.yaml", "path": "surfaces.web.environments.prod.domain", "valueFrom": "launchInput.domains.productionDomain", "writeWhen": "host-selected" },
+              { "target": "treeseed.site.yaml", "path": "surfaces.web.environments.staging.domain", "valueFrom": "launchInput.domains.stagingDomain", "writeWhen": "host-selected" }
+            ],
+            "environmentWrites": [
+              { "env": "TREESEED_PUBLIC_WEB_PROVIDER", "valueFrom": "selectedHost.provider", "targets": ["github-variable", "cloudflare-var"], "scopes": ["staging", "prod"], "sensitivity": "plain" }
+            ]
+          }
+        ],
+        "resources": [
+          {
+            "kind": "resource",
+            "key": "marketDatabase",
+            "type": "database",
+            "required": true,
+            "compatibleProviders": ["railway-postgres"],
+            "displayName": "Market database",
+            "purpose": "Provide the PostgreSQL database used by the Market API control plane.",
+            "configWrites": [
+              { "target": "treeseed.site.yaml", "path": "services.marketDatabase.enabled", "valueFrom": "literal.true" },
+              { "target": "treeseed.site.yaml", "path": "services.marketDatabase.provider", "valueFrom": "literal.railway" },
+              { "target": "treeseed.site.yaml", "path": "services.marketDatabase.railway.resourceType", "valueFrom": "literal.postgres" },
+              { "target": "treeseed.site.yaml", "path": "services.marketDatabase.railway.serviceName", "valueFrom": "selectedResource.configValues.serviceName" },
+              { "target": "treeseed.site.yaml", "path": "services.marketDatabase.railway.environmentVariable", "valueFrom": "literal.TREESEED_MARKET_DATABASE_URL" }
+            ],
+            "environmentWrites": [
+              { "env": "TREESEED_MARKET_DATABASE_URL", "valueFrom": "selectedResource.secretRefs.databaseUrl", "targets": ["github-secret", "railway-secret"], "scopes": ["staging", "prod"], "sensitivity": "secret" }
+            ]
+          },
+          {
+            "kind": "resource",
+            "key": "api",
+            "type": "service",
+            "required": true,
+            "compatibleProviders": ["railway"],
+            "displayName": "Market API service",
+            "purpose": "Run the Market API service that serves the control-plane routes.",
+            "configWrites": [
+              { "target": "treeseed.site.yaml", "path": "services.api.enabled", "valueFrom": "literal.true" },
+              { "target": "treeseed.site.yaml", "path": "services.api.provider", "valueFrom": "literal.railway" },
+              { "target": "treeseed.site.yaml", "path": "services.api.railway.serviceName", "valueFrom": "selectedResource.configValues.serviceName" },
+              { "target": "treeseed.site.yaml", "path": "services.api.railway.rootDirectory", "valueFrom": "literal." },
+              { "target": "treeseed.site.yaml", "path": "services.api.railway.startCommand", "valueFrom": "literal.node dist/api/server.js" }
+            ],
+            "environmentWrites": [
+              { "env": "TREESEED_MARKET_DATABASE_URL", "valueFrom": "selectedResource.secretRefs.databaseUrl", "targets": ["railway-secret"], "scopes": ["staging", "prod"], "sensitivity": "secret" }
+            ]
+          },
+          {
+            "kind": "resource",
+            "key": "marketOperationsRunner",
+            "type": "service",
+            "required": true,
+            "compatibleProviders": ["railway"],
+            "displayName": "Market operations runner",
+            "purpose": "Run the governed Market operations runner for queued control-plane operations.",
+            "configWrites": [
+              { "target": "treeseed.site.yaml", "path": "services.marketOperationsRunner.enabled", "valueFrom": "literal.true" },
+              { "target": "treeseed.site.yaml", "path": "services.marketOperationsRunner.provider", "valueFrom": "literal.railway" },
+              { "target": "treeseed.site.yaml", "path": "services.marketOperationsRunner.railway.serviceName", "valueFrom": "selectedResource.configValues.serviceName" },
+              { "target": "treeseed.site.yaml", "path": "services.marketOperationsRunner.railway.startCommand", "valueFrom": "literal.node dist/market-operations-runner/runner.js" }
+            ],
+            "environmentWrites": [
+              { "env": "TREESEED_MARKET_DATABASE_URL", "valueFrom": "selectedResource.secretRefs.databaseUrl", "targets": ["railway-secret"], "scopes": ["staging", "prod"], "sensitivity": "secret" },
+              { "env": "TREESEED_PLATFORM_RUNNER_TOKEN", "valueFrom": "selectedResource.secretRefs.runnerToken", "targets": ["railway-secret"], "scopes": ["staging", "prod"], "sensitivity": "secret" },
+              { "env": "TREESEED_PLATFORM_RUNNER_ID", "valueFrom": "selectedResource.environmentValues.runnerId", "targets": ["railway-var"], "scopes": ["staging", "prod"], "sensitivity": "plain" }
+            ]
+          }
+        ]
+      },
+      "relatedBooks": [],
+      "relatedKnowledge": [],
+      "relatedObjectives": []
     }
   ],
   "meta": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@treeseed/sdk",
-  "version": "0.10.23",
+  "version": "0.10.25",
   "description": "Shared Treeseed SDK for content-backed and D1-backed object models.",
   "license": "AGPL-3.0-only",
   "repository": {
@@ -198,6 +198,18 @@
       "types": "./dist/template-catalog.d.ts",
       "default": "./dist/template-catalog.js"
     },
+    "./template-launch-requirements": {
+      "types": "./dist/template-launch-requirements.d.ts",
+      "default": "./dist/template-launch-requirements.js"
+    },
+    "./template-launch-ui": {
+      "types": "./dist/template-launch-ui.d.ts",
+      "default": "./dist/template-launch-ui.js"
+    },
+    "./template-secret-sync": {
+      "types": "./dist/operations/services/template-secret-sync.d.ts",
+      "default": "./dist/operations/services/template-secret-sync.js"
+    },
     "./d1-store": {
       "types": "./dist/d1-store.d.ts",
       "default": "./dist/d1-store.js"

package/templates/github/deploy-web.workflow.yml

@@ -120,7 +120,11 @@ __WORKING_DIRECTORY_BLOCK__  web:
         shell: bash
         run: |
           set -euo pipefail
+          TIMING_SUMMARY="${RUNNER_TEMP:-/tmp}/treeseed-provider-timing.md"
+          : > "${TIMING_SUMMARY}"
+          export TREESEED_PROVIDER_TIMING_SUMMARY_PATH="${TIMING_SUMMARY}"
           EXTRA_ARGS=()
           if [[ -n "${TREESEED_WORKFLOW_PROJECT:-}" ]]; then EXTRA_ARGS+=(--project-id "${TREESEED_WORKFLOW_PROJECT}"); fi
           if [[ -n "${TREESEED_WORKFLOW_PREVIEW_ID:-}" ]]; then EXTRA_ARGS+=(--preview-id "${TREESEED_WORKFLOW_PREVIEW_ID}"); fi
           node ./packages/sdk/scripts/run-ts.mjs ./packages/sdk/scripts/tenant-workflow-action.ts --action "${TREESEED_WORKFLOW_ACTION}" --environment "${TREESEED_WORKFLOW_ENVIRONMENT}" "${EXTRA_ARGS[@]}"
+          if [[ -n "${GITHUB_STEP_SUMMARY:-}" && -s "${TIMING_SUMMARY}" ]]; then cat "${TIMING_SUMMARY}" >> "${GITHUB_STEP_SUMMARY}"; fi