create-objectstack 17.1.0 → 17.3.0

package/dist/index.js

@@ -1,9 +1,62 @@
+import {
+  describeEntry,
+  summarizeTree
+} from "./chunk-ZIUW7UEA.js";
+
 // src/index.ts
 import { Command } from "commander";
-import chalk from "chalk";
-import fs4 from "fs";
-import path4 from "path";
+import chalk2 from "chalk";
+import fs5 from "fs";
+import path5 from "path";
+import { execSync as execSync2 } from "child_process";
+
+// src/detect-package-manager.ts
+import fs from "fs";
+import path from "path";
 import { execSync } from "child_process";
+function resolveOnPath(cmd, env = process.env) {
+  const raw = env.PATH ?? "";
+  if (!raw) return null;
+  const exts = process.platform === "win32" ? (env.PATHEXT ?? ".COM;.EXE;.BAT;.CMD").split(";").filter(Boolean) : [""];
+  for (const dir of raw.split(path.delimiter)) {
+    if (!dir) continue;
+    for (const ext of exts) {
+      const candidate = path.join(dir, cmd + ext);
+      try {
+        if (fs.statSync(candidate).isFile()) return candidate;
+      } catch {
+      }
+    }
+  }
+  return null;
+}
+function probeFailureDetail(err) {
+  const e = err ?? {};
+  if (e.signal) return `killed by ${e.signal}`;
+  const stderr = e.stderr == null ? "" : String(e.stderr);
+  const firstLine = stderr.split("\n").map((l) => l.trim()).find((l) => l.length > 0);
+  if (firstLine) return firstLine.length > 200 ? `${firstLine.slice(0, 197)}...` : firstLine;
+  if (typeof e.code === "string") return e.code;
+  if (typeof e.status === "number") return `exited ${e.status}`;
+  const msg = (e.message ?? "").split("\n")[0]?.trim();
+  return msg || "unknown error";
+}
+function defaultProbe() {
+  execSync("pnpm --version", { stdio: ["ignore", "ignore", "pipe"] });
+}
+function detectPackageManager(deps = {}) {
+  const probe = deps.probe ?? defaultProbe;
+  const pnpmOnPath = deps.pnpmOnPath ?? (() => resolveOnPath("pnpm") !== null);
+  try {
+    probe();
+    return { pm: "pnpm", probe: "ok" };
+  } catch (err) {
+    if (!pnpmOnPath()) return { pm: "npm", probe: "absent" };
+    return { pm: "npm", probe: "failed", detail: probeFailureDetail(err) };
+  }
+}
+
+// src/index.ts
 import { fileURLToPath } from "url";
 
 // src/pkg-utils.ts
@@ -20,41 +73,41 @@ function syncObjectStackDeps(pkg, version) {
 }
 
 // src/template-copy.ts
-import fs from "fs";
-import path from "path";
+import fs2 from "fs";
+import path2 from "path";
 var TEMPLATE_FILE_ALIASES = /* @__PURE__ */ new Map([
   ["_gitignore", ".gitignore"]
 ]);
 function copyDir(src, dest, collected, rel = "") {
-  fs.mkdirSync(dest, { recursive: true });
-  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
-    const srcPath = path.join(src, entry.name);
+  fs2.mkdirSync(dest, { recursive: true });
+  for (const entry of fs2.readdirSync(src, { withFileTypes: true })) {
+    const srcPath = path2.join(src, entry.name);
     const outName = entry.isFile() ? TEMPLATE_FILE_ALIASES.get(entry.name) ?? entry.name : entry.name;
-    const destPath = path.join(dest, outName);
+    const destPath = path2.join(dest, outName);
     const relPath = rel ? `${rel}/${outName}` : outName;
     if (entry.isDirectory()) {
       copyDir(srcPath, destPath, collected, relPath);
     } else if (entry.isFile()) {
-      fs.copyFileSync(srcPath, destPath);
+      fs2.copyFileSync(srcPath, destPath);
       collected.push(relPath);
     }
   }
 }
 
 // src/rewrite-identity.ts
