boomtick-cli 0.2.2__tar.gz → 0.5.0__tar.gz

boomtick_cli-0.5.0/MANIFEST.in

@@ -0,0 +1,3 @@
+recursive-include dev_tools/dist *
+recursive-include dev_tools/resources *
+include dev_tools/cli-schema.json

{boomtick_cli-0.2.2 → boomtick_cli-0.5.0}/PKG-INFO

@@ -1,24 +1,30 @@
 Metadata-Version: 2.4
 Name: boomtick-cli
-Version: 0.2.2
+Version: 0.5.0
 Summary: BoomTick CLI — agentic dev-tools for GitHub + AI workflows
+Author: Ariel Anders
+Project-URL: Homepage, https://github.com/arii/boomtick
+Project-URL: Repository, https://github.com/arii/boomtick
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 Requires-Dist: requests>=2.0.0
 Requires-Dist: packaging>=21.3
-Requires-Dist: google-genai
 Requires-Dist: python-dotenv
 Requires-Dist: pydantic
 Requires-Dist: click
 Requires-Dist: PyGithub
 Requires-Dist: semgrep
-Requires-Dist: chromadb>=1.5.9
-Requires-Dist: sentence-transformers>=5.6.0
 Requires-Dist: duckduckgo-search>=6.0.0
 Requires-Dist: setuptools<81.0.0
 Requires-Dist: importlib-resources
-Requires-Dist: langchain-google-genai
-Requires-Dist: langchain-openai
+Provides-Extra: ai
+Requires-Dist: google-genai; extra == "ai"
+Requires-Dist: chromadb>=1.5.9; extra == "ai"
+Requires-Dist: sentence-transformers>=5.6.0; extra == "ai"
+Requires-Dist: langchain-google-genai; extra == "ai"
+Requires-Dist: langchain-openai; extra == "ai"
 
 # dev-tools
 
@@ -35,7 +41,7 @@ tool hierarchy.
 ./setup-agent.sh
 ```
 
-This script (symlinked to `dev-tools/setup-agent.sh`) handles system tools,
+This setup script is now located at the repository root (not symlinked) and handles system tools,
 Node.js, pnpm, Python dependencies, Playwright, remote origin configuration,
 and git hook registration.
 
@@ -75,7 +81,7 @@ export GEMINI_API_KEY="<key>"
 
 ## 🧩 Workflow-Specific Setup
 
-After `./dev-tools/setup-agent.sh`, use the following workflow-specific setup:
+After `./setup-agent.sh`, use the following workflow-specific setup:
 
 #### 1) Standard PR / Review Workflows
 
@@ -109,7 +115,7 @@ After `./dev-tools/setup-agent.sh`, use the following workflow-specific setup:
 
 `.agent-context.json` (repository root) is the pre-built index that
 `boomtick-mcp` reads on every tool call. It contains `file_tree`, `cli_schema`,
-and `package_json` metadata — built by `boomtick-pkg/scripts/build-repo-context.py`.
+and `package_json` metadata — built by `scripts/build-repo-context.py`.
 
 **The index is kept fresh automatically** by the git hooks registered during
 `./setup-agent.sh`:

{boomtick_cli-0.2.2 → boomtick_cli-0.5.0}/README.md

@@ -13,7 +13,7 @@ tool hierarchy.
 ./setup-agent.sh
 ```
 
-This script (symlinked to `dev-tools/setup-agent.sh`) handles system tools,
+This setup script is now located at the repository root (not symlinked) and handles system tools,
 Node.js, pnpm, Python dependencies, Playwright, remote origin configuration,
 and git hook registration.
 
@@ -53,7 +53,7 @@ export GEMINI_API_KEY="<key>"
 
 ## 🧩 Workflow-Specific Setup
 
-After `./dev-tools/setup-agent.sh`, use the following workflow-specific setup:
+After `./setup-agent.sh`, use the following workflow-specific setup:
 
 #### 1) Standard PR / Review Workflows
 
