Implement OpenSpec artifacts and SDK contracts

packages/sdk/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "@logicsrc/sdk",
+  "version": "0.1.0",
+  "description": "LogicSRC SDK contract types and client interface.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run src"
+  },
+  "devDependencies": {
+    "vitest": "^4.0.8"
+  }
+}

packages/sdk/src/index.test.ts

@@ -0,0 +1,31 @@
+import { describe, expect, it } from "vitest";
+import { createAgentSwarmSession, createTask } from "./index.js";
+
+describe("LogicSRC SDK contract helpers", () => {
+  it("creates task documents with LogicSRC defaults", () => {
+    expect(createTask({
+      title: "Document SDK",
+      description: "Add SDK contract helpers.",
+      board: "/docs",
+      creator_did: "did:example:alice"
+    })).toMatchObject({
+      type: "logicsrc.task",
+      version: "0.1",
+      status: "draft"
+    });
+  });
+
+  it("creates AgentSwarm session documents", () => {
+    expect(createAgentSwarmSession({
+      repo: "profullstack/logicsrc",
+      agents: ["reproduce", "patch"],
+      yolo: true,
+      openspec: true
+    })).toMatchObject({
+      type: "logicsrc.agentswarm.session",
+      mode: "yolo",
+      openspec_compatible: true,
+      slave_agents: ["reproduce", "patch"]
+    });
+  });
+});

packages/sdk/src/index.ts

@@ -0,0 +1,90 @@
+export type LogicSrcId = string;
+
+export interface LogicSrcTask {
+  type: "logicsrc.task";
+  version: string;
+  title: string;
+  description: string;
+  board: string;
+  creator_did: string;
+  status: "draft" | "open" | "funded" | "claimed" | "submitted" | "approved" | "rejected" | "disputed" | "closed";
+  budget?: {
+    amount: number;
+    currency: string;
+  };
+  assignee_did?: string;
+}
+
+export interface LogicSrcAgent {
+  type: "logicsrc.agent";
+  id: LogicSrcId;
+  name: string;
+  capabilities: string[];
+  logicsrc_compatibility_version?: string;
+}
+
+export interface LogicSrcRun {
+  type: "logicsrc.agent_run";
+  id: LogicSrcId;
+  agent_id: LogicSrcId;
+  status: "queued" | "running" | "succeeded" | "failed" | "canceled";
+  task_id?: LogicSrcId;
+}
+
+export interface LogicSrcEvent {
+  type: "logicsrc.event";
+  event: string;
+  resource_id: LogicSrcId;
+  created_at?: string;
+}
+
+export interface AgentSwarmSession {
+  type: "logicsrc.agentswarm.session";
+  status: "opening" | "active" | "paused" | "completed" | "failed";
+  mode: "yolo" | "review";
+  master_agent: string;
+  slave_agents: string[];
+  repo: string | null;
+  openspec_compatible: boolean;
+  openspec_only: boolean;
+}
+
+export interface LogicSrcClient {
+  createTask(input: Omit<LogicSrcTask, "type" | "version" | "status"> & Partial<Pick<LogicSrcTask, "version" | "status">>): Promise<LogicSrcTask>;
+  validateTask(input: unknown): Promise<{ ok: boolean; errors: string[] }>;
+  startAgentSwarm(input: {
+    repo?: string;
+    agents?: string[];
+    yolo?: boolean;
+    openspec?: boolean;
+    openspecOnly?: boolean;
+  }): Promise<AgentSwarmSession>;
+}
+
+export function createTask(input: Omit<LogicSrcTask, "type" | "version" | "status"> & Partial<Pick<LogicSrcTask, "version" | "status">>): LogicSrcTask {
+  return {
+    type: "logicsrc.task",
+    version: input.version ?? "0.1",
+    status: input.status ?? "draft",
+    ...input
+  };
+}
+
+export function createAgentSwarmSession(input: {
+  repo?: string;
+  agents?: string[];
+  yolo?: boolean;
+  openspec?: boolean;
+  openspecOnly?: boolean;
+}): AgentSwarmSession {
+  return {
+    type: "logicsrc.agentswarm.session",
+    status: "opening",
+    mode: input.yolo ? "yolo" : "review",
+    master_agent: "agentswarm-master",
+    slave_agents: input.agents ?? ["reproduce", "patch", "review"],
+    repo: input.repo ?? null,
+    openspec_compatible: input.openspec ?? false,
+    openspec_only: input.openspecOnly ?? false
+  };
+}

packages/sdk/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "rootDir": "src",
+    "outDir": "dist"
+  },
+  "include": ["src/**/*.ts"]
+}