@treeseed/sdk 0.1.1 → 0.3.0

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

@@ -0,0 +1,55 @@
+{
+  "items": [
+    {
+      "id": "starter-basic",
+      "displayName": "TreeSeed Basic",
+      "description": "Opinionated first-party TreeSeed starter for documentation-first teams.",
+      "summary": "A general-purpose starter for Astro, Cloudflare, docs, and the standard Treeseed workflow.",
+      "status": "live",
+      "featured": true,
+      "category": "starter",
+      "audience": [
+        "maintainers",
+        "teams"
+      ],
+      "tags": [
+        "starter",
+        "astro",
+        "cloudflare",
+        "docs"
+      ],
+      "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": {
+        "source": {
+          "kind": "git",
+          "repoUrl": "https://github.com/treeseed-ai/market.git",
+          "directory": "templates/starter-basic",
+          "ref": "main",
+          "integrity": "catalog-fixture"
+        },
+        "hooksPolicy": "builtin_only",
+        "supportsReconcile": true
+      },
+      "offer": {
+        "priceModel": "free",
+        "license": "AGPL-3.0-only",
+        "support": "community"
+      },
+      "relatedBooks": [],
+      "relatedKnowledge": [],
+      "relatedObjectives": []
+    }
+  ],
+  "meta": {
+    "source": "fixture"
+  }
+}

package/dist/treeseed/template-catalog/templates/starter-basic/template/astro.config.d.ts

@@ -0,0 +1,2 @@
+declare const _default: any;
+export default _default;

package/dist/treeseed/template-catalog/templates/starter-basic/template/astro.config.ts

@@ -0,0 +1,3 @@
+import { createTreeseedTenantSite } from '@treeseed/core/config';
+
+export default createTreeseedTenantSite();

package/dist/treeseed/template-catalog/templates/starter-basic/template/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "__SITE_SLUG__",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "packageManager": "npm@11.7.0",
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "setup": "npm install",
+    "setup:ci": "npm ci",
+    "config": "treeseed config",
+    "dev": "treeseed dev",
+    "dev:watch": "treeseed dev --watch",
+    "check": "treeseed check",
+    "build": "treeseed build",
+    "deploy": "treeseed deploy",
+    "preview": "treeseed preview",
+    "sync": "treeseed sync",
+    "verify": "npm run check && npm run build"
+  },
+  "dependencies": {
+    "@treeseed/cli": "__CLI_VERSION__",
+    "@treeseed/core": "__CORE_VERSION__",
+    "yaml": "^2.8.1"
+  },
+  "devDependencies": {
+    "@types/node": "^24.6.0",
+    "typescript": "^5.9.3"
+  }
+}

package/dist/treeseed/template-catalog/templates/starter-basic/template/src/config.yaml

@@ -0,0 +1,40 @@
+site:
+  name: __SITE_NAME__
+  statement: A Treeseed site generated from the basic starter template.
+  siteUrl: __SITE_URL__
+  githubRepository: __REPOSITORY_URL__
+  discordLink: __DISCORD_URL__
+  headerMenu:
+    - label: Learn
+      items:
+        - label: Handbook
+          href: /knowledge/handbook/
+    - label: Build
+      items:
+        - label: Welcome
+          href: /welcome/
+  footerMenu:
+    - label: Project
+      items:
+        - label: Repository
+          href: __REPOSITORY_URL__
+  forms:
+    apiBaseUrl: /api/form/submit
+  emailNotifications:
+    contactRouting:
+      default:
+        - __CONTACT_EMAIL__
+    subscribeRecipients:
+      - __CONTACT_EMAIL__
+  summary: __SITE_NAME__ is a Treeseed site generated from the basic starter.
+  projectStage: Initial build
+  projectStageDetail: Generated from the Treeseed basic starter template.
+models:
+  pages:
+    defaults:
+      pageLayout: article
+      stage: starter
+      audience: []
+  docs:
+    defaults:
+      tags: []

package/dist/treeseed/template-catalog/templates/starter-basic/template/src/content/empty/.gitkeep

@@ -0,0 +1 @@
+

package/dist/treeseed/template-catalog/templates/starter-basic/template/src/content/knowledge/handbook/index.mdx

@@ -0,0 +1,11 @@
+---
+title: Handbook
+description: Starter handbook for the generated Treeseed site.
+tags:
+  - handbook
+  - starter
+---
+
+`__SITE_NAME__` is connected to the Treeseed runtime through `@treeseed/core`.
+
+Use this handbook as the first docs collection entry.

package/dist/treeseed/template-catalog/templates/starter-basic/template/src/content/pages/welcome.mdx

@@ -0,0 +1,11 @@
+---
+title: Welcome
+description: Welcome page for the generated Treeseed starter site.
+slug: welcome
+summary: A starter page proving the tenant content pipeline is wired correctly.
+updated: 2026-04-08
+---
+
+Welcome to `__SITE_NAME__`.
+
+This site was generated from the TreeSeed basic starter.

package/dist/treeseed/template-catalog/templates/starter-basic/template/src/content.config.d.ts

@@ -0,0 +1 @@
+export declare const collections: any;

