@treeseed/sdk 0.12.62 → 0.13.0-rc.10

package/dist/operations/services/workspace-tools.js

@@ -1,320 +0,0 @@
-import { existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, rmSync } from "node:fs";
-import { spawnSync } from "node:child_process";
-import { classifyTreeseedGitMode, runTreeseedGit, runTreeseedGitText } from "./git-runner.js";
-import { join, relative, resolve } from "node:path";
-const TREESEED_WORKSPACE_PACKAGE_DIRS = ["sdk", "ui", "core", "admin", "cli", "agent", "api", "treedx"];
-function packageSortWeight(pkg) {
-  const relativeDir = String(pkg.relativeDir ?? "");
-  const dirName = relativeDir.split("/").pop() ?? "";
-  const index = TREESEED_WORKSPACE_PACKAGE_DIRS.indexOf(dirName);
-  return index >= 0 ? index : Number.MAX_SAFE_INTEGER;
-}
-function compareWorkspacePackages(left, right) {
-  const leftWeight = packageSortWeight(left);
-  const rightWeight = packageSortWeight(right);
-  if (leftWeight !== rightWeight) {
-    return leftWeight - rightWeight;
-  }
-  return left.name.localeCompare(right.name);
-}
-function escapeRegex(source) {
-  return source.replace(/[|\\{}()[\]^$+?.]/g, "\\$&");
-}
-function runGit(args, options) {
-  return runTreeseedGitText(args, {
-    cwd: options.cwd,
-    mode: classifyTreeseedGitMode(args),
-    timeoutMs: options.timeoutMs,
-    maxBuffer: options.maxBuffer
-  });
-}
-function segmentPatternToRegex(pattern) {
-  return new RegExp(`^${escapeRegex(pattern).replaceAll("*", ".*")}$`);
-}
-function expandWorkspacePattern(root, pattern) {
-  const segments = pattern.split(/[\\/]+/).filter(Boolean);
-  const results = [];
-  function visit(baseDir, index) {
-    if (index >= segments.length) {
-      results.push(baseDir);
-      return;
-    }
-    const segment = segments[index];
-    if (!segment.includes("*")) {
-      const nextDir = resolve(baseDir, segment);
-      if (existsSync(nextDir)) {
-        visit(nextDir, index + 1);
-      }
-      return;
-    }
-    if (!existsSync(baseDir)) {
-      return;
-    }
-    const matcher = segmentPatternToRegex(segment);
-    for (const entry of readdirSync(baseDir, { withFileTypes: true })) {
-      if (!entry.isDirectory() || !matcher.test(entry.name)) {
-        continue;
-      }
-      visit(resolve(baseDir, entry.name), index + 1);
-    }
-  }
-  visit(root, 0);
-  return results;
-}
-function workspaceRoot(startCwd = process.cwd()) {
-  return findNearestTreeseedWorkspaceRoot(startCwd) ?? resolve(startCwd);
-}
-function findNearestTreeseedRoot(startCwd = process.cwd()) {
-  let current = resolve(startCwd);
-  while (true) {
-    if (existsSync(resolve(current, "treeseed.site.yaml"))) {
-      return current;
-    }
-    const parent = resolve(current, "..");
-    if (parent === current) {
-      return null;
-    }
-    current = parent;
-  }
-}
-function isWorkspaceRoot(root = process.cwd()) {
-  try {
-    return workspacePatterns(root).length > 0 || hasCompleteTreeseedPackageCheckout(root);
-  } catch {
-    return false;
-  }
-}
-function hasCompleteTreeseedPackageCheckout(root = process.cwd()) {
-  return TREESEED_WORKSPACE_PACKAGE_DIRS.every((dirName) => {
-    const packageDir = resolve(root, "packages", dirName);
-    return existsSync(resolve(packageDir, "package.json")) || existsSync(resolve(packageDir, "treeseed.package.yaml"));
-  });
-}
-function findNearestTreeseedWorkspaceRoot(startCwd = process.cwd()) {
-  const tenantRoot = findNearestTreeseedRoot(startCwd);
-  if (!tenantRoot) {
-    return null;
-  }
-  return isWorkspaceRoot(tenantRoot) ? tenantRoot : null;
-}
-function readJson(filePath) {
-  return JSON.parse(readFileSync(filePath, "utf8"));
-}
-function workspacePackageJson(root = workspaceRoot()) {
-  if (!existsSync(resolve(root, "package.json"))) {
-    return {};
-  }
-  return readJson(resolve(root, "package.json"));
-}
-function workspacePatterns(root = workspaceRoot()) {
-  if (!existsSync(resolve(root, "package.json"))) {
-    return hasCompleteTreeseedPackageCheckout(root) ? ["packages/*"] : [];
-  }
-  const packageJson = workspacePackageJson(root);
-  const workspaces = Array.isArray(packageJson.workspaces) ? packageJson.workspaces : Array.isArray(packageJson.workspaces?.packages) ? packageJson.workspaces.packages : [];
-  const patterns = workspaces.filter((value) => typeof value === "string" && value.trim().length > 0);
-  if (patterns.length > 0) {
-    return patterns;
-  }
-  return hasCompleteTreeseedPackageCheckout(root) ? ["packages/*"] : [];
-}
-function workspacePackages(root = workspaceRoot()) {
-  const discovered = /* @__PURE__ */ new Map();
-  for (const pattern of workspacePatterns(root)) {
-    for (const dir of expandWorkspacePattern(root, pattern)) {
-      const packageJsonPath = resolve(dir, "package.json");
-      if (!existsSync(packageJsonPath)) {
-        continue;
-      }
-      const packageJson = readJson(packageJsonPath);
-      discovered.set(dir, {
-        dir,
-        name: packageJson.name,
-        packageJson,
-        relativeDir: relative(root, dir).replaceAll("\\", "/")
-      });
-    }
-  }
-  return [...discovered.values()].sort(compareWorkspacePackages);
-}
-function internalDependenciesFor(pkg, packageNames) {
-  const internalDeps = /* @__PURE__ */ new Set();
-  for (const field of ["dependencies", "optionalDependencies", "peerDependencies", "devDependencies"]) {
-    for (const name of Object.keys(pkg.packageJson[field] ?? {})) {
-      if (packageNames.has(name)) {
-        internalDeps.add(name);
-      }
-    }
-  }
-  return internalDeps;
-}
-function sortWorkspacePackages(packages) {
-  const packageMap = new Map(packages.map((pkg) => [pkg.name, pkg]));
-  const packageNames = new Set(packageMap.keys());
-  const dependents = new Map(packages.map((pkg) => [pkg.name, /* @__PURE__ */ new Set()]));
-  const indegree = new Map(packages.map((pkg) => [pkg.name, 0]));
-  for (const pkg of packages) {
-    for (const dep of internalDependenciesFor(pkg, packageNames)) {
-      dependents.get(dep)?.add(pkg.name);
-      indegree.set(pkg.name, (indegree.get(pkg.name) ?? 0) + 1);
-    }
-  }
-  const ready = [...packages].filter((pkg) => (indegree.get(pkg.name) ?? 0) === 0).sort(compareWorkspacePackages);
-  const ordered = [];
-  while (ready.length > 0) {
-    const next = ready.shift();
-    if (!next) {
-      break;
-    }
-    ordered.push(next);
-    for (const dependentName of [...dependents.get(next.name) ?? []].sort()) {
-      const nextDegree = (indegree.get(dependentName) ?? 0) - 1;
-      indegree.set(dependentName, nextDegree);
-      if (nextDegree === 0) {
-        const dependent = packageMap.get(dependentName);
-        if (dependent) {
-          ready.push(dependent);
-          ready.sort(compareWorkspacePackages);
-        }
-      }
-    }
-  }
-  if (ordered.length !== packages.length) {
-    return [...packages].sort(compareWorkspacePackages);
-  }
-  return ordered;
-}
-function packagesWithScript(scriptName, root = workspaceRoot()) {
-  return sortWorkspacePackages(
-    workspacePackages(root).filter((pkg) => typeof pkg.packageJson.scripts?.[scriptName] === "string")
-  );
-}
-function run(command, args, options = {}) {
-  if (command === "git") {
-    const result2 = runTreeseedGit(args, {
-      cwd: options.cwd ?? workspaceRoot(),
-      mode: classifyTreeseedGitMode(args),
-      allowFailure: false,
-      timeoutMs: options.timeoutMs,
-      maxBuffer: options.maxBuffer
-    });
-    if (!options.capture && result2.stdout) {
-      process.stdout.write(result2.stdout);
-    }
-    if (!options.capture && result2.stderr) {
-      process.stderr.write(result2.stderr);
-    }
-    return (result2.stdout ?? "").trim();
-  }
-  const result = spawnSync(command, args, {
-    cwd: options.cwd ?? workspaceRoot(),
-    env: { ...process.env, ...options.env ?? {} },
-    stdio: options.capture ? "pipe" : "inherit",
-    encoding: "utf8",
-    timeout: options.timeoutMs,
-    maxBuffer: options.maxBuffer ?? 1024 * 1024 * 32
-  });
-  if (result.status !== 0) {
-    const message = (result.error?.message ? `${result.error.message}
-` : "") + (result.stderr?.trim() || result.stdout?.trim() || `${command} ${args.join(" ")} failed`);
-    throw new Error(message);
-  }
-  return (result.stdout ?? "").trim();
-}
-function canResolveGitRef(baseRef, cwd = workspaceRoot()) {
-  const result = runTreeseedGit(["rev-parse", "--verify", baseRef], {
-    cwd,
-    mode: "read",
-    allowFailure: true
-  });
-  return result.status === 0;
-}
-function resolveChangedFilesBaseRef(baseRef, cwd = workspaceRoot()) {
-  if (canResolveGitRef(baseRef, cwd)) {
-    return baseRef;
-  }
-  return null;
-}
-function changedWorkspaceFiles(baseRef, cwd = workspaceRoot()) {
-  const changedFiles = /* @__PURE__ */ new Set();
-  const resolvedBaseRef = resolveChangedFilesBaseRef(baseRef, cwd);
-  const diffCommands = [
-    ["diff", "--name-only"],
-    ["diff", "--name-only", "--cached"],
-    ["ls-files", "--others", "--exclude-standard"]
-  ];
-  if (resolvedBaseRef) {
-    diffCommands.unshift(["diff", "--name-only", resolvedBaseRef, "HEAD"]);
-  }
-  for (const args of diffCommands) {
-    const output = runGit(args, { cwd, capture: true });
-    for (const line of output.split("\n").map((entry) => entry.trim()).filter(Boolean)) {
-      changedFiles.add(line);
-    }
-  }
-  return changedFiles;
-}
-function changedWorkspacePackages(options = {}) {
-  const root = options.root ?? workspaceRoot();
-  const baseRef = options.baseRef ?? process.env.TREESEED_RELEASE_BASE_REF ?? "HEAD^";
-  const includeDependents = options.includeDependents ?? false;
-  const packages = options.packages ?? workspacePackages(root);
-  const changedFiles = changedWorkspaceFiles(baseRef, root);
-  const changed = new Set(
-    packages.filter((pkg) => [...changedFiles].some((file) => file === pkg.relativeDir || file.startsWith(`${pkg.relativeDir}/`))).map((pkg) => pkg.name)
-  );
-  if (includeDependents && changed.size > 0) {
-    const packageMap = new Map(packages.map((pkg) => [pkg.name, pkg]));
-    const packageNames = new Set(packageMap.keys());
-    const reverseDeps = new Map(packages.map((pkg) => [pkg.name, /* @__PURE__ */ new Set()]));
-    for (const pkg of packages) {
-      for (const dep of internalDependenciesFor(pkg, packageNames)) {
-        reverseDeps.get(dep)?.add(pkg.name);
-      }
-    }
-    const queue = [...changed];
-    while (queue.length > 0) {
-      const next = queue.shift();
-      for (const dependent of reverseDeps.get(next) ?? []) {
-        if (changed.has(dependent)) {
-          continue;
-        }
-        changed.add(dependent);
-        queue.push(dependent);
-      }
-    }
-  }
-  return sortWorkspacePackages(packages.filter((pkg) => changed.has(pkg.name)));
-}
-function publishableWorkspacePackages(root = workspaceRoot()) {
-  return packagesWithScript("release:publish", root);
-}
-function createTempDir(prefix) {
-  const baseRoot = resolve(process.env.TREESEED_TEMP_ROOT ?? resolve(workspaceRoot(), ".local", "tmp"));
-  mkdirSync(baseRoot, { recursive: true });
-  return mkdtempSync(join(baseRoot, prefix));
-}
-function cleanupDir(dirPath) {
-  if (dirPath && existsSync(dirPath)) {
-    rmSync(dirPath, { recursive: true, force: true });
-  }
-}
-export {
-  TREESEED_WORKSPACE_PACKAGE_DIRS,
-  changedWorkspacePackages,
-  cleanupDir,
-  createTempDir,
-  findNearestTreeseedRoot,
-  findNearestTreeseedWorkspaceRoot,
-  hasCompleteTreeseedPackageCheckout,
-  isWorkspaceRoot,
-  packagesWithScript,
-  publishableWorkspacePackages,
-  readJson,
-  run,
-  sortWorkspacePackages,
-  workspacePackageJson,
-  workspacePackages,
-  workspacePatterns,
-  workspaceRoot
-};

