@treeseed/sdk 0.3.3 → 0.4.0

package/dist/platform/plugins/constants.js

@@ -1,4 +1,4 @@
-const TREESEED_DEFAULT_PLUGIN_PACKAGE = "@treeseed/core/plugin-default";
+const TREESEED_DEFAULT_PLUGIN_PACKAGE = "@treeseed/sdk/plugin-default";
 const TREESEED_DEFAULT_PROVIDER_SELECTIONS = {
   forms: "store_only",
   operations: "default",

package/dist/platform/plugins/runtime.d.ts

@@ -1,5 +1,5 @@
 import type { TreeseedDeployConfig } from '../contracts.ts';
-import type { TreeseedPluginEnvironmentContext } from './plugin.ts';
+import type { TreeseedPluginEnvironmentContext } from '../plugin.ts';
 import type { SdkGraphRankingProvider } from '../../sdk-types.ts';
 type LoadedPluginEntry = {
     package: string;

package/dist/platform/plugins/runtime.js

@@ -2,7 +2,7 @@ import { existsSync } from "node:fs";
 import { createRequire } from "node:module";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
-import { loadTreeseedDeployConfig } from "../deploy/config.js";
+import { loadTreeseedDeployConfig } from "../deploy-config.js";
 import { TREESEED_DEFAULT_PLUGIN_PACKAGE } from "./constants.js";
 const require2 = createRequire(import.meta.url);
 const runtimeDir = path.dirname(fileURLToPath(import.meta.url));
@@ -18,18 +18,18 @@ function isPathLikePluginReference(packageName) {
 }
 function resolveLocalDefaultPluginPath() {
   const candidates = [
-    path.resolve(runtimeDir, "../../../../core/dist/plugin-default.js"),
-    path.resolve(runtimeDir, "../../../../dist/plugin-default.js")
+    path.resolve(runtimeDir, "../../../dist/plugin-default.js"),
+    path.resolve(runtimeDir, "../../../../sdk/dist/plugin-default.js")
   ];
   let current = runtimeDir;
   while (true) {
+    candidates.push(path.resolve(current, "..", "sdk", "dist", "plugin-default.js"));
     const packageJsonPath = path.resolve(current, "package.json");
     if (existsSync(packageJsonPath)) {
       try {
         const packageJson = require2(packageJsonPath);
-        if (packageJson?.name === "@treeseed/core") {
+        if (packageJson?.name === "@treeseed/sdk") {
           candidates.push(path.resolve(current, "dist/plugin-default.js"));
-          break;
         }
       } catch {
       }

package/dist/platform/plugins.d.ts

@@ -1,6 +1,6 @@
 export { TREESEED_DEFAULT_PLUGIN_PACKAGE, TREESEED_DEFAULT_PLUGIN_REFERENCES, TREESEED_DEFAULT_PROVIDER_SELECTIONS, } from './plugins/constants.ts';
 export { getTreeseedAgentProviderSelections, getTreeseedDeployConfig, getTreeseedDeployProvider, getTreeseedDocsProvider, getTreeseedFormsProvider, getTreeseedOperationsProvider, getTreeseedSiteProvider, isTreeseedSmtpEnabled, isTreeseedTurnstileEnabled, resetTreeseedDeployConfigForTests, } from './deploy-runtime.ts';
-export { defineTreeseedPlugin } from './plugins/plugin.ts';
-export type * from './plugins/plugin.ts';
+export { defineTreeseedPlugin } from './plugin.ts';
+export type * from './plugin.ts';
 export { loadTreeseedPluginRuntime, loadTreeseedPlugins, resolveTreeseedGraphRankingProvider } from './plugins/runtime.ts';
 export type { LoadedTreeseedPluginEntry } from './plugins/runtime.ts';

package/dist/platform/plugins.js

@@ -15,7 +15,7 @@ import {
   isTreeseedTurnstileEnabled,
   resetTreeseedDeployConfigForTests
 } from "./deploy-runtime.js";
-import { defineTreeseedPlugin } from "./plugins/plugin.js";
+import { defineTreeseedPlugin } from "./plugin.js";
 import { loadTreeseedPluginRuntime, loadTreeseedPlugins, resolveTreeseedGraphRankingProvider } from "./plugins/runtime.js";
 export {
   TREESEED_DEFAULT_PLUGIN_PACKAGE,

package/dist/platform/tenant/runtime-config.js

@@ -1,5 +1,5 @@
 import { readFileSync } from "node:fs";
-import { loadTreeseedManifest } from "./config.js";
+import { loadTreeseedManifest } from "../tenant-config.js";
 import { parseSiteConfig } from "../utils/site-config-schema.js";
 const injectedTenantConfig = typeof __TREESEED_TENANT_CONFIG__ !== "undefined" ? __TREESEED_TENANT_CONFIG__ : null;
 const injectedProjectRoot = typeof __TREESEED_PROJECT_ROOT__ !== "undefined" ? __TREESEED_PROJECT_ROOT__ : null;

package/dist/platform/tenant-config.d.ts

@@ -1 +1,7 @@
-export * from './tenant/config.ts';
+import type { TreeseedTenantConfig } from './contracts.ts';
+export declare function resolveTreeseedTenantRoot(): string;
+export declare function defineTreeseedTenant<T>(tenantConfig: T): T;
+export declare function loadTreeseedManifest(manifestPath?: string): TreeseedTenantConfig;
+export declare const loadTreeseedTenantManifest: typeof loadTreeseedManifest;
+export declare function getTenantContentRoot(tenantConfig: Pick<TreeseedTenantConfig, 'content'>, collectionName: string): string;
+export declare function tenantFeatureEnabled(tenantConfig: Pick<TreeseedTenantConfig, 'features'>, featureName: string): boolean;

package/dist/platform/tenant-config.js

@@ -1 +1,153 @@
-export * from "./tenant/config.js";
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { parse as parseYaml } from "yaml";
+import { normalizeAliasedRecord } from "../field-aliases.js";
+function resolvePackageRoot() {
+  const moduleUrl = typeof import.meta?.url === "string" ? import.meta.url : null;
+  if (!moduleUrl) {
+    return process.cwd();
+  }
+  return resolve(dirname(fileURLToPath(moduleUrl)), "../..");
+}
+const packageRoot = resolvePackageRoot();
+const packageFixtureRoot = resolve(packageRoot, ".fixtures", "treeseed-fixtures", "sites", "working-site");
+const explicitTenantRoot = process.env.TREESEED_TENANT_ROOT ? resolve(process.env.TREESEED_TENANT_ROOT) : null;
+const manifestFieldAliases = {
+  siteConfigPath: { key: "siteConfigPath", aliases: ["site_config_path"] }
+};
+const manifestContentFieldAliases = {
+  pages: { key: "pages", aliases: ["page_root", "pages_root"] },
+  notes: { key: "notes", aliases: ["notes_root"] },
+  questions: { key: "questions", aliases: ["questions_root"] },
+  objectives: { key: "objectives", aliases: ["objectives_root"] },
+  people: { key: "people", aliases: ["people_root"] },
+  agents: { key: "agents", aliases: ["agents_root"] },
+  books: { key: "books", aliases: ["books_root"] },
+  docs: { key: "docs", aliases: ["knowledge", "knowledge_root", "docs_root"] }
+};
+const manifestOverrideFieldAliases = {
+  pagesRoot: { key: "pagesRoot", aliases: ["pages_root"] },
+  stylesRoot: { key: "stylesRoot", aliases: ["styles_root"] },
+  componentsRoot: { key: "componentsRoot", aliases: ["components_root"] }
+};
+function pathWithin(parent, candidate) {
+  const normalizedParent = resolve(parent);
+  const normalizedCandidate = resolve(candidate);
+  return normalizedCandidate === normalizedParent || normalizedCandidate.startsWith(`${normalizedParent}/`);
+}
+function collectTenantRootCandidates(start) {
+  const candidates = [];
+  let current = resolve(start);
+  while (true) {
+    candidates.push(
+      current,
+      resolve(current, ".fixtures", "treeseed-fixtures", "sites", "working-site"),
+      resolve(current, "fixture")
+    );
+    const parent = resolve(current, "..");
+    if (parent === current) {
+      break;
+    }
+    current = parent;
+  }
+  return candidates;
+}
+function uniqueCandidates(entries) {
+  return [...new Set(entries.map((entry) => resolve(entry)))];
+}
+function tenantRootCandidates() {
+  const cwd = resolve(process.cwd());
+  const cwdCandidates = collectTenantRootCandidates(cwd);
+  const packageCandidates = collectTenantRootCandidates(packageRoot);
+  if (explicitTenantRoot) {
+    return uniqueCandidates([explicitTenantRoot, ...cwdCandidates, packageFixtureRoot, ...packageCandidates]);
+  }
+  if (pathWithin(packageRoot, cwd)) {
+    return uniqueCandidates([packageFixtureRoot, ...cwdCandidates, ...packageCandidates]);
+  }
+  return uniqueCandidates([...cwdCandidates, packageFixtureRoot, ...packageCandidates]);
+}
+function resolveTenantPath(manifestPath) {
+  if (existsSync(manifestPath)) {
+    return resolve(manifestPath);
+  }
+  const candidates = tenantRootCandidates().map((root) => resolve(root, manifestPath));
+  for (const candidate of candidates) {
+    if (existsSync(candidate)) {
+      return candidate;
+    }
+  }
+  throw new Error(
+    `Unable to resolve Treeseed tenant manifest at "${manifestPath}" from ${process.cwd()} or ${packageFixtureRoot}.`
+  );
+}
+function resolveTreeseedTenantRoot() {
+  const candidates = tenantRootCandidates();
+  for (const candidate of candidates) {
+    if (existsSync(resolve(candidate, "src/manifest.yaml"))) {
+      return candidate;
+    }
+  }
+  throw new Error(
+    `Unable to resolve a Treeseed tenant root from ${process.cwd()} or ${packageFixtureRoot}.`
+  );
+}
+function defineTreeseedTenant(tenantConfig) {
+  return tenantConfig;
+}
+function loadTreeseedManifest(manifestPath = "./src/manifest.yaml") {
+  const resolvedManifestPath = resolveTenantPath(manifestPath);
+  const tenantRoot = resolve(dirname(resolvedManifestPath), "..");
+  const parsed = normalizeAliasedRecord(
+    manifestFieldAliases,
+    parseYaml(readFileSync(resolvedManifestPath, "utf8"))
+  );
+  const content = normalizeAliasedRecord(
+    manifestContentFieldAliases,
+    parsed.content ?? {}
+  );
+  const overrides = parsed.overrides ? normalizeAliasedRecord(
+    manifestOverrideFieldAliases,
+    parsed.overrides
+  ) : void 0;
+  const tenantConfig = defineTreeseedTenant({
+    ...parsed,
+    siteConfigPath: resolve(tenantRoot, parsed.siteConfigPath),
+    content: Object.fromEntries(
+      Object.entries(content ?? {}).map(([collectionName, rootPath]) => [
+        collectionName,
+        resolve(tenantRoot, String(rootPath))
+      ])
+    ),
+    overrides: overrides ? {
+      pagesRoot: overrides.pagesRoot ? resolve(tenantRoot, overrides.pagesRoot) : void 0,
+      stylesRoot: overrides.stylesRoot ? resolve(tenantRoot, overrides.stylesRoot) : void 0,
+      componentsRoot: overrides.componentsRoot ? resolve(tenantRoot, overrides.componentsRoot) : void 0
+    } : void 0
+  });
+  Object.defineProperty(tenantConfig, "__tenantRoot", {
+    value: tenantRoot,
+    enumerable: false
+  });
+  return tenantConfig;
+}
+const loadTreeseedTenantManifest = loadTreeseedManifest;
+function getTenantContentRoot(tenantConfig, collectionName) {
+  const root = tenantConfig.content[collectionName];
+  if (!root) {
+    throw new Error(`Unknown tenant content collection: ${collectionName}`);
+  }
+  return root;
+}
+function tenantFeatureEnabled(tenantConfig, featureName) {
+  return tenantConfig.features?.[featureName] !== false;
+}
+export {
+  defineTreeseedTenant,
+  getTenantContentRoot,
+  loadTreeseedManifest,
+  loadTreeseedTenantManifest,
+  resolveTreeseedTenantRoot,
+  tenantFeatureEnabled
+};

package/dist/plugin-default.d.ts

@@ -0,0 +1,25 @@
+declare const _default: {
+    id: string;
+    provides: {
+        forms: string[];
+        operations: string[];
+        agents: {
+            execution: string[];
+            mutation: string[];
+            repository: string[];
+            verification: string[];
+            notification: string[];
+            research: string[];
+            handlers: string[];
+        };
+        deploy: string[];
+        content: {
+            docs: string[];
+        };
+        site: string[];
+    };
+    graphRankingProviders: {
+        default: import("./sdk-types.ts").SdkGraphRankingProvider;
+    };
+};
+export default _default;

package/dist/plugin-default.js

@@ -0,0 +1,37 @@
+import { createDefaultGraphRankingProvider } from "./graph/ranking.js";
+import { defineTreeseedPlugin } from "./platform/plugin.js";
+var plugin_default_default = defineTreeseedPlugin({
+  id: "treeseed-sdk-default",
+  provides: {
+    forms: ["store_only", "notify_admin", "full_email"],
+    operations: ["default"],
+    agents: {
+      execution: ["stub", "manual", "copilot"],
+      mutation: ["local_branch"],
+      repository: ["stub", "git"],
+      verification: ["stub", "local"],
+      notification: ["stub"],
+      research: ["stub"],
+      handlers: [
+        "planner",
+        "architect",
+        "engineer",
+        "notifier",
+        "researcher",
+        "reviewer",
+        "releaser"
+      ]
+    },
+    deploy: ["cloudflare"],
+    content: {
+      docs: ["default"]
+    },
+    site: ["default"]
+  },
+  graphRankingProviders: {
+    default: createDefaultGraphRankingProvider()
+  }
+});
+export {
+  plugin_default_default as default
+};

package/dist/scripts/aggregate-book.js

@@ -1,7 +1,7 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { buildTenantBookRuntime } from '../platform/utils/books-data.js';
-import { loadTreeseedManifest } from '../platform/tenant/config.js';
+import { loadTreeseedManifest } from '../platform/tenant-config.js';
 const PROJECT_TENANT = loadTreeseedManifest();
 const { BOOKS, TREESEED_LIBRARY_DOWNLOAD } = buildTenantBookRuntime(PROJECT_TENANT, {
     projectRoot: PROJECT_TENANT.__tenantRoot ?? process.cwd(),

package/dist/scripts/build-tenant-worker.js

@@ -1,8 +1,8 @@
 import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { dirname, resolve } from 'node:path';
 import { build } from 'esbuild';
-import { loadTreeseedDeployConfig } from '../platform/deploy/config.js';
-import { loadTreeseedManifest } from '../platform/tenant/config.js';
+import { loadTreeseedDeployConfig } from '../platform/deploy-config.js';
+import { loadTreeseedManifest } from '../platform/tenant-config.js';
 import { parseSiteConfig } from '../platform/utils/site-config-schema.js';
 import { corePackageRoot } from '../operations/services/runtime-tools.js';
 const tenantRoot = process.cwd();

package/dist/scripts/tenant-destroy.js

@@ -3,7 +3,7 @@ import readline from 'node:readline/promises';
 import { stdin as input, stdout as output } from 'node:process';
 import { applyTreeseedEnvironmentToProcess, assertTreeseedCommandEnvironment } from '../operations/services/config-runtime.js';
 import { cleanupDestroyedState, createPersistentDeployTarget, destroyCloudflareResources, loadDeployState, printDestroySummary, validateDestroyPrerequisites, } from '../operations/services/deploy.js';
-import { deriveCloudflareWorkerName } from '../platform/deploy/config.js';
+import { deriveCloudflareWorkerName } from '../platform/deploy-config.js';
 const tenantRoot = process.cwd();
 function parseArgs(argv) {
     const parsed = {

package/dist/scripts/tenant-dev.js

@@ -2,7 +2,7 @@ import { spawnSync } from 'node:child_process';
 import { corePackageRoot, packageScriptPath, spawnNodeBinary, resolveWranglerBin } from '../operations/services/runtime-tools.js';
 import { applyTreeseedEnvironmentToProcess, assertTreeseedCommandEnvironment } from '../operations/services/config-runtime.js';
 import { ensureGeneratedWranglerConfig } from '../operations/services/deploy.js';
-import { loadTreeseedDeployConfig } from '../platform/deploy/config.js';
+import { loadTreeseedDeployConfig } from '../platform/deploy-config.js';
 import { createTenantWatchEntries, isEditablePackageWorkspace, startPollingWatch, stopManagedProcess, writeDevReloadStamp, workspaceSdkRoot, } from '../operations/services/watch-dev.js';
 const tenantRoot = process.cwd();
 const cliArgs = process.argv.slice(2);

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

@@ -23,6 +23,7 @@
   "dependencies": {
     "@treeseed/cli": "__CLI_VERSION__",
     "@treeseed/core": "__CORE_VERSION__",
+    "@treeseed/sdk": "__SDK_VERSION__",
     "yaml": "^2.8.1"
   },
   "devDependencies": {

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

@@ -6,7 +6,7 @@ cloudflare:
   accountId: replace-with-cloudflare-account-id
   workerName: __SITE_SLUG__
 plugins:
-  - package: '@treeseed/core/plugin-default'
+  - package: '@treeseed/sdk/plugin-default'
 providers:
   forms: store_only
   agents:

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

@@ -64,6 +64,12 @@
       "token": "__CORE_VERSION__",
       "deriveFrom": "coreVersion",
       "required": true
+    },
+    {
+      "name": "SDK version",
+      "token": "__SDK_VERSION__",
+      "deriveFrom": "sdkVersion",
+      "required": true
     }
   ],
   "managedSurface": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@treeseed/sdk",
-  "version": "0.3.3",
+  "version": "0.4.0",
   "description": "Shared Treeseed SDK for content-backed and D1-backed object models.",
   "license": "AGPL-3.0-only",
   "repository": {
@@ -120,6 +120,10 @@
       "types": "./dist/platform/plugin.d.ts",
       "default": "./dist/platform/plugin.js"
     },
+    "./plugin-default": {
+      "types": "./dist/plugin-default.d.ts",
+      "default": "./dist/plugin-default.js"
+    },
     "./platform/books-data": {
       "types": "./dist/platform/books-data.d.ts",
       "default": "./dist/platform/books-data.js"
@@ -180,26 +184,14 @@
       "types": "./dist/types/agents.d.ts",
       "default": "./dist/types/agents.js"
     },
-    "./types/agents.js": {
-      "types": "./dist/types/agents.d.ts",
-      "default": "./dist/types/agents.js"
-    },
     "./types/cloudflare": {
       "types": "./dist/types/cloudflare.d.ts",
       "default": "./dist/types/cloudflare.js"
     },
-    "./types/cloudflare.js": {
-      "types": "./dist/types/cloudflare.d.ts",
-      "default": "./dist/types/cloudflare.js"
-    },
     "./wrangler-d1": {
       "types": "./dist/wrangler-d1.d.ts",
       "default": "./dist/wrangler-d1.js"
     },
-    "./wrangler-d1.js": {
-      "types": "./dist/wrangler-d1.d.ts",
-      "default": "./dist/wrangler-d1.js"
-    },
     "./stores/cursor-store": {
       "types": "./dist/stores/cursor-store.d.ts",
       "default": "./dist/stores/cursor-store.js"
@@ -223,18 +215,6 @@
     "./stores/subscription-store": {
       "types": "./dist/stores/subscription-store.d.ts",
       "default": "./dist/stores/subscription-store.js"
-    },
-    "./utils/agents/runtime-types": {
-      "types": "./dist/utils/agents/runtime-types.d.ts",
-      "default": "./dist/utils/agents/runtime-types.js"
-    },
-    "./utils/agents/contracts/messages": {
-      "types": "./dist/utils/agents/contracts/messages.d.ts",
-      "default": "./dist/utils/agents/contracts/messages.js"
-    },
-    "./utils/agents/contracts/run": {
-      "types": "./dist/utils/agents/contracts/run.d.ts",
-      "default": "./dist/utils/agents/contracts/run.js"
     }
   }
 }

package/dist/platform/deploy/config.d.ts

@@ -1,4 +0,0 @@
-import type { TreeseedDeployConfig } from '../contracts.ts';
-export declare function resolveTreeseedDeployConfigPath(configPath?: string): string;
-export declare function deriveCloudflareWorkerName(config: TreeseedDeployConfig): string;
-export declare function loadTreeseedDeployConfig(configPath?: string): TreeseedDeployConfig;