@stigmer/sdk 3.19.0 → 3.20.0

package/gen/project.js

@@ -1,121 +0,0 @@
-// Code generated by stigmer-codegen. DO NOT EDIT.
-import { wrapError } from "./errors.js";
-import { stripUndefined, toResourceRefInputs } from "./proto-utils.js";
-import { create } from "@bufbuild/protobuf";
-import { createClient } from "@connectrpc/connect";
-import { ApiResourceKind } from "@stigmer/protos/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb";
-import { ApiResourceReferenceSchema } from "@stigmer/protos/ai/stigmer/commons/apiresource/io_pb";
-import { ApiResourceMetadataSchema } from "@stigmer/protos/ai/stigmer/commons/apiresource/metadata_pb";
-import { ProjectSchema } from "@stigmer/protos/ai/stigmer/tenancy/project/v1/api_pb";
-import { ProjectCommandController } from "@stigmer/protos/ai/stigmer/tenancy/project/v1/command_pb";
-import { ProjectIdSchema } from "@stigmer/protos/ai/stigmer/tenancy/project/v1/io_pb";
-import { ProjectQueryController } from "@stigmer/protos/ai/stigmer/tenancy/project/v1/query_pb";
-import { ProjectSpecSchema } from "@stigmer/protos/ai/stigmer/tenancy/project/v1/spec_pb";
-/** Provides operations on project resources. */
-export class ProjectClient {
-    command;
-    query;
-    constructor(transport) {
-        this.command = createClient(ProjectCommandController, transport);
-        this.query = createClient(ProjectQueryController, transport);
-    }
-    async apply(input) {
-        try {
-            return await this.command.apply(buildProjectProto(input));
-        }
-        catch (e) {
-            throw wrapError(e);
-        }
-    }
-    async create(input) {
-        try {
-            return await this.command.create(buildProjectProto(input));
-        }
-        catch (e) {
-            throw wrapError(e);
-        }
-    }
-    async update(input) {
-        try {
-            return await this.command.update(buildProjectProto(input));
-        }
-        catch (e) {
-            throw wrapError(e);
-        }
-    }
-    async delete(id) {
-        try {
-            return await this.command.delete(create(ProjectIdSchema, { value: id }));
-        }
-        catch (e) {
-            throw wrapError(e);
-        }
-    }
-    async get(id) {
-        try {
-            return await this.query.get(create(ProjectIdSchema, { value: id }));
-        }
-        catch (e) {
-            throw wrapError(e);
-        }
-    }
-    async getByReference(ref) {
-        try {
-            return await this.query.getByReference(create(ApiResourceReferenceSchema, { ...ref, kind: ApiResourceKind.project }));
-        }
-        catch (e) {
-            throw wrapError(e);
-        }
-    }
-}
-export function buildProjectProto(input) {
-    const members = input.members?.map(r => create(ApiResourceReferenceSchema, r));
-    return Object.assign(create(ProjectSchema), {
-        apiVersion: "tenancy.stigmer.ai/v1",
-        kind: "Project",
-        metadata: Object.assign(create(ApiResourceMetadataSchema), {
-            ...(input.id && { id: input.id }),
-            name: input.name,
-            org: input.org,
-            ...(input.slug && { slug: input.slug }),
-            ...(input.labels && { labels: input.labels }),
-            ...(input.visibility && { visibility: input.visibility }),
-        }),
-        spec: Object.assign(create(ProjectSpecSchema), stripUndefined({
-            entryPoint: input.entryPoint,
-            description: input.description,
-            members,
-        })),
-    });
-}
-/**
- * Maps a fetched {@link Project} to a complete {@link ProjectInput} for `update()`.
- *
- * The update RPC replaces the ENTIRE spec — spread this mapper's output
- * and override only the fields you edit (spread nested objects the same
- * way):
- *
- *   await client.update({ ...toProjectUpdateInput(res), description: next });
- *
- * Proto3 defaults normalize to `undefined`; resource references keep
- * `version` (pinned refs) and `kind`.
- */
-export function toProjectUpdateInput(resource) {
-    const meta = resource.metadata;
-    const spec = resource.spec ?? create(ProjectSpecSchema);
-    return {
-        // Exact update addressing (id-first in the update pipeline) — for
-        // platform-scoped (org-less) kinds the org+slug fallback cannot
-        // match, so the id is the ONLY working address.
-        id: meta?.id || undefined,
-        name: meta?.name ?? "",
-        slug: meta?.slug || undefined,
-        org: meta?.org ?? "",
-        labels: meta?.labels && Object.keys(meta.labels).length > 0 ? { ...meta.labels } : undefined,
-        visibility: meta?.visibility || undefined,
-        entryPoint: spec.entryPoint || undefined,
-        description: spec.description || undefined,
-        members: toResourceRefInputs(spec.members),
-    };
-}
-//# sourceMappingURL=project.js.map