@@ -87,7 +87,7 @@ After `./dev-tools/setup-agent.sh`, use the following workflow-specific setup:
 
 `.agent-context.json` (repository root) is the pre-built index that
 `boomtick-mcp` reads on every tool call. It contains `file_tree`, `cli_schema`,
-and `package_json` metadata — built by `boomtick-pkg/scripts/build-repo-context.py`.
+and `package_json` metadata — built by `scripts/build-repo-context.py`.
 
 **The index is kept fresh automatically** by the git hooks registered during
 `./setup-agent.sh`:

{boomtick_cli-0.2.2 → boomtick_cli-0.5.0}/boomtick_cli.egg-info/PKG-INFO

@@ -1,24 +1,30 @@
 Metadata-Version: 2.4
 Name: boomtick-cli
-Version: 0.2.2
+Version: 0.5.0
 Summary: BoomTick CLI — agentic dev-tools for GitHub + AI workflows
+Author: Ariel Anders
+Project-URL: Homepage, https://github.com/arii/boomtick
+Project-URL: Repository, https://github.com/arii/boomtick
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 Requires-Dist: requests>=2.0.0
 Requires-Dist: packaging>=21.3
-Requires-Dist: google-genai
 Requires-Dist: python-dotenv
 Requires-Dist: pydantic
 Requires-Dist: click
 Requires-Dist: PyGithub
 Requires-Dist: semgrep
-Requires-Dist: chromadb>=1.5.9
-Requires-Dist: sentence-transformers>=5.6.0
 Requires-Dist: duckduckgo-search>=6.0.0
 Requires-Dist: setuptools<81.0.0
 Requires-Dist: importlib-resources
-Requires-Dist: langchain-google-genai
-Requires-Dist: langchain-openai
+Provides-Extra: ai
+Requires-Dist: google-genai; extra == "ai"
+Requires-Dist: chromadb>=1.5.9; extra == "ai"
+Requires-Dist: sentence-transformers>=5.6.0; extra == "ai"
+Requires-Dist: langchain-google-genai; extra == "ai"
+Requires-Dist: langchain-openai; extra == "ai"
 
 # dev-tools
 
