@google/jules-fleet 0.0.1-experimental.2 → 0.0.1-experimental.4

package/README.md

@@ -53,10 +53,18 @@ If a merge conflict is detected, the fleet closes the conflicting PR, re-dispatc
 ## Set up a repository
 
 ```bash
-npx @google/jules-fleet init --repo your-org/your-repo
+npx @google/jules-fleet init
 ```
 
-This creates a pull request containing three GitHub Actions workflows and an example goal file. It also creates the `fleet` and `fleet-merge-ready` labels. Merge the PR, then add `JULES_API_KEY` to your repository secrets.
+The interactive wizard will:
+1. **Detect the repo** from your git remote (or pass `--repo owner/repo`)
+2. **Configure auth** — choose GitHub App (recommended) or personal access token
+   - For GitHub App: enter your app slug and path to the `.pem` private key file. Fleet auto-detects the App ID and Installation ID.
+3. **Upload secrets** — `JULES_API_KEY` and app credentials are uploaded to GitHub Actions secrets
+4. **Create a PR** with three workflow files and an example goal
+5. **Create labels** — `fleet` and `fleet-merge-ready`
+
+If workflow files already exist (re-initialization), the wizard prompts to overwrite them with the latest templates.
 
 ## CLI Reference
 
@@ -65,16 +73,20 @@ This creates a pull request containing three GitHub Actions workflows and an exa
 Scaffold a repository for fleet workflows by creating a PR with the necessary files.
 
 ```
-jules-fleet init --repo <owner/repo> [options]
+jules-fleet init [options]
 
 Options:
-  --base <branch>   Base branch for the PR (default: main)
+  --repo <owner/repo>    Repository (auto-detected from git remote)
+  --base <branch>        Base branch for the PR (default: main)
+  --non-interactive      Disable wizard prompts — all inputs via flags/env vars
+  --dry-run              Show what would be created without making changes
+  --upload-secrets       Upload secrets to GitHub Actions (default: true)
 ```
 
 Files added by the PR:
-- `.github/workflows/fleet-merge.yml`
-- `.github/workflows/fleet-dispatch.yml`
 - `.github/workflows/fleet-analyze.yml`
+- `.github/workflows/fleet-dispatch.yml`
+- `.github/workflows/fleet-merge.yml`
 - `.fleet/goals/example.md`
 
 Labels created: `fleet`, `fleet-merge-ready`
@@ -166,15 +178,19 @@ Options:
 
 ### Environment Variables
 
+Fleet auto-detects auth from environment variables. App auth takes priority over `GITHUB_TOKEN`.
+
 ```
-GITHUB_TOKEN                    Required. GitHub token with repo access.
-JULES_API_KEY                   Required for analyze, dispatch, and re-dispatch.
-GITHUB_APP_ID                   GitHub App authentication (alternative to token).
-GITHUB_APP_PRIVATE_KEY          GitHub App private key (PEM or base64).
-GITHUB_APP_INSTALLATION_ID      GitHub App installation ID.
-FLEET_BASE_BRANCH               Override default base branch (default: main).
+GITHUB_TOKEN                       Auto-provided in GitHub Actions. For local use, set a PAT.
+JULES_API_KEY                      Required for analyze, dispatch, and re-dispatch.
+FLEET_APP_ID                       GitHub App ID.
+FLEET_APP_PRIVATE_KEY              GitHub App private key (base64-encoded).
+FLEET_APP_INSTALLATION_ID          GitHub App installation ID.
+FLEET_BASE_BRANCH                  Override default base branch (default: main).
 ```
 
+`GITHUB_APP_ID`, `GITHUB_APP_PRIVATE_KEY_BASE64`, and `GITHUB_APP_INSTALLATION_ID` are also accepted as aliases. The `FLEET_APP_*` names are recommended because they work both as GitHub Actions secret names and as local env vars.
+
 ## Programmatic API
 
 The handlers are exported for use in scripts and custom workflows.

package/dist/cli/analyze.command.mjs

@@ -1,4 +1,15 @@
 import { createRequire } from "node:module";
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
 // src/cli/analyze.command.ts
@@ -180,7 +191,9 @@ function formatPRContext(pr) {
 }
 
 // src/analyze/prompt.ts
