@agent-native/core 0.121.1 → 0.122.0

package/dist/cli/template-baseline.js

@@ -0,0 +1,334 @@
+/**
+ * Baseline store for `agent-native template`.
+ *
+ * A baseline is the pristine upstream tree an app was generated from — the
+ * "base" side of the 3-way merge. It is stored as a git ref under
+ * `refs/agent-native/template-baseline/<app-path>` so it never shows up as
+ * working-tree files, and as a gzipped tar under `.agent-native/` only when
+ * the app is not inside a git repository at all.
+ *
+ * Every git operation here is plumbing driven by a throwaway `GIT_INDEX_FILE`
+ * and an out-of-tree `--work-tree`. Nothing in this file may move HEAD, touch
+ * the user's index, or write into their working tree.
+ */
+import { execFileSync } from "node:child_process";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+const REF_NAMESPACE = "refs/agent-native";
+const GIT_IDENTITY = {
+    GIT_AUTHOR_NAME: "agent-native",
+    GIT_AUTHOR_EMAIL: "noreply@agent-native.com",
+    GIT_COMMITTER_NAME: "agent-native",
+    GIT_COMMITTER_EMAIL: "noreply@agent-native.com",
+};
+export function resolveBaselineStore(appDir) {
+    // git reports realpaths; comparing against a symlinked temp path (macOS
+    // /var → /private/var) would compute a nonsense repo-relative prefix.
+    const resolved = realpath(path.resolve(appDir));
+    const gitDir = findGitDir(resolved);
+    const repoRoot = gitDir ? findRepoRoot(resolved) : null;
+    const prefix = repoRoot && repoRoot !== resolved
+        ? path.relative(repoRoot, resolved).split(path.sep).join("/")
+        : "";
+    return {
+        appDir: resolved,
+        gitDir,
+        repoRoot,
+        prefix,
+        slug: sanitizeRefPath(prefix || path.basename(resolved)),
+    };
+}
+export function baselineRefName(store, slot) {
+    return `${REF_NAMESPACE}/template-${slot}/${store.slug}`;
+}
+export function baselineTarballPath(store, slot) {
+    return path.join(store.appDir, ".agent-native", `template-${slot}`, `${path.basename(store.appDir)}.tar.gz`);
+}
+export function baselineExists(store, slot) {
+    if (store.gitDir)
+        return revParse(store, baselineRefName(store, slot)) !== null;
+    return fs.existsSync(baselineTarballPath(store, slot));
+}
+export function baselineDescription(store, slot) {
+    if (!store.gitDir) {
+        const file = baselineTarballPath(store, slot);
+        return fs.existsSync(file) ? file : null;
+    }
+    const ref = baselineRefName(store, slot);
+    const commit = revParse(store, ref);
+    if (!commit)
+        return null;
+    const subject = git(store, ["log", "-1", "--format=%s", commit]).trim();
+    return `${ref} (${commit.slice(0, 12)}) ${subject}`;
+}
+/**
+ * Snapshot `sourceDir` into the baseline store. Writes through a temporary
+ * index and an out-of-tree work-tree so HEAD, the real index, and the working
+ * tree are untouched.
+ */
+export function writeBaseline(store, sourceDir, slot, meta) {
+    if (!store.gitDir) {
+        const file = baselineTarballPath(store, slot);
+        fs.mkdirSync(path.dirname(file), { recursive: true });
+        execFileSync("tar", ["-czf", file, "-C", sourceDir, "."], {
+            stdio: "pipe",
+        });
+        return { kind: "tarball", location: file, configuredRefspecs: [] };
+    }
+    const stage = fs.mkdtempSync(path.join(os.tmpdir(), "an-template-baseline-"));
+    try {
+        const stageRoot = path.join(stage, "tree");
+        const target = store.prefix
+            ? path.join(stageRoot, ...store.prefix.split("/"))
+            : stageRoot;
+        fs.mkdirSync(target, { recursive: true });
+        copyPlainTree(sourceDir, target);
+        const indexFile = path.join(stage, "index");
+        const env = { ...process.env, ...GIT_IDENTITY, GIT_INDEX_FILE: indexFile };
+        // --force: the app's own .gitignore lives inside the staged tree and would
+        // otherwise drop scaffolded files from the baseline.
+        git(store, ["--work-tree", stageRoot, "add", "-A", "--force", "."], {
+            cwd: stageRoot,
+            env,
+        });
+        const tree = git(store, ["write-tree"], { cwd: stageRoot, env }).trim();
+        const ref = baselineRefName(store, slot);
+        const parent = revParse(store, ref);
+        const message = [
+            `agent-native template ${slot}: ${meta.template}`,
+            "",
+            `template: ${meta.template}`,
+            `templateRef: ${meta.templateRef}`,
+            `coreVersion: ${meta.coreVersion ?? "unknown"}`,
+            `path: ${store.prefix || "."}`,
+        ].join("\n");
+        const commit = git(store, ["commit-tree", tree, ...(parent ? ["-p", parent] : []), "-m", message], { cwd: stageRoot, env }).trim();
+        git(store, ["update-ref", ref, commit, ...(parent ? [parent] : [])]);
+        return {
+            kind: "git-ref",
+            location: ref,
+            commit,
+            configuredRefspecs: parent ? [] : ensureBaselineRefspecs(store),
+        };
+    }
+    finally {
+        fs.rmSync(stage, { recursive: true, force: true });
+    }
+}
+/** Point `slot` at whatever `from` currently points at. */
+export function promoteBaseline(store, from, to) {
+    if (!store.gitDir) {
+        const src = baselineTarballPath(store, from);
+        if (!fs.existsSync(src))
+            return false;
+        const dst = baselineTarballPath(store, to);
+        fs.mkdirSync(path.dirname(dst), { recursive: true });
+        fs.copyFileSync(src, dst);
+        fs.rmSync(src, { force: true });
+        return true;
+    }
+    const commit = revParse(store, baselineRefName(store, from));
+    if (!commit)
+        return false;
+    git(store, ["update-ref", baselineRefName(store, to), commit]);
+    git(store, ["update-ref", "-d", baselineRefName(store, from)]);
+    return true;
+}
+export function clearBaseline(store, slot) {
+    if (!store.gitDir) {
+        fs.rmSync(baselineTarballPath(store, slot), { force: true });
+        return;
+    }
+    if (revParse(store, baselineRefName(store, slot))) {
+        git(store, ["update-ref", "-d", baselineRefName(store, slot)]);
+    }
+}
+/**
+ * Extract a stored baseline into a fresh temp directory whose root is the app
+ * root. Returns null when the slot is empty. Callers own the returned dir.
+ */
+export function materializeBaseline(store, slot) {
+    const out = fs.mkdtempSync(path.join(os.tmpdir(), "an-template-base-"));
+    try {
+        if (!store.gitDir) {
+            const file = baselineTarballPath(store, slot);
+            if (!fs.existsSync(file)) {
+                fs.rmSync(out, { recursive: true, force: true });
+                return null;
+            }
+            execFileSync("tar", ["-xzf", file, "-C", out], { stdio: "pipe" });
+            return out;
+        }
+        const ref = baselineRefName(store, slot);
+        if (!revParse(store, ref)) {
+            fs.rmSync(out, { recursive: true, force: true });
+            return null;
+        }
+        const tarPath = path.join(out, ".baseline.tar");
+        const args = ["archive", "--format=tar", "-o", tarPath, ref];
+        if (store.prefix)
+            args.push("--", store.prefix);
+        git(store, args);
+        const strip = store.prefix ? store.prefix.split("/").length : 0;
+        execFileSync("tar", [
+            "-xf",
+            tarPath,
+            "-C",
+            out,
+            ...(strip ? [`--strip-components=${strip}`] : []),
+        ], { stdio: "pipe" });
+        fs.rmSync(tarPath, { force: true });
+        return out;
+    }
+    catch (err) {
+        fs.rmSync(out, { recursive: true, force: true });
+        throw err;
+    }
+}
+/**
+ * Teach the repo's remote to carry `refs/agent-native/*` so baselines survive
+ * clone and push. Returns the refspecs it actually added.
+ */
+export function ensureBaselineRefspecs(store) {
+    if (!store.gitDir)
+        return [];
+    const remotes = git(store, ["remote"])
+        .split("\n")
+        .map((line) => line.trim())
+        .filter(Boolean);
+    if (remotes.length === 0)
+        return [];
+    const remote = remotes.includes("origin") ? "origin" : remotes[0];
+    const spec = "+refs/agent-native/*:refs/agent-native/*";
+    const added = [];
+    for (const key of ["fetch", "push"]) {
+        const existing = gitAllowFail(store, [
+            "config",
+            "--get-all",
+            `remote.${remote}.${key}`,
+        ]);
+        if (existing.split("\n").some((line) => line.trim() === spec))
+            continue;
+        git(store, ["config", "--add", `remote.${remote}.${key}`, spec]);
+        added.push(`remote.${remote}.${key}`);
+    }
+    return added;
+}
+/** Uncommitted changes under the app dir, as porcelain lines. */
+export function appDirtyPaths(store) {
+    if (!store.gitDir)
+        return [];
+    const out = gitAllowFail(store, [
+        "status",
+        "--porcelain",
+        "--",
+        store.prefix || ".",
+    ]);
+    return out
+        .split("\n")
+        .map((line) => line.trim())
+        .filter(Boolean);
+}
+/* ─────────────────────────────────────────────────────────────────────────
+ * Internals
+ * ───────────────────────────────────────────────────────────────────────── */
+function git(store, args, options = {}) {
+    return execFileSync("git", ["--git-dir", store.gitDir, ...args], {
+        // Without an explicit work tree, `--git-dir` makes git treat cwd as the
+        // work-tree root, which turns every sibling path into a phantom deletion.
+        cwd: options.cwd ?? store.repoRoot ?? store.appDir,
+        encoding: "utf-8",
+        env: options.env ?? { ...process.env, ...GIT_IDENTITY },
+        stdio: ["ignore", "pipe", "pipe"],
+        maxBuffer: 256 * 1024 * 1024,
+    });
+}
+function gitAllowFail(store, args) {
+    try {
+        return git(store, args);
+    }
+    catch {
+        return "";
+    }
+}
+function revParse(store, ref) {
+    if (!store.gitDir)
+        return null;
+    const out = gitAllowFail(store, ["rev-parse", "--verify", "--quiet", ref]);
+    return out.trim() || null;
+}
+function realpath(dir) {
+    try {
+        return fs.realpathSync(dir);
+    }
+    catch {
+        return dir;
+    }
+}
+function findGitDir(dir) {
+    try {
+        return execFileSync("git", ["rev-parse", "--absolute-git-dir"], {
+            cwd: dir,
+            encoding: "utf-8",
+            stdio: ["ignore", "pipe", "ignore"],
+        }).trim();
+    }
+    catch {
+        return null;
+    }
+}
+function findRepoRoot(dir) {
+    try {
+        return execFileSync("git", ["rev-parse", "--show-toplevel"], {
+            cwd: dir,
+            encoding: "utf-8",
+            stdio: ["ignore", "pipe", "ignore"],
+        }).trim();
+    }
+    catch {
+        return null;
+    }
+}
+/** Copy regular files and directories only. Symlinks are never part of a
+ *  baseline: they are agent-tool conveniences, not upstream content. */
+function copyPlainTree(src, dest) {
+    fs.mkdirSync(dest, { recursive: true });
+    for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+        if (entry.isSymbolicLink())
+            continue;
+        const from = path.join(src, entry.name);
+        const to = path.join(dest, entry.name);
+        if (entry.isDirectory()) {
+            if (entry.name === ".git")
+                continue;
+            copyPlainTree(from, to);
+        }
+        else if (entry.isFile()) {
+            fs.copyFileSync(from, to);
+        }
+    }
+}
+/** Make each path segment safe for `git check-ref-format`. */
+export function sanitizeRefPath(value) {
+    const segments = value
+        .split("/")
+        .map((segment) => sanitizeRefSegment(segment))
+        .filter(Boolean);
+    return segments.length > 0 ? segments.join("/") : "app";
+}
+function sanitizeRefSegment(segment) {
+    let out = segment
+        // eslint-disable-next-line no-control-regex
+        .replace(/[\u0000-\u0020\u007f~^:?*\[\\]/g, "-")
+        .replace(/\.\.+/g, "-")
+        .replace(/@\{/g, "-");
+    while (out.startsWith("."))
+        out = out.slice(1);
+    while (out.endsWith("."))
+        out = out.slice(0, -1);
+    if (out.endsWith(".lock"))
+        out = `${out.slice(0, -".lock".length)}-lock`;
+    return out;
+}
+//# sourceMappingURL=template-baseline.js.map

package/dist/cli/template-baseline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-baseline.js","sourceRoot":"","sources":["../../src/cli/template-baseline.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Baseline store for `agent-native template`.\n *\n * A baseline is the pristine upstream tree an app was generated from — the\n * \"base\" side of the 3-way merge. It is stored as a git ref under\n * `refs/agent-native/template-baseline/<app-path>` so it never shows up as\n * working-tree files, and as a gzipped tar under `.agent-native/` only when\n * the app is not inside a git repository at all.\n *\n * Every git operation here is plumbing driven by a throwaway `GIT_INDEX_FILE`\n * and an out-of-tree `--work-tree`. Nothing in this file may move HEAD, touch\n * the user's index, or write into their working tree.\n */\nimport { execFileSync } from \"node:child_process\";\nimport fs from \"node:fs\";\nimport os from \"node:os\";\nimport path from \"node:path\";\n\nexport type BaselineSlot = \"baseline\" | \"pending\";\n\nexport interface BaselineStore {\n  appDir: string;\n  /** Absolute `.git` directory, or null when the app is not in a repo. */\n  gitDir: string | null;\n  /** Absolute work-tree root, or null when the app is not in a repo. */\n  repoRoot: string | null;\n  /** Repo-relative posix prefix the app lives at (\"\" when app === repo root). */\n  prefix: string;\n  /** Stable id used in ref names and tarball filenames. */\n  slug: string;\n}\n\nexport interface BaselineWriteMeta {\n  template: string;\n  templateRef: string;\n  coreVersion?: string;\n}\n\nexport interface BaselineWriteResult {\n  kind: \"git-ref\" | \"tarball\";\n  /** Ref name or tarball path. */\n  location: string;\n  /** Commit sha for git refs. */\n  commit?: string;\n  configuredRefspecs: string[];\n}\n\nconst REF_NAMESPACE = \"refs/agent-native\";\nconst GIT_IDENTITY = {\n  GIT_AUTHOR_NAME: \"agent-native\",\n  GIT_AUTHOR_EMAIL: \"noreply@agent-native.com\",\n  GIT_COMMITTER_NAME: \"agent-native\",\n  GIT_COMMITTER_EMAIL: \"noreply@agent-native.com\",\n};\n\nexport function resolveBaselineStore(appDir: string): BaselineStore {\n  // git reports realpaths; comparing against a symlinked temp path (macOS\n  // /var → /private/var) would compute a nonsense repo-relative prefix.\n  const resolved = realpath(path.resolve(appDir));\n  const gitDir = findGitDir(resolved);\n  const repoRoot = gitDir ? findRepoRoot(resolved) : null;\n  const prefix =\n    repoRoot && repoRoot !== resolved\n      ? path.relative(repoRoot, resolved).split(path.sep).join(\"/\")\n      : \"\";\n  return {\n    appDir: resolved,\n    gitDir,\n    repoRoot,\n    prefix,\n    slug: sanitizeRefPath(prefix || path.basename(resolved)),\n  };\n}\n\nexport function baselineRefName(\n  store: BaselineStore,\n  slot: BaselineSlot,\n): string {\n  return `${REF_NAMESPACE}/template-${slot}/${store.slug}`;\n}\n\nexport function baselineTarballPath(\n  store: BaselineStore,\n  slot: BaselineSlot,\n): string {\n  return path.join(\n    store.appDir,\n    \".agent-native\",\n    `template-${slot}`,\n    `${path.basename(store.appDir)}.tar.gz`,\n  );\n}\n\nexport function baselineExists(\n  store: BaselineStore,\n  slot: BaselineSlot,\n): boolean {\n  if (store.gitDir)\n    return revParse(store, baselineRefName(store, slot)) !== null;\n  return fs.existsSync(baselineTarballPath(store, slot));\n}\n\nexport function baselineDescription(\n  store: BaselineStore,\n  slot: BaselineSlot,\n): string | null {\n  if (!store.gitDir) {\n    const file = baselineTarballPath(store, slot);\n    return fs.existsSync(file) ? file : null;\n  }\n  const ref = baselineRefName(store, slot);\n  const commit = revParse(store, ref);\n  if (!commit) return null;\n  const subject = git(store, [\"log\", \"-1\", \"--format=%s\", commit]).trim();\n  return `${ref} (${commit.slice(0, 12)}) ${subject}`;\n}\n\n/**\n * Snapshot `sourceDir` into the baseline store. Writes through a temporary\n * index and an out-of-tree work-tree so HEAD, the real index, and the working\n * tree are untouched.\n */\nexport function writeBaseline(\n  store: BaselineStore,\n  sourceDir: string,\n  slot: BaselineSlot,\n  meta: BaselineWriteMeta,\n): BaselineWriteResult {\n  if (!store.gitDir) {\n    const file = baselineTarballPath(store, slot);\n    fs.mkdirSync(path.dirname(file), { recursive: true });\n    execFileSync(\"tar\", [\"-czf\", file, \"-C\", sourceDir, \".\"], {\n      stdio: \"pipe\",\n    });\n    return { kind: \"tarball\", location: file, configuredRefspecs: [] };\n  }\n\n  const stage = fs.mkdtempSync(path.join(os.tmpdir(), \"an-template-baseline-\"));\n  try {\n    const stageRoot = path.join(stage, \"tree\");\n    const target = store.prefix\n      ? path.join(stageRoot, ...store.prefix.split(\"/\"))\n      : stageRoot;\n    fs.mkdirSync(target, { recursive: true });\n    copyPlainTree(sourceDir, target);\n\n    const indexFile = path.join(stage, \"index\");\n    const env = { ...process.env, ...GIT_IDENTITY, GIT_INDEX_FILE: indexFile };\n    // --force: the app's own .gitignore lives inside the staged tree and would\n    // otherwise drop scaffolded files from the baseline.\n    git(store, [\"--work-tree\", stageRoot, \"add\", \"-A\", \"--force\", \".\"], {\n      cwd: stageRoot,\n      env,\n    });\n    const tree = git(store, [\"write-tree\"], { cwd: stageRoot, env }).trim();\n\n    const ref = baselineRefName(store, slot);\n    const parent = revParse(store, ref);\n    const message = [\n      `agent-native template ${slot}: ${meta.template}`,\n      \"\",\n      `template: ${meta.template}`,\n      `templateRef: ${meta.templateRef}`,\n      `coreVersion: ${meta.coreVersion ?? \"unknown\"}`,\n      `path: ${store.prefix || \".\"}`,\n    ].join(\"\\n\");\n    const commit = git(\n      store,\n      [\"commit-tree\", tree, ...(parent ? [\"-p\", parent] : []), \"-m\", message],\n      { cwd: stageRoot, env },\n    ).trim();\n\n    git(store, [\"update-ref\", ref, commit, ...(parent ? [parent] : [])]);\n    return {\n      kind: \"git-ref\",\n      location: ref,\n      commit,\n      configuredRefspecs: parent ? [] : ensureBaselineRefspecs(store),\n    };\n  } finally {\n    fs.rmSync(stage, { recursive: true, force: true });\n  }\n}\n\n/** Point `slot` at whatever `from` currently points at. */\nexport function promoteBaseline(\n  store: BaselineStore,\n  from: BaselineSlot,\n  to: BaselineSlot,\n): boolean {\n  if (!store.gitDir) {\n    const src = baselineTarballPath(store, from);\n    if (!fs.existsSync(src)) return false;\n    const dst = baselineTarballPath(store, to);\n    fs.mkdirSync(path.dirname(dst), { recursive: true });\n    fs.copyFileSync(src, dst);\n    fs.rmSync(src, { force: true });\n    return true;\n  }\n  const commit = revParse(store, baselineRefName(store, from));\n  if (!commit) return false;\n  git(store, [\"update-ref\", baselineRefName(store, to), commit]);\n  git(store, [\"update-ref\", \"-d\", baselineRefName(store, from)]);\n  return true;\n}\n\nexport function clearBaseline(store: BaselineStore, slot: BaselineSlot): void {\n  if (!store.gitDir) {\n    fs.rmSync(baselineTarballPath(store, slot), { force: true });\n    return;\n  }\n  if (revParse(store, baselineRefName(store, slot))) {\n    git(store, [\"update-ref\", \"-d\", baselineRefName(store, slot)]);\n  }\n}\n\n/**\n * Extract a stored baseline into a fresh temp directory whose root is the app\n * root. Returns null when the slot is empty. Callers own the returned dir.\n */\nexport function materializeBaseline(\n  store: BaselineStore,\n  slot: BaselineSlot,\n): string | null {\n  const out = fs.mkdtempSync(path.join(os.tmpdir(), \"an-template-base-\"));\n  try {\n    if (!store.gitDir) {\n      const file = baselineTarballPath(store, slot);\n      if (!fs.existsSync(file)) {\n        fs.rmSync(out, { recursive: true, force: true });\n        return null;\n      }\n      execFileSync(\"tar\", [\"-xzf\", file, \"-C\", out], { stdio: \"pipe\" });\n      return out;\n    }\n\n    const ref = baselineRefName(store, slot);\n    if (!revParse(store, ref)) {\n      fs.rmSync(out, { recursive: true, force: true });\n      return null;\n    }\n    const tarPath = path.join(out, \".baseline.tar\");\n    const args = [\"archive\", \"--format=tar\", \"-o\", tarPath, ref];\n    if (store.prefix) args.push(\"--\", store.prefix);\n    git(store, args);\n    const strip = store.prefix ? store.prefix.split(\"/\").length : 0;\n    execFileSync(\n      \"tar\",\n      [\n        \"-xf\",\n        tarPath,\n        \"-C\",\n        out,\n        ...(strip ? [`--strip-components=${strip}`] : []),\n      ],\n      { stdio: \"pipe\" },\n    );\n    fs.rmSync(tarPath, { force: true });\n    return out;\n  } catch (err) {\n    fs.rmSync(out, { recursive: true, force: true });\n    throw err;\n  }\n}\n\n/**\n * Teach the repo's remote to carry `refs/agent-native/*` so baselines survive\n * clone and push. Returns the refspecs it actually added.\n */\nexport function ensureBaselineRefspecs(store: BaselineStore): string[] {\n  if (!store.gitDir) return [];\n  const remotes = git(store, [\"remote\"])\n    .split(\"\\n\")\n    .map((line) => line.trim())\n    .filter(Boolean);\n  if (remotes.length === 0) return [];\n  const remote = remotes.includes(\"origin\") ? \"origin\" : remotes[0]!;\n  const spec = \"+refs/agent-native/*:refs/agent-native/*\";\n  const added: string[] = [];\n  for (const key of [\"fetch\", \"push\"] as const) {\n    const existing = gitAllowFail(store, [\n      \"config\",\n      \"--get-all\",\n      `remote.${remote}.${key}`,\n    ]);\n    if (existing.split(\"\\n\").some((line) => line.trim() === spec)) continue;\n    git(store, [\"config\", \"--add\", `remote.${remote}.${key}`, spec]);\n    added.push(`remote.${remote}.${key}`);\n  }\n  return added;\n}\n\n/** Uncommitted changes under the app dir, as porcelain lines. */\nexport function appDirtyPaths(store: BaselineStore): string[] {\n  if (!store.gitDir) return [];\n  const out = gitAllowFail(store, [\n    \"status\",\n    \"--porcelain\",\n    \"--\",\n    store.prefix || \".\",\n  ]);\n  return out\n    .split(\"\\n\")\n    .map((line) => line.trim())\n    .filter(Boolean);\n}\n\n/* ─────────────────────────────────────────────────────────────────────────\n * Internals\n * ───────────────────────────────────────────────────────────────────────── */\n\nfunction git(\n  store: BaselineStore,\n  args: string[],\n  options: { cwd?: string; env?: NodeJS.ProcessEnv } = {},\n): string {\n  return execFileSync(\"git\", [\"--git-dir\", store.gitDir!, ...args], {\n    // Without an explicit work tree, `--git-dir` makes git treat cwd as the\n    // work-tree root, which turns every sibling path into a phantom deletion.\n    cwd: options.cwd ?? store.repoRoot ?? store.appDir,\n    encoding: \"utf-8\",\n    env: options.env ?? { ...process.env, ...GIT_IDENTITY },\n    stdio: [\"ignore\", \"pipe\", \"pipe\"],\n    maxBuffer: 256 * 1024 * 1024,\n  });\n}\n\nfunction gitAllowFail(store: BaselineStore, args: string[]): string {\n  try {\n    return git(store, args);\n  } catch {\n    return \"\";\n  }\n}\n\nfunction revParse(store: BaselineStore, ref: string): string | null {\n  if (!store.gitDir) return null;\n  const out = gitAllowFail(store, [\"rev-parse\", \"--verify\", \"--quiet\", ref]);\n  return out.trim() || null;\n}\n\nfunction realpath(dir: string): string {\n  try {\n    return fs.realpathSync(dir);\n  } catch {\n    return dir;\n  }\n}\n\nfunction findGitDir(dir: string): string | null {\n  try {\n    return execFileSync(\"git\", [\"rev-parse\", \"--absolute-git-dir\"], {\n      cwd: dir,\n      encoding: \"utf-8\",\n      stdio: [\"ignore\", \"pipe\", \"ignore\"],\n    }).trim();\n  } catch {\n    return null;\n  }\n}\n\nfunction findRepoRoot(dir: string): string | null {\n  try {\n    return execFileSync(\"git\", [\"rev-parse\", \"--show-toplevel\"], {\n      cwd: dir,\n      encoding: \"utf-8\",\n      stdio: [\"ignore\", \"pipe\", \"ignore\"],\n    }).trim();\n  } catch {\n    return null;\n  }\n}\n\n/** Copy regular files and directories only. Symlinks are never part of a\n *  baseline: they are agent-tool conveniences, not upstream content. */\nfunction copyPlainTree(src: string, dest: string): void {\n  fs.mkdirSync(dest, { recursive: true });\n  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {\n    if (entry.isSymbolicLink()) continue;\n    const from = path.join(src, entry.name);\n    const to = path.join(dest, entry.name);\n    if (entry.isDirectory()) {\n      if (entry.name === \".git\") continue;\n      copyPlainTree(from, to);\n    } else if (entry.isFile()) {\n      fs.copyFileSync(from, to);\n    }\n  }\n}\n\n/** Make each path segment safe for `git check-ref-format`. */\nexport function sanitizeRefPath(value: string): string {\n  const segments = value\n    .split(\"/\")\n    .map((segment) => sanitizeRefSegment(segment))\n    .filter(Boolean);\n  return segments.length > 0 ? segments.join(\"/\") : \"app\";\n}\n\nfunction sanitizeRefSegment(segment: string): string {\n  let out = segment\n    // eslint-disable-next-line no-control-regex\n    .replace(/[\\u0000-\\u0020\\u007f~^:?*\\[\\\\]/g, \"-\")\n    .replace(/\\.\\.+/g, \"-\")\n    .replace(/@\\{/g, \"-\");\n  while (out.startsWith(\".\")) out = out.slice(1);\n  while (out.endsWith(\".\")) out = out.slice(0, -1);\n  if (out.endsWith(\".lock\")) out = `${out.slice(0, -\".lock\".length)}-lock`;\n  return out;\n}\n"]}

