@hasna/workflows 0.1.0

package/dist/index.js

@@ -0,0 +1,232 @@
+// @bun
+// src/service.ts
+import { join } from "path";
+// package.json
+var package_default = {
+  name: "@hasna/workflows",
+  version: "0.1.0",
+  description: "Universal graph workflow app \u2014 scaffold with version/health/readiness on all four surfaces; graph language, store, session WAL, daemon, and lane adapters are roadmap",
+  type: "module",
+  main: "./dist/index.js",
+  types: "./types/index.d.ts",
+  bin: {
+    workflows: "dist/cli/index.js",
+    "workflows-mcp": "dist/mcp/index.js",
+    "workflows-serve": "dist/serve/index.js"
+  },
+  exports: {
+    ".": {
+      types: "./types/index.d.ts",
+      import: "./dist/index.js"
+    },
+    "./sdk": {
+      types: "./types/index.d.ts",
+      import: "./dist/index.js"
+    },
+    "./cli": {
+      types: "./types/cli/index.d.ts",
+      import: "./dist/cli/index.js"
+    }
+  },
+  files: [
+    "dist",
+    "types",
+    "README.md",
+    "LICENSE",
+    "hasna.contract.json"
+  ],
+  scripts: {
+    build: "bun run build:runtime && bun run build:types",
+    "build:runtime": "rm -rf dist && bun build src/cli/index.ts --outdir dist/cli --target bun --packages external && bun build src/mcp/index.ts --outdir dist/mcp --target bun --packages external && bun build src/serve/index.ts --outdir dist/serve --target bun --packages external && bun build src/index.ts src/service.ts src/handlers.ts src/agent-tools.ts src/types.ts --root src --outdir dist --target bun --packages external",
+    "build:types": "rm -rf types && tsc -p tsconfig.build.json --emitDeclarationOnly --outDir types",
+    "artifact-scan": "bun scripts/contracts-cli.mjs artifact-scan dist",
+    "contract:check": "bun scripts/contracts-cli.mjs repo-conformance .",
+    typecheck: "tsc --noEmit",
+    test: "bun test",
+    "test:pg": 'WORKFLOWS_TEST_DATABASE_URL="${WORKFLOWS_TEST_DATABASE_URL:?point it at a throwaway Postgres; the live-PG gate must not pass without one}" WORKFLOWS_REQUIRE_POSTGRES=1 bun test src/db/pg-live.test.ts',
+    prepack: "bun run build && bun run artifact-scan",
+    prepublishOnly: "bun run test && bun run build"
+  },
+  keywords: [
+    "workflows",
+    "graph",
+    "automation",
+    "cli",
+    "typescript",
+    "bun",
+    "hasna"
+  ],
+  publishConfig: {
+    registry: "https://registry.npmjs.org",
+    access: "public"
+  },
+  repository: {
+    type: "git",
+    url: "git+https://github.com/hasna/apps.git"
+  },
+  homepage: "https://github.com/hasna/apps/tree/main/apps/workflows",
+  bugs: {
+    url: "https://github.com/hasna/apps/issues"
+  },
+  engines: {
+    bun: ">=1.0.0",
+    node: ">=20.0.0"
+  },
+  author: "Hasna",
+  license: "Apache-2.0",
+  dependencies: {
+    commander: "^13.1.0"
+  },
+  devDependencies: {
+    "@hasna/contracts": "0.14.0",
+    "@types/bun": "latest",
+    "@types/pg": "^8.15.6",
+    pg: "^8.16.3",
+    typescript: "^5.7.3"
+  }
+};
+
+// src/service.ts
+var DEFAULT_PORT = 8790;
+var DEFAULT_HOST = "127.0.0.1";
+function packageVersion() {
+  return package_default.version;
+}
+function envString(names) {
+  for (const name of names) {
+    const value = process.env[name];
+    if (value !== undefined && value !== "")
+      return value;
+  }
+  return;
+}
+function envInt(names, fallback) {
+  const value = envString(names);
+  if (value === undefined)
+    return fallback;
+  const parsed = Number(value);
+  return Number.isFinite(parsed) ? parsed : fallback;
+}
+function resolveWorkflowsConfig(overrides = {}) {
+  const home = process.env.HOME ?? process.env.USERPROFILE ?? ".";
+  return {
+    port: overrides.port ?? envInt(["HASNA_WORKFLOWS_PORT", "WORKFLOWS_PORT"], DEFAULT_PORT),
+    host: overrides.host ?? envString(["HASNA_WORKFLOWS_HOST", "WORKFLOWS_HOST"]) ?? DEFAULT_HOST,
+    dataDir: overrides.dataDir ?? envString(["HASNA_WORKFLOWS_DATA_DIR", "WORKFLOWS_DATA_DIR"]) ?? join(home, ".hasna", "workflows"),
+    apiUrl: overrides.apiUrl ?? envString(["WORKFLOWS_API_URL"]),
+    apiKey: overrides.apiKey ?? envString(["WORKFLOWS_API_KEY"])
+  };
+}
+
+class WorkflowsService {
+  name = "workflows";
+  version;
+  config;
+  startedAt = Date.now();
+  constructor(config = {}) {
+    this.config = resolveWorkflowsConfig(config);
+    this.version = packageVersion();
+  }
+  health() {
+    return {
+      ok: true,
+      service: this.name,
+      version: this.version,
+      pid: process.pid,
+      uptimeMs: Date.now() - this.startedAt
+    };
+  }
+  ready() {
+    return {
+      ok: true,
+      service: this.name,
+      version: this.version,
+      checks: { version: "ok" }
+    };
+  }
+}
+function createWorkflowsService(config = {}) {
+  return new WorkflowsService(config);
+}
+
+// src/handlers.ts
+function jsonResponse(body, status = 200) {
+  return new Response(JSON.stringify(body), {
+    status,
+    headers: { "content-type": "application/json" }
+  });
+}
+function openApiDoc(service) {
+  return {
+    openapi: "3.0.3",
+    info: { title: "workflows", version: service.version },
+    paths: {
+      "/health": { get: { summary: "Service health", responses: { "200": { description: "ok" } } } },
+      "/ready": { get: { summary: "Service readiness", responses: { "200": { description: "ok" } } } },
+      "/version": { get: { summary: "Service version", responses: { "200": { description: "ok" } } } }
+    }
+  };
+}
+function createRequestHandler(service) {
+  return (req) => {
+    const url = new URL(req.url);
+    switch (url.pathname) {
+      case "/health":
+        return jsonResponse(service.health());
+      case "/ready":
+        return jsonResponse(service.ready());
+      case "/version":
+        return jsonResponse({ service: service.name, version: service.version });
+      case "/openapi.json":
+        return jsonResponse(openApiDoc(service));
+      default:
+        return jsonResponse({ error: "not_found", path: url.pathname }, 404);
+    }
+  };
+}
+
+// src/agent-tools.ts
+function textResult(payload) {
+  return { content: [{ type: "text", text: JSON.stringify(payload) }], isError: false };
+}
+function workflowsTools(_service) {
+  return [
+    {
+      name: "workflows_version",
+      description: "Report the installed @hasna/workflows version.",
+      inputSchema: { type: "object", properties: {} }
+    },
+    {
+      name: "workflows_health",
+      description: "Report the workflows service health (service, version, pid, uptime).",
+      inputSchema: { type: "object", properties: {} }
+    },
+    {
+      name: "workflows_ready",
+      description: "Report the workflows service readiness (version check).",
+      inputSchema: { type: "object", properties: {} }
+    }
+  ];
+}
+function callWorkflowTool(service, name, _args) {
+  switch (name) {
+    case "workflows_version":
+      return textResult({ service: service.name, version: service.version });
+    case "workflows_health":
+      return textResult(service.health());
+    case "workflows_ready":
+      return textResult(service.ready());
+    default:
+      throw new Error(`Unknown tool: ${name}`);
+  }
+}
+export {
+  workflowsTools,
+  resolveWorkflowsConfig,
+  packageVersion,
+  jsonResponse,
+  createWorkflowsService,
+  createRequestHandler,
+  callWorkflowTool,
+  WorkflowsService
+};