-import fs2 from "fs";
-import path2 from "path";
+import fs3 from "fs";
+import path3 from "path";
 var CONFIG_NAMESPACE_RE = /\bnamespace:\s*(['"`])([a-z0-9_]+)\1/i;
 function readTemplateNamespace(targetDir) {
-  const configPath = path2.join(targetDir, "objectstack.config.ts");
-  if (fs2.existsSync(configPath)) {
-    const m = CONFIG_NAMESPACE_RE.exec(fs2.readFileSync(configPath, "utf8"));
+  const configPath = path3.join(targetDir, "objectstack.config.ts");
+  if (fs3.existsSync(configPath)) {
+    const m = CONFIG_NAMESPACE_RE.exec(fs3.readFileSync(configPath, "utf8"));
     if (m) return m[2];
   }
-  const manifestPath = path2.join(targetDir, "objectstack.manifest.json");
-  if (fs2.existsSync(manifestPath)) {
+  const manifestPath = path3.join(targetDir, "objectstack.manifest.json");
+  if (fs3.existsSync(manifestPath)) {
     try {
-      const m = JSON.parse(fs2.readFileSync(manifestPath, "utf8"));
+      const m = JSON.parse(fs3.readFileSync(manifestPath, "utf8"));
       if (typeof m.namespace === "string" && m.namespace) return m.namespace;
     } catch {
     }
@@ -62,9 +115,9 @@ function readTemplateNamespace(targetDir) {
   return void 0;
 }
 function tsFiles(dir, out = []) {
-  if (!fs2.existsSync(dir)) return out;
-  for (const entry of fs2.readdirSync(dir, { withFileTypes: true })) {
-    const full = path2.join(dir, entry.name);
+  if (!fs3.existsSync(dir)) return out;
+  for (const entry of fs3.readdirSync(dir, { withFileTypes: true })) {
+    const full = path3.join(dir, entry.name);
     if (entry.isDirectory()) {
       if (entry.name === "node_modules") continue;
       tsFiles(full, out);
@@ -78,7 +131,7 @@ var namePrefixRe = (ns, flags) => new RegExp(`(\\bname:\\s*)(['"\`])${ns}_([a-z0
 function rewriteObjectNamePrefix(dir, from, to) {
   let rewritten = 0;
   for (const file of tsFiles(dir)) {
-    const before = fs2.readFileSync(file, "utf8");
+    const before = fs3.readFileSync(file, "utf8");
     const after = before.replace(
       namePrefixRe(from, "g"),
       (_m, prefix, q, rest) => {
@@ -86,7 +139,7 @@ function rewriteObjectNamePrefix(dir, from, to) {
         return `${prefix}${q}${to}_${rest}${q}`;
       }
     );
-    if (after !== before) fs2.writeFileSync(file, after);
+    if (after !== before) fs3.writeFileSync(file, after);
   }
   return rewritten;
 }
@@ -94,11 +147,11 @@ function findStaleNamespacePrefixes(dir, oldNs) {
   const re = namePrefixRe(oldNs, "");
   const stale = [];
   for (const file of tsFiles(dir)) {
-    const lines = fs2.readFileSync(file, "utf8").split("\n");
+    const lines = fs3.readFileSync(file, "utf8").split("\n");
     for (let i = 0; i < lines.length; i++) {
       if (re.test(lines[i])) {
         stale.push({
-          file: path2.relative(dir, file),
+          file: path3.relative(dir, file),
           line: i + 1,
           text: lines[i].trim()
         });
@@ -133,13 +186,13 @@ function templateNames() {
 }
 
 // src/runtime-image.ts
-import fs3 from "fs";
-import path3 from "path";
+import fs4 from "fs";
+import path4 from "path";
 var RUNTIME_FROM_RE = /^FROM ghcr\.io\/objectstack-ai\/objectstack:([A-Za-z0-9_][A-Za-z0-9_.+-]*)[ \t]*$/;
 var PINNABLE_VERSION_RE = /^\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.-]+)?$/;
 var PROSE_COMMENT_RE = /^#[ \t]+\S/;
 function readResolvedCliVersion(targetDir) {
-  const pkgPath = path3.join(
+  const pkgPath = path4.join(
     targetDir,
     "node_modules",
     "@objectstack",
@@ -147,7 +200,7 @@ function readResolvedCliVersion(targetDir) {
     "package.json"
   );
   try {
-    const version = JSON.parse(fs3.readFileSync(pkgPath, "utf8")).version;
+    const version = JSON.parse(fs4.readFileSync(pkgPath, "utf8")).version;
     return typeof version === "string" && PINNABLE_VERSION_RE.test(version) ? version : void 0;
   } catch {
     return void 0;
@@ -165,10 +218,10 @@ function pinRuntimeImage(targetDir, version) {
   if (!PINNABLE_VERSION_RE.test(version)) {
     return { pinned: false, reason: `'${version}' is not a pinnable version` };
   }
-  const dockerfile = path3.join(targetDir, "Dockerfile");
+  const dockerfile = path4.join(targetDir, "Dockerfile");
   let text;
   try {
-    text = fs3.readFileSync(dockerfile, "utf8");
+    text = fs4.readFileSync(dockerfile, "utf8");
   } catch {
     return { pinned: false, reason: "no Dockerfile in the scaffolded project" };
   }
@@ -188,14 +241,34 @@ function pinRuntimeImage(targetDir, version) {
   if (!check || check[1] !== version) {
     return { pinned: false, reason: "rewrite did not produce the pinned tag" };
   }
-  fs3.writeFileSync(dockerfile, pinnedText);
+  fs4.writeFileSync(dockerfile, pinnedText);
   return { pinned: true, tag: version };
 }
 
+// src/banner.ts
+import chalk from "chalk";
+var PREFIX = "   \u25C6 Create ObjectStack ";
+var MIN_INNER_WIDTH = 35;
+var MIN_TRAILING_PAD = 3;
+function renderVersionBanner(version) {
+  const versionLabel = `v${version}`;
+  const innerWidth = Math.max(
+    MIN_INNER_WIDTH,
+    PREFIX.length + versionLabel.length + MIN_TRAILING_PAD
+  );
+  const trailingPad = innerWidth - PREFIX.length - versionLabel.length;
+  const border = "\u2550".repeat(innerWidth);
+  return [
+    chalk.bold.cyan(`  \u2554${border}\u2557`),
+    chalk.bold.cyan("  \u2551") + chalk.bold(PREFIX) + chalk.dim(versionLabel) + chalk.bold.cyan(`${" ".repeat(trailingPad)}\u2551`),
+    chalk.bold.cyan(`  \u255A${border}\u255D`)
+  ];
+}
+
 // src/index.ts
 var __filename2 = fileURLToPath(import.meta.url);
-var __dirname2 = path4.dirname(__filename2);
-var BUNDLED_TEMPLATES_DIR = path4.resolve(__dirname2, "templates");
+var __dirname2 = path5.dirname(__filename2);
+var BUNDLED_TEMPLATES_DIR = path5.resolve(__dirname2, "templates");
 function toTitleCase(str) {
   return str.replace(/[-_]/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
 }
@@ -212,44 +285,36 @@ function sanitizeNamespace(name) {
 }
 function readCliVersion() {
   try {
-    const pkgPath = path4.resolve(__dirname2, "..", "package.json");
-    const pkg = JSON.parse(fs4.readFileSync(pkgPath, "utf8"));
+    const pkgPath = path5.resolve(__dirname2, "..", "package.json");
+    const pkg = JSON.parse(fs5.readFileSync(pkgPath, "utf8"));
     return String(pkg.version || "0.0.0");
   } catch {
     return "0.0.0";
   }
 }
 function printHeader(title) {
-  console.log(chalk.bold(`
+  console.log(chalk2.bold(`
 \u25C6 ${title}`));
-  console.log(chalk.dim("\u2500".repeat(40)));
+  console.log(chalk2.dim("\u2500".repeat(40)));
 }
 function printKV(key, value) {
-  console.log(`  ${chalk.dim(key + ":")} ${chalk.white(value)}`);
+  console.log(`  ${chalk2.dim(key + ":")} ${chalk2.white(value)}`);
 }
 function printSuccess(msg) {
-  console.log(chalk.green(`  \u2713 ${msg}`));
+  console.log(chalk2.green(`  \u2713 ${msg}`));
 }
 function printError(msg) {
-  console.log(chalk.red(`  \u2717 ${msg}`));
+  console.log(chalk2.red(`  \u2717 ${msg}`));
 }
 function printStep(msg) {
-  console.log(chalk.yellow(`  \u2192 ${msg}`));
+  console.log(chalk2.yellow(`  \u2192 ${msg}`));
 }
 function printWarning(msg) {
-  console.log(chalk.yellow(`  \u26A0 ${msg}`));
-}
-function detectPackageManager() {
-  try {
-    execSync("pnpm --version", { stdio: "ignore" });
-    return "pnpm";
-  } catch {
-    return "npm";
-  }
+  console.log(chalk2.yellow(`  \u26A0 ${msg}`));
 }
 function loadBundled(templateDir, targetDir) {
-  const src = path4.join(BUNDLED_TEMPLATES_DIR, templateDir);
-  if (!fs4.existsSync(src)) {
+  const src = path5.join(BUNDLED_TEMPLATES_DIR, templateDir);
+  if (!fs5.existsSync(src)) {
     throw new Error(`Bundled template missing on disk: ${src}`);
   }
   const collected = [];
@@ -259,39 +324,39 @@ function loadBundled(templateDir, targetDir) {
 function rewriteProjectIdentity(targetDir, projectName, namespace) {
   const title = toTitleCase(projectName);
   const templateNamespace = readTemplateNamespace(targetDir);
-  const pkgPath = path4.join(targetDir, "package.json");
-  if (fs4.existsSync(pkgPath)) {
+  const pkgPath = path5.join(targetDir, "package.json");
+  if (fs5.existsSync(pkgPath)) {
     try {
-      const pkg = JSON.parse(fs4.readFileSync(pkgPath, "utf8"));
+      const pkg = JSON.parse(fs5.readFileSync(pkgPath, "utf8"));
       pkg.name = projectName;
       syncObjectStackDeps(pkg, readCliVersion());
-      fs4.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
+      fs5.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
     } catch {
     }
   }
-  const manifestPath = path4.join(targetDir, "objectstack.manifest.json");
-  if (fs4.existsSync(manifestPath)) {
+  const manifestPath = path5.join(targetDir, "objectstack.manifest.json");
+  if (fs5.existsSync(manifestPath)) {
     try {
-      const m = JSON.parse(fs4.readFileSync(manifestPath, "utf8"));
+      const m = JSON.parse(fs5.readFileSync(manifestPath, "utf8"));
       m.name = projectName;
       m.displayName = title;
       if ("namespace" in m) m.namespace = namespace;
       delete m.description;
-      fs4.writeFileSync(manifestPath, JSON.stringify(m, null, 2) + "\n");
+      fs5.writeFileSync(manifestPath, JSON.stringify(m, null, 2) + "\n");
     } catch {
     }
   }
-  const configPath = path4.join(targetDir, "objectstack.config.ts");
-  if (fs4.existsSync(configPath)) {
-    let cfg = fs4.readFileSync(configPath, "utf8");
+  const configPath = path5.join(targetDir, "objectstack.config.ts");
+  if (fs5.existsSync(configPath)) {
+    let cfg = fs5.readFileSync(configPath, "utf8");
     cfg = cfg.replace(/(\bid:\s*)(['"`])[^'"`]*\2/, `$1$2${projectName}$2`);
     cfg = cfg.replace(/(\bnamespace:\s*)(['"`])[^'"`]*\2/, `$1$2${namespace}$2`);
     cfg = cfg.replace(/(\bname:\s*)(['"`])[^'"`]*\2/, `$1$2${title}$2`);
     cfg = cfg.replace(/^[ \t]*description:\s*(['"`])[^'"`]*\1,?\r?\n/m, "");
-    fs4.writeFileSync(configPath, cfg);
+    fs5.writeFileSync(configPath, cfg);
   }
   if (templateNamespace && namespace !== templateNamespace) {
-    const srcDir = path4.join(targetDir, "src");
+    const srcDir = path5.join(targetDir, "src");
     rewriteObjectNamePrefix(srcDir, templateNamespace, namespace);
     const stale = findStaleNamespacePrefixes(srcDir, templateNamespace);
     if (stale.length > 0) {
@@ -305,32 +370,75 @@ The generated project would fail 'objectstack build' on the \${namespace}_\${sho
       );
     }
   }
-  const readmePath = path4.join(targetDir, "README.md");
-  if (fs4.existsSync(readmePath)) {
-    let md = fs4.readFileSync(readmePath, "utf8");
+  const readmePath = path5.join(targetDir, "README.md");
+  if (fs5.existsSync(readmePath)) {
+    let md = fs5.readFileSync(readmePath, "utf8");
     md = md.replace(/^#\s+.*$/m, `# ${title}`);
-    fs4.writeFileSync(readmePath, md);
+    fs5.writeFileSync(readmePath, md);
   }
   writeAgentGuides(targetDir, title, projectName);
 }
 function writeAgentGuides(targetDir, title, projectName) {
-  const templatePath = path4.join(BUNDLED_TEMPLATES_DIR, "AGENTS.md");
+  const templatePath = path5.join(BUNDLED_TEMPLATES_DIR, "AGENTS.md");
   let template;
   try {
-    template = fs4.readFileSync(templatePath, "utf8");
+    template = fs5.readFileSync(templatePath, "utf8");
   } catch (err) {
     if (err?.code === "ENOENT") return;
     throw err;
   }
   const rendered = template.replace(/\{\{PROJECT_TITLE\}\}/g, title).replace(/\{\{PROJECT_NAME\}\}/g, projectName);
-  writeIfAbsent(path4.join(targetDir, "AGENTS.md"), rendered);
-  const copilotPath = path4.join(targetDir, ".github", "copilot-instructions.md");
-  fs4.mkdirSync(path4.dirname(copilotPath), { recursive: true });
+  writeIfAbsent(path5.join(targetDir, "AGENTS.md"), rendered);
+  const copilotPath = path5.join(targetDir, ".github", "copilot-instructions.md");
+  fs5.mkdirSync(path5.dirname(copilotPath), { recursive: true });
   writeIfAbsent(copilotPath, rendered);
 }
+function topLevelNames(dir) {
+  try {
+    return new Set(fs5.readdirSync(dir));
+  } catch {
+    return /* @__PURE__ */ new Set();
+  }
+}
+function printCreatedSummary(targetDir, opts) {
+  const entries = summarizeTree(targetDir);
+  if (entries.length === 0) return;
+  console.log(
+    chalk2.bold(opts.wasEmpty ? "  Created files:" : "  Project contents:")
+  );
+  if (!opts.wasEmpty) {
+    console.log(
+      chalk2.dim("    (the directory already had contents; this lists all of it)")
+    );
+  }
+  const isSkillPath = (p) => opts.skillPaths.has(p.split("/")[0]);
+  const width = Math.min(
+    44,
+    Math.max(...entries.map((e) => e.path.length)) + 2
+  );
+  let flagged = false;
+  for (const entry of entries) {
+    const note = describeEntry(entry);
+    const flag = isSkillPath(entry.path);
+    if (flag) flagged = true;
+    const pad = note || flag ? entry.path.padEnd(width) : entry.path;
+    const line = `    + ${pad}${note ? chalk2.dim(note) : ""}`;
+    console.log(chalk2.green(line) + (flag ? chalk2.yellow("  \u26A0 skills") : ""));
+  }
+  if (flagged) {
+    console.log("");
+    console.log(
+      chalk2.yellow("  \u26A0 Skill files run with your coding agent's full permissions.")
+    );
+    console.log(
+      chalk2.dim("    Review the paths marked \u26A0 above before letting an agent use them.")
+    );
+  }
+  console.log("");
+}
 function writeIfAbsent(filePath, contents) {
   try {
-    fs4.writeFileSync(filePath, contents, { flag: "wx" });
+    fs5.writeFileSync(filePath, contents, { flag: "wx" });
   } catch (err) {
     if (err?.code !== "EEXIST") throw err;
   }
@@ -341,65 +449,65 @@ var program = new Command().name("create-objectstack").description("Create a new
   "blank"
 ).option("--skip-install", "Skip dependency installation").option("--skip-skills", "Skip installing ObjectStack AI skills").action((name, options) => {
   console.log("");
-  console.log(chalk.bold.cyan("  \u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557"));
-  console.log(chalk.bold.cyan("  \u2551") + chalk.bold("   \u25C6 Create ObjectStack ") + chalk.dim("v6.x") + chalk.bold.cyan("       \u2551"));
-  console.log(chalk.bold.cyan("  \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D"));
+  for (const line of renderVersionBanner(readCliVersion())) console.log(line);
   printHeader("New Environment");
   const lookup = lookupTemplate(options.template);
   if (lookup.kind !== "found") {
     if (lookup.kind === "retired") {
       printError(`Template "${lookup.name}" has been retired and is no longer available.`);
       console.log(
-        chalk.dim(
+        chalk2.dim(
           "  It was delisted from the ObjectStack template marketplace and is no longer maintained."
         )
       );
     } else {
       printError(`Unknown template: ${lookup.name}`);
     }
-    console.log(chalk.dim(`  Available: ${templateNames().join(", ")}`));
+    console.log(chalk2.dim(`  Available: ${templateNames().join(", ")}`));
     process.exit(1);
   }
   const template = lookup.template;
   const cwd = process.cwd();
-  const projectName = name || path4.basename(cwd);
+  const projectName = name || path5.basename(cwd);
   const namespace = sanitizeNamespace(projectName);
-  const targetDir = name ? path4.resolve(cwd, name) : cwd;
+  const targetDir = name ? path5.resolve(cwd, name) : cwd;
   const isCurrentDir = targetDir === cwd;
+  const detected = detectPackageManager();
+  const pm = detected.pm;
+  if (detected.probe === "failed") {
+    printWarning(
+      `pnpm is installed but \`pnpm --version\` failed (${detected.detail}); using npm as a fallback. The commands below name npm because the probe did not answer, not because this project prefers it.`
+    );
+    console.log("");
+  }
   printKV("Environment", projectName);
   printKV("Namespace", namespace);
   printKV("Template", `${options.template} \u2014 ${template.description}`);
   printKV("Directory", targetDir);
   console.log("");
-  if (!isCurrentDir && fs4.existsSync(targetDir)) {
-    const existing = fs4.readdirSync(targetDir);
+  if (!isCurrentDir && fs5.existsSync(targetDir)) {
+    const existing = fs5.readdirSync(targetDir);
     if (existing.length > 0) {
       printError(`Directory already exists and is not empty: ${targetDir}`);
       process.exit(1);
     }
   }
+  const targetWasEmpty = topLevelNames(targetDir).size === 0;
   try {
-    fs4.mkdirSync(targetDir, { recursive: true });
+    fs5.mkdirSync(targetDir, { recursive: true });
     const createdFiles = loadBundled(template.source.dir, targetDir);
     rewriteProjectIdentity(targetDir, projectName, namespace);
-    console.log(chalk.bold("  Created files:"));
-    for (const f of createdFiles.slice(0, 20)) {
-      console.log(chalk.green(`    + ${f}`));
-    }
-    if (createdFiles.length > 20) {
-      console.log(chalk.dim(`    \u2026 and ${createdFiles.length - 20} more`));
-    }
+    printSuccess(`Template files written (${createdFiles.length})`);
     console.log("");
     if (!options.skipInstall) {
       printStep("Installing dependencies...");
       let installed = false;
       try {
-        const pm = detectPackageManager();
-        execSync(`${pm} install`, { stdio: "inherit", cwd: targetDir });
+        execSync2(`${pm} install`, { stdio: "inherit", cwd: targetDir });
         installed = true;
         console.log("");
       } catch {
-        printWarning("Dependency installation failed. Run `npm install` manually.");
+        printWarning(`Dependency installation failed. Run \`${pm} install\` manually.`);
         console.log("");
       }
       if (installed) {
@@ -417,10 +525,11 @@ var program = new Command().name("create-objectstack").description("Create a new
         }
       }
     }
+    const beforeSkills = topLevelNames(targetDir);
     if (!options.skipInstall && !options.skipSkills) {
       printStep("Installing AI skills for your coding agent...");
       try {
-        execSync("npx -y skills add objectstack-ai/objectstack/skills --all", {
+        execSync2("npx -y skills add objectstack-ai/objectstack/skills --all", {
           stdio: "inherit",
           cwd: targetDir
         });
@@ -432,22 +541,29 @@ var program = new Command().name("create-objectstack").description("Create a new
         console.log("");
       }
     }
+    const skillPaths = new Set(
+      [...topLevelNames(targetDir)].filter((p) => !beforeSkills.has(p))
+    );
+    printCreatedSummary(targetDir, { wasEmpty: targetWasEmpty, skillPaths });
     printSuccess("Environment created!");
     console.log("");
-    console.log(chalk.bold("  Next steps:"));
+    console.log(chalk2.bold("  Next steps:"));
     if (!isCurrentDir) {
-      console.log(chalk.dim(`    cd ${name}`));
+      console.log(chalk2.dim(`    cd ${name}`));
     }
     if (options.skipInstall) {
-      console.log(chalk.dim("    npm install"));
+      console.log(chalk2.dim(`    ${pm} install`));
     }
-    console.log(chalk.dim("    npm run dev           # Start development server"));
-    console.log(chalk.dim("    npm run validate      # Verify metadata: schema + predicates + bindings"));
-    console.log(chalk.dim("                          # (run after every metadata edit \u2014 see AGENTS.md)"));
+    const devLabel = `${pm} run dev`;
+    const validateLabel = `${pm} run validate`;
+    const labelWidth = Math.max(devLabel.length, validateLabel.length) + 3;
+    console.log(chalk2.dim(`    ${devLabel.padEnd(labelWidth)}# Start development server`));
+    console.log(chalk2.dim(`    ${validateLabel.padEnd(labelWidth)}# Verify metadata: schema + predicates + bindings`));
+    console.log(chalk2.dim(`    ${" ".repeat(labelWidth)}# (run after every metadata edit \u2014 see AGENTS.md)`));
     if (options.skipInstall || options.skipSkills) {
       console.log("");
-      console.log(chalk.bold("  AI Skills (recommended):"));
-      console.log(chalk.dim("    npx skills add objectstack-ai/objectstack/skills"));
+      console.log(chalk2.bold("  AI Skills (recommended):"));
+      console.log(chalk2.dim("    npx skills add objectstack-ai/objectstack/skills"));
     }
     console.log("");
   } catch (error) {

package/dist/templates/AGENTS.md

@@ -96,6 +96,6 @@ Skills are triggered automatically based on task context:
 
 ## Learn More
 
-- [ObjectStack Documentation](https://objectstack.com/docs)
+- [ObjectStack Documentation](https://objectstack.ai/docs)
 - [GitHub: objectstack-ai/objectstack](https://github.com/objectstack-ai/objectstack)
 - [Skills CLI](https://skills.sh/) — Manage AI skills across agents

package/dist/templates/blank/Dockerfile

@@ -7,7 +7,7 @@
 #     my-app
 #
 # Or run the full app + Postgres stack: see docker-compose.yml.
-# Docs: https://docs.objectstack.ai/docs/deployment/self-hosting
+# Docs: https://objectstack.ai/docs/deployment/self-hosting
 
 # ── Build stage: compile TypeScript metadata to the artifact ─────────
 FROM node:22-slim AS build
@@ -20,7 +20,7 @@ RUN npx os build              # → dist/objectstack.json
 # ── Runtime: the official ObjectStack runtime image ──────────────────
 # Ships Node + @objectstack/cli with `os start`, a non-root user, the
 # /api/v1/health HEALTHCHECK, and OS_ARTIFACT_PATH/OS_PORT preset (port 8080)
-# — see docker/README.md in the framework repo.
+# — see the self-hosting guide linked above.
 #
 # Dependencies were not installed while scaffolding, so the tag below could
 # not be resolved for you. `latest` floats to whatever release is newest,