jules-orchestrator-kit 0.1.9 → 0.2.9

package/bin/init.js

@@ -3,6 +3,8 @@
 import fs from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
+import { parseArgs } from "node:util";
+import readline from "node:readline/promises";
 import { resolveProjectCommands } from "../scripts/command-resolver.mjs";
 
 const __filename = fileURLToPath(import.meta.url);
@@ -10,8 +12,27 @@ const __dirname = path.dirname(__filename);
 const kitRoot = path.resolve(__dirname, "..");
 const targetDir = process.cwd();
 
-const isHelp = process.argv.includes("--help") || process.argv.includes("-h");
-const isForce = process.argv.includes("--force") || process.argv.includes("-f");
+let isHelp = false;
+let isForce = false;
+let isInteractive = false;
+
+try {
+  const { values } = parseArgs({
+    options: {
+      help: { type: "boolean", short: "h", default: false },
+      force: { type: "boolean", short: "f", default: false },
+      interactive: { type: "boolean", short: "i", default: false },
+    },
+    allowPositionals: true,
+  });
+  isHelp = values.help;
+  isForce = values.force;
+  isInteractive = values.interactive;
+} catch (err) {
+  isHelp = process.argv.includes("--help") || process.argv.includes("-h");
+  isForce = process.argv.includes("--force") || process.argv.includes("-f");
+  isInteractive = process.argv.includes("--interactive") || process.argv.includes("-i");
+}
 
 if (isHelp) {
   console.log(`
@@ -22,8 +43,9 @@ Usage:
   npx jules-init [options]
 
 Options:
-  -f, --force    Overwrite existing AGENTS.md, .agent/jules.yml, and orchestration scripts.
-  -h, --help     Show this help message.
+  -f, --force          Overwrite existing AGENTS.md, .agent/jules.yml, and orchestration scripts.
+  -i, --interactive    Launch interactive wizard to prompt for repository and branch configuration.
+  -h, --help           Show this help message.
 `);
   process.exit(0);
 }
@@ -32,6 +54,52 @@ console.log("\n🚀 Initializing Google Jules Orchestration Kit...\n");
 console.log(`📁 Target Directory: ${targetDir}`);
 if (isForce) console.log("⚠️ Force mode enabled (existing files will be overwritten).");
 
+let answerRepoVal = "";
+let answerBranchVal = "";
+
+// Dual TTY Interactive Wizard
+if (process.stdin.isTTY && (isInteractive || (!fs.existsSync(path.join(targetDir, ".agent/jules.yml")) && !process.env.CI))) {
+  try {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    const answerRepo = await rl.question("📦 Enter target GitHub repository (e.g. owner/repo) [optional]: ");
+    if (answerRepo.trim()) {
+      answerRepoVal = answerRepo.trim();
+      process.env.JULES_REPO = answerRepoVal;
+    }
+    const answerBranch = await rl.question("🌿 Enter base branch [default: main]: ");
+    if (answerBranch.trim()) {
+      answerBranchVal = answerBranch.trim();
+      process.env.BASE_BRANCH = answerBranchVal;
+    }
+    rl.close();
+  } catch (err) {
+    console.warn("⚠️ Interactive setup prompt failed:", err.message);
+  }
+}
+
+// 0. Persist wizard values to .env if provided
+const envPath = path.join(targetDir, ".env");
+let envAdditions = [];
+if (answerRepoVal) envAdditions.push(`JULES_REPO="${answerRepoVal}"`);
+if (answerBranchVal) envAdditions.push(`BASE_BRANCH="${answerBranchVal}"`);
+
+if (envAdditions.length > 0) {
+  if (fs.existsSync(envPath)) {
+    const existingEnv = fs.readFileSync(envPath, "utf-8");
+    const toAppend = envAdditions.filter((line) => {
+      const key = line.split("=")[0];
+      return !existingEnv.includes(`${key}=`);
+    });
+    if (toAppend.length > 0) {
+      fs.appendFileSync(envPath, `\n${toAppend.join("\n")}\n`, "utf-8");
+      console.log("✅ Appended interactive configuration to .env");
+    }
+  } else {
+    fs.writeFileSync(envPath, `${envAdditions.join("\n")}\n`, "utf-8");
+    console.log("✅ Created: .env with repository configuration");
+  }
+}
+
 // 1. Detect Stack & Manifests
 const detected = resolveProjectCommands(targetDir);
 console.log(`🔍 Detected Project Type: ${detected.source}`);
