@treeseed/sdk 0.12.62 → 0.13.0-rc.10

package/dist/operations/services/railway-source-policy.d.ts

@@ -1,25 +0,0 @@
-export type TreeseedRailwaySourcePolicyScope = 'local' | 'staging' | 'prod';
-export type TreeseedRailwaySourcePolicyService = {
-    key?: string | null;
-    serviceName?: string | null;
-    sourceMode?: string | null;
-    sourceRepo?: string | null;
-    sourceBranch?: string | null;
-    sourceCommit?: string | null;
-    sourceRootDirectory?: string | null;
-    imageRef?: string | null;
-    dockerfilePath?: string | null;
-    buildCommand?: string | null;
-    startCommand?: string | null;
-};
-export type TreeseedRailwaySourceIdentity = TreeseedRailwaySourcePolicyService & {
-    environment?: string | null;
-};
-export declare function railwayEnvironmentQualifiedServiceName(serviceName: string, scope: TreeseedRailwaySourcePolicyScope | string): string;
-export declare function railwayTreeDxServiceName(index: number, scope: string): string;
-export declare function assertNoRailwaySourceIdentityCollisions(services: TreeseedRailwaySourceIdentity[]): void;
-export declare function isApiRailwaySourcePolicyService(service: TreeseedRailwaySourcePolicyService): boolean;
-export declare function isImmutableRailwayImageRef(value: unknown): boolean;
-export declare function apiRailwayDefaultSourceRepo(service: TreeseedRailwaySourcePolicyService): "treeseed-ai/treedx" | "treeseed-ai/api" | null;
-export declare function apiRailwayDefaultDockerfilePath(service: TreeseedRailwaySourcePolicyService): "/Dockerfile.api" | "/Dockerfile.operations-runner" | "/Dockerfile" | null;
-export declare function assertApiRailwaySourcePolicy(scope: TreeseedRailwaySourcePolicyScope | string, service: TreeseedRailwaySourcePolicyService): void;

package/dist/operations/services/railway-source-policy.js