package/dist/mcp/index.js

@@ -0,0 +1,270 @@
+#!/usr/bin/env bun
+// @bun
+
+// src/mcp/index.ts
+import { createInterface } from "readline";
+
+// src/agent-tools.ts
+function textResult(payload) {
+  return { content: [{ type: "text", text: JSON.stringify(payload) }], isError: false };
+}
+function workflowsTools(_service) {
+  return [
+    {
+      name: "workflows_version",
+      description: "Report the installed @hasna/workflows version.",
+      inputSchema: { type: "object", properties: {} }
+    },
+    {
+      name: "workflows_health",
+      description: "Report the workflows service health (service, version, pid, uptime).",
+      inputSchema: { type: "object", properties: {} }
+    },
+    {
+      name: "workflows_ready",
+      description: "Report the workflows service readiness (version check).",
+      inputSchema: { type: "object", properties: {} }
+    }
+  ];
+}
+function callWorkflowTool(service, name, _args) {
+  switch (name) {
+    case "workflows_version":
+      return textResult({ service: service.name, version: service.version });
+    case "workflows_health":
+      return textResult(service.health());
+    case "workflows_ready":
+      return textResult(service.ready());
+    default:
+      throw new Error(`Unknown tool: ${name}`);
+  }
+}
+
+// src/service.ts
+import { join } from "path";
+// package.json
+var package_default = {
+  name: "@hasna/workflows",
+  version: "0.1.0",
+  description: "Universal graph workflow app \u2014 scaffold with version/health/readiness on all four surfaces; graph language, store, session WAL, daemon, and lane adapters are roadmap",
+  type: "module",
+  main: "./dist/index.js",
+  types: "./types/index.d.ts",
+  bin: {
+    workflows: "dist/cli/index.js",
+    "workflows-mcp": "dist/mcp/index.js",
+    "workflows-serve": "dist/serve/index.js"
+  },
+  exports: {
+    ".": {
+      types: "./types/index.d.ts",
+      import: "./dist/index.js"
+    },
+    "./sdk": {
+      types: "./types/index.d.ts",
+      import: "./dist/index.js"
+    },
+    "./cli": {
+      types: "./types/cli/index.d.ts",
+      import: "./dist/cli/index.js"
+    }
+  },
+  files: [
+    "dist",
+    "types",
+    "README.md",
+    "LICENSE",
+    "hasna.contract.json"
+  ],
+  scripts: {
+    build: "bun run build:runtime && bun run build:types",
+    "build:runtime": "rm -rf dist && bun build src/cli/index.ts --outdir dist/cli --target bun --packages external && bun build src/mcp/index.ts --outdir dist/mcp --target bun --packages external && bun build src/serve/index.ts --outdir dist/serve --target bun --packages external && bun build src/index.ts src/service.ts src/handlers.ts src/agent-tools.ts src/types.ts --root src --outdir dist --target bun --packages external",
+    "build:types": "rm -rf types && tsc -p tsconfig.build.json --emitDeclarationOnly --outDir types",
+    "artifact-scan": "bun scripts/contracts-cli.mjs artifact-scan dist",
+    "contract:check": "bun scripts/contracts-cli.mjs repo-conformance .",
+    typecheck: "tsc --noEmit",
+    test: "bun test",
+    "test:pg": 'WORKFLOWS_TEST_DATABASE_URL="${WORKFLOWS_TEST_DATABASE_URL:?point it at a throwaway Postgres; the live-PG gate must not pass without one}" WORKFLOWS_REQUIRE_POSTGRES=1 bun test src/db/pg-live.test.ts',
+    prepack: "bun run build && bun run artifact-scan",
+    prepublishOnly: "bun run test && bun run build"
+  },
+  keywords: [
+    "workflows",
+    "graph",
+    "automation",
+    "cli",
+    "typescript",
+    "bun",
+    "hasna"
+  ],
+  publishConfig: {
+    registry: "https://registry.npmjs.org",
+    access: "public"
+  },
+  repository: {
+    type: "git",
+    url: "git+https://github.com/hasna/apps.git"
+  },
+  homepage: "https://github.com/hasna/apps/tree/main/apps/workflows",
+  bugs: {
+    url: "https://github.com/hasna/apps/issues"
+  },
+  engines: {
+    bun: ">=1.0.0",
+    node: ">=20.0.0"
+  },
+  author: "Hasna",
+  license: "Apache-2.0",
+  dependencies: {
+    commander: "^13.1.0"
+  },
+  devDependencies: {
+    "@hasna/contracts": "0.14.0",
+    "@types/bun": "latest",
+    "@types/pg": "^8.15.6",
+    pg: "^8.16.3",
+    typescript: "^5.7.3"
+  }
+};
+
+// src/service.ts
+var DEFAULT_PORT = 8790;
+var DEFAULT_HOST = "127.0.0.1";
+function packageVersion() {
+  return package_default.version;
+}
+function envString(names) {
+  for (const name of names) {
+    const value = process.env[name];
+    if (value !== undefined && value !== "")
+      return value;
+  }
+  return;
+}
+function envInt(names, fallback) {
+  const value = envString(names);
+  if (value === undefined)
+    return fallback;
+  const parsed = Number(value);
+  return Number.isFinite(parsed) ? parsed : fallback;
+}
+function resolveWorkflowsConfig(overrides = {}) {
+  const home = process.env.HOME ?? process.env.USERPROFILE ?? ".";
+  return {
+    port: overrides.port ?? envInt(["HASNA_WORKFLOWS_PORT", "WORKFLOWS_PORT"], DEFAULT_PORT),
+    host: overrides.host ?? envString(["HASNA_WORKFLOWS_HOST", "WORKFLOWS_HOST"]) ?? DEFAULT_HOST,
+    dataDir: overrides.dataDir ?? envString(["HASNA_WORKFLOWS_DATA_DIR", "WORKFLOWS_DATA_DIR"]) ?? join(home, ".hasna", "workflows"),
+    apiUrl: overrides.apiUrl ?? envString(["WORKFLOWS_API_URL"]),
+    apiKey: overrides.apiKey ?? envString(["WORKFLOWS_API_KEY"])
+  };
+}
+
+class WorkflowsService {
+  name = "workflows";
+  version;
+  config;
+  startedAt = Date.now();
+  constructor(config = {}) {
+    this.config = resolveWorkflowsConfig(config);
+    this.version = packageVersion();
+  }
+  health() {
+    return {
+      ok: true,
+      service: this.name,
+      version: this.version,
+      pid: process.pid,
+      uptimeMs: Date.now() - this.startedAt
+    };
+  }
+  ready() {
+    return {
+      ok: true,
+      service: this.name,
+      version: this.version,
+      checks: { version: "ok" }
+    };
+  }
+}
+function createWorkflowsService(config = {}) {
+  return new WorkflowsService(config);
+}
+
+// src/mcp/index.ts
+var HELP_TEXT = `workflows-mcp \u2014 MCP server for @hasna/workflows
+
+Usage:
+  workflows-mcp [--version] [--help]
+
+Speaks the MCP protocol over stdio. Tools:
+  workflows_version  report the installed version
+  workflows_health   report service health
+  workflows_ready    report service readiness`;
+var argv = process.argv.slice(2);
+if (argv.includes("--version") || argv.includes("-v")) {
+  console.log(packageVersion());
+  process.exit(0);
+}
+if (argv.includes("--help") || argv.includes("-h")) {
+  console.log(HELP_TEXT);
+  process.exit(0);
+}
+function respond(id, result) {
+  if (id === null || id === undefined)
+    return;
+  process.stdout.write(JSON.stringify({ jsonrpc: "2.0", id, result }) + `
+`);
+}
+function respondError(id, code, message) {
+  if (id === null || id === undefined)
+    return;
+  process.stdout.write(JSON.stringify({ jsonrpc: "2.0", id, error: { code, message } }) + `
+`);
+}
+var service = createWorkflowsService();
+var rl = createInterface({ input: process.stdin, crlfDelay: Infinity });
+rl.on("line", (line) => {
+  const trimmed = line.trim();
+  if (trimmed === "")
+    return;
+  let msg;
+  try {
+    msg = JSON.parse(trimmed);
+  } catch {
+    return;
+  }
+  const method = msg.method ?? "";
+  if (method === "initialize") {
+    respond(msg.id ?? null, {
+      protocolVersion: "2024-11-05",
+      capabilities: { tools: {} },
+      serverInfo: { name: "workflows-mcp", version: packageVersion() }
+    });
+    return;
+  }
+  if (method.startsWith("notifications/"))
+    return;
+  if (method === "ping") {
+    respond(msg.id ?? null, {});
+    return;
+  }
+  if (method === "tools/list") {
+    respond(msg.id ?? null, { tools: workflowsTools(service) });
+    return;
+  }
+  if (method === "tools/call") {
+    const params = msg.params ?? {};
+    const name = typeof params.name === "string" ? params.name : "";
+    const args = params.arguments ?? {};
+    try {
+      respond(msg.id ?? null, callWorkflowTool(service, name, args));
+    } catch (err) {
+      respond(msg.id ?? null, {
+        content: [{ type: "text", text: String(err instanceof Error ? err.message : err) }],
+        isError: true
+      });
+    }
+    return;
+  }
+  respondError(msg.id ?? null, -32601, `Method not found: ${method}`);
+});