carrick 0.3.77 → 0.3.78

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "carrick",
-  "version": "0.3.77",
+  "version": "0.3.78",
   "description": "The API contract index for a TypeScript workspace: what the other services do with the routes and calls in the file you are editing, in your editor and in your agent's context",
   "keywords": [
     "typescript",
@@ -57,11 +57,11 @@
     "zod": "^3.23.0"
   },
   "optionalDependencies": {
-    "@carrick-tools/cli-darwin-arm64": "0.3.77",
-    "@carrick-tools/cli-darwin-x64": "0.3.77",
-    "@carrick-tools/cli-linux-arm64": "0.3.77",
-    "@carrick-tools/cli-linux-x64": "0.3.77",
-    "@carrick-tools/cli-win32-x64": "0.3.77"
+    "@carrick-tools/cli-darwin-arm64": "0.3.78",
+    "@carrick-tools/cli-darwin-x64": "0.3.78",
+    "@carrick-tools/cli-linux-arm64": "0.3.78",
+    "@carrick-tools/cli-linux-x64": "0.3.78",
+    "@carrick-tools/cli-win32-x64": "0.3.78"
   },
   "devDependencies": {
     "@types/node": "^24.13.3",

package/sidecar/dist/src/capture/index.d.ts

@@ -32,6 +32,25 @@ export type { CaptureStubOptions, CaptureStubResult } from './api.js';
 export { DenoProject, findDenoConfig } from './deno-project.js';
 export { runCheck } from './check.js';
 export type { CheckProgress } from './check.js';
+/**
+ * The name of THIS capture's surface entry, without an extension
+ * (carrick#1046).
+ *
+ * The entry has to live inside the effective `rootDir` — an entry beside a
+ * `rootDir` of `src` fails TS6059 — so it is written into the scanned tree and
+ * unlinked afterwards. One name per repo root made two captures of the same
+ * tree share a single file: whichever finished first unlinked it while the
+ * other's program was still reading it, and every alias whose print anchors in
+ * that destination then demoted to `structural_fallback` with an accessibility
+ * reason that described the harness rather than the code. Concurrent captures
+ * of one tree are ordinary — the test suite does it on every run, and two
+ * services of a monorepo can share a root — so the name, not the locking, is
+ * what has to give.
+ *
+ * A leftover from an interrupted capture is also identifiable as one process's
+ * (carrick#1069), rather than a fixed name the next scan reads as source.
+ */
+export declare function surfaceEntryFileName(): string;
 /** Same normalization intent as bundle_file_stems on the Rust side. */
 export declare function sanitizeServiceName(name: string): string;
 export declare function captureStub(opts: CaptureStubOptions): CaptureStubResult;

package/sidecar/dist/src/capture/index.js

@@ -44,6 +44,31 @@ export { DenoProject, findDenoConfig } from './deno-project.js';
 // reaches it only through this door (index.js).
 export { runCheck } from './check.js';
 const SURFACE_ENTRY_BASENAME = '__carrick_surface__';
+/** Captures made by this process, so each one's entry file has a name of its
+ * own. Paired with the pid it is unique across processes too. */
+let surfaceEntrySequence = 0;
+/**
+ * The name of THIS capture's surface entry, without an extension
+ * (carrick#1046).
+ *
+ * The entry has to live inside the effective `rootDir` — an entry beside a
+ * `rootDir` of `src` fails TS6059 — so it is written into the scanned tree and
+ * unlinked afterwards. One name per repo root made two captures of the same
+ * tree share a single file: whichever finished first unlinked it while the
+ * other's program was still reading it, and every alias whose print anchors in
+ * that destination then demoted to `structural_fallback` with an accessibility
+ * reason that described the harness rather than the code. Concurrent captures
+ * of one tree are ordinary — the test suite does it on every run, and two
+ * services of a monorepo can share a root — so the name, not the locking, is
+ * what has to give.
+ *
+ * A leftover from an interrupted capture is also identifiable as one process's
+ * (carrick#1069), rather than a fixed name the next scan reads as source.
+ */
+export function surfaceEntryFileName() {
+    surfaceEntrySequence += 1;
+    return `${SURFACE_ENTRY_BASENAME}.${process.pid}.${surfaceEntrySequence}`;
+}
 /** Same normalization intent as bundle_file_stems on the Rust side. */
 export function sanitizeServiceName(name) {
     return name.toLowerCase().replace(/[^a-z0-9._-]+/g, '-').replace(/^-+|-+$/g, '');
@@ -153,9 +178,11 @@ export function captureStub(opts) {
     const entryDir = parsed.options.rootDir
         ? path.resolve(path.dirname(configPath), parsed.options.rootDir)
         : repoRoot;
+    const surfaceEntry = surfaceEntryFileName();
+    const surfaceDeclaration = `${surfaceEntry}.d.ts`;
     const entryPath = deno
-        ? path.join(deno.cacheDir, `${SURFACE_ENTRY_BASENAME}.ts`)
-        : path.join(entryDir, `${SURFACE_ENTRY_BASENAME}.ts`);
+        ? path.join(deno.cacheDir, `${surfaceEntry}.ts`)
+        : path.join(entryDir, `${surfaceEntry}.ts`);
     fs.mkdirSync(path.dirname(entryPath), { recursive: true });
     // ---- Phase A: analysis program over placeholder entry + anchor sources ----
     let resolved;
@@ -250,7 +277,7 @@ export function captureStub(opts) {
     if (emitPartial) {
         errors.push(`declaration emit was partial: kept ${emitted.size} emitted file(s); ` +
             'aliases referencing unemitted modules are demoted to structural_fallback');
-        resolved = demoteDanglingAliases({ resolved, emitted, declarationSources, staging });
+        resolved = demoteDanglingAliases({ resolved, emitted, declarationSources, staging, surfaceDeclaration });
     }
     // ---- Relocate the emitted tree into the stub package ----
     const typesDir = path.join(stubDir, 'types');
@@ -260,7 +287,7 @@ export function captureStub(opts) {
     let surfaceAbsPath = '';
     for (const [fileName, text] of emitted) {
         let rel = path.relative(staging, fileName).split(path.sep).join('/');
-        if (path.basename(rel) === `${SURFACE_ENTRY_BASENAME}.d.ts`) {
+        if (path.basename(rel) === surfaceDeclaration) {
             const source = sourceByEmitted.get(rel);
             sourceByEmitted.delete(rel);
             rel = 'surface.d.ts';
@@ -422,7 +449,7 @@ function demoteDanglingAliases(args) {
     let surfaceKey;
     for (const fileName of args.emitted.keys()) {
         const rel = path.relative(args.staging, fileName).split(path.sep).join('/');
-        if (path.basename(rel) === `${SURFACE_ENTRY_BASENAME}.d.ts`)
+        if (path.basename(rel) === args.surfaceDeclaration)
             surfaceKey = fileName;
         if (rel.endsWith('.d.ts'))
             treeModules.add(rel.slice(0, -'.d.ts'.length));