@@ -1,111 +0,0 @@
-const SOURCE_DIVERGENT_ENVIRONMENT_SUFFIX = /-(?:staging|production)(?=-\d+$|$)/u;
-function railwayEnvironmentQualifiedServiceName(serviceName, scope) {
-  const normalizedName = String(serviceName ?? "").trim();
-  const suffix = scope === "prod" || scope === "production" ? "production" : scope === "staging" ? "staging" : null;
-  if (!normalizedName || !suffix) return normalizedName;
-  const unqualifiedName = normalizedName.replace(SOURCE_DIVERGENT_ENVIRONMENT_SUFFIX, "");
-  const indexedName = /^(.*?)(-\d+)$/u.exec(unqualifiedName);
-  return indexedName ? `${indexedName[1]}-${suffix}${indexedName[2]}` : `${unqualifiedName}-${suffix}`;
-}
-function railwayTreeDxServiceName(index, scope) {
-  const normalizedIndex = String(Math.max(1, Math.trunc(index))).padStart(2, "0");
-  return railwayEnvironmentQualifiedServiceName(`treeseed-treedx-${normalizedIndex}`, scope);
-}
-function railwaySourceSignature(service) {
-  return JSON.stringify({
-    sourceMode: service.sourceMode ?? null,
-    sourceRepo: service.sourceRepo ?? null,
-    sourceBranch: service.sourceBranch ?? null,
-    sourceRootDirectory: service.sourceRootDirectory ?? null,
-    imageRef: service.imageRef ?? null,
-    dockerfilePath: service.dockerfilePath ?? null,
-    buildCommand: service.buildCommand ?? null
-  });
-}
-function assertNoRailwaySourceIdentityCollisions(services) {
-  const identities = /* @__PURE__ */ new Map();
-  for (const service of services) {
-    const serviceName = String(service.serviceName ?? "").trim();
-    if (!serviceName) continue;
-    const existing = identities.get(serviceName);
-    if (existing && railwaySourceSignature(existing) !== railwaySourceSignature(service)) {
-      throw new Error(
-        `${serviceName}: Railway service identity is shared by ${existing.environment ?? "one environment"} and ${service.environment ?? "another environment"} with different source/build configurations. Use environment-qualified service names.`
-      );
-    }
-    identities.set(serviceName, service);
-  }
-}
-function isApiRailwaySourcePolicyService(service) {
-  const key = String(service.key ?? "").trim();
-  const serviceName = String(service.serviceName ?? "").trim();
-  return key.startsWith("public-treedx-node-") || /^treeseed-api(?:-(?:staging|production))?$/u.test(serviceName) || /^treeseed-api-operations-runner(?:-(?:staging|production))?(?:-\d+)?$/u.test(serviceName) || /^treeseed-ops(?:-(?:staging|production))?-\d+$/u.test(serviceName) || /^public-treedx-node(?:-(?:staging|production))?-\d+$/u.test(serviceName) || /^treeseed-treedx(?:-(?:staging|production))?-\d+$/u.test(serviceName);
-}
-function isImmutableRailwayImageRef(value) {
-  const imageRef = typeof value === "string" ? value.trim() : "";
-  if (!imageRef || !imageRef.includes(":")) return false;
-  const tag = imageRef.split(":").pop()?.trim() ?? "";
-  return Boolean(tag) && !["latest", "staging", "dev", "local"].includes(tag);
-}
-function apiRailwayDefaultSourceRepo(service) {
-  const serviceName = String(service.serviceName ?? "").trim();
-  if (String(service.key ?? "") === "api" || String(service.key ?? "") === "operationsRunner" || /^treeseed-api(?:-(?:staging|production))?$/u.test(serviceName) || /^treeseed-api-operations-runner(?:-(?:staging|production))?(?:-\d+)?$/u.test(serviceName)) return "treeseed-ai/api";
-  if (/^public-treedx-node(?:-(?:staging|production))?-\d+$/u.test(serviceName) || String(service.key ?? "").startsWith("public-treedx-node-")) return "treeseed-ai/treedx";
-  return null;
-}
-function apiRailwayDefaultDockerfilePath(service) {
-  const serviceName = String(service.serviceName ?? "").trim();
-  if (String(service.key ?? "") === "api" || /^treeseed-api(?:-(?:staging|production))?$/u.test(serviceName)) return "/Dockerfile.api";
-  if (String(service.key ?? "") === "operationsRunner" || /^treeseed-api-operations-runner(?:-(?:staging|production))?(?:-\d+)?$/u.test(serviceName)) return "/Dockerfile.operations-runner";
-  if (/^public-treedx-node(?:-(?:staging|production))?-\d+$/u.test(serviceName) || String(service.key ?? "").startsWith("public-treedx-node-")) return "/Dockerfile";
-  return null;
-}
-function assertApiRailwaySourcePolicy(scope, service) {
-  if (!isApiRailwaySourcePolicyService(service)) return;
-  const normalizedScope = scope === "prod" ? "prod" : scope === "staging" ? "staging" : "local";
-  const label = service.serviceName ?? service.key ?? "Railway service";
-  const serviceName = String(service.serviceName ?? "").trim();
-  const expectedServiceName = railwayEnvironmentQualifiedServiceName(serviceName, normalizedScope);
-  if (normalizedScope === "staging") {
-    const issues = [
-      serviceName === expectedServiceName && /-staging(?:-|$)/u.test(serviceName) ? null : `serviceName must be ${expectedServiceName}`,
-      service.sourceMode === "git" ? null : "sourceMode must be git",
-      service.imageRef ? "imageRef must be empty" : null,
-      service.sourceRepo ? null : "sourceRepo must be set",
-      service.sourceBranch === "staging" ? null : "sourceBranch must be staging",
-      service.sourceRootDirectory ? null : "sourceRootDirectory must be set",
-      service.dockerfilePath ? null : "dockerfilePath must be set"
-    ].filter((issue) => Boolean(issue));
-    if (issues.length > 0) {
-      throw new Error(`${label}: API Railway staging services must use GitHub Dockerfile source builds (${issues.join("; ")}).`);
-    }
-    return;
-  }
-  if (normalizedScope === "prod") {
-    const issues = [
-      serviceName === expectedServiceName && /-production(?:-|$)/u.test(serviceName) ? null : `serviceName must be ${expectedServiceName}`,
-      service.sourceMode === "image" ? null : "sourceMode must be image",
-      isImmutableRailwayImageRef(service.imageRef) ? null : "imageRef must be an immutable released image tag",
-      service.sourceRepo ? "sourceRepo must be empty" : null,
-      service.sourceBranch ? "sourceBranch must be empty" : null,
-      service.sourceCommit ? "sourceCommit must be empty" : null,
-      service.sourceRootDirectory ? "sourceRootDirectory must be empty" : null,
-      service.dockerfilePath ? "dockerfilePath must be empty" : null,
-      service.buildCommand ? "buildCommand must be empty" : null,
-      service.startCommand ? "startCommand must be empty" : null
-    ].filter((issue) => Boolean(issue));
-    if (issues.length > 0) {
-      throw new Error(`${label}: API Railway production services must use released Docker image sources (${issues.join("; ")}).`);
-    }
-  }
-}
-export {
-  apiRailwayDefaultDockerfilePath,
-  apiRailwayDefaultSourceRepo,
-  assertApiRailwaySourcePolicy,
-  assertNoRailwaySourceIdentityCollisions,
-  isApiRailwaySourcePolicyService,
-  isImmutableRailwayImageRef,
-  railwayEnvironmentQualifiedServiceName,
-  railwayTreeDxServiceName
-};

