FE-1437: Move brunch-agent into hashintel/hash with its history

.changeset/seven-poems-punch.md

@@ -0,0 +1,5 @@
+---
+"@hashintel/petrinaut": patch
+---
+
+Add an interactive-tool extension point to the AI assistant panel: hosts can register app-level tools whose calls render as interactive widgets in the conversation, including tools that suspend the turn until the user responds.

.github/actions/prune-repository/prune.py

@@ -6,6 +6,7 @@
 
 import argparse
 import json
+import shutil
 import subprocess
 from collections.abc import Iterable
 from glob import glob
@@ -18,7 +19,8 @@
 # ---------------------------------------------------------------------------
 
 # If any of these packages appear in the dependency closure, add the
-# corresponding extra packages to the scope.
+# corresponding extra packages to the scope. Triggers use prefix matching
+# so a family root can pull its children (e.g. darwin-kperf).
 EXTRA_DEPENDENCIES: dict[str, list[str]] = {
     # Cyclic: hashql crates need compiletest
     "@rust/hashql-ast": ["@rust/hashql-compiletest"],
@@ -38,6 +40,27 @@
     "@rust/hash-graph-types": ["@rust/hash-graph-test-data"],
 }
 
+# Extras that must not fire on a transitive or prefix match. Brunch core's
+# architecture tests need the app and context root, but a job whose requested
+# scope is only a sibling or a consumer of core must not pull that fixture.
+REQUESTED_DEPENDENCIES: dict[str, list[str]] = {
+    "@hashintel/brunch-agent": ["@apps/brunch-agent"],
+}
+
+# Non-workspace paths required by packages in the *requested* scope.
+# `turbo prune` copies workspace directories and root manifests only.
+REQUESTED_PATHS: dict[str, list[str]] = {
+    # The Brunch context root is deliberately not a workspace, but the
+    # architecture tests in packages/core read its docs, scripts, and agent
+    # contract files
+    "@hashintel/brunch-agent": [
+        "libs/@hashintel/brunch-agent/AGENTS.md",
+        "libs/@hashintel/brunch-agent/CONTEXT.md",
+        "libs/@hashintel/brunch-agent/docs",
+        "libs/@hashintel/brunch-agent/scripts",
+    ],
+}
+
 TURBO_QUERY = """
     query {
       packages {
@@ -73,6 +96,31 @@ def turbo_dependency_map() -> dict[str, frozenset[str]]:
     return dep_map
 
 
+def extras_for_requested(requested: Iterable[str]) -> frozenset[str]:
+    """Return extras implied by the job's requested scopes only.
+
+    Exact identity: a name that is a prefix of its siblings must not match them.
+    """
+
+    names = set(requested)
+    extras: set[str] = set()
+    for trigger, additions in REQUESTED_DEPENDENCIES.items():
+        if trigger in names:
+            extras.update(additions)
+    return frozenset(extras)
+
+
+def extra_paths_for_requested(requested: Iterable[str]) -> list[str]:
+    """Return non-workspace paths implied by the job's requested scopes only."""
+
+    names = set(requested)
+    paths: list[str] = []
+    for trigger, trigger_paths in REQUESTED_PATHS.items():
+        if trigger in names:
+            paths.extend(trigger_paths)
+    return paths
+
+
 def expand_scopes(dependencies: Iterable[str]) -> frozenset[str]:
     """Return extra scopes implied by the dependency names.
 
@@ -121,6 +169,29 @@ def turbo_prune(scopes: Iterable[str], *, dry_run: bool = False) -> None:
     subprocess.run(args, check=True)
 
 
+def copy_extra_paths(scopes: Iterable[str], *, dry_run: bool = False) -> None:
+    """Copy non-workspace paths that `turbo prune` cannot include."""
+
+    for path in extra_paths_for_requested(scopes):
+        source = Path(path)
+        if not source.exists():
+            msg = f"REQUESTED_PATHS names {source}, which does not exist"
+            raise FileNotFoundError(msg)
+
+        destination = Path("out") / source
+
+        if dry_run:
+            print(f"[dry-run] Would copy: {source} -> {destination}")
+            continue
+
+        print(f"Copying extra path: {source} -> {destination}")
+        if source.is_dir():
+            shutil.copytree(source, destination, dirs_exist_ok=True)
+        else:
+            destination.parent.mkdir(parents=True, exist_ok=True)
+            shutil.copy2(source, destination)
+
+
 def resolve_workspace_members() -> list[Path]:
     """Read workspace members from Cargo.toml and resolve globs to Cargo.toml paths."""
 
@@ -192,8 +263,9 @@ def main(argv: list[str] | None = None) -> None:
     }
 
     dependencies = turbo_dependency_map()
-    scopes = fixpoint_expand(initial, dependencies)
+    scopes = fixpoint_expand(initial | extras_for_requested(initial), dependencies)
     turbo_prune(scopes, dry_run=args.dry_run)
+    copy_extra_paths(initial, dry_run=args.dry_run)
     stub_missing_members(dry_run=args.dry_run)
 
 

.github/actions/prune-repository/prune_test.py

@@ -0,0 +1,66 @@
+#!/usr/bin/env python3
+"""Hermetic oracles for prune extra-scope rules. Does not run turbo prune."""
+
+from __future__ import annotations
+
+import unittest
+
+from prune import (
+    expand_scopes,
+    extra_paths_for_requested,
+    extras_for_requested,
+    fixpoint_expand,
+)
+
+CORE = "@hashintel/brunch-agent"
+TRANSPORT = "@hashintel/brunch-agent-transport-aisdk"
+APP = "@apps/brunch-agent"
+WEBSITE = "@apps/petrinaut-website"
+
+
+class BrunchRequestedExtras(unittest.TestCase):
+    def test_core_job_adds_the_app_and_context_paths(self) -> None:
+        self.assertEqual(extras_for_requested({CORE}), frozenset({APP}))
+        self.assertIn(
+            APP,
+            fixpoint_expand(
+                {CORE} | extras_for_requested({CORE}),
+                {CORE: frozenset(), APP: frozenset({CORE})},
+            ),
+        )
+        self.assertEqual(
+            extra_paths_for_requested({CORE}),
+            [
+                "libs/@hashintel/brunch-agent/AGENTS.md",
+                "libs/@hashintel/brunch-agent/CONTEXT.md",
+                "libs/@hashintel/brunch-agent/docs",
+                "libs/@hashintel/brunch-agent/scripts",
+            ],
+        )
+
+    def test_sibling_or_website_job_does_not_add_brunch_extras(self) -> None:
+        self.assertEqual(extras_for_requested({TRANSPORT}), frozenset())
+        self.assertEqual(extras_for_requested({WEBSITE}), frozenset())
+        self.assertEqual(extra_paths_for_requested({TRANSPORT}), [])
+        self.assertEqual(extra_paths_for_requested({WEBSITE}), [])
+
+    def test_transitive_core_in_the_closure_does_not_add_the_app(self) -> None:
+        dependencies = {
+            WEBSITE: frozenset({TRANSPORT}),
+            TRANSPORT: frozenset({CORE}),
+            CORE: frozenset(),
+        }
+        expanded = fixpoint_expand({WEBSITE}, dependencies)
+        self.assertNotIn(APP, expanded)
+        self.assertEqual(extras_for_requested({WEBSITE}), frozenset())
+
+
+class DarwinPrefix(unittest.TestCase):
+    def test_child_crate_still_triggers_the_prefix_family(self) -> None:
+        extras = expand_scopes({"@rust/darwin-kperf-sys"})
+        self.assertIn("@rust/darwin-kperf-sys", extras)
+        self.assertIn("@rust/darwin-kperf-events", extras)
+
+
+if __name__ == "__main__":
+    unittest.main()

.markdownlint-cli2.jsonc

@@ -35,6 +35,7 @@
     "**/_ai/**",
     "**/.cursor/plans/**",
     "libs/@hashintel/ds-components/**",
-    "libs/@hashintel/ds-helpers/**"
+    "libs/@hashintel/ds-helpers/**",
+    "libs/@hashintel/brunch-agent/docs/**"
   ]
 }

apps/brunch-agent/.gitignore

@@ -0,0 +1,2 @@
+.data-wipe-me/
+.flue/

apps/brunch-agent/AGENTS.md

@@ -0,0 +1,9 @@
+# Brunch agent application
+
+This application belongs to the Brunch context rooted at
+`../../libs/@hashintel/brunch-agent/`. Read that context's `AGENTS.md`, `CONTEXT.md`, and relevant
+ADRs before changing this application. HASH root guidance takes precedence.
+
+The application composes the Brunch packages, Flue runtime, HTTP routes, and local diagnostics. It
+must remain independent of Petrinaut implementation packages; `apps/petrinaut-website` meets it
+through the AI SDK/HTTP transport.

apps/brunch-agent/CLAUDE.md

@@ -0,0 +1 @@
+AGENTS.md