@cargo-ai/cdk 1.0.6 → 1.0.8

package/README.md

@@ -51,6 +51,9 @@ no global install:
 npx @cargo-ai/cdk init my-workspace --template full  # every resource type, wired up
 # or: npx @cargo-ai/cdk init my-workspace             # minimal 'blank' template
 # or: npx @cargo-ai/cdk init --list-templates         # see all templates
+# or: npx @cargo-ai/cdk init my-tam --from getcargohq/cargo-cookbooks/signal-based-tam
+#     scaffold from a GitHub source (owner/repo[/folder][@ref]); a cookbook
+#     folder also pulls its required siblings via the repo's cargo.scaffold.json
 cd my-workspace && npm install
 ```
 
@@ -165,49 +168,6 @@ There is one context repo per workspace, so this is a singleton. On deploy it
 writes each changed file into the repo via the runtime — **additive**: files
 added elsewhere (the UI, other tooling) are left in place.
 
-### Unification
-
-A model can declare how it feeds Cargo's unified `Account` / `Contact` /
-`AccountEvent` / `ContactEvent` models. A connector model defaults to its
-integration's built-in mapping (`{ source: "integration" }`), so you only pass
-`unification` to override it or to unify a model the integration doesn't map on
-its own. A `custom` unification maps columns to shared references (`domain`,
-`email`, `linkedinId`, …) and can link a child to its parent by pointing at
-another model handle:
-
-```ts
-import { defineModel } from "@cargo-ai/cdk";
-
-export const accounts = defineModel("accounts", {
-  dataset: warehouse,
-  extractSlug: "runQuery",
-  unification: {
-    source: "custom",
-    type: "account",
-    uniqueColumns: [{ slug: "website", reference: "domain" }],
-  },
-});
-
-export const contacts = defineModel("contacts", {
-  dataset: warehouse,
-  extractSlug: "runQuery",
-  unification: {
-    source: "custom",
-    type: "contact",
-    uniqueColumns: [{ slug: "work_email", reference: "workEmail" }],
-    // link each contact to its unified account — pass the model handle, not a uuid
-    parent: { kind: "model", columnSlug: "account_id", parent: accounts },
-  },
-});
-```
-
-Unification isn't part of the create call, so the CDK applies it with a
-follow-up update once the model exists — including models the deploy adopts.
-Passing a parent handle makes the child depend on the parent, so the parent is
-created first and its uuid is injected. See
-[Unification](https://docs.getcargo.ai/models/unification) for the reference and
-priority rules.
-
 ## Commands
 
 In a scaffolded project, the everyday commands are `npm run` scripts:
@@ -221,7 +181,7 @@ npm run deploy    # create/update resources, write cargo.state.json
 Run any command — including the ones without a script — with `npx @cargo-ai/cdk`:
 
 ```bash
-npx @cargo-ai/cdk init <directory>      # scaffold from a template (--template, --list-templates)
+npx @cargo-ai/cdk init <directory>      # scaffold from a template (--template, --list-templates) or GitHub (--from owner/repo[/folder][@ref])
 npx @cargo-ai/cdk deploy --prune        # also delete resources removed from code
 npx @cargo-ai/cdk deploy --refresh      # re-read live resources, re-apply out-of-band changes
 npx @cargo-ai/cdk refresh               # read-only: report resources that drifted from code

package/build/src/cli/auth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/cli/auth.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,GAAG,EAAkC,MAAM,eAAe,CAAC;AAuBzE,MAAM,MAAM,MAAM,GAAG;IACnB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC,CAAC;AAYF,wBAAgB,SAAS,IAAI,MAAM,CAoBlC;AA4DD,wBAAgB,MAAM,IAAI,GAAG,CAS5B"}
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/cli/auth.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,GAAG,EAAkC,MAAM,eAAe,CAAC;AAuBzE,MAAM,MAAM,MAAM,GAAG;IACnB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC,CAAC;AAYF,wBAAgB,SAAS,IAAI,MAAM,CAqBlC;AAgED,wBAAgB,MAAM,IAAI,GAAG,CAS5B"}

package/build/src/cli/auth.js

