@tinycld/bootstrap 1.0.0

package/dist/index.js

@@ -0,0 +1,134 @@
+#!/usr/bin/env node
+import { realpathSync } from 'node:fs';
+import { dirname, relative } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { intro, outro } from '@clack/prompts';
+import pc from 'picocolors';
+import { ArgParseError, parseArgs } from "./args.js";
+import { bootstrapTooling } from "./bootstrap-tooling.js";
+import { copyTemplate, resolveTemplatesRoot } from "./copy-template.js";
+import { detectLayout } from "./layout.js";
+import { offerLinkPackage } from "./link-package.js";
+import { runPrompts } from "./prompts.js";
+export function runToolingMode(opts) {
+    const root = opts.root ?? process.cwd();
+    const present = bootstrapTooling({ ...opts, root });
+    // Mandatory members must clone — a missing app/core means a broken workspace.
+    for (const required of ['app', 'core']) {
+        if (!present.includes(required)) {
+            throw new Error(`Failed to clone required member '${required}'. Check network/auth and retry.`);
+        }
+    }
+    console.log(`Workspace skeleton ready at ${root} (members: ${present.join(', ')})`);
+}
+async function main() {
+    intro(pc.bold(pc.cyan('@tinycld/bootstrap')));
+    let args;
+    try {
+        args = parseArgs(process.argv.slice(2));
+    }
+    catch (err) {
+        if (err instanceof ArgParseError) {
+            console.error(pc.red('Bad arguments:'));
+            for (const issue of err.issues) {
+                console.error(`  --${issue.flag}: ${issue.reason}`);
+            }
+            process.exit(2);
+        }
+        throw err;
+    }
+    if (args.tooling) {
+        runToolingMode({ root: process.cwd(), members: args.with });
+        outro(pc.green(`Tooling-only workspace assembled (app + core${args.with?.length ? `, ${args.with.join(', ')}` : ''}). Run \`npm install\` at the root.`));
+        return;
+    }
+    const answers = await runPrompts(args);
+    copyTemplate(resolveTemplatesRoot(import.meta.url), answers);
+    const linked = await offerLinkPackage({
+        packageName: answers.slug,
+        targetDir: answers.targetDir,
+        mode: resolveLinkMode(args),
+    });
+    const relTarget = relative(process.cwd(), answers.targetDir) || answers.targetDir;
+    outro(pc.green(`Scaffolded ${pc.bold(answers.slug)} at ${pc.bold(relTarget)}`));
+    // Re-derive the layout from the resolved target so the next-steps output
+    // matches whatever path the user actually ended up at (default detection,
+    // explicit --target, or interactive override). The wrapper's parent dir
+    // names where `cd ../tinycld` lands.
+    const layout = detectLayoutFromTarget(answers.targetDir, answers.slug);
+    printNextSteps({ slug: answers.slug, relTarget, linked, layout });
+}
+function detectLayoutFromTarget(targetDir, slug) {
+    // If cwd has a tinycld/ child (workspace mode) and target is a sibling of
+    // that tinycld, we're in attach mode. Otherwise the scaffolder created a
+    // wrapper under cwd and dropped tinycld inside it (bootstrap mode).
+    const detected = detectLayout(slug);
+    if (detected.mode === 'attach' && targetDir === detected.targetDir)
+        return 'attach';
+    if (detected.mode === 'bootstrap' && targetDir === detected.targetDir)
+        return 'bootstrap';
+    // User passed an explicit --target. Infer from the on-disk shape: if the
+    // parent of targetDir has a `tinycld` child, treat as attach.
+    const parent = dirname(targetDir);
+    const looksAttached = detectLayout(slug, parent).mode === 'attach';
+    return looksAttached ? 'attach' : 'bootstrap';
+}
+function resolveLinkMode(args) {
+    if (args.link === false)
+        return 'skip';
+    if (args.link === true)
+        return 'accept';
+    if (args.yes === true)
+        return 'accept';
+    return 'prompt';
+}
+function printNextSteps({ slug, relTarget, linked, layout }) {
+    const lines = ['', pc.bold('Next steps:'), ''];
+    let step = 1;
+    if (layout === 'bootstrap') {
+        // Highlight that the scaffolder also dropped a tinycld checkout
+        // alongside the new package. New users may not realize they just
+        // got a self-contained workspace.
+        lines.push(pc.dim(`  Scaffolded a self-contained workspace alongside the package.\n  The tinycld app shell lives at ./${dirname(relTarget)}/tinycld/.\n`));
+    }
+    lines.push(`  ${pc.dim(`# ${step++}. Initialize git and push to GitHub`)}`);
+    lines.push(`  cd ${relTarget}`);
+    lines.push('  git init');
+    lines.push('  git add .');
+    lines.push("  git commit -m 'chore: initial scaffold'");
+    lines.push(`  gh repo create tinycld/${slug} --public --source=. --push`);
+    lines.push('');
+    if (!linked) {
+        lines.push(`  ${pc.dim(`# ${step++}. Link into the tinycld app shell`)}`);
+        lines.push('  cd ../tinycld');
+        lines.push(`  npm run packages:link ../${slug}`);
+        lines.push('');
+    }
+    lines.push(`  ${pc.dim(`# ${step++}. Verify (biome + tsc run from the app shell and cover the linked package)`)}`);
+    if (linked)
+        lines.push('  cd ../tinycld');
+    lines.push('  npm run checks');
+    lines.push('');
+    lines.push(`  ${pc.dim(`# ${step++}. Run the app (Expo + PocketBase, single-port dev proxy)`)}`);
+    lines.push('  npm run start');
+    lines.push('');
+    console.log(lines.join('\n'));
+}
+function isEntrypoint() {
+    const argv1 = process.argv[1];
+    if (!argv1)
+        return false;
+    try {
+        return import.meta.url === pathToFileURL(realpathSync(argv1)).href;
+    }
+    catch {
+        return false;
+    }
+}
+if (isEntrypoint()) {
+    main().catch((err) => {
+        console.error(pc.red('Error:'), err?.message ?? err);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,MAAM,YAAY,CAAA;AAC3B,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AACpD,OAAO,EAAgC,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACvF,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzC,MAAM,UAAU,cAAc,CAAC,IAA6B;IACxD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAA;IACvC,MAAM,OAAO,GAAG,gBAAgB,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;IACnD,8EAA8E;IAC9E,KAAK,MAAM,QAAQ,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC;QACrC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,oCAAoC,QAAQ,kCAAkC,CAAC,CAAA;QACnG,CAAC;IACL,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,+BAA+B,IAAI,cAAc,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AACvF,CAAC;AAED,KAAK,UAAU,IAAI;IACf,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAA;IAE7C,IAAI,IAAkC,CAAA;IACtC,IAAI,CAAC;QACD,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IAC3C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,IAAI,GAAG,YAAY,aAAa,EAAE,CAAC;YAC/B,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAA;YACvC,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;gBAC7B,OAAO,CAAC,KAAK,CAAC,OAAO,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC,CAAA;YACvD,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACnB,CAAC;QACD,MAAM,GAAG,CAAA;IACb,CAAC;IAED,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,cAAc,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;QAC3D,KAAK,CACD,EAAE,CAAC,KAAK,CACJ,+CACI,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EACtD,qCAAqC,CACxC,CACJ,CAAA;QACD,OAAM;IACV,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,CAAA;IAEtC,YAAY,CAAC,oBAAoB,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAA;IAE5D,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC;QAClC,WAAW,EAAE,OAAO,CAAC,IAAI;QACzB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,IAAI,EAAE,eAAe,CAAC,IAAI,CAAC;KAC9B,CAAC,CAAA;IAEF,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,SAAS,CAAA;IACjF,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAA;IAE/E,yEAAyE;IACzE,0EAA0E;IAC1E,wEAAwE;IACxE,qCAAqC;IACrC,MAAM,MAAM,GAAG,sBAAsB,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;IACtE,cAAc,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;AACrE,CAAC;AAED,SAAS,sBAAsB,CAAC,SAAiB,EAAE,IAAY;IAC3D,0EAA0E;IAC1E,yEAAyE;IACzE,oEAAoE;IACpE,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,CAAA;IACnC,IAAI,QAAQ,CAAC,IAAI,KAAK,QAAQ,IAAI,SAAS,KAAK,QAAQ,CAAC,SAAS;QAAE,OAAO,QAAQ,CAAA;IACnF,IAAI,QAAQ,CAAC,IAAI,KAAK,WAAW,IAAI,SAAS,KAAK,QAAQ,CAAC,SAAS;QAAE,OAAO,WAAW,CAAA;IACzF,yEAAyE;IACzE,8DAA8D;IAC9D,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAA;IACjC,MAAM,aAAa,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAA;IAClE,OAAO,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAA;AACjD,CAAC;AAED,SAAS,eAAe,CAAC,IAAkC;IACvD,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK;QAAE,OAAO,MAAM,CAAA;IACtC,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI;QAAE,OAAO,QAAQ,CAAA;IACvC,IAAI,IAAI,CAAC,GAAG,KAAK,IAAI;QAAE,OAAO,QAAQ,CAAA;IACtC,OAAO,QAAQ,CAAA;AACnB,CAAC;AASD,SAAS,cAAc,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAkB;IACvE,MAAM,KAAK,GAAa,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,EAAE,CAAC,CAAA;IACxD,IAAI,IAAI,GAAG,CAAC,CAAA;IAEZ,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;QACzB,gEAAgE;QAChE,iEAAiE;QACjE,kCAAkC;QAClC,KAAK,CAAC,IAAI,CACN,EAAE,CAAC,GAAG,CACF,sGAAsG,OAAO,CAAC,SAAS,CAAC,cAAc,CACzI,CACJ,CAAA;IACL,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,qCAAqC,CAAC,EAAE,CAAC,CAAA;IAC3E,KAAK,CAAC,IAAI,CAAC,QAAQ,SAAS,EAAE,CAAC,CAAA;IAC/B,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;IACxB,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;IACzB,KAAK,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAA;IACvD,KAAK,CAAC,IAAI,CAAC,4BAA4B,IAAI,6BAA6B,CAAC,CAAA;IACzE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAEd,IAAI,CAAC,MAAM,EAAE,CAAC;QACV,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,mCAAmC,CAAC,EAAE,CAAC,CAAA;QACzE,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA;QAC7B,KAAK,CAAC,IAAI,CAAC,8BAA8B,IAAI,EAAE,CAAC,CAAA;QAChD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAClB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,4EAA4E,CAAC,EAAE,CAAC,CAAA;IAClH,IAAI,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA;IACzC,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAA;IAC9B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAEd,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,0DAA0D,CAAC,EAAE,CAAC,CAAA;IAChG,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA;IAC7B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAEd,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;AACjC,CAAC;AAED,SAAS,YAAY;IACjB,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAC7B,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAA;IACxB,IAAI,CAAC;QACD,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,aAAa,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAA;IACtE,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,KAAK,CAAA;IAChB,CAAC;AACL,CAAC;AAED,IAAI,YAAY,EAAE,EAAE,CAAC;IACjB,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACjB,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,OAAO,IAAI,GAAG,CAAC,CAAA;QACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACnB,CAAC,CAAC,CAAA;AACN,CAAC"}

package/dist/layout.js

@@ -0,0 +1,40 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+const APP_DIR_NAME = 'tinycld';
+export function detectLayout(slug, cwd = process.cwd()) {
+    const candidateApp = join(cwd, APP_DIR_NAME);
+    if (looksLikeAppShell(candidateApp)) {
+        return {
+            mode: 'attach',
+            targetDir: resolve(cwd, slug),
+            appDir: candidateApp,
+        };
+    }
+    const wrapperDir = resolve(cwd, `${APP_DIR_NAME}-${slug}`);
+    return {
+        mode: 'bootstrap',
+        targetDir: join(wrapperDir, slug),
+        appDir: join(wrapperDir, APP_DIR_NAME),
+        wrapperDir,
+    };
+}
+/**
+ * A directory "looks like" the tinycld app shell when it has a package.json
+ * declaring `name: "tinycld"`. The bare directory check would false-match any
+ * unrelated `tinycld` directory; the package.json check is fast (one read of
+ * a file we'd be reading anyway) and unambiguous now that the app shell's
+ * package.json `name` field has been renamed from "@tinycld/app" to "tinycld".
+ */
+export function looksLikeAppShell(dir) {
+    const pkgPath = join(dir, 'package.json');
+    if (!existsSync(pkgPath))
+        return false;
+    try {
+        const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+        return pkg?.name === 'tinycld';
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=layout.js.map

package/dist/layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.js","sourceRoot":"","sources":["../src/layout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAClD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAuBzC,MAAM,YAAY,GAAG,SAAS,CAAA;AAE9B,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,MAAc,OAAO,CAAC,GAAG,EAAE;IAClE,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAA;IAC5C,IAAI,iBAAiB,CAAC,YAAY,CAAC,EAAE,CAAC;QAClC,OAAO;YACH,IAAI,EAAE,QAAQ;YACd,SAAS,EAAE,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC;YAC7B,MAAM,EAAE,YAAY;SACvB,CAAA;IACL,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,YAAY,IAAI,IAAI,EAAE,CAAC,CAAA;IAC1D,OAAO;QACH,IAAI,EAAE,WAAW;QACjB,SAAS,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC;QACjC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC;QACtC,UAAU;KACb,CAAA;AACL,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAW;IACzC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAA;IACzC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAA;IACtC,IAAI,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAA;QACtD,OAAO,GAAG,EAAE,IAAI,KAAK,SAAS,CAAA;IAClC,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,KAAK,CAAA;IAChB,CAAC;AACL,CAAC"}

package/dist/link-core.js

@@ -0,0 +1,99 @@
+import { spawnSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { dirname, join, relative } from 'node:path';
+import { confirm, isCancel, log, spinner } from '@clack/prompts';
+import pc from 'picocolors';
+const CORE_REPO_URL = 'git@github.com:tinycld/core.git';
+const APP_REPO_URL = 'git@github.com:tinycld/tinycld.git';
+const CORE_DIR_NAME = 'core';
+const APP_DIR_NAME = 'tinycld';
+/**
+ * Returns true if the user chose to link (even if a subprocess failed —
+ * the error is already logged, and we don't want to follow up with
+ * "here are the manual steps" when the user already expressed intent).
+ * Returns false only if linking was declined or skipped.
+ *
+ * Linking happens against the tinycld **app shell** (sibling repo
+ * `tinycld/tinycld`), which owns `packages:link`. The `core` library
+ * sibling is also cloned because the app shell installs it via
+ * `file:../core` and the package's tsconfig points at `../core/...`.
+ */
+export async function offerLinkCore({ packageName, targetDir, mode }) {
+    if (mode === 'skip')
+        return false;
+    const parentDir = dirname(targetDir);
+    const coreDir = join(parentDir, CORE_DIR_NAME);
+    const appDir = join(parentDir, APP_DIR_NAME);
+    const coreExists = existsSync(coreDir);
+    const appExists = existsSync(appDir);
+    if (mode === 'prompt') {
+        const missing = [];
+        if (!coreExists)
+            missing.push(CORE_DIR_NAME);
+        if (!appExists)
+            missing.push(APP_DIR_NAME);
+        const prompt = missing.length === 0
+            ? `Link ${pc.bold(packageName)} into ${pc.bold(APP_DIR_NAME)} now?`
+            : `Clone ${pc.bold(missing.join(' + '))} (shallow) and link ${pc.bold(packageName)} into ${pc.bold(APP_DIR_NAME)} now?`;
+        const answer = await confirm({ message: prompt, initialValue: true });
+        if (isCancel(answer) || answer !== true)
+            return false;
+    }
+    if (!coreExists) {
+        if (!cloneRepo(CORE_REPO_URL, coreDir))
+            return true;
+    }
+    else {
+        log.info(`Using existing ${CORE_DIR_NAME} at ${coreDir}`);
+    }
+    if (!appExists) {
+        if (!cloneRepo(APP_REPO_URL, appDir))
+            return true;
+    }
+    else {
+        log.info(`Using existing ${APP_DIR_NAME} at ${appDir}`);
+    }
+    const install = spinner();
+    install.start(`Installing ${APP_DIR_NAME} dependencies (bun install)`);
+    const inst = spawnSync('bun', ['install'], { cwd: appDir, stdio: 'pipe', encoding: 'utf8' });
+    if (inst.status !== 0) {
+        install.stop(pc.red('bun install failed'), 1);
+        log.error(inst.stderr.trim() || 'bun install exited non-zero');
+        return true;
+    }
+    install.stop(`Installed ${APP_DIR_NAME} dependencies`);
+    // packages:link in tinycld takes a sibling-directory locator and reads
+    // the package name from the sibling's package.json. Pass a path relative
+    // to the app shell so the symlink target stays portable.
+    const link = spinner();
+    link.start(`Linking ${packageName}`);
+    const locator = relative(appDir, targetDir) || targetDir;
+    const linkResult = spawnSync('bun', ['run', 'packages:link', locator], {
+        cwd: appDir,
+        stdio: 'pipe',
+        encoding: 'utf8',
+    });
+    if (linkResult.status !== 0) {
+        link.stop(pc.red('Link failed'), 1);
+        log.error(linkResult.stderr.trim() || 'packages:link exited non-zero');
+        return true;
+    }
+    link.stop(`Linked ${packageName} into ${APP_DIR_NAME}`);
+    return true;
+}
+function cloneRepo(url, dest) {
+    const s = spinner();
+    s.start(`Cloning ${url} into ${dest}`);
+    const result = spawnSync('git', ['clone', '--depth', '1', url, dest], {
+        stdio: 'pipe',
+        encoding: 'utf8',
+    });
+    if (result.status !== 0) {
+        s.stop(pc.red('Clone failed'), 1);
+        log.error(result.stderr.trim() || 'git clone exited non-zero');
+        return false;
+    }
+    s.stop(`Cloned ${dest}`);
+    return true;
+}
+//# sourceMappingURL=link-core.js.map

package/dist/link-core.js.map

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

package/dist/link-package.js

@@ -0,0 +1,85 @@
+import { spawnSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { dirname, join, relative } from 'node:path';
+import { confirm, isCancel, log, spinner } from '@clack/prompts';
+import pc from 'picocolors';
+const APP_REPO_URL = 'git@github.com:tinycld/tinycld.git';
+const APP_DIR_NAME = 'tinycld';
+/**
+ * Returns true if the user chose to link (even if a subprocess failed —
+ * the error is already logged, and we don't want to follow up with
+ * "here are the manual steps" when the user already expressed intent).
+ * Returns false only if linking was declined or skipped.
+ *
+ * Linking happens against the tinycld **app shell** (sibling repo
+ * `tinycld/tinycld`), which owns `packages:link` and bundles `@tinycld/core`
+ * at `packages/@tinycld/core/`. This package's tsconfig
+ * (`"@tinycld/core/*": ["../tinycld/packages/@tinycld/core/*"]`) and its Go
+ * server's `replace tinycld.org/core => ../../tinycld/packages/@tinycld/core/server`
+ * directive both resolve into the bundled core inside the app shell.
+ */
+export async function offerLinkPackage({ packageName, targetDir, mode }) {
+    if (mode === 'skip')
+        return false;
+    const parentDir = dirname(targetDir);
+    const appDir = join(parentDir, APP_DIR_NAME);
+    const appExists = existsSync(appDir);
+    if (mode === 'prompt') {
+        const prompt = appExists
+            ? `Link ${pc.bold(packageName)} into ${pc.bold(APP_DIR_NAME)} now?`
+            : `Clone ${pc.bold(APP_DIR_NAME)} (shallow) and link ${pc.bold(packageName)} into it now?`;
+        const answer = await confirm({ message: prompt, initialValue: true });
+        if (isCancel(answer) || answer !== true)
+            return false;
+    }
+    if (!appExists) {
+        if (!cloneRepo(APP_REPO_URL, appDir))
+            return true;
+    }
+    else {
+        log.info(`Using existing ${APP_DIR_NAME} at ${appDir}`);
+    }
+    const install = spinner();
+    install.start(`Installing ${APP_DIR_NAME} dependencies (npm install)`);
+    const inst = spawnSync('npm', ['install'], { cwd: appDir, stdio: 'pipe', encoding: 'utf8' });
+    if (inst.status !== 0) {
+        install.stop(pc.red('npm install failed'), 1);
+        log.error(inst.stderr.trim() || 'npm install exited non-zero');
+        return true;
+    }
+    install.stop(`Installed ${APP_DIR_NAME} dependencies`);
+    // packages:link in tinycld takes a sibling-directory locator and reads
+    // the package name from the sibling's package.json. Pass a path relative
+    // to the app shell so the symlink target stays portable.
+    const link = spinner();
+    link.start(`Linking ${packageName}`);
+    const locator = relative(appDir, targetDir) || targetDir;
+    const linkResult = spawnSync('npm', ['run', 'packages:link', locator], {
+        cwd: appDir,
+        stdio: 'pipe',
+        encoding: 'utf8',
+    });
+    if (linkResult.status !== 0) {
+        link.stop(pc.red('Link failed'), 1);
+        log.error(linkResult.stderr.trim() || 'packages:link exited non-zero');
+        return true;
+    }
+    link.stop(`Linked ${packageName} into ${APP_DIR_NAME}`);
+    return true;
+}
+function cloneRepo(url, dest) {
+    const s = spinner();
+    s.start(`Cloning ${url} into ${dest}`);
+    const result = spawnSync('git', ['clone', '--depth', '1', url, dest], {
+        stdio: 'pipe',
+        encoding: 'utf8',
+    });
+    if (result.status !== 0) {
+        s.stop(pc.red('Clone failed'), 1);
+        log.error(result.stderr.trim() || 'git clone exited non-zero');
+        return false;
+    }
+    s.stop(`Cloned ${dest}`);
+    return true;
+}
+//# sourceMappingURL=link-package.js.map

package/dist/link-package.js.map

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

package/dist/prompts.js

@@ -0,0 +1,187 @@
+import { relative, resolve } from 'node:path';
+import { cancel, confirm, isCancel, select, text } from '@clack/prompts';
+import { detectLayout } from "./layout.js";
+import { validateDescription, validateIcon, validateName, validateNavOrder, validateShortcut, validateSlug, validateTargetDir, } from "./validate.js";
+function cancelIf(value) {
+    if (isCancel(value)) {
+        cancel('Scaffolding cancelled.');
+        process.exit(1);
+    }
+    return value;
+}
+function fail(msg) {
+    cancel(msg);
+    process.exit(1);
+}
+function titleCase(slug) {
+    return slug
+        .split('-')
+        .filter(Boolean)
+        .map((w) => (w[0]?.toUpperCase() ?? '') + w.slice(1))
+        .join(' ');
+}
+export async function runPrompts(argv) {
+    const skipPrompts = argv.yes === true;
+    const slug = await resolveSlug(argv.slug, skipPrompts);
+    const name = await resolveString({
+        argvValue: argv.name,
+        validator: validateName,
+        skipPrompts,
+        defaultValue: titleCase(slug),
+        prompt: {
+            message: 'Human-readable name',
+            initialValue: titleCase(slug),
+        },
+    });
+    const description = await resolveString({
+        argvValue: argv.description,
+        validator: validateDescription,
+        skipPrompts,
+        defaultValue: `${titleCase(slug)} for your organization`,
+        prompt: {
+            message: 'One-sentence description',
+            placeholder: `${titleCase(slug)} for your organization`,
+        },
+    });
+    const preset = await resolvePreset(argv.preset, skipPrompts);
+    const answers = {
+        slug,
+        name,
+        description,
+        preset,
+        targetDir: '',
+    };
+    if (preset === 'full') {
+        answers.icon = await resolveString({
+            argvValue: argv.icon,
+            validator: validateIcon,
+            skipPrompts,
+            defaultValue: 'box',
+            prompt: { message: 'Lucide icon name', placeholder: 'box', initialValue: 'box' },
+        });
+        answers.navOrder = await resolveNavOrder(argv.navOrder, skipPrompts);
+        answers.navShortcut = await resolveString({
+            argvValue: argv.shortcut,
+            validator: validateShortcut,
+            skipPrompts,
+            defaultValue: '',
+            prompt: {
+                message: 'Keyboard shortcut (single letter, blank to skip)',
+                placeholder: '',
+                initialValue: '',
+            },
+        });
+        answers.includeServer = await resolveBool({
+            argvValue: argv.server,
+            skipPrompts,
+            defaultValue: true,
+            prompt: { message: 'Include a Go server?', initialValue: true },
+        });
+    }
+    answers.targetDir = await resolveTarget(argv.target, slug, skipPrompts);
+    return answers;
+}
+async function resolveSlug(fromArgv, skipPrompts) {
+    if (fromArgv) {
+        const err = validateSlug(fromArgv);
+        if (err)
+            fail(`Invalid slug "${fromArgv}": ${err}`);
+        return fromArgv;
+    }
+    if (skipPrompts)
+        fail('Missing slug. Provide it as a positional argument when using --yes.');
+    return cancelIf(await text({
+        message: 'Package slug (kebab-case, e.g. my-feature)',
+        validate: (v) => validateSlug(v) ?? undefined,
+    }));
+}
+async function resolveString({ argvValue, validator, skipPrompts, defaultValue, prompt, }) {
+    if (argvValue !== undefined) {
+        const err = validator(argvValue);
+        if (err)
+            fail(`Invalid ${prompt.message.toLowerCase()}: ${err}`);
+        return argvValue;
+    }
+    if (skipPrompts) {
+        const err = validator(defaultValue);
+        if (err)
+            fail(`Invalid default for ${prompt.message.toLowerCase()}: ${err}`);
+        return defaultValue;
+    }
+    return cancelIf(await text({
+        ...prompt,
+        validate: (v) => validator(v) ?? undefined,
+    }));
+}
+async function resolvePreset(fromArgv, skipPrompts) {
+    if (fromArgv)
+        return fromArgv;
+    if (skipPrompts)
+        return 'full';
+    return cancelIf(await select({
+        message: 'Preset',
+        options: [
+            {
+                value: 'full',
+                label: 'full — data package (routes, collections, migrations, seed, optional Go server)',
+            },
+            {
+                value: 'settings-only',
+                label: 'settings-only — just a settings panel (like @tinycld/google-takeout-import)',
+            },
+        ],
+    }));
+}
+async function resolveNavOrder(fromArgv, skipPrompts) {
+    if (fromArgv !== undefined) {
+        const err = validateNavOrder(String(fromArgv));
+        if (err)
+            fail(`Invalid nav order: ${err}`);
+        return fromArgv;
+    }
+    if (skipPrompts)
+        return 20;
+    const raw = cancelIf(await text({
+        message: 'Nav order (0–99)',
+        initialValue: '20',
+        validate: (v) => validateNavOrder(v) ?? undefined,
+    }));
+    return Number(raw);
+}
+async function resolveBool({ argvValue, skipPrompts, defaultValue, prompt }) {
+    if (argvValue !== undefined)
+        return argvValue;
+    if (skipPrompts)
+        return defaultValue;
+    return cancelIf(await confirm(prompt));
+}
+async function resolveTarget(fromArgv, slug, skipPrompts) {
+    // Explicit --target always wins. The user knows where they want it.
+    if (fromArgv !== undefined) {
+        const abs = resolve(fromArgv);
+        const err = validateTargetDir(abs);
+        if (err)
+            fail(`Invalid target directory: ${err}`);
+        return abs;
+    }
+    // No --target: pick a sensible default based on the cwd's existing layout.
+    // If cwd already has a tinycld/ app shell child, attach the new package
+    // alongside it as `<cwd>/<slug>`. Otherwise bootstrap a wrapper workspace
+    // under `<cwd>/tinycld-<slug>/` and place the package inside it.
+    const layout = detectLayout(slug);
+    const defaultAbs = layout.targetDir;
+    const defaultDisplay = `./${relative(process.cwd(), defaultAbs) || slug}`;
+    if (skipPrompts) {
+        const err = validateTargetDir(defaultAbs);
+        if (err)
+            fail(`Invalid default target directory: ${err}`);
+        return defaultAbs;
+    }
+    const raw = cancelIf(await text({
+        message: 'Target directory',
+        initialValue: defaultDisplay,
+        validate: (v) => validateTargetDir(resolve(v)) ?? undefined,
+    }));
+    return resolve(raw);
+}
+//# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

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

package/dist/substitute.js

@@ -0,0 +1,35 @@
+export function buildPlaceholders(answers) {
+    const slug = answers.slug;
+    return {
+        '{{PKG_SLUG}}': slug,
+        '{{PKG_NAME}}': answers.name,
+        '{{PKG_SCOPED}}': slug, // kept for back-compat; identical to PKG_SLUG
+        '{{PKG_PASCAL}}': toPascalCase(slug),
+        '{{PKG_CAMEL}}': toCamelCase(slug),
+        '{{PKG_SNAKE}}': slug.replace(/-/g, '_'),
+        '{{PKG_DESCRIPTION}}': answers.description,
+        '{{PKG_ICON}}': answers.icon ?? 'box',
+        '{{PKG_NAV_ORDER}}': String(answers.navOrder ?? 20),
+        '{{PKG_NAV_SHORTCUT}}': answers.navShortcut ?? '',
+        '{{GO_MODULE}}': `tinycld.org/packages/${slug}`,
+    };
+}
+export function substitute(content, placeholders) {
+    let out = content;
+    for (const [token, value] of Object.entries(placeholders)) {
+        out = out.replaceAll(token, value);
+    }
+    return out;
+}
+function toPascalCase(slug) {
+    return slug
+        .split('-')
+        .filter(Boolean)
+        .map((part) => (part[0]?.toUpperCase() ?? '') + part.slice(1).toLowerCase())
+        .join('');
+}
+function toCamelCase(slug) {
+    const pascal = toPascalCase(slug);
+    return (pascal[0]?.toLowerCase() ?? '') + pascal.slice(1);
+}
+//# sourceMappingURL=substitute.js.map

package/dist/substitute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"substitute.js","sourceRoot":"","sources":["../src/substitute.ts"],"names":[],"mappings":"AAcA,MAAM,UAAU,iBAAiB,CAAC,OAAgB;IAC9C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAA;IACzB,OAAO;QACH,cAAc,EAAE,IAAI;QACpB,cAAc,EAAE,OAAO,CAAC,IAAI;QAC5B,gBAAgB,EAAE,IAAI,EAAE,8CAA8C;QACtE,gBAAgB,EAAE,YAAY,CAAC,IAAI,CAAC;QACpC,eAAe,EAAE,WAAW,CAAC,IAAI,CAAC;QAClC,eAAe,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC;QACxC,qBAAqB,EAAE,OAAO,CAAC,WAAW;QAC1C,cAAc,EAAE,OAAO,CAAC,IAAI,IAAI,KAAK;QACrC,mBAAmB,EAAE,MAAM,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;QACnD,sBAAsB,EAAE,OAAO,CAAC,WAAW,IAAI,EAAE;QACjD,eAAe,EAAE,wBAAwB,IAAI,EAAE;KAClD,CAAA;AACL,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,OAAe,EAAE,YAA4B;IACpE,IAAI,GAAG,GAAG,OAAO,CAAA;IACjB,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;QACxD,GAAG,GAAG,GAAG,CAAC,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;IACtC,CAAC;IACD,OAAO,GAAG,CAAA;AACd,CAAC;AAED,SAAS,YAAY,CAAC,IAAY;IAC9B,OAAO,IAAI;SACN,KAAK,CAAC,GAAG,CAAC;SACV,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SAC3E,IAAI,CAAC,EAAE,CAAC,CAAA;AACjB,CAAC;AAED,SAAS,WAAW,CAAC,IAAY;IAC7B,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAA;IACjC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;AAC7D,CAAC"}