-var SYSTEM_PREAMBLE = `You are a senior software architect performing a rigorous code analysis against a set of goal directives. Your job is to identify gaps and create GitHub issues for each actionable task.`;
+var SYSTEM_PREAMBLE = `You are a senior software architect performing a rigorous code analysis. Your ONLY deliverable is GitHub issues created via the \`npx @google/jules-fleet signal create\` CLI command.
+
+Focus exclusively on analysis and signal creation. Leave all application code, project scaffolding, and feature implementation to the downstream worker agents who will receive your signals. Your value is in the precision of your diagnosis and the clarity of your issue descriptions — the code comes later, from others.`;
 var DEDUP_RULES = `**Deduplication Rules (MANDATORY):**
 1. **Closed Issue = Work Already Done.** Do NOT recreate issues that have been closed.
 2. **Open Issue = Work In Progress.** Someone is already handling it. Do NOT create a duplicate.
@@ -207,16 +220,16 @@ var PHASE_2_ARCHITECT = `### Phase 2: Architect
 Design a concrete, production-ready solution for each root cause.
 
 For each solution, you must provide:
-1. **Proposed Implementation:** Write the actual TypeScript/code demonstrating the solution. Include function signatures, interfaces, and logic.
+1. **Proposed Implementation:** Write code demonstrating the solution in the project's primary language. Include function signatures, types, and logic.
 2. **Integration Points:** Detail exactly where in the existing code this gets wired in, using before/after diffs to show the structural changes.
 3. **Edge Cases:** Identify assumptions and define fallback behaviors.
 4. **Test Scenarios:** Define specific test cases, inputs, and expected outputs that validate the fix.`;
 var PHASE_3_PLAN = `### Phase 3: Plan (Coupling & Boundary Analysis)
 Evaluate the exact file requirements for each architectural solution to define strict boundaries for the downstream worker agents.
 
