@enfyra/mcp-server 0.2.51 → 0.2.53

package/dist/lib/workspace-state.d.ts

@@ -0,0 +1,35 @@
+import { z } from 'zod';
+import type { WorkspaceArtifact, WorkspaceArtifactRef, WorkspaceDependencies, WorkspaceManifest, WorkspaceObservation, WorkspacePaths, WorkspaceRemoteSource, WorkspaceSourceStatus } from './workspace-types.js';
+export declare const WORKSPACE_TABLES: readonly ["enfyra_route_handler", "enfyra_pre_hook", "enfyra_post_hook", "enfyra_flow_step", "enfyra_websocket_event", "enfyra_websocket", "enfyra_oauth_config", "enfyra_bootstrap_script", "enfyra_extension"];
+export declare const workspaceArtifactSchema: z.ZodObject<{
+    tableName: z.ZodEnum<["enfyra_route_handler", "enfyra_pre_hook", "enfyra_post_hook", "enfyra_flow_step", "enfyra_websocket_event", "enfyra_websocket", "enfyra_oauth_config", "enfyra_bootstrap_script", "enfyra_extension"]>;
+    id: z.ZodString;
+    path: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    path?: string;
+    tableName?: "enfyra_extension" | "enfyra_route_handler" | "enfyra_pre_hook" | "enfyra_post_hook" | "enfyra_flow_step" | "enfyra_websocket_event" | "enfyra_websocket" | "enfyra_oauth_config" | "enfyra_bootstrap_script";
+    id?: string;
+}, {
+    path?: string;
+    tableName?: "enfyra_extension" | "enfyra_route_handler" | "enfyra_pre_hook" | "enfyra_post_hook" | "enfyra_flow_step" | "enfyra_websocket_event" | "enfyra_websocket" | "enfyra_oauth_config" | "enfyra_bootstrap_script";
+    id?: string;
+}>;
+export declare function sourceRevision(remote: WorkspaceRemoteSource): string;
+export declare function artifactKey(ref: WorkspaceArtifactRef): string;
+export declare function artifactPath(ref: WorkspaceArtifactRef, source: WorkspaceRemoteSource): string;
+export declare function loadWorkspace(paths: WorkspacePaths): WorkspaceManifest;
+export declare function saveWorkspace(paths: WorkspacePaths, manifest: WorkspaceManifest): void;
+export declare function selectArtifacts(manifest: WorkspaceManifest, keys?: string[]): WorkspaceArtifact[];
+export declare function observeArtifact(paths: WorkspacePaths, artifact: WorkspaceArtifact, dependencies: WorkspaceDependencies): Promise<WorkspaceObservation>;
+export declare function observationSummary(observation: WorkspaceObservation): {
+    key: string;
+    status: WorkspaceSourceStatus;
+    language: string;
+    sourceField: string;
+    localFile: string;
+    remoteFile: string;
+    localHash: string;
+    remoteHash: string;
+    baselineHash: string;
+};
+export declare function updateFromRemote(paths: WorkspacePaths, observation: WorkspaceObservation): void;

package/dist/lib/workspace-state.js

