@owlmeans/viable-sdk 0.1.18-rc.8 → 0.1.18

package/build/executor/files/types.d.ts

@@ -0,0 +1,106 @@
+import type { StatTreeResult, SubProject } from '@owlmeans/viable-common';
+import type { LocalSourceFile, SourceListOptions } from '../types.js';
+/**
+ * The target's files, as the platform asks for them.
+ *
+ * Shaped exactly like the publisher's `createFileHelper`, because the caller is the same code:
+ * the agent's remote helper sends a `SlotFileCommand` and parses one of these answers, and it has
+ * no way to know whether a pod or a laptop produced it.
+ */
+export interface LocalFileHelper {
+    /**
+     * Wipe the project, keeping what the caller names and what is never ours to delete.
+     *
+     * The kept paths are project-relative and may be NESTED — `.agents/memory/history.md` is one
+     * the reinit pipeline passes, and `sources/web/.env` is one this helper adds itself. Matching
+     * them against top-level `readdir` names alone is what deleted the first: `.agents` matched
+     * nothing in the ignore set, so the whole harness tree went along with the one file the
+     * caller had explicitly asked to preserve — and nothing failed.
+     *
+     * So a directory is removed whole only when nothing kept lives under it; otherwise it is
+     * walked and pruned entry by entry.
+     */
+    emptyProject: (ignore?: string[]) => Promise<void>;
+    deleteProject: () => Promise<void>;
+    /**
+     * Finish an installed template: make sure the root manifest declares its workspaces.
+     *
+     * The agent pushes every template file itself, so this is only the finalizer. The workspace
+     * list is written only when the manifest does not already declare one — the template ships
+     * `["sources/*"]`, and injecting the explicit list beside it produced a manifest carrying the
+     * key TWICE, valid only because JSON keeps the last one.
+     */
+    initializeProject: () => Promise<void>;
+    getSourceList: (pattern?: string, options?: SourceListOptions) => Promise<string[]>;
+    getStructuredList: (patterns: string[]) => Promise<string[]>;
+    readFile: (path: string, notThrow?: boolean) => Promise<string>;
+    readSource: (filePath: string) => Promise<LocalSourceFile>;
+    readPossibleSource: (filePath: string) => Promise<LocalSourceFile>;
+    readSources: (files: string | string[]) => Promise<LocalSourceFile[]>;
+    writeFile: (filePath: string, content: string) => Promise<void>;
+    writeSource: (file: {
+        path: string;
+        code: string;
+    }) => Promise<void>;
+    deleteFile: (filePath: string, noThrow?: boolean) => Promise<void>;
+    /**
+     * The tree, one line per file, bounded.
+     *
+     * One command rather than a listing plus a read per entry: the caller is a census over a
+     * repository somebody else wrote, which may hold a hundred thousand files, and one round trip
+     * each — over a connector, on somebody's laptop — is not a slower walk but a walk that never
+     * finishes.
+     *
+     * `total` counts what the walk SAW and `entries` what it returned. They differ once the limit
+     * is reached, and that difference is the only thing that tells a caller its picture of the
+     * tree is partial: a listing that reported only its own length would be indistinguishable
+     * from a small repository.
+     *
+     * Every entry's `path` is relative to the directory ASKED FOR, not to the project root. That
+     * is the contract the in-process helper and the publisher answer, and one executor answering
+     * a different relativity is worse than either choice: the caller is a census that follows a
+     * listing with a `readHead` of what it listed, and nothing downstream knows which of the
+     * three produced the path it is holding.
+     */
+    statTree: (dir?: string, limit?: number) => Promise<StatTreeResult>;
+    /**
+     * The first bytes of one file, decoded as text.
+     *
+     * A classification reads a head; reading whole files to do it would hold a megabyte export in
+     * memory to look at its first line. Whatever the decoding produces for a binary head is the
+     * answer — that IS the signal an entropy classification wants, and cleaning it up would hide
+     * the one thing the caller is asking about.
+     */
+    readHead: (filePath: string, bytes: number) => Promise<string>;
+    /**
+     * Move everything in the project root under one directory, leaving a named few where they are.
+     *
+     * What makes a converted project possible: the origin's own tree goes below, a Viable target
+     * is grown above it, and the two never share a path. It is the same walk `emptyProject` does —
+     * kept paths may be nested, a directory holding one is walked rather than moved, and a
+     * directory left empty by that walk does not survive as a shell.
+     *
+     * The always-keep set applies here too and for the same reason: `.git` is the developer's
+     * history and moving it under the origin would take the project's whole history with it,
+     * `.viable` is how a later session recognizes the project, and the two `.env` files hold what
+     * the platform cannot re-derive.
+     *
+     * Refuses a destination that already holds something. A relocation into an occupied directory
+     * interleaves two trees, and nothing afterwards can tell which files came from where.
+     */
+    relocate: (dir: string, keep?: string[]) => Promise<{
+        moved: number;
+        kept: string[];
+    }>;
+    /**
+     * Delete a directory and everything under it — the purge of a relocated origin.
+     *
+     * Refuses the project root: emptying the project is `emptyProject`, which has a keep list this
+     * does not, and a purge that resolved to `.` would take the developer's `.git` and `.env` with
+     * the origin it was asked to remove.
+     */
+    removeTree: (dir: string) => Promise<void>;
+    getRootPath: (subproject?: SubProject) => string;
+    findFilesWithEnvVars: (frontend?: boolean) => Promise<string[]>;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/executor/files/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/executor/files/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAErE;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;;;;;;OAWG;IACH,YAAY,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAClD,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAClC;;;;;;;OAOG;IACH,iBAAiB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IACtC,aAAa,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IACnF,iBAAiB,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAC5D,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IAC/D,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,CAAC,CAAA;IAC1D,kBAAkB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,CAAC,CAAA;IAClE,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,OAAO,CAAC,eAAe,EAAE,CAAC,CAAA;IACrE,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/D,WAAW,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACpE,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAClE;;;;;;;;;;;;;;;;;;OAkBG;IACH,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAA;IACnE;;;;;;;OAOG;IACH,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IAC9D;;;;;;;;;;;;;;;OAeG;IACH,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAA;IACtF;;;;;;OAMG;IACH,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1C,WAAW,EAAE,CAAC,UAAU,CAAC,EAAE,UAAU,KAAK,MAAM,CAAA;IAChD,oBAAoB,EAAE,CAAC,QAAQ,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;CAChE"}

package/build/executor/files/types.js

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

package/build/executor/files/types.js.map

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

package/build/executor/files.d.ts

@@ -1,13 +1,4 @@
-import { SubProject } from '@owlmeans/viable-common';
-/** What `readSource` and friends answer with — the shape the platform's file helpers parse. */
-export interface LocalSourceFile {
-    path: string;
-    code?: string;
-}
-export interface SourceListOptions {
-    skipUIElements?: boolean;
-    excludes?: string[];
-}
+import type { LocalFileHelper } from './files/types.js';
 /**
  * The target's files, as the platform asks for them.
  *
@@ -15,46 +6,7 @@ export interface SourceListOptions {
  * the agent's remote helper sends a `SlotFileCommand` and parses one of these answers, and it has
  * no way to know whether a pod or a laptop produced it.
  */
-export declare const createLocalFileHelper: (projectPath: string) => {
-    /**
-     * Wipe the project, keeping what the caller names and what is never ours to delete.
-     *
-     * The kept paths are project-relative and may be NESTED — `.agents/memory/history.md` is one
-     * the reinit pipeline passes, and `sources/web/.env` is one this helper adds itself. Matching
-     * them against top-level `readdir` names alone is what deleted the first: `.agents` matched
-     * nothing in the ignore set, so the whole harness tree went along with the one file the
-     * caller had explicitly asked to preserve — and nothing failed.
-     *
-     * So a directory is removed whole only when nothing kept lives under it; otherwise it is
-     * walked and pruned entry by entry.
-     */
-    emptyProject: (ignore?: string[]) => Promise<void>;
-    deleteProject: () => Promise<void>;
-    /**
-     * Finish an installed template: make sure the root manifest declares its workspaces.
-     *
-     * The agent pushes every template file itself, so this is only the finalizer. The workspace
-     * list is written only when the manifest does not already declare one — the template ships
-     * `["sources/*"]`, and injecting the explicit list beside it produced a manifest carrying the
-     * key TWICE, valid only because JSON keeps the last one.
-     */
-    initializeProject: () => Promise<void>;
-    getSourceList: (pattern?: string, options?: SourceListOptions) => Promise<string[]>;
-    getStructuredList: (patterns: string[]) => Promise<string[]>;
-    readFile: (path: string, notThrow?: boolean) => Promise<string>;
-    readSource: (filePath: string) => Promise<LocalSourceFile>;
-    readPossibleSource: (filePath: string) => Promise<LocalSourceFile>;
-    readSources: (files: string | string[]) => Promise<LocalSourceFile[]>;
-    writeFile: (filePath: string, content: string) => Promise<void>;
-    writeSource: (file: {
-        path: string;
-        code: string;
-    }) => Promise<void>;
-    deleteFile: (filePath: string, noThrow?: boolean) => Promise<void>;
-    getRootPath: (subproject?: SubProject) => string;
-    findFilesWithEnvVars: (frontend?: boolean) => Promise<string[]>;
-};
-export type LocalFileHelper = ReturnType<typeof createLocalFileHelper>;
+export declare const createLocalFileHelper: (projectPath: string) => LocalFileHelper;
 /**
  * The same confinement, for callers outside this helper.
  *

package/build/executor/files.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/executor/files.ts"],"names":[],"mappings":"AAIA,OAAO,EAAwD,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAK1G,+FAA+F;AAC/F,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CACpB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,gBAAiB,MAAM;IAgCrD;;;;;;;;;;;OAWG;4BAC2B,MAAM,EAAE;;IAgDtC;;;;;;;OAOG;;gDA6BQ,iBAAiB,KACzB,OAAO,CAAC,MAAM,EAAE,CAAC;kCAyCgB,MAAM,EAAE,KAAG,OAAO,CAAC,MAAM,EAAE,CAAC;qBASzC,MAAM,yBAAqB,OAAO,CAAC,MAAM,CAAC;2BAWpC,MAAM,KAAG,OAAO,CAAC,eAAe,CAAC;mCAOzB,MAAM,KAAG,OAAO,CAAC,eAAe,CAAC;yBAQ3C,MAAM,GAAG,MAAM,EAAE,KAAG,OAAO,CAAC,eAAe,EAAE,CAAC;0BAY7C,MAAM,WAAW,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;wBAMzC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAAG,OAAO,CAAC,IAAI,CAAC;2BAM3C,MAAM,wBAAmB,OAAO,CAAC,IAAI,CAAC;+BAWxC,UAAU,KAAG,MAAM;sCAIN,OAAO,KAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CA+BtE,CAAA;AAED,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAoCtE;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,QAAS,MAAM,QAAQ,MAAM,KAAG,MACU,CAAA"}
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/executor/files.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAoCvD;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,gBAAiB,MAAM,KAAG,eAkb3D,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,QAAS,MAAM,QAAQ,MAAM,KAAG,MACU,CAAA"}

package/build/executor/files.js

@@ -1,9 +1,37 @@
 import fs from 'fs-extra';
-import { globby } from 'globby';
+import { globHelper } from './glob.js';
+import fsp from 'node:fs/promises';
 import p from 'node:path';
-import { CONNECT_MARKER_DIR, METADATA_DIRS, METADATA_SUFFIXES, SubProject } from '@owlmeans/viable-common';
-import { SandboxPathError } from './errors.js';
-import { subprojectDir, targetPaths } from './layout.js';
+import { BINARY_PROBE_BYTES, CENSUS_MAX_ENTRIES, CENSUS_MAX_HEAD_BYTES, CONNECT_MARKER_DIR, METADATA_SUFFIXES, SOURCE_LIST_EXCLUSIONS, SubProject, censusHelper } from '@owlmeans/viable-common';
+import { FileCommandRefused, SandboxPathError } from './errors.js';
+import { makeLayoutHelper } from './layout.js';
+import { WALK_SKIP } from './consts.local.js';
+const wrapWithSlashes = (path) => path.endsWith('/') ? path : `${path}/`;
+const cleanUpPath = (file, { rootPath }) => file.replace(rootPath, '').replace(/^\/+/, '');
+/**
+ * Resolve a caller-supplied project path to the absolute path it names inside the project.
+ *
+ * Paths arrive from the platform in both shapes — root-relative (`sources/web/src/app.tsx`) and
+ * already absolute — so **every** fs call has to apply the same normalization, not just the read
+ * side. Concatenating an absolute path onto the root instead builds a shadow tree: the write
+ * reports success, a later read of the same name resolves to the untouched original, and the
+ * change looks like it was silently ignored.
+ *
+ * The refusal is confinement, not sanitization: only a fully resolved path can be compared to the
+ * root, and a `..`-to-`.` replace at one caller is a guard on that caller rather than on the tree.
+ */
+const resolveInProject = (file, { rootPath }) => {
+    const resolved = p.resolve(rootPath, cleanUpPath(file, { rootPath }));
+    const root = p.resolve(rootPath);
+    if (resolved !== root && !resolved.startsWith(wrapWithSlashes(root))) {
+        throw new SandboxPathError(file);
+    }
+    return resolved;
+};
+const normalizePaths = (files, { rootPath }) => {
+    const fileList = Array.isArray(files) ? files : [files];
+    return fileList.map(file => file.startsWith('/') ? cleanUpPath(file, { rootPath }) : file);
+};
 /**
  * The target's files, as the platform asks for them.
  *
@@ -13,11 +41,39 @@ import { subprojectDir, targetPaths } from './layout.js';
  */
 export const createLocalFileHelper = (projectPath) => {
     const rootPath = wrapWithSlashes(p.resolve(projectPath));
+    /**
+     * Whether a file is binary, by git's own heuristic: a NUL byte near the beginning.
+     *
+     * Asked only where {@link binaryByExtension} says nothing, and that ordering is the contract
+     * rather than an optimization: a probe alone answers `false` for a small `.ico` with no NUL in its
+     * first bytes, so a census run here and the same census run in the slot disagreed about one file
+     * of one repository — with the tail table consulted first, all three executors agree.
+     */
+    const isBinary = async (path, size) => {
+        if (size < 1)
+            return false;
+        const handle = await fsp.open(path, 'r').catch(() => null);
+        if (handle == null)
+            return false;
+        try {
+            const length = Math.min(size, BINARY_PROBE_BYTES);
+            const buffer = Buffer.alloc(length);
+            const { bytesRead } = await handle.read(buffer, 0, length, 0);
+            return buffer.subarray(0, bytesRead).includes(0);
+        }
+        catch {
+            return false;
+        }
+        finally {
+            await handle.close();
+        }
+    };
     // Every path below asks the tree which layout it holds, per call, rather than closing over one
     // answer: a project is re-initialized in place, and this helper outlives that. `packages/` for
     // a target generated before the move, `sources/` for one generated after it.
-    const layout = () => targetPaths(rootPath);
-    const dirOf = (role) => subprojectDir(rootPath, role);
+    const targetLayout = makeLayoutHelper(rootPath);
+    const layout = () => targetLayout.targetPaths();
+    const dirOf = (role) => targetLayout.subprojectDir(role);
     /**
      * What a wipe must never take, whatever the caller asked to keep.
      *
@@ -39,31 +95,31 @@ export const createLocalFileHelper = (projectPath) => {
         `${layout().dir}/${dirOf(SubProject.Web)}/.env`,
         '.git',
     ];
+    /**
+     * The two questions a wipe and a relocation both ask of every entry they walk.
+     *
+     * Shared because they are the same walk with a different verb: one removes what it passes and
+     * the other moves it, and both must leave a nested keep — `.agents/memory/history.md`,
+     * `sources/web/.env` — where it is. Matching kept paths against top-level names alone is what
+     * once deleted a whole harness tree along with the one file the caller had asked to preserve.
+     */
+    const keepGuards = (entries) => {
+        const keep = new Set(entries.map(entry => entry.replace(/^\.?\//, '').replace(/\/+$/, '')));
+        const holdsKept = (rel) => {
+            const prefix = `${rel}/`;
+            for (const entry of keep) {
+                if (entry.startsWith(prefix))
+                    return true;
+            }
+            return false;
+        };
+        return { keep, isKept: (rel) => keep.has(rel), holdsKept };
+    };
     const helper = {
-        /**
-         * Wipe the project, keeping what the caller names and what is never ours to delete.
-         *
-         * The kept paths are project-relative and may be NESTED — `.agents/memory/history.md` is one
-         * the reinit pipeline passes, and `sources/web/.env` is one this helper adds itself. Matching
-         * them against top-level `readdir` names alone is what deleted the first: `.agents` matched
-         * nothing in the ignore set, so the whole harness tree went along with the one file the
-         * caller had explicitly asked to preserve — and nothing failed.
-         *
-         * So a directory is removed whole only when nothing kept lives under it; otherwise it is
-         * walked and pruned entry by entry.
-         */
         emptyProject: async (ignore) => {
-            const keep = new Set([...(ignore ?? []), ...alwaysKeep()].map(entry => entry.replace(/^\.?\//, '')));
-            const isKept = (rel) => keep.has(rel);
-            // Something kept lives below here, so this directory has to be walked rather than removed.
-            const holdsKept = (rel) => {
-                const prefix = `${rel}/`;
-                for (const entry of keep) {
-                    if (entry.startsWith(prefix))
-                        return true;
-                }
-                return false;
-            };
+            // `holdsKept` says something kept lives below here, so this directory has to be walked
+            // rather than removed.
+            const { isKept, holdsKept } = keepGuards([...(ignore ?? []), ...alwaysKeep()]);
             const prune = async (rel) => {
                 const dir = rel === '' ? rootPath : p.join(rootPath, rel);
                 const entries = await fs.readdir(dir);
@@ -93,14 +149,6 @@ export const createLocalFileHelper = (projectPath) => {
         deleteProject: async () => {
             await helper.emptyProject();
         },
-        /**
-         * Finish an installed template: make sure the root manifest declares its workspaces.
-         *
-         * The agent pushes every template file itself, so this is only the finalizer. The workspace
-         * list is written only when the manifest does not already declare one — the template ships
-         * `["sources/*"]`, and injecting the explicit list beside it produced a manifest carrying the
-         * key TWICE, valid only because JSON keeps the last one.
-         */
         initializeProject: async () => {
             const manifestPath = `${rootPath}package.json`;
             if (await fs.pathExists(manifestPath) === false) {
@@ -127,7 +175,7 @@ ${present.map(path => `          "${path}"`).join(',\n')}
         getSourceList: async (pattern = `${rootPath}**/*`, options = {}) => {
             const { skipUIElements = false, excludes = [] } = options;
             pattern = pattern.startsWith(rootPath) ? pattern : p.join(rootPath, pattern);
-            const files = await globby([
+            const files = await globHelper.list([
                 pattern,
                 `!${rootPath}**/rollup.config.js`,
                 `!${rootPath}**/rollup.build.mjs`,
@@ -151,9 +199,13 @@ ${present.map(path => `          "${path}"`).join(',\n')}
                 `!${rootPath}**/build/**/*`,
                 `!${rootPath}**/node_modules/**/*`,
                 `!${rootPath}spectator-log/**/*`,
-                // The target's own documentation and agent harness, plus the co-located metadata files
+                // The target's own documentation and agent harness, and the origin tree a conversion
+                // keeps beside the generated application — ONE constant, shared with the publisher and
+                // the library, because three copies of this list is three chances for one of them to
+                // keep listing the origin, and the symptom is a coder helper reading a foreign
+                // framework's files as if they were the target's. Plus the co-located metadata files
                 // (*.spec.md, *.ux.md, *.ui.md).
-                ...METADATA_DIRS.map(dir => `!${rootPath}${dir}/**/*`),
+                ...SOURCE_LIST_EXCLUSIONS.map(dir => `!${rootPath}${dir}/**/*`),
                 ...METADATA_SUFFIXES.map(suffix => `!${rootPath}**/*${suffix}`),
                 ...excludes.map(exclude => `!${rootPath}${exclude}`),
                 ...(skipUIElements
@@ -164,7 +216,7 @@ ${present.map(path => `          "${path}"`).join(',\n')}
         },
         getStructuredList: async (patterns) => {
             const resolved = patterns.map(pattern => pattern.startsWith(rootPath) ? pattern : p.join(rootPath, pattern));
-            const files = await globby(resolved);
+            const files = await globHelper.list(resolved);
             return files.map(file => cleanUpPath(file, { rootPath }));
         },
         readFile: async (path, notThrow = false) => {
@@ -220,6 +272,137 @@ ${present.map(path => `          "${path}"`).join(',\n')}
                 }
             }
         },
+        statTree: async (dir, limit) => {
+            const start = dir != null && dir !== ''
+                ? resolveInProject(dir, { rootPath })
+                : p.resolve(rootPath);
+            const cap = limit != null && limit > 0 ? limit : CENSUS_MAX_ENTRIES;
+            const entries = [];
+            let total = 0;
+            const walk = async (absolute) => {
+                const listed = await fs.readdir(absolute, { withFileTypes: true }).catch(() => []);
+                for (const entry of listed) {
+                    if (WALK_SKIP.has(entry.name))
+                        continue;
+                    const child = p.join(absolute, entry.name);
+                    if (entry.isDirectory()) {
+                        await walk(child);
+                        continue;
+                    }
+                    // Symlinks and devices are counted by nobody: a census describes files a model could
+                    // read, and following a link would leave the tree it was asked about.
+                    if (!entry.isFile())
+                        continue;
+                    total += 1;
+                    if (entries.length >= cap)
+                        continue;
+                    const stat = await fs.stat(child).catch(() => null);
+                    if (stat == null)
+                        continue;
+                    const rel = p.relative(start, child);
+                    const known = censusHelper.binaryByExtension(rel);
+                    entries.push({
+                        path: rel,
+                        bytes: stat.size,
+                        binary: known ?? await isBinary(child, stat.size),
+                        modifiedAt: stat.mtime.toISOString(),
+                    });
+                }
+            };
+            await walk(start);
+            return { entries, truncated: total > entries.length, total };
+        },
+        readHead: async (filePath, bytes) => {
+            // Confinement first, and it is the ONE thing here that still raises: a path resolving
+            // outside the project is a caller's bug, never an entry of a tree.
+            const path = resolveInProject(filePath, { rootPath });
+            // Everything else answers `''`. A census hands this whatever a walk over somebody else's
+            // tree produced — a directory, a symlink, a file deleted between the listing and the read —
+            // and one unreadable entry must not fail the pass that is classifying the rest. A directory
+            // is the case that made this necessary: `open` succeeds on one and the read then throws
+            // EISDIR, so the tolerant answer has to cover the read as well as the open.
+            const stat = await fs.stat(path).catch(() => null);
+            if (stat == null || !stat.isFile())
+                return '';
+            const length = Math.min(Math.max(bytes, 0), stat.size, CENSUS_MAX_HEAD_BYTES);
+            if (length < 1)
+                return '';
+            const handle = await fsp.open(path, 'r').catch(() => null);
+            if (handle == null)
+                return '';
+            try {
+                const buffer = Buffer.alloc(length);
+                const { bytesRead } = await handle.read(buffer, 0, length, 0);
+                return buffer.subarray(0, bytesRead).toString('utf-8');
+            }
+            catch {
+                return '';
+            }
+            finally {
+                await handle.close();
+            }
+        },
+        relocate: async (dir, keep) => {
+            // Resolved FIRST, and the project-relative name derived back from the resolved path. A
+            // destination arrives in both shapes like every other path a caller sends, and normalizing
+            // the string ahead of the confinement is what builds the shadow tree `resolveInProject`
+            // exists to prevent: an absolute destination lost its leading slash, resolved under the root
+            // a second time, and the keep set then no longer matched the top-level name it had created.
+            // It also subsumes `.`, `''` and a trailing slash, which all resolve to the root itself.
+            const destinationPath = resolveInProject(dir ?? '', { rootPath });
+            const destination = p.relative(p.resolve(rootPath), destinationPath);
+            if (destination === '') {
+                throw new FileCommandRefused('relocate needs a directory to move the project into');
+            }
+            if (await fs.pathExists(destinationPath)) {
+                const existing = await fs.readdir(destinationPath);
+                if (existing.length > 0) {
+                    throw new FileCommandRefused(`relocation target is not empty: ${destination}`);
+                }
+            }
+            // The destination is kept like anything else, which is what stops the walk moving it into
+            // itself — a keep is checked before a move, and this one always matches first.
+            const { keep: kept, isKept, holdsKept } = keepGuards([destination, ...(keep ?? []), ...alwaysKeep()]);
+            const move = async (rel) => {
+                const from = rel === '' ? rootPath : p.join(rootPath, rel);
+                const entries = await fs.readdir(from);
+                let moved = 0;
+                // Serial: a relocation is one operation from the caller's point of view, and a half-moved
+                // tree is neither the origin nor a target.
+                for (const name of entries) {
+                    const child = rel === '' ? name : `${rel}/${name}`;
+                    if (isKept(child))
+                        continue;
+                    if (holdsKept(child)) {
+                        moved += await move(child);
+                        const remaining = await fs.readdir(p.join(rootPath, child));
+                        if (remaining.length === 0)
+                            await fs.remove(p.join(rootPath, child));
+                        continue;
+                    }
+                    const to = p.join(destinationPath, child);
+                    await fs.ensureDir(p.dirname(to));
+                    await fs.move(p.join(rootPath, child), to);
+                    moved += 1;
+                }
+                return moved;
+            };
+            await fs.ensureDir(destinationPath);
+            const moved = await move('');
+            // The whole keep set, exactly as the publisher and the library helper answer it — this is a
+            // report of what the relocation was told to leave alone, not a listing of what happens to be
+            // on disk afterwards. Filtering it by existence made the same relocation answer differently
+            // here than in a slot, over paths (a project without local branding has no web `.env`) whose
+            // absence says nothing about the move.
+            return { moved, kept: [...kept] };
+        },
+        removeTree: async (dir) => {
+            const path = resolveInProject(dir, { rootPath });
+            if (path === p.resolve(rootPath)) {
+                throw new FileCommandRefused('removeTree cannot delete the project root');
+            }
+            await fs.remove(path);
+        },
         getRootPath: (subproject) => subproject == null
             ? rootPath
             : p.join(rootPath, layout().dir, dirOf(subproject)),
@@ -229,7 +412,7 @@ ${present.map(path => `          "${path}"`).join(',\n')}
                 : frontend === false
                     ? `${rootPath}${layout().dir}/${dirOf(SubProject.Backend)}/src/**/*.ts`
                     : `${rootPath}**/*.ts`;
-            const files = await globby([
+            const files = await globHelper.list([
                 searchPattern,
                 `!${rootPath}**/node_modules/**/*`,
                 `!${rootPath}**/owlmeans.ts`,
@@ -251,32 +434,6 @@ ${present.map(path => `          "${path}"`).join(',\n')}
     };
     return helper;
 };
-const wrapWithSlashes = (path) => path.endsWith('/') ? path : `${path}/`;
-const cleanUpPath = (file, { rootPath }) => file.replace(rootPath, '').replace(/^\/+/, '');
-/**
- * Resolve a caller-supplied project path to the absolute path it names inside the project.
- *
- * Paths arrive from the platform in both shapes — root-relative (`sources/web/src/app.tsx`) and
- * already absolute — so **every** fs call has to apply the same normalization, not just the read
- * side. Concatenating an absolute path onto the root instead builds a shadow tree: the write
- * reports success, a later read of the same name resolves to the untouched original, and the
- * change looks like it was silently ignored.
- *
- * The refusal is confinement, not sanitization: only a fully resolved path can be compared to the
- * root, and a `..`-to-`.` replace at one caller is a guard on that caller rather than on the tree.
- */
-const resolveInProject = (file, { rootPath }) => {
-    const resolved = p.resolve(rootPath, cleanUpPath(file, { rootPath }));
-    const root = p.resolve(rootPath);
-    if (resolved !== root && !resolved.startsWith(wrapWithSlashes(root))) {
-        throw new SandboxPathError(file);
-    }
-    return resolved;
-};
-const normalizePaths = (files, { rootPath }) => {
-    const fileList = Array.isArray(files) ? files : [files];
-    return fileList.map(file => file.startsWith('/') ? cleanUpPath(file, { rootPath }) : file);
-};
 /**
  * The same confinement, for callers outside this helper.
  *

package/build/executor/files.js.map

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

package/build/executor/git/types.d.ts

@@ -0,0 +1,19 @@
+import type { SlotGitCommand } from '@owlmeans/viable-common';
+/**
+ * Git in ONE local project directory, answered the way the publisher answers a slot's git
+ * commands. Every dispatch is serialized per directory: git takes `.git/*.lock` files for the
+ * duration of a write, so two concurrent operations on one repository fail.
+ */
+export interface LocalGitHelper {
+    /**
+     * Answer one `SlotGitCommand` against the directory. The three that touch a remote, and a clone,
+     * are refused as TEXT in the shape their caller parses — a policy, not a failure.
+     */
+    dispatchGitCommand: (command: SlotGitCommand, args?: Record<string, any>) => Promise<Record<string, unknown>>;
+    /**
+     * Make the directory a repository the platform can work in, and change nothing else: no baseline
+     * commit, and an identity only when there is none.
+     */
+    ensureGitRepo: () => Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/executor/git/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/executor/git/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAE7D;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,kBAAkB,EAAE,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IAC7G;;;OAGG;IACH,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CACnC"}

package/build/executor/git/types.js

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