package/dist/cli/template-sync.d.ts

@@ -0,0 +1,57 @@
+export interface TemplateIO {
+    out: (message: string) => void;
+    err: (message: string) => void;
+}
+export interface TemplateProvenance {
+    template?: string;
+    frameworkSkills?: string;
+    templateRef?: string;
+    templateSource?: "github" | "bundled" | "local-checkout";
+    coreVersion?: string;
+    shape?: "workspace" | "standalone";
+}
+export interface AppTarget {
+    appDir: string;
+    appName: string;
+    shape: "workspace" | "standalone";
+    workspaceRoot?: string;
+    workspaceCoreName?: string;
+    provenance: TemplateProvenance;
+}
+export interface MaterializeOptions {
+    appName: string;
+    template: string;
+    /** Git ref to fetch from, or null to use the bundled/local template copy. */
+    ref: string | null;
+    shape: "workspace" | "standalone";
+    workspaceRoot?: string;
+    workspaceCoreName?: string;
+    destDir?: string;
+}
+export interface MaterializeResult {
+    dir: string;
+    ref: string;
+    source: "github" | "bundled" | "local-checkout";
+}
+export interface TemplateMergeResult {
+    added: string[];
+    updated: string[];
+    deleted: string[];
+    conflicted: string[];
+    manual: string[];
+    keptLocal: string[];
+}
+/**
+ * Reproduce, in a temp directory, the exact bytes `create` would have written
+ * for this (template, ref, app name, shape, workspace scope).
+ */
+export declare function materializeTemplate(opts: MaterializeOptions): Promise<MaterializeResult>;
+export declare function isMergeExcluded(rel: string): boolean;
+export declare function listMergeableFiles(root: string): Set<string>;
+export declare function mergeTemplateTrees(appDir: string, baseDir: string, theirsDir: string, options?: {
+    dryRun?: boolean;
+}): TemplateMergeResult;
+export declare function readProvenance(appDir: string): TemplateProvenance;
+export declare function resolveTargets(cwd: string, appArg?: string): AppTarget[];
+export declare function runTemplate(args: string[], io?: TemplateIO): Promise<number>;
+//# sourceMappingURL=template-sync.d.ts.map

package/dist/cli/template-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-sync.d.ts","sourceRoot":"","sources":["../../src/cli/template-sync.ts"],"names":[],"mappings":"AA0DA,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AAmBD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,gBAAgB,CAAC;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,WAAW,GAAG,YAAY,CAAC;CACpC;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,WAAW,GAAG,YAAY,CAAC;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,kBAAkB,CAAC;CAChC;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,KAAK,EAAE,WAAW,GAAG,YAAY,CAAC;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,gBAAgB,CAAC;CACjD;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAMD;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,iBAAiB,CAAC,CAsE5B;AAMD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAUpD;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAmB5D;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC,mBAAmB,CAuErB;AA2CD,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,CAOjE;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,CAkCxE;AAyDD,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EAAE,EACd,EAAE,GAAE,UAAsB,GACzB,OAAO,CAAC,MAAM,CAAC,CA2CjB"}