brainiac 0.1.4 → 0.1.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d73484edd8f42558e933347b45b50f5aa27065a86798ae4d764e44b0d07534f9
-  data.tar.gz: bcc9a1a5bf6094ef8138cf345e2e517004c412d983c4475c80b89cb005bbf6aa
+  metadata.gz: 66eb8c75d924422aeb756ce7bc59dc503dc8fcab67095267b6c7940f461e6d8d
+  data.tar.gz: b7e22617f77bd5ee2882f3651a6622e00984e02193cd8a4554026c6e5245d6d0
 SHA512:
-  metadata.gz: 1ecd465ba660b6a145c15a9fa7fd17a13dad35bf2dff802b18dcba92949964b5df0be02e26ebc643a74582f010cecf520fc7d04cd32b4acda83891768cd0c6c1
-  data.tar.gz: ca830bd810461ff79c474bf5a2744f187a29ee8040d7af0b14c7143dd76c92dbb6e1117f942e51610ecb8e3bdb9d48739a48f7862006f8f84a4d7a66bb40481a
+  metadata.gz: 53d31acae1ef2a57be783175db90715adbdf0d3877beda17165feefbbd2e77df3528680984844e28ada13315582942a1aea54268895c203a9d388cb76d20c78a
+  data.tar.gz: 8b12a7305c26ac95c3a8c5682645039cac545845efeba325860859ad0299e5b6a429e0eeac157686b648746c82198392e791e55bc102b1f0fc876fe5c2493337

data/README.md

@@ -47,9 +47,28 @@ All four channels support inline tags in message/comment text. Tags are stripped
 | `[branch:branch-name]`                                                        | ✓     | ✓       | ✓      | Target an existing branch — reuses its worktree if a work item exists                                 |
 | `[workitem:wi-abc123]`                                                        | ✓     | ✓       | ✓      | Target a specific work item by ID — agent works in its worktree                                       |
 | `[plan]`                                                                      | ✓     | ✓       | —      | Activate planning mode — agent gathers requirements before coding                                     |
+| `[fork]` `[fork:topic]`                                                       | —     | ✓       | —      | Fork conversation to a new thread — starts unbound (no worktree until implementation)                 |
 
 Model keys come from the project's `allowed_models` config. Fizzy also supports model selection via card tags (e.g. adding an `opus` tag to the card).
 
+### Conversation Branching (Discord)
+
+Sometimes you want to spin off a tangent without polluting the current conversation's context. Brainiac supports two ways to branch:
+
+**🌿 Reaction** — React with 🌿 on any message to fork from that point. The message becomes the root of a new thread.
+
+**`[fork]` Tag** — Include `[fork]` or `[fork:topic]` in your message to immediately branch:
+
+```
+@Galen [fork:belt-bug] Hey, unrelated to what we're working on, but I think belt deploy has a bug...
+```
+
+Both methods create a new thread that starts **unbound** — no worktree, no project lock-in. The agent can discuss, search brain, and read files across any registered project. When you ask for actual implementation work, the worktree is created at that point, scoped to the right repo.
+
+This solves the "orphaned worktree" problem: if you notice a belt bug while working on brainiac, the branch doesn't create a useless brainiac worktree. The project is resolved when implementation starts.
+
+The original conversation continues undisturbed. The branched thread gets its own memory file and context.
+
 ### Planning Mode
 
 Add a `[plan]` tag to a Discord message or a `plan` tag to a Fizzy card to activate planning mode. Instead of jumping straight into implementation, the agent:

data/lib/brainiac/handlers/shared/inline_tags.rb

@@ -22,6 +22,7 @@
 #     fresh: true/false,
 #     deploy_intent: "dev01" / :auto / nil,
 #     worktree_override: "branch-name" or nil,
+#     fork_branch: "topic" or true or nil (fork conversation to a new thread),
 #     clean_text: "the message with all tags stripped"
 #   }
 def parse_inline_tags(text)
@@ -38,6 +39,7 @@ def parse_inline_tags(text)
     worktree_override: nil,
     work_item: nil,
     branch_override: nil,
+    fork_branch: nil,
     clean_text: text.dup
   }
 
@@ -110,7 +112,8 @@ def parse_work_item_tags(result)
     result[:clean_text].sub!(match[0], "")
   end
 
-  # [branch:branch-name] — preferred syntax for targeting a branch/worktree
+  # [branch:branch-name] — preferred syntax for targeting a branch/worktree.
+  # Note: bare [branch] (no colon/value) is handled below as a fork request.
   if (match = result[:clean_text].match(/\[branch:([^\]]+)\]/i))
     result[:branch_override] = match[1].strip
     # Also set worktree_override for backward compat with plugins that read it
@@ -123,6 +126,21 @@ def parse_work_item_tags(result)
     result[:work_item] = match[1].strip
     result[:clean_text].sub!(match[0], "")
   end
+
+  # [fork], [fork:topic], or bare [branch] — fork the conversation into a new thread.
+  # The new thread starts unbound (no worktree) until implementation work begins.
+  # Topic becomes the thread title; without a topic, the message content is used.
+  # - [fork:belt-bug] → fork with "belt-bug" as the topic
+  # - [fork] → fork with auto-generated topic from message content
+  # - [branch] → alias for [fork] (bare [branch] with no value)
+  if (match = result[:clean_text].match(/\[fork(?::([^\]]+))?\]/i))
+    result[:fork_branch] = match[1]&.strip || true
+    result[:clean_text].sub!(match[0], "")
+  elsif result[:clean_text].match?(/\[branch\]/i) && !result[:branch_override]
+    # Bare [branch] with no value acts as a fork request
+    result[:fork_branch] = true
+    result[:clean_text].sub!(/\[branch\]/i, "")
+  end
 end
 
 def parse_model_tag(result)

data/lib/brainiac/helpers.rb

@@ -353,10 +353,10 @@ def register_work_item(branch:, worktree: nil, project: nil, agent: nil, source:
   work_item_id
 end
 
-# Update dispatch overrides on a work item (cli_provider, model, effort).
+# Update dispatch overrides on a work item (cli_provider, model, effort, profile).
 # Only non-nil values are stored; nil values are removed from existing overrides.
 # Returns true if the work item was found and updated, false otherwise.
-def update_work_item_overrides(cli_provider: nil, model: nil, effort: nil, work_item_id: nil, branch: nil) # rubocop:disable Naming/PredicateMethod
+def update_work_item_overrides(cli_provider: nil, model: nil, effort: nil, profile: nil, work_item_id: nil, branch: nil) # rubocop:disable Naming/PredicateMethod
   map = load_work_item_map
 
   target_id = work_item_id
@@ -375,6 +375,7 @@ def update_work_item_overrides(cli_provider: nil, model: nil, effort: nil, work_
   overrides["cli_provider"] = cli_provider if cli_provider
   overrides["model"] = model if model
   overrides["effort"] = effort if effort
+  overrides["profile"] = profile if profile
   overrides.compact!
 
   if overrides.empty?
@@ -417,16 +418,26 @@ end
 #   inline_cli_provider: — [cli:X] from current message (nil if not specified)
 #   inline_model: — resolved model from current message (nil if not specified)
 #   inline_effort: — [effort:X] from current message (nil if not specified)
+#   inline_profile: — [profile:X]/[p:X] from current message (nil if not specified)
 #
-# Returns: { cli_provider: String|nil, model: String|nil, effort: String|nil }
-def resolve_work_item_overrides(work_item_id: nil, branch: nil, inline_cli_provider: nil, inline_model: nil, inline_effort: nil)
+# A profile sticks to the work item like model/effort do: [p:k+] once and every later
+# untagged reply keeps running on k+ until a different [p:X] (e.g. [p:q]) replaces it.
+# Unknown profile names are never persisted, so a typo can't pin a work item to a
+# profile that doesn't exist (profile_spawn_env ignores it for this dispatch too).
+#
+# Returns: { cli_provider:, model:, effort:, profile: } (each String or nil)
+def resolve_work_item_overrides(work_item_id: nil, branch: nil, inline_cli_provider: nil, inline_model: nil, inline_effort: nil,
+                                inline_profile: nil)
   stored = work_item_overrides_for(work_item_id: work_item_id, branch: branch)
+  inline_profile = inline_profile&.to_s&.downcase
+  persist_profile = inline_profile && profile_entry(inline_profile) ? inline_profile : nil
 
   # Inline tags override stored values
   resolved = {
     cli_provider: inline_cli_provider || stored["cli_provider"],
     model: inline_model || stored["model"],
-    effort: inline_effort || stored["effort"]
+    effort: inline_effort || stored["effort"],
+    profile: inline_profile || stored["profile"]
   }
 
   # Persist any new inline overrides to the work item for future dispatches
@@ -434,6 +445,7 @@ def resolve_work_item_overrides(work_item_id: nil, branch: nil, inline_cli_provi
   new_overrides[:cli_provider] = inline_cli_provider if inline_cli_provider
   new_overrides[:model] = inline_model if inline_model
   new_overrides[:effort] = inline_effort if inline_effort
+  new_overrides[:profile] = persist_profile if persist_profile
 
   update_work_item_overrides(work_item_id: work_item_id, branch: branch, **new_overrides) if new_overrides.any? && (work_item_id || branch)
 

data/lib/brainiac/version.rb

@@ -2,5 +2,5 @@
 
 module Brainiac
   # @return [String] the current gem version
-  VERSION = "0.1.4"
+  VERSION = "0.1.6"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: brainiac
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.1.6
 platform: ruby
 authors:
 - Andy Davis
@@ -117,7 +117,6 @@ extra_rdoc_files: []
 files:
 - CHANGELOG.md
 - Gemfile
-- Gemfile.lock
 - README.md
 - Rakefile
 - bin/brainiac

data/Gemfile.lock

@@ -1,117 +0,0 @@
-PATH
-  remote: .
-  specs:
-    brainiac (0.1.4)
-      puma (~> 7.2)
-      rackup (~> 2.3)
-      sinatra (~> 4.1)
-
-GEM
-  remote: https://rubygems.org/
-  specs:
-    ast (2.4.3)
-    base64 (0.3.0)
-    json (2.21.2)
-    language_server-protocol (3.17.0.6)
-    lint_roller (1.1.0)
-    logger (1.7.0)
-    minitest (5.27.0)
-    mustermann (3.1.1)
-    nio4r (2.7.5)
-    parallel (2.2.0)
-    parser (3.3.12.0)
-      ast (~> 2.4.1)
-      racc
-    prism (1.9.0)
-    puma (7.2.1)
-      nio4r (~> 2.0)
-    racc (1.8.1)
-    rack (3.2.7)
-    rack-protection (4.2.1)
-      base64 (>= 0.1.0)
-      logger (>= 1.6.0)
-      rack (>= 3.0.0, < 4)
-    rack-session (2.1.2)
-      base64 (>= 0.1.0)
-      rack (>= 3.0.0)
-    rackup (2.3.1)
-      rack (>= 3)
-    rainbow (3.1.1)
-    rake (13.4.2)
-    regexp_parser (2.12.0)
-    rubocop (1.88.0)
-      json (~> 2.3)
-      language_server-protocol (~> 3.17.0.2)
-      lint_roller (~> 1.1.0)
-      parallel (>= 1.10)
-      parser (>= 3.3.0.2)
-      rainbow (>= 2.2.2, < 4.0)
-      regexp_parser (>= 2.9.3, < 3.0)
-      rubocop-ast (>= 1.49.0, < 2.0)
-      ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 2.4.0, < 4.0)
-    rubocop-ast (1.50.0)
-      parser (>= 3.3.7.2)
-      prism (~> 1.7)
-    rubocop-performance (1.26.1)
-      lint_roller (~> 1.1)
-      rubocop (>= 1.75.0, < 2.0)
-      rubocop-ast (>= 1.47.1, < 2.0)
-    ruby-progressbar (1.13.0)
-    sinatra (4.2.1)
-      logger (>= 1.6.0)
-      mustermann (~> 3.0)
-      rack (>= 3.0.0, < 4)
-      rack-protection (= 4.2.1)
-      rack-session (>= 2.0.0, < 3)
-      tilt (~> 2.0)
-    tilt (2.9.0)
-    unicode-display_width (3.2.0)
-      unicode-emoji (~> 4.1)
-    unicode-emoji (4.2.0)
-
-PLATFORMS
-  ruby
-  x86_64-linux
-
-DEPENDENCIES
-  brainiac!
-  minitest (~> 5.25)
-  rake (~> 13.0)
-  rubocop (~> 1.75)
-  rubocop-performance (~> 1.25)
-
-CHECKSUMS
-  ast (2.4.3) sha256=954615157c1d6a382bc27d690d973195e79db7f55e9765ac7c481c60bdb4d383
-  base64 (0.3.0) sha256=27337aeabad6ffae05c265c450490628ef3ebd4b67be58257393227588f5a97b
-  brainiac (0.1.4)
-  json (2.21.2) sha256=1f1d3b7cf2b3ba1a69beca0bb6db13d5438b80bff3cd54cdaaa620b9b07c1c6a
-  language_server-protocol (3.17.0.6) sha256=5ef2c0c138f8267e1bc631d3328347d354f96724b0af22f2c79516120443b7f0
-  lint_roller (1.1.0) sha256=2c0c845b632a7d172cb849cc90c1bce937a28c5c8ccccb50dfd46a485003cc87
-  logger (1.7.0) sha256=196edec7cc44b66cfb40f9755ce11b392f21f7967696af15d274dde7edff0203
-  minitest (5.27.0) sha256=2d3b17f8a36fe7801c1adcffdbc38233b938eb0b4966e97a6739055a45fa77d5
-  mustermann (3.1.1) sha256=4c6170c7234d5499c345562ba7c7dfe73e1754286dcc1abb053064d66a127198
-  nio4r (2.7.5) sha256=6c90168e48fb5f8e768419c93abb94ba2b892a1d0602cb06eef16d8b7df1dca1
-  parallel (2.2.0) sha256=e1059c5fd7b649558a0aec38a769f06a42942bdb40503d005a59c352fe011cd8
-  parser (3.3.12.0) sha256=21a6d7f755d5a24dfbdc6e6b772e4e879a52e7631a88bc5a3a134606052c9828
-  prism (1.9.0) sha256=7b530c6a9f92c24300014919c9dcbc055bf4cdf51ec30aed099b06cd6674ef85
-  puma (7.2.1) sha256=d7bf0e9cabd532e0d401e142cd94e3ac531e993610e2d80e6fbf9c26961414b0
-  racc (1.8.1) sha256=4a7f6929691dbec8b5209a0b373bc2614882b55fc5d2e447a21aaa691303d62f
-  rack (3.2.7) sha256=93e13e1c24f93556671d85d2d79fa228c3485815c50d7e2f265b5330c6528fb7
-  rack-protection (4.2.1) sha256=cf6e2842df8c55f5e4d1a4be015e603e19e9bc3a7178bae58949ccbb58558bac
-  rack-session (2.1.2) sha256=595434f8c0c3473ae7d7ac56ecda6cc6dfd9d37c0b2b5255330aa1576967ffe8
-  rackup (2.3.1) sha256=6c79c26753778e90983761d677a48937ee3192b3ffef6bc963c0950f94688868
-  rainbow (3.1.1) sha256=039491aa3a89f42efa1d6dec2fc4e62ede96eb6acd95e52f1ad581182b79bc6a
-  rake (13.4.2) sha256=cb825b2bd5f1f8e91ca37bddb4b9aaf345551b4731da62949be002fa89283701
-  regexp_parser (2.12.0) sha256=35a916a1d63190ab5c9009457136ae5f3c0c7512d60291d0d1378ba18ce08ebb
-  rubocop (1.88.0) sha256=e420ddf1662d0ef34bc8a2910ac4b396a7ddda0b51a708264405241734b08e0b
-  rubocop-ast (1.50.0) sha256=b9ca88300da0803ee222ad20cdb30494c0a784eed06fdc35d254b06d662788db
-  rubocop-performance (1.26.1) sha256=cd19b936ff196df85829d264b522fd4f98b6c89ad271fa52744a8c11b8f71834
-  ruby-progressbar (1.13.0) sha256=80fc9c47a9b640d6834e0dc7b3c94c9df37f08cb072b7761e4a71e22cff29b33
-  sinatra (4.2.1) sha256=b7aeb9b11d046b552972ade834f1f9be98b185fa8444480688e3627625377080
-  tilt (2.9.0) sha256=da5735d0280bba96e9a91041bb14aee435ccad5c17b0fa519249ae543d9aa3a5
-  unicode-display_width (3.2.0) sha256=0cdd96b5681a5949cdbc2c55e7b420facae74c4aaf9a9815eee1087cb1853c42
-  unicode-emoji (4.2.0) sha256=519e69150f75652e40bf736106cfbc8f0f73aa3fb6a65afe62fefa7f80b0f80f
-
-BUNDLED WITH
-  4.0.10