package/dist/operations/services/release-history.d.ts

@@ -1,59 +0,0 @@
-export type ReleaseHistoryCommit = {
-    sha: string;
-    subject: string;
-    body: string;
-};
-export type ReleaseHistorySection = 'Added' | 'Changed' | 'Fixed' | 'Infrastructure' | 'Tests' | 'Dependencies';
-export type ReleaseHistorySummary = {
-    version: string;
-    date: string;
-    sourceRef: string;
-    targetRef: string;
-    commitCount: number;
-    sections: Record<ReleaseHistorySection, string[]>;
-    notableCommits: ReleaseHistoryCommit[];
-    changelogPath: string;
-    changelogUpdated: boolean;
-    entry: string;
-};
-export declare function collectReleaseHistoryCommits(repoDir: string, sourceRef: string, targetRef: string, options?: {
-    maxCommits?: number;
-}): ReleaseHistoryCommit[];
-export declare function renderReleaseChangelogEntry(input: {
-    version: string;
-    date?: string;
-    commits: ReleaseHistoryCommit[];
-    extraBullets?: Partial<Record<ReleaseHistorySection, string[]>>;
-}): {
-    date: string;
-    sections: Record<ReleaseHistorySection, string[]>;
-    entry: string;
-};
-export declare function upsertReleaseChangelog(repoDir: string, input: {
-    version: string;
-    sourceRef: string;
-    targetRef: string;
-    commits: ReleaseHistoryCommit[];
-    extraBullets?: Partial<Record<ReleaseHistorySection, string[]>>;
-}): {
-    version: string;
-    date: string;
-    sourceRef: string;
-    targetRef: string;
-    commitCount: number;
-    sections: Record<ReleaseHistorySection, string[]>;
-    notableCommits: ReleaseHistoryCommit[];
-    changelogPath: string;
-    changelogUpdated: boolean;
-    entry: string;
-};
-export declare function renderAdministrativeCommitMessage(input: {
-    subject: string;
-    version?: string | null;
-    tagName?: string | null;
-    sourceRef: string;
-    targetRef: string;
-    commits: ReleaseHistoryCommit[];
-    changelog?: ReleaseHistorySummary | null;
-    extraLines?: string[];
-}): string;

package/dist/operations/services/release-history.js

