Function runScaffold

packages/core/src/tools/scaffold.ts:186–249

(req: ScaffoldRequest)

}

export async function runScaffold(req: ScaffoldRequest): Promise<ScaffoldResult> {
  let manifest: ScaffoldManifest;
  try {
    manifest = await loadScaffoldManifest(req.scaffoldsRoot);
  } catch (err) {
    const reason = err instanceof Error ? err.message : String(err);
    return { ok: false, reason: `scaffold manifest unavailable: ${reason}` };
  }
  const entry = manifest.scaffolds[req.kind];
  if (!entry) return { ok: false, reason: `unknown scaffold kind: ${req.kind}` };

  const templatesRoot = path.dirname(path.resolve(req.scaffoldsRoot));
  let source: string;
  try {
    const sourceRel = path.relative(templatesRoot, path.resolve(req.scaffoldsRoot, entry.path));
    source = await resolveSafeChildPath(templatesRoot, sourceRel);
  } catch (err) {
    const reason = err instanceof Error ? err.message : String(err);
    return {
      ok: false,
      reason: `scaffold source outside templates root: ${entry.path}: ${reason}`,
    };
  }
  if (!isWithinRoot(templatesRoot, source)) {
    return { ok: false, reason: `scaffold source outside templates root: ${entry.path}` };
  }
  let contents: string;
  try {
    contents = await readFile(source, 'utf8');
  } catch (err) {
    const reason = err instanceof Error ? err.message : String(err);
    return {
      ok: false,
      reason: `scaffold source not found for kind ${req.kind} (${entry.path}): ${reason}`,
    };
  }
  const normalizedContents = normalizeLegacyEditmodeBlock(contents);
  const normalizedEditmode = normalizedContents !== null;
  if (normalizedContents !== null) {
    contents = normalizedContents;
  }

  let dest: string;
  const actualDestPath = destinationPathForSource(req.destPath, source);
  try {
    dest = await resolveSafeChildPath(req.workspaceRoot, actualDestPath);
  } catch (err) {
    const reason = err instanceof Error ? err.message : String(err);
    return {
      ok: false,
      reason: reason.includes('outside root') ? 'destination outside workspace' : reason,
    };
  }
  await mkdir(path.dirname(dest), { recursive: true });
  await writeFile(dest, contents, 'utf8');
  return {
    ok: true,
    destPath: actualDestPath,