dev-flow-deepseek 0.1.0 → 0.5.2

package/lib/runtime.mjs

@@ -0,0 +1,103 @@
+import { execFile as execFileCallback } from "node:child_process";
+import { lstat, realpath, stat } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { promisify } from "node:util";
+
+import { containedPath, packageRootFromModule } from "./paths.mjs";
+
+export const SUPPORTED_RUNTIME_KEY = "darwin-arm64";
+
+const execFile = promisify(execFileCallback);
+const semverPattern = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/u;
+
+export async function selectPackagedRuntime({
+  packageRoot = packageRootFromModule(import.meta.url),
+  platform = process.platform,
+  arch = process.arch,
+} = {}) {
+  const runtimeKey = `${platform}-${arch}`;
+  if (runtimeKey !== SUPPORTED_RUNTIME_KEY) {
+    throw new Error(`unsupported platform ${runtimeKey}; dev-flow-deepseek supports ${SUPPORTED_RUNTIME_KEY}`);
+  }
+
+  const canonicalPackageRoot = await canonicalPackageDirectory(packageRoot);
+  return Object.freeze({
+    packageRoot: canonicalPackageRoot,
+    runtimeKey,
+    runtimePath: containedPath(
+      canonicalPackageRoot,
+      join(canonicalPackageRoot, "runtime", runtimeKey, "dev-flow"),
+      "packaged Core runtime",
+    ),
+  });
+}
+
+export async function preflightPackagedCore(
+  selection,
+  {
+    environment = process.env,
+    currentDirectory = dirname(selection?.runtimePath ?? "."),
+  } = {},
+) {
+  if (!selection || selection.runtimeKey !== SUPPORTED_RUNTIME_KEY) {
+    throw new Error("packaged Core selection must use darwin-arm64");
+  }
+  const expectedRuntimePath = containedPath(
+    selection.packageRoot,
+    join(selection.packageRoot, "runtime", SUPPORTED_RUNTIME_KEY, "dev-flow"),
+    "packaged Core runtime",
+  );
+  if (selection.runtimePath !== expectedRuntimePath) {
+    throw new Error("packaged Core must use the exact package-relative runtime path");
+  }
+  await assertRegularExecutableFile(selection.runtimePath);
+
+  let stdout;
+  try {
+    ({ stdout } = await execFile(selection.runtimePath, ["version"], {
+      cwd: currentDirectory,
+      env: environment,
+      encoding: "utf8",
+      maxBuffer: 64 * 1024,
+      windowsHide: true,
+    }));
+  } catch (error) {
+    throw new Error("packaged Core version preflight failed", { cause: error });
+  }
+
+  const match = /^dev-flow (\S+)\n?$/u.exec(stdout);
+  if (!match || !semverPattern.test(match[1])) {
+    throw new Error("packaged Core returned an invalid version line");
+  }
+  return Object.freeze({ ...selection, version: match[1] });
+}
+
+async function canonicalPackageDirectory(path) {
+  try {
+    const canonical = await realpath(path);
+    const info = await stat(canonical);
+    if (!info.isDirectory()) throw new Error("not a directory");
+    return canonical;
+  } catch (error) {
+    throw new Error("package root must name an existing directory", { cause: error });
+  }
+}
+
+async function assertRegularExecutableFile(path) {
+  let info;
+  try {
+    info = await lstat(path);
+  } catch (error) {
+    throw new Error("packaged Core must be a regular executable file", { cause: error });
+  }
+  if (!info.isFile() || info.isSymbolicLink()) {
+    throw new Error("packaged Core must be a regular executable file");
+  }
+  if ((info.mode & 0o111) === 0) {
+    throw new Error("packaged Core must have executable mode");
+  }
+  const canonical = await realpath(path);
+  if (canonical !== path) {
+    throw new Error("packaged Core must use a canonical package-relative runtime path");
+  }
+}

package/lib/tool-names.mjs

@@ -0,0 +1,43 @@
+export const DEV_FLOW_SERVER_NAME = "dev_flow";
+export const DEV_FLOW_TOOL_NAMESPACE_PREFIX = `mcp__${DEV_FLOW_SERVER_NAME}__`;
+
+export const DEV_FLOW_RAW_TOOL_NAMES = Object.freeze([
+  "dev_flow_server_info",
+  "dev_flow_open_task",
+  "dev_flow_get_task",
+  "dev_flow_get_next_action",
+  "dev_flow_apply_action",
+  "dev_flow_cancel_task",
+]);
+
+export const DEV_FLOW_QUALIFIED_TOOL_NAMES = Object.freeze(
+  DEV_FLOW_RAW_TOOL_NAMES.map((rawName) => `${DEV_FLOW_TOOL_NAMESPACE_PREFIX}${rawName}`),
+);
+
+const expectedQualifiedTools = new Set(DEV_FLOW_QUALIFIED_TOOL_NAMES);
+
+export function isDevFlowNamespaceTool(name) {
+  return typeof name === "string" && name.startsWith(DEV_FLOW_TOOL_NAMESPACE_PREFIX);
+}
+
+export function isExpectedDevFlowTool(name) {
+  return expectedQualifiedTools.has(name);
+}
+
+export function assertQualifiedToolCatalog(toolNames, { allowUnavailable = false } = {}) {
+  const namespaceTools = [...toolNames]
+    .filter(isDevFlowNamespaceTool)
+    .sort();
+  if (allowUnavailable && namespaceTools.length === 0) return Object.freeze([]);
+
+  const expected = [...DEV_FLOW_QUALIFIED_TOOL_NAMES].sort();
+  if (
+    namespaceTools.length !== expected.length
+    || namespaceTools.some((name, index) => name !== expected[index])
+  ) {
+    throw new Error(
+      `Dev Flow tool catalog mismatch: received ${JSON.stringify(namespaceTools)}; expected ${JSON.stringify(expected)}`,
+    );
+  }
+  return DEV_FLOW_QUALIFIED_TOOL_NAMES;
+}

package/package.json

@@ -1,58 +1,55 @@
 {
   "name": "dev-flow-deepseek",
-  "version": "0.1.0",
-  "description": "DeepSeek Harness bundle for the external Dev Flow Orchestrator MCP runtime.",
-  "type": "module",
+  "version": "0.5.2",
+  "private": false,
+  "description": "Explicit DeepSeek Harness adapter for the Dev Flow process graph.",
   "license": "Apache-2.0",
-  "keywords": [
-    "deepseek",
-    "deepseek-harness",
-    "dev-flow",
-    "mcp",
-    "plugin"
+  "type": "module",
+  "main": "lib/index.mjs",
+  "files": [
+    "LICENSE",
+    "README.md",
+    "cordis.patch.yml",
+    "lib/authorization.mjs",
+    "lib/index.mjs",
+    "lib/paths.mjs",
+    "lib/runtime.mjs",
+    "lib/tool-names.mjs",
+    "runtime/darwin-arm64/dev-flow",
+    "skills/dev-flow/SKILL.md",
+    "skills/dev-flow/references/method-profiles.md",
+    "skills/dev-flow/references/node-payloads.md"
   ],
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/Innocent-children/dev-flow-deepseek.git"
-  },
-  "bugs": {
-    "url": "https://github.com/Innocent-children/dev-flow-deepseek/issues"
-  },
-  "homepage": "https://github.com/Innocent-children/dev-flow-deepseek#readme",
-  "publishConfig": {
-    "access": "public",
-    "tag": "latest"
+  "scripts": {
+    "test": "node --test tests/*.test.mjs",
+    "test:package": "node --test tests/package-contract.test.mjs",
+    "test:bundle": "node --test tests/bundle-contract.test.mjs",
+    "pack:dry": "pnpm pack --dry-run --json"
   },
   "engines": {
-    "node": "^22.19.0 || >=24.0.0"
+    "node": ">=24"
   },
-  "files": [
-    "lib/",
-    "cordis.patch.yml",
-    "skills/",
-    "README.md",
-    "LICENSE"
+  "os": [
+    "darwin"
   ],
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "1.12.0"
-  },
-  "devDependencies": {
-    "@types/js-yaml": "4.0.9",
-    "@types/node": "22.15.3",
-    "js-yaml": "4.1.0",
-    "tsdown": "0.15.4",
-    "typescript": "5.8.3"
+  "cpu": [
+    "arm64"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
   },
   "dsh": {
     "bundle": {
       "patch": "./cordis.patch.yml"
     }
   },
-  "scripts": {
-    "build": "tsdown && chmod 755 lib/proxy.js",
-    "typecheck": "tsc --noEmit",
-    "test": "node --test tests/unit/*.test.mjs tests/integration/proxy.test.mjs tests/package/package-contract.test.mjs",
-    "test:real": "node --test tests/integration/real-runtime.test.mjs",
-    "verify:package": "node scripts/verify-package.mjs"
+  "dependencies": {
+    "@deepseek-ai/dsh-mcp-client": ">=0.1.0-rc.6"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": ">=4.0.1 <5.0.0",
+    "@deepseek-ai/dsh-skill": ">=0.1.0-rc.6",
+    "@deepseek-ai/dsh-tools": ">=0.1.0-rc.6"
   }
-}
+}