Merge pull request #28 from gitbito/release/1.8.4

release/1.8.4

Author: shubhambito

README.md

@@ -62,19 +62,22 @@
       <a href="#6-sso-authentication">SSO Authentication</a>
     </li>
     <li>
-      <a href="#7-configuring-ai-architect-for-bito-ai-code-review-agent">Configuring AI Architect for Bito AI Code Review Agent</a>
+      <a href="#7-insights">Insights</a>
     </li>
     <li>
-      <a href="#8-command-reference">Command reference</a>
+      <a href="#8-configuring-ai-architect-for-bito-ai-code-review-agent">Configuring AI Architect for Bito AI Code Review Agent</a>
     </li>
     <li>
-      <a href="#9-troubleshooting-guide">Troubleshooting guide</a>
+      <a href="#9-command-reference">Command reference</a>
     </li>
     <li>
-      <a href="#10-upgrading-ai-architect">Upgrading AI Architect</a>
+      <a href="#10-troubleshooting-guide">Troubleshooting guide</a>
     </li>
     <li>
-      <a href="#11-support--contact">Support & contact</a>
+      <a href="#11-upgrading-ai-architect">Upgrading AI Architect</a>
+    </li>
+    <li>
+      <a href="#12-support--contact">Support & contact</a>
     </li>
   </ol>
 </details>
@@ -546,9 +549,97 @@ SSO sessions are configurable with the following defaults:
 
 <br />
 
+<!-- Insights -->
+
+## 7. Insights
+
+AI Architect optionally enriches the knowledge graph with context from Jira, and Confluence giving coding agents deeper understanding of project activity, planned work, and documentation.
+
+> **Note:** Insights is an optional feature. Repository indexing and MCP functionality work without it.
+
+---
+
+### Enabling and disabling features
+
+Enable one or more insights sources during installation (when prompted) or at any time post-install:
+
+```bash
+bitoarch insights enable git
+bitoarch insights enable ticket-tracker
+bitoarch insights enable docs
+```
+
+Each `enable` command runs an interactive setup that collects the required credentials.
+
+To disable a feature:
+
+```bash
+bitoarch insights disable git
+bitoarch insights disable ticket-tracker
+bitoarch insights disable docs
+```
+
+---
+
+### Running insights
+
+```bash
+bitoarch insights run
+bitoarch insights run --force              # Force a full refresh
+```
+
+---
+
+### Checking status
+
+```bash
+bitoarch insights status
+```
+
+---
+
+### Managing Jira project keys
+
+```bash
+bitoarch insights tracker-projects list
+bitoarch insights tracker-projects add KEY1 KEY2
+bitoarch insights tracker-projects remove KEY1
+bitoarch insights discover-tracker-projects
+```
+
+---
+
+### Updating credentials
+
+```bash
+bitoarch insights update-ticket-tracker
+bitoarch insights update-doc-config
+```
+
+---
+
+### Viewing configuration
+
+```bash
+bitoarch insights config
+```
+
+---
+
+### Configuring lookback period
+
+```bash
+bitoarch insights set-lookback git 90
+bitoarch insights set-lookback ticket-tracker 180
+```
+
+---
+
+<br />
+
 <!-- Configuring AI Architect for Bito AI Code Review Agent -->
 
-## 7. Configuring AI Architect for Bito AI Code Review Agent
+## 8. Configuring AI Architect for Bito AI Code Review Agent
 
 Now that you have **AI Architect** set up, you can take your code quality to the next level by integrating it with **[Bito's AI Code Review Agent](https://bito.ai/product/ai-code-review-agent/)**. This powerful combination delivers significantly more accurate and context-aware code reviews by leveraging the deep codebase knowledge graph that AI Architect has built.
 
@@ -579,7 +670,7 @@ This enables the AI Code Review Agent to:
 
 <!-- Command reference -->
 
-## 8. Command reference
+## 9. Command reference
 
 Quick reference to CLI commands for managing Bito's AI Architect.
 
@@ -659,6 +750,21 @@ Quick reference to CLI commands for managing Bito's AI Architect.
 | `bitoarch sso disable` | Disable SSO (temporary or permanent) | `bitoarch sso disable` |
 | `bitoarch sso rotate-key` | Rotate SSO tenant management key | `bitoarch sso rotate-key` |
 
+### Insights
+
+| Command | Description | Example |
+|---------|-------------|---------|
+| `bitoarch insights enable [feature]` | Enable an insights feature (`git`, `ticket-tracker`, or `docs`) | `bitoarch insights enable git` |
+| `bitoarch insights disable [feature]` | Disable an insights feature | `bitoarch insights disable ticket-tracker` |
+| `bitoarch insights run [--force]` | Run insights. `--force` forces a full refresh | `bitoarch insights run` |
+| `bitoarch insights status` | Show insights progress | `bitoarch insights status` |
+| `bitoarch insights config` | Show insights configuration | `bitoarch insights config` |
+| `bitoarch insights set-lookback [feature] [days]` | Set lookback period for a feature | `bitoarch insights set-lookback git 90` |
+| `bitoarch insights tracker-projects [action]` | Manage Jira project keys (`list`, `add`, `remove`, `set`) | `bitoarch insights tracker-projects add PROJ` |
+| `bitoarch insights discover-tracker-projects` | List accessible Jira projects | `bitoarch insights discover-tracker-projects` |
+| `bitoarch insights update-ticket-tracker` | Update ticket-tracker credentials | `bitoarch insights update-ticket-tracker` |
+| `bitoarch insights update-doc-config` | Update Confluence credentials | `bitoarch insights update-doc-config` |
+
 ### Output options
 
 Add these flags to any command:
@@ -691,7 +797,7 @@ bitoarch --version
 
 <!-- Troubleshooting guide -->
 
-## 9. Troubleshooting guide
+## 10. Troubleshooting guide
 
 ```bash
 # Check all services
@@ -736,7 +842,7 @@ bitoarch update
 ---
 
 
-## 10. Upgrading AI Architect
+## 11. Upgrading AI Architect
 
 [](#overview)
 
@@ -830,7 +936,7 @@ curl -fsSL https://aiarchitect.bito.ai/install.sh | bash
 
 <!-- Support & contact -->
 
-## 11. Support & contact
+## 12. Support & contact
 
 For comprehensive information and guidance on the AI Architect, including installation and configuration instructions, please refer to our detailed **[documentation available here](https://docs.bito.ai/ai-architect/overview)**. Should you require further assistance or have any inquiries, our support team is readily available to assist you.
 
@@ -850,4 +956,4 @@ Feel free to reach out to us via email at: **[support@bito.ai](mailto:support@bi
 [issues-shield]: https://img.shields.io/github/issues/gitbito/ai-architect.svg?style=for-the-badge
 [issues-url]: https://github.com/gitbito/ai-architect/issues
 [license-shield]: https://img.shields.io/github/license/gitbito/ai-architect.svg?style=for-the-badge
-[license-url]: https://github.com/gitbito/ai-architect?tab=MIT-1-ov-file#readme
+[license-url]: https://github.com/gitbito/ai-architect?tab=MIT-1-ov-file#readme

bito-ai-architect-1.8.2.tar.gz

@@ -74,3 +74,27 @@ resources:
 #   cis_config: 5003
 #   mysql: 5004
 #   cis_tracker: 5005
+
+# OPTIONAL: Insights features. Run independently; both work better together.
+# Set "true" to enable a feature; leave empty to be prompted during install.
+insights:
+  git: ""                                   # set to true to enable commit-history insights (reuses git creds above)
+
+  ticket_tracker:
+    enabled: ""                             # set to true to enable Jira ticket insights
+    provider: jira                          # jira (only supported provider today)
+    base_url: ""                            # e.g. https://acme.atlassian.net
+    email: ""
+    api_token: ""                           # Atlassian → security → API tokens
+    host_type: cloud                        # cloud | self
+    project_keys: ""                        # comma-separated string ONLY (e.g. "PROJ,INFRA") — YAML list will fail
+
+  docs:
+    enabled: ""                             # set to true to enable Confluence docs insights
+    provider: confluence                    # confluence (only supported provider today)
+    url: ""                                 # e.g. https://acme.atlassian.net (with or without /wiki — we normalize)
+    email: ""                               # defaults to ticket_tracker.email
+    api_token: ""
+
+  git_lookback_days: ""                      # git insights lookback (days, default: 180, max: 730)
+  jira_lookback_days: ""                     # jira insights lookback (days, default: 180, max: 730)

bito-ai-architect-1.8.4.tar.gz

@@ -768,6 +768,21 @@ migrate_config() {
         merge_new_env_configs "$NEW_ENV"
     fi
 
+    # Migrate legacy unified lookback to per-feature keys (pre-1.8.4).
+    if [[ -f "$NEW_ENV" ]] && grep -qE '^INSIGHTS_LOOKBACK_DAYS=' "$NEW_ENV"; then
+        local _legacy_lb
+        _legacy_lb=$(grep -E '^INSIGHTS_LOOKBACK_DAYS=' "$NEW_ENV" | cut -d= -f2- | tr -d '"' | tr -d "'")
+        if [ -n "$_legacy_lb" ]; then
+            grep -qE '^INSIGHTS_GIT_LOOKBACK_DAYS=.+' "$NEW_ENV" \
+                || sed -i.bak "s|^INSIGHTS_GIT_LOOKBACK_DAYS=.*|INSIGHTS_GIT_LOOKBACK_DAYS=${_legacy_lb}|" "$NEW_ENV"
+            grep -qE '^INSIGHTS_JIRA_LOOKBACK_DAYS=.+' "$NEW_ENV" \
+                || sed -i.bak "s|^INSIGHTS_JIRA_LOOKBACK_DAYS=.*|INSIGHTS_JIRA_LOOKBACK_DAYS=${_legacy_lb}|" "$NEW_ENV"
+        fi
+        sed -i.bak '/^INSIGHTS_LOOKBACK_DAYS=/d' "$NEW_ENV"
+        rm -f "${NEW_ENV}.bak"
+        log_silent "Migrated INSIGHTS_LOOKBACK_DAYS to per-feature keys"
+    fi
+
     # Replace TEMPORAL_MYSQL_PASSWORD placeholder with a real random secret.
     # The default template ships CHANGE_THIS_PASSWORD so every install would
     # otherwise end up with the same well-known password for temporal_user.
@@ -932,6 +947,8 @@ volumes:
   ai_architect_temp:
     external: true
     name: ${old_volumes_project}_ai_architect_temp
+  ai_architect_insights:
+    driver: local
 EOF
         log_silent "Volume config: external (from $old_volumes_project)"
     else
@@ -946,6 +963,8 @@ volumes:
     driver: local
   ai_architect_temp:
     driver: local
+  ai_architect_insights:
+    driver: local
 EOF
         log_silent "Volume config: fresh local volumes"
     fi
@@ -1661,6 +1680,17 @@ run_database_migrations() {
     return 0
 }
 
+_version_lt() {
+    local IFS='.'
+    local i v1=($1) v2=($2)
+    for ((i=0; i<3; i++)); do
+        local a=${v1[i]:-0} b=${v2[i]:-0}
+        (( a < b )) && return 0
+        (( a > b )) && return 1
+    done
+    return 1
+}
+
 _resolve_new_version() {
     local v=""
     if [[ -f "${NEW_DIR}/versions/service-versions.json" ]]; then
@@ -1670,6 +1700,17 @@ _resolve_new_version() {
     echo "$v"
 }
 
+_print_insights_announcement() {
+    if _version_lt "${CURRENT_VERSION:-0.0.0}" "1.8.4"; then
+        echo ""
+        echo -e "  ${GREEN}──────────────────────────────────────────────────────${NC}"
+        echo -e "  ${GREEN}NEW:${NC} Insights — enrich the knowledge graph with context from Git history, Jira, and Confluence."
+        echo -e "  Run ${YELLOW}bitoarch insights --help${NC} to get started."
+        echo -e "  ${GREEN}──────────────────────────────────────────────────────${NC}"
+        echo ""
+    fi
+}
+
 print_kubernetes_success() {
     local new_version
     new_version=$(_resolve_new_version)
@@ -1682,6 +1723,7 @@ print_kubernetes_success() {
     echo -e "   ${YELLOW}bitoarch status${NC}"
     echo -e "   ${YELLOW}bitoarch index-status${NC}"
     echo ""
+    _print_insights_announcement
     echo -e "Log:      ${LOG_FILE}"
     echo -e "Cleanup:  ${YELLOW}rm -rf ${OLD_DIR}${NC}  (after verifying new version)"
     echo ""
@@ -1707,6 +1749,7 @@ print_success() {
     echo -e "   ${BLUE}cd ${NEW_DIR}${NC}"
     echo -e "   ${YELLOW}bitoarch status${NC}"
     echo ""
+    _print_insights_announcement
     echo -e "Log:      ${LOG_FILE}"
     echo -e "Cleanup:  ${YELLOW}rm -rf ${OLD_DIR}${NC}  (after verifying new version)"
     echo ""