@metagptx/deepflow-suite-cli 0.0.0-stage → 0.1.1

package/src/manifest.mjs

@@ -0,0 +1,72 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+import { CLI_NAMES, DISTRIBUTION, PACKAGE_NAME, SKILL_NAMES } from "./constants.mjs";
+
+const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+
+export const defaultManifestPath = path.join(packageRoot, "manifest.json");
+
+export async function loadManifest(manifestPath = defaultManifestPath) {
+  const manifest = JSON.parse(await readFile(manifestPath, "utf8"));
+  validateManifest(manifest);
+  return manifest;
+}
+
+export function validateManifest(manifest) {
+  if (!manifest || typeof manifest !== "object") {
+    throw new Error("DeepFlow manifest must be an object");
+  }
+  if (manifest.distribution !== DISTRIBUTION) {
+    throw new Error(`DeepFlow manifest distribution must be ${DISTRIBUTION}`);
+  }
+  if (typeof manifest.version !== "string" || !/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/.test(manifest.version)) {
+    throw new Error("DeepFlow manifest version must be a semantic version");
+  }
+  if (!Array.isArray(manifest.skills) || manifest.skills.length !== SKILL_NAMES.length) {
+    throw new Error("DeepFlow manifest must contain exactly seven skills");
+  }
+  if (!Array.isArray(manifest.clis) || manifest.clis.length !== CLI_NAMES.length) {
+    throw new Error("DeepFlow manifest must contain exactly five CLIs");
+  }
+
+  const skillNames = manifest.skills.map((skill) => skill.name);
+  if (JSON.stringify([...skillNames].sort()) !== JSON.stringify([...SKILL_NAMES].sort())) {
+    throw new Error(`DeepFlow manifest skills must be ${SKILL_NAMES.join(", ")}`);
+  }
+
+  const cliNames = manifest.clis.map((cli) => cli.name);
+  if (JSON.stringify([...cliNames].sort()) !== JSON.stringify([...CLI_NAMES].sort())) {
+    throw new Error(`DeepFlow manifest CLIs must be ${CLI_NAMES.join(", ")}`);
+  }
+
+  for (const skill of manifest.skills) {
+    if (!skill || typeof skill.name !== "string" || typeof skill.source !== "string") {
+      throw new Error("DeepFlow manifest skills must define name and source");
+    }
+    if (path.isAbsolute(skill.source) || skill.source.split(/[\\/]/).includes("..")) {
+      throw new Error(`DeepFlow manifest skill source must be relative: ${skill.name}`);
+    }
+  }
+  for (const cli of manifest.clis) {
+    if (!cli || typeof cli.name !== "string" || typeof cli.project !== "string" || typeof cli.install !== "string") {
+      throw new Error("DeepFlow manifest CLIs must define name, project, and install");
+    }
+  }
+}
+
+export function resolveSkillSources(manifest, workspaceRoot, mode = "workspace") {
+  return manifest.skills.map((skill) => ({
+    ...skill,
+    sourcePath: path.resolve(workspaceRoot, mode === "package" ? (skill.packageSource || `skills/${skill.name}`) : skill.source),
+  }));
+}
+
+export function packageManifest() {
+  return {
+    distribution: DISTRIBUTION,
+    package: PACKAGE_NAME,
+    cli: "deepflow-suite",
+  };
+}