@treeseed/sdk 0.4.13 → 0.5.1

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

@@ -9,6 +9,10 @@ site:
       items:
         - label: Handbook
           href: /knowledge/handbook/
+        - label: Proposals
+          href: /proposals/
+        - label: Decisions
+          href: /decisions/
     - label: Build
       items:
         - label: Welcome
@@ -38,3 +42,24 @@ models:
   docs:
     defaults:
       tags: []
+  notes:
+    defaults:
+      author: __SITE_NAME__
+      draft: false
+      tags: []
+  questions:
+    defaults:
+      draft: false
+      tags: []
+  objectives:
+    defaults:
+      draft: false
+      tags: []
+  proposals:
+    defaults:
+      draft: false
+      tags: []
+  decisions:
+    defaults:
+      draft: false
+      tags: []

package/dist/treeseed/template-catalog/templates/starter-basic/template/src/content/decisions/adopt-initial-proposal-loop.mdx

@@ -0,0 +1,22 @@
+---
+id: decision:adopt-initial-proposal-loop
+title: Adopt The Initial Proposal Loop
+description: Seed the starter with a decision record alongside the initial proposal.
+date: 2026-04-17
+summary: The starter demonstrates that decisions are first-class records, not hidden implementation residue.
+status: live
+decisionType: approved
+rationale: Teams benefit from a visible pattern for recording what was chosen and why.
+authority: Starter template
+primaryContributor: starter-steward
+relatedObjectives: []
+relatedQuestions: []
+relatedNotes: []
+relatedProposals:
+  - establish-initial-proposal-loop
+relatedBooks: []
+implements:
+  - starter
+---
+
+This starter decision exists to make the proposal-to-decision loop visible in a freshly generated TreeSeed site.

package/dist/treeseed/template-catalog/templates/starter-basic/template/src/content/people/starter-steward.mdx

@@ -0,0 +1,11 @@
+---
+name: Starter Steward
+role: Maintainer
+affiliation: Starter template
+status: live
+tags:
+  - stewardship
+  - starter
+---
+
+This placeholder profile exists so the starter can model contributor-linked content from the first commit.

package/dist/treeseed/template-catalog/templates/starter-basic/template/src/content/proposals/establish-initial-proposal-loop.mdx

@@ -0,0 +1,17 @@
+---
+id: proposal:establish-initial-proposal-loop
+title: Establish The Initial Proposal Loop
+description: Seed the starter with a proposal so suggested changes are explicit from day one.
+date: 2026-04-17
+summary: The starter should show how a team can move from questions and objectives into a concrete proposal.
+status: live
+proposalType: strategy
+motivation: New sites should inherit a visible proposal-to-decision pattern instead of recreating it ad hoc.
+primaryContributor: starter-steward
+relatedObjectives: []
+relatedQuestions: []
+relatedNotes: []
+relatedBooks: []
+---
+
+Use this starter proposal as a placeholder for the first concrete change a team wants to make in its site or operating model.

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

@@ -3,17 +3,24 @@ 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
+  notes: ./src/content/notes
+  questions: ./src/content/questions
+  objectives: ./src/content/objectives
+  proposals: ./src/content/proposals
+  decisions: ./src/content/decisions
+  people: ./src/content/people
+  agents: ./src/content/agents
+  books: ./src/content/books
+  templates: ./src/content/templates
+  knowledge_packs: ./src/content/knowledge-packs
+  workdays: ./src/content/workdays
 features:
   docs: true
   books: false
-  notes: false
-  questions: false
-  objectives: false
-  agents: false
+  notes: true
+  questions: true
+  objectives: true
+  proposals: true
+  decisions: true
+  agents: true
   forms: false

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

@@ -5,12 +5,14 @@ contactEmail: __CONTACT_EMAIL__
 hosting:
   kind: hosted_project
   registration: optional