package/dist/treeseed/template-catalog/templates/starter-basic/template/src/content.config.ts

@@ -0,0 +1,3 @@
+import { createTreeseedTenantCollections } from '@treeseed/core/content-config';
+
+export const collections = createTreeseedTenantCollections();

package/dist/treeseed/template-catalog/templates/starter-basic/template/src/env.yaml

@@ -0,0 +1 @@
+entries: {}

package/dist/treeseed/template-catalog/templates/starter-basic/template/src/manifest.yaml

@@ -0,0 +1,19 @@
+id: __SITE_SLUG__
+siteConfigPath: ./src/config.yaml
+content:
+  docs: ./src/content/knowledge
+  pages: ./src/content/pages
+  notes: ./src/content/empty
+  questions: ./src/content/empty
+  objectives: ./src/content/empty
+  people: ./src/content/empty
+  agents: ./src/content/empty
+  books: ./src/content/empty
+features:
+  docs: true
+  books: false
+  notes: false
+  questions: false
+  objectives: false
+  agents: false
+  forms: false

package/dist/treeseed/template-catalog/templates/starter-basic/template/treeseed.site.yaml

@@ -0,0 +1,26 @@
+name: __SITE_NAME__
+slug: __SITE_SLUG__
+siteUrl: __SITE_URL__
+contactEmail: __CONTACT_EMAIL__
+cloudflare:
+  accountId: replace-with-cloudflare-account-id
+  workerName: __SITE_SLUG__
+plugins:
+  - package: '@treeseed/core/plugin-default'
+providers:
+  forms: store_only
+  agents:
+    execution: stub
+    mutation: local_branch
+    repository: stub
+    verification: stub
+    notification: stub
+    research: stub
+  deploy: cloudflare
+  content:
+    docs: default
+  site: default
+smtp:
+  enabled: false
+turnstile:
+  enabled: false

package/dist/treeseed/template-catalog/templates/starter-basic/template/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "@treeseed/core/tsconfigs/strict",
+  "compilerOptions": {
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "types": ["node"]
+  },
+  "include": ["src/**/*", "astro.config.ts"]
+}

package/dist/treeseed/template-catalog/templates/starter-basic/template.config.json

@@ -0,0 +1,90 @@
+{
+  "schemaVersion": 1,
+  "id": "starter-basic",
+  "displayName": "TreeSeed Basic",
+  "description": "Opinionated first-party TreeSeed starter for documentation-first teams.",
+  "category": "starter",
+  "tags": [
+    "starter",
+    "astro",
+    "cloudflare",
+    "docs"
+  ],
+  "templateVersion": "1.0.0",
+  "templateApiVersion": 1,
+  "minCliVersion": "0.1.1",
+  "minCoreVersion": "0.1.2",
+  "variables": [
+    {
+      "name": "Site name",
+      "token": "__SITE_NAME__",
+      "deriveFrom": "name",
+      "required": true
+    },
+    {
+      "name": "Site slug",
+      "token": "__SITE_SLUG__",
+      "deriveFrom": "slug",
+      "required": true
+    },
+    {
+      "name": "Site URL",
+      "token": "__SITE_URL__",
+      "deriveFrom": "siteUrl",
+      "default": "https://example.com",
+      "required": true
+    },
+    {
+      "name": "Contact email",
+      "token": "__CONTACT_EMAIL__",
+      "deriveFrom": "contactEmail",
+      "default": "hello@example.com",
+      "required": true
+    },
+    {
+      "name": "Repository URL",
+      "token": "__REPOSITORY_URL__",
+      "deriveFrom": "repositoryUrl",
+      "default": "https://github.com/example/site"
+    },
+    {
+      "name": "Discord URL",
+      "token": "__DISCORD_URL__",
+      "deriveFrom": "discordUrl",
+      "default": "https://discord.gg/example"
+    },
+    {
+      "name": "CLI version",
+      "token": "__CLI_VERSION__",
+      "deriveFrom": "cliVersion",
+      "required": true
+    },
+    {
+      "name": "Core version",
+      "token": "__CORE_VERSION__",
+      "deriveFrom": "coreVersion",
+      "required": true
+    }
+  ],
+  "managedSurface": {
+    "coreManaged": [
+      "package.json",
+      "astro.config.ts",
+      "tsconfig.json",
+      "treeseed.site.yaml",
+      "src/content.config.ts",
+      "src/config.yaml",
+      "src/manifest.yaml",
+      "src/env.yaml"
+    ],
+    "validatedOnly": [
+      "treeseed.site.yaml",
+      "src/config.yaml",
+      "src/manifest.yaml",
+      "src/env.yaml"
+    ]
+  },
+  "testing": {
+    "buildCommand": "npm run build"
+  }
+}

package/dist/verification.d.ts

