@enfyra/mcp-server 0.2.51 → 0.2.52

package/dist/lib/workspace-files.js

@@ -0,0 +1,160 @@
+import { execFileSync } from 'node:child_process';
+import { createHash, randomUUID } from 'node:crypto';
+import { constants, lstatSync, mkdirSync, openSync, closeSync, readFileSync, realpathSync, renameSync, rmSync, writeFileSync } from 'node:fs';
+import { dirname, isAbsolute, join, relative, resolve, sep } from 'node:path';
+export function sourceHash(source) {
+    return createHash('sha256').update(source, 'utf8').digest('hex');
+}
+export function workspaceTarget(value) {
+    const url = new URL(value);
+    if (!['http:', 'https:'].includes(url.protocol) || url.username || url.password || url.search || url.hash)
+        throw new Error('Workspace target must be an HTTP API URL without credentials, query or fragment.');
+    return url.href.replace(/\/$/, '');
+}
+export function safeWorkspacePath(root, name) {
+    try {
+        if (lstatSync(root).isSymbolicLink())
+            throw new Error(`Workspace symlink is not allowed: ${root}`);
+    }
+    catch (error) {
+        if (error.code !== 'ENOENT')
+            throw error;
+    }
+    if (!name || isAbsolute(name) || name.includes('\\') || name.split('/').some((part) => part === '..' || part === '.' || !part))
+        throw new Error('Workspace path must be a relative path without traversal.');
+    const target = resolve(root, name);
+    if (!target.startsWith(`${root}${sep}`))
+        throw new Error('Workspace path is outside the project.');
+    let current = root;
+    for (const part of relative(root, target).split(sep)) {
+        current = join(current, part);
+        try {
+            const stat = lstatSync(current);
+            if (stat.isSymbolicLink())
+                throw new Error(`Workspace symlink is not allowed: ${current}`);
+            if (current !== target && !stat.isDirectory())
+                throw new Error(`Workspace parent is not a directory: ${current}`);
+        }
+        catch (error) {
+            if (error.code !== 'ENOENT')
+                throw error;
+        }
+    }
+    return target;
+}
+export function readWorkspaceFile(root, name) {
+    const file = safeWorkspacePath(root, name);
+    let fd;
+    try {
+        fd = openSync(file, constants.O_RDONLY | constants.O_NOFOLLOW);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return null;
+        throw error;
+    }
+    try {
+        return readFileSync(fd, 'utf8');
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+export function writeWorkspaceFile(root, name, content, expected) {
+    const file = safeWorkspacePath(root, name);
+    mkdirSync(dirname(file), { recursive: true, mode: 0o700 });
+    safeWorkspacePath(root, name);
+    if (expected !== undefined && readWorkspaceFile(root, name) !== expected)
+        throw new Error(`Local file changed while synchronizing: ${name}`);
+    const temporary = `${file}.${randomUUID()}.tmp`;
+    let mode = 0o600;
+    try {
+        mode = lstatSync(file).mode & 0o777;
+    }
+    catch (error) {
+        if (error.code !== 'ENOENT')
+            throw error;
+    }
+    const fd = openSync(temporary, 'wx', mode);
+    try {
+        writeFileSync(fd, content);
+    }
+    finally {
+        closeSync(fd);
+    }
+    try {
+        safeWorkspacePath(root, name);
+        if (expected !== undefined && readWorkspaceFile(root, name) !== expected)
+            throw new Error(`Local file changed while synchronizing: ${name}`);
+        renameSync(temporary, file);
+    }
+    finally {
+        rmSync(temporary, { force: true });
+    }
+    return file;
+}
+export function workspacePaths(projectRoot, target) {
+    if (!isAbsolute(projectRoot))
+        throw new Error('projectRoot must be an absolute project directory.');
+    const root = realpathSync(projectRoot);
+    if (!lstatSync(root).isDirectory())
+        throw new Error('projectRoot must be a directory.');
+    return {
+        projectRoot: root,
+        workspaceRoot: safeWorkspacePath(root, 'enfyra'),
+        tempRoot: safeWorkspacePath(root, `.tmp/enfyra/${sourceHash(target).slice(0, 16)}/${process.pid}`),
+        target,
+        manifestPath: 'enfyra/.state/sync.json',
+        planPath: 'enfyra/.state/push-plan.json',
+    };
+}
+export function ensureWorkspaceIgnored(paths) {
+    const root = paths.projectRoot;
+    const patterns = ['/enfyra/', '/.tmp/enfyra/'];
+    let isRepository = false;
+    try {
+        execFileSync('git', ['-C', root, 'rev-parse', '--show-toplevel'], { stdio: 'pipe' });
+        isRepository = true;
+    }
+    catch (error) {
+        if (!error.stderr?.toString().includes('not a git repository'))
+            throw error;
+    }
+    if (isRepository) {
+        const tracked = execFileSync('git', ['-C', root, 'ls-files', '--', 'enfyra', '.tmp/enfyra'], { encoding: 'utf8' });
+        if (tracked.trim())
+            throw new Error('Workspace paths are already tracked by Git. Untrack them explicitly before preparing the workspace.');
+    }
+    const original = readWorkspaceFile(root, '.gitignore');
+    const lines = (original ?? '').split(/\r?\n/);
+    const missing = patterns.filter((pattern) => !lines.includes(pattern));
+    if (missing.length)
+        writeWorkspaceFile(root, '.gitignore', `${original ?? ''}${original && !original.endsWith('\n') ? '\n' : ''}${missing.join('\n')}\n`, original);
+    if (isRepository) {
+        for (const path of ['enfyra/project.json', '.tmp/enfyra/source.js'])
+            execFileSync('git', ['-C', root, 'check-ignore', '-q', '--', path], { stdio: 'pipe' });
+    }
+    return isRepository;
+}
+export async function withWorkspaceLock(paths, run) {
+    const lock = safeWorkspacePath(paths.projectRoot, 'enfyra/.state/workspace.lock');
+    mkdirSync(dirname(lock), { recursive: true, mode: 0o700 });
+    let fd;
+    try {
+        fd = openSync(lock, 'wx', 0o600);
+    }
+    catch (error) {
+        if (error.code === 'EEXIST')
+            throw new Error('Workspace is locked by another operation. Retry when it finishes; inspect an abandoned lock before removing it.');
+        throw error;
+    }
+    writeFileSync(fd, JSON.stringify({ pid: process.pid }));
+    try {
+        return await run();
+    }
+    finally {
+        closeSync(fd);
+        rmSync(lock, { force: true });
+    }
+}
+//# sourceMappingURL=workspace-files.js.map

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

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

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

@@ -0,0 +1,44 @@
+import type { WorkspaceDependencies, WorkspaceManifest, WorkspacePaths, WorkspacePushInput } from './workspace-types.js';
+export declare function pushWorkspace(paths: WorkspacePaths, manifest: WorkspaceManifest, dependencies: WorkspaceDependencies, input: WorkspacePushInput): Promise<{
+    action: string;
+    complete: boolean;
+    artifacts: {
+        key: string;
+        status: import("./workspace-types.js").WorkspaceSourceStatus;
+        language: string;
+        sourceField: string;
+        localFile: string;
+        remoteFile: string;
+        localHash: string;
+        remoteHash: string;
+        baselineHash: string;
+    }[];
+    guidance: string;
+    planId?: undefined;
+    protection?: undefined;
+    remainingKeys?: undefined;
+} | {
+    action: string;
+    complete: boolean;
+    planId: string;
+    artifacts: any[];
+    protection: string;
+    guidance: string;
+    remainingKeys?: undefined;
+} | {
+    action: string;
+    complete: boolean;
+    artifacts: Record<string, unknown>[];
+    remainingKeys: string[];
+    guidance: string;
+    planId?: undefined;
+    protection?: undefined;
+} | {
+    action: string;
+    complete: boolean;
+    artifacts: Record<string, unknown>[];
+    guidance?: undefined;
+    planId?: undefined;
+    protection?: undefined;
+    remainingKeys?: undefined;
+}>;

package/dist/lib/workspace-push.js

@@ -0,0 +1,79 @@
+import { randomUUID } from 'node:crypto';
+import { z } from 'zod';
+import { writeSourceArtifact } from './source-artifacts.js';
+import { sourceHash, readWorkspaceFile, writeWorkspaceFile } from './workspace-files.js';
+import { observeArtifact, observationSummary, saveWorkspace, selectArtifacts } from './workspace-state.js';
+const planSchema = z.object({ id: z.string().uuid(), target: z.string(), projectRoot: z.string(), consumed: z.boolean(), items: z.array(z.object({ key: z.string(), localRevision: z.string(), remoteRevision: z.string(), sourceHash: z.string() }).strict()).max(500) }).strict();
+function savePlan(paths, plan) {
+    writeWorkspaceFile(paths.projectRoot, paths.planPath, `${JSON.stringify(plan, null, 2)}\n`);
+}
+function diffArtifact(observation) {
+    const remote = (observation.remote?.source ?? '').split('\n');
+    const local = (observation.localSource ?? '').split('\n');
+    const diff = [`--- live/${observation.artifact.path}`, `+++ local/${observation.artifact.path}`, `@@ -1,${remote.length} +1,${local.length} @@`, ...remote.map((line) => `-${line}`), ...local.map((line) => `+${line}`)].join('\n');
+    return writeSourceArtifact({ tableName: observation.artifact.tableName, id: observation.artifact.id, fieldName: 'diff', source: diff });
+}
+export async function pushWorkspace(paths, manifest, dependencies, input) {
+    if (!input.apply) {
+        if (input.planId)
+            throw new Error('planId is only accepted when apply=true.');
+        const observations = [];
+        for (const artifact of selectArtifacts(manifest, input.keys))
+            observations.push(await observeArtifact(paths, artifact, dependencies));
+        const blocked = observations.filter((item) => !['synced', 'local_changed'].includes(item.status));
+        if (blocked.length)
+            return { action: 'enfyra_workspace_push_blocked', complete: false, artifacts: observations.map(observationSummary), guidance: 'Pull remote-only or aligned changes first; resolve conflicts without overwriting local edits.' };
+        const changes = observations.filter((item) => item.status === 'local_changed');
+        const artifacts = [];
+        for (const change of changes) {
+            const sourceArtifact = writeSourceArtifact({ tableName: change.artifact.tableName, id: change.artifact.id, fieldName: change.artifact.sourceField, source: change.localSource });
+            await dependencies.validate(change.artifact, change.localSource);
+            artifacts.push({ ...observationSummary(change), sourceFile: sourceArtifact.tmpFile, diff: diffArtifact(change) });
+        }
+        const plan = { id: randomUUID(), target: paths.target, projectRoot: paths.projectRoot, consumed: false, items: changes.map((item) => ({ key: item.artifact.key, localRevision: item.localRevision, remoteRevision: item.remoteRevision, sourceHash: sourceHash(item.localSource) })) };
+        savePlan(paths, plan);
+        return { action: 'enfyra_workspace_push_previewed', complete: changes.length === 0, planId: plan.id, artifacts, protection: 'optimistic-source-check', guidance: 'Review the diffs, then call push_enfyra_sources with apply=true and this planId. External writers are not locked; each write rechecks and verifies the live source.' };
+    }
+    if (!input.planId)
+        throw new Error('A reviewed planId is required when apply=true.');
+    if (input.keys)
+        throw new Error('Apply uses the reviewed plan scope; omit keys.');
+    const raw = readWorkspaceFile(paths.projectRoot, paths.planPath);
+    const plan = raw ? planSchema.parse(JSON.parse(raw)) : null;
+    if (!plan || plan.id !== input.planId || plan.consumed || plan.target !== paths.target || plan.projectRoot !== paths.projectRoot)
+        throw new Error('Push plan is missing, consumed, stale or belongs to another target. Preview again.');
+    const changes = [];
+    for (const item of plan.items) {
+        const artifact = selectArtifacts(manifest, [item.key])[0];
+        const observation = await observeArtifact(paths, artifact, dependencies);
+        if (observation.status !== 'local_changed' || observation.localRevision !== item.localRevision || observation.remoteRevision !== item.remoteRevision || sourceHash(observation.localSource) !== item.sourceHash)
+            throw new Error(`Source changed after preview: ${item.key}. Inspect and preview again.`);
+        await dependencies.validate(artifact, observation.localSource);
+        changes.push(observation);
+    }
+    plan.consumed = true;
+    savePlan(paths, plan);
+    const results = [];
+    for (const change of changes) {
+        try {
+            const current = await observeArtifact(paths, change.artifact, dependencies);
+            if (current.localRevision !== change.localRevision || current.remoteRevision !== change.remoteRevision)
+                throw new Error('Source changed before write; preview again.');
+            const source = current.localSource;
+            const staged = writeSourceArtifact({ tableName: current.artifact.tableName, id: current.artifact.id, fieldName: current.artifact.sourceField, source });
+            await dependencies.write(current.artifact, source, sourceHash(current.remote.source), staged.tmpFile);
+            const saved = await observeArtifact(paths, current.artifact, dependencies);
+            if (saved.remoteRevision !== current.localRevision)
+                throw new Error('Saved source does not match the reviewed source. Inspect live state before retrying.');
+            current.artifact.baseline = saved.remoteRevision;
+            saveWorkspace(paths, manifest);
+            results.push({ key: current.artifact.key, status: 'pushed', sourceSha256: sourceHash(source), verified: true, localChangedDuringPush: saved.localRevision !== current.localRevision });
+        }
+        catch (error) {
+            results.push({ key: change.artifact.key, status: 'failed', error: error instanceof Error ? error.message : String(error) });
+            return { action: 'enfyra_workspace_push_incomplete', complete: false, artifacts: results, remainingKeys: changes.slice(results.length).map((item) => item.artifact.key), guidance: 'Some writes may have completed. Inspect live state and create a fresh preview before retrying.' };
+        }
+    }
+    return { action: 'enfyra_workspace_pushed', complete: true, artifacts: results };
+}
+//# sourceMappingURL=workspace-push.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-push.js","sourceRoot":"","sources":["../../src/lib/workspace-push.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACzF,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG3G,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAEpR,SAAS,QAAQ,CAAC,KAAqB,EAAE,IAAuB;IAC9D,kBAAkB,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AAC9F,CAAC;AAED,SAAS,YAAY,CAAC,WAAiC;IACrD,MAAM,MAAM,GAAG,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9D,MAAM,KAAK,GAAG,CAAC,WAAW,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1D,MAAM,IAAI,GAAG,CAAC,YAAY,WAAW,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,aAAa,WAAW,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,SAAS,MAAM,CAAC,MAAM,OAAO,KAAK,CAAC,MAAM,KAAK,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrO,OAAO,mBAAmB,CAAC,EAAE,SAAS,EAAE,WAAW,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,EAAE,WAAW,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AAC1I,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAqB,EAAE,QAA2B,EAAE,YAAmC,EAAE,KAAyB;IACpJ,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACjB,IAAI,KAAK,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC9E,MAAM,YAAY,GAA2B,EAAE,CAAC;QAChD,KAAK,MAAM,QAAQ,IAAI,eAAe,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC;YAAE,YAAY,CAAC,IAAI,CAAC,MAAM,eAAe,CAAC,KAAK,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC;QACtI,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QAClG,IAAI,OAAO,CAAC,MAAM;YAAE,OAAO,EAAE,MAAM,EAAE,+BAA+B,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,YAAY,CAAC,GAAG,CAAC,kBAAkB,CAAC,EAAE,QAAQ,EAAE,+FAA+F,EAAE,CAAC;QACpP,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,eAAe,CAAC,CAAC;QAC/E,MAAM,SAAS,GAAG,EAAE,CAAC;QACrB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,cAAc,GAAG,mBAAmB,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,WAAY,EAAE,CAAC,CAAC;YAClL,MAAM,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,WAAY,CAAC,CAAC;YAClE,SAAS,CAAC,IAAI,CAAC,EAAE,GAAG,kBAAkB,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,cAAc,CAAC,OAAO,EAAE,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACpH,CAAC;QACD,MAAM,IAAI,GAAsB,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,aAAa,EAAE,IAAI,CAAC,aAAc,EAAE,cAAc,EAAE,IAAI,CAAC,cAAe,EAAE,UAAU,EAAE,UAAU,CAAC,IAAI,CAAC,WAAY,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QAC7S,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACtB,OAAO,EAAE,MAAM,EAAE,iCAAiC,EAAE,QAAQ,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,yBAAyB,EAAE,QAAQ,EAAE,qKAAqK,EAAE,CAAC;IAC3U,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACrF,IAAI,KAAK,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IAClF,MAAM,GAAG,GAAG,iBAAiB,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IACjE,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAsB,CAAC,CAAC,CAAC,IAAI,CAAC;IACjF,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,KAAK,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,WAAW,KAAK,KAAK,CAAC,WAAW;QAAE,MAAM,IAAI,KAAK,CAAC,oFAAoF,CAAC,CAAC;IACxO,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,eAAe,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1D,MAAM,WAAW,GAAG,MAAM,eAAe,CAAC,KAAK,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;QACzE,IAAI,WAAW,CAAC,MAAM,KAAK,eAAe,IAAI,WAAW,CAAC,aAAa,KAAK,IAAI,CAAC,aAAa,IAAI,WAAW,CAAC,cAAc,KAAK,IAAI,CAAC,cAAc,IAAI,UAAU,CAAC,WAAW,CAAC,WAAY,CAAC,KAAK,IAAI,CAAC,UAAU;YAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,IAAI,CAAC,GAAG,8BAA8B,CAAC,CAAC;QAC3S,MAAM,YAAY,CAAC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,WAAY,CAAC,CAAC;QAChE,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC5B,CAAC;IACD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACtB,MAAM,OAAO,GAAmC,EAAE,CAAC;IACnD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;YAC5E,IAAI,OAAO,CAAC,aAAa,KAAK,MAAM,CAAC,aAAa,IAAI,OAAO,CAAC,cAAc,KAAK,MAAM,CAAC,cAAc;gBAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;YACvK,MAAM,MAAM,GAAG,OAAO,CAAC,WAAY,CAAC;YACpC,MAAM,MAAM,GAAG,mBAAmB,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;YACxJ,MAAM,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,MAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;YACvG,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;YAC3E,IAAI,KAAK,CAAC,cAAc,KAAK,OAAO,CAAC,aAAa;gBAAE,MAAM,IAAI,KAAK,CAAC,sFAAsF,CAAC,CAAC;YAC5J,OAAO,CAAC,QAAQ,CAAC,QAAQ,GAAG,KAAK,CAAC,cAAe,CAAC;YAClD,aAAa,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;YAC/B,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,sBAAsB,EAAE,KAAK,CAAC,aAAa,KAAK,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;QACzL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC5H,OAAO,EAAE,MAAM,EAAE,kCAAkC,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,gGAAgG,EAAE,CAAC;QACxR,CAAC;IACH,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,yBAAyB,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;AACnF,CAAC"}

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

@@ -0,0 +1,3 @@
+import type { ToolsetRegistrationState } from './types.js';
+import type { WorkspaceDependencies } from './workspace-types.js';
+export declare function createWorkspaceRemote(apiUrl: string, state: ToolsetRegistrationState): Pick<WorkspaceDependencies, 'read' | 'validate' | 'write'>;

package/dist/lib/workspace-remote.js

@@ -0,0 +1,52 @@
+import { fetchAPI } from './fetch.js';
+import { fetchTableMetadata } from './metadata-client.js';
+import { validateDynamicScript, validateExtensionCode } from './platform-extension-source.js';
+import { assertDynamicCodeKnowledgeAck, assertExtensionKnowledgeAck, assertGlobalRulesAck } from './required-knowledge.js';
+import { executeToolDefinition } from './tool-execution.js';
+import { resolveCatalogToolAvailability } from './tool-permission-profile.js';
+import { getPrimaryFieldName } from './tool-record-operations.js';
+export function createWorkspaceRemote(apiUrl, state) {
+    return {
+        read: async (artifact) => {
+            const table = await fetchTableMetadata(apiUrl, artifact.tableName);
+            const columns = (table.columns ?? []);
+            const primaryKey = await getPrimaryFieldName(artifact.tableName, table);
+            const sourceField = artifact.tableName === 'enfyra_extension' ? 'code' : 'sourceCode';
+            if (!columns.some((column) => column.name === sourceField))
+                throw new Error(`${artifact.tableName} does not expose an editable ${sourceField} field.`);
+            const languageField = ['scriptLanguage', 'language'].find((name) => columns.some((column) => column.name === name));
+            const fields = [primaryKey, sourceField, ...(languageField ? [languageField] : [])];
+            const query = new URLSearchParams({ filter: JSON.stringify({ [primaryKey]: { _eq: artifact.id } }), limit: '1', fields: fields.join(',') });
+            const result = await fetchAPI(apiUrl, `/${artifact.tableName}?${query}`);
+            const record = Array.isArray(result?.data) ? result.data[0] : Array.isArray(result) ? result[0] : null;
+            if (!record)
+                return null;
+            if (String(record[primaryKey]) !== artifact.id || typeof record[sourceField] !== 'string')
+                throw new Error('Workspace source response did not match the requested artifact or expose readable source.');
+            return { source: record[sourceField], sourceField, language: languageField ? String(record[languageField] ?? 'javascript') : 'javascript' };
+        },
+        validate: async (artifact, source) => {
+            assertGlobalRulesAck(undefined);
+            if (artifact.tableName === 'enfyra_extension') {
+                assertExtensionKnowledgeAck(undefined);
+                return validateExtensionCode(apiUrl, source, artifact.id);
+            }
+            assertDynamicCodeKnowledgeAck(undefined);
+            return validateDynamicScript(apiUrl, source, artifact.language);
+        },
+        write: async (artifact, _source, expectedHash, sourceFile) => {
+            const name = artifact.tableName === 'enfyra_extension' ? 'update_extension_code' : 'update_script_source';
+            const tool = state.getTool(name);
+            if (!tool)
+                throw new Error(`Workspace writer is not registered: ${name}`);
+            const args = artifact.tableName === 'enfyra_extension'
+                ? { id: artifact.id, sourceFile, expectedSha256: expectedHash }
+                : { tableName: artifact.tableName, id: artifact.id, sourceFile, expectedSourceSha256: expectedHash, scriptLanguage: artifact.language };
+            const result = await executeToolDefinition(tool, args, undefined, resolveCatalogToolAvailability);
+            if (result?.isError)
+                throw new Error(result.content?.find((item) => item.type === 'text')?.text ?? `${name} failed.`);
+            return result;
+        },
+    };
+}
+//# sourceMappingURL=workspace-remote.js.map

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

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

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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"}