-  marketBaseUrl: https://api.treeseed.ai
+  marketBaseUrl: https://knowledge.coop
   teamId: __SITE_SLUG__
   projectId: __SITE_SLUG__
 cloudflare:
   accountId: replace-with-cloudflare-account-id
   workerName: __SITE_SLUG__
+  queueName: __SITE_SLUG__-agent-work
+  dlqName: __SITE_SLUG__-agent-work-dlq
   pages:
     projectName: __SITE_SLUG__
     previewProjectName: __SITE_SLUG__-staging
@@ -23,17 +25,77 @@ cloudflare:
     manifestKeyTemplate: teams/{teamId}/published/common.json
     previewRootTemplate: teams/{teamId}/previews
     previewTtlHours: 168
+surfaces:
+  web:
+    enabled: true
+    provider: cloudflare
+    rootDir: .
+    publicBaseUrl: https://__SITE_SLUG__.pages.dev
+    localBaseUrl: http://127.0.0.1:4321
+  api:
+    enabled: true
+    provider: railway
+    rootDir: .
+    localBaseUrl: http://127.0.0.1:3000
+services:
+  api:
+    enabled: true
+    provider: railway
+    rootDir: .
+    publicBaseUrl: https://__SITE_SLUG__-api.up.railway.app
+    railway:
+      serviceName: __SITE_SLUG__-api
+      buildCommand: npm run build
+      startCommand: node ./src/api/server.js
+    environments:
+      local:
+        baseUrl: http://127.0.0.1:3000
+  manager:
+    enabled: true
+    provider: railway
+    railway:
+      serviceName: __SITE_SLUG__-manager
+      rootDir: .
+      buildCommand: npm run build
+      startCommand: node ./node_modules/@treeseed/core/dist/services/manager.js
+      schedule: '*/5 * * * *'
+  worker:
+    enabled: true
+    provider: railway
+    railway:
+      serviceName: __SITE_SLUG__-worker
+      rootDir: .
+      buildCommand: npm run build
+      startCommand: node ./node_modules/@treeseed/core/dist/services/worker.js
+  workdayStart:
+    enabled: true
+    provider: railway
+    railway:
+      serviceName: __SITE_SLUG__-workday-start
+      rootDir: .
+      buildCommand: npm run build
+      startCommand: node ./node_modules/@treeseed/core/dist/services/workday-start.js
+      schedule: '0 9 * * 1-5'
+  workdayReport:
+    enabled: true
+    provider: railway
+    railway:
+      serviceName: __SITE_SLUG__-workday-report
+      rootDir: .
+      buildCommand: npm run build
+      startCommand: node ./node_modules/@treeseed/core/dist/services/workday-report.js
+      schedule: '5 17 * * 1-5'
 plugins:
-  - package: '@treeseed/sdk/plugin-default'
+  - package: '@treeseed/core/plugin-default'
 providers:
   forms: store_only
   agents:
-    execution: stub
+    execution: copilot
     mutation: local_branch
-    repository: stub
-    verification: stub
-    notification: stub
-    research: stub
+    repository: git
+    verification: local
+    notification: sdk_message
+    research: project_graph
   deploy: cloudflare
   content:
     runtime: team_scoped_r2_overlay

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

@@ -78,6 +78,7 @@
       "astro.config.ts",
       "tsconfig.json",
       "treeseed.site.yaml",
+      "src/api/server.js",
       "src/content.config.ts",
       "src/config.yaml",
       "src/manifest.yaml",

package/dist/verification.js

