@link-assistant/hive-mind 1.30.0 → 1.30.2

package/CHANGELOG.md

@@ -1,5 +1,43 @@
 # @link-assistant/hive-mind
 
+## 1.30.2
+
+### Patch Changes
+
+- e0bf56a: feat: make --gitkeep-file content shorter with single-line format (Issue #1397)
+
+  Previously, the `.gitkeep` file generated by `--gitkeep-file` contained multiple verbose lines:
+
+  ```
+  # Auto-generated file for PR creation
+  # Issue: https://github.com/...
+  # Branch: issue-3-57a79ede43e6
+  # Timestamp: 2026-03-07T23:53:23.107Z
+  # This file was created with --gitkeep-file (default)
+  # It will be removed when the task is complete
+  ```
+
+  Now it uses a concise single-line format:
+
+  ```
+  # .gitkeep file auto-generated at 2026-03-07T23:53:23.107Z for PR creation at branch issue-3-57a79ede43e6 for issue https://github.com/...
+  ```
+
+## 1.30.1
+
+### Patch Changes
+
+- 27b4f09: Fix Docker CI/CD amd64 build cancellation due to GHA cache export timeout
+  - Increase `timeout-minutes` from 30 to 45 in `docker-publish` and `docker-publish-instant` jobs
+  - Switch GHA cache mode from `mode=max` to `mode=min` to reduce sequential cache export payload
+  - Add `ignore-error=true` to `cache-to` so cache export failure does not cancel a successful image push
+  - Add comprehensive case study in `docs/case-studies/issue-1394/CASE-STUDY.md` with root cause analysis and CI log data
+
+  Root cause: The sandbox-based hive-mind image (~2-3 GB) takes ~30 min to build and push to Docker Hub.
+  After the push, BuildKit exports all image layers sequentially to GHA cache (`mode=max`). This sequential
+  write of ~800 MB per layer exhausted the 30-minute job timeout mid-export, cancelling an already-successful
+  build. The Docker image itself was published correctly; only the cache export step was interrupted.
+
 ## 1.30.0
 
 ### Minor Changes

package/README.md

@@ -143,7 +143,7 @@ sudo docker run hello-world
 
 Run the Hive Mind using Docker for safer local installation - no manual setup required:
 
-**Note:** Docker is much safer for local installation and can be used to install multiple isolated instances on a server or Kubernetes cluster. For Kubernetes deployments, see the [Helm chart installation](#helm-installation-kubernetes) section below.
+**Note:** Docker is much safer for local installation and can be used to install multiple isolated instances on a server or Kubernetes cluster. For Kubernetes deployments, see the [Helm chart installation](#helm-installation-kubernetes-experimental) section below.
 
 ```bash
 # Pull the latest image from Docker Hub
@@ -264,33 +264,13 @@ df -h # check disk space (to confirm space is freed)
 # tmpfs           1.2G   12K  1.2G   1% /run/user/0
 ```
 
-### Helm Installation (Kubernetes)
+### Helm Installation (Kubernetes) (Experimental)
 
-Deploy Hive Mind on Kubernetes using Helm:
-
-```bash
-# Add the Hive Mind Helm repository
-helm repo add link-assistant https://link-assistant.github.io/hive-mind
-helm repo update
-
-# Install Hive Mind
-helm install hive-mind link-assistant/hive-mind
-
-# Or install with custom values
-helm install hive-mind link-assistant/hive-mind -f values.yaml
-```
-
-**Benefits of Helm:**
-
-- ✅ Easy deployment to Kubernetes clusters
-- ✅ Declarative configuration management
-- ✅ Simple upgrades and rollbacks
-- ✅ Production-ready with configurable resources
-- ✅ Supports multiple replicas and scaling
-
-See [docs/HELM.md](./docs/HELM.md) for detailed Helm configuration options.
-
-**Note:** The Helm chart is published to [ArtifactHub](https://artifacthub.io/packages/helm/link-assistant/hive-mind) for easy discovery.
+> ⚠️ **EXPERIMENTAL:** The Helm/Kubernetes installation method is experimental and may not be fully stable.
+>
+> For a more reliable installation, we recommend using [Docker](#using-docker) instead.
+>
+> See [docs/HELM.md](./docs/HELM.md) for the full Helm installation instructions and configuration options.
 
 ### Installation on Ubuntu 24.04 server (Deprecated)
 
@@ -300,7 +280,7 @@ See [docs/HELM.md](./docs/HELM.md) for detailed Helm configuration options.
 > Docker provides better isolation, easier management, and consistent environments.
 >
 > Please use the [Docker installation method](#using-docker) above.
-> For Kubernetes deployments, see the [Helm installation](#helm-installation-kubernetes) section.
+> For Kubernetes deployments, see the [Helm installation](#helm-installation-kubernetes-experimental) section.
 >
 > The legacy bare-metal installation instructions have been moved to [docs/UBUNTU-SERVER.md](./docs/UBUNTU-SERVER.md) for reference.
 
@@ -308,7 +288,7 @@ See [docs/HELM.md](./docs/HELM.md) for detailed Helm configuration options.
 
 ```bash
 # Solve using maximum power
-solve https://github.com/Veronika89-lang/index.html/issues/1 --auto-continue --attach-logs --verbose --model opus --think max
+solve https://github.com/Veronika89-lang/index.html/issues/1 --attach-logs --verbose --model opus --think max
 
 # Solve GitHub issues automatically
 solve https://github.com/owner/repo/issues/123 --model sonnet

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@link-assistant/hive-mind",
-  "version": "1.30.0",
+  "version": "1.30.2",
   "description": "AI-powered issue solver and hive mind for collaborative problem solving",
   "main": "src/hive.mjs",
   "type": "module",

package/src/solve.auto-pr.lib.mjs

@@ -132,14 +132,8 @@ Proceed.
         finalContent = taskInfo;
       }
     } else {
-      // .gitkeep: Use minimal metadata format (explicit --gitkeep-file or auto-gitkeep-file fallback)
-      const creationReason = argv.claudeFile === false ? '# This file was created with --gitkeep-file (default)' : '# This file was created because CLAUDE.md is in .gitignore (--auto-gitkeep-file=true)';
-      const gitkeepContent = `# Auto-generated file for PR creation
-# Issue: ${issueUrl}
-# Branch: ${branchName}
-# Timestamp: ${timestamp}
-${creationReason}
-# It will be removed when the task is complete`;
+      // .gitkeep: Use minimal single-line metadata format (explicit --gitkeep-file or auto-gitkeep-file fallback)
+      const gitkeepContent = `# .gitkeep file auto-generated at ${timestamp} for PR creation at branch ${branchName} for issue ${issueUrl}`;
 
       if (fileExisted && existingContent) {
         await log(`   ${fileName} already exists, appending timestamp...`, { verbose: true });
@@ -197,11 +191,7 @@ ${creationReason}
 
           // Create a .gitkeep file as fallback
           const gitkeepPath = path.join(tempDir, '.gitkeep');
-          const gitkeepContent = `# Auto-generated file for PR creation
-# Issue: ${issueUrl}
-# Branch: ${branchName}
-# This file was created because CLAUDE.md is in .gitignore
-# It will be removed when the task is complete`;
+          const gitkeepContent = `# .gitkeep file auto-generated at ${timestamp} for PR creation at branch ${branchName} for issue ${issueUrl}`;
 
           await fs.writeFile(gitkeepPath, gitkeepContent);
           await log(formatAligned('✅', 'Created:', '.gitkeep file'));