@@ -35,7 +41,7 @@ tool hierarchy.
 ./setup-agent.sh
 ```
 
-This script (symlinked to `dev-tools/setup-agent.sh`) handles system tools,
+This setup script is now located at the repository root (not symlinked) and handles system tools,
 Node.js, pnpm, Python dependencies, Playwright, remote origin configuration,
 and git hook registration.
 
@@ -75,7 +81,7 @@ export GEMINI_API_KEY="<key>"
 
 ## 🧩 Workflow-Specific Setup
 
-After `./dev-tools/setup-agent.sh`, use the following workflow-specific setup:
+After `./setup-agent.sh`, use the following workflow-specific setup:
 
 #### 1) Standard PR / Review Workflows
 
@@ -109,7 +115,7 @@ After `./dev-tools/setup-agent.sh`, use the following workflow-specific setup:
 
 `.agent-context.json` (repository root) is the pre-built index that
 `boomtick-mcp` reads on every tool call. It contains `file_tree`, `cli_schema`,
-and `package_json` metadata — built by `boomtick-pkg/scripts/build-repo-context.py`.
+and `package_json` metadata — built by `scripts/build-repo-context.py`.
 
 **The index is kept fresh automatically** by the git hooks registered during
 `./setup-agent.sh`:

{boomtick_cli-0.2.2 → boomtick_cli-0.5.0}/boomtick_cli.egg-info/SOURCES.txt

@@ -1,3 +1,4 @@
+MANIFEST.in
 README.md
 pyproject.toml
 boomtick_cli.egg-info/PKG-INFO
@@ -28,6 +29,7 @@ dev_tools/verify_versions.py
 dev_tools/version_utils.py
 dev_tools/dist/config.js
 dev_tools/dist/index.js
+dev_tools/dist/evals/run-evals.js
 dev_tools/dist/lib/error_utils.js
 dev_tools/dist/lib/git.js
 dev_tools/dist/lib/result.js
@@ -94,8 +96,10 @@ dev_tools/resources/prompt_constants.json
 dev_tools/resources/review_template.md
 dev_tools/resources/ux-audit.config.json
 dev_tools/resources/visual_guidelines.json
+dev_tools/resources/__pycache__/__init__.cpython-312.pyc
 dev_tools/services/__init__.py
 dev_tools/services/ai_service.py
+dev_tools/services/context_builder.py
 dev_tools/services/dependency_graph.py
 dev_tools/services/github.py
 dev_tools/services/jules.py
@@ -104,12 +108,20 @@ dev_tools/services/vector_store.py
 dev_tools/services/vision_service.py
 dev_tools/utils/__init__.py
 dev_tools/utils/git.py
+dev_tools/workflows/__init__.py
+dev_tools/workflows/context.py
+dev_tools/workflows/graph.py
+dev_tools/workflows/node.py
+dev_tools/workflows/nodes.py
+dev_tools/workflows/runner.py
 tests/test_config.py
 tests/test_dependency_graph.py
 tests/test_fail_fast.py
 tests/test_github_diff_parser.py
 tests/test_github_no_gh.py
 tests/test_github_parser.py
+tests/test_install_workflows.py
+tests/test_issue_validation_local.py
 tests/test_jules_batch_send.py
 tests/test_labels.py
 tests/test_latency_mitigation.py
@@ -121,4 +133,5 @@ tests/test_pr_overlap.py
 tests/test_review_template_validation.py
 tests/test_schema_utils.py
 tests/test_verify_ci_metrics.py
-tests/test_workflow_audit.py
+tests/test_workflow_audit.py
+tests/test_workflow_orchestration.py

{boomtick_cli-0.2.2 → boomtick_cli-0.5.0}/boomtick_cli.egg-info/requires.txt

@@ -1,15 +1,17 @@
 requests>=2.0.0
 packaging>=21.3
-google-genai
 python-dotenv
 pydantic
 click
 PyGithub
 semgrep
-chromadb>=1.5.9
-sentence-transformers>=5.6.0
 duckduckgo-search>=6.0.0
 setuptools<81.0.0
 importlib-resources
+
+[ai]
+google-genai
+chromadb>=1.5.9
+sentence-transformers>=5.6.0
 langchain-google-genai
 langchain-openai

{boomtick_cli-0.2.2 → boomtick_cli-0.5.0}/dev_tools/cli.py

@@ -467,15 +467,37 @@ def issue_comment(ctx, issue_number, file, body):
 @click.option("--all-open", is_flag=True)
 @click.option("--post-comments", is_flag=True)
 @click.option("--dry-run/--execute", default=True)
+@click.option("--file", default=None, help="Path to local issue draft to validate")
 @click.pass_context
-def validate_issue(ctx, issue_number, all_open, post_comments, dry_run):
+def validate_issue(ctx, issue_number, all_open, post_comments, dry_run, file=None):
     orch = ctx.obj["ORCHESTRATOR"]
-    res = orch.validate_issue(
-        issue_number=issue_number, all_open=all_open, post_comments=post_comments, dry_run=dry_run
-    )
+
+    if file:
+        content = orch._read_safe_file(file)
+        # For local files, we use title 'Draft: Local' to satisfy frontmatter check
+        res_content = orch.validate_content("Draft: Local", content)
+        res = {
+            "status": "success" if not res_content["findings"] else "error",
+            "issues": [
+                {
+                    "number": 0,
+                    "title": file,
+                    "findings": res_content["findings"],
+                    "warnings": res_content["warnings"],
+                }
+            ],
+            "total_findings": len(res_content["findings"]),
+        }
+    else:
+        res = orch.validate_issue(
+            issue_number=issue_number, all_open=all_open, post_comments=post_comments, dry_run=dry_run
+        )
+
     if not ctx.obj["JSON"]:
         for issue in res["issues"]:
-            click.echo(f"{'✅' if not issue['findings'] else '❌'} #{issue['number']}: {issue['title'][:60]}")
+            issue_ref = f"#{issue['number']}" if issue["number"] else f"File: {issue['title']}"
+            title_display = f": {issue['title'][:60]}" if issue["number"] else ""
+            click.echo(f"{'✅' if not issue['findings'] else '❌'} {issue_ref}{title_display}")
             for f in issue["findings"]:
                 click.echo(f"   ❌ {f}")
             for w in issue["warnings"]:
@@ -486,6 +508,22 @@ def validate_issue(ctx, issue_number, all_open, post_comments, dry_run):
         out(ctx, "✅ Issue validation complete.", data=res)
 
 
+@gh.command()
+@click.pass_context
+def scaffold_issue(ctx):
+    """Output a markdown skeleton containing the required headers."""
+    sections = PROJECT_CONFIG.spec_sections
+
+    output = "# Issue Title\n\n"
+    for section in sections:
+        output += f"# {section}\n\n[Provide content for {section}]\n\n"
+
+    if ctx.obj.get("JSON"):
+        out(ctx, "Issue scaffold generated.", data={"template": output})
+    else:
+        click.echo(output)
+
+
 @gh.command()
 @click.option("--title", required=True)
 @click.option("--body", required=True)
@@ -1403,6 +1441,22 @@ def plan_workflow_audit(ctx, workflow):
         _handle_unexpected_error(ctx, "agent plan-workflow-audit", e)
 
 
+@agent_group.command(name="install-workflows")
+@click.option("--dry-run/--execute", default=True)
+@click.pass_context
+def install_workflows(ctx, dry_run):
+    """Install and configure Jules/AI automation workflows for submodule or standalone use."""
+    orch = ctx.obj["ORCHESTRATOR"]
+    try:
+        res = orch.install_workflows(dry_run=dry_run)
+        if res["status"] == "success":
+            out(ctx, "✅ Workflows installed successfully.", data=res)
+        else:
+            out(ctx, "⚠️ Workflows partially installed or encountered errors.", data=res)
+    except Exception as e:
+        _handle_unexpected_error(ctx, "agent install-workflows", e)
+
+
 @agent_group.command(name="run-feedback-check")
 @limit_option(help_text="Limit the number of active sessions to check")
 @click.pass_context
@@ -1506,6 +1560,7 @@ for group in [jules_group]:
     group.add_command(send)
     group.add_command(plan_review)
     group.add_command(plan_aggregation)
+    group.add_command(install_workflows)
 
 for group in [agent_group, jules_group]:
     group.add_command(get_session, name="session")

{boomtick_cli-0.2.2 → boomtick_cli-0.5.0}/dev_tools/config.py

@@ -18,7 +18,7 @@ class ProjectConfig:
     core_dirs: List[str] = field(default_factory=lambda: ["src/layouts/", "src/components/"])
     monolithic_pr_threshold: int = 3
     base_branch: str = "origin/main"
-    vite_base_path: str = "/tech-dancer/"
+    vite_base_path: str | None = None
     gh_path: str = "gh"
     max_diff_chars: int = 40000
     content_scopes: Dict[str, str] = field(
@@ -59,7 +59,7 @@ class ProjectConfig:
     infra_file_paths: List[str] = field(
         default_factory=lambda: [
             "scripts/",
-            "boomtick-pkg/cli/",
+            "cli/",
             ".github/",
             "setup-agent.sh",
             "Dockerfile",
@@ -99,6 +99,12 @@ class ProjectConfig:
         ]
     )
 
+    def __post_init__(self):
+        if not self.github_repo:
+            raise ValueError("Missing required configuration: github_repo. Please provide it in project_config.json.")
+        if not self.vite_base_path:
+            raise ValueError("Missing required configuration: vite_base_path. Please provide it in project_config.json.")
+
     @property
     def base_branch_name(self) -> str:
         """Returns the base branch name without the remote prefix (e.g., 'main' for 'origin/main')."""
@@ -150,10 +156,7 @@ def load_project_config(path: str | Path = "project_config.json") -> ProjectConf
             raw = json.loads(p.read_text(encoding="utf-8"))
         except (json.JSONDecodeError, IOError):
             pass
-    elif path != "project_config.json":
-        # If a specific path was requested but doesn't exist, return default
-        return ProjectConfig()
-    else:
+    elif str(path) == "project_config.json":
         # Check parent directories for project_config.json if not in CWD
         # This helps when running from subdirectories
         current = Path.cwd()
@@ -186,7 +189,7 @@ def load_project_config(path: str | Path = "project_config.json") -> ProjectConf
     if "github_repo" in raw or "repo_name" in raw:
         kwargs["github_repo"] = raw.get("github_repo") or raw.get("repo_name")
     else:
-        kwargs["github_repo"] = _detect_repo_name() or "arii/tech-dancer"
+        kwargs["github_repo"] = _detect_repo_name()
 
     if "vite_base_path" in raw:
         kwargs["vite_base_path"] = raw["vite_base_path"]

{boomtick_cli-0.2.2 → boomtick_cli-0.5.0}/dev_tools/dist/config.js

@@ -18,7 +18,7 @@ function getGithubToken() {
             return token;
         }
     }
-    catch (e) { }
+    catch (e) { /* ignore to allow fallback */ }
     return undefined;
 }
 let cachedDynamicConfig = null;
@@ -42,7 +42,7 @@ export function initializeConfig() {
     }
     catch (e) {
         const message = e instanceof Error ? e.message : String(e);
-        const errorPrefix = `CRITICAL: Failed to load dynamic config from Python CLI. Ensure Python 3 is installed and boomtick-pkg/cli is in your PYTHONPATH. Details: ${message}`;
+        const errorPrefix = `CRITICAL: Failed to load dynamic config from Python CLI. Ensure Python 3 is installed and cli is in your PYTHONPATH. Details: ${message}`;
         if (process.env.NODE_ENV === "development" || process.env.CI === "true") {
             throw new Error(errorPrefix);
         }

boomtick_cli-0.5.0/dev_tools/dist/evals/run-evals.js

@@ -0,0 +1,38 @@
+import { healthHandler } from "../mcp/tools.js";
+import { searchOpenPrsHandler } from "../tools/github.search_open_prs.js";
+import { getPackageScriptsHandler } from "../tools/repo.get_package_scripts.js";
+async function runEvals() {
+    console.log("Starting Boomtick MCP Evaluations...");
+    try {
+        console.log("\n1. Health Check:");
+        try {
+            const health = await healthHandler({ checkDeep: false });
+            console.log(JSON.stringify(health, null, 2));
+        }
+        catch (e) {
+            console.log("Health check failed:", e instanceof Error ? e.message : String(e));
+        }
+        console.log("\n2. Repository Scripts:");
+        try {
+            const scripts = await getPackageScriptsHandler({ filter: "" });
+            console.log(`Found ${Object.keys(scripts.scripts).length} scripts.`);
+        }
+        catch (e) {
+            console.log("Repository scripts fetch failed:", e instanceof Error ? e.message : String(e));
+        }
+        console.log("\n3. GitHub PR Search (Dry Run):");
+        try {
+            const prs = await searchOpenPrsHandler({ state: "open", includeDrafts: true, limit: 100 });
+            console.log(`Found ${prs.prs.length} open PRs.`);
+        }
+        catch (e) {
+            console.log("GitHub search failed (likely due to environment/auth):", e instanceof Error ? e.message : String(e));
+        }
+        console.log("\nEvaluations complete.");
+    }
+    catch (error) {
+        console.error("\nEvaluation failed:", error);
+        process.exit(1);
+    }
+}
+runEvals();

{boomtick_cli-0.2.2 → boomtick_cli-0.5.0}/dev_tools/dist/lib/git.js

@@ -18,7 +18,7 @@ export async function createWorktree(branch, prNumber) {
         await fs.rm(worktreePath, { recursive: true, force: true });
         await runCommand("git", ["worktree", "prune"]);
     }
-    catch (e) { }
+    catch (e) { /* ignore if no previous worktree */ }
     const result = await runCommand("git", ["worktree", "add", "-b", `repair-pr-${prNumber}-${Date.now()}`, worktreePath, branch]);
     if (result.exitCode !== 0) {
         throw new Error(`Failed to create worktree: ${result.stderr}`);

{boomtick_cli-0.2.2 → boomtick_cli-0.5.0}/dev_tools/dist/mcp/definitions.js

@@ -1,4 +1,4 @@
-import { HealthCheckInputJsonSchema, SearchPRsInputJsonSchema, GetPrDiffInputJsonSchema, CheckoutBranchInputJsonSchema, GetMergeConflictFilesInputJsonSchema, GetChangedFilesInputJsonSchema, GetPackageScriptsInputJsonSchema, GetRouteMapInputJsonSchema, ReadCiLogsInputJsonSchema, RepoLogsInputJsonSchema, CreateBranchInputJsonSchema, CreateRepairBranchInputJsonSchema, RunTestsInputJsonSchema, RunLighthouseInputJsonSchema, RunPlaywrightInputJsonSchema, CommitPatchInputJsonSchema, OpenReplacementPrInputJsonSchema, CreatePullRequestInputJsonSchema, CommentTriageSummaryInputJsonSchema, GetPrInputJsonSchema, IssueViewInputJsonSchema, IssueUpdateInputJsonSchema, IssueCommentInputJsonSchema, CreateIssueInputJsonSchema, GetCommandSchemaInputJsonSchema, CreateJulesSessionInputJsonSchema, JulesSessionIdInputJsonSchema, JulesSendMessageInputJsonSchema, JulesListSessionsInputJsonSchema, SearchDdgsInputJsonSchema, } from "../tools/contract.js";
+import { HealthCheckInputJsonSchema, SearchPRsInputJsonSchema, GetPrDiffInputJsonSchema, CheckoutBranchInputJsonSchema, GetMergeConflictFilesInputJsonSchema, GetChangedFilesInputJsonSchema, GetPackageScriptsInputJsonSchema, GetRouteMapInputJsonSchema, ReadCiLogsInputJsonSchema, RepoLogsInputJsonSchema, CreateBranchInputJsonSchema, CreateRepairBranchInputJsonSchema, RunTestsInputJsonSchema, RunLighthouseInputJsonSchema, RunPlaywrightInputJsonSchema, CommitPatchInputJsonSchema, OpenReplacementPrInputJsonSchema, CreatePullRequestInputJsonSchema, CommentTriageSummaryInputJsonSchema, GetPrInputJsonSchema, IssueViewInputJsonSchema, IssueUpdateInputJsonSchema, IssueCommentInputJsonSchema, CreateIssueInputJsonSchema, GetCommandSchemaInputJsonSchema, ReadAgentContextInputJsonSchema as ReadAgentContextSchema, CreateJulesSessionInputJsonSchema, JulesSessionIdInputJsonSchema, JulesSendMessageInputJsonSchema, JulesListSessionsInputJsonSchema, SearchDdgsInputJsonSchema, } from "../tools/contract.js";
 export const MCP_PROMPTS = [
     {
         name: "conflict-scout",
@@ -77,7 +77,7 @@ export const MCP_TOOLS = [
     {
         name: "repo.read_agent_context",
         description: "Read the full repository index including file tree, CLI schema, and MCP tools.",
-        inputSchema: { type: "object", properties: {} },
+        inputSchema: ReadAgentContextSchema,
     },
     {
         name: "github.get_pr_diff",

{boomtick_cli-0.2.2 → boomtick_cli-0.5.0}/dev_tools/dist/mcp/server.js

@@ -69,7 +69,7 @@ export class BoomtickMCPServer {
         });
         this.server.setRequestHandler(GetPromptRequestSchema, async (request) => {
             const name = request.params.name;
-            const agentsDir = path.resolve(config.repoPath, "boomtick-pkg/mcp/src/agents");
+            const agentsDir = path.resolve(config.repoPath, "mcp/src/agents");
             // nosemgrep
             const promptPath = path.resolve(agentsDir, `${name}.prompt.md`);
             if (!promptPath.startsWith(agentsDir + path.sep)) {