@@ -0,0 +1,20 @@
+export type TreeseedVerifyDriver = 'auto' | 'act' | 'direct';
+export type TreeseedVerifyDriverOptions = {
+    packageRoot?: string;
+    driver?: TreeseedVerifyDriver;
+    eventName?: string;
+    write?: (message: string, stream?: 'stdout' | 'stderr') => void;
+};
+export type TreeseedVerifyDriverStatus = {
+    packageRoot: string;
+    workflowPath: string;
+    driver: TreeseedVerifyDriver;
+    eventName: string;
+    inGitHubActions: boolean;
+    workflowPresent: boolean;
+    ghActAvailable: boolean;
+    dockerAvailable: boolean;
+    canUseAct: boolean;
+};
+export declare function getTreeseedVerifyDriverStatus(options?: TreeseedVerifyDriverOptions): TreeseedVerifyDriverStatus;
+export declare function runTreeseedVerifyDriver(options?: TreeseedVerifyDriverOptions): number;

package/dist/verification.js

@@ -0,0 +1,98 @@
+import { existsSync } from "node:fs";
+import { spawnSync } from "node:child_process";
+import { basename, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+function defaultWrite(message, stream = "stdout") {
+  if (!message) return;
+  (stream === "stderr" ? process.stderr : process.stdout).write(`${message}
+`);
+}
+function run(command, args, cwd) {
+  const result = spawnSync(command, args, {
+    cwd,
+    env: process.env,
+    stdio: "inherit"
+  });
+  return result.status ?? 1;
+}
+function check(command, args, cwd) {
+  const result = spawnSync(command, args, {
+    cwd,
+    env: process.env,
+    stdio: "pipe",
+    encoding: "utf8"
+  });
+  return {
+    ok: result.status === 0,
+    detail: `${result.stderr ?? ""}
+${result.stdout ?? ""}`.trim()
+  };
+}
+function getTreeseedVerifyDriverStatus(options = {}) {
+  const packageRoot = resolve(options.packageRoot ?? process.cwd());
+  const workflowPath = resolve(packageRoot, ".github", "workflows", "verify.yml");
+  const driver = options.driver ?? process.env.TREESEED_VERIFY_DRIVER ?? "auto";
+  const eventName = options.eventName ?? process.env.TREESEED_VERIFY_EVENT ?? "workflow_dispatch";
+  const inGitHubActions = process.env.GITHUB_ACTIONS === "true";
+  const workflowPresent = existsSync(workflowPath);
+  const ghAct = check("gh", ["act", "--version"], packageRoot);
+  const docker = check("docker", ["info"], packageRoot);
+  return {
+    packageRoot,
+    workflowPath,
+    driver,
+    eventName,
+    inGitHubActions,
+    workflowPresent,
+    ghActAvailable: ghAct.ok,
+    dockerAvailable: docker.ok,
+    canUseAct: workflowPresent && ghAct.ok && docker.ok
+  };
+}
+function runTreeseedVerifyDriver(options = {}) {
+  const write = options.write ?? defaultWrite;
+  const status = getTreeseedVerifyDriverStatus(options);
+  if (status.driver === "direct" || status.inGitHubActions) {
+    return run("npm", ["run", "verify:direct"], status.packageRoot);
+  }
+  if (status.driver === "act") {
+    if (!status.workflowPresent) {
+      write(`Treeseed verify requires ${status.workflowPath} when TREESEED_VERIFY_DRIVER=act.`, "stderr");
+      return 1;
+    }
+    if (!status.ghActAvailable) {
+      const detail = check("gh", ["act", "--version"], status.packageRoot).detail;
+      write(detail || "Treeseed verify requires `gh act` when TREESEED_VERIFY_DRIVER=act.", "stderr");
+      return 1;
+    }
+    if (!status.dockerAvailable) {
+      const detail = check("docker", ["info"], status.packageRoot).detail;
+      write(detail || "Treeseed verify requires a running Docker daemon when TREESEED_VERIFY_DRIVER=act.", "stderr");
+      return 1;
+    }
+    return run("gh", ["act", status.eventName, "-W", ".github/workflows/verify.yml", "-j", "verify"], status.packageRoot);
+  }
+  if (status.canUseAct) {
+    return run("gh", ["act", status.eventName, "-W", ".github/workflows/verify.yml", "-j", "verify"], status.packageRoot);
+  }
+  if (!status.workflowPresent) {
+    write("Treeseed verify warning: package-local verify workflow is missing; falling back to verify:direct.", "stderr");
+  } else if (!status.ghActAvailable) {
+    write("Treeseed verify warning: `gh act` is unavailable; falling back to verify:direct.", "stderr");
+  } else if (!status.dockerAvailable) {
+    write("Treeseed verify warning: Docker is unavailable; falling back to verify:direct.", "stderr");
+  }
+  return run("npm", ["run", "verify:direct"], status.packageRoot);
+}
+const invokedPath = process.argv[1] ? resolve(process.argv[1]) : "";
+const invokedBasename = basename(invokedPath);
+const modulePath = fileURLToPath(import.meta.url);
+const moduleBasename = basename(modulePath);
+const invokedAsVerificationEntrypoint = invokedPath === modulePath || /^verification\.(?:ts|js|mjs|cjs)$/.test(invokedBasename) || invokedBasename === moduleBasename;
+if (invokedAsVerificationEntrypoint) {
+  process.exit(runTreeseedVerifyDriver());
+}
+export {
+  getTreeseedVerifyDriverStatus,
+  runTreeseedVerifyDriver
+};