@@ -0,0 +1,89 @@
+import { relative } from 'node:path';
+import { z } from 'zod';
+import { readWorkspaceFile, safeWorkspacePath, sourceHash, writeWorkspaceFile } from './workspace-files.js';
+import { writeSourceArtifact } from './source-artifacts.js';
+export const WORKSPACE_TABLES = ['enfyra_route_handler', 'enfyra_pre_hook', 'enfyra_post_hook', 'enfyra_flow_step', 'enfyra_websocket_event', 'enfyra_websocket', 'enfyra_oauth_config', 'enfyra_bootstrap_script', 'enfyra_extension'];
+export const workspaceArtifactSchema = z.object({ tableName: z.enum(WORKSPACE_TABLES), id: z.string().min(1).max(200), path: z.string().optional() }).strict();
+const savedArtifactSchema = workspaceArtifactSchema.extend({ key: z.string(), path: z.string(), sourceField: z.string(), language: z.string(), baseline: z.string() });
+const manifestSchema = z.object({ target: z.string(), artifacts: z.array(savedArtifactSchema).max(500) }).strict();
+export function sourceRevision(remote) {
+    return sourceHash(JSON.stringify([remote.source, remote.sourceField, remote.language]));
+}
+export function artifactKey(ref) {
+    return `${ref.tableName}:${ref.id}`;
+}
+export function artifactPath(ref, source) {
+    const kind = ref.tableName.replace(/^enfyra_/, '').replace(/_/g, '-');
+    const id = ref.id.replace(/[^a-zA-Z0-9_-]/g, '-').slice(0, 60);
+    const extension = source.sourceField === 'code' ? 'vue' : source.language === 'typescript' ? 'ts' : 'js';
+    const path = ref.path ?? `${kind}/${id}-${sourceHash(ref.id).slice(0, 8)}.${extension}`;
+    if (path.startsWith('.') || path === 'project.json' || path.split('/').some((part) => part.startsWith('.')))
+        throw new Error('Artifact path cannot use workspace configuration or state directories.');
+    return path;
+}
+export function loadWorkspace(paths) {
+    const raw = readWorkspaceFile(paths.projectRoot, paths.manifestPath);
+    if (!raw)
+        throw new Error('Workspace is not prepared. Call prepare_enfyra_workspace with projectRoot and exact artifact references.');
+    const manifest = manifestSchema.parse(JSON.parse(raw));
+    if (manifest.target !== paths.target)
+        throw new Error('Workspace target differs from the connected Enfyra instance. Use a separate project workspace.');
+    const keys = new Set();
+    const files = new Set();
+    for (const artifact of manifest.artifacts) {
+        if (artifact.key !== artifactKey(artifact) || keys.has(artifact.key) || files.has(artifact.path))
+            throw new Error('Workspace manifest has invalid or duplicate artifact mappings.');
+        artifactPath(artifact, { source: '', sourceField: artifact.sourceField, language: artifact.language });
+        safeWorkspacePath(paths.workspaceRoot, artifact.path);
+        keys.add(artifact.key);
+        files.add(artifact.path);
+    }
+    return manifest;
+}
+export function saveWorkspace(paths, manifest) {
+    writeWorkspaceFile(paths.projectRoot, paths.manifestPath, `${JSON.stringify(manifest, null, 2)}\n`);
+}
+export function selectArtifacts(manifest, keys) {
+    if (!keys)
+        return manifest.artifacts;
+    if (!keys.length || new Set(keys).size !== keys.length)
+        throw new Error('Select a non-empty list of unique artifact keys.');
+    return keys.map((key) => {
+        const artifact = manifest.artifacts.find((item) => item.key === key);
+        if (!artifact)
+            throw new Error(`Artifact is not in this workspace: ${key}`);
+        return artifact;
+    });
+}
+export async function observeArtifact(paths, artifact, dependencies) {
+    const localFile = safeWorkspacePath(paths.workspaceRoot, artifact.path);
+    const localSource = readWorkspaceFile(paths.workspaceRoot, artifact.path);
+    const remote = await dependencies.read(artifact);
+    const remoteRevision = remote ? sourceRevision(remote) : null;
+    const localRevision = localSource === null ? null : sourceRevision({ source: localSource, sourceField: artifact.sourceField, language: artifact.language });
+    let status;
+    if (!remote)
+        status = 'remote_missing';
+    else if (localSource === null)
+        status = 'local_missing';
+    else if (localRevision === remoteRevision)
+        status = remoteRevision === artifact.baseline ? 'synced' : 'aligned';
+    else if (localRevision === artifact.baseline)
+        status = 'remote_changed';
+    else if (remoteRevision === artifact.baseline)
+        status = 'local_changed';
+    else
+        status = 'conflict';
+    const remoteFile = remote ? writeSourceArtifact({ tableName: artifact.tableName, id: artifact.id, fieldName: remote.sourceField, source: remote.source }).tmpFile : null;
+    return { artifact, localSource, remote, localRevision, remoteRevision, status, localFile, remoteFile };
+}
+export function observationSummary(observation) {
+    return { key: observation.artifact.key, status: observation.status, language: observation.artifact.language, sourceField: observation.artifact.sourceField, localFile: observation.localFile, remoteFile: observation.remoteFile, localHash: observation.localRevision, remoteHash: observation.remoteRevision, baselineHash: observation.artifact.baseline };
+}
+export function updateFromRemote(paths, observation) {
+    if (!observation.remote)
+        throw new Error('Cannot pull a deleted remote artifact.');
+    writeWorkspaceFile(paths.projectRoot, relative(paths.projectRoot, observation.localFile), observation.remote.source, observation.localSource);
+    Object.assign(observation.artifact, { baseline: observation.remoteRevision, language: observation.remote.language, sourceField: observation.remote.sourceField });
+}
+//# sourceMappingURL=workspace-state.js.map

