create-cofounder 0.1.1 → 0.1.3

package/README.md

@@ -8,3 +8,11 @@ npm create cofounder@latest -- --template worktree --setup-codex --yes
 ```
 
 This creates a `.cofounder/` skeleton in the current project and can optionally install the Codex MCP entry.
+
+The `worktree` template requires a Git repository with at least one commit before delegated tasks can run in isolated worktrees.
+
+`npm create` does not install a persistent `cofounder` shell command. For one-off runtime commands:
+
+```bash
+npx -y --package cofounder-crew -- cofounder team
+```

package/index.js

@@ -13,15 +13,18 @@ async function main(argv = process.argv.slice(2)) {
   const template = answers.template ?? "default";
 
   await runCofounder(["init", "--template", template], { inherit: true });
+  if (template === "worktree" && !(await hasGitHead())) {
+    printWorktreePrerequisiteWarning();
+  }
 
   if (answers.setupCodex) {
     await runCofounder(["setup", "codex", "--install"], { inherit: true });
   } else {
     console.log("");
     console.log("Next:");
-    console.log("  cofounder setup codex --install");
-    console.log("  cofounder team");
-    console.log('  cofounder delegate backend "inspect this repo and summarize the API boundaries"');
+    console.log(`  ${formatCofounderCommand(["setup", "codex", "--install"])}`);
+    console.log(`  ${formatCofounderCommand(["team"])}`);
+    console.log(`  ${formatCofounderCommand(["delegate", "backend", "inspect this repo and summarize the API boundaries"])}`);
   }
 }
 
@@ -110,10 +113,55 @@ function resolveCofounderCommand(args) {
 
   return {
     bin: "npx",
-    args: ["-y", "--package", PACKAGE_NAME, "--", "cofounder", ...args]
+    args: resolveNpxCofounderArgs(args)
   };
 }
 
+function resolveNpxCofounderArgs(args) {
+  return ["-y", "--package", PACKAGE_NAME, "--", "cofounder", ...args];
+}
+
+function formatCofounderCommand(args) {
+  return ["npx", ...resolveNpxCofounderArgs(args)].map(quoteShellArg).join(" ");
+}
+
+async function hasGitHead() {
+  return commandSucceeds("git", ["rev-parse", "--verify", "HEAD"]);
+}
+
+async function commandSucceeds(bin, args) {
+  return new Promise((resolve) => {
+    const child = spawn(bin, args, {
+      cwd: process.cwd(),
+      env: process.env,
+      stdio: "ignore"
+    });
+    child.on("error", () => resolve(false));
+    child.on("close", (code) => resolve(code === 0));
+  });
+}
+
+function printWorktreePrerequisiteWarning() {
+  console.log("");
+  console.log("Warning:");
+  console.log("  worktree template needs a Git repository with at least one commit before delegation.");
+  console.log("  Worktrees are created from HEAD, so commit the baseline delegated agents should see.");
+  console.log("");
+  console.log("  For a scratch test:");
+  console.log("    git init");
+  console.log("    git add .");
+  console.log('    git commit -m "chore: initial commit"');
+  console.log("");
+  console.log('  Or use direct mode by setting mode = "direct" under [write] in .cofounder/members/backend/settings.toml.');
+}
+
+function quoteShellArg(value) {
+  if (/^[A-Za-z0-9_./:@%+=,-]+$/.test(value)) {
+    return value;
+  }
+  return `"${value.replaceAll("\\", "\\\\").replaceAll('"', '\\"')}"`;
+}
+
 function validateTemplate(template) {
   if (!template) {
     return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-cofounder",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Initializer for Cofounder Crew projects",
   "type": "module",
   "bin": {