@@ -102,6 +170,21 @@ if ((!fs.existsSync(reviewTarget) || isForce) && fs.existsSync(reviewSource)) {
   console.log("✅ Created: .agent/workflows/jules-review.md");
 }
 
+// Scaffold .github/workflows/jules-audit.yml
+const githubWorkflowsDir = path.join(targetDir, ".github/workflows");
+const auditWfSource = path.join(kitRoot, ".github/workflows/jules-audit.yml");
+const auditWfTarget = path.join(githubWorkflowsDir, "jules-audit.yml");
+
+if (fs.existsSync(auditWfSource)) {
+  if (!fs.existsSync(githubWorkflowsDir)) {
+    fs.mkdirSync(githubWorkflowsDir, { recursive: true });
+  }
+  if (!fs.existsSync(auditWfTarget) || isForce) {
+    fs.copyFileSync(auditWfSource, auditWfTarget);
+    console.log("✅ Scaffolded CI Audit Workflow: .github/workflows/jules-audit.yml");
+  }
+}
+
 // 4. Copy scripts/ directory with PER-FILE existence guard
 const targetScriptsDir = path.join(targetDir, "scripts");
 if (!fs.existsSync(targetScriptsDir)) {
@@ -121,7 +204,9 @@ if (fs.existsSync(sourceScriptsDir)) {
       fs.copyFileSync(srcFile, destFile);
       try {
         fs.chmodSync(destFile, 0o755);
-      } catch (_) {}
+      } catch (err) {
+        console.warn(`⚠️ Could not set executable permissions on ${file}:`, err.message);
+      }
       copiedCount++;
     } else {
       skippedCount++;
@@ -156,7 +241,9 @@ if (fs.existsSync(targetPkgPath) && targetDir !== kitRoot) {
       fs.writeFileSync(targetPkgPath, JSON.stringify(pkg, null, 2) + "\n", "utf-8");
       console.log("✅ Injected jules:* helper scripts into package.json");
     }
-  } catch (_) {}
+  } catch (err) {
+    console.warn("⚠️ Failed to inject helper scripts into target package.json:", err.message);
+  }
 }
 
 console.log("\n🎉 Google Jules Orchestration Kit successfully initialized!");
@@ -164,4 +251,3 @@ console.log("\nNext Steps:");
 console.log("  1. Set environment variables: JULES_REPO=\"owner/repo\"");
 console.log("  2. Dispatch your first task:  node scripts/jules-dispatch.mjs \"Task Title\" \"Task prompt\"");
 console.log("  3. Run pre-merge PR audit:    node scripts/jules-self-audit.mjs\n");
-

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jules-orchestrator-kit",
-  "version": "0.1.9",
+  "version": "0.2.9",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/FullThrottle83/jules-orchestrator-kit.git"
@@ -18,6 +18,8 @@
     "bin/",
     "scripts/",
     ".agent/",
+    ".github/",
+    ".env.example",
     "JULES_RULES_TEMPLATE.md",
     "README.md",
     "LICENSE"

package/scripts/command-resolver.mjs

@@ -39,137 +39,90 @@ export function resolveProjectCommands(projectRoot = process.cwd()) {
         buildCmd: cfg.buildCmd || "",
         source: "jules.config.json",
       };