package/dist/operations-registry.d.ts

@@ -1,5 +0,0 @@
-import type { TreeseedOperationMetadata } from './operations-types.js';
-export declare const TRESEED_OPERATION_SPECS: TreeseedOperationMetadata[];
-export declare const TRESEED_OPERATION_INDEX: Map<string, TreeseedOperationMetadata>;
-export declare function findTreeseedOperation(name: string | null | undefined): TreeseedOperationMetadata | null;
-export declare function listTreeseedOperationNames(): string[];

package/dist/operations-registry.js

@@ -1,98 +0,0 @@
-function operation(spec) {
-  return spec;
-}
-const workspaceCommand = (name) => `workspace${":"}${name}`;
-const TRESEED_OPERATION_SPECS = [
-  operation({ id: "workspace.status", name: "status", aliases: [], group: "Workflow", summary: "Show Treeseed project health and the current task state.", description: "Report branch/task state, runtime readiness, preview/deploy state, auth readiness, and recommended next operations.", provider: "default", related: ["tasks", "switch", "config"] }),
-  operation({ id: "workspace.ci", name: "ci", aliases: [], group: "Validation", summary: "Inspect remote GitHub Actions status for the active workspace commits.", description: "Check the latest GitHub Actions workflow runs for the current branch heads across market and checked-out package repositories, including failed jobs and inspect commands.", provider: "default", related: ["status", "save", "stage"] }),
-  operation({ id: "branch.tasks", name: "tasks", aliases: [], group: "Workflow", summary: "List task branches plus package branch alignment.", description: "List task branches from market and checked-out package repos, including preview metadata and branch/pointer alignment state.", provider: "default", related: ["status", "switch", "close"] }),
-  operation({ id: "branch.switch", name: "switch", aliases: [], group: "Workflow", summary: "Create or resume a recursive task branch.", description: "Create or resume the task branch in market and any checked-out package repos, with optional preview provisioning.", provider: "default", related: ["tasks", "dev", "save"] }),
-  operation({ id: "branch.save", name: "save", aliases: [], group: "Workflow", summary: "Recursively verify, commit, and push the current task checkpoint.", description: "Save dirty package repos in dependency order, then verify, commit, push, and optionally refresh preview for market.", provider: "default", related: ["switch", "stage", "status"] }),
-  operation({ id: "branch.update", name: "update", aliases: [], group: "Workflow", summary: "Merge staging into the current task branch.", description: "Merge the selected upstream branch, staging by default, into the current task branch across market and checked-out package repos.", provider: "default", related: ["status", "save", "stage", "switch"] }),
-  operation({ id: "branch.close", name: "close", aliases: [], group: "Workflow", summary: "Recursively archive and delete a task branch.", description: "Auto-save if needed, clean preview resources, and remove the task branch across market and checked-out package repos.", provider: "default", related: ["tasks", "switch", "stage"] }),
-  operation({ id: "branch.stage", name: "stage", aliases: [], group: "Workflow", summary: "Promote a locally verified task branch to staging across market and packages.", description: "Merge staging down into the task branch first, run local proof, promote exact verified root and package refs to staging, verify remote staging refs, and clean up only after promotion succeeds.", provider: "default", related: ["save", "release", "close"] }),
-  operation({ id: "release.candidate", name: "release-candidate", aliases: [], group: "Validation", summary: "Plan and run reusable release proof records for staging promotion.", description: "Build the exact-SHA proof graph for package, hosted workflow, and provider verification. GitHub-hosted workflow proof is authoritative; local and action-simulation proof is reusable but not a hosted CI substitute.", provider: "default", related: ["stage", "release", "save"] }),
-  operation({ id: "release.proof", name: "proof", aliases: [], group: "Validation", summary: "Plan, run, and inspect reusable release proof records.", description: "Manage exact-SHA release proof records for packages, hosted workflows, and provider verification. GitHub-hosted workflow proof is authoritative; local action simulation is advisory.", provider: "default", related: ["save", "release-candidate", "ci"] }),
-  operation({ id: "workspace.resume", name: "resume", aliases: [], group: "Workflow", summary: "Resume an interrupted workflow run.", description: "Continue a failed journaled workflow run from its next incomplete step after validating current workspace preconditions.", provider: "default", related: ["recover", "status"] }),
-  operation({ id: "workspace.recover", name: "recover", aliases: [], group: "Workflow", summary: "Inspect active workflow locks and interrupted runs.", description: "List active workflow locks, resumable interrupted runs, and the exact commands needed to continue or recover the workspace state.", provider: "default", related: ["resume", "status"] }),
-  operation({ id: "workspace.links.status", name: workspaceCommand("status"), aliases: [], group: "Utilities", summary: "Inspect local workspace dependency links.", description: "Inspect whether Treeseed package dependencies are linked to local package checkouts or resolved through deployment references.", provider: "default", related: ["dev", "save"] }),
-  operation({ id: "workspace.links.link", name: workspaceCommand("link"), aliases: [], group: "Utilities", summary: "Link local Treeseed workspace packages.", description: "Create local node_modules links from internal Treeseed dependencies to checked-out package repositories for integrated development.", provider: "default", related: ["dev", workspaceCommand("status")] }),
-  operation({ id: "workspace.links.unlink", name: workspaceCommand("unlink"), aliases: [], group: "Utilities", summary: "Remove managed local workspace package links.", description: "Remove Treeseed-managed local workspace links before deployment-style installs or lockfile repair.", provider: "default", related: ["save", workspaceCommand("status")] }),
-  operation({ id: "deploy.rollback", name: "rollback", aliases: [], group: "Workflow", summary: "Roll back staging or production to a recorded deployment.", description: "Redeploy a previously recorded staging or production commit using a temporary checkout of that revision.", provider: "default", related: ["status", "release"] }),
-  operation({ id: "workspace.doctor", name: "doctor", aliases: [], group: "Validation", summary: "Diagnose Treeseed tooling, auth, and workflow readiness.", description: "Collect doctor-style diagnostics for workspace readiness and optional safe repairs.", provider: "default", related: ["status", "config"] }),
-  operation({ id: "workspace.install", name: "install", aliases: [], group: "Utilities", summary: "Install Treeseed-managed local dependencies.", description: "Install or repair Treeseed-managed CLI dependencies including GitHub CLI, Wrangler, Railway, Copilot, and optional gh-act support.", provider: "default", related: ["config", "doctor"] }),
-  operation({ id: "workspace.tools", name: "tools", aliases: [], group: "Utilities", summary: "Report Treeseed-managed executable locations.", description: "Inspect Treeseed-managed executable paths, invocation commands, cache roots, and GitHub CLI authentication state without installing or mutating tools.", provider: "default", related: ["install", "doctor"] }),
-  operation({ id: "workspace.cleanup", name: "cleanup", aliases: [], group: "Utilities", summary: "Prune local generated artifacts and package caches before long verification.", description: "Remove local Treeseed temporary/cache directories, generated scene and release evidence, npm cache, and optional Docker images and volumes.", provider: "default", related: ["save", "stage", "release"] }),
-  operation({ id: "auth.login", name: "auth:login", aliases: [], group: "Validation", summary: "Authenticate against the configured Treeseed API.", description: "Start the device login flow against the active Treeseed API host and persist the returned session locally.", provider: "default", related: ["auth:check", "auth:whoami", "auth:logout"] }),
-  operation({ id: "auth.logout", name: "auth:logout", aliases: [], group: "Validation", summary: "Clear locally stored Treeseed API credentials.", description: "Remove the persisted local device-flow session for the active Treeseed API host.", provider: "default", related: ["auth:login", "auth:whoami"] }),
-  operation({ id: "auth.whoami", name: "auth:whoami", aliases: [], group: "Validation", summary: "Inspect the active Treeseed API identity.", description: "Use the persisted local remote session to query the active Treeseed API principal.", provider: "default", related: ["auth:login", "status"] }),
-  operation({ id: "secrets.status", name: "secrets:status", aliases: [], group: "Validation", summary: "Inspect the local wrapped machine-key session.", description: "Report whether the local key agent is running, whether the wrapped machine key exists, and whether the secret session is unlocked.", provider: "default", related: ["secrets:unlock", "secrets:lock"] }),
-  operation({ id: "secrets.unlock", name: "secrets:unlock", aliases: [], group: "Validation", summary: "Unlock the local Treeseed secret session.", description: "Unlock the host-local Treeseed key agent from an interactive passphrase prompt or an explicit startup passphrase env var.", provider: "default", related: ["secrets:status", "secrets:lock", "secrets:migrate-key"] }),
-  operation({ id: "secrets.lock", name: "secrets:lock", aliases: [], group: "Validation", summary: "Lock the local Treeseed secret session.", description: "Clear the in-memory machine key from the host-local Treeseed key agent.", provider: "default", related: ["secrets:status", "secrets:unlock"] }),
-  operation({ id: "secrets.migrateKey", name: "secrets:migrate-key", aliases: [], group: "Validation", summary: "Wrap a legacy plaintext machine key.", description: "Replace the legacy plaintext machine-key file with the wrapped passphrase-protected format used by the Treeseed key agent.", provider: "default", related: ["secrets:unlock", "secrets:rotate-passphrase"] }),
-  operation({ id: "secrets.rotatePassphrase", name: "secrets:rotate-passphrase", aliases: [], group: "Validation", summary: "Rotate the wrapped machine-key passphrase.", description: "Re-wrap the existing machine key with a newly entered passphrase without changing the underlying machine key.", provider: "default", related: ["secrets:unlock", "secrets:rotate-machine-key"] }),
-  operation({ id: "secrets.rotateMachineKey", name: "secrets:rotate-machine-key", aliases: [], group: "Validation", summary: "Rotate the encrypted machine key itself.", description: "Generate a new machine key, re-encrypt stored local secrets and remote auth sessions, and re-wrap the result with the configured passphrase.", provider: "default", related: ["config", "secrets:rotate-passphrase"] }),
-  operation({ id: "template.list", name: "template", aliases: [], group: "Utilities", summary: "List, inspect, and validate templates from the Treeseed catalog.", description: "Use remote template metadata to list templates, show one template, or validate local template artifacts.", provider: "default", related: ["init", "sync"] }),
-  operation({ id: "template.sync", name: "sync", aliases: [], group: "Validation", summary: "Validate or reconcile the managed template surface for the current site.", description: "Use remote template metadata plus the local scaffold artifact to check or apply updates to the managed scaffold surface.", provider: "default", related: ["template", "init", "status"] }),
-  operation({ id: "project.init", name: "init", aliases: [], group: "Workflow", summary: "Scaffold a new Treeseed tenant project.", description: "Create a new Treeseed tenant directory from a remote-catalog template backed by the packaged scaffold artifact.", provider: "default", related: ["config", "switch", "dev"] }),
-  operation({ id: "project.config", name: "config", aliases: [], group: "Workflow", summary: "Configure and test the runtime foundation.", description: "Apply safe repairs, collect environment values, write local machine config, initialize environments, sync providers, and run doctor-style checks.", provider: "default", related: ["status", "switch", "dev"] }),
-  operation({ id: "hub.planLaunch", name: "hub.plan_launch", aliases: [], group: "Workflow", summary: "Plan an online Knowledge Hub launch.", description: "Normalize a Knowledge Hub launch intent, resolve repository topology, and return the durable launch plan shared by CLI and Market.", provider: "default", related: ["hub.validate_launch", "hub.execute_launch"] }),
-  operation({ id: "hub.validateLaunch", name: "hub.validate_launch", aliases: [], group: "Validation", summary: "Validate an online Knowledge Hub launch intent.", description: "Validate the shared Knowledge Hub launch intent and repository plan before execution.", provider: "default", related: ["hub.plan_launch", "hub.execute_launch"] }),
-  operation({ id: "hub.executeLaunch", name: "hub.execute_launch", aliases: [], group: "Workflow", summary: "Execute an online Knowledge Hub launch.", description: "Execute a Knowledge Hub launch through the shared SDK launch contract.", provider: "default", related: ["hub.plan_launch", "hub.resume_launch"] }),
-  operation({ id: "hub.resumeLaunch", name: "hub.resume_launch", aliases: [], group: "Workflow", summary: "Resume an online Knowledge Hub launch.", description: "Resume a previously planned Knowledge Hub launch from durable launch state.", provider: "default", related: ["hub.execute_launch"] }),
-  operation({ id: "hub.planUpdate", name: "hub.plan_update", aliases: [], group: "Workflow", summary: "Plan a Knowledge Hub update.", description: "Create a preview plan for template, knowledge pack, runtime, capability, or repository-topology updates.", provider: "default", related: ["hub.validate_update", "hub.execute_update"] }),
-  operation({ id: "hub.validateUpdate", name: "hub.validate_update", aliases: [], group: "Validation", summary: "Validate a Knowledge Hub update plan.", description: "Validate a planned update before it becomes binding work.", provider: "default", related: ["hub.plan_update"] }),
-  operation({ id: "hub.executeUpdate", name: "hub.execute_update", aliases: [], group: "Workflow", summary: "Execute a Knowledge Hub update.", description: "Apply a capability-gated Knowledge Hub update after required review or Decision approval.", provider: "default", related: ["hub.plan_update", "hub.resume_update"] }),
-  operation({ id: "hub.resumeUpdate", name: "hub.resume_update", aliases: [], group: "Workflow", summary: "Resume a Knowledge Hub update.", description: "Resume a previously planned Knowledge Hub update from durable state.", provider: "default", related: ["hub.execute_update"] }),
-  operation({ id: "repositoryHost.validate", name: "repository_host.validate", aliases: [], group: "Validation", summary: "Validate Repository Host configuration.", description: "Validate a GitHub Repository Host for Knowledge Hub repository provisioning.", provider: "default", related: ["repository_host.create_repositories"] }),
-  operation({ id: "repositoryHost.createRepositories", name: "repository_host.create_repositories", aliases: [], group: "Workflow", summary: "Create or connect Knowledge Hub repositories.", description: "Create or connect the software and content repositories for a Knowledge Hub repository plan.", provider: "default", related: ["hub.plan_launch"] }),
-  operation({ id: "content.verifyPackage", name: "content.verify_package", aliases: [], group: "Validation", summary: "Verify a content package before publishing.", description: "Verify Knowledge Hub content package metadata before publishing content artifacts.", provider: "default", related: ["content.publish"] }),
-  operation({ id: "content.publish", name: "content.publish", aliases: [], group: "Workflow", summary: "Publish Knowledge Hub content artifacts.", description: "Publish verified Knowledge Hub content artifacts to the configured content target.", provider: "default", related: ["content.verify_package"] }),
-  operation({ id: "workspace.planAttachParent", name: "workspace.plan_attach_parent", aliases: [], group: "Workflow", summary: "Plan parent workspace attachment.", description: "Plan how a Knowledge Hub software/content repository pair attaches to a parent repository workspace.", provider: "default", related: ["workspace.attach_parent"] }),
-  operation({ id: "workspace.attachParent", name: "workspace.attach_parent", aliases: [], group: "Workflow", summary: "Attach a parent workspace.", description: "Attach a parent repository workspace after technical steward approval.", provider: "default", related: ["workspace.plan_attach_parent", "workspace.update_submodule_pointers"] }),
-  operation({ id: "workspace.updateSubmodulePointers", name: "workspace.update_submodule_pointers", aliases: [], group: "Workflow", summary: "Update workspace submodule pointers.", description: "Update parent workspace submodule pointers for software and content repositories.", provider: "default", related: ["workspace.attach_parent"] }),
-  operation({ id: "project.export", name: "export", aliases: [], group: "Utilities", summary: "Export a Markdown snapshot of the current codebase.", description: "Generate a Markdown codebase snapshot for the selected directory using the SDK-owned repomix integration and store it under .treeseed/exports.", provider: "default", related: ["status", "config"] }),
-  operation({ id: "deploy.release", name: "release", aliases: [], group: "Workflow", summary: "Release changed packages and market from staging to production.", description: "Select changed packages plus dependents, validate publish workflows, release packages first, then promote market from staging to main with aligned package pointers.", provider: "default", related: ["stage", "status", "rollback"] }),
-  operation({ id: "deploy.destroy", name: "destroy", aliases: [], group: "Workflow", summary: "Destroy a persistent environment and its local state.", description: "Delete the selected persistent environment resources and remove the local deploy state after confirmation.", provider: "default", related: ["config", "status"] }),
-  operation({ id: "local.dev", name: "dev", aliases: [], group: "Local Development", summary: "Start the local Treeseed Market web/API development environment.", description: "Start the local Treeseed Market web/API development environment. Capacity provider lifecycle is handled by the capacity command.", provider: "default" }),
-  operation({ id: "local.build", name: "build", aliases: [], group: "Local Development", summary: "Build the tenant site and generated worker artifacts.", description: "Build the tenant site and generated worker artifacts.", provider: "default" }),
-  operation({ id: "local.check", name: "check", aliases: [], group: "Local Development", summary: "Run the tenant check flow.", description: "Run the tenant check flow.", provider: "default" }),
-  operation({ id: "local.preview", name: "preview", aliases: [], group: "Local Development", summary: "Preview the built tenant site locally.", description: "Preview the built tenant site locally.", provider: "default" }),
-  operation({ id: "local.lint", name: "lint", aliases: [], group: "Validation", summary: "Run Treeseed lint checks.", description: "Run Treeseed lint checks.", provider: "default" }),
-  operation({ id: "local.test", name: "test", aliases: [], group: "Validation", summary: "Run Treeseed tests.", description: "Run Treeseed tests.", provider: "default" }),
-  operation({ id: "validation.testUnit", name: "test:unit", aliases: [], group: "Validation", summary: "Run workspace unit tests in dependency order.", description: "Run workspace unit tests in dependency order.", provider: "default" }),
-  operation({ id: "validation.preflight", name: "preflight", aliases: [], group: "Validation", summary: "Check local prerequisites and authentication state.", description: "Check local prerequisites and authentication state.", provider: "default" }),
-  operation({ id: "validation.authCheck", name: "auth:check", aliases: [], group: "Validation", summary: "Check local prerequisites and require authenticated tooling.", description: "Check local prerequisites and require authenticated tooling.", provider: "default" }),
-  operation({ id: "release.testE2e", name: "test:e2e", aliases: [], group: "Release Utilities", summary: "Run Treeseed end-to-end command tests.", description: "Run Treeseed end-to-end command tests.", provider: "default" }),
-  operation({ id: "release.testE2eLocal", name: "test:e2e:local", aliases: [], group: "Release Utilities", summary: "Run local-mode Treeseed end-to-end command tests.", description: "Run local-mode Treeseed end-to-end command tests.", provider: "default" }),
-  operation({ id: "release.testE2eStaging", name: "test:e2e:staging", aliases: [], group: "Release Utilities", summary: "Run staging-mode Treeseed end-to-end command tests.", description: "Run staging-mode Treeseed end-to-end command tests.", provider: "default" }),
-  operation({ id: "release.testE2eFull", name: "test:e2e:full", aliases: [], group: "Release Utilities", summary: "Run the full Treeseed end-to-end command suite.", description: "Run the full Treeseed end-to-end command suite.", provider: "default" }),
-  operation({ id: "release.testFast", name: "test:release", aliases: [], group: "Release Utilities", summary: "Run the fast release verification path.", description: "Run the fast release verification path.", provider: "default" }),
-  operation({ id: "release.verify", name: "test:release:full", aliases: ["release:verify"], group: "Release Utilities", summary: "Run the full release verification path.", description: "Run the full release verification path.", provider: "default" }),
-  operation({ id: "release.publishChanged", name: "release:publish:changed", aliases: [], group: "Release Utilities", summary: "Publish changed Treeseed workspace packages.", description: "Publish changed Treeseed workspace packages.", provider: "default" }),
-  operation({ id: "tools.astro", name: "astro", aliases: [], group: "Passthrough", summary: "Pass through to the packaged Astro CLI wrapper.", description: "Pass through to the packaged Astro CLI wrapper.", provider: "default" }),
-  operation({ id: "data.d1MigrateLocal", name: "d1:migrate:local", aliases: [], group: "Utilities", summary: "Apply local D1 migrations.", description: "Apply local D1 migrations.", provider: "default" }),
-  operation({ id: "content.cleanupMarkdown", name: "cleanup:markdown", aliases: [], group: "Utilities", summary: "Normalize Markdown and MDX files.", description: "Normalize Markdown and MDX files.", provider: "default" }),
-  operation({ id: "content.cleanupMarkdownCheck", name: "cleanup:markdown:check", aliases: [], group: "Utilities", summary: "Check Markdown and MDX formatting without rewriting files.", description: "Check Markdown and MDX formatting without rewriting files.", provider: "default" }),
-  operation({ id: "tools.starlightPatch", name: "starlight:patch", aliases: [], group: "Utilities", summary: "Apply the Starlight content path patch.", description: "Apply the Starlight content path patch.", provider: "default" })
-];
-const TRESEED_OPERATION_INDEX = /* @__PURE__ */ new Map();
-for (const spec of TRESEED_OPERATION_SPECS) {
-  TRESEED_OPERATION_INDEX.set(spec.name, spec);
-  for (const alias of spec.aliases) {
-    TRESEED_OPERATION_INDEX.set(alias, spec);
-  }
-}
-function findTreeseedOperation(name) {
-  if (!name) return null;
-  return TRESEED_OPERATION_INDEX.get(name) ?? null;
-}
-function listTreeseedOperationNames() {
-  return [...new Set(TRESEED_OPERATION_SPECS.map((spec) => spec.name))];
-}
-export {
-  TRESEED_OPERATION_INDEX,
-  TRESEED_OPERATION_SPECS,
-  findTreeseedOperation,
-  listTreeseedOperationNames
-};