package/gen/project.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"project.js","sourceRoot":"","sources":["../../src/gen/project.ts"],"names":[],"mappings":"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"}

package/src/gen/project.ts

@@ -1,135 +0,0 @@
-// Code generated by stigmer-codegen. DO NOT EDIT.
-
-import { wrapError } from "./errors.js";
-import { stripUndefined, toResourceRefInputs } from "./proto-utils.js";
-import { type ResourceRef } from "./types.js";
-import { create } from "@bufbuild/protobuf";
-import { createClient, type Client, type Transport } from "@connectrpc/connect";
-import { ApiResourceKind } from "@stigmer/protos/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb";
-import { ApiResourceVisibility } from "@stigmer/protos/ai/stigmer/commons/apiresource/enum_pb";
-import { ApiResourceReferenceSchema } from "@stigmer/protos/ai/stigmer/commons/apiresource/io_pb";
-import { ApiResourceMetadataSchema } from "@stigmer/protos/ai/stigmer/commons/apiresource/metadata_pb";
-import { ProjectSchema, type Project } from "@stigmer/protos/ai/stigmer/tenancy/project/v1/api_pb";
-import { ProjectCommandController } from "@stigmer/protos/ai/stigmer/tenancy/project/v1/command_pb";
-import { ProjectIdSchema } from "@stigmer/protos/ai/stigmer/tenancy/project/v1/io_pb";
-import { ProjectQueryController } from "@stigmer/protos/ai/stigmer/tenancy/project/v1/query_pb";
-import { ProjectSpecSchema } from "@stigmer/protos/ai/stigmer/tenancy/project/v1/spec_pb";
-
-/** Provides operations on project resources. */
-export class ProjectClient {
-  private readonly command: Client<typeof ProjectCommandController>;
-  private readonly query: Client<typeof ProjectQueryController>;
-
-  constructor(transport: Transport) {
-    this.command = createClient(ProjectCommandController, transport);
-    this.query = createClient(ProjectQueryController, transport);
-  }
-
-  async apply(input: ProjectInput): Promise<Project> {
-    try {
-      return await this.command.apply(buildProjectProto(input));
-    } catch (e) { throw wrapError(e); }
-  }
-
-  async create(input: ProjectInput): Promise<Project> {
-    try {
-      return await this.command.create(buildProjectProto(input));
-    } catch (e) { throw wrapError(e); }
-  }
-
-  async update(input: ProjectInput): Promise<Project> {
-    try {
-      return await this.command.update(buildProjectProto(input));
-    } catch (e) { throw wrapError(e); }
-  }
-
-  async delete(id: string): Promise<Project> {
-    try {
-      return await this.command.delete(create(ProjectIdSchema, { value: id }));
-    } catch (e) { throw wrapError(e); }
-  }
-
-  async get(id: string): Promise<Project> {
-    try {
-      return await this.query.get(create(ProjectIdSchema, { value: id }));
-    } catch (e) { throw wrapError(e); }
-  }
-
-  async getByReference(ref: ResourceRef): Promise<Project> {
-    try {
-      return await this.query.getByReference(create(ApiResourceReferenceSchema, { ...ref, kind: ApiResourceKind.project }));
-    } catch (e) { throw wrapError(e); }
-  }
-}
-
-/** Input for creating/updating a Project. */
-export interface ProjectInput {
-  /**
-   * The resource's `metadata.id`, for exact update addressing when set
-   * from a loaded resource. Required for updates to platform-scoped
-   * (org-less) kinds, where the org+slug fallback cannot match. On
-   * create, the cloud server stamps its own id regardless; the OSS
-   * server honors a caller-supplied id (existing apply semantics).
-   */
-  id?: string;
-  name: string;
-  slug?: string;
-  org: string;
-  labels?: Record<string, string>;
-  visibility?: ApiResourceVisibility;
-  entryPoint?: string;
-  description?: string;
-  members?: ResourceRef[];
-}
-
-export function buildProjectProto(input: ProjectInput): Project {
-  const members = input.members?.map(r => create(ApiResourceReferenceSchema, r));
-  return Object.assign(create(ProjectSchema), {
-    apiVersion: "tenancy.stigmer.ai/v1",
-    kind: "Project",
-    metadata: Object.assign(create(ApiResourceMetadataSchema), {
-      ...(input.id && { id: input.id }),
-      name: input.name,
-      org: input.org,
-      ...(input.slug && { slug: input.slug }),
-      ...(input.labels && { labels: input.labels }),
-      ...(input.visibility && { visibility: input.visibility }),
-    }),
-    spec: Object.assign(create(ProjectSpecSchema), stripUndefined({
-      entryPoint: input.entryPoint,
-      description: input.description,
-      members,
-    })),
-  }) as Project;
-}
-
-/**
- * Maps a fetched {@link Project} to a complete {@link ProjectInput} for `update()`.
- *
- * The update RPC replaces the ENTIRE spec — spread this mapper's output
- * and override only the fields you edit (spread nested objects the same
- * way):
- *
- *   await client.update({ ...toProjectUpdateInput(res), description: next });
- *
- * Proto3 defaults normalize to `undefined`; resource references keep
- * `version` (pinned refs) and `kind`.
- */
-export function toProjectUpdateInput(resource: Project): ProjectInput {
-  const meta = resource.metadata;
-  const spec = resource.spec ?? create(ProjectSpecSchema);
-  return {
-    // Exact update addressing (id-first in the update pipeline) — for
-    // platform-scoped (org-less) kinds the org+slug fallback cannot
-    // match, so the id is the ONLY working address.
-    id: meta?.id || undefined,
-    name: meta?.name ?? "",
-    slug: meta?.slug || undefined,
-    org: meta?.org ?? "",
-    labels: meta?.labels && Object.keys(meta.labels).length > 0 ? { ...meta.labels } : undefined,
-    visibility: meta?.visibility || undefined,
-    entryPoint: spec.entryPoint || undefined,
-    description: spec.description || undefined,
-    members: toResourceRefInputs(spec.members),
-  };
-}

