@agent-teams/engineering-foundation 0.4.1 → 0.6.0

package/dist/process-execution/windows-managed-process.js

@@ -0,0 +1,389 @@
+import { spawn } from "node:child_process";
+import { fileURLToPath } from "node:url";
+const PROCESS_HOST_PATH = fileURLToPath(new URL("./windows-process-host.js", import.meta.url));
+const MAX_ENCODED_REQUEST_CHARACTERS = 24_000;
+const WINDOWS_JOB_RUNNER = String.raw `
+$ErrorActionPreference = "Stop"
+Add-Type -TypeDefinition @'
+using System;
+using System.ComponentModel;
+using System.Diagnostics;
+using System.Runtime.InteropServices;
+using System.Text;
+using System.Threading;
+
+public static class AgentTeamsFoundationJobRunner
+{
+    private const uint CREATE_SUSPENDED = 0x00000004;
+    private const uint STARTF_USESTDHANDLES = 0x00000100;
+    private const uint JOB_OBJECT_LIMIT_KILL_ON_JOB_CLOSE = 0x00002000;
+    private const int JobObjectBasicAccountingInformation = 1;
+    private const int JobObjectExtendedLimitInformation = 9;
+    private const uint INFINITE = 0xffffffff;
+    private const int STD_INPUT_HANDLE = -10;
+    private const int STD_OUTPUT_HANDLE = -11;
+    private const int STD_ERROR_HANDLE = -12;
+
+    [StructLayout(LayoutKind.Sequential)]
+    private struct PROCESS_INFORMATION
+    {
+        public IntPtr hProcess;
+        public IntPtr hThread;
+        public uint dwProcessId;
+        public uint dwThreadId;
+    }
+
+    [StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
+    private struct STARTUPINFO
+    {
+        public uint cb;
+        public string lpReserved;
+        public string lpDesktop;
+        public string lpTitle;
+        public uint dwX;
+        public uint dwY;
+        public uint dwXSize;
+        public uint dwYSize;
+        public uint dwXCountChars;
+        public uint dwYCountChars;
+        public uint dwFillAttribute;
+        public uint dwFlags;
+        public ushort wShowWindow;
+        public ushort cbReserved2;
+        public IntPtr lpReserved2;
+        public IntPtr hStdInput;
+        public IntPtr hStdOutput;
+        public IntPtr hStdError;
+    }
+
+    [StructLayout(LayoutKind.Sequential)]
+    private struct JOBOBJECT_BASIC_LIMIT_INFORMATION
+    {
+        public long PerProcessUserTimeLimit;
+        public long PerJobUserTimeLimit;
+        public uint LimitFlags;
+        public UIntPtr MinimumWorkingSetSize;
+        public UIntPtr MaximumWorkingSetSize;
+        public uint ActiveProcessLimit;
+        public UIntPtr Affinity;
+        public uint PriorityClass;
+        public uint SchedulingClass;
+    }
+
+    [StructLayout(LayoutKind.Sequential)]
+    private struct JOBOBJECT_BASIC_ACCOUNTING_INFORMATION
+    {
+        public long TotalUserTime;
+        public long TotalKernelTime;
+        public long ThisPeriodTotalUserTime;
+        public long ThisPeriodTotalKernelTime;
+        public uint TotalPageFaultCount;
+        public uint TotalProcesses;
+        public uint ActiveProcesses;
+        public uint TotalTerminatedProcesses;
+    }
+
+    [StructLayout(LayoutKind.Sequential)]
+    private struct IO_COUNTERS
+    {
+        public ulong ReadOperationCount;
+        public ulong WriteOperationCount;
+        public ulong OtherOperationCount;
+        public ulong ReadTransferCount;
+        public ulong WriteTransferCount;
+        public ulong OtherTransferCount;
+    }
+
+    [StructLayout(LayoutKind.Sequential)]
+    private struct JOBOBJECT_EXTENDED_LIMIT_INFORMATION
+    {
+        public JOBOBJECT_BASIC_LIMIT_INFORMATION BasicLimitInformation;
+        public IO_COUNTERS IoInfo;
+        public UIntPtr ProcessMemoryLimit;
+        public UIntPtr JobMemoryLimit;
+        public UIntPtr PeakProcessMemoryUsed;
+        public UIntPtr PeakJobMemoryUsed;
+    }
+
+    [DllImport("kernel32.dll", CharSet = CharSet.Unicode, SetLastError = true)]
+    private static extern IntPtr CreateJobObject(IntPtr attributes, string name);
+
+    [DllImport("kernel32.dll", SetLastError = true)]
+    private static extern bool SetInformationJobObject(
+        IntPtr job,
+        int informationClass,
+        IntPtr information,
+        uint informationLength);
+
+    [DllImport("kernel32.dll", SetLastError = true)]
+    private static extern bool QueryInformationJobObject(
+        IntPtr job,
+        int informationClass,
+        IntPtr information,
+        uint informationLength,
+        IntPtr returnLength);
+
+    [DllImport("kernel32.dll", SetLastError = true)]
+    private static extern bool TerminateJobObject(IntPtr job, uint exitCode);
+
+    [DllImport("kernel32.dll", SetLastError = true)]
+    private static extern bool AssignProcessToJobObject(IntPtr job, IntPtr process);
+
+    [DllImport("kernel32.dll", CharSet = CharSet.Unicode, SetLastError = true)]
+    private static extern bool CreateProcess(
+        string applicationName,
+        StringBuilder commandLine,
+        IntPtr processAttributes,
+        IntPtr threadAttributes,
+        bool inheritHandles,
+        uint creationFlags,
+        IntPtr environment,
+        string currentDirectory,
+        ref STARTUPINFO startupInfo,
+        out PROCESS_INFORMATION processInformation);
+
+    [DllImport("kernel32.dll", SetLastError = true)]
+    private static extern uint ResumeThread(IntPtr thread);
+
+    [DllImport("kernel32.dll", SetLastError = true)]
+    private static extern uint WaitForSingleObject(IntPtr handle, uint milliseconds);
+
+    [DllImport("kernel32.dll", SetLastError = true)]
+    private static extern bool GetExitCodeProcess(IntPtr process, out uint exitCode);
+
+    [DllImport("kernel32.dll", SetLastError = true)]
+    private static extern bool TerminateProcess(IntPtr process, uint exitCode);
+
+    [DllImport("kernel32.dll")]
+    private static extern IntPtr GetStdHandle(int standardHandle);
+
+    [DllImport("kernel32.dll")]
+    private static extern bool CloseHandle(IntPtr handle);
+
+    private static string Quote(string value)
+    {
+        if (value.Length > 0 && value.IndexOfAny(new[] { ' ', '\t', '"' }) < 0)
+        {
+            return value;
+        }
+        var output = new StringBuilder("\"");
+        var slashes = 0;
+        foreach (var character in value)
+        {
+            if (character == '\\')
+            {
+                slashes += 1;
+                continue;
+            }
+            if (character == '"')
+            {
+                output.Append('\\', slashes * 2 + 1);
+                output.Append(character);
+                slashes = 0;
+                continue;
+            }
+            output.Append('\\', slashes);
+            slashes = 0;
+            output.Append(character);
+        }
+        output.Append('\\', slashes * 2);
+        output.Append('"');
+        return output.ToString();
+    }
+
+    private static uint ActiveProcessCount(IntPtr job)
+    {
+        var accounting = new JOBOBJECT_BASIC_ACCOUNTING_INFORMATION();
+        var length = Marshal.SizeOf(accounting);
+        var pointer = Marshal.AllocHGlobal(length);
+        try
+        {
+            if (!QueryInformationJobObject(
+                job,
+                JobObjectBasicAccountingInformation,
+                pointer,
+                (uint)length,
+                IntPtr.Zero))
+            {
+                throw new Win32Exception(
+                    Marshal.GetLastWin32Error(),
+                    "QueryInformationJobObject failed");
+            }
+            accounting = (JOBOBJECT_BASIC_ACCOUNTING_INFORMATION)
+                Marshal.PtrToStructure(pointer, typeof(JOBOBJECT_BASIC_ACCOUNTING_INFORMATION));
+            return accounting.ActiveProcesses;
+        }
+        finally
+        {
+            Marshal.FreeHGlobal(pointer);
+        }
+    }
+
+    private static void TerminateRemainingProcessesAndWait(IntPtr job)
+    {
+        if (ActiveProcessCount(job) > 0 && !TerminateJobObject(job, 1))
+        {
+            throw new Win32Exception(Marshal.GetLastWin32Error(), "TerminateJobObject failed");
+        }
+        var stopwatch = Stopwatch.StartNew();
+        while (ActiveProcessCount(job) > 0)
+        {
+            if (stopwatch.ElapsedMilliseconds >= 5000)
+            {
+                throw new TimeoutException(
+                    "Windows Job Object descendants did not terminate within 5000 ms");
+            }
+            Thread.Sleep(10);
+        }
+    }
+
+    public static int Run(
+        string executable,
+        string hostPath,
+        string currentDirectory,
+        string encodedRequest)
+    {
+        var job = CreateJobObject(IntPtr.Zero, null);
+        if (job == IntPtr.Zero)
+        {
+            throw new Win32Exception(Marshal.GetLastWin32Error(), "CreateJobObject failed");
+        }
+        PROCESS_INFORMATION process = new PROCESS_INFORMATION();
+        try
+        {
+            var limits = new JOBOBJECT_EXTENDED_LIMIT_INFORMATION();
+            limits.BasicLimitInformation.LimitFlags = JOB_OBJECT_LIMIT_KILL_ON_JOB_CLOSE;
+            var length = Marshal.SizeOf(limits);
+            var limitsPointer = Marshal.AllocHGlobal(length);
+            try
+            {
+                Marshal.StructureToPtr(limits, limitsPointer, false);
+                if (!SetInformationJobObject(
+                    job,
+                    JobObjectExtendedLimitInformation,
+                    limitsPointer,
+                    (uint)length))
+                {
+                    throw new Win32Exception(
+                        Marshal.GetLastWin32Error(),
+                        "SetInformationJobObject failed");
+                }
+            }
+            finally
+            {
+                Marshal.FreeHGlobal(limitsPointer);
+            }
+
+            var startup = new STARTUPINFO();
+            startup.cb = (uint)Marshal.SizeOf(startup);
+            startup.dwFlags = STARTF_USESTDHANDLES;
+            startup.hStdInput = GetStdHandle(STD_INPUT_HANDLE);
+            startup.hStdOutput = GetStdHandle(STD_OUTPUT_HANDLE);
+            startup.hStdError = GetStdHandle(STD_ERROR_HANDLE);
+            var commandLine = new StringBuilder(
+                Quote(executable) + " " + Quote(hostPath) + " " + Quote(encodedRequest));
+            if (!CreateProcess(
+                executable,
+                commandLine,
+                IntPtr.Zero,
+                IntPtr.Zero,
+                true,
+                CREATE_SUSPENDED,
+                IntPtr.Zero,
+                currentDirectory,
+                ref startup,
+                out process))
+            {
+                throw new Win32Exception(Marshal.GetLastWin32Error(), "CreateProcess failed");
+            }
+            if (!AssignProcessToJobObject(job, process.hProcess))
+            {
+                var errorCode = Marshal.GetLastWin32Error();
+                TerminateProcess(process.hProcess, 1);
+                throw new Win32Exception(
+                    errorCode,
+                    "AssignProcessToJobObject failed");
+            }
+            if (ResumeThread(process.hThread) == 0xffffffff)
+            {
+                var errorCode = Marshal.GetLastWin32Error();
+                TerminateProcess(process.hProcess, 1);
+                throw new Win32Exception(errorCode, "ResumeThread failed");
+            }
+            if (WaitForSingleObject(process.hProcess, INFINITE) == 0xffffffff)
+            {
+                var errorCode = Marshal.GetLastWin32Error();
+                TerminateProcess(process.hProcess, 1);
+                throw new Win32Exception(errorCode, "WaitForSingleObject failed");
+            }
+            uint exitCode;
+            if (!GetExitCodeProcess(process.hProcess, out exitCode))
+            {
+                throw new Win32Exception(Marshal.GetLastWin32Error(), "GetExitCodeProcess failed");
+            }
+            TerminateRemainingProcessesAndWait(job);
+            return unchecked((int)exitCode);
+        }
+        finally
+        {
+            if (process.hThread != IntPtr.Zero) CloseHandle(process.hThread);
+            if (process.hProcess != IntPtr.Zero) CloseHandle(process.hProcess);
+            CloseHandle(job);
+        }
+    }
+}
+'@
+
+try {
+  $bootstrapRequest = [Console]::In.ReadToEnd() | ConvertFrom-Json
+  $exitCode = [AgentTeamsFoundationJobRunner]::Run(
+    [string]$bootstrapRequest.nodeExecutable,
+    [string]$bootstrapRequest.processHostPath,
+    (Get-Location).Path,
+    [string]$bootstrapRequest.encodedRequest)
+  exit $exitCode
+} catch {
+  [Console]::Error.WriteLine("Windows Job Object runner failed: " + $_.Exception.Message)
+  exit 1
+}
+`;
+const ENCODED_WINDOWS_JOB_RUNNER = Buffer.from(WINDOWS_JOB_RUNNER, "utf16le").toString("base64");
+/**
+ * Starts a suspended Node host, assigns it to a kill-on-close Windows Job
+ * Object, and only then allows it to launch the requested command. The Job
+ * Object is the containment boundary for every descendant.
+ */
+export function spawnWindowsManagedProcess(request) {
+    const encodedRequest = Buffer.from(JSON.stringify({
+        schemaVersion: 1,
+        command: request.command,
+        args: [...request.args],
+        cwd: request.cwd
+    })).toString("base64url");
+    if (encodedRequest.length > MAX_ENCODED_REQUEST_CHARACTERS) {
+        throw new Error(`The managed Windows process request exceeds ${MAX_ENCODED_REQUEST_CHARACTERS} encoded characters.`);
+    }
+    const child = spawn("powershell.exe", [
+        "-NoLogo",
+        "-NoProfile",
+        "-NonInteractive",
+        "-ExecutionPolicy",
+        "Bypass",
+        "-EncodedCommand",
+        ENCODED_WINDOWS_JOB_RUNNER
+    ], {
+        cwd: request.cwd,
+        stdio: ["pipe", "pipe", "pipe"],
+        windowsHide: true
+    });
+    child.stdin.once("error", () => {
+        // The wrapper's process error is reported through its own error event.
+    });
+    child.stdin.end(JSON.stringify({
+        nodeExecutable: process.execPath,
+        processHostPath: PROCESS_HOST_PATH,
+        encodedRequest
+    }));
+    return child;
+}
+//# sourceMappingURL=windows-managed-process.js.map

package/dist/process-execution/windows-managed-process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"windows-managed-process.js","sourceRoot":"","sources":["../../src/process-execution/windows-managed-process.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAqB,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAQzC,MAAM,iBAAiB,GAAG,aAAa,CACrC,IAAI,GAAG,CAAC,2BAA2B,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CACtD,CAAC;AACF,MAAM,8BAA8B,GAAG,MAAM,CAAC;AAE9C,MAAM,kBAAkB,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwVpC,CAAC;AAEF,MAAM,0BAA0B,GAAG,MAAM,CAAC,IAAI,CAC5C,kBAAkB,EAClB,SAAS,CACV,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAErB;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CACxC,OAAqC;IAErC,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC;QAChD,aAAa,EAAE,CAAC;QAChB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;QACvB,GAAG,EAAE,OAAO,CAAC,GAAG;KACjB,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC1B,IAAI,cAAc,CAAC,MAAM,GAAG,8BAA8B,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CACb,+CAA+C,8BAA8B,sBAAsB,CACpG,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CACjB,gBAAgB,EAChB;QACE,SAAS;QACT,YAAY;QACZ,iBAAiB;QACjB,kBAAkB;QAClB,QAAQ;QACR,iBAAiB;QACjB,0BAA0B;KAC3B,EACD;QACE,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;QAC/B,WAAW,EAAE,IAAI;KAClB,CACF,CAAC;IACF,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;QAC7B,uEAAuE;IACzE,CAAC,CAAC,CAAC;IACH,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC;QAC7B,cAAc,EAAE,OAAO,CAAC,QAAQ;QAChC,eAAe,EAAE,iBAAiB;QAClC,cAAc;KACf,CAAC,CAAC,CAAC;IACJ,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/process-execution/windows-process-host.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=windows-process-host.d.ts.map

package/dist/process-execution/windows-process-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"windows-process-host.d.ts","sourceRoot":"","sources":["../../src/process-execution/windows-process-host.ts"],"names":[],"mappings":""}

package/dist/process-execution/windows-process-host.js

@@ -0,0 +1,59 @@
+import { spawn } from "node:child_process";
+function isHostRequest(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return false;
+    }
+    const candidate = value;
+    return (candidate.schemaVersion === 1 &&
+        typeof candidate.command === "string" &&
+        candidate.command.length > 0 &&
+        Array.isArray(candidate.args) &&
+        candidate.args.every((argument) => typeof argument === "string") &&
+        typeof candidate.cwd === "string" &&
+        candidate.cwd.length > 0);
+}
+function readRequest() {
+    const encoded = process.argv[2];
+    if (encoded === undefined) {
+        throw new Error("The managed Windows process host did not receive a request.");
+    }
+    let input;
+    try {
+        input = JSON.parse(Buffer.from(encoded, "base64url").toString("utf8"));
+    }
+    catch {
+        throw new Error("The managed Windows process host received invalid request encoding.");
+    }
+    if (!isHostRequest(input)) {
+        throw new Error("The managed Windows process host received an invalid request.");
+    }
+    return input;
+}
+if (process.platform !== "win32") {
+    process.stderr.write("The managed Windows process host can only run on Windows.\n");
+    process.exitCode = 1;
+}
+else {
+    try {
+        const request = readRequest();
+        const child = spawn(request.command, [...request.args], {
+            cwd: request.cwd,
+            detached: false,
+            shell: false,
+            stdio: ["ignore", "inherit", "inherit"],
+            windowsHide: true
+        });
+        child.once("error", (error) => {
+            process.stderr.write(`Managed command could not be started: ${error.message}\n`);
+            process.exitCode = 1;
+        });
+        child.once("exit", (exitCode) => {
+            process.exitCode = exitCode ?? 1;
+        });
+    }
+    catch (error) {
+        process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=windows-process-host.js.map

package/dist/process-execution/windows-process-host.js.map

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

package/dist/public-api-surface.d.ts

@@ -0,0 +1,4 @@
+export * from "./index.js";
+export * as localMode from "./local-mode/index.js";
+export * as scaffolding from "./scaffolding/index.js";
+//# sourceMappingURL=public-api-surface.d.ts.map

package/dist/public-api-surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-api-surface.d.ts","sourceRoot":"","sources":["../src/public-api-surface.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,OAAO,KAAK,SAAS,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,WAAW,MAAM,wBAAwB,CAAC"}

package/dist/public-api-surface.js

@@ -0,0 +1,4 @@
+export * from "./index.js";
+export * as localMode from "./local-mode/index.js";
+export * as scaffolding from "./scaffolding/index.js";
+//# sourceMappingURL=public-api-surface.js.map

package/dist/public-api-surface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-api-surface.js","sourceRoot":"","sources":["../src/public-api-surface.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,OAAO,KAAK,SAAS,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,WAAW,MAAM,wBAAwB,CAAC"}

package/dist/scaffolding/adapters/memory/memory-workspace.d.ts

@@ -0,0 +1,9 @@
+import type { ScaffoldPlanV1, ScaffoldReceiptV1 } from "../../contract/types.js";
+export declare class MemoryScaffoldWorkspace {
+    #private;
+    constructor(files?: Readonly<Record<string, string | Uint8Array>>);
+    read(path: string): Uint8Array | undefined;
+    entries(): Readonly<Record<string, Uint8Array>>;
+    apply(plan: ScaffoldPlanV1): Promise<ScaffoldReceiptV1>;
+}
+//# sourceMappingURL=memory-workspace.d.ts.map

package/dist/scaffolding/adapters/memory/memory-workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-workspace.d.ts","sourceRoot":"","sources":["../../../../src/scaffolding/adapters/memory/memory-workspace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,cAAc,EACd,iBAAiB,EAClB,MAAM,yBAAyB,CAAC;AAMjC,qBAAa,uBAAuB;;IAGlC,YAAY,KAAK,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC,CAAM,EASpE;IAED,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAGzC;IAED,OAAO,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAM9C;IAEK,KAAK,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA0E5D;CACF"}

package/dist/scaffolding/adapters/memory/memory-workspace.js

@@ -0,0 +1,93 @@
+import { sha256Bytes } from "../../kernel/canonical-json.js";
+import { assertScaffoldPlanDigest } from "../../kernel/plan-validation.js";
+import { createScaffoldReceipt } from "../../kernel/receipt.js";
+import { assertSchema } from "../../../schema-catalog.js";
+export class MemoryScaffoldWorkspace {
+    #files;
+    constructor(files = {}) {
+        this.#files = new Map(Object.entries(files).map(([path, content]) => [
+            path,
+            typeof content === "string"
+                ? Buffer.from(content, "utf8")
+                : Uint8Array.from(content)
+        ]));
+    }
+    read(path) {
+        const value = this.#files.get(path);
+        return value === undefined ? undefined : Uint8Array.from(value);
+    }
+    entries() {
+        return Object.fromEntries([...this.#files.entries()]
+            .toSorted(([left], [right]) => (left < right ? -1 : left > right ? 1 : 0))
+            .map(([path, content]) => [path, Uint8Array.from(content)]));
+    }
+    async apply(plan) {
+        await assertSchema("scaffold-plan/v1", plan, "scaffold-memory-apply-plan");
+        assertScaffoldPlanDigest(plan);
+        const diagnostics = [];
+        const classifications = plan.operations.map((operation) => {
+            const current = this.#files.get(operation.path);
+            if (current === undefined) {
+                return { operation, state: "absent" };
+            }
+            if (sha256Bytes(current) === operation.after.digest) {
+                return { operation, state: "after" };
+            }
+            diagnostics.push({
+                ruleId: "scaffolding.apply.precondition-conflict",
+                severity: "error",
+                phase: "apply",
+                subject: operation.path,
+                message: "Workspace content matches neither the Plan precondition nor its desired result.",
+                remediation: "Create a new Intent and Plan from the current workspace state."
+            });
+            return { operation, state: "conflict" };
+        });
+        if (classifications.some(({ state }) => state === "conflict")) {
+            return createScaffoldReceipt({
+                plan,
+                adapterId: "foundation.memory/v1",
+                outcome: "rejected",
+                commitState: "rejected",
+                atomicity: "memory-atomic",
+                operations: classifications.map(({ operation, state }) => ({
+                    operationId: operation.id,
+                    path: operation.path,
+                    outcome: state === "conflict"
+                        ? "conflict"
+                        : state === "after"
+                            ? "already-satisfied"
+                            : "not-applied",
+                    ...(state === "after" ? { resultDigest: operation.after.digest } : {})
+                })),
+                diagnostics
+            });
+        }
+        const next = new Map(this.#files);
+        const receipts = classifications.map(({ operation, state }) => {
+            if (state === "absent") {
+                next.set(operation.path, Buffer.from(operation.after.contentBase64, "base64"));
+            }
+            return {
+                operationId: operation.id,
+                path: operation.path,
+                outcome: state === "absent" ? "applied" : "already-satisfied",
+                resultDigest: operation.after.digest
+            };
+        });
+        this.#files.clear();
+        for (const [path, content] of next) {
+            this.#files.set(path, content);
+        }
+        const changed = classifications.some(({ state }) => state === "absent");
+        return createScaffoldReceipt({
+            plan,
+            adapterId: "foundation.memory/v1",
+            outcome: changed ? "applied" : "already-applied",
+            commitState: "committed",
+            atomicity: "memory-atomic",
+            operations: receipts
+        });
+    }
+}
+//# sourceMappingURL=memory-workspace.js.map

package/dist/scaffolding/adapters/memory/memory-workspace.js.map

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

package/dist/scaffolding/adapters/node/filesystem-journal.d.ts

@@ -0,0 +1,6 @@
+import type { ScaffoldPlanV1 } from "../../contract/types.js";
+export declare const SCAFFOLD_JOURNAL_FILE = "scaffolding-transaction.json";
+export declare function writeScaffoldJournal(path: string, plan: ScaffoldPlanV1): Promise<void>;
+export declare function readScaffoldJournal(path: string): Promise<ScaffoldPlanV1 | undefined>;
+export declare function removeScaffoldJournal(path: string): Promise<void>;
+//# sourceMappingURL=filesystem-journal.d.ts.map

package/dist/scaffolding/adapters/node/filesystem-journal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem-journal.d.ts","sourceRoot":"","sources":["../../../../src/scaffolding/adapters/node/filesystem-journal.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAQ9D,eAAO,MAAM,qBAAqB,iCAAiC,CAAC;AAUpE,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,IAAI,CAAC,CAuBf;AAED,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CA0CrC;AAED,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGvE"}