@@ -1,6 +1,7 @@
-import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { existsSync, mkdtempSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
 import * as childProcess from "node:child_process";
-import { basename, resolve } from "node:path";
+import { basename, relative, resolve } from "node:path";
+import { tmpdir } from "node:os";
 import { fileURLToPath } from "node:url";
 function defaultWrite(message, stream = "stdout") {
   if (!message) return;
@@ -38,6 +39,84 @@ function readPackageManifest(packageJsonPath) {
     return null;
   }
 }
+function createWorkspaceActWorkflow(options) {
+  const relativePackageRoot = relative(options.workspaceRoot, options.packageRoot).replace(/\\/g, "/");
+  const siblingPreparationCommands = options.localTreeseedSiblingDependencies.map((packageName) => {
+    const packageDir = `packages/${packageName.split("/")[1]}`;
+    const manifest = readPackageManifest(resolve(options.workspaceRoot, packageDir, "package.json"));
+    if (!manifest) {
+      return null;
+    }
+    const commands = [
+      `if test -f ${packageDir}/package-lock.json; then`,
+      `  npm --prefix ${packageDir} ci`,
+      "else",
+      `  npm --prefix ${packageDir} install --no-audit --no-fund`,
+      "fi"
+    ];
+    if (manifest.scripts?.["build:dist"]) {
+      commands.push(`npm --prefix ${packageDir} run build:dist`);
+    }
+    return commands.join("\n");
+  }).filter((command) => Boolean(command)).join("\n");
+  const workflowRoot = mkdtempSync(resolve(tmpdir(), "treeseed-verify-act-"));
+  const workflowPath = resolve(workflowRoot, "verify.yml");
+  writeFileSync(
+    workflowPath,
+    `name: Treeseed Local Verify
+
+on:
+  workflow_dispatch:
+
+jobs:
+  verify:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: ${relativePackageRoot}
+    env:
+      CI: "true"
+      TREESEED_GITHUB_AUTOMATION_MODE: stub
+      TREESEED_STAGE_WAIT_MODE: skip
+      TREESEED_AGENT_DISABLE_GIT: "true"
+      TREESEED_FIXTURE_ID: treeseed-working-site
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          submodules: recursive
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 24.12.0
+
+      - name: Assert node:sqlite availability
+        run: node -e "import('node:sqlite').then(() => console.log('node:sqlite available')).catch((error) => { console.error(error); process.exit(1); })"
+
+${siblingPreparationCommands ? `      - name: Prepare sibling packages
+        working-directory: .
+        run: |
+${siblingPreparationCommands.split("\n").map((line) => `          ${line}`).join("\n")}
+
+` : ""}      - name: Install dependencies
+        run: |
+          if test -f package-lock.json; then
+            npm ci
+          else
+            npm install --no-audit --no-fund
+          fi
+
+      - name: Verify package
+        run: npm run verify:direct
+`,
+    "utf8"
+  );
+  return {
+    cwd: options.workspaceRoot,
+    args: ["act", options.eventName, "-W", workflowPath, "-j", "verify"]
+  };
+}
 function findWorkspaceRoot(packageRoot) {
   let current = packageRoot;
   while (true) {
@@ -150,6 +229,15 @@ function runTreeseedVerifyDriver(options = {}) {
       write(detail || "Treeseed verify requires a running Docker daemon when TREESEED_VERIFY_DRIVER=act.", "stderr");
       return 1;
     }
+    if (status.workspaceRoot && status.localTreeseedSiblingDependencies.length > 0) {
+      const workspaceAct = createWorkspaceActWorkflow({
+        workspaceRoot: status.workspaceRoot,
+        packageRoot: status.packageRoot,
+        eventName: status.eventName,
+        localTreeseedSiblingDependencies: status.localTreeseedSiblingDependencies
+      });
+      return runCommand("gh", workspaceAct.args, workspaceAct.cwd);
+    }
     return runCommand("gh", ["act", status.eventName, "-W", ".github/workflows/verify.yml", "-j", "verify"], status.packageRoot);
   }
   if (status.prefersDirectForLocalWorkspace) {

package/dist/workflow/operations.d.ts

@@ -45,8 +45,81 @@ type WorkflowRepoReport = {
 export declare function workflowStatus(helpers: WorkflowOperationHelpers): Promise<TreeseedWorkflowResult<import("../workflow-state.ts").TreeseedWorkflowState>>;
 export declare function workflowTasks(helpers: WorkflowOperationHelpers): Promise<TreeseedWorkflowResult<{
     tasks: TreeseedTaskBranchMetadata[];
+    workstreams: Array<{
+        id: string;
+        title: string;
+        linkedDirectRefs: Array<{
+            model: "objective" | "question" | "note";
+            id: string;
+        }>;
+        branch: string;
+        local: boolean;
+        remote: boolean;
+        current: boolean;
+        previewUrl: string | null;
+        lastSaveAt: string | null;
+        verificationResult: "ready" | "needs_attention" | "unknown";
+        stagingCandidate: boolean;
+        archived: boolean;
+    }>;
 }>>;
 export declare function workflowConfig(helpers: WorkflowOperationHelpers, input?: TreeseedConfigInput): Promise<TreeseedWorkflowResult<{
+    mode: string;
+    scopes: ("local" | "staging" | "prod")[];
+    sync: "none" | "cloudflare" | "railway" | "github" | "all" | undefined;
+    configPath: string;
+    keyPath: string;
+    repairs: unknown[];
+    preflight: {
+        ok: boolean;
+        requireAuth: boolean;
+        missingCommands: string[];
+        failingAuth: string[];
+        checks: {
+            commands: {
+                [k: string]: {
+                    installed: boolean;
+                    path: string | null;
+                };
+            };
+            auth: {};
+        };
+    };
+    toolHealth: {
+        githubCli: {
+            name: any;
+            available: any;
+            detail: any;
+        };
+        ghActExtension: {
+            name: any;
+            available: any;
+            detail: any;
+        };
+        dockerDaemon: {
+            name: any;
+            available: any;
+            detail: any;
+        };
+        wranglerCli: {
+            name: any;
+            available: any;
+            detail: any;
+        };
+        railwayCli: {
+            name: any;
+            available: any;
+            detail: any;
+        };
+        actVerificationReady: any;
+        remediation: string[];
+    };
+    market: any;
+    connection: import("../sdk-types.ts").ProjectConnection | null;
+    runnerTokenIssued: boolean;
+} & {
+    finalState?: WorkflowStatePayload;
+}> | TreeseedWorkflowResult<{
     mode: string;
     scopes: ("local" | "staging" | "prod")[];
     sync: "none" | "cloudflare" | "railway" | "github" | "all";
@@ -66,6 +139,7 @@ export declare function workflowConfig(helpers: WorkflowOperationHelpers, input?
                 ready: any;
                 detail: any;
             }[];
+            issues: any[];
         };
     }[];
     repairs: import("../operations/services/config-runtime.ts").TreeseedRepairAction[];
@@ -100,9 +174,21 @@ export declare function workflowConfig(helpers: WorkflowOperationHelpers, input?
             available: any;
             detail: any;
         };
+        wranglerCli: {
+            name: any;
+            available: any;
+            detail: any;
+        };
+        railwayCli: {
+            name: any;
+            available: any;
+            detail: any;
+        };
         actVerificationReady: any;
         remediation: string[];
     };
+    context: import("../operations/services/config-runtime.ts").TreeseedCollectedConfigContext;
+    secretSession: import("../operations/services/config-runtime.ts").TreeseedConfigSecretSessionBootstrap;
 } & {
     finalState?: WorkflowStatePayload;
 }> | TreeseedWorkflowResult<{
@@ -142,9 +228,21 @@ export declare function workflowConfig(helpers: WorkflowOperationHelpers, input?
             available: any;
             detail: any;
         };
+        wranglerCli: {
+            name: any;
+            available: any;
+            detail: any;
+        };
+        railwayCli: {
+            name: any;
+            available: any;
+            detail: any;
+        };
         actVerificationReady: any;
         remediation: string[];
     };
+    context: import("../operations/services/config-runtime.ts").TreeseedCollectedConfigContext;
+    secretSession: import("../operations/services/config-runtime.ts").TreeseedConfigSecretSessionBootstrap;
 } & {
     finalState?: WorkflowStatePayload;
 }>>;