package/src/synth/__tests__/synth.test.ts

@@ -1,171 +0,0 @@
-// Tests for the `@stigmer/sdk/synth` producer: explicit synth writes the
-// reader-contract file names in order, each artifact round-trips through
-// fromBinary, skills serialize both local and git sources, async builders are
-// awaited, and a missing out dir produces actionable guidance.
-
-import { mkdtempSync, readFileSync, rmSync } from "node:fs";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import { fromBinary } from "@bufbuild/protobuf";
-import { AgentSchema } from "@stigmer/protos/ai/stigmer/agentic/agent/v1/api_pb";
-import { McpServerSchema } from "@stigmer/protos/ai/stigmer/agentic/mcpserver/v1/api_pb";
-import { SkillSynthSchema } from "@stigmer/protos/ai/stigmer/agentic/skill/v1/synth_pb";
-import { WorkflowSchema } from "@stigmer/protos/ai/stigmer/agentic/workflow/v1/api_pb";
-import { afterEach, beforeEach, describe, expect, it } from "vitest";
-import { defineProject } from "../index";
-
-let outDir: string;
-
-beforeEach(() => {
-  outDir = mkdtempSync(join(tmpdir(), "stigmer-synth-"));
-});
-
-afterEach(() => {
-  rmSync(outDir, { recursive: true, force: true });
-});
-
-function readProto<T>(schema: Parameters<typeof fromBinary>[0], name: string): T {
-  return fromBinary(schema, readFileSync(join(outDir, name))) as T;
-}
-
-describe("defineProject().synth()", () => {
-  it("writes per-kind, zero-indexed file names in registration order", async () => {
-    const project = defineProject((ctx) => {
-      ctx.skill.fromDir("./skills/calculator");
-      ctx.mcpServer({ name: "fs", org: "acme" });
-      ctx.agent({ name: "support-bot", org: "acme", instructions: "help" });
-      ctx.agent({ name: "sales-bot", org: "acme", instructions: "sell" });
-      ctx.workflow({
-        name: "onboard",
-        org: "acme",
-        document: { namespace: "acme", name: "onboard", version: "1.0.0" },
-      });
-    });
-
-    const result = await project.synth({ outDir });
-
-    expect(result.outDir).toBe(outDir);
-    expect(result.counts).toEqual({ agents: 2, workflows: 1, mcpServers: 1, skills: 1 });
-    expect(result.files).toEqual([
-      "skill-0.pb",
-      "mcpserver-0.pb",
-      "agent-0.pb",
-      "agent-1.pb",
-      "workflow-0.pb",
-    ]);
-  });
-
-  it("round-trips each kind through fromBinary", async () => {
-    const project = defineProject((ctx) => {
-      ctx.agent({ name: "support-bot", org: "acme", instructions: "be helpful" });
-      ctx.workflow({
-        name: "onboard",
-        org: "acme",
-        document: { namespace: "acme", name: "onboard", version: "2.1.0" },
-      });
-      ctx.mcpServer({ name: "filesystem", org: "acme" });
-    });
-
-    await project.synth({ outDir });
-
-    const agent = readProto<{ metadata?: { name: string; org: string }; spec?: { instructions: string } }>(
-      AgentSchema,
-      "agent-0.pb",
-    );
-    expect(agent.metadata?.name).toBe("support-bot");
-    expect(agent.metadata?.org).toBe("acme");
-    expect(agent.spec?.instructions).toBe("be helpful");
-
-    const workflow = readProto<{ spec?: { document?: { name: string; version: string } } }>(
-      WorkflowSchema,
-      "workflow-0.pb",
-    );
-    expect(workflow.spec?.document?.name).toBe("onboard");
-    expect(workflow.spec?.document?.version).toBe("2.1.0");
-
-    const mcp = readProto<{ metadata?: { name: string } }>(McpServerSchema, "mcpserver-0.pb");
-    expect(mcp.metadata?.name).toBe("filesystem");
-  });
-
-  it("serializes skills from a local directory", async () => {
-    const project = defineProject((ctx) => {
-      ctx.skill.fromDir("./skills/calculator", { tag: "stable" });
-    });
-    await project.synth({ outDir });
-
-    const synth = readProto<{ source: { case: string; value: { path: string } }; tag: string }>(
-      SkillSynthSchema,
-      "skill-0.pb",
-    );
-    expect(synth.source.case).toBe("local");
-    expect(synth.source.value.path).toBe("./skills/calculator");
-    expect(synth.tag).toBe("stable");
-  });
-
-  it("serializes skills from a git repository", async () => {
-    const project = defineProject((ctx) => {
-      ctx.skill.fromGit({ url: "https://github.com/acme/skills.git", ref: "v1", subdir: "calc" });
-    });
-    await project.synth({ outDir });
-
-    const synth = readProto<{ source: { case: string; value: { url: string; ref: string; subdir: string } } }>(
-      SkillSynthSchema,
-      "skill-0.pb",
-    );
-    expect(synth.source.case).toBe("git");
-    expect(synth.source.value.url).toBe("https://github.com/acme/skills.git");
-    expect(synth.source.value.ref).toBe("v1");
-    expect(synth.source.value.subdir).toBe("calc");
-  });
-
-  it("awaits an async builder", async () => {
-    const project = defineProject(async (ctx) => {
-      await Promise.resolve();
-      ctx.agent({ name: "async-bot", org: "acme", instructions: "later" });
-    });
-    const result = await project.synth({ outDir });
-    expect(result.counts.agents).toBe(1);
-    expect(readProto<{ metadata?: { name: string } }>(AgentSchema, "agent-0.pb").metadata?.name).toBe("async-bot");
-  });
-
-  it("defaults org from the synth({ org }) option when a resource omits it", async () => {
-    const project = defineProject((ctx) => {
-      ctx.agent({ name: "no-org-bot", org: "", instructions: "x" });
-    });
-    await project.synth({ outDir, org: "from-option" });
-    expect(readProto<{ metadata?: { org: string } }>(AgentSchema, "agent-0.pb").metadata?.org).toBe("from-option");
-  });
-
-  it("does not run the builder until synth() is called", async () => {
-    let ran = false;
-    defineProject(() => {
-      ran = true;
-    });
-    expect(ran).toBe(false);
-  });
-
-  it("throws actionable guidance when no out dir is resolvable", async () => {
-    const saved = process.env.STIGMER_OUT_DIR;
-    delete process.env.STIGMER_OUT_DIR;
-    try {
-      const project = defineProject((ctx) => ctx.agent({ name: "x", org: "acme", instructions: "x" }));
-      await expect(project.synth()).rejects.toThrow(/no synthesis output directory/);
-      await expect(project.synth()).rejects.toThrow(/stigmer apply/);
-    } finally {
-      if (saved !== undefined) process.env.STIGMER_OUT_DIR = saved;
-    }
-  });
-
-  it("resolves the out dir from STIGMER_OUT_DIR when no option is passed", async () => {
-    const saved = process.env.STIGMER_OUT_DIR;
-    process.env.STIGMER_OUT_DIR = outDir;
-    try {
-      const project = defineProject((ctx) => ctx.agent({ name: "env-bot", org: "acme", instructions: "x" }));
-      const result = await project.synth();
-      expect(result.outDir).toBe(outDir);
-    } finally {
-      if (saved !== undefined) process.env.STIGMER_OUT_DIR = saved;
-      else delete process.env.STIGMER_OUT_DIR;
-    }
-  });
-});