@@ -13,7 +13,7 @@ const ORIGIN = { name: "cargo-cdk", version: packageVersion() };
 const DEFAULT_BASE_URL = "https://api.getcargo.io";
 const CREDENTIALS_FILE = join(homedir(), ".config", "cargo-ai", "credentials.json");
 function loadCredentials() {
-    if (!existsSync(CREDENTIALS_FILE))
+    if (existsSync(CREDENTIALS_FILE) === false)
         return undefined;
     try {
         return JSON.parse(readFileSync(CREDENTIALS_FILE, "utf-8"));
@@ -24,21 +24,31 @@ function loadCredentials() {
 }
 // Resolve token / baseUrl / workspace, preferring env over the credentials file.
 export function getConfig() {
-    const credentials = loadCredentials();
+    const loaded = loadCredentials();
+    const credentials = loaded === undefined ? {} : loaded;
     const envToken = process.env["CARGO_API_TOKEN"];
-    const accessToken = envToken !== undefined ? envToken : credentials?.accessToken;
+    const accessToken = envToken !== undefined ? envToken : credentials.accessToken;
     const envUrl = process.env["CARGO_BASE_URL"];
     const baseUrl = envUrl !== undefined
         ? envUrl
-        : credentials?.baseUrl !== undefined
+        : credentials.baseUrl !== undefined
             ? credentials.baseUrl
             : DEFAULT_BASE_URL;
     const envUuid = process.env["CARGO_WORKSPACE_UUID"];
-    const workspaceUuid = envUuid !== undefined ? envUuid : credentials?.workspaceUuid;
+    const workspaceUuid = envUuid !== undefined ? envUuid : credentials.workspaceUuid;
     return { accessToken, baseUrl, workspaceUuid };
 }
 // Tunnel through an HTTP/HTTPS proxy when one is configured via the standard env
 // vars (honoring NO_PROXY); returns undefined otherwise so egress stays direct.
+// The URL's hostname, or "" if it doesn't parse (used only for NO_PROXY matching).
+function safeHostname(url) {
+    try {
+        return new URL(url).hostname;
+    }
+    catch {
+        return "";
+    }
+}
 function getProxyTransport(targetUrl) {
     const getEnv = (...names) => {
         for (const name of names) {
@@ -52,13 +62,7 @@ function getProxyTransport(targetUrl) {
     if (noProxy === "*")
         return undefined;
     if (noProxy !== undefined) {
-        let hostname = "";
-        try {
-            hostname = new URL(targetUrl).hostname;
-        }
-        catch {
-            hostname = "";
-        }
+        const hostname = safeHostname(targetUrl);
         const bypass = noProxy
             .split(",")
             .map((e) => e.trim())

package/build/src/cli/commands/deploy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/deploy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0CzC,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CA0oBN"}
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/deploy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA2CzC,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CA2lBN"}

package/build/src/cli/commands/deploy.js

@@ -17,15 +17,9 @@ export function registerDeployCommands(parent, getApi) {
         if (opts.dir !== undefined)
             process.chdir(opts.dir);
         const root = ".";
-        let result;
-        try {
-            result = await plan(root);
-        }
-        catch (error) {
-            failWith(`Failed to load cdk repo: ${message(error)}`, {
-                code: ExitCodes.InvalidUsage,
-            });
-        }
+        const result = await runOrFail(() => plan(root), (error) => failWith(`Failed to load cdk repo: ${message(error)}`, {
+            code: ExitCodes.InvalidUsage,
+        }));
         if (opts.json === true)
             outputJson(result);
         else
@@ -54,15 +48,9 @@ export function registerDeployCommands(parent, getApi) {
         const runId = newRunId();
         // Load the resource tree ONCE (loadResources resets the registry, so it
         // must not run twice in a process), then reuse the nodes for plan + apply.
-        let nodes;
-        try {
-            nodes = await loadResources(root);
-        }
-        catch (error) {
-            failWith(`Failed to load cdk repo: ${message(error)}`, {
-                code: ExitCodes.InvalidUsage,
-            });
-        }
+        const nodes = await runOrFail(() => loadResources(root), (error) => failWith(`Failed to load cdk repo: ${message(error)}`, {
+            code: ExitCodes.InvalidUsage,
+        }));
         // Hold the state lock for the whole read→plan→apply sequence (not just
         // the apply), so a concurrent run can't rewrite cargo.state.json between
         // our read and our write. --dry-run is read-only, so it skips the lock.
@@ -78,7 +66,7 @@ export function registerDeployCommands(parent, getApi) {
         if (prior !== undefined && prior.workspaceUuid !== workspaceUuid) {
             failWith(`cargo.state.json belongs to workspace ${prior.workspaceUuid}, but the selected workspace is ${workspaceUuid}. Refusing to deploy (would orphan resources).`, { code: ExitCodes.InvalidUsage });
         }
-        const baseState = prior ?? emptyState(workspaceUuid);
+        const baseState = prior !== undefined ? prior : emptyState(workspaceUuid);
         // Build the authenticated client lazily so a plain `--dry-run` stays
         // offline; `--refresh` and the apply both reuse this one instance.
         let apiClient;
@@ -90,47 +78,9 @@ export function registerDeployCommands(parent, getApi) {
         // With --refresh, re-read the live resources and fold out-of-band drift
         // into the state before planning: a resource edited in the UI re-applies
         // (its code-hash is invalidated) and one deleted externally is recreated.
-        let state = baseState;
-        if (opts.refresh === true &&
-            Object.keys(baseState.resources).length > 0) {
-            let drift;
-            try {
-                drift = await detectDrift(baseState, liveReaders(api()));
-            }
-            catch (error) {
-                failWith(`Refresh failed: ${message(error)}`, {
-                    code: ExitCodes.GenericError,
-                });
-            }
-            const modifiedExternally = drift.filter((d) => d.status === "modified");
-            const deletedExternally = drift.filter((d) => d.status === "deleted");
-            const changed = [...modifiedExternally, ...deletedExternally];
-            if (changed.length === 0) {
-                info("Refresh: no out-of-band drift.");
-            }
-            else {
-                info(`Refresh found ${String(changed.length)} drifted resource(s):`);
-                for (const d of modifiedExternally) {
-                    info(`  modified externally: ${d.id}`);
-                }
-                for (const d of deletedExternally) {
-                    info(`  deleted externally: ${d.id}`);
-                }
-                // A resource present in code but deleted in the UI is ambiguous —
-                // an accident to restore, or an intentional removal. Don't silently
-                // recreate it; force the decision unless --recreate-deleted opts in.
-                if (deletedExternally.length > 0 && opts.recreateDeleted !== true) {
-                    failWith(`${String(deletedExternally.length)} resource(s) were deleted outside the CDK ` +
-                        `(${deletedExternally.map((d) => d.id).join(", ")}). Re-run with ` +
-                        `--recreate-deleted to restore them, or remove them from your code if ` +
-                        `the deletion was intentional.`, { code: ExitCodes.InvalidUsage });
-                }
-                // Modified always re-applies; deleted only reconciles (→ recreate)
-                // once the user has opted in above.
-                const effectiveDrift = opts.recreateDeleted === true ? drift : modifiedExternally;
-                state = reconcileDrift(baseState, effectiveDrift);
-            }
-        }
+        const state = opts.refresh === true && Object.keys(baseState.resources).length > 0
+            ? await refreshedState(baseState, opts, api)
+            : baseState;
         const planResult = compile({ nodes, state });
         info(formatPlan(planResult));
         if (planResult.errors.length > 0) {
@@ -150,7 +100,7 @@ export function registerDeployCommands(parent, getApi) {
             }
             return;
         }
-        if (!hasApplyWork && !willPrune) {
+        if (hasApplyWork === false && willPrune === false) {
             if (deletes.length > 0) {
                 info(`${String(deletes.length)} resource(s) in state are no longer in code. Re-run with --prune to remove them.`);
             }
@@ -164,7 +114,7 @@ export function registerDeployCommands(parent, getApi) {
                 ? `Deploy to workspace ${workspaceUuid} and prune ${String(deletes.length)} resource(s)?`
                 : `Deploy to workspace ${workspaceUuid}?`;
             const ok = await confirm(ask);
-            if (!ok)
+            if (ok === false)
                 failWith("Aborted.", { code: ExitCodes.GenericError });
         }
         // Snapshot the pre-deploy state so `cdk rollback` can restore it.
@@ -185,14 +135,11 @@ export function registerDeployCommands(parent, getApi) {
                     spinner.log(`  ${colors.green("✓")} ${event.id} ${colors.dim(done)}`);
                 }
             };
-        let result;
-        try {
-            result = await apply({ nodes, state }, liveExecutors(api()), // throws NotAuthenticated if not logged in
-            (next) => writeState(root, next), liveReaders(api()), // capture a live fingerprint for drift detection
-            onProgress);
-        }
-        catch (error) {
-            spinner?.stop();
+        const result = await runOrFail(() => apply({ nodes, state }, liveExecutors(api()), // throws NotAuthenticated if not logged in
+        (next) => writeState(root, next), liveReaders(api()), // capture a live fingerprint for drift detection
+        onProgress), (error) => {
+            if (spinner !== undefined)
+                spinner.stop();
             appendAudit(root, {
                 runId,
                 at: new Date().toISOString(),
@@ -208,17 +155,11 @@ export function registerDeployCommands(parent, getApi) {
                     hint: "Resources created before the failure were saved to cargo.state.json — fix the error and re-run to continue.",
                 },
             });
-        }
-        spinner?.stop();
-        let pruned = {
-            removed: [],
-            released: [],
-        };
-        if (willPrune) {
-            try {
-                pruned = await removeResources(root, api(), deletes.map((e) => e.id));
-            }
-            catch (error) {
+        });
+        if (spinner !== undefined)
+            spinner.stop();
+        const pruned = willPrune
+            ? await runOrFail(() => removeResources(root, api(), deletes.map((e) => e.id)), (error) => {
                 appendAudit(root, {
                     runId,
                     at: new Date().toISOString(),
@@ -231,8 +172,8 @@ export function registerDeployCommands(parent, getApi) {
                     code: ExitCodes.GenericError,
                     extra: { runId },
                 });
-            }
-        }
+            })
+            : { removed: [], released: [] };
         const created = result.applied.filter((e) => e.change === "create").length;
         const updated = result.applied.filter((e) => e.change === "update").length;
         appendAudit(root, {
@@ -293,15 +234,9 @@ export function registerDeployCommands(parent, getApi) {
             failWith(`cargo.state.json belongs to workspace ${state.workspaceUuid}, not the selected ${workspaceUuid}.`, { code: ExitCodes.InvalidUsage });
         }
         const api = getApi();
-        let drift;
-        try {
-            drift = await detectDrift(state, liveReaders(api));
-        }
-        catch (error) {
-            failWith(`Refresh failed: ${message(error)}`, {
-                code: ExitCodes.GenericError,
-            });
-        }
+        const drift = await runOrFail(() => detectDrift(state, liveReaders(api)), (error) => failWith(`Refresh failed: ${message(error)}`, {
+            code: ExitCodes.GenericError,
+        }));
         if (opts.json === true) {
             outputJson(drift);
             return;
@@ -339,11 +274,7 @@ export function registerDeployCommands(parent, getApi) {
             failWith(message(error), { code: ExitCodes.GenericError });
         }
         snapshotState(root); // enable `cdk rollback`
-        let result;
-        try {
-            result = await importResource(root, api, workspaceUuid, id, uuid);
-        }
-        catch (error) {
+        const result = await runOrFail(() => importResource(root, api, workspaceUuid, id, uuid), (error) => {
             appendAudit(root, {
                 runId,
                 at: new Date().toISOString(),
@@ -356,7 +287,7 @@ export function registerDeployCommands(parent, getApi) {
                 code: ExitCodes.GenericError,
                 extra: { runId },
             });
-        }
+        });
         appendAudit(root, {
             runId,
             at: new Date().toISOString(),
@@ -384,7 +315,7 @@ export function registerDeployCommands(parent, getApi) {
         const runId = newRunId();
         if (opts.yes !== true) {
             const ok = await confirm("Restore cargo.state.json from the last snapshot? (restores the state file only — not live resources)");
-            if (!ok)
+            if (ok === false)
                 failWith("Aborted.", { code: ExitCodes.GenericError });
         }
         try {
@@ -393,7 +324,7 @@ export function registerDeployCommands(parent, getApi) {
         catch (error) {
             failWith(message(error), { code: ExitCodes.GenericError });
         }
-        if (!restoreSnapshot(root)) {
+        if (restoreSnapshot(root) === false) {
             failWith("No snapshot found (cargo.state.bak.json) — nothing to roll back.", { code: ExitCodes.InvalidUsage });
         }
         appendAudit(root, {
@@ -460,15 +391,11 @@ export function registerDeployCommands(parent, getApi) {
             info(`  - ${id}`);
         if (opts.yes !== true) {
             const ok = await confirm(`Delete these ${String(ids.length)} resource(s)?`);
-            if (!ok)
+            if (ok === false)
                 failWith("Aborted.", { code: ExitCodes.GenericError });
         }
         snapshotState(root); // enable `cdk rollback`
-        let result;
-        try {
-            result = await destroy(root, api, { target: opts.target });
-        }
-        catch (error) {
+        const result = await runOrFail(() => destroy(root, api, { target: opts.target }), (error) => {
             appendAudit(root, {
                 runId,
                 at: new Date().toISOString(),
@@ -484,7 +411,7 @@ export function registerDeployCommands(parent, getApi) {
                     hint: "Resources removed before the failure are gone and dropped from state — re-run to remove the rest.",
                 },
             });
-        }
+        });
         appendAudit(root, {
             runId,
             at: new Date().toISOString(),
@@ -526,6 +453,53 @@ async function resolveWorkspaceUuid(getApi) {
             "Run 'cargo-ai login' or set CARGO_WORKSPACE_UUID.", { code: ExitCodes.NotAuthenticated });
     }
 }
+// Await `op`, routing any failure through `onError` (which never returns —
+// it exits via `failWith`) so the successful result can bind to a `const`
+// instead of a reassigned `let` captured out of a try/catch.
+async function runOrFail(op, onError) {
+    try {
+        return await op();
+    }
+    catch (error) {
+        onError(error);
+    }
+}
+// --refresh: re-read the live resources and fold out-of-band drift into the
+// state before planning. Returns the state to plan against — `baseState`
+// unchanged when there is no actionable drift. Callers gate this behind the
+// refresh flag and a non-empty state.
+async function refreshedState(baseState, opts, api) {
+    const drift = await runOrFail(() => detectDrift(baseState, liveReaders(api())), (error) => failWith(`Refresh failed: ${message(error)}`, {
+        code: ExitCodes.GenericError,
+    }));
+    const modifiedExternally = drift.filter((d) => d.status === "modified");
+    const deletedExternally = drift.filter((d) => d.status === "deleted");
+    const changed = [...modifiedExternally, ...deletedExternally];
+    if (changed.length === 0) {
+        info("Refresh: no out-of-band drift.");
+        return baseState;
+    }
+    info(`Refresh found ${String(changed.length)} drifted resource(s):`);
+    for (const d of modifiedExternally) {
+        info(`  modified externally: ${d.id}`);
+    }
+    for (const d of deletedExternally) {
+        info(`  deleted externally: ${d.id}`);
+    }
+    // A resource present in code but deleted in the UI is ambiguous — an accident
+    // to restore, or an intentional removal. Don't silently recreate it; force the
+    // decision unless --recreate-deleted opts in.
+    if (deletedExternally.length > 0 && opts.recreateDeleted !== true) {
+        failWith(`${String(deletedExternally.length)} resource(s) were deleted outside the CDK ` +
+            `(${deletedExternally.map((d) => d.id).join(", ")}). Re-run with ` +
+            `--recreate-deleted to restore them, or remove them from your code if ` +
+            `the deletion was intentional.`, { code: ExitCodes.InvalidUsage });
+    }
+    // Modified always re-applies; deleted only reconciles (→ recreate) once the
+    // user has opted in above.
+    const effectiveDrift = opts.recreateDeleted === true ? drift : modifiedExternally;
+    return reconcileDrift(baseState, effectiveDrift);
+}
 function message(error) {
     return error instanceof Error ? error.message : String(error);
 }

package/build/src/cli/commands/from.d.ts

@@ -0,0 +1,65 @@
+import { z } from "zod";
+export type FromRef = {
+    owner: string;
+    repo: string;
+    /** Repo-relative folder to scaffold ("" = the whole repo). */
+    subPath: string;
+    /** Branch or tag ("" = the repo's default branch). */
+    gitRef: string;
+};
+/** Reject absolute paths, `..`, `.`, and empty segments in repo-relative paths. */
+export declare function assertSafeRepoRelativePath(repoRelativePath: string, label: string): void;
+/** Join `relativePath` under `baseDir` and ensure the result cannot escape it. */
+export declare function resolveWithin(baseDir: string, relativePath: string): string;
+/**
+ * Parse a `--from` source. Accepts `owner/repo[/sub/path][@ref]`, the same
+ * with a `github.com` / `git@github.com:` prefix, and GitHub tree URLs
+ * (`github.com/owner/repo/tree/<ref>/<sub/path>`). Returns `undefined` when
+ * the source doesn't name a GitHub repo.
+ */
+export declare function parseFromRef(raw: string): FromRef | undefined;
+declare const manifestSchema: z.ZodObject<{
+    shared: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    folders: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        requires: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type ScaffoldManifest = z.infer<typeof manifestSchema>;
+export declare const MANIFEST_FILENAME = "cargo.scaffold.json";
+/** Read and validate `cargo.scaffold.json` at the repo root, if present. */
+export declare function readManifest(repoDir: string): Promise<ScaffoldManifest | undefined>;
+export type CopyPlan = {
+    /** Repo-relative folders to copy, keeping their path under the target. */
+    folders: string[];
+    /** Repo-relative files to copy, keeping their path under the target. */
+    files: string[];
+    /** When true, the single folder's CONTENTS land at the target root. */
+    flatten: boolean;
+};
+/**
+ * Decide what to copy. A manifest-declared folder keeps the repo layout and
+ * brings its transitive `requires` plus the shared root files; anything else
+ * is a flat copy of the requested folder (or the whole repo).
+ */
+export declare function planCopies(manifest: ScaffoldManifest | undefined, subPath: string): CopyPlan;
+/**
+ * Shallow-clone the repo into a temp dir. Returns the dir and its cleanup.
+ * `remoteUrl` overrides the GitHub URL (tests clone from a local repo).
+ */
+export declare function cloneGitHubRepo(ref: FromRef, remoteUrl?: string): Promise<{
+    dir: string;
+    cleanup: () => Promise<void>;
+}>;
+/**
+ * Fetch the source and copy the planned folders/files into `targetDir`,
+ * substituting `__APP_NAME__`. Returns the copied repo-relative paths.
+ */
+export declare function scaffoldFromGitHub(payload: {
+    ref: FromRef;
+    targetDir: string;
+    appName: string;
+    /** Test-only override — clone from this URL/path instead of github.com. */
+    remoteUrl?: string;
+}): Promise<string[]>;
+export {};
+//# sourceMappingURL=from.d.ts.map

package/build/src/cli/commands/from.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"from.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/from.ts"],"names":[],"mappings":"AA2BA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,MAAM,MAAM,OAAO,GAAG;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAIF,mFAAmF;AACnF,wBAAgB,0BAA0B,CACxC,gBAAgB,EAAE,MAAM,EACxB,KAAK,EAAE,MAAM,GACZ,IAAI,CAeN;AAED,kFAAkF;AAClF,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAW3E;AA0BD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAwD7D;AAED,QAAA,MAAM,cAAc;;;;;iBAKlB,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE9D,eAAO,MAAM,iBAAiB,wBAAwB,CAAC;AAqCvD,4EAA4E;AAC5E,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAavC;AAED,MAAM,MAAM,QAAQ,GAAG;IACrB,0EAA0E;IAC1E,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,wEAAwE;IACxE,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,uEAAuE;IACvE,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,gBAAgB,GAAG,SAAS,EACtC,OAAO,EAAE,MAAM,GACd,QAAQ,CAkBV;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,OAAO,EACZ,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC,CA8BxD;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE;IAChD,GAAG,EAAE,OAAO,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAsDpB"}