-    } catch (_) {}
-  }
-
-  // 2. Bun (bunfig.toml or bun.lockb)
-  if (
-    fs.existsSync(path.join(projectRoot, "bunfig.toml")) ||
-    fs.existsSync(path.join(projectRoot, "bun.lockb"))
-  ) {
-    return {
-      testCmd: "bun test",
-      buildCmd: "bun run build",
-      source: "Bun Manifest",
-    };
-  }
-
-  // 3. Deno (deno.json / deno.jsonc)
-  if (
-    fs.existsSync(path.join(projectRoot, "deno.json")) ||
-    fs.existsSync(path.join(projectRoot, "deno.jsonc"))
-  ) {
-    return {
-      testCmd: "deno test",
-      buildCmd: "deno task build",
-      source: "Deno Manifest",
-    };
-  }
-
-  // 4. JavaScript / TypeScript (package.json)
-  const pkgPath = path.join(projectRoot, "package.json");
-  if (fs.existsSync(pkgPath)) {
-    try {
-      const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
-      const scripts = pkg.scripts || {};
-      const verifyScript = scripts["check:all"]
-        ? "npm run check:all"
-        : scripts.test
-        ? "npm test"
-        : "";
-      const buildScript = scripts.build ? "npm run build" : "";
-      return {
-        testCmd: verifyScript,
-        buildCmd: buildScript,
-        source: "package.json",
-      };
-    } catch (_) {}
-  }
-
-  // 5. Rust (Cargo.toml)
-  if (fs.existsSync(path.join(projectRoot, "Cargo.toml"))) {
-    return {
-      testCmd: "cargo test --workspace",
-      buildCmd: "cargo build",
-      source: "Cargo.toml",
-    };
-  }
-
-  // 6. Go (go.mod)
-  if (fs.existsSync(path.join(projectRoot, "go.mod"))) {
-    return {
-      testCmd: "go test ./...",
-      buildCmd: "go build ./...",
-      source: "go.mod",
-    };
-  }
-
-  // 7. Python (pyproject.toml / requirements.txt / setup.py)
-  if (
-    fs.existsSync(path.join(projectRoot, "pyproject.toml")) ||
-    fs.existsSync(path.join(projectRoot, "requirements.txt")) ||
-    fs.existsSync(path.join(projectRoot, "setup.py"))
-  ) {
-    return {
-      testCmd: "pytest",
-      buildCmd: "",
-      source: "Python Manifest",
-    };
-  }
-
-  // 8. Elixir (mix.exs)
-  if (fs.existsSync(path.join(projectRoot, "mix.exs"))) {
-    return {
-      testCmd: "mix test",
-      buildCmd: "mix compile",
-      source: "mix.exs",
-    };
-  }
-
-  // 9. Ruby (Gemfile)
-  if (fs.existsSync(path.join(projectRoot, "Gemfile"))) {
-    return {
-      testCmd: "bundle exec rake test",
-      buildCmd: "",
-      source: "Gemfile",
-    };
-  }
-
-  // 10. Swift (Package.swift)
-  if (fs.existsSync(path.join(projectRoot, "Package.swift"))) {
-    return {
-      testCmd: "swift test",
-      buildCmd: "swift build",
-      source: "Package.swift",
-    };
-  }
-
-  // 11. Java (Maven pom.xml / Gradle build.gradle)
-  if (fs.existsSync(path.join(projectRoot, "pom.xml"))) {
-    return {
-      testCmd: "mvn test",
-      buildCmd: "mvn compile",
-      source: "pom.xml",
-    };
-  }
-  if (
-    fs.existsSync(path.join(projectRoot, "build.gradle")) ||
-    fs.existsSync(path.join(projectRoot, "build.gradle.kts"))
-  ) {
-    return {
-      testCmd: "./gradlew test",
-      buildCmd: "./gradlew assemble",
-      source: "build.gradle",
-    };
+    } catch (err) {
+      console.warn("⚠️ Failed to parse jules.config.json:", err.message);
+    }
   }
 