package/dist/lib/workspace-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-state.js","sourceRoot":"","sources":["../../src/lib/workspace-state.ts"],"names":[],"mappings":"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"}

package/dist/lib/workspace-tools.d.ts

@@ -0,0 +1,2 @@
+import type { ToolsetRegistrationState } from './types.js';
+export declare function registerWorkspaceTools(server: any, state: ToolsetRegistrationState, apiUrl: string, projectRoot?: string): import("./workspace-types.js").ScriptWorkspace;

package/dist/lib/workspace-tools.js

@@ -0,0 +1,40 @@
+import { fileURLToPath } from 'node:url';
+import { z } from 'zod';
+import { createScriptWorkspace } from './script-workspace.js';
+import { createWorkspaceRemote } from './workspace-remote.js';
+import { workspaceArtifactSchema } from './workspace-state.js';
+import { jsonContent } from './response-format.js';
+export function registerWorkspaceTools(server, state, apiUrl, projectRoot) {
+    const workspace = createScriptWorkspace({
+        apiUrl,
+        projectRoot,
+        roots: async () => {
+            if (!server.server.getClientCapabilities()?.roots)
+                return [];
+            const result = await server.server.listRoots();
+            return result.roots.map((root) => fileURLToPath(root.uri));
+        },
+        ...createWorkspaceRemote(apiUrl, state),
+    });
+    const scope = {
+        projectRoot: z.string().optional().describe('Absolute client project directory. Defaults to the selected workspace, configured ENFYRA_MCP_PROJECT_ROOT or one client-provided root; never guesses cwd.'),
+        keys: z.array(z.string()).min(1).max(100).optional().describe('Exact workspace artifact keys. Omit to select the prepared inventory.'),
+    };
+    server.tool('prepare_enfyra_workspace', 'Prepare an ignored project-local enfyra/ source worktree. Adds /enfyra/ and /.tmp/enfyra/ to Git ignore before any source write. Bootstrap with explicit artifact references from discovery; existing workspaces preserve local edits and target binding. Does not create a Git branch or clone the whole instance.', {
+        ...scope,
+        artifacts: z.array(workspaceArtifactSchema).max(100).optional().describe('Located live records to add. Optional path is relative to enfyra/. Required for a new workspace; use [] before creating new source, or omit to reopen.'),
+    }, async (input) => jsonContent(await workspace.prepare(input), { columnar: false }));
+    server.tool('inspect_enfyra_workspace', 'Inspect local, last-synced and freshly read live source hashes. Returns synced/local_changed/remote_changed/conflict or missing states, local file paths and project-local .tmp snapshots. Does not overwrite working sources.', scope, async (input) => jsonContent(await workspace.inspect(input), { columnar: false }));
+    server.tool('pull_enfyra_sources', 'Refresh missing or unchanged local workspace files from live source. Keeps local edits, conflicts and remotely deleted files intact; never infers server deletion from local deletion. Use inspect_enfyra_workspace to review returned states.', scope, async (input) => jsonContent(await workspace.pull(input), { columnar: false }));
+    server.tool('push_enfyra_sources', 'Preview and validate edited workspace sources, then apply the reviewed planId. Requires target confirmation and domain knowledge. Rechecks local/live hashes, uses canonical source writers and verifies each saved source. The plan is consumed before writes; partial failure requires fresh inspection and preview. External writers are not atomically locked.', {
+        ...scope,
+        apply: z.boolean().optional().default(false),
+        planId: z.string().uuid().optional().describe('Required with apply=true; use the current reviewed preview plan and omit keys.'),
+    }, async (input) => {
+        const result = await workspace.push(input);
+        const content = jsonContent(result, { columnar: false });
+        return input.apply && !result.complete ? { ...content, isError: true } : content;
+    });
+    return workspace;
+}
+//# sourceMappingURL=workspace-tools.js.map