-1. **Coupling Analysis:** Map all implicitly coupled files. Identify test files that exercise the modified code, barrel exports (\`index.ts\`), and shared utilities.
-2. **File Ownership & Locking:** The downstream Orchestrator prevents merge conflicts by locking files at runtime. You must exhaustively list every single file (source, test, and utility) the worker agent needs to touch.
-3. **Task Sizing:** Keep tasks strictly isolated by functional domain. You may assign the same core file (e.g., \`types.ts\`) to multiple tasks; the Orchestrator will sequence them automatically based on your exhaustive file list.`;
+1. **Coupling Analysis:** Map all implicitly coupled files. Identify test files that exercise the modified code, barrel exports, and shared utilities.
+2. **File Ownership & Locking:** The downstream Orchestrator prevents merge conflicts by locking files at runtime. You must exhaustively list every single file (source, test, and utility) the worker agent needs to touch.
+3. **Task Sizing:** Keep tasks strictly isolated by functional domain. You may assign the same core file (e.g., shared type definitions) to multiple tasks; the Orchestrator will sequence them automatically based on your exhaustive file list.`;
 var PHASE_4_DISPATCH_HEALTHY = `**Path A: System Healthy Protocol**
 If your Phase 0 verification confirms that the codebase already satisfies the goal directives and no actionable work remains, formulate a comprehensive "Fleet Status: Goal Currently Satisfied" report. Detail exactly which domains, files, and logic paths you verified to reach this conclusion. Output this markdown report and exit gracefully, bypassing the issue creation step entirely. Preserve the repository's current state by creating issues only when substantial, goal-aligned engineering work is required.`;
 var PHASE_4_DISPATCH_ISSUES = `**Path B: Task Dispatch Protocol**
@@ -226,37 +239,36 @@ For EACH validated task that requires execution, perform a **Deduplication Check
 2. If an existing open issue's **Objective** already covers the same gap (even partially or under a different name), **do NOT create a new issue**. Instead, note the overlap in your report and skip creation.
 3. Only create an issue for gaps that are genuinely novel — not covered by any existing open issue.
 
-For each non-duplicate task, create a signal using the \`jules-fleet signal create\` command.`;
+For each non-duplicate task, create a signal using the \`npx @google/jules-fleet signal create\` command.`;
 var ISSUE_BODY_TEMPLATE = `\`\`\`markdown
 ### Objective
 [2-3 sentences explaining the functional goal of this isolated task]
 
 ### Code-Level Diagnosis
-**Code path:** [e.g., \`src/session.ts → fetch()\`]
+**Code path:** [e.g., src/module.py -> function_name()]
 **Mechanism:** [Explanation of the current state]
 **Root cause:** [Summary of the architectural gap]
 
 #### Current Implementation
-\\\`\\\`\\\`typescript
+\`\`\`
 // [Insert exact snippet from current codebase showing the logic to be changed]
-\\\`\\\`\\\`
+\`\`\`
 
 ### Proposed Implementation
 **Files to modify:** [Brief summary of structural changes]
 
-#### Integration (Before → After)
-\\\`\\\`\\\`diff
+#### Integration (Before -> After)
+\`\`\`diff
 // [Insert precise diffs showing how the new logic integrates]
-\\\`\\\`\\\`
+\`\`\`
 
 ### Test Scenarios
 1. [Scenario 1: Input -> Expected Output]
 2. [Scenario 2: Input -> Expected Output]
 
 ### Target Files
-- [exact/path/to/source1.ts]
-- [exact/path/to/source2.ts]
-- [exact/path/to/test1.test.ts]
+- [exact/path/to/source_file]
+- [exact/path/to/test_file]
 
 ### Boundary Rules
 Restrict your modifications exclusively to the files listed in the Target Files section. Ensure your source changes are entirely backward-compatible if unowned tests outside your boundary fail. Retain all existing file names and locations outside your explicitly declared target list.
@@ -279,20 +291,12 @@ ${prContext}
 
 **Assessment** (actionable — requires code changes):
 \`\`\`bash
-jules-fleet signal create \\
-  --kind assessment \\
-  --title "[Fleet Execution] <Highly Specific Domain Task Title>" \\
-  --tag fleet \\
-  --body-file <path_to_markdown_file>${milestoneFlag}
+npx @google/jules-fleet signal create \\  --kind assessment \\  --title "[Fleet Execution] [Highly Specific Domain Task Title]" \\  --tag fleet \\  --body-file [path_to_markdown_file]${milestoneFlag}
 \`\`\`
 
 **Insight** (informational — no action required):
 \`\`\`bash
-jules-fleet signal create \\
-  --kind insight \\
-  --title "<Descriptive Finding>" \\
-  --tag fleet \\
-  --body-file <path_to_markdown_file>${milestoneFlag}
+npx @google/jules-fleet signal create \\  --kind insight \\  --title "[Descriptive Finding]" \\  --tag fleet \\  --body-file [path_to_markdown_file]${milestoneFlag}
 \`\`\``;
   return [
     SYSTEM_PREAMBLE,
@@ -329,7 +333,7 @@ jules-fleet signal create \\
     PHASE_3_PLAN,
     "",
     `### Phase 4: Dispatch (Issue Creation or Goal Validation)`,
-    `Translate your analysis into independent signals using \`jules-fleet signal create\`, or provide a clean bill of health.`,
+    `Translate your analysis into independent signals using \`npx @google/jules-fleet signal create\`, or provide a clean bill of health.`,
     "",
     PHASE_4_DISPATCH_HEALTHY,
     "",
@@ -548,10 +552,10 @@ function resolvePrivateKey(base64Value, rawValue) {
 // src/shared/auth/octokit.ts
 var CachedOctokit = Octokit.plugin(cachePlugin);
 function getAuthOptions() {
-  const appId = process.env.GITHUB_APP_ID;
-  const privateKeyBase64 = process.env.GITHUB_APP_PRIVATE_KEY_BASE64;
+  const appId = process.env.FLEET_APP_ID || process.env.GITHUB_APP_ID;
+  const privateKeyBase64 = process.env.FLEET_APP_PRIVATE_KEY || process.env.GITHUB_APP_PRIVATE_KEY_BASE64;
   const privateKeyRaw = process.env.GITHUB_APP_PRIVATE_KEY;
-  const installationId = process.env.GITHUB_APP_INSTALLATION_ID;
+  const installationId = process.env.FLEET_APP_INSTALLATION_ID || process.env.GITHUB_APP_INSTALLATION_ID;
   if (appId && (privateKeyBase64 || privateKeyRaw) && installationId) {
     return {
       authStrategy: createAppAuth,
@@ -566,7 +570,7 @@ function getAuthOptions() {
   if (token) {
     return { auth: token };
   }
-  throw new Error("GitHub auth not configured. Set GITHUB_APP_ID + GITHUB_APP_PRIVATE_KEY + GITHUB_APP_INSTALLATION_ID for App auth, or GITHUB_TOKEN for PAT auth.");
+  throw new Error("GitHub auth not configured. Set FLEET_APP_ID + FLEET_APP_PRIVATE_KEY + FLEET_APP_INSTALLATION_ID for App auth, or GITHUB_TOKEN for PAT auth.");
 }
 function createFleetOctokit() {
   return new CachedOctokit(getAuthOptions());

package/dist/cli/configure.command.mjs

@@ -1,4 +1,15 @@
 import { createRequire } from "node:module";
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
 // src/cli/configure.command.ts
@@ -171,10 +182,10 @@ function resolvePrivateKey(base64Value, rawValue) {
 // src/shared/auth/octokit.ts
 var CachedOctokit = Octokit.plugin(cachePlugin);
 function getAuthOptions() {
-  const appId = process.env.GITHUB_APP_ID;
-  const privateKeyBase64 = process.env.GITHUB_APP_PRIVATE_KEY_BASE64;
+  const appId = process.env.FLEET_APP_ID || process.env.GITHUB_APP_ID;
+  const privateKeyBase64 = process.env.FLEET_APP_PRIVATE_KEY || process.env.GITHUB_APP_PRIVATE_KEY_BASE64;
   const privateKeyRaw = process.env.GITHUB_APP_PRIVATE_KEY;
-  const installationId = process.env.GITHUB_APP_INSTALLATION_ID;
+  const installationId = process.env.FLEET_APP_INSTALLATION_ID || process.env.GITHUB_APP_INSTALLATION_ID;
   if (appId && (privateKeyBase64 || privateKeyRaw) && installationId) {
     return {
       authStrategy: createAppAuth,
@@ -189,7 +200,7 @@ function getAuthOptions() {
   if (token) {
     return { auth: token };
   }
-  throw new Error("GitHub auth not configured. Set GITHUB_APP_ID + GITHUB_APP_PRIVATE_KEY + GITHUB_APP_INSTALLATION_ID for App auth, or GITHUB_TOKEN for PAT auth.");
+  throw new Error("GitHub auth not configured. Set FLEET_APP_ID + FLEET_APP_PRIVATE_KEY + FLEET_APP_INSTALLATION_ID for App auth, or GITHUB_TOKEN for PAT auth.");
 }
 function createFleetOctokit() {
   return new CachedOctokit(getAuthOptions());

package/dist/cli/dispatch.command.mjs

@@ -1,4 +1,15 @@
 import { createRequire } from "node:module";
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
 // src/cli/dispatch.command.ts
@@ -319,10 +330,10 @@ function resolvePrivateKey(base64Value, rawValue) {
 // src/shared/auth/octokit.ts
 var CachedOctokit = Octokit.plugin(cachePlugin);
 function getAuthOptions() {
-  const appId = process.env.GITHUB_APP_ID;
-  const privateKeyBase64 = process.env.GITHUB_APP_PRIVATE_KEY_BASE64;
+  const appId = process.env.FLEET_APP_ID || process.env.GITHUB_APP_ID;
+  const privateKeyBase64 = process.env.FLEET_APP_PRIVATE_KEY || process.env.GITHUB_APP_PRIVATE_KEY_BASE64;
   const privateKeyRaw = process.env.GITHUB_APP_PRIVATE_KEY;
-  const installationId = process.env.GITHUB_APP_INSTALLATION_ID;
+  const installationId = process.env.FLEET_APP_INSTALLATION_ID || process.env.GITHUB_APP_INSTALLATION_ID;
   if (appId && (privateKeyBase64 || privateKeyRaw) && installationId) {
     return {
       authStrategy: createAppAuth,
@@ -337,7 +348,7 @@ function getAuthOptions() {
   if (token) {
     return { auth: token };
   }
-  throw new Error("GitHub auth not configured. Set GITHUB_APP_ID + GITHUB_APP_PRIVATE_KEY + GITHUB_APP_INSTALLATION_ID for App auth, or GITHUB_TOKEN for PAT auth.");
+  throw new Error("GitHub auth not configured. Set FLEET_APP_ID + FLEET_APP_PRIVATE_KEY + FLEET_APP_INSTALLATION_ID for App auth, or GITHUB_TOKEN for PAT auth.");
 }
 function createFleetOctokit() {
   return new CachedOctokit(getAuthOptions());