package/dist/operations-types.d.ts

@@ -1,75 +0,0 @@
-export type TreeseedOperationGroup = 'Workflow' | 'Local Development' | 'Validation' | 'Release Utilities' | 'Utilities' | 'Passthrough';
-export type TreeseedOperationId = 'workspace.status' | 'workspace.doctor' | 'branch.tasks' | 'branch.switch' | 'branch.save' | 'branch.close' | 'branch.stage' | 'deploy.release' | 'deploy.rollback' | 'deploy.destroy' | 'workspace.resume' | 'workspace.recover' | 'template.list' | 'template.show' | 'template.validate' | 'template.sync' | 'project.init' | 'project.config' | 'local.dev' | 'local.devWatch' | 'local.build' | 'local.check' | 'local.preview' | 'local.lint' | 'local.test' | 'validation.testUnit' | 'validation.preflight' | 'validation.authCheck' | 'auth.login' | 'auth.logout' | 'auth.whoami' | 'release.testE2e' | 'release.testE2eLocal' | 'release.testE2eStaging' | 'release.testE2eFull' | 'release.testFast' | 'release.verify' | 'release.publishChanged' | 'data.d1MigrateLocal' | 'content.cleanupMarkdown' | 'content.cleanupMarkdownCheck' | 'project.export' | 'tools.astro' | 'tools.syncDevvars' | 'tools.starlightPatch' | 'agents.run';
-export type TreeseedOperationProviderId = 'default';
-export type TreeseedOperationMetadata = {
-    id: TreeseedOperationId;
-    name: string;
-    aliases: string[];
-    group: TreeseedOperationGroup;
-    summary: string;
-    description: string;
-    provider: TreeseedOperationProviderId;
-    related?: string[];
-};
-export type TreeseedOperationRequest = {
-    operationName: string;
-    input?: Record<string, unknown>;
-};
-export type TreeseedOperationResult<TPayload = Record<string, unknown>> = {
-    operation: TreeseedOperationId;
-    ok: boolean;
-    payload?: TPayload | null;
-    meta?: Record<string, unknown>;
-    nextSteps?: Array<{
-        operation: string;
-        reason?: string;
-        input?: Record<string, unknown>;
-    }>;
-    exitCode?: number;
-    stdout?: string[];
-    stderr?: string[];
-    report?: Record<string, unknown> | null;
-};
-export type TreeseedOperationWriter = (output: string, stream?: 'stdout' | 'stderr') => void;
-export type TreeseedOperationPrompt = (message: string) => Promise<string> | string;
-export type TreeseedOperationConfirm = (message: string, expected: string) => Promise<boolean> | boolean;
-export type TreeseedOperationSpawn = (command: string, args: string[], options: {
-    cwd: string;
-    env: NodeJS.ProcessEnv;
-    stdio?: 'inherit' | 'pipe';
-    timeout?: number;
-    killSignal?: NodeJS.Signals;
-}) => {
-    status?: number | null;
-};
-export type TreeseedOperationContext = {
-    cwd: string;
-    env: NodeJS.ProcessEnv;
-    write?: TreeseedOperationWriter;
-    onProgress?: (event: Record<string, unknown>) => void | Promise<void>;
-    spawn?: TreeseedOperationSpawn;
-    outputFormat?: 'human' | 'json';
-    prompt?: TreeseedOperationPrompt;
-    confirm?: TreeseedOperationConfirm;
-    transport?: 'sdk' | 'cli' | 'api';
-};
-export type TreeseedOperationFailureCode = 'validation_failed' | 'merge_conflict' | 'missing_runtime_auth' | 'deployment_timeout' | 'confirmation_required' | 'unsupported_transport' | 'unsupported_state' | 'workflow_locked' | 'resume_unavailable' | 'workflow_contract_missing' | 'provider_resolution_failed';
-export declare class TreeseedOperationError extends Error {
-    code: TreeseedOperationFailureCode;
-    operation: string;
-    details?: Record<string, unknown>;
-    exitCode?: number;
-    constructor(operation: string, code: TreeseedOperationFailureCode, message: string, options?: {
-        details?: Record<string, unknown>;
-        exitCode?: number;
-    });
-}
-export interface TreeseedOperationImplementation<TInput extends Record<string, unknown> = Record<string, unknown>, TPayload = Record<string, unknown>> {
-    readonly metadata: TreeseedOperationMetadata;
-    execute(input: TInput, context: TreeseedOperationContext): Promise<TreeseedOperationResult<TPayload>>;
-}
-export interface TreeseedOperationProvider {
-    readonly id: TreeseedOperationProviderId | string;
-    listOperations(): TreeseedOperationImplementation[];
-    findOperation(name: string | null | undefined): TreeseedOperationImplementation | null;
-}