package/dist/lib/workspace-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-tools.js","sourceRoot":"","sources":["../../src/lib/workspace-tools.ts"],"names":[],"mappings":"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"}

package/dist/lib/workspace-types.d.ts

@@ -0,0 +1,83 @@
+export interface WorkspaceArtifactRef {
+    tableName: string;
+    id: string;
+    path?: string;
+}
+export interface WorkspaceRemoteSource {
+    source: string;
+    sourceField: string;
+    language: string;
+}
+export interface WorkspaceArtifact extends WorkspaceArtifactRef {
+    key: string;
+    path: string;
+    sourceField: string;
+    language: string;
+    baseline: string;
+}
+export interface WorkspaceManifest {
+    target: string;
+    artifacts: WorkspaceArtifact[];
+}
+export interface WorkspaceRequest {
+    projectRoot?: string;
+    keys?: string[];
+}
+export interface WorkspacePrepareInput extends WorkspaceRequest {
+    artifacts?: WorkspaceArtifactRef[];
+}
+export interface WorkspacePushInput extends WorkspaceRequest {
+    apply?: boolean;
+    planId?: string;
+}
+export interface WorkspaceDependencies {
+    apiUrl: string;
+    projectRoot?: string;
+    roots?: () => Promise<string[]>;
+    read: (artifact: WorkspaceArtifactRef) => Promise<WorkspaceRemoteSource | null>;
+    validate: (artifact: WorkspaceArtifact, source: string) => Promise<unknown>;
+    write: (artifact: WorkspaceArtifact, source: string, expectedSourceHash: string, sourceFile: string) => Promise<unknown>;
+}
+export interface WorkspacePaths {
+    projectRoot: string;
+    workspaceRoot: string;
+    tempRoot: string;
+    target: string;
+    manifestPath: string;
+    planPath: string;
+}
+export type WorkspaceSourceStatus = 'synced' | 'aligned' | 'local_changed' | 'remote_changed' | 'conflict' | 'local_missing' | 'remote_missing';
+export interface WorkspaceObservation {
+    artifact: WorkspaceArtifact;
+    localSource: string | null;
+    remote: WorkspaceRemoteSource | null;
+    localRevision: string | null;
+    remoteRevision: string | null;
+    status: WorkspaceSourceStatus;
+    localFile: string;
+    remoteFile: string | null;
+}
+export interface WorkspacePushPlan {
+    id: string;
+    target: string;
+    projectRoot: string;
+    consumed: boolean;
+    items: Array<{
+        key: string;
+        localRevision: string;
+        remoteRevision: string;
+        sourceHash: string;
+    }>;
+}
+export interface WorkspaceOperationResult {
+    action: string;
+    complete?: boolean;
+    [key: string]: unknown;
+}
+export interface ScriptWorkspace {
+    prepare(input: WorkspacePrepareInput): Promise<WorkspaceOperationResult>;
+    inspect(input: WorkspaceRequest): Promise<WorkspaceOperationResult>;
+    pull(input: WorkspaceRequest): Promise<WorkspaceOperationResult>;
+    push(input: WorkspacePushInput): Promise<WorkspaceOperationResult>;
+    artifactDirectory(): string | null;
+}

package/dist/lib/workspace-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=workspace-types.js.map

package/dist/lib/workspace-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-types.js","sourceRoot":"","sources":["../../src/lib/workspace-types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@enfyra/mcp-server",
-  "version": "0.2.51",
+  "version": "0.2.53",
   "description": "MCP server for Enfyra - manage Enfyra instances from MCP-compatible coding tools",
   "type": "module",
   "packageManager": "yarn@4.17.0",