create-cofounder 0.1.2 → 0.1.3

package/README.md

@@ -9,6 +9,8 @@ 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

package/index.js

@@ -13,6 +13,9 @@ 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 });
@@ -122,6 +125,36 @@ 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;

package/package.json

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