package/dist/operations-types.js

@@ -1,17 +0,0 @@
-class TreeseedOperationError extends Error {
-  code;
-  operation;
-  details;
-  exitCode;
-  constructor(operation, code, message, options = {}) {
-    super(message);
-    this.name = "TreeseedOperationError";
-    this.operation = operation;
-    this.code = code;
-    this.details = options.details;
-    this.exitCode = options.exitCode;
-  }
-}
-export {
-  TreeseedOperationError
-};

package/dist/operations.d.ts

@@ -1,17 +0,0 @@
-export { TRESEED_OPERATION_SPECS, findTreeseedOperation, listTreeseedOperationNames, } from './operations-registry.js';
-export { collectTreeseedConfigSeedValues } from './operations/services/config-runtime.js';
-export { createKnowledgeHubRepositories, defaultHubContentResolutionPolicy, executeKnowledgeHubLaunch, normalizeKnowledgeHubLaunchIntent, planKnowledgeHubLaunch, planKnowledgeHubRepositories, validateRepositoryHost, } from './operations/services/hub-launch.js';
-export { TreeseedOperationsSdk } from './operations/runtime.js';
-export { cancelGitHubWorkflowRun, formatGitHubWorkflowFailure, waitForGitHubWorkflowRunCompletion, type GitHubWorkflowCancellationResult, type GitHubWorkflowFailureSummary, type GitHubWorkflowFailureSummaryInput, type GitHubWorkflowProgressEvent, } from './operations/services/github-api.js';
-export { computeProofInputHash, createProofRecord, proofIdFor, type TreeseedProofDriver, type TreeseedProofInput, type TreeseedProofRecord, type TreeseedProofStatus, type TreeseedProofSubject, type TreeseedProofSubjectKind, } from './operations/services/release-proof.js';
-export { cleanProofLedger, findReusableProof, invalidateProofs, readProofLedger, writeProofRecord, } from './operations/services/release-proof-ledger.js';
-export { buildTreeseedProofPlan, summarizeTreeseedProofLedger, type TreeseedProofPlan, type TreeseedProofPlanSubject, type TreeseedProofTarget, } from './operations/services/release-proof-planner.js';
-export { runTreeseedProof, type TreeseedProofRunResult, } from './operations/services/release-proof-runner.js';
-export { createTreeseedWorkflowTimer, formatTreeseedDuration, slowestTreeseedWorkflowPhases, type TreeseedWorkflowTiming, type TreeseedWorkflowTimingPhase, } from './operations/services/workflow-timing.js';
-export { classifyTreeseedGitMode, inspectTreeseedGitLocks, inspectTreeseedWorkspaceGitLocks, recoverTreeseedGitLocks, runTreeseedGit, runTreeseedGitBatch, runTreeseedGitOk, runTreeseedGitText, type TreeseedGitBatchOperation, type TreeseedGitLockDiagnostic, type TreeseedGitRunnerMode, type TreeseedGitRunnerResult, type TreeseedGitWorkspaceLockDiagnostics, } from './operations/services/git-runner.js';
-export type { HubContentResolutionPolicy, KnowledgeHubLaunchIntent, KnowledgeHubLaunchPhase, KnowledgeHubLaunchPlan, KnowledgeHubLaunchResult, KnowledgeHubRepositoryPlan, RepositoryHost, } from './operations/services/hub-launch.js';
-export type { TreeseedOperationContext, TreeseedOperationImplementation, TreeseedOperationId, TreeseedOperationMetadata, TreeseedOperationProvider, TreeseedOperationProviderId, TreeseedOperationRequest, TreeseedOperationResult, TreeseedOperationGroup, } from './operations-types.js';
-export { TreeseedOperationError } from './operations-types.js';
-export { AGENT_OPERATION_MODES, AGENT_OPERATION_NAMES, createAgentOperationEvent, decideAgentOperationPermission, deniedAgentOperationResult, isAgentOperationName, resolveAgentOperationGrant, type AgentDeterministicOperationStep, type AgentOperationEvent, type AgentOperationGrant, type AgentOperationMergeFailure, type AgentOperationMode, type AgentOperationName, type AgentOperationPermissionCode, type AgentOperationPermissionDecision, type AgentOperationRequest, type AgentOperationResult, type AgentOperationStatus, } from './operations/agent-tools.js';
-export { TreeseedWorkflowSdk } from './workflow.js';
-export type * from './workflow.js';