dev-flow-deepseek 0.1.0 → 0.5.2

package/lib/proxy.js

@@ -1,87 +0,0 @@
-#!/usr/bin/env node
-import { APPROVED_RAW_TOOLS, MAX_ADAPTER_DIAGNOSTIC_BYTES, PACKAGE_NAME, PACKAGE_VERSION, STARTUP_EXIT_CODE } from "./compatibility.js";
-import { BackendClient, BackendStartupError } from "./backend-client.js";
-import { readBackendConfiguration } from "./environment.js";
-import { createAdapterErrorResult, projectBackendResult } from "./result-envelope.js";
-import process from "node:process";
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
-
-//#region src/proxy.ts
-function isApprovedTool(name) {
-	return APPROVED_RAW_TOOLS.includes(name);
-}
-function startupDiagnostic(code) {
-	const text = `dsh-dev-flow projection proxy startup failed (${code}).`;
-	if (Buffer.byteLength(text, "utf8") > 4096) return "dsh-dev-flow projection proxy startup failed.";
-	return text;
-}
-async function startProxy() {
-	let backend;
-	try {
-		backend = await BackendClient.connect(readBackendConfiguration());
-	} catch (error) {
-		const code = error instanceof BackendStartupError ? error.code : "BACKEND_START_FAILED";
-		process.stderr.write(`${startupDiagnostic(code)}\n`);
-		process.exitCode = 2;
-		return;
-	}
-	const server = new Server({
-		name: PACKAGE_NAME,
-		version: PACKAGE_VERSION
-	}, { capabilities: { tools: {} } });
-	server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: [...backend.tools] }));
-	server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
-		const name = request.params.name;
-		if (!isApprovedTool(name)) throw new TypeError("Requested tool is not exposed by this proxy.");
-		let upstream;
-		try {
-			upstream = await backend.call(name, request.params.arguments ?? {}, extra.signal);
-		} catch {
-			const code = extra.signal.aborted ? "REQUEST_CANCELLED" : "UPSTREAM_CALL_FAILED";
-			return createAdapterErrorResult(name, code);
-		}
-		try {
-			return projectBackendResult(name, upstream);
-		} catch {
-			return createAdapterErrorResult(name, "UPSTREAM_RESULT_INVALID");
-		}
-	});
-	const outwardTransport = new StdioServerTransport();
-	let shuttingDown = false;
-	const shutdown = async (exitCode) => {
-		if (shuttingDown) return;
-		shuttingDown = true;
-		if (exitCode !== 0) process.exitCode = exitCode;
-		await Promise.allSettled([server.close(), backend.close()]);
-	};
-	process.once("SIGINT", () => {
-		shutdown(0);
-	});
-	process.once("SIGTERM", () => {
-		shutdown(0);
-	});
-	backend.closed.then(() => {
-		if (!shuttingDown) shutdown(1);
-	});
-	try {
-		await server.connect(outwardTransport);
-	} catch {
-		process.stderr.write(`${startupDiagnostic("BACKEND_INITIALIZE_FAILED")}\n`);
-		await shutdown(2);
-		return;
-	}
-	const protocolClose = outwardTransport.onclose;
-	outwardTransport.onclose = () => {
-		protocolClose?.();
-		if (!shuttingDown) shutdown(0);
-	};
-}
-startProxy().catch(() => {
-	process.stderr.write(`${startupDiagnostic("BACKEND_INITIALIZE_FAILED")}\n`);
-	process.exitCode = 2;
-});
-
-//#endregion
-export {  };

package/lib/result-envelope.js