-  // 12. Makefile
-  if (fs.existsSync(path.join(projectRoot, "Makefile"))) {
-    return {
-      testCmd: "make test",
-      buildCmd: "make build",
-      source: "Makefile",
-    };
+  // 2. Dynamic Detector Strategy List
+  const detectors = [
+    {
+      files: ["bunfig.toml", "bun.lockb"],
+      resolve: () => ({ testCmd: "bun test", buildCmd: "bun run build", source: "Bun Manifest" }),
+    },
+    {
+      files: ["deno.json", "deno.jsonc"],
+      resolve: () => ({ testCmd: "deno test", buildCmd: "deno task build", source: "Deno Manifest" }),
+    },
+    {
+      files: ["package.json"],
+      resolve: (root) => {
+        try {
+          const pkg = JSON.parse(fs.readFileSync(path.join(root, "package.json"), "utf-8"));
+          const scripts = pkg.scripts || {};
+          let verifyScript = scripts["check:all"] ? "npm run check:all" : "";
+          if (!verifyScript) {
+            const parts = [];
+            if (scripts.lint) parts.push("npm run lint");
+            else if (scripts.check) parts.push("npm run check");
+            if (scripts.test) parts.push("npm test");
+            verifyScript = parts.join(" && ");
+          }
+          const buildScript = scripts.build ? "npm run build" : "";
+          return {
+            testCmd: verifyScript || "npm test",
+            buildCmd: buildScript,
+            source: "package.json",
+          };
+        } catch (err) {
+          console.warn("⚠️ Failed to parse package.json:", err.message);
+          return null;
+        }
+      },
+    },
+    {
+      files: ["Cargo.toml"],
+      resolve: () => ({ testCmd: "cargo test --workspace", buildCmd: "cargo build", source: "Cargo.toml" }),
+    },
+    {
+      files: ["go.mod"],
+      resolve: () => ({ testCmd: "go test ./...", buildCmd: "go build ./...", source: "go.mod" }),
+    },
+    {
+      files: ["pyproject.toml", "requirements.txt", "setup.py"],
+      resolve: () => ({ testCmd: "pytest", buildCmd: "", source: "Python Manifest" }),
+    },
+    {
+      files: ["mix.exs"],
+      resolve: () => ({ testCmd: "mix test", buildCmd: "mix compile", source: "mix.exs" }),
+    },
+    {
+      files: ["Gemfile"],
+      resolve: () => ({ testCmd: "bundle exec rake test", buildCmd: "", source: "Gemfile" }),
+    },
+    {
+      files: ["Package.swift"],
+      resolve: () => ({ testCmd: "swift test", buildCmd: "swift build", source: "Package.swift" }),
+    },
+    {
+      files: ["pom.xml"],
+      resolve: () => ({ testCmd: "mvn test", buildCmd: "mvn compile", source: "pom.xml" }),
+    },
+    {
+      files: ["build.gradle", "build.gradle.kts"],
+      resolve: () => ({ testCmd: "./gradlew test", buildCmd: "./gradlew assemble", source: "build.gradle" }),
+    },
+    {
+      files: ["Makefile"],
+      resolve: () => ({ testCmd: "make test", buildCmd: "make build", source: "Makefile" }),
+    },
+  ];
+
+  for (const detector of detectors) {
+    if (detector.files.some((f) => fs.existsSync(path.join(projectRoot, f)))) {
+      const res = detector.resolve(projectRoot);
+      if (res) return res;
+    }
   }
 
   return {
@@ -185,6 +138,9 @@ export function resolveProjectCommands(projectRoot = process.cwd()) {
  */
 export function resolveWorkspaceExecutionBoundary(modifiedFiles = [], projectRoot = process.cwd()) {
   const baseCmds = resolveProjectCommands(projectRoot);
+  if (baseCmds.source === ".agent/jules.yml" || baseCmds.source === "jules.config.json") {
+    return baseCmds;
+  }
   if (!modifiedFiles || modifiedFiles.length === 0) return baseCmds;
 
   // Find affected package names by walking up from modified files to nearest manifest
@@ -211,8 +167,9 @@ export function resolveWorkspaceExecutionBoundary(modifiedFiles = [], projectRoo
     }
   }
 
-  if (affectedPkgs.size === 0) return baseCmds;
-  const targets = Array.from(affectedPkgs);
+  const SAFE_PKG_NAME = /^[@a-zA-Z0-9._\/-]+$/;
+  const targets = Array.from(affectedPkgs).filter((t) => SAFE_PKG_NAME.test(t));
+  if (targets.length === 0) return baseCmds;
 
   // 1. Turborepo (turbo.json)
   if (fs.existsSync(path.join(projectRoot, "turbo.json"))) {