package/src/synth/context.ts

@@ -1,141 +0,0 @@
-// ProjectContext — the resource-registration surface handed to a
-// `defineProject` builder.
-//
-// Each `ctx.<kind>()` records one ergonomic `*Input` (the very types the
-// `@stigmer/sdk` resource clients already accept) in registration order;
-// `ctx.skill.fromDir` / `ctx.skill.fromGit` record a `SkillSynth` handover
-// message (the SDK→CLI contract from `synth.proto`). The writer later turns
-// these registrations into the `.pb` files the CLI consumes. Reusing the
-// `*Input` types — not a new authoring vocabulary — keeps the synthesis surface
-// identical to the imperative SDK, so there is exactly one way to describe a
-// resource in TypeScript (DD-009 §1, §4).
-//
-// Org defaults from `STIGMER_ORG_ID` when a resource omits it, mirroring the
-// CLI's org injection (apply.ts `injectOrg`) so a project authored without an
-// explicit org still synthesizes to valid protos when run via `stigmer apply`.
-
-import { create } from "@bufbuild/protobuf";
-import {
-  GitSchema,
-  LocalDirSchema,
-  type SkillSynth,
-  SkillSynthSchema,
-} from "@stigmer/protos/ai/stigmer/agentic/skill/v1/synth_pb";
-import type { AgentInput } from "../gen/agent.js";
-import type { McpServerInput } from "../gen/mcpserver.js";
-import type { WorkflowInput } from "../gen/workflow.js";
-
-/** Options for registering a skill from a local directory. */
-export interface SkillFromDirOptions {
-  /** Mutable version tag (the CLI defaults this to "latest" at push time). */
-  readonly tag?: string;
-}
-
-/** Input for registering a skill sourced from a remote git repository. */
-export interface SkillFromGitInput {
-  /** Git repository URL (HTTPS or SSH). */
-  readonly url: string;
-  /** Tag, branch, or commit SHA; empty resolves to the default branch. */
-  readonly ref?: string;
-  /** Subdirectory within the repo that holds SKILL.md; empty = repo root. */
-  readonly subdir?: string;
-  /** Mutable version tag (the CLI defaults this to "latest" at push time). */
-  readonly tag?: string;
-}
-
-// Opaque registration record returned by ctx.skill.* so the builder reads
-// naturally (and to leave room for future linkage ergonomics). Agents reference
-// skills by slug via AgentInput.skillRefs, exactly as in the declarative track —
-// a skill's slug is its SKILL.md name, which the backend assigns at push time.
-export interface SkillHandle {
-  readonly kind: "skill";
-  readonly synth: SkillSynth;
-}
-
-/** One ordered registration captured by the context. */
-export type Registration =
-  | { readonly kind: "agent"; readonly input: AgentInput }
-  | { readonly kind: "workflow"; readonly input: WorkflowInput }
-  | { readonly kind: "mcpServer"; readonly input: McpServerInput }
-  | { readonly kind: "skill"; readonly synth: SkillSynth };
-
-/** The resource-registration API passed to a `defineProject` builder. */
-export interface ProjectContext {
-  /** Register an agent for synthesis. */
-  agent(input: AgentInput): void;
-  /** Register a workflow for synthesis. */
-  workflow(input: WorkflowInput): void;
-  /** Register an MCP server for synthesis. */
-  mcpServer(input: McpServerInput): void;
-  /** Register skills sourced from a local directory or a git repository. */
-  readonly skill: {
-    fromDir(path: string, opts?: SkillFromDirOptions): SkillHandle;
-    fromGit(input: SkillFromGitInput): SkillHandle;
-  };
-}
-
-/**
- * Concrete {@link ProjectContext} that accumulates registrations in order.
- * `defineProject` runs the user's builder against one of these, then hands the
- * collected registrations to the writer.
- */
-export class RegistrationContext implements ProjectContext {
-  private readonly registrations: Registration[] = [];
-  private readonly defaultOrg: string;
-
-  constructor(defaultOrg: string = process.env.STIGMER_ORG_ID ?? "") {
-    this.defaultOrg = defaultOrg;
-  }
-
-  agent(input: AgentInput): void {
-    this.registrations.push({ kind: "agent", input: this.withOrg(input) });
-  }
-
-  workflow(input: WorkflowInput): void {
-    this.registrations.push({ kind: "workflow", input: this.withOrg(input) });
-  }
-
-  mcpServer(input: McpServerInput): void {
-    this.registrations.push({ kind: "mcpServer", input: this.withOrg(input) });
-  }
-
-  readonly skill = {
-    fromDir: (path: string, opts?: SkillFromDirOptions): SkillHandle => {
-      const synth = create(SkillSynthSchema, {
-        source: { case: "local", value: create(LocalDirSchema, { path }) },
-        tag: opts?.tag ?? "",
-      });
-      this.registrations.push({ kind: "skill", synth });
-      return { kind: "skill", synth };
-    },
-    fromGit: (input: SkillFromGitInput): SkillHandle => {
-      const synth = create(SkillSynthSchema, {
-        source: {
-          case: "git",
-          value: create(GitSchema, {
-            url: input.url,
-            ref: input.ref ?? "",
-            subdir: input.subdir ?? "",
-          }),
-        },
-        tag: input.tag ?? "",
-      });
-      this.registrations.push({ kind: "skill", synth });
-      return { kind: "skill", synth };
-    },
-  };
-
-  /** Registrations captured so far, in builder-call order. */
-  collect(): readonly Registration[] {
-    return this.registrations;
-  }
-
-  // Fill org from STIGMER_ORG_ID only when the resource left it blank; an
-  // explicit org always wins (the CLI later warns on org mismatch, not here).
-  private withOrg<T extends { org: string }>(input: T): T {
-    if (this.defaultOrg !== "" && (input.org === undefined || input.org === "")) {
-      return { ...input, org: this.defaultOrg };
-    }
-    return input;
-  }
-}

package/src/synth/index.ts

@@ -1,85 +0,0 @@
-// `@stigmer/sdk/synth` — the project-synthesis authoring API (the "producer").
-//
-// A user's entry point describes resources functionally and synthesizes them to
-// proto `.pb` files that `stigmer apply` consumes:
-//
-//   import { defineProject } from "@stigmer/sdk/synth";
-//
-//   const project = defineProject((ctx) => {
-//     ctx.skill.fromDir("./skills/calculator");
-//     ctx.agent({ name: "support-bot", org: "acme", instructions: "…" });
-//   });
-//
-//   await project.synth();
-//
-// `synth()` is EXPLICIT (no import-time / beforeExit magic): the builder runs
-// lazily inside it, honoring `@stigmer/sdk`'s `sideEffects: false` and staying
-// trivially testable via `synth({ outDir })` (DD-009 §1). Node-only — it writes
-// files — and exported from the dedicated `/synth` subpath (DD-009 §2).
-
-import { RegistrationContext } from "./context.js";
-import { countRegistrations, type SynthCounts, writeRegistrations } from "./writer.js";
-import type { ProjectContext } from "./context.js";
-
-export type {
-  ProjectContext,
-  Registration,
-  SkillFromDirOptions,
-  SkillFromGitInput,
-  SkillHandle,
-} from "./context.js";
-export type { SynthCounts, SynthFile } from "./writer.js";
-export { serializeRegistrations } from "./writer.js";
-
-/** Options for {@link ProjectApp.synth}. */
-export interface SynthOptions {
-  /** Output directory; defaults to `process.env.STIGMER_OUT_DIR`. */
-  readonly outDir?: string;
-  /** Default org for resources that omit one; defaults to `STIGMER_ORG_ID`. */
-  readonly org?: string;
-}
-
-/** Outcome of a synthesis run. */
-export interface SynthResult {
-  /** Directory the `.pb` files were written to. */
-  readonly outDir: string;
-  /** Names of the written `.pb` files, in registration order. */
-  readonly files: readonly string[];
-  /** Per-kind resource counts. */
-  readonly counts: SynthCounts;
-}
-
-/** A builder that registers resources on the given context (sync or async). */
-export type ProjectBuilder = (ctx: ProjectContext) => void | Promise<void>;
-
-/** A synthesizable project produced by {@link defineProject}. */
-export interface ProjectApp {
-  /** Run the builder and write the `.pb` artifacts; resolves to a summary. */
-  synth(opts?: SynthOptions): Promise<SynthResult>;
-}
-
-/**
- * Define a synthesizable project. The `build` callback is NOT run here — it runs
- * lazily inside {@link ProjectApp.synth}, so importing the module has no side
- * effects and the same app can be synthesized to different out dirs in tests.
- */
-export function defineProject(build: ProjectBuilder): ProjectApp {
-  return {
-    async synth(opts?: SynthOptions): Promise<SynthResult> {
-      const outDir = opts?.outDir ?? process.env.STIGMER_OUT_DIR;
-      if (outDir === undefined || outDir === "") {
-        throw new Error(
-          "no synthesis output directory\n\n" +
-            "Run this project via `stigmer apply` (which sets STIGMER_OUT_DIR), " +
-            "or call project.synth({ outDir }) with an explicit directory.",
-        );
-      }
-
-      const ctx = new RegistrationContext(opts?.org ?? process.env.STIGMER_ORG_ID ?? "");
-      await build(ctx);
-      const registrations = ctx.collect();
-      const files = writeRegistrations(outDir, registrations);
-      return { outDir, files, counts: countRegistrations(registrations) };
-    },
-  };
-}