@@ -1,105 +0,0 @@
-import { ADAPTER_ERROR_CODES, ADAPTER_ERROR_SCHEMA, APPROVED_RAW_TOOLS, DEV_FLOW_RESULT_SCHEMA, MAX_ADAPTER_DIAGNOSTIC_BYTES } from "./compatibility.js";
-import { canonicalJson } from "./canonical-json.js";
-
-//#region src/result-envelope.ts
-const REQUEST_ID_PATTERN = /^mcp-[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/;
-const ADAPTER_MESSAGES = Object.freeze({
-	BACKEND_START_FAILED: "The Dev Flow backend could not be started.",
-	BACKEND_INITIALIZE_FAILED: "The Dev Flow backend could not be initialized.",
-	BACKEND_CATALOG_INVALID: "The Dev Flow backend tool catalog is invalid.",
-	UPSTREAM_CALL_FAILED: "The Dev Flow backend call did not return a valid result.",
-	UPSTREAM_RESULT_INVALID: "The Dev Flow backend returned an invalid result.",
-	REQUEST_CANCELLED: "The Dev Flow backend call was cancelled before a valid result was received."
-});
-function isPlainObject(value) {
-	if (value === null || typeof value !== "object" || Array.isArray(value)) return false;
-	const prototype = Object.getPrototypeOf(value);
-	return prototype === Object.prototype || prototype === null;
-}
-function hasExactKeys(value, expected) {
-	const actual = Object.keys(value).sort();
-	const sortedExpected = [...expected].sort();
-	return actual.length === sortedExpected.length && actual.every((key, index) => key === sortedExpected[index]);
-}
-function invalid(reason) {
-	throw new TypeError(`Invalid Dev Flow result envelope: ${reason}.`);
-}
-function validateDevFlowEnvelope(value, invokedTool) {
-	if (!APPROVED_RAW_TOOLS.includes(invokedTool)) invalid("invoked tool is not approved");
-	if (!isPlainObject(value)) invalid("structuredContent is not a plain object");
-	if (!hasExactKeys(value, [
-		"schema",
-		"ok",
-		"tool",
-		"request_id",
-		"result",
-		"error"
-	])) invalid("top-level fields do not match the closed envelope");
-	if (value.schema !== "dev-flow-mcp-result/1.0.0") invalid("schema identity does not match");
-	if (value.tool !== invokedTool) invalid("tool identity does not match the invoked tool");
-	if (typeof value.request_id !== "string" || !REQUEST_ID_PATTERN.test(value.request_id)) invalid("request_id does not match the pinned grammar");
-	if (typeof value.ok !== "boolean") invalid("ok is not boolean");
-	if (value.ok) {
-		if (value.error !== null) invalid("successful envelope error is not null");
-	} else {
-		if (value.result !== null) invalid("error envelope result is not null");
-		if (!isPlainObject(value.error)) invalid("error is not a plain object");
-		if (!hasExactKeys(value.error, [
-			"code",
-			"message",
-			"details",
-			"recovery"
-		])) invalid("error fields do not match the closed union");
-		if (typeof value.error.code !== "string" || value.error.code.length === 0) invalid("error code is not a non-empty string");
-		if (typeof value.error.message !== "string" || value.error.message.length === 0) invalid("error message is not a non-empty string");
-		if (!isPlainObject(value.error.details)) invalid("error details is not a plain object");
-		if (value.error.recovery !== null && !isPlainObject(value.error.recovery)) invalid("error recovery is neither a plain object nor null");
-	}
-	canonicalJson(value);
-	return value;
-}
-function projectBackendResult(invokedTool, upstream) {
-	const envelope = validateDevFlowEnvelope(upstream.structuredContent, invokedTool);
-	return {
-		...upstream,
-		content: [{
-			type: "text",
-			text: canonicalJson(envelope)
-		}]
-	};
-}
-function recoveryFor(tool) {
-	if (tool === "dev_flow_start_task") return Object.freeze(["dev_flow_find_tasks_for_path"]);
-	if (tool === "dev_flow_apply_action") return Object.freeze(["dev_flow_get_task", "dev_flow_get_next_action"]);
-	return Object.freeze([tool]);
-}
-function createAdapterErrorEnvelope(tool, code) {
-	if (!APPROVED_RAW_TOOLS.includes(tool)) throw new TypeError("Adapter error tool is not approved.");
-	if (!ADAPTER_ERROR_CODES.includes(code)) throw new TypeError("Adapter error code is not approved.");
-	const message = ADAPTER_MESSAGES[code];
-	if (Buffer.byteLength(message, "utf8") > 4096) throw new TypeError("Adapter diagnostic exceeds its fixed byte limit.");
-	return Object.freeze({
-		schema: ADAPTER_ERROR_SCHEMA,
-		ok: false,
-		tool,
-		error: Object.freeze({
-			code,
-			message,
-			mutation_uncertain: tool === "dev_flow_start_task" || tool === "dev_flow_apply_action",
-			recovery: recoveryFor(tool)
-		})
-	});
-}
-function createAdapterErrorResult(tool, code) {
-	const envelope = createAdapterErrorEnvelope(tool, code);
-	return {
-		content: [{
-			type: "text",
-			text: canonicalJson(envelope)
-		}],
-		isError: true
-	};
-}
-
-//#endregion
-export { createAdapterErrorEnvelope, createAdapterErrorResult, projectBackendResult, validateDevFlowEnvelope };

package/skills/dev-flow/references/activation-and-routing.md

@@ -1,89 +0,0 @@
-# Activation and routing
-
-These rules refine explicit `/dev-flow` task selection and recovery. They do
-not define Controller actions, payload schemas, transitions, or terminal
-criteria.
-
-## Complete-result rule
-
-Treat tool text as authority only when it is the complete canonical JSON
-result. If any result mentions `spill`, `truncated`, `pruned`, `preview`, or
-`Full formatted result stored at`, use a normal DSH file-reading tool to read
-the complete saved text before parsing it. If the complete text cannot be
-read, stop. Never infer an action, binding, payload schema, repository set,
-recovery operation, or terminal result from a preview.
-
-## Select or start
-
-1. Call `mcp__dev-flow__dev_flow_find_tasks_for_path` with the exact current
-   canonical Git root. Inventory must be authoritative; stop if it is
-   unavailable or inconsistent.
-2. Discovery does not prove complete repository membership. For every
-   candidate that might be selected, call
-   `mcp__dev-flow__dev_flow_get_next_action` and use its fresh authority.
-3. Canonicalize every returned `repository_set.repositories[].path`. A
-   candidate is compatible only when its workflow is exactly `lite`, its
-   repository array has cardinality one, and that one canonical path equals
-   the current root. Reject subsets, supersets, different members,
-   multi-repository tasks, unrelated paths, and non-`lite` workflows.
-4. Resume one compatible active task when the result is unambiguous. If more
-   than one is compatible, present their bounded identities and ask the user
-   to choose; never select by recency. If discovery returns only incompatible
-   tasks, report the conflict and ask the user to resolve it outside this MVP.
-5. When authoritative discovery returns no candidate and the request is
-   substantive, call `mcp__dev-flow__dev_flow_start_task` with only the user
-   requirement, workflow `lite`, and a one-element repositories array holding
-   the current root. Omit custom task ID and contract fields.
-
-Never merge candidates, convert workflows, cancel tasks, revise contracts, or
-use an unexposed inventory or governance operation.
-
-## Drive current authority
-
-For each nonterminal result:
-
-1. Reconfirm exact one-root repository equality.
-2. Read the fresh action ID, objective, guidance, allowed effects, required
-   evidence, closed payload schema, and complete binding.
-3. Perform only that action in the current repository with normal DSH tools.
-4. Build a payload containing exactly the schema-declared fields.
-5. Call `mcp__dev-flow__dev_flow_apply_action` with the exact task ID, action
-   ID, payload, and unmodified current binding.
-6. Continue only from the fresh action returned by a successful mutation or a
-   new `mcp__dev-flow__dev_flow_get_next_action` read. Never reuse an old
-   binding.
-
-When the Controller returns a terminal result, report its Delivery Dossier.
-Do not announce completion before that authority exists.
-
-## Errors and mutation uncertainty
-
-A valid `dev-flow-mcp-result/1.0.0` envelope with `ok: false` remains a
-Controller domain error. Follow its recovery only when the named operation is
-one of the six exposed tools. If it requires a hidden governance,
-cancellation, finding, listing, or contract operation, report that the task is
-outside this MVP and stop.
-
-An adapter envelope with schema `dsh-dev-flow-proxy-error/1.0.0` is not a
-Controller result. For a failed read, wait until the six-tool surface is
-healthy and repeat that read at most once. Never reinterpret an adapter error
-as task state.
-
-If `mcp__dev-flow__dev_flow_start_task` loses or corrupts its response, assume
-neither success nor failure. Rediscover tasks for the current root and inspect
-fresh compatible authority before considering another start. Do not create a
-replacement for a task that may already exist.
-
-If `mcp__dev-flow__dev_flow_apply_action` loses or corrupts its response,
-assume neither success nor failure. First call
-`mcp__dev-flow__dev_flow_get_task`, then
-`mcp__dev-flow__dev_flow_get_next_action`, and compare the fresh revision,
-action, and binding. Retry only when that authority proves the mutation did not
-commit and the current binding still authorizes it. Never blindly replay a
-mutation.
-
-## Repository and product boundary
-
-Keep the repository set fixed at the one current user-prepared worktree. Do not
-manage Git topology or publishing. Do not install a runtime, add a UI, expose
-another MCP tool, use remote transport, or store adapter-owned task state.