@@ -1,158 +0,0 @@
-import { existsSync, readFileSync, writeFileSync } from "node:fs";
-import { resolve } from "node:path";
-import { runTreeseedGit } from "./git-runner.js";
-const SECTION_ORDER = [
-  "Added",
-  "Changed",
-  "Fixed",
-  "Infrastructure",
-  "Tests",
-  "Dependencies"
-];
-function runGit(repoDir, args) {
-  const result = runTreeseedGit(args, {
-    cwd: repoDir,
-    mode: "read"
-  });
-  if (result.status !== 0) {
-    throw new Error(result.stderr?.trim() || result.stdout?.trim() || `git ${args.join(" ")} failed`);
-  }
-  return result.stdout;
-}
-function shortSha(value) {
-  return value.slice(0, 12);
-}
-function cleanLine(value) {
-  return value.replace(/\s+/gu, " ").trim();
-}
-function bulletText(commit) {
-  const subject = cleanLine(commit.subject);
-  return subject ? `${subject} (${shortSha(commit.sha)})` : shortSha(commit.sha);
-}
-function sectionForCommit(commit) {
-  const value = `${commit.subject}
-${commit.body}`.toLowerCase();
-  if (/^(feat|add)(\(|:)/u.test(value) || /\badded?\b/u.test(value)) return "Added";
-  if (/^(fix|hotfix)(\(|:)/u.test(value) || /\bfix(e[ds])?\b|\bbug\b/u.test(value)) return "Fixed";
-  if (/^(test)(\(|:)/u.test(value) || /\btest(s|ing)?\b|\bverify\b/u.test(value)) return "Tests";
-  if (/^(deps?|build)(\(|:)/u.test(value) || /\bdependenc(y|ies)\b|\blockfile\b|\bpackage pointer\b/u.test(value)) return "Dependencies";
-  if (/^(ci|chore|release)(\(|:)/u.test(value) || /\bdeploy\b|\bworkflow\b|\brelease\b|\bsubmodule\b/u.test(value)) return "Infrastructure";
-  return "Changed";
-}
-function uniqueSectionBullets(commits) {
-  const sections = Object.fromEntries(SECTION_ORDER.map((section) => [section, []]));
-  const seen = /* @__PURE__ */ new Set();
-  for (const commit of commits) {
-    const bullet = bulletText(commit);
-    const key = bullet.toLowerCase();
-    if (seen.has(key)) continue;
-    seen.add(key);
-    sections[sectionForCommit(commit)].push(bullet);
-  }
-  return sections;
-}
-function collectReleaseHistoryCommits(repoDir, sourceRef, targetRef, options = {}) {
-  const maxCommits = options.maxCommits ?? 80;
-  const output = runGit(repoDir, [
-    "log",
-    "--no-merges",
-    `--max-count=${maxCommits}`,
-    "--format=%H%x1f%s%x1f%b%x1e",
-    `${sourceRef}..${targetRef}`
-  ]);
-  return output.split("").map((entry) => entry.trim()).filter(Boolean).map((entry) => {
-    const [sha = "", subject = "", body = ""] = entry.split("");
-    return { sha: sha.trim(), subject: subject.trim(), body: body.trim() };
-  }).filter((commit) => commit.sha.length > 0);
-}
-function renderReleaseChangelogEntry(input) {
-  const date = input.date ?? (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-  const sections = uniqueSectionBullets(input.commits);
-  for (const [section, bullets] of Object.entries(input.extraBullets ?? {})) {
-    for (const bullet of bullets ?? []) {
-      const normalized = cleanLine(bullet);
-      if (normalized) sections[section].push(normalized);
-    }
-  }
-  const lines = [`## [${input.version}] - ${date}`, ""];
-  let wroteSection = false;
-  for (const section of SECTION_ORDER) {
-    const bullets = sections[section];
-    if (bullets.length === 0) continue;
-    wroteSection = true;
-    lines.push(`### ${section}`, "");
-    for (const bullet of bullets.slice(0, 20)) {
-      lines.push(`- ${bullet}`);
-    }
-    if (bullets.length > 20) {
-      lines.push(`- ${bullets.length - 20} additional change${bullets.length - 20 === 1 ? "" : "s"} omitted from this summary.`);
-    }
-    lines.push("");
-  }
-  if (!wroteSection) {
-    lines.push("### Changed", "", "- Release metadata and deployment history updated.", "");
-  }
-  return {
-    date,
-    sections,
-    entry: lines.join("\n").trimEnd()
-  };
-}
-function upsertReleaseChangelog(repoDir, input) {
-  const rendered = renderReleaseChangelogEntry(input);
-  const changelogPath = resolve(repoDir, "CHANGELOG.md");
-  const current = existsSync(changelogPath) ? readFileSync(changelogPath, "utf8") : "";
-  const title = "# Changelog";
-  const withoutExisting = current.replace(new RegExp(`^# Changelog\\s*\\n+## \\[${input.version.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&")}\\][\\s\\S]*?(?=\\n## \\[|$)`, "u"), `${title}
-
-`).trim();
-  const body = withoutExisting.startsWith(title) ? withoutExisting.slice(title.length).trim() : withoutExisting.trim();
-  const next = `${title}
-
-${rendered.entry}${body ? `
-
-${body}` : ""}
-`;
-  const changed = current !== next;
-  if (changed) {
-    writeFileSync(changelogPath, next, "utf8");
-  }
-  return {
-    version: input.version,
-    date: rendered.date,
-    sourceRef: input.sourceRef,
-    targetRef: input.targetRef,
-    commitCount: input.commits.length,
-    sections: rendered.sections,
-    notableCommits: input.commits.slice(0, 12),
-    changelogPath,
-    changelogUpdated: changed,
-    entry: rendered.entry
-  };
-}
-function renderAdministrativeCommitMessage(input) {
-  const lines = [
-    input.subject,
-    "",
-    "Release summary:",
-    input.version ? `- Version: ${input.version}` : null,
-    input.tagName ? `- Tag: ${input.tagName}` : null,
-    `- Source: ${input.sourceRef}`,
-    `- Target: ${input.targetRef}`,
-    `- Promoted commits: ${input.commits.length}`,
-    ...(input.extraLines ?? []).map((line) => `- ${line}`),
-    "",
-    "Notable changes:",
-    ...input.commits.length > 0 ? input.commits.slice(0, 12).map((commit) => `- ${bulletText(commit)}`) : ["- Release metadata and package pointers updated."],
-    input.commits.length > 12 ? `- ${input.commits.length - 12} additional promoted commit${input.commits.length - 12 === 1 ? "" : "s"} omitted from this summary.` : null,
-    input.changelog ? "" : null,
-    input.changelog ? "See CHANGELOG.md for the release history entry." : null
-  ].filter((line) => line !== null);
-  return lines.join("\n");
-}
-export {
-  collectReleaseHistoryCommits,
-  renderAdministrativeCommitMessage,
-  renderReleaseChangelogEntry,
-  upsertReleaseChangelog
-};

package/dist/operations/services/release-proof-ledger.d.ts

@@ -1,13 +0,0 @@
-import { type TreeseedProofDriver, type TreeseedProofInput, type TreeseedProofRecord } from './release-proof.js';
-export declare function readProofLedger(root: string): TreeseedProofRecord[];
-export declare function writeProofRecord(root: string, record: TreeseedProofRecord): void;
-export declare function findReusableProof(root: string, input: TreeseedProofInput & {
-    requiredDriver?: TreeseedProofDriver;
-}): TreeseedProofRecord | null;
-export declare function invalidateProofs(root: string, predicate: (record: TreeseedProofRecord) => boolean): void;
-export declare function cleanProofLedger(root: string, options: {
-    olderThanMs: number;
-    now?: number;
-}): {
-    removed: number;
-};

package/dist/operations/services/release-proof-ledger.js

@@ -1,81 +0,0 @@
-import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from "node:fs";
-import { dirname, resolve } from "node:path";
-import {
-  computeProofInputHash,
-  proofIdFor
-} from "./release-proof.js";
-const PROOF_DIR = ".treeseed/workflow/proofs";
-function proofRoot(root) {
-  return resolve(root, PROOF_DIR);
-}
-function proofPath(root, proofId) {
-  return resolve(proofRoot(root), `${proofId}.json`);
-}
-function isProofRecord(value) {
-  return Boolean(value && typeof value === "object" && value.schemaVersion === 1 && typeof value.proofId === "string" && typeof value.status === "string");
-}
-function readProofLedger(root) {
-  const dir = proofRoot(root);
-  if (!existsSync(dir)) return [];
-  const records = [];
-  for (const entry of readdirSync(dir)) {
-    if (!entry.endsWith(".json")) continue;
-    try {
-      const parsed = JSON.parse(readFileSync(resolve(dir, entry), "utf8"));
-      if (isProofRecord(parsed)) records.push(parsed);
-    } catch {
-    }
-  }
-  return records.sort((left, right) => String(right.finishedAt ?? "").localeCompare(String(left.finishedAt ?? "")));
-}
-function writeProofRecord(root, record) {
-  const filePath = proofPath(root, record.proofId);
-  mkdirSync(dirname(filePath), { recursive: true });
-  writeFileSync(filePath, `${JSON.stringify(record, null, 2)}
-`, "utf8");
-}
-function findReusableProof(root, input) {
-  const inputHash = input.inputs.inputHash || computeProofInputHash({
-    subject: input.subject,
-    driver: input.driver,
-    inputs: {
-      ...input.inputs,
-      dependencyProofIds: [...input.inputs.dependencyProofIds].sort(),
-      inputHash: void 0
-    }
-  });
-  const proofId = proofIdFor({
-    subject: input.subject,
-    driver: input.driver,
-    inputs: {
-      ...input.inputs,
-      inputHash,
-      dependencyProofIds: [...input.inputs.dependencyProofIds].sort()
-    }
-  });
-  return readProofLedger(root).find((record) => record.proofId === proofId && record.status === "passed" && record.reusable === true && record.inputs.inputHash === inputHash && record.driver === (input.requiredDriver ?? input.driver)) ?? null;
-}
-function invalidateProofs(root, predicate) {
-  for (const record of readProofLedger(root)) {
-    if (!predicate(record)) continue;
-    rmSync(proofPath(root, record.proofId), { force: true });
-  }
-}
-function cleanProofLedger(root, options) {
-  const now = options.now ?? Date.now();
-  let removed = 0;
-  for (const record of readProofLedger(root)) {
-    const finished = Date.parse(record.finishedAt ?? record.startedAt);
-    if (!Number.isFinite(finished) || now - finished < options.olderThanMs) continue;
-    rmSync(proofPath(root, record.proofId), { force: true });
-    removed += 1;
-  }
-  return { removed };
-}
-export {
-  cleanProofLedger,
-  findReusableProof,
-  invalidateProofs,
-  readProofLedger,
-  writeProofRecord
-};

package/dist/operations/services/release-proof-planner.d.ts

@@ -1,48 +0,0 @@
-import { type TreeseedPackageAdapter, type TreeseedPackageCommand } from './package-adapters.js';
-import { type TreeseedProofDriver, type TreeseedProofInput, type TreeseedProofRecord } from './release-proof.js';
-export type TreeseedProofTarget = 'local' | 'staging' | 'prod';
-export type TreeseedProofPlanMode = 'plan' | 'run' | 'status' | 'failures' | 'explain';
-export type TreeseedProofPlanSubject = TreeseedProofInput & {
-    workflow: string | null;
-    command: string | null;
-    commandSpec: TreeseedPackageCommand | null;
-    authority: 'authoritative' | 'advisory';
-    reusableProof: TreeseedProofRecord | null;
-    rerunReasons: string[];
-};
-export type TreeseedProofPlan = {
-    target: TreeseedProofTarget;
-    driver: TreeseedProofDriver;
-    subjects: TreeseedProofPlanSubject[];
-    summary: {
-        subjects: number;
-        reusable: number;
-        pending: number;
-    };
-};
-export declare function hostedWorkflowForPackage(adapter: TreeseedPackageAdapter): string;
-export declare function buildTreeseedProofPlan(input: {
-    root: string;
-    target?: TreeseedProofTarget;
-    driver?: TreeseedProofDriver;
-    subject?: string | null;
-}): TreeseedProofPlan;
-export declare function summarizeTreeseedProofLedger(root: string): {
-    records: TreeseedProofRecord[];
-    latest: TreeseedProofRecord;
-    failures: TreeseedProofRecord[];
-    slowest: {
-        subject: string;
-        driver: TreeseedProofDriver;
-        durationMs: number | null;
-        status: import("./release-proof.js").TreeseedProofStatus;
-        reason: string;
-    }[];
-    summary: {
-        records: number;
-        passed: number;
-        failed: number;
-        pending: number;
-        reusable: number;
-    };
-};