@treeseed/sdk 0.4.13 → 0.5.1

package/dist/scripts/tenant-dev.js

@@ -61,7 +61,6 @@ function runTenantBuildCycle({ includePackageBuild = false, includeSdkBuild = fa
     const buildScripts = [
         ['patch-starlight-content-path', []],
         ['aggregate-book', []],
-        ['sync-dev-vars', envOverrides],
         ['tenant-d1-migrate-local', []],
     ];
     if (shouldEnsureMailpit()) {

package/dist/sdk-types.d.ts

@@ -1,5 +1,5 @@
 import type { TreeseedFieldAliasBinding } from './field-aliases.ts';
-export declare const SDK_MODEL_NAMES: readonly ["page", "note", "question", "book", "knowledge", "objective", "person", "subscription", "message", "agent", "agent_run", "agent_cursor", "content_lease", "work_day", "task", "task_event", "task_output", "graph_run", "report"];
+export declare const SDK_MODEL_NAMES: readonly ["page", "note", "question", "proposal", "decision", "book", "knowledge", "objective", "person", "subscription", "message", "agent", "agent_run", "agent_cursor", "content_lease", "work_day", "task", "task_event", "task_output", "graph_run", "report"];
 export declare const SDK_OPERATIONS: readonly ["get", "read", "search", "follow", "pick", "create", "update"];
 export declare const SDK_STORAGE_BACKENDS: readonly ["content", "d1"];
 export declare const SDK_PICK_STRATEGIES: readonly ["latest", "highest_priority", "oldest"];
@@ -741,7 +741,7 @@ export interface SdkModelDefinition {
     graph?: SdkGraphModelConfig;
 }
 export type SdkModelRegistry = Record<string, SdkModelDefinition>;
-export type SdkGraphNodeType = 'File' | 'Section' | 'Agent' | 'Objective' | 'Question' | 'Note' | 'Knowledge' | 'Book' | 'Page' | 'Person' | 'Tag' | 'Series' | 'Reference' | 'Entity';
+export type SdkGraphNodeType = 'File' | 'Section' | 'Agent' | 'Objective' | 'Question' | 'Note' | 'Proposal' | 'Decision' | 'Knowledge' | 'Book' | 'Page' | 'Person' | 'Tag' | 'Series' | 'Reference' | 'Entity';
 export type SdkGraphEdgeType = 'HAS_SECTION' | 'BELONGS_TO_FILE' | 'PARENT_SECTION' | 'CHILD_SECTION' | 'NEXT_SECTION' | 'PREV_SECTION' | 'LINKS_TO' | 'REFERENCES' | 'MENTIONS' | 'HAS_TAG' | 'IN_SERIES' | 'SAME_DIRECTORY' | 'SAME_COLLECTION' | 'DEFINES' | 'DEFINED_BY' | 'RELATES_TO' | 'DEPENDS_ON' | 'IMPLEMENTS' | 'EXTENDS' | 'SUPERSEDES' | 'BELONGS_TO' | 'ABOUT' | 'USED_BY' | 'GENERATED_FROM';
 export interface SdkGraphReferenceFieldConfig {
     field: string;

package/dist/sdk-types.js

@@ -2,6 +2,8 @@ const SDK_MODEL_NAMES = [
   "page",
   "note",
   "question",
+  "proposal",
+  "decision",
   "book",
   "knowledge",
   "objective",

package/dist/sdk.d.ts

@@ -2,6 +2,7 @@ import type { AgentPermissionConfig, AgentRuntimeSpec } from './types/agents.ts'
 import { ContentStore } from './content-store.ts';
 import { type AgentDatabase } from './d1-store.ts';
 import { type LoadedTreeseedPluginEntry } from './platform/plugins.ts';
+import type { ReleaseDetail, ReleaseSummary, SharePackageStatus, WorkstreamDetail, WorkstreamEvent, WorkstreamSummary } from './knowledge-coop.ts';
 import type { SdkAckMessageRequest, SdkClaimMessageRequest, SdkClaimTaskRequest, SdkCloseWorkDayRequest, SdkCompleteTaskRequest, SdkCreateReportRequest, SdkCreateMessageRequest, SdkCreatePrioritySnapshotRequest, SdkCreateTaskRequest, SdkCursorRequest, SdkFailTaskRequest, SdkFollowRequest, SdkGetRequest, SdkGetCursorRequest, SdkJsonEnvelope, SdkLeaseReleaseRequest, SdkManagerContextPayload, SdkMutationRequest, SdkGraphQueryOptions, SdkGraphQueryRequest, SdkGraphRefreshRequest, SdkGraphSearchOptions, SdkContextPackRequest, SdkGraphDslParseResult, SdkPickRequest, SdkPriorityOverrideRequest, SdkRecordRunRequest, SdkRecordScaleDecisionRequest, SdkRecordTaskCreditsRequest, SdkSearchRequest, SdkStartWorkDayRequest, SdkTaskProgressRequest, SdkTaskSearchRequest, SdkUpsertWorkPolicyRequest, SdkUpdateRequest, SdkModelDefinition, SdkModelRegistry, SdkGraphRankingProvider, SdkDispatchConfig, SdkDispatchRequest, SdkDispatchResult, PrioritySnapshot, ScaleDecision, TaskCreditLedgerEntry, WorkdayPolicy } from './sdk-types.ts';
 export interface AgentSdkOptions {
     repoRoot?: string;
@@ -95,6 +96,18 @@ export declare class AgentSdk {
     listTaskCredits(workDayId: string): Promise<SdkJsonEnvelope<TaskCreditLedgerEntry[]>>;
     recordScaleDecision(request: SdkRecordScaleDecisionRequest): Promise<SdkJsonEnvelope<ScaleDecision>>;
     getLatestScaleDecision(projectId: string, environment: string, poolName: string): Promise<SdkJsonEnvelope<ScaleDecision>>;
+    listWorkstreams(projectId: string): Promise<SdkJsonEnvelope<WorkstreamSummary[]>>;
+    getWorkstream(workstreamId: string): Promise<SdkJsonEnvelope<WorkstreamDetail>>;
+    upsertWorkstream(input: Partial<WorkstreamSummary> & Pick<WorkstreamSummary, 'projectId' | 'title'>): Promise<SdkJsonEnvelope<WorkstreamSummary>>;
+    appendWorkstreamEvent(input: Pick<WorkstreamEvent, 'projectId' | 'workstreamId' | 'kind'> & Partial<WorkstreamEvent>): Promise<SdkJsonEnvelope<WorkstreamEvent>>;
+    listReleases(projectId: string): Promise<SdkJsonEnvelope<ReleaseSummary[]>>;
+    getRelease(releaseId: string): Promise<SdkJsonEnvelope<ReleaseDetail>>;
+    upsertRelease(input: Partial<ReleaseSummary> & Pick<ReleaseSummary, 'projectId' | 'version'> & {
+        items?: ReleaseDetail['items'];
+    }): Promise<SdkJsonEnvelope<ReleaseDetail>>;
+    listSharePackages(projectId: string): Promise<SdkJsonEnvelope<SharePackageStatus[]>>;
+    getSharePackage(packageId: string): Promise<SdkJsonEnvelope<SharePackageStatus>>;
+    upsertSharePackage(input: Partial<SharePackageStatus> & Pick<SharePackageStatus, 'projectId' | 'kind' | 'title'>): Promise<SdkJsonEnvelope<SharePackageStatus>>;
     listAgentSpecs(options?: {
         enabled?: boolean;
     }): Promise<AgentRuntimeSpec[]>;

package/dist/sdk.js

@@ -301,6 +301,46 @@ class AgentSdk {
     const payload = await this.database.getLatestScaleDecision(projectId, environment, poolName);
     return this.envelope("report", "get", payload);
   }
+  async listWorkstreams(projectId) {
+    const payload = await this.database.listWorkstreams(projectId);
+    return this.envelope("task", "search", payload, { count: payload.length });
+  }
+  async getWorkstream(workstreamId) {
+    const payload = await this.database.getWorkstream(workstreamId);
+    return this.envelope("task", "get", payload);
+  }
+  async upsertWorkstream(input) {
+    const payload = await this.database.upsertWorkstream(input);
+    return this.envelope("task", "update", payload);
+  }
+  async appendWorkstreamEvent(input) {
+    const payload = await this.database.appendWorkstreamEvent(input);
+    return this.envelope("task_event", "create", payload);
+  }
+  async listReleases(projectId) {
+    const payload = await this.database.listReleases(projectId);
+    return this.envelope("report", "search", payload, { count: payload.length });
+  }
+  async getRelease(releaseId) {
+    const payload = await this.database.getRelease(releaseId);
+    return this.envelope("report", "get", payload);
+  }
+  async upsertRelease(input) {
+    const payload = await this.database.upsertRelease(input);
+    return this.envelope("report", "update", payload);
+  }
+  async listSharePackages(projectId) {
+    const payload = await this.database.listSharePackages(projectId);
+    return this.envelope("report", "search", payload, { count: payload.length });
+  }
+  async getSharePackage(packageId) {
+    const payload = await this.database.getSharePackage(packageId);
+    return this.envelope("report", "get", payload);
+  }
+  async upsertSharePackage(input) {
+    const payload = await this.database.upsertSharePackage(input);
+    return this.envelope("report", "update", payload);
+  }
   async listAgentSpecs(options) {
     const rawEntries = await this.listRawAgentSpecs(options);
     return rawEntries.map((entry) => normalizeAgentSpec(entry)).filter((entry) => Boolean(entry && entry.slug));

package/dist/stores/knowledge-coop-store.d.ts

@@ -0,0 +1,56 @@
+import type { ReleaseDetail, ReleaseSummary, SharePackageStatus, WorkstreamDetail, WorkstreamEvent, WorkstreamState, WorkstreamSummary, LinkedProjectRecordRef } from '../knowledge-coop.ts';
+import { SqliteStoreBase } from './helpers.ts';
+export declare class MemoryKnowledgeCoopStore {
+    private readonly workstreams;
+    private readonly workstreamEvents;
+    private readonly releases;
+    private readonly releaseItems;
+    private readonly packages;
+    listWorkstreams(projectId: string): WorkstreamSummary[];
+    getWorkstream(workstreamId: string): WorkstreamDetail | null;
+    upsertWorkstream(input: Partial<WorkstreamSummary> & Pick<WorkstreamSummary, 'projectId' | 'title'>): WorkstreamSummary;
+    appendWorkstreamEvent(input: Pick<WorkstreamEvent, 'projectId' | 'workstreamId' | 'kind'> & Partial<WorkstreamEvent>): WorkstreamEvent;
+    listReleases(projectId: string): ReleaseSummary[];
+    getRelease(releaseId: string): ReleaseDetail | null;
+    upsertRelease(input: Partial<ReleaseSummary> & Pick<ReleaseSummary, 'projectId' | 'version'> & {
+        items?: ReleaseDetail['items'];
+    }): ReleaseDetail | null;
+    listSharePackages(projectId: string): SharePackageStatus[];
+    getSharePackage(packageId: string): SharePackageStatus | null;
+    upsertSharePackage(input: Partial<SharePackageStatus> & Pick<SharePackageStatus, 'projectId' | 'kind' | 'title'>): SharePackageStatus;
+}
+export declare class SqliteKnowledgeCoopStore extends SqliteStoreBase {
+    private initialized;
+    private ensureSchema;
+    listWorkstreams(projectId: string): Promise<WorkstreamSummary[]>;
+    getWorkstream(workstreamId: string): Promise<WorkstreamDetail | null>;
+    upsertWorkstream(input: Partial<WorkstreamSummary> & Pick<WorkstreamSummary, 'projectId' | 'title'>): Promise<{
+        events: WorkstreamEvent[];
+        id: string;
+        projectId: string;
+        title: string;
+        summary: string | null;
+        state: WorkstreamState;
+        branchName: string | null;
+        branchRef: string | null;
+        owner: string | null;
+        linkedItems: LinkedProjectRecordRef[];
+        verificationStatus: "completed" | "failed" | "waiting" | null;
+        verificationSummary: string | null;
+        lastSaveAt: string | null;
+        lastStageAt: string | null;
+        archivedAt: string | null;
+        createdAt: string;
+        updatedAt: string;
+        metadata?: Record<string, unknown>;
+    } | null>;
+    appendWorkstreamEvent(input: Pick<WorkstreamEvent, 'projectId' | 'workstreamId' | 'kind'> & Partial<WorkstreamEvent>): Promise<WorkstreamEvent | null>;
+    listReleases(projectId: string): Promise<ReleaseSummary[]>;
+    getRelease(releaseId: string): Promise<ReleaseDetail | null>;
+    upsertRelease(input: Partial<ReleaseSummary> & Pick<ReleaseSummary, 'projectId' | 'version'> & {
+        items?: ReleaseDetail['items'];
+    }): Promise<ReleaseDetail | null>;
+    listSharePackages(projectId: string): Promise<SharePackageStatus[]>;
+    getSharePackage(packageId: string): Promise<SharePackageStatus | null>;
+    upsertSharePackage(input: Partial<SharePackageStatus> & Pick<SharePackageStatus, 'projectId' | 'kind' | 'title'>): Promise<SharePackageStatus | null>;
+}

package/dist/stores/knowledge-coop-store.js

@@ -0,0 +1,482 @@
+import crypto from "node:crypto";
+import { SqliteStoreBase, nowIso, toSqlValue } from "./helpers.js";
+function parseJson(value, fallback) {
+  if (typeof value !== "string" || !value.trim()) {
+    return fallback;
+  }
+  try {
+    return JSON.parse(value);
+  } catch {
+    return fallback;
+  }
+}
+function stringify(value) {
+  return JSON.stringify(value ?? {});
+}
+function linkedItemsFromRow(row) {
+  return parseJson(row.linked_items_json, []);
+}
+function workstreamFromRow(row) {
+  return {
+    id: String(row.id ?? ""),
+    projectId: String(row.project_id ?? ""),
+    title: String(row.title ?? ""),
+    summary: row.summary === null || row.summary === void 0 ? null : String(row.summary),
+    state: String(row.state ?? "drafting"),
+    branchName: row.branch_name === null || row.branch_name === void 0 ? null : String(row.branch_name),
+    branchRef: row.branch_ref === null || row.branch_ref === void 0 ? null : String(row.branch_ref),
+    owner: row.owner === null || row.owner === void 0 ? null : String(row.owner),
+    linkedItems: linkedItemsFromRow(row),
+    verificationStatus: row.verification_status === null || row.verification_status === void 0 ? null : String(row.verification_status),
+    verificationSummary: row.verification_summary === null || row.verification_summary === void 0 ? null : String(row.verification_summary),
+    lastSaveAt: row.last_save_at === null || row.last_save_at === void 0 ? null : String(row.last_save_at),
+    lastStageAt: row.last_stage_at === null || row.last_stage_at === void 0 ? null : String(row.last_stage_at),
+    archivedAt: row.archived_at === null || row.archived_at === void 0 ? null : String(row.archived_at),
+    createdAt: String(row.created_at ?? nowIso()),
+    updatedAt: String(row.updated_at ?? nowIso()),
+    metadata: parseJson(row.metadata_json, {})
+  };
+}
+function workstreamEventFromRow(row) {
+  return {
+    id: String(row.id ?? ""),
+    workstreamId: String(row.workstream_id ?? ""),
+    projectId: String(row.project_id ?? ""),
+    kind: String(row.kind ?? ""),
+    summary: row.summary === null || row.summary === void 0 ? null : String(row.summary),
+    data: parseJson(row.data_json, {}),
+    createdAt: String(row.created_at ?? nowIso())
+  };
+}
+function releaseSummaryFromRow(row) {
+  return {
+    id: String(row.id ?? ""),
+    projectId: String(row.project_id ?? ""),
+    version: String(row.version ?? ""),
+    title: row.title === null || row.title === void 0 ? null : String(row.title),
+    state: String(row.state ?? "drafting"),
+    summary: row.summary === null || row.summary === void 0 ? null : String(row.summary),
+    workstreamIds: parseJson(row.workstream_ids_json, []),
+    releaseTag: row.release_tag === null || row.release_tag === void 0 ? null : String(row.release_tag),
+    commitSha: row.commit_sha === null || row.commit_sha === void 0 ? null : String(row.commit_sha),
+    publishedAt: row.published_at === null || row.published_at === void 0 ? null : String(row.published_at),
+    rolledBackAt: row.rolled_back_at === null || row.rolled_back_at === void 0 ? null : String(row.rolled_back_at),
+    createdAt: String(row.created_at ?? nowIso()),
+    updatedAt: String(row.updated_at ?? nowIso()),
+    metadata: parseJson(row.metadata_json, {})
+  };
+}
+function sharePackageFromRow(row) {
+  return {
+    id: String(row.id ?? ""),
+    projectId: String(row.project_id ?? ""),
+    kind: String(row.kind ?? "export"),
+    state: String(row.state ?? "draft"),
+    title: String(row.title ?? ""),
+    summary: row.summary === null || row.summary === void 0 ? null : String(row.summary),
+    version: row.version === null || row.version === void 0 ? null : String(row.version),
+    outputPath: row.output_path === null || row.output_path === void 0 ? null : String(row.output_path),
+    artifactKey: row.artifact_key === null || row.artifact_key === void 0 ? null : String(row.artifact_key),
+    manifestKey: row.manifest_key === null || row.manifest_key === void 0 ? null : String(row.manifest_key),
+    publishedItemId: row.published_item_id === null || row.published_item_id === void 0 ? null : String(row.published_item_id),
+    lastError: row.last_error === null || row.last_error === void 0 ? null : String(row.last_error),
+    createdAt: String(row.created_at ?? nowIso()),
+    updatedAt: String(row.updated_at ?? nowIso()),
+    metadata: parseJson(row.metadata_json, {})
+  };
+}
+class MemoryKnowledgeCoopStore {
+  workstreams = /* @__PURE__ */ new Map();
+  workstreamEvents = /* @__PURE__ */ new Map();
+  releases = /* @__PURE__ */ new Map();
+  releaseItems = /* @__PURE__ */ new Map();
+  packages = /* @__PURE__ */ new Map();
+  listWorkstreams(projectId) {
+    return [...this.workstreams.values()].filter((entry) => entry.projectId === projectId).sort((left, right) => right.updatedAt.localeCompare(left.updatedAt));
+  }
+  getWorkstream(workstreamId) {
+    const workstream = this.workstreams.get(workstreamId);
+    if (!workstream) return null;
+    return {
+      ...workstream,
+      events: [...this.workstreamEvents.get(workstreamId) ?? []]
+    };
+  }
+  upsertWorkstream(input) {
+    const timestamp = nowIso();
+    const id = input.id ?? crypto.randomUUID();
+    const existing = this.workstreams.get(id);
+    const next = {
+      id,
+      projectId: input.projectId,
+      title: input.title,
+      summary: input.summary ?? existing?.summary ?? null,
+      state: input.state ?? existing?.state ?? "drafting",
+      branchName: input.branchName ?? existing?.branchName ?? null,
+      branchRef: input.branchRef ?? existing?.branchRef ?? null,
+      owner: input.owner ?? existing?.owner ?? null,
+      linkedItems: input.linkedItems ?? existing?.linkedItems ?? [],
+      verificationStatus: input.verificationStatus ?? existing?.verificationStatus ?? null,
+      verificationSummary: input.verificationSummary ?? existing?.verificationSummary ?? null,
+      lastSaveAt: input.lastSaveAt ?? existing?.lastSaveAt ?? null,
+      lastStageAt: input.lastStageAt ?? existing?.lastStageAt ?? null,
+      archivedAt: input.archivedAt ?? existing?.archivedAt ?? null,
+      createdAt: existing?.createdAt ?? timestamp,
+      updatedAt: timestamp,
+      metadata: input.metadata ?? existing?.metadata ?? {}
+    };
+    this.workstreams.set(id, next);
+    return next;
+  }
+  appendWorkstreamEvent(input) {
+    const event = {
+      id: input.id ?? crypto.randomUUID(),
+      projectId: input.projectId,
+      workstreamId: input.workstreamId,
+      kind: input.kind,
+      summary: input.summary ?? null,
+      data: input.data ?? {},
+      createdAt: input.createdAt ?? nowIso()
+    };
+    const events = this.workstreamEvents.get(input.workstreamId) ?? [];
+    events.push(event);
+    this.workstreamEvents.set(input.workstreamId, events);
+    return event;
+  }
+  listReleases(projectId) {
+    return [...this.releases.values()].filter((entry) => entry.projectId === projectId).sort((left, right) => right.updatedAt.localeCompare(left.updatedAt));
+  }
+  getRelease(releaseId) {
+    const release = this.releases.get(releaseId);
+    if (!release) return null;
+    return {
+      ...release,
+      items: [...this.releaseItems.get(releaseId) ?? []]
+    };
+  }
+  upsertRelease(input) {
+    const timestamp = nowIso();
+    const id = input.id ?? crypto.randomUUID();
+    const existing = this.releases.get(id);
+    const next = {
+      id,
+      projectId: input.projectId,
+      version: input.version,
+      title: input.title ?? existing?.title ?? null,
+      state: input.state ?? existing?.state ?? "drafting",
+      summary: input.summary ?? existing?.summary ?? null,
+      workstreamIds: input.workstreamIds ?? existing?.workstreamIds ?? [],
+      releaseTag: input.releaseTag ?? existing?.releaseTag ?? null,
+      commitSha: input.commitSha ?? existing?.commitSha ?? null,
+      publishedAt: input.publishedAt ?? existing?.publishedAt ?? null,
+      rolledBackAt: input.rolledBackAt ?? existing?.rolledBackAt ?? null,
+      createdAt: existing?.createdAt ?? timestamp,
+      updatedAt: timestamp,
+      metadata: input.metadata ?? existing?.metadata ?? {}
+    };
+    this.releases.set(id, next);
+    if (input.items) {
+      this.releaseItems.set(id, [...input.items]);
+    }
+    return this.getRelease(id);
+  }
+  listSharePackages(projectId) {
+    return [...this.packages.values()].filter((entry) => entry.projectId === projectId).sort((left, right) => right.updatedAt.localeCompare(left.updatedAt));
+  }
+  getSharePackage(packageId) {
+    return this.packages.get(packageId) ?? null;
+  }
+  upsertSharePackage(input) {
+    const timestamp = nowIso();
+    const id = input.id ?? crypto.randomUUID();
+    const existing = this.packages.get(id);
+    const next = {
+      id,
+      projectId: input.projectId,
+      kind: input.kind,
+      state: input.state ?? existing?.state ?? "draft",
+      title: input.title,
+      summary: input.summary ?? existing?.summary ?? null,
+      version: input.version ?? existing?.version ?? null,
+      outputPath: input.outputPath ?? existing?.outputPath ?? null,
+      artifactKey: input.artifactKey ?? existing?.artifactKey ?? null,
+      manifestKey: input.manifestKey ?? existing?.manifestKey ?? null,
+      publishedItemId: input.publishedItemId ?? existing?.publishedItemId ?? null,
+      lastError: input.lastError ?? existing?.lastError ?? null,
+      createdAt: existing?.createdAt ?? timestamp,
+      updatedAt: timestamp,
+      metadata: input.metadata ?? existing?.metadata ?? {}
+    };
+    this.packages.set(id, next);
+    return next;
+  }
+}
+class SqliteKnowledgeCoopStore extends SqliteStoreBase {
+  initialized = false;
+  async ensureSchema() {
+    if (this.initialized) return;
+    const statements = [
+      `CREATE TABLE IF NOT EXISTS project_workstreams (
+				id TEXT PRIMARY KEY,
+				project_id TEXT NOT NULL,
+				title TEXT NOT NULL,
+				summary TEXT,
+				state TEXT NOT NULL,
+				branch_name TEXT,
+				branch_ref TEXT,
+				owner TEXT,
+				linked_items_json TEXT NOT NULL DEFAULT '[]',
+				verification_status TEXT,
+				verification_summary TEXT,
+				last_save_at TEXT,
+				last_stage_at TEXT,
+				archived_at TEXT,
+				metadata_json TEXT NOT NULL DEFAULT '{}',
+				created_at TEXT NOT NULL,
+				updated_at TEXT NOT NULL
+			)`,
+      `CREATE INDEX IF NOT EXISTS idx_project_workstreams_project_updated
+				ON project_workstreams(project_id, updated_at DESC)`,
+      `CREATE TABLE IF NOT EXISTS project_workstream_events (
+				id TEXT PRIMARY KEY,
+				workstream_id TEXT NOT NULL,
+				project_id TEXT NOT NULL,
+				kind TEXT NOT NULL,
+				summary TEXT,
+				data_json TEXT NOT NULL DEFAULT '{}',
+				created_at TEXT NOT NULL
+			)`,
+      `CREATE INDEX IF NOT EXISTS idx_project_workstream_events_workstream_created
+				ON project_workstream_events(workstream_id, created_at ASC)`,
+      `CREATE TABLE IF NOT EXISTS project_releases (
+				id TEXT PRIMARY KEY,
+				project_id TEXT NOT NULL,
+				version TEXT NOT NULL,
+				title TEXT,
+				state TEXT NOT NULL,
+				summary TEXT,
+				workstream_ids_json TEXT NOT NULL DEFAULT '[]',
+				release_tag TEXT,
+				commit_sha TEXT,
+				published_at TEXT,
+				rolled_back_at TEXT,
+				metadata_json TEXT NOT NULL DEFAULT '{}',
+				created_at TEXT NOT NULL,
+				updated_at TEXT NOT NULL
+			)`,
+      `CREATE INDEX IF NOT EXISTS idx_project_releases_project_updated
+				ON project_releases(project_id, updated_at DESC)`,
+      `CREATE TABLE IF NOT EXISTS project_release_items (
+				id TEXT PRIMARY KEY,
+				release_id TEXT NOT NULL,
+				workstream_id TEXT,
+				model TEXT,
+				record_id TEXT,
+				summary TEXT,
+				metadata_json TEXT NOT NULL DEFAULT '{}',
+				created_at TEXT NOT NULL
+			)`,
+      `CREATE INDEX IF NOT EXISTS idx_project_release_items_release_created
+				ON project_release_items(release_id, created_at ASC)`,
+      `CREATE TABLE IF NOT EXISTS project_share_packages (
+				id TEXT PRIMARY KEY,
+				project_id TEXT NOT NULL,
+				kind TEXT NOT NULL,
+				state TEXT NOT NULL,
+				title TEXT NOT NULL,
+				summary TEXT,
+				version TEXT,
+				output_path TEXT,
+				artifact_key TEXT,
+				manifest_key TEXT,
+				published_item_id TEXT,
+				last_error TEXT,
+				metadata_json TEXT NOT NULL DEFAULT '{}',
+				created_at TEXT NOT NULL,
+				updated_at TEXT NOT NULL
+			)`,
+      `CREATE INDEX IF NOT EXISTS idx_project_share_packages_project_updated
+				ON project_share_packages(project_id, updated_at DESC)`
+    ];
+    for (const statement of statements) {
+      await this.execute(statement);
+    }
+    this.initialized = true;
+  }
+  async listWorkstreams(projectId) {
+    await this.ensureSchema();
+    const rows = await this.selectAll(
+      `SELECT * FROM project_workstreams WHERE project_id = ${toSqlValue(projectId)} ORDER BY updated_at DESC`
+    );
+    return rows.map(workstreamFromRow);
+  }
+  async getWorkstream(workstreamId) {
+    await this.ensureSchema();
+    const row = await this.selectFirst(`SELECT * FROM project_workstreams WHERE id = ${toSqlValue(workstreamId)} LIMIT 1`);
+    if (!row) return null;
+    const eventRows = await this.selectAll(`SELECT * FROM project_workstream_events WHERE workstream_id = ${toSqlValue(workstreamId)} ORDER BY created_at ASC`);
+    return {
+      ...workstreamFromRow(row),
+      events: eventRows.map(workstreamEventFromRow)
+    };
+  }
+  async upsertWorkstream(input) {
+    await this.ensureSchema();
+    const id = input.id ?? crypto.randomUUID();
+    const timestamp = nowIso();
+    await this.execute(
+      `INSERT OR REPLACE INTO project_workstreams (
+				id, project_id, title, summary, state, branch_name, branch_ref, owner, linked_items_json, verification_status, verification_summary,
+				last_save_at, last_stage_at, archived_at, metadata_json, created_at, updated_at
+			) VALUES (
+				${toSqlValue(id)},
+				${toSqlValue(input.projectId)},
+				${toSqlValue(input.title)},
+				${toSqlValue(input.summary ?? null)},
+				${toSqlValue(input.state ?? "drafting")},
+				${toSqlValue(input.branchName ?? null)},
+				${toSqlValue(input.branchRef ?? null)},
+				${toSqlValue(input.owner ?? null)},
+				${toSqlValue(JSON.stringify(input.linkedItems ?? []))},
+				${toSqlValue(input.verificationStatus ?? null)},
+				${toSqlValue(input.verificationSummary ?? null)},
+				${toSqlValue(input.lastSaveAt ?? null)},
+				${toSqlValue(input.lastStageAt ?? null)},
+				${toSqlValue(input.archivedAt ?? null)},
+				${toSqlValue(stringify(input.metadata ?? {}))},
+				COALESCE((SELECT created_at FROM project_workstreams WHERE id = ${toSqlValue(id)}), ${toSqlValue(timestamp)}),
+				${toSqlValue(timestamp)}
+			)`
+    );
+    const detail = await this.getWorkstream(id);
+    return detail ? { ...detail } : null;
+  }
+  async appendWorkstreamEvent(input) {
+    await this.ensureSchema();
+    const id = input.id ?? crypto.randomUUID();
+    await this.execute(
+      `INSERT INTO project_workstream_events (
+				id, workstream_id, project_id, kind, summary, data_json, created_at
+			) VALUES (
+				${toSqlValue(id)},
+				${toSqlValue(input.workstreamId)},
+				${toSqlValue(input.projectId)},
+				${toSqlValue(input.kind)},
+				${toSqlValue(input.summary ?? null)},
+				${toSqlValue(stringify(input.data ?? {}))},
+				${toSqlValue(input.createdAt ?? nowIso())}
+			)`
+    );
+    const row = await this.selectFirst(`SELECT * FROM project_workstream_events WHERE id = ${toSqlValue(id)} LIMIT 1`);
+    return row ? workstreamEventFromRow(row) : null;
+  }
+  async listReleases(projectId) {
+    await this.ensureSchema();
+    const rows = await this.selectAll(`SELECT * FROM project_releases WHERE project_id = ${toSqlValue(projectId)} ORDER BY updated_at DESC`);
+    return rows.map(releaseSummaryFromRow);
+  }
+  async getRelease(releaseId) {
+    await this.ensureSchema();
+    const row = await this.selectFirst(`SELECT * FROM project_releases WHERE id = ${toSqlValue(releaseId)} LIMIT 1`);
+    if (!row) return null;
+    const items = await this.selectAll(`SELECT * FROM project_release_items WHERE release_id = ${toSqlValue(releaseId)} ORDER BY created_at ASC`);
+    return {
+      ...releaseSummaryFromRow(row),
+      items: items.map((item) => ({
+        id: String(item.id ?? ""),
+        workstreamId: item.workstream_id === null || item.workstream_id === void 0 ? null : String(item.workstream_id),
+        model: item.model === null || item.model === void 0 ? null : String(item.model),
+        recordId: item.record_id === null || item.record_id === void 0 ? null : String(item.record_id),
+        summary: item.summary === null || item.summary === void 0 ? null : String(item.summary),
+        metadata: parseJson(item.metadata_json, {}),
+        createdAt: String(item.created_at ?? nowIso())
+      }))
+    };
+  }
+  async upsertRelease(input) {
+    await this.ensureSchema();
+    const id = input.id ?? crypto.randomUUID();
+    const timestamp = nowIso();
+    await this.execute(
+      `INSERT OR REPLACE INTO project_releases (
+				id, project_id, version, title, state, summary, workstream_ids_json, release_tag, commit_sha, published_at, rolled_back_at, metadata_json, created_at, updated_at
+			) VALUES (
+				${toSqlValue(id)},
+				${toSqlValue(input.projectId)},
+				${toSqlValue(input.version)},
+				${toSqlValue(input.title ?? null)},
+				${toSqlValue(input.state ?? "drafting")},
+				${toSqlValue(input.summary ?? null)},
+				${toSqlValue(JSON.stringify(input.workstreamIds ?? []))},
+				${toSqlValue(input.releaseTag ?? null)},
+				${toSqlValue(input.commitSha ?? null)},
+				${toSqlValue(input.publishedAt ?? null)},
+				${toSqlValue(input.rolledBackAt ?? null)},
+				${toSqlValue(stringify(input.metadata ?? {}))},
+				COALESCE((SELECT created_at FROM project_releases WHERE id = ${toSqlValue(id)}), ${toSqlValue(timestamp)}),
+				${toSqlValue(timestamp)}
+			)`
+    );
+    if (input.items) {
+      await this.execute(`DELETE FROM project_release_items WHERE release_id = ${toSqlValue(id)}`);
+      for (const item of input.items) {
+        await this.execute(
+          `INSERT INTO project_release_items (
+						id, release_id, workstream_id, model, record_id, summary, metadata_json, created_at
+					) VALUES (
+						${toSqlValue(item.id ?? crypto.randomUUID())},
+						${toSqlValue(id)},
+						${toSqlValue(item.workstreamId ?? null)},
+						${toSqlValue(item.model ?? null)},
+						${toSqlValue(item.recordId ?? null)},
+						${toSqlValue(item.summary ?? null)},
+						${toSqlValue(stringify(item.metadata ?? {}))},
+						${toSqlValue(item.createdAt ?? timestamp)}
+					)`
+        );
+      }
+    }
+    return this.getRelease(id);
+  }
+  async listSharePackages(projectId) {
+    await this.ensureSchema();
+    const rows = await this.selectAll(`SELECT * FROM project_share_packages WHERE project_id = ${toSqlValue(projectId)} ORDER BY updated_at DESC`);
+    return rows.map(sharePackageFromRow);
+  }
+  async getSharePackage(packageId) {
+    await this.ensureSchema();
+    const row = await this.selectFirst(`SELECT * FROM project_share_packages WHERE id = ${toSqlValue(packageId)} LIMIT 1`);
+    return row ? sharePackageFromRow(row) : null;
+  }
+  async upsertSharePackage(input) {
+    await this.ensureSchema();
+    const id = input.id ?? crypto.randomUUID();
+    const timestamp = nowIso();
+    await this.execute(
+      `INSERT OR REPLACE INTO project_share_packages (
+				id, project_id, kind, state, title, summary, version, output_path, artifact_key, manifest_key, published_item_id, last_error, metadata_json, created_at, updated_at
+			) VALUES (
+				${toSqlValue(id)},
+				${toSqlValue(input.projectId)},
+				${toSqlValue(input.kind)},
+				${toSqlValue(input.state ?? "draft")},
+				${toSqlValue(input.title)},
+				${toSqlValue(input.summary ?? null)},
+				${toSqlValue(input.version ?? null)},
+				${toSqlValue(input.outputPath ?? null)},
+				${toSqlValue(input.artifactKey ?? null)},
+				${toSqlValue(input.manifestKey ?? null)},
+				${toSqlValue(input.publishedItemId ?? null)},
+				${toSqlValue(input.lastError ?? null)},
+				${toSqlValue(stringify(input.metadata ?? {}))},
+				COALESCE((SELECT created_at FROM project_share_packages WHERE id = ${toSqlValue(id)}), ${toSqlValue(timestamp)}),
+				${toSqlValue(timestamp)}
+			)`
+    );
+    return this.getSharePackage(id);
+  }
+}
+export {
+  MemoryKnowledgeCoopStore,
+  SqliteKnowledgeCoopStore
+};

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

@@ -11,11 +11,15 @@
     "setup": "npm install",
     "setup:ci": "npm ci",
     "config": "treeseed config",
+    "preflight": "treeseed preflight",
     "dev": "treeseed dev",
+    "dev:web": "treeseed dev:web",
+    "dev:api": "treeseed dev:api",
     "dev:watch": "treeseed dev --watch",
     "check": "treeseed check",
-    "build": "treeseed build",
-    "deploy": "treeseed deploy",
+    "build:web": "treeseed build",
+    "build": "npm run build:web",
+    "deploy": "treeseed release",
     "preview": "treeseed preview",
     "sync": "treeseed sync",
     "verify": "npm run check && npm run build"

package/dist/treeseed/template-catalog/templates/starter-basic/template/src/api/server.js

@@ -0,0 +1,4 @@
+import { createRailwayTreeseedApiServer } from '@treeseed/core/api';
+
+const server = await createRailwayTreeseedApiServer();
+console.log(`Treeseed project API listening on ${server.url}`);