ttsc 0.30.3 → 0.31.0

package/lib/compiler/internal/captureProcessOutput.d.ts

@@ -1,26 +1,28 @@
-export interface CapturedProcessOutput {
-    /** Close the descriptors and remove the backing files. */
-    dispose(): void;
-    /** Read one stream's bytes, decoded unless `"buffer"` is asked for. */
-    read(stream: "stdout" | "stderr", encoding: BufferEncoding | "buffer" | undefined): string | Buffer;
-    stderrFd: number;
-    stdoutFd: number;
-}
+import type { CapturedProcessOutput } from "./CapturedProcessOutput";
 /**
- * A pair of temporary files standing in for a child process's pipes.
+ * Acquire two private files and descriptors for a child's output.
  *
- * `spawnSync` holds a _piped_ stream in this process's memory and refuses to
- * keep more than `maxBuffer` bytes, so any piped capture has to name a ceiling
- * — and a ceiling is a number nobody chose for this machine, deciding on the
- * user's behalf that a large but legitimate build said too much. Handing the
- * child a file descriptor instead means the bytes never pass through this heap
- * on their way out of the child: how much a process may write is the
- * filesystem's business, and that is the same answer on every machine. Reading
- * the result back still materializes a string, so V8's own maximum string
- * length remains the outer bound — but that is a property of the runtime rather
- * than a budget chosen here, and it is identical everywhere this runs.
+ * File descriptors avoid spawnSync's piped maxBuffer ceiling. Reading after
+ * exit still allocates complete output and is subject to filesystem, Buffer and
+ * string limits; file capture does not make output unbounded.
  *
- * The directory is per-call, so two concurrent spawns cannot read each other's
- * bytes.
+ * The directory is per-call, so ordinary concurrent captures use separate
+ * destinations. This is not held-directory protection against namespace
+ * mutation. Descriptor acquisition failures attempt rollback; cleanup failures
+ * are suppressed, and the temp creator can leave an unclaimed postflight
+ * allocation. The caller owns the returned capture and must dispose it after
+ * reading; read failures propagate, while disposal is idempotent and cleanup is
+ * best effort.
+ *
+ * @evidence contracts/common.md#principled-implementation Precreated files receive exact child stream bytes through inherited descriptors; decoding happens on read, and I/O errors cannot masquerade as empty successful output.
+ * @evidence contracts/common.md#clear-and-simple-design One capture owns two descriptors and their private directory. Acquisition rollback and disposal share cleanup helpers, leaving consumers responsible for a finally boundary.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Supported Node filesystem and descriptor APIs capture diagnostics without foreign mutation, expected-output substitution or an arbitrary output ceiling.
+ * @evidence contracts/common.md#meaningful-documentation Separate purpose, limits and ownership paragraphs follow the documentation skill and explain actual failure effects rather than claiming unlimited output.
+ * @evidence contracts/portability.md#os-neutral-implementation Canonical temporary-directory ownership and path.join represent native paths; Node manages native descriptors. Removal remains best effort because inherited Windows handles may keep files live.
+ * @evidence contracts/performance.md#efficient-algorithms Two streams require a fixed number of filesystem calls, including delegated canonical-parent/child observations and native creation/open work. Parent/path text and native lookup are not constant-cost; reading B bytes and optional decoding allocate complete raw/output text in O(B) storage. No output-byte quota is imposed by this capture owner.
+ *
+ * @evidenceExclude contracts/performance.md#reuse-equivalent-work Each child requires independent effectful output destinations; sharing prior captures would mix bytes and ownership rather than reuse equivalent work.
+ *
+ * @evidence contracts/performance.md#bound-retention-and-release-resources One accepted directory and two descriptors transfer to the capture until disposal. Acquisition rollback/disposal attempt close/removal; errors are suppressed, so closure and file reclamation can remain unconfirmed. Disposal marks itself consumed before cleanup and does not retry; caller-reachable capture closures retain path/state references until discarded. Output bytes are uncapped here.
  */
 export declare function captureProcessOutput(): CapturedProcessOutput;

package/lib/compiler/internal/captureProcessOutput.js

@@ -8,69 +8,83 @@ const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const createCanonicalTempDirectory_1 = require("../../internal/createCanonicalTempDirectory");
 /**
- * A pair of temporary files standing in for a child process's pipes.
+ * Acquire two private files and descriptors for a child's output.
  *
- * `spawnSync` holds a _piped_ stream in this process's memory and refuses to
- * keep more than `maxBuffer` bytes, so any piped capture has to name a ceiling
- * — and a ceiling is a number nobody chose for this machine, deciding on the
- * user's behalf that a large but legitimate build said too much. Handing the
- * child a file descriptor instead means the bytes never pass through this heap
- * on their way out of the child: how much a process may write is the
- * filesystem's business, and that is the same answer on every machine. Reading
- * the result back still materializes a string, so V8's own maximum string
- * length remains the outer bound — but that is a property of the runtime rather
- * than a budget chosen here, and it is identical everywhere this runs.
+ * File descriptors avoid spawnSync's piped maxBuffer ceiling. Reading after
+ * exit still allocates complete output and is subject to filesystem, Buffer and
+ * string limits; file capture does not make output unbounded.
  *
- * The directory is per-call, so two concurrent spawns cannot read each other's
- * bytes.
+ * The directory is per-call, so ordinary concurrent captures use separate
+ * destinations. This is not held-directory protection against namespace
+ * mutation. Descriptor acquisition failures attempt rollback; cleanup failures
+ * are suppressed, and the temp creator can leave an unclaimed postflight
+ * allocation. The caller owns the returned capture and must dispose it after
+ * reading; read failures propagate, while disposal is idempotent and cleanup is
+ * best effort.
+ *
+ * @evidence contracts/common.md#principled-implementation Precreated files receive exact child stream bytes through inherited descriptors; decoding happens on read, and I/O errors cannot masquerade as empty successful output.
+ * @evidence contracts/common.md#clear-and-simple-design One capture owns two descriptors and their private directory. Acquisition rollback and disposal share cleanup helpers, leaving consumers responsible for a finally boundary.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Supported Node filesystem and descriptor APIs capture diagnostics without foreign mutation, expected-output substitution or an arbitrary output ceiling.
+ * @evidence contracts/common.md#meaningful-documentation Separate purpose, limits and ownership paragraphs follow the documentation skill and explain actual failure effects rather than claiming unlimited output.
+ * @evidence contracts/portability.md#os-neutral-implementation Canonical temporary-directory ownership and path.join represent native paths; Node manages native descriptors. Removal remains best effort because inherited Windows handles may keep files live.
+ * @evidence contracts/performance.md#efficient-algorithms Two streams require a fixed number of filesystem calls, including delegated canonical-parent/child observations and native creation/open work. Parent/path text and native lookup are not constant-cost; reading B bytes and optional decoding allocate complete raw/output text in O(B) storage. No output-byte quota is imposed by this capture owner.
+ *
+ * @evidenceExclude contracts/performance.md#reuse-equivalent-work Each child requires independent effectful output destinations; sharing prior captures would mix bytes and ownership rather than reuse equivalent work.
+ *
+ * @evidence contracts/performance.md#bound-retention-and-release-resources One accepted directory and two descriptors transfer to the capture until disposal. Acquisition rollback/disposal attempt close/removal; errors are suppressed, so closure and file reclamation can remain unconfirmed. Disposal marks itself consumed before cleanup and does not retry; caller-reachable capture closures retain path/state references until discarded. Output bytes are uncapped here.
  */
 function captureProcessOutput() {
     const directory = (0, createCanonicalTempDirectory_1.createCanonicalTempDirectory)("ttsc-spawn-");
     const stdoutPath = node_path_1.default.join(directory, "stdout");
     const stderrPath = node_path_1.default.join(directory, "stderr");
-    const stdoutFd = node_fs_1.default.openSync(stdoutPath, "w+");
+    let stdoutFd;
+    try {
+        stdoutFd = node_fs_1.default.openSync(stdoutPath, "w+");
+    }
+    catch (error) {
+        removeQuietly(directory);
+        throw error;
+    }
     let stderrFd;
     try {
         stderrFd = node_fs_1.default.openSync(stderrPath, "w+");
     }
     catch (error) {
         // The first descriptor and the directory are already live. Nothing else
-        // will ever hold them, so they are released here rather than left for a
+        // will receive a disposer, so cleanup is attempted here rather than left for a
         // caller that never received a handle to dispose.
         closeQuietly(stdoutFd);
         removeQuietly(directory);
         throw error;
     }
+    let disposed = false;
     return {
         dispose() {
+            if (disposed)
+                return;
+            disposed = true;
             closeQuietly(stdoutFd);
             closeQuietly(stderrFd);
             removeQuietly(directory);
         },
         read(stream, encoding) {
             const location = stream === "stdout" ? stdoutPath : stderrPath;
-            let raw;
-            try {
-                raw = node_fs_1.default.readFileSync(location);
-            }
-            catch {
-                // A spawn that never launched leaves nothing behind. Report the same
-                // empty output a failed piped capture would have.
-                raw = Buffer.alloc(0);
-            }
+            const raw = node_fs_1.default.readFileSync(location);
             return encoding === "buffer" ? raw : raw.toString(encoding ?? "utf8");
         },
         stderrFd,
+        stderrPath,
         stdoutFd,
+        stdoutPath,
     };
 }
-/** Close a descriptor, ignoring one that is already closed. */
+/** Attempt closure without replacing the acquisition or process outcome. */
 function closeQuietly(fd) {
     try {
         node_fs_1.default.closeSync(fd);
     }
     catch {
-        // Already closed; removing the directory is what reclaims the space.
+        // Cleanup remains best effort, including descriptors closed by the host.
     }
 }
 /**

package/lib/compiler/internal/captureProcessOutput.js.map

@@ -1 +1 @@
-{"version":3,"file":"captureProcessOutput.js","sourceRoot":"","sources":["../../../src/compiler/internal/captureProcessOutput.ts"],"names":[],"mappings":";;;;;;AAAA,sDAAyB;AACzB,0DAA6B;AAE7B,8FAA2F;AAc3F;;;;;;;;;;;;;;;;GAgBG;AACH;IACE,MAAM,SAAS,GAAG,IAAA,2DAA4B,EAAC,aAAa,CAAC,CAAC;IAC9D,MAAM,UAAU,GAAG,mBAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAClD,MAAM,UAAU,GAAG,mBAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,iBAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAC/C,IAAI,QAAgB,CAAC;IACrB,IAAI,CAAC;QACH,QAAQ,GAAG,iBAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAC3C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,wEAAwE;QACxE,wEAAwE;QACxE,kDAAkD;QAClD,YAAY,CAAC,QAAQ,CAAC,CAAC;QACvB,aAAa,CAAC,SAAS,CAAC,CAAC;QACzB,MAAM,KAAK,CAAC;IACd,CAAC;IACD,OAAO;QACL,OAAO;YACL,YAAY,CAAC,QAAQ,CAAC,CAAC;YACvB,YAAY,CAAC,QAAQ,CAAC,CAAC;YACvB,aAAa,CAAC,SAAS,CAAC,CAAC;QAC3B,CAAC;QACD,IAAI,CAAC,MAAM,EAAE,QAAQ;YACnB,MAAM,QAAQ,GAAG,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC;YAC/D,IAAI,GAAW,CAAC;YAChB,IAAI,CAAC;gBACH,GAAG,GAAG,iBAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;YAClC,CAAC;YAAC,MAAM,CAAC;gBACP,qEAAqE;gBACrE,kDAAkD;gBAClD,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACxB,CAAC;YACD,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,IAAI,MAAM,CAAC,CAAC;QACxE,CAAC;QACD,QAAQ;QACR,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,+DAA+D;AAC/D,SAAS,YAAY,CAAC,EAAU;IAC9B,IAAI,CAAC;QACH,iBAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,qEAAqE;IACvE,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,aAAa,CAAC,SAAiB;IACtC,IAAI,CAAC;QACH,iBAAE,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,eAAe;IACjB,CAAC;AACH,CAAC"}
+{"version":3,"file":"captureProcessOutput.js","sourceRoot":"","sources":["../../../src/compiler/internal/captureProcessOutput.ts"],"names":[],"mappings":";;;;;;AAAA,sDAAyB;AACzB,0DAA6B;AAE7B,8FAA2F;AAG3F;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH;IACE,MAAM,SAAS,GAAG,IAAA,2DAA4B,EAAC,aAAa,CAAC,CAAC;IAC9D,MAAM,UAAU,GAAG,mBAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAClD,MAAM,UAAU,GAAG,mBAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAClD,IAAI,QAAgB,CAAC;IACrB,IAAI,CAAC;QACH,QAAQ,GAAG,iBAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAC3C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,aAAa,CAAC,SAAS,CAAC,CAAC;QACzB,MAAM,KAAK,CAAC;IACd,CAAC;IACD,IAAI,QAAgB,CAAC;IACrB,IAAI,CAAC;QACH,QAAQ,GAAG,iBAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAC3C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,wEAAwE;QACxE,+EAA+E;QAC/E,kDAAkD;QAClD,YAAY,CAAC,QAAQ,CAAC,CAAC;QACvB,aAAa,CAAC,SAAS,CAAC,CAAC;QACzB,MAAM,KAAK,CAAC;IACd,CAAC;IACD,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,OAAO;QACL,OAAO;YACL,IAAI,QAAQ;gBAAE,OAAO;YACrB,QAAQ,GAAG,IAAI,CAAC;YAChB,YAAY,CAAC,QAAQ,CAAC,CAAC;YACvB,YAAY,CAAC,QAAQ,CAAC,CAAC;YACvB,aAAa,CAAC,SAAS,CAAC,CAAC;QAC3B,CAAC;QACD,IAAI,CAAC,MAAM,EAAE,QAAQ;YACnB,MAAM,QAAQ,GAAG,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC;YAC/D,MAAM,GAAG,GAAG,iBAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;YACtC,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,IAAI,MAAM,CAAC,CAAC;QACxE,CAAC;QACD,QAAQ;QACR,UAAU;QACV,QAAQ;QACR,UAAU;KACX,CAAC;AACJ,CAAC;AAED,4EAA4E;AAC5E,SAAS,YAAY,CAAC,EAAU;IAC9B,IAAI,CAAC;QACH,iBAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,yEAAyE;IAC3E,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,aAAa,CAAC,SAAiB;IACtC,IAAI,CAAC;QACH,iBAAE,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,eAAe;IACjB,CAAC;AACH,CAAC"}

package/lib/compiler/internal/compileProjectInMemory.d.ts

@@ -1,19 +1,42 @@
 import type { ITtscCompilerContext } from "../../structures/ITtscCompilerContext";
 import type { TtscBuildResult } from "../../structures/internal/TtscBuildResult";
 /**
- * Compile a project and capture emitted files without writing to the project
- * tree.
+ * Compile a project while capturing emitted outputs instead of placing those
+ * outputs in the project tree. Compiler/plugin caches and plugin side effects
+ * remain owned by their normal paths; this is not a no-filesystem-write mode.
  *
- * When no plugins are configured the fast path spawns the native ttsc compiler
- * host (`cmd/ttsc api-compile`) which returns a structured JSON response
- * containing diagnostics and an output file map. When plugins are present the
- * slow path goes through `runBuild` into a temp directory and reads the files
- * back from disk.
+ * When no plugins are configured the native path spawns the native ttsc
+ * compiler host (`cmd/ttsc api-compile`) which returns a structured JSON
+ * response containing diagnostics and an output file map. When plugins are
+ * present the plugin path goes through `runBuild` into a temp directory and
+ * reads the files back from disk. Independent recovery checks use the same
+ * private destinations, with a separate incremental-state file that is not an
+ * emitted API artifact. Actual emission state remains in returned partial
+ * output.
+ *
+ * A native response must contain a string-valued output record. Plugin output
+ * storage removal is attempted before returning. If removal also fails after a
+ * thrown operation failure, both are retained in an AggregateError with the
+ * original cause. An unsuccessful returned build retains its diagnostics and
+ * partial output in that aggregate; removal failure after success propagates
+ * directly.
  *
  * @returns A map of output path → file content plus a `TtscBuildResult` with
  *   diagnostics and the exit status.
+ * @evidence contracts/common.md#principled-implementation The plugin-free API host supplies a required text-output record and structured diagnostics; plugin projects use the existing build owner and read its isolated emitted files with the project's output-key convention, translating private map/state coordinates back to their original artifact locations.
+ * @evidence contracts/common.md#clear-and-simple-design One router separates structured native capture from plugin-backed disk emission while project discovery, native execution and build semantics remain with their owning helpers.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Plugin discovery failure routes through the build's real diagnostic path, and an absent or malformed native output record cannot become an empty successful compile.
+ * @evidence contracts/common.md#meaningful-documentation Native paragraphs describe both compile lanes and output-key ownership; separated return members explain diagnostics/status versus emitted content under documentation guidance.
+ * @evidence contracts/performance.md#efficient-algorithms Project discovery/plugin admission and native-host source/cache construction are delegated costs of this call. The native lane captures, decodes and parses complete JSON output; the plugin lane visits E entries, sorts F paths with path-text comparison costs and reads emitted bytes once. Native I/O, compiler work, output-key text and temporary storage grow with their actual inputs; no measured lane speed ranking is claimed.
+ *
+ * @evidenceExclude contracts/performance.md#reuse-equivalent-work Each compile observes potentially changed source and plugin effects; this API owns no proven equivalent-generation cache. The native binary builder independently reuses its valid artifact.
+ *
+ * @evidence contracts/performance.md#bound-retention-and-release-resources Native capture cleanup is best effort in spawnNative; plugin emission owns one accepted temporary tree through finally removal, while temp acquisition has its own failure limitations. Cleanup failure propagates after success and aggregates with a thrown failure or a build outcome carrying nonzero status or error diagnostics, preserving its diagnostics and partial output rather than masking it.
+ * @evidence contracts/portability.md#os-neutral-implementation Native paths use Node resolution and argument arrays; inheritedSidecarEnv owns child environment spelling and the private output owner preserves native output destinations and protocol key spelling, including literal POSIX backslashes.
  */
 export declare function compileProjectInMemory(options: ITtscCompilerContext): {
+    /** Emitted content under the project's native API output-key convention. */
     output: Record<string, string>;
+    /** Compiler diagnostics, exit status and textual failure context. */
     result: TtscBuildResult;
 };

package/lib/compiler/internal/compileProjectInMemory.js

@@ -7,25 +7,49 @@ exports.compileProjectInMemory = compileProjectInMemory;
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const createCanonicalTempDirectory_1 = require("../../internal/createCanonicalTempDirectory");
-const loadProjectPlugins_1 = require("../../plugin/internal/loadProjectPlugins");
+const hasProjectPluginEntries_1 = require("../../plugin/internal/load/hasProjectPluginEntries");
+const PrivateCompilerOutput_1 = require("./PrivateCompilerOutput");
+const runBuild_1 = require("./build/runBuild");
 const buildNativeCompiler_1 = require("./buildNativeCompiler");
-const paths_1 = require("./paths");
+const outputText_1 = require("./outputText");
+const packageRootDir_1 = require("./packageRootDir");
 const readProjectConfig_1 = require("./project/readProjectConfig");
-const runBuild_1 = require("./runBuild");
-const sharedHostHelpers_1 = require("./sharedHostHelpers");
+const SidecarEnvironment_1 = require("./sharedHost/SidecarEnvironment");
+const inheritedSidecarEnv_1 = require("./sharedHost/inheritedSidecarEnv");
 const spawnNative_1 = require("./spawnNative");
 /**
- * Compile a project and capture emitted files without writing to the project
- * tree.
+ * Compile a project while capturing emitted outputs instead of placing those
+ * outputs in the project tree. Compiler/plugin caches and plugin side effects
+ * remain owned by their normal paths; this is not a no-filesystem-write mode.
  *
- * When no plugins are configured the fast path spawns the native ttsc compiler
- * host (`cmd/ttsc api-compile`) which returns a structured JSON response
- * containing diagnostics and an output file map. When plugins are present the
- * slow path goes through `runBuild` into a temp directory and reads the files
- * back from disk.
+ * When no plugins are configured the native path spawns the native ttsc
+ * compiler host (`cmd/ttsc api-compile`) which returns a structured JSON
+ * response containing diagnostics and an output file map. When plugins are
+ * present the plugin path goes through `runBuild` into a temp directory and
+ * reads the files back from disk. Independent recovery checks use the same
+ * private destinations, with a separate incremental-state file that is not an
+ * emitted API artifact. Actual emission state remains in returned partial
+ * output.
+ *
+ * A native response must contain a string-valued output record. Plugin output
+ * storage removal is attempted before returning. If removal also fails after a
+ * thrown operation failure, both are retained in an AggregateError with the
+ * original cause. An unsuccessful returned build retains its diagnostics and
+ * partial output in that aggregate; removal failure after success propagates
+ * directly.
  *
  * @returns A map of output path → file content plus a `TtscBuildResult` with
  *   diagnostics and the exit status.
+ * @evidence contracts/common.md#principled-implementation The plugin-free API host supplies a required text-output record and structured diagnostics; plugin projects use the existing build owner and read its isolated emitted files with the project's output-key convention, translating private map/state coordinates back to their original artifact locations.
+ * @evidence contracts/common.md#clear-and-simple-design One router separates structured native capture from plugin-backed disk emission while project discovery, native execution and build semantics remain with their owning helpers.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Plugin discovery failure routes through the build's real diagnostic path, and an absent or malformed native output record cannot become an empty successful compile.
+ * @evidence contracts/common.md#meaningful-documentation Native paragraphs describe both compile lanes and output-key ownership; separated return members explain diagnostics/status versus emitted content under documentation guidance.
+ * @evidence contracts/performance.md#efficient-algorithms Project discovery/plugin admission and native-host source/cache construction are delegated costs of this call. The native lane captures, decodes and parses complete JSON output; the plugin lane visits E entries, sorts F paths with path-text comparison costs and reads emitted bytes once. Native I/O, compiler work, output-key text and temporary storage grow with their actual inputs; no measured lane speed ranking is claimed.
+ *
+ * @evidenceExclude contracts/performance.md#reuse-equivalent-work Each compile observes potentially changed source and plugin effects; this API owns no proven equivalent-generation cache. The native binary builder independently reuses its valid artifact.
+ *
+ * @evidence contracts/performance.md#bound-retention-and-release-resources Native capture cleanup is best effort in spawnNative; plugin emission owns one accepted temporary tree through finally removal, while temp acquisition has its own failure limitations. Cleanup failure propagates after success and aggregates with a thrown failure or a build outcome carrying nonzero status or error diagnostics, preserving its diagnostics and partial output rather than masking it.
+ * @evidence contracts/portability.md#os-neutral-implementation Native paths use Node resolution and argument arrays; inheritedSidecarEnv owns child environment spelling and the private output owner preserves native output destinations and protocol key spelling, including literal POSIX backslashes.
  */
 function compileProjectInMemory(options) {
     const cwd = node_path_1.default.resolve(options.cwd ?? process.cwd());
@@ -40,30 +64,32 @@ function compileProjectInMemory(options) {
     const tsconfig = project.path;
     const binary = (0, buildNativeCompiler_1.buildNativeCompiler)({
         cacheBaseDir: project.root,
-        cacheDir: options.cacheDir ?? options.env?.TTSC_CACHE_DIR,
-        packageRoot: (0, paths_1.packageRootDir)(),
+        cacheDir: options.cacheDir ??
+            SidecarEnvironment_1.SidecarEnvironment.read(options.env, "TTSC_CACHE_DIR"),
+        packageRoot: (0, packageRootDir_1.packageRootDir)(),
     });
     const res = (0, spawnNative_1.spawnNative)(binary, ["api-compile", "--cwd", project.root, "--tsconfig", tsconfig], {
         cwd: project.root,
-        env: (0, sharedHostHelpers_1.inheritedSidecarEnv)(options.env),
+        env: (0, inheritedSidecarEnv_1.inheritedSidecarEnv)(options.env, options.binary),
     });
     if (res.error) {
         throw new Error(`ttsc: failed to spawn native compiler host ${binary}: ${res.error.message}`);
     }
-    const output = parseNativeCompileOutput((0, spawnNative_1.outputText)(res.stdout), (0, spawnNative_1.outputText)(res.stderr));
+    const output = parseNativeCompileOutput((0, outputText_1.outputText)(res.stdout), (0, outputText_1.outputText)(res.stderr));
     return {
         output: output.output,
         result: {
             diagnostics: output.diagnostics,
+            emittedSources: output.emittedSources,
             status: res.status ?? 1,
             stdout: "",
-            stderr: (0, spawnNative_1.outputText)(res.stderr),
+            stderr: (0, outputText_1.outputText)(res.stderr),
         },
     };
 }
 /** Return true when the project or the call-level options declare any plugins. */
 function hasConfiguredPlugins(options, project) {
-    return (0, loadProjectPlugins_1.hasProjectPluginEntries)(project, options.plugins);
+    return (0, hasProjectPluginEntries_1.hasProjectPluginEntries)(project, options.plugins);
 }
 /**
  * Route plugin discovery failures through runBuild's recoverable setup path.
@@ -84,101 +110,95 @@ function shouldUsePluginBuild(options, project) {
  */
 function compileProjectWithPlugins(options, cwd, project) {
     const tempRoot = (0, createCanonicalTempDirectory_1.createCanonicalTempDirectory)("ttsc-api-output-");
-    const tempOutDir = node_path_1.default.join(tempRoot, "out");
+    let outcome;
+    let failed = false;
+    let failure;
     try {
+        const layout = PrivateCompilerOutput_1.PrivateCompilerOutput.create(project, tempRoot);
         const result = (0, runBuild_1.runBuild)({
             ...options,
             cwd,
             emit: true,
             forceListEmittedFiles: true,
-            outDir: tempOutDir,
-            // The temp directory is an `outDir` this lane injected so the emit can be
-            // read back as strings; the project need not declare one at all. tsgo
-            // answers an inferred common source directory with TS5011 as soon as any
-            // `outDir` is in play, so pin the root it would infer. The keys
-            // `outputKeyMapper` builds are unchanged by it — that root is exactly the
-            // layout tsgo already lays the emit out against (issue #1172).
-            pinInferredRootDir: true,
+            outDir: layout.destinations.outDir ?? undefined,
+            privateOutputDestinations: layout.destinations,
+            // Private output adds an outDir to source-adjacent projects. Pin only
+            // their layout root; configured roots and bundle-only layouts retain
+            // the compiler's containment and option validity.
+            pinInferredRootDir: layout.pinInferredRootDir,
             quiet: true,
             resolvedProject: project,
             structuredDiagnostics: true,
             tsconfig: project.path,
         });
-        return {
-            output: readOutputDirectory(tempOutDir, outputKeyMapper(project)),
+        outcome = {
+            output: PrivateCompilerOutput_1.PrivateCompilerOutput.read(project, tempRoot, layout.originalPath, layout.destinations.tsBuildInfoFile, layout.destinations.diagnosticsTsBuildInfoFile),
             result,
         };
+        return outcome;
     }
-    finally {
-        node_fs_1.default.rmSync(tempRoot, { force: true, recursive: true });
-    }
-}
-/**
- * Build a function that maps a path relative to the temp output directory to
- * the key used in the returned `output` map.
- *
- * When `outDir` is inside the project root the key is relative to the project
- * root (preserving the `outDir` prefix). When `outDir` is outside the project
- * root the key is absolute-style (`/absolute/outDir/relative`). When `outDir`
- * is absent the key is the bare relative path.
- */
-function outputKeyMapper(project) {
-    const outDir = project.compilerOptions.outDir;
-    if (!outDir) {
-        return (relativePath) => relativePath;
-    }
-    const relativeOutDir = node_path_1.default.relative(project.root, outDir);
-    if (relativeOutDir !== "" && !(0, paths_1.isOutsideRelativePath)(relativeOutDir)) {
-        const prefix = pathToKey(relativeOutDir);
-        return (relativePath) => node_path_1.default.posix.join(prefix, relativePath);
+    catch (error) {
+        failed = true;
+        failure = error;
+        throw error;
     }
-    return (relativePath) => pathToKey(node_path_1.default.join(outDir, relativePath));
-}
-/** Read every file in `directory` recursively and return a `path→content` map. */
-function readOutputDirectory(directory, keyOf) {
-    const output = {};
-    if (!node_fs_1.default.existsSync(directory)) {
-        return output;
-    }
-    for (const file of listFiles(directory)) {
-        output[keyOf(pathToKey(node_path_1.default.relative(directory, file)))] = node_fs_1.default.readFileSync(file, "utf8");
-    }
-    return output;
-}
-/** Recursively list all files under `directory`, sorted for stable output. */
-function listFiles(directory) {
-    const out = [];
-    for (const entry of node_fs_1.default.readdirSync(directory, { withFileTypes: true })) {
-        const location = node_path_1.default.join(directory, entry.name);
-        if (entry.isDirectory()) {
-            out.push(...listFiles(location));
+    finally {
+        try {
+            node_fs_1.default.rmSync(tempRoot, { force: true, recursive: true });
         }
-        else if (entry.isFile()) {
-            out.push(location);
+        catch (cleanupError) {
+            if (failed) {
+                throw new AggregateError([failure, cleanupError], "ttsc: project compilation and temporary output cleanup failed", { cause: failure });
+            }
+            if (outcome !== undefined &&
+                (outcome.result.status !== 0 ||
+                    outcome.result.diagnostics.some((diagnostic) => diagnostic.category === "error"))) {
+                throw new AggregateError([outcome, cleanupError], "ttsc: unsuccessful project compilation and temporary output cleanup failed", { cause: outcome });
+            }
+            throw cleanupError;
         }
     }
-    return out.sort();
-}
-/** Normalise a file path to a forward-slash key suitable for the output map. */
-function pathToKey(file) {
-    return file.replace(/\\/g, "/");
 }
 /**
  * Parse the JSON envelope written by the native compiler host to stdout.
  *
- * On success returns `{ diagnostics, output }`. On JSON parse failure throws a
- * descriptive error using stderr (preferred) or stdout as context, so callers
- * see the original compiler error rather than a generic JSON parse message.
+ * On success returns diagnostics, output and optional emitted-source
+ * provenance. Missing legacy provenance remains unknown. Malformed provenance
+ * is rejected. On JSON parse failure throws a descriptive error using stderr
+ * (preferred) or stdout as context, so callers see the original compiler error
+ * rather than a generic JSON parse message.
  */
 function parseNativeCompileOutput(stdout, stderr) {
     try {
         const parsed = JSON.parse(stdout);
+        if (typeof parsed !== "object" ||
+            parsed === null ||
+            Array.isArray(parsed) ||
+            typeof parsed.output !== "object" ||
+            parsed.output === null ||
+            Array.isArray(parsed.output) ||
+            !Object.values(parsed.output).every((value) => typeof value === "string")) {
+            throw new Error("ttsc: native compiler host returned an invalid output map");
+        }
+        if (parsed.emittedSources !== undefined &&
+            (typeof parsed.emittedSources !== "object" ||
+                parsed.emittedSources === null ||
+                Array.isArray(parsed.emittedSources) ||
+                !Object.entries(parsed.emittedSources).every(([output, sources]) => node_path_1.default.isAbsolute(output) &&
+                    Array.isArray(sources) &&
+                    sources.every((source) => typeof source === "string" && node_path_1.default.isAbsolute(source))))) {
+            throw new Error("ttsc: native compiler host returned invalid emit provenance");
+        }
         return {
-            diagnostics: parsed.diagnostics ?? [],
-            output: parsed.output ?? {},
+            diagnostics: Array.isArray(parsed.diagnostics) ? parsed.diagnostics : [],
+            output: parsed.output,
+            emittedSources: parsed.emittedSources,
         };
     }
-    catch {
+    catch (error) {
+        if (error instanceof Error && !(error instanceof SyntaxError)) {
+            throw error;
+        }
         throw new Error((stderr || stdout).trim() ||
             "ttsc: native compiler host returned no output");
     }

package/lib/compiler/internal/compileProjectInMemory.js.map

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

package/lib/compiler/internal/ensureExecutable.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Ensure the binary has the executable bit set on POSIX systems. Silently skips
+ * on Windows and swallows `chmod` errors to let the original spawn error
+ * surface instead of masking it with a permission error.
+ *
+ * @evidence contracts/common.md#principled-implementation X_OK checks current access first; a failed check permits a best-effort POSIX repair that preserves the low nine permission bits and adds 0755. Special mode bits are not preserved by that masked repair.
+ * @evidence contracts/common.md#clear-and-simple-design This boundary attempts permission preparation only; spawning retains ownership of the definitive error and process outcome.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Permission preparation uses supported filesystem APIs and does not intercept spawning or turn missing binaries into success.
+ * @evidence contracts/common.md#meaningful-documentation The native comment explains the Windows branch and why chmod failure remains for the spawn path, following the documentation skill.
+ * @evidence contracts/portability.md#os-neutral-implementation Windows execution does not use POSIX mode bits; other supported hosts use Node X_OK and chmod with the native path, isolating that real OS distinction here.
+ * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources The synchronous access/stat/chmod APIs do not return retained handles, and this declaration owns no live child or cache after returning.
+ * @evidence contracts/performance.md#efficient-algorithms Windows returns before I/O; other hosts attempt one access check and, only on failure, one stat and one chmod. Work includes native path lookup and permission-operation costs; the fixed call count does not bound native duration.
+ * @evidenceExclude contracts/performance.md#reuse-equivalent-work It does not coordinate compilation or memoize permission results: each call consults current access so an earlier successful check is not reused as authority after permission changes.
+ */
+export declare function ensureExecutable(binary: string): void;

package/lib/compiler/internal/ensureExecutable.js

@@ -0,0 +1,40 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureExecutable = ensureExecutable;
+const node_fs_1 = __importDefault(require("node:fs"));
+/**
+ * Ensure the binary has the executable bit set on POSIX systems. Silently skips
+ * on Windows and swallows `chmod` errors to let the original spawn error
+ * surface instead of masking it with a permission error.
+ *
+ * @evidence contracts/common.md#principled-implementation X_OK checks current access first; a failed check permits a best-effort POSIX repair that preserves the low nine permission bits and adds 0755. Special mode bits are not preserved by that masked repair.
+ * @evidence contracts/common.md#clear-and-simple-design This boundary attempts permission preparation only; spawning retains ownership of the definitive error and process outcome.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Permission preparation uses supported filesystem APIs and does not intercept spawning or turn missing binaries into success.
+ * @evidence contracts/common.md#meaningful-documentation The native comment explains the Windows branch and why chmod failure remains for the spawn path, following the documentation skill.
+ * @evidence contracts/portability.md#os-neutral-implementation Windows execution does not use POSIX mode bits; other supported hosts use Node X_OK and chmod with the native path, isolating that real OS distinction here.
+ * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources The synchronous access/stat/chmod APIs do not return retained handles, and this declaration owns no live child or cache after returning.
+ * @evidence contracts/performance.md#efficient-algorithms Windows returns before I/O; other hosts attempt one access check and, only on failure, one stat and one chmod. Work includes native path lookup and permission-operation costs; the fixed call count does not bound native duration.
+ * @evidenceExclude contracts/performance.md#reuse-equivalent-work It does not coordinate compilation or memoize permission results: each call consults current access so an earlier successful check is not reused as authority after permission changes.
+ */
+function ensureExecutable(binary) {
+    if (process.platform === "win32") {
+        return;
+    }
+    try {
+        node_fs_1.default.accessSync(binary, node_fs_1.default.constants.X_OK);
+        return;
+    }
+    catch {
+        try {
+            const mode = node_fs_1.default.statSync(binary).mode & 0o777;
+            node_fs_1.default.chmodSync(binary, mode | 0o755);
+        }
+        catch {
+            /* keep the original spawn error path */
+        }
+    }
+}
+//# sourceMappingURL=ensureExecutable.js.map

package/lib/compiler/internal/ensureExecutable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensureExecutable.js","sourceRoot":"","sources":["../../../src/compiler/internal/ensureExecutable.ts"],"names":[],"mappings":";;;;;;AAAA,sDAAyB;AAEzB;;;;;;;;;;;;;GAaG;AACH,0BAAiC,MAAc;IAC7C,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,OAAO;IACT,CAAC;IACD,IAAI,CAAC;QACH,iBAAE,CAAC,UAAU,CAAC,MAAM,EAAE,iBAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACzC,OAAO;IACT,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,iBAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC;YAC9C,iBAAE,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,GAAG,KAAK,CAAC,CAAC;QACrC,CAAC;QAAC,MAAM,CAAC;YACP,wCAAwC;QAC1C,CAAC;IACH,CAAC;AACH,CAAC"}

package/lib/compiler/internal/findNearestGoMod.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Walk up the directory tree from `from` looking for a `go.mod` file. Stops
+ * after `maxDepth` hops so callers can bound the search to a known
+ * neighbourhood of the plugin source directory.
+ *
+ * Returns the absolute path to the first `go.mod` found, or `null` when no
+ * `go.mod` exists within the depth limit or filesystem root is reached first.
+ * Only stat-observed regular files qualify; a directory named go.mod is not
+ * module metadata. The caller supplies a nonnegative integer parent limit (the
+ * maintained plugin caller uses 3). Other native stat errors propagate; a
+ * returned path is an observation, not a held identity or parsed module.
+ *
+ * @evidence contracts/common.md#principled-implementation Searching the starting directory then at most maxDepth parents implements the plugin module's nearest-owner rule; regular-file status distinguishes metadata from an identically named directory.
+ * @evidence contracts/common.md#clear-and-simple-design One bounded ancestry walk owns module discovery, while the caller owns plugin-source validation and interpretation of the resulting module root.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The search follows module ancestry and an explicit supported depth, without guessing a module from a particular plugin name or fixture layout.
+ * @evidence contracts/common.md#meaningful-documentation The native comment defines inclusive starting-directory search, parent limit, absence and file-kind requirements in separated prose following the documentation skill.
+ * @evidence contracts/portability.md#os-neutral-implementation Native path resolution and parent traversal handle platform roots; stat follows filesystem symlinks to actual regular module files without an OS-derived case assumption.
+ * @evidence contracts/performance.md#efficient-algorithms For the caller-supplied nonnegative integer limit, at most maxDepth plus one metadata probes occur, fewer at a filesystem root. Path resolution/join/parent text and native stat lookup costs accompany those probes; one current path avoids retaining all ancestors and no recursive source scan is performed.
+ *
+ * @evidenceExclude contracts/performance.md#reuse-equivalent-work Nearby go.mod files can appear or disappear; this query has no watcher or dependency identity authorizing persistent cross-request reuse.
+ * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources The synchronous walk owns no retained descriptors or historical state and transfers its nullable path result to the caller.
+ */
+export declare function findNearestGoMod(from: string, maxDepth: number): string | null;