primitive-admin 1.0.61 → 1.0.63

package/dist/src/lib/init-schema.d.ts

@@ -0,0 +1,74 @@
+import type { Platform } from "./resolve-platform.js";
+/** The canonical schema's path, relative to the project root. */
+export declare const CANONICAL_SCHEMA_RELATIVE: string;
+/**
+ * A POSIX-style relative specifier from `fromDir` to `toFile`, always prefixed
+ * with `./` or `../` — what both an import specifier and a `-i` argument need.
+ */
+export declare function relativeSchemaPath(fromDir: string, toFile: string): string;
+/**
+ * The schema a freshly installed client template ships, or null when it has
+ * none (the Swift starter is comment-only but the file is still there).
+ */
+export declare function findClientSchema(clientDir: string, platform: Platform): string | null;
+/** The Swift target's source directory (`Sources/<AppName>`), if there is one. */
+export declare function findSwiftTargetDir(clientDir: string): string | null;
+/**
+ * The models a schema declares, in the order it declares them.
+ *
+ * `[models.<name>]`, `[models.<name>.fields.<field>]` and the array form all
+ * name the same model; the loader treats the first path segment after `models`
+ * as the model name, and so does this.
+ */
+export declare function declaredModelNames(toml: string): string[];
+/**
+ * The app's one schema has to declare every model its clients read.
+ *
+ * A client's template ships both a starter schema and code generated from it —
+ * the web template's store reads `UserPref`, and the model generator refuses a
+ * schema with no models at all. So composing the shared schema is not "pick a
+ * starter": it is the base schema (an existing client's, when one is being
+ * promoted) PLUS every model a client being added declares and the base does
+ * not. Nothing is ever overwritten — a model the base already declares is the
+ * app's definition of it, and stays exactly as it is.
+ */
+export declare function composeSchemaContent(input: {
+    /** The schema the app already has, or the one being promoted to the root. */
+    base: string;
+    /** The starter schemas of the clients this run is adding. */
+    starters: string[];
+}): {
+    content: string;
+    added: string[];
+};
+/** What `wireClientToSchema` actually rewrote, for the caller to report. */
+export interface SchemaWiringResult {
+    /** Files rewritten or created so this client reads the shared schema. */
+    rewired: string[];
+    /** The client-local schema copy that was removed, if any. */
+    removed?: string;
+    /** Set when the client's shape was not recognized and nothing was rewired. */
+    error?: string;
+}
+/**
+ * Points one client at the shared schema and drops its own copy.
+ *
+ * Writes the new wiring BEFORE removing the client-local schema, so a failure
+ * leaves a client that still has a schema rather than one with neither.
+ */
+export declare function wireClientToSchema(clientDir: string, platform: Platform, schemaPath: string): SchemaWiringResult;
+/**
+ * Why this client cannot be pointed at the shared schema, or null when it can.
+ *
+ * Separate from the wiring itself because the answer decides whether the run
+ * happens at all: a client that keeps its own schema while the app has another
+ * is the two-copies layout the shared schema exists to prevent, so a caller
+ * asks this BEFORE it writes the shared file — before the download, when the
+ * client already exists.
+ */
+export declare function checkClientWiring(clientDir: string, platform: Platform, schemaPath: string): string | null;
+/**
+ * Writes the canonical schema, creating `models/` if needed. Never overwrites:
+ * an existing shared schema is the app's, not this run's.
+ */
+export declare function writeCanonicalSchema(schemaPath: string, content: string): boolean;

package/dist/src/lib/init-schema.js

@@ -0,0 +1,358 @@
+/**
+ * One model schema for one Primitive app, however many clients it has (#2890).
+ *
+ * The schema cannot be duplicated: its TOML keys are the wire field names, so
+ * two copies that drift orphan each other's records. It also must not be a
+ * symlink — that was a way around the generators not reading a schema outside
+ * the client tree, which #2889 fixed. This module is the wiring against that
+ * landed surface:
+ *
+ *   web   — `js-bao-codegen-v2 -i <path to the shared schema> -o src/models`.
+ *           The generated barrel imports the schema it was generated FROM, by a
+ *           relative specifier, so the same file feeds codegen and the runtime
+ *           `loadSchemaFromTomlString` call.
+ *   swift — `bao-codegen.json` at the root of the target's source directory:
+ *           `{ "input": "../../../models/models.toml" }`, resolved against the
+ *           target directory. When present it replaces the plugin's scan of the
+ *           target's own sources, and `scripts/generate-models.sh` (the Xcode
+ *           path) reads the same file.
+ *
+ * Every function here reports what it changed rather than throwing on a shape
+ * it does not recognize, so a caller can say precisely what it did and did not
+ * rewire.
+ */
+import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync, } from "fs";
+import { createHash } from "crypto";
+import { dirname, join, relative, sep } from "path";
+import { retargetXcodePath, xcodePathsLeftBehind } from "./init-xcode.js";
+/** The canonical schema's path, relative to the project root. */
+export const CANONICAL_SCHEMA_RELATIVE = join("models", "models.toml");
+/** Where a freshly scaffolded web client keeps its starter schema. */
+const WEB_SCHEMA_RELATIVE = join("src", "models", "models.toml");
+/** The generated barrel that imports the schema at runtime. */
+const WEB_BARREL_RELATIVE = join("src", "models", "index.ts");
+/** The barrel's schema import, as the generator emits it. */
+const BARREL_SCHEMA_IMPORT = /(import modelsToml from\s+")([^"]+)(\?raw";)/;
+/**
+ * A POSIX-style relative specifier from `fromDir` to `toFile`, always prefixed
+ * with `./` or `../` — what both an import specifier and a `-i` argument need.
+ */
+export function relativeSchemaPath(fromDir, toFile) {
+    const rel = relative(fromDir, toFile).split(sep).join("/");
+    return rel.startsWith(".") ? rel : `./${rel}`;
+}
+/**
+ * The schema a freshly installed client template ships, or null when it has
+ * none (the Swift starter is comment-only but the file is still there).
+ */
+export function findClientSchema(clientDir, platform) {
+    if (platform === "web") {
+        const path = join(clientDir, WEB_SCHEMA_RELATIVE);
+        return existsSync(path) ? path : null;
+    }
+    return findSwiftSchema(clientDir);
+}
+/** `Sources/<AppName>/Models/models.toml`, whatever the app is called. */
+function findSwiftSchema(clientDir) {
+    const sources = join(clientDir, "Sources");
+    let entries;
+    try {
+        entries = readdirSync(sources);
+    }
+    catch {
+        return null;
+    }
+    for (const entry of entries) {
+        const candidate = join(sources, entry, "Models", "models.toml");
+        if (existsSync(candidate))
+            return candidate;
+    }
+    return null;
+}
+/** The Swift target's source directory (`Sources/<AppName>`), if there is one. */
+export function findSwiftTargetDir(clientDir) {
+    const schema = findSwiftSchema(clientDir);
+    if (schema)
+        return dirname(dirname(schema));
+    const sources = join(clientDir, "Sources");
+    try {
+        const dirs = readdirSync(sources, { withFileTypes: true }).filter((e) => e.isDirectory());
+        return dirs.length === 1 ? join(sources, dirs[0].name) : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * The models a schema declares, in the order it declares them.
+ *
+ * `[models.<name>]`, `[models.<name>.fields.<field>]` and the array form all
+ * name the same model; the loader treats the first path segment after `models`
+ * as the model name, and so does this.
+ */
+export function declaredModelNames(toml) {
+    const names = [];
+    for (const match of toml.matchAll(/^\s*\[\[?models\.([A-Za-z0-9_-]+)/gm)) {
+        if (!names.includes(match[1]))
+            names.push(match[1]);
+    }
+    return names;
+}
+/**
+ * Splits a schema into the raw text of each model it declares, keyed by model
+ * name and in declaration order. A model declared by several tables (one per
+ * field, which is how both starters spell it) comes back as one entry, and the
+ * comment lines introducing a table stay with it.
+ */
+function modelSections(toml) {
+    const sections = new Map();
+    let current = null;
+    let pending = "";
+    const append = (model, text) => {
+        sections.set(model, (sections.get(model) ?? "") + text);
+    };
+    for (const line of toml.split("\n")) {
+        const header = line.match(/^\s*\[\[?([A-Za-z0-9_.\-]+)/);
+        if (header) {
+            current = header[1].startsWith("models.")
+                ? header[1].slice("models.".length).split(".")[0]
+                : null;
+            if (current)
+                append(current, `${pending}${line}\n`);
+            pending = "";
+            continue;
+        }
+        // A comment or a blank line introduces whatever comes next as often as it
+        // closes what came before — hold it until the next line says which.
+        if (line.trim() === "" || line.trimStart().startsWith("#")) {
+            pending += `${line}\n`;
+            continue;
+        }
+        if (current)
+            append(current, `${pending}${line}\n`);
+        pending = "";
+    }
+    return sections;
+}
+/**
+ * The app's one schema has to declare every model its clients read.
+ *
+ * A client's template ships both a starter schema and code generated from it —
+ * the web template's store reads `UserPref`, and the model generator refuses a
+ * schema with no models at all. So composing the shared schema is not "pick a
+ * starter": it is the base schema (an existing client's, when one is being
+ * promoted) PLUS every model a client being added declares and the base does
+ * not. Nothing is ever overwritten — a model the base already declares is the
+ * app's definition of it, and stays exactly as it is.
+ */
+export function composeSchemaContent(input) {
+    let content = input.base;
+    const added = [];
+    const declared = declaredModelNames(content);
+    for (const starter of input.starters) {
+        for (const [model, text] of modelSections(starter)) {
+            if (declared.includes(model))
+                continue;
+            declared.push(model);
+            added.push(model);
+            content = `${content.replace(/\n*$/, "\n")}\n${text.replace(/^\n*/, "").replace(/\n*$/, "\n")}`;
+        }
+    }
+    return { content, added };
+}
+/**
+ * Points one client at the shared schema and drops its own copy.
+ *
+ * Writes the new wiring BEFORE removing the client-local schema, so a failure
+ * leaves a client that still has a schema rather than one with neither.
+ */
+export function wireClientToSchema(clientDir, platform, schemaPath) {
+    const blocked = checkClientWiring(clientDir, platform, schemaPath);
+    if (blocked)
+        return { rewired: [], error: blocked };
+    return platform === "web"
+        ? wireWebClient(clientDir, schemaPath)
+        : wireSwiftClient(clientDir, schemaPath);
+}
+/**
+ * Why this client cannot be pointed at the shared schema, or null when it can.
+ *
+ * Separate from the wiring itself because the answer decides whether the run
+ * happens at all: a client that keeps its own schema while the app has another
+ * is the two-copies layout the shared schema exists to prevent, so a caller
+ * asks this BEFORE it writes the shared file — before the download, when the
+ * client already exists.
+ */
+export function checkClientWiring(clientDir, platform, schemaPath) {
+    return platform === "web"
+        ? checkWebWiring(clientDir, schemaPath)
+        : checkSwiftWiring(clientDir, schemaPath);
+}
+function checkWebWiring(clientDir, schemaPath) {
+    const packageJsonPath = join(clientDir, "package.json");
+    if (!existsSync(packageJsonPath)) {
+        return `no package.json in ${clientDir}`;
+    }
+    let pkg;
+    try {
+        pkg = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
+    }
+    catch (err) {
+        return `could not parse ${packageJsonPath}: ${err.message}`;
+    }
+    const codegen = pkg.scripts?.codegen;
+    if (!codegen || !codegen.includes("js-bao-codegen-v2")) {
+        return `no js-bao-codegen-v2 step in ${packageJsonPath}`;
+    }
+    // The generated barrel imports the schema at runtime, so it and the codegen
+    // input have to move together: a barrel whose import this cannot rewrite
+    // would keep naming the copy that gets removed, and the client would fail its
+    // next build on a path with nothing saying the schema moved.
+    const barrelPath = join(clientDir, WEB_BARREL_RELATIVE);
+    const barrel = existsSync(barrelPath) ? readFileSync(barrelPath, "utf-8") : null;
+    if (barrel !== null && !BARREL_SCHEMA_IMPORT.test(barrel)) {
+        return (`${barrelPath} does not import its schema as \`import modelsToml from "…?raw"\`, ` +
+            `so it cannot be pointed at ${schemaPath} — the client keeps its own schema`);
+    }
+    return null;
+}
+function checkSwiftWiring(clientDir, schemaPath) {
+    if (!findSwiftTargetDir(clientDir)) {
+        return `no Sources/<App>/ directory in ${clientDir}`;
+    }
+    // The client's own schema is removed by the wiring, so every Xcode file that
+    // declares it has to be able to name the shared one instead. One that cannot
+    // is the Swift counterpart of an unrewritable barrel: the build reads a path
+    // that is no longer there and reports the path, not the move.
+    const declaredSchema = findSwiftSchema(clientDir);
+    if (declaredSchema && declaredSchema !== schemaPath) {
+        const stranded = xcodePathsLeftBehind(clientDir, relative(clientDir, declaredSchema), relative(clientDir, schemaPath));
+        if (stranded.length > 0) {
+            return (`${stranded.join(", ")} declares ${declaredSchema} as a build input in a form ` +
+                `this cannot point at ${schemaPath} — the client keeps its own schema`);
+        }
+    }
+    return null;
+}
+function wireWebClient(clientDir, schemaPath) {
+    const rewired = [];
+    const packageJsonPath = join(clientDir, "package.json");
+    // The codegen input: `-i src/models/models.toml` -> `-i ../models/models.toml`.
+    const inputSpecifier = relativeSchemaPath(clientDir, schemaPath);
+    const pkg = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
+    const codegen = pkg.scripts.codegen;
+    const barrelPath = join(clientDir, WEB_BARREL_RELATIVE);
+    const barrel = existsSync(barrelPath) ? readFileSync(barrelPath, "utf-8") : null;
+    pkg.scripts.codegen = codegen.replace(/(-i\s+)(\S+)/, (_match, flag) => `${flag}${inputSpecifier}`);
+    writeFileSync(packageJsonPath, `${JSON.stringify(pkg, null, 2)}\n`);
+    rewired.push(packageJsonPath);
+    // Rewriting the barrel's specifier here is exactly what the next
+    // `pnpm codegen` emits, so the scaffold runs before its first codegen and
+    // stays byte-identical after it.
+    if (barrel !== null) {
+        const importSpecifier = relativeSchemaPath(dirname(barrelPath), schemaPath);
+        const rewritten = barrel.replace(BARREL_SCHEMA_IMPORT, `$1${importSpecifier}$3`);
+        if (rewritten !== barrel) {
+            writeFileSync(barrelPath, rewritten);
+            rewired.push(barrelPath);
+        }
+    }
+    // Codegen stamps each generated file with a fingerprint of the schema it read,
+    // and the shared schema is the starter plus a header — a different file, and
+    // so a different fingerprint. Restamping them here is what the next
+    // `pnpm codegen` would write anyway, so the first `pnpm dev` after init leaves
+    // the freshly committed repository clean instead of rewriting its own files.
+    if (existsSync(schemaPath)) {
+        rewired.push(...restampGeneratedFiles(join(clientDir, "src", "models"), readFileSync(schemaPath, "utf-8")));
+    }
+    const localSchema = join(clientDir, WEB_SCHEMA_RELATIVE);
+    let removed;
+    if (existsSync(localSchema) && localSchema !== schemaPath) {
+        rmSync(localSchema);
+        removed = localSchema;
+    }
+    return { rewired, removed };
+}
+/**
+ * Rewrites the `// fingerprint:` line of every generated file in a directory to
+ * the one the generator computes for `schemaContent` (a 16-hex-char SHA-256
+ * prefix — see `fingerprintToml`). Returns the files it changed.
+ */
+function restampGeneratedFiles(modelsDir, schemaContent) {
+    const fingerprint = createHash("sha256")
+        .update(schemaContent, "utf-8")
+        .digest("hex")
+        .slice(0, 16);
+    let entries;
+    try {
+        entries = readdirSync(modelsDir);
+    }
+    catch {
+        return [];
+    }
+    const restamped = [];
+    for (const entry of entries.filter((name) => name.endsWith(".ts"))) {
+        const path = join(modelsDir, entry);
+        const before = readFileSync(path, "utf-8");
+        const after = before.replace(/^\/\/ fingerprint: [0-9a-f]+$/m, `// fingerprint: ${fingerprint}`);
+        if (after === before)
+            continue;
+        writeFileSync(path, after);
+        restamped.push(path);
+    }
+    return restamped;
+}
+function wireSwiftClient(clientDir, schemaPath) {
+    const rewired = [];
+    const targetDir = findSwiftTargetDir(clientDir);
+    // #2889's surface: the plugin (and `scripts/generate-models.sh`) read this
+    // instead of scanning the target's own sources.
+    const configPath = join(targetDir, "bao-codegen.json");
+    const input = relativeSchemaPath(targetDir, schemaPath);
+    mkdirSync(targetDir, { recursive: true });
+    writeFileSync(configPath, `${JSON.stringify({ input }, null, 2)}\n`);
+    rewired.push(configPath);
+    // SwiftPM warns about a file in a target it has no rule for, so the manifest
+    // has to exclude the config it just gained.
+    const manifestPath = join(clientDir, "Package.swift");
+    if (existsSync(manifestPath)) {
+        const manifest = readFileSync(manifestPath, "utf-8");
+        if (!manifest.includes("bao-codegen.json")) {
+            const rewritten = manifest.replace(/exclude:\s*\[([^\]]*)\]/, (_match, inner) => `exclude: [${inner.trim().length > 0 ? `${inner.trimEnd()}, ` : ""}"bao-codegen.json"]`);
+            if (rewritten !== manifest) {
+                writeFileSync(manifestPath, rewritten);
+                rewired.push(manifestPath);
+            }
+        }
+    }
+    // The Xcode pre-build phase declares the schema as its input file, which is
+    // how Xcode knows to re-run codegen when the schema changes. It has to name
+    // the shared file too, or a build reads a path that is no longer there.
+    //
+    // `project.yml` generates the Xcode project, but the project is CHECKED IN
+    // and is what Xcode itself compiles, so the retarget lands in both — an
+    // .xcodeproj still declaring the removed copy fails the build naming a path,
+    // with nothing saying the schema moved.
+    const localSchema = findSwiftSchema(clientDir);
+    if (localSchema) {
+        rewired.push(...retargetXcodePath(clientDir, relative(clientDir, localSchema), relative(clientDir, schemaPath)));
+    }
+    let removed;
+    if (localSchema && localSchema !== schemaPath) {
+        rmSync(localSchema);
+        removed = localSchema;
+    }
+    return { rewired, removed };
+}
+/**
+ * Writes the canonical schema, creating `models/` if needed. Never overwrites:
+ * an existing shared schema is the app's, not this run's.
+ */
+export function writeCanonicalSchema(schemaPath, content) {
+    if (existsSync(schemaPath))
+        return false;
+    mkdirSync(dirname(schemaPath), { recursive: true });
+    writeFileSync(schemaPath, content);
+    return true;
+}
+//# sourceMappingURL=init-schema.js.map

package/dist/src/lib/init-schema.js.map

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

package/dist/src/lib/init-xcode.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Retargets one `$(SRCROOT)`-relative build-phase path, in `project.yml` and in
+ * every checked-in Xcode project. Both spell the path the same way, so one
+ * literal substitution covers the declared inputs and outputs alike.
+ *
+ * Returns the files it rewrote.
+ */
+export declare function retargetXcodePath(clientDir: string, fromRelative: string, toRelative: string): string[];
+/**
+ * The Xcode files that would still name `fromRelative` after `retargetXcodePath`
+ * moved it to `toRelative` — spellings the substitution above does not reach,
+ * such as a path written without the `$(SRCROOT)/` prefix.
+ *
+ * A caller that is about to REMOVE the file at `fromRelative` asks this first:
+ * a project left declaring it has a build input that is not there, and Xcode
+ * reports the path rather than the move that stranded it.
+ */
+export declare function xcodePathsLeftBehind(clientDir: string, fromRelative: string, toRelative: string): string[];
+/**
+ * Points the Xcode build phases at the app's `.primitive/config.json` when it
+ * lives above the client.
+ *
+ * Without this an Xcode build has no readable config: the phase declares
+ * `$(SRCROOT)/.primitive/config.json`, which a composed client does not have,
+ * and the sandbox denies everything undeclared. A fresh clone (where
+ * `primitive.json` is gitignored) then cannot build at all, and a working copy
+ * that still has one keeps whichever environment generated it — so
+ * `primitive env use` would leave Xcode builds on the old backend.
+ *
+ * Returns the files it rewrote; an empty list means the client was already
+ * pointed at its own root (a standalone scaffold) or ships no Xcode project.
+ */
+export declare function declareSharedProjectConfig(clientDir: string, projectRoot: string): string[];

package/dist/src/lib/init-xcode.js

@@ -0,0 +1,114 @@
+/**
+ * The Swift client's Xcode project, when the app it belongs to lives above it
+ * (#2890).
+ *
+ * `project.yml` is the source of truth, but the `.xcodeproj` it generates is
+ * CHECKED IN — that is what Xcode's Run button, a bare `xcodebuild` and a fresh
+ * clone all compile. A composed repository moves two files the Xcode build
+ * phases declare out of the client: the model schema (up to `models/` at the
+ * root) and `.primitive/config.json` (which the whole app shares). Rewriting
+ * only `project.yml` would leave the shipped project declaring paths that are
+ * no longer there — a build input error naming a file, with nothing saying the
+ * schema moved — so every rewrite here lands in both places.
+ *
+ * The declared inputs are also what Xcode's user-script sandbox permits a phase
+ * to READ. Declaring the root config is what lets `resolve-primitive-config.sh`
+ * find it from inside an Xcode build at all.
+ */
+import { existsSync, readFileSync, readdirSync, writeFileSync } from "fs";
+import { join, relative, sep } from "path";
+/** The build phase inputs that name the project config, relative to a client. */
+const PROJECT_CONFIG_INPUTS = [
+    join(".primitive", "config.json"),
+    join(".primitive", "local.json"),
+];
+/** A POSIX-style path from `fromDir` to `toPath`, for a build-setting string. */
+function posixRelative(fromDir, toPath) {
+    return relative(fromDir, toPath).split(sep).join("/");
+}
+/** Every checked-in `project.pbxproj` beside the client's sources. */
+function findPbxprojFiles(clientDir) {
+    let entries;
+    try {
+        entries = readdirSync(clientDir);
+    }
+    catch {
+        return [];
+    }
+    return entries
+        .filter((entry) => entry.endsWith(".xcodeproj"))
+        .map((entry) => join(clientDir, entry, "project.pbxproj"))
+        .filter((path) => existsSync(path));
+}
+/**
+ * Retargets one `$(SRCROOT)`-relative build-phase path, in `project.yml` and in
+ * every checked-in Xcode project. Both spell the path the same way, so one
+ * literal substitution covers the declared inputs and outputs alike.
+ *
+ * Returns the files it rewrote.
+ */
+export function retargetXcodePath(clientDir, fromRelative, toRelative) {
+    const from = `$(SRCROOT)/${fromRelative.split(sep).join("/")}`;
+    const to = `$(SRCROOT)/${toRelative.split(sep).join("/")}`;
+    if (from === to)
+        return [];
+    const rewritten = [];
+    for (const path of [join(clientDir, "project.yml"), ...findPbxprojFiles(clientDir)]) {
+        if (!existsSync(path))
+            continue;
+        const before = readFileSync(path, "utf-8");
+        const after = before.split(from).join(to);
+        if (after === before)
+            continue;
+        writeFileSync(path, after);
+        rewritten.push(path);
+    }
+    return rewritten;
+}
+/**
+ * The Xcode files that would still name `fromRelative` after `retargetXcodePath`
+ * moved it to `toRelative` — spellings the substitution above does not reach,
+ * such as a path written without the `$(SRCROOT)/` prefix.
+ *
+ * A caller that is about to REMOVE the file at `fromRelative` asks this first:
+ * a project left declaring it has a build input that is not there, and Xcode
+ * reports the path rather than the move that stranded it.
+ */
+export function xcodePathsLeftBehind(clientDir, fromRelative, toRelative) {
+    const from = `$(SRCROOT)/${fromRelative.split(sep).join("/")}`;
+    const to = `$(SRCROOT)/${toRelative.split(sep).join("/")}`;
+    if (from === to)
+        return [];
+    const stranded = [];
+    for (const path of [join(clientDir, "project.yml"), ...findPbxprojFiles(clientDir)]) {
+        if (!existsSync(path))
+            continue;
+        const retargeted = readFileSync(path, "utf-8").split(from).join(to);
+        if (retargeted.includes(fromRelative.split(sep).join("/")))
+            stranded.push(path);
+    }
+    return stranded;
+}
+/**
+ * Points the Xcode build phases at the app's `.primitive/config.json` when it
+ * lives above the client.
+ *
+ * Without this an Xcode build has no readable config: the phase declares
+ * `$(SRCROOT)/.primitive/config.json`, which a composed client does not have,
+ * and the sandbox denies everything undeclared. A fresh clone (where
+ * `primitive.json` is gitignored) then cannot build at all, and a working copy
+ * that still has one keeps whichever environment generated it — so
+ * `primitive env use` would leave Xcode builds on the old backend.
+ *
+ * Returns the files it rewrote; an empty list means the client was already
+ * pointed at its own root (a standalone scaffold) or ships no Xcode project.
+ */
+export function declareSharedProjectConfig(clientDir, projectRoot) {
+    const rewritten = [];
+    for (const input of PROJECT_CONFIG_INPUTS) {
+        const target = posixRelative(clientDir, join(projectRoot, input));
+        rewritten.push(...retargetXcodePath(clientDir, input, target));
+    }
+    return rewritten;
+}
+//# sourceMappingURL=init-xcode.js.map

package/dist/src/lib/init-xcode.js.map

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

package/dist/src/lib/integration-request-config.d.ts

@@ -0,0 +1,30 @@
+/**
+ * The CLI's mirror of the server's integration `requestConfig` normalization
+ * (issue #2880, DSO-003).
+ *
+ * `normalizeIntegrationRequestConfig` (`src/services/integration-utils.ts`)
+ * rewrites an accepted request config on the way in: the base URL gains a
+ * single trailing slash, methods are upper-cased and de-duplicated, header and
+ * query lists are trimmed, and the optional keys are materialized. So the state
+ * the server RETURNS is not the text a hand-authored file holds — and comparing
+ * the two raw makes an authored integration read `local-edited` on every run,
+ * with push re-applying the same update forever. Baseline restamping cannot
+ * save it: after an apply the remote hash equals the fresh baseline while the
+ * local hash still does not.
+ *
+ * Mirrored rather than imported: the published CLI must not import server
+ * `src/` at runtime (the same rule the vendored config surfaces follow). The
+ * acceptance fixture pinning this mirror is the tripwire if the server's rule
+ * moves — a disagreement then shows as an ordinary `Modified` row, never a
+ * crash, which is why every step here is total: an input the server would
+ * REJECT (a missing base URL, a bogus method) is left exactly as authored so
+ * the server's own error is what the operator sees.
+ */
+/**
+ * The request config as the server would store it, from what the file says.
+ *
+ * Applied to BOTH sides of the comparison (the remote side reaches it through
+ * the same projection), which is safe because the server's own output is
+ * already canonical and this is idempotent.
+ */
+export declare function canonicalizeIntegrationRequestConfig(input: unknown): any;