terra-hiven 3.2.0

package/dist/types.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Hiven Engine V3 - TypeScript Type Definitions
+ * Autonomous Swarm Intelligence & Logic Synthesizer
+ */
+export type SwarmPhase = 'phase_0' | 'phase_1_architect' | 'phase_2_coder' | 'phase_3_validator' | 'phase_4_consolidator' | 'self_healing';
+export type SwarmStatusType = 'queued' | 'running' | 'validating' | 'healing' | 'completed' | 'failed' | 'cancelled';
+export interface KombeeWorker {
+    id: number;
+    role: 'architect' | 'coder' | 'validator' | 'healer';
+    status: 'idle' | 'running' | 'done' | 'failed';
+    currentFile?: string;
+    partitionGroup?: number;
+    logs: string[];
+}
+export interface HoneycombPattern {
+    id: string;
+    language: string;
+    framework?: string;
+    patternType: 'architecture' | 'testing' | 'anti_pattern' | 'best_practice' | 'library';
+    summary: string;
+    doDirective: string;
+    dontDirective?: string;
+    exampleSnippet?: string;
+    successRate?: number;
+    usageCount: number;
+    discoveredAt: string;
+    lastUsedAt: string;
+}
+export interface HoneycombCell {
+    key: string;
+    value: any;
+    ttl?: number;
+    expiresAt?: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface SearchReplaceBlock {
+    filePath: string;
+    searchContent: string;
+    replaceContent: string;
+    occurrence?: number;
+}
+export interface TaskNode {
+    id: string;
+    title: string;
+    description: string;
+    dependencies: string[];
+    assignedFiles: string[];
+    status: 'pending' | 'in_progress' | 'completed' | 'failed';
+    resultSummary?: string;
+}
+export interface TaskGraph {
+    taskId: string;
+    rootGoal: string;
+    nodes: TaskNode[];
+    createdAt: string;
+}
+export interface SelfHealingReport {
+    attempt: number;
+    maxAttempts: number;
+    failedCommand: string;
+    errorSnippet: string;
+    healedFiles: string[];
+    resolved: boolean;
+}
+export interface SwarmOptions {
+    repo: string;
+    instruction: string;
+    branch?: string;
+    baseBranch?: string;
+    workerCount?: number;
+    testCommand?: string;
+    filesToEdit?: string[];
+    maxSelfHealingRetries?: number;
+    models?: {
+        architect?: string;
+        coder?: string;
+        validator?: string;
+    };
+    dryRun?: boolean;
+}
+export interface SwarmResult {
+    swarmId: string;
+    repo: string;
+    branch: string;
+    status: SwarmStatusType;
+    pullRequestUrl?: string;
+    commitSha?: string;
+    modifiedFiles: string[];
+    healingAttempts: number;
+    taskGraph?: TaskGraph;
+    summary: string;
+    startedAt: string;
+    completedAt?: string;
+    durationMs?: number;
+}
+export interface SwarmStatus {
+    swarmId: string;
+    repo: string;
+    status: SwarmStatusType;
+    currentPhase: SwarmPhase;
+    progressPercent: number;
+    activeWorkers: number;
+    logs: string[];
+    prUrl?: string;
+    startedAt: string;
+    updatedAt: string;
+}
+export interface HivenConfig {
+    githubToken?: string;
+    storageRepo?: string;
+    defaultBranch?: string;
+    defaultWorkers?: number;
+    ollamaHost?: string;
+    port?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,mBAAmB,GAAG,eAAe,GAAG,mBAAmB,GAAG,sBAAsB,GAAG,cAAc,CAAC;AAE3I,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;AAErH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,GAAG,OAAO,GAAG,WAAW,GAAG,QAAQ,CAAC;IACrD,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,cAAc,GAAG,SAAS,GAAG,cAAc,GAAG,eAAe,GAAG,SAAS,CAAC;IACvF,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,GAAG,CAAC;IACX,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC3D,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,MAAM,CAAC,EAAE;QACP,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,eAAe,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,eAAe,CAAC;IACxB,YAAY,EAAE,UAAU,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}

package/dist/types.js

@@ -0,0 +1,6 @@
+/**
+ * Hiven Engine V3 - TypeScript Type Definitions
+ * Autonomous Swarm Intelligence & Logic Synthesizer
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/vault.d.ts

@@ -0,0 +1,19 @@
+export interface VaultFile {
+    path: string;
+    content: string;
+    sha?: string;
+}
+/**
+ * Hiven Vault Manager
+ * Manages repository state, swarm persistence, and Honeycombs sync in .hiven-storage.
+ */
+export declare class HivenVault {
+    private octokit?;
+    private storageRepo;
+    private owner?;
+    constructor(token?: string, storageRepo?: string);
+    init(): Promise<boolean>;
+    saveFile(filePath: string, content: string, commitMessage?: string): Promise<boolean>;
+    readFile(filePath: string): Promise<string | null>;
+}
+//# sourceMappingURL=vault.d.ts.map

package/dist/vault.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault.d.ts","sourceRoot":"","sources":["../src/vault.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAAC,CAAU;IAC1B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,KAAK,CAAC,CAAS;gBAEX,KAAK,CAAC,EAAE,MAAM,EAAE,WAAW,GAAE,MAAyB;IAOrD,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IA+BxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,GAAE,MAAoC,GAAG,OAAO,CAAC,OAAO,CAAC;IA+BlH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAgBhE"}

package/dist/vault.js

@@ -0,0 +1,99 @@
+import { Octokit } from "@octokit/rest";
+/**
+ * Hiven Vault Manager
+ * Manages repository state, swarm persistence, and Honeycombs sync in .hiven-storage.
+ */
+export class HivenVault {
+    octokit;
+    storageRepo;
+    owner;
+    constructor(token, storageRepo = ".hiven-storage") {
+        this.storageRepo = storageRepo;
+        if (token) {
+            this.octokit = new Octokit({ auth: token });
+        }
+    }
+    async init() {
+        if (!this.octokit)
+            return false;
+        try {
+            const user = await this.octokit.users.getAuthenticated();
+            this.owner = user.data.login;
+            // Check if .hiven-storage exists, create if missing
+            try {
+                await this.octokit.repos.get({
+                    owner: this.owner,
+                    repo: this.storageRepo
+                });
+                return true;
+            }
+            catch (err) {
+                if (err.status === 404) {
+                    await this.octokit.repos.createForAuthenticatedUser({
+                        name: this.storageRepo,
+                        description: "Hiven Storage Vault — Autonomous Swarm State, Honeycombs & Execution History",
+                        private: true,
+                        auto_init: true
+                    });
+                    return true;
+                }
+                throw err;
+            }
+        }
+        catch (e) {
+            console.warn(`[Vault] Could not initialize remote repository: ${e.message}`);
+            return false;
+        }
+    }
+    async saveFile(filePath, content, commitMessage = "feat(hiven): update state") {
+        if (!this.octokit || !this.owner)
+            return false;
+        try {
+            let sha;
+            try {
+                const existing = await this.octokit.repos.getContent({
+                    owner: this.owner,
+                    repo: this.storageRepo,
+                    path: filePath
+                });
+                if ("sha" in existing.data) {
+                    sha = existing.data.sha;
+                }
+            }
+            catch {
+                // File does not exist yet
+            }
+            await this.octokit.repos.createOrUpdateFileContents({
+                owner: this.owner,
+                repo: this.storageRepo,
+                path: filePath,
+                message: commitMessage,
+                content: Buffer.from(content, "utf-8").toString("base64"),
+                sha
+            });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async readFile(filePath) {
+        if (!this.octokit || !this.owner)
+            return null;
+        try {
+            const res = await this.octokit.repos.getContent({
+                owner: this.owner,
+                repo: this.storageRepo,
+                path: filePath
+            });
+            if ("content" in res.data) {
+                return Buffer.from(res.data.content, "base64").toString("utf-8");
+            }
+            return null;
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=vault.js.map

package/dist/vault.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault.js","sourceRoot":"","sources":["../src/vault.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "terra-hiven",
+  "version": "3.2.0",
+  "description": "Hiven — Autonomous Cognitive Swarm, Distributed Multi-Agent Engineering & Collective Honeycombs Memory for the Terra Ecosystem",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "bin": {
+    "hiven": "./bin/hiven.js",
+    "terra-hiven": "./bin/hiven.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "start": "node dist/index.js"
+  },
+  "files": [
+    "dist/",
+    "bin/",
+    "console/",
+    "assets/",
+    "templates/",
+    "README.md",
+    "LICENSE.md"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "keywords": [
+    "terra",
+    "hiven",
+    "swarm",
+    "multi-agent",
+    "autonomous-coding",
+    "honeycombs",
+    "self-healing",
+    "ai-engineer",
+    "github-actions",
+    "zero-cost"
+  ],
+  "author": "AMG Logicalis / Terra Ecosystem",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/amglogicalis/hiven-komb-queen.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@octokit/rest": "^21.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.5.0"
+  }
+}

package/templates/.github/workflows/swarm.yml

@@ -0,0 +1,229 @@
+# swarm.yml
+# Hiven Worker Swarm Workflow Template - Multi-Stage Kōmbee Pipeline
+# Role: Principal Distributed Systems & MLOps Architect
+
+name: Hiven Swarm Execution
+
+on:
+  repository_dispatch:
+    types: [hiven-trigger]
+
+permissions:
+  contents: write
+  pull-requests: write
+  actions: write
+
+jobs:
+  # ==========================================================
+  # FASE 1: CONTEXT (Reader & Architect Kōmbees)
+  # ==========================================================
+  phase1-context:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Worker Repo
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install Dependencies
+        run: npm install @octokit/rest dotenv chalk
+
+      - name: Restore Ollama Cache
+        uses: actions/cache@v4
+        with:
+          path: ~/.ollama
+          key: ${{ runner.os }}-ollama-models-v1
+          restore-keys: |
+            ${{ runner.os }}-ollama-models-
+
+      - name: Install & Start Ollama
+        run: |
+          curl -fsSL https://ollama.com/install.sh | sh
+          ollama serve > ollama.log 2>&1 &
+          for i in {1..15}; do
+            if curl -s http://localhost:11434/api/tags > /dev/null; then break; fi
+            sleep 2
+          done
+      - name: Debug Environment Variables
+        run: |
+          echo "Checking trigger payload variables:"
+          echo "TARGET_REPO is set: ${{ github.event.client_payload.target_repo != '' }}"
+          echo "TARGET_BRANCH is set: ${{ github.event.client_payload.target_branch != '' }}"
+          echo "INSTRUCTION is set: ${{ github.event.client_payload.instruction != '' }}"
+          echo "TOKEN is set: ${{ github.event.client_payload.token != '' }}"
+          echo "FILES_TO_EDIT is set: ${{ github.event.client_payload.files != '' }}"
+
+
+      - name: Run Context Kōmbees
+        env:
+          GITHUB_TOKEN: ${{ github.event.client_payload.token }}
+          TARGET_REPO: ${{ github.event.client_payload.target_repo }}
+          TARGET_BRANCH: ${{ github.event.client_payload.target_branch }}
+          INSTRUCTION: ${{ github.event.client_payload.instruction }}
+          FILES_TO_EDIT: ${{ github.event.client_payload.files }}
+          STATUS_COMMENT_ID: ${{ github.event.client_payload.status_comment_id }}
+        run: node swarm_runner.js --phase context
+
+      - name: Upload Context Artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: swarm-context
+          path: swarm_context.json
+
+  # ==========================================================
+  # FASE 2: EXECUTION (Coder Kōmbees Matrix Strategy)
+  # ==========================================================
+  phase2-execution:
+    needs: phase1-context
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        kombee_index: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
+    steps:
+      - name: Checkout Worker Repo
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install Dependencies
+        run: npm install @octokit/rest dotenv chalk
+
+      - name: Download Context Artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: swarm-context
+
+      - name: Restore Ollama Cache
+        uses: actions/cache@v4
+        with:
+          path: ~/.ollama
+          key: ${{ runner.os }}-ollama-models-v1
+          restore-keys: |
+            ${{ runner.os }}-ollama-models-
+
+      - name: Install & Start Ollama
+        run: |
+          curl -fsSL https://ollama.com/install.sh | sh
+          ollama serve > ollama.log 2>&1 &
+          for i in {1..15}; do
+            if curl -s http://localhost:11434/api/tags > /dev/null; then break; fi
+            sleep 2
+          done
+
+      - name: Run Coder Kōmbee Node ${{ matrix.kombee_index }}
+        env:
+          GITHUB_TOKEN: ${{ github.event.client_payload.token }}
+          TARGET_REPO: ${{ github.event.client_payload.target_repo }}
+          TARGET_BRANCH: ${{ github.event.client_payload.target_branch }}
+          INSTRUCTION: ${{ github.event.client_payload.instruction }}
+          FILES_TO_EDIT: ${{ github.event.client_payload.files }}
+          KOMBEE_INDEX: ${{ matrix.kombee_index }}
+          STATUS_COMMENT_ID: ${{ github.event.client_payload.status_comment_id }}
+        run: node swarm_runner.js --phase execution --index ${{ matrix.kombee_index }}
+
+      - name: Upload Coder Output
+        uses: actions/upload-artifact@v4
+        with:
+          name: coder-output-${{ matrix.kombee_index }}
+          path: coder_output_${{ matrix.kombee_index }}.json
+
+  # ==========================================================
+  # FASE 3: VALIDATION (Tester & Reviewer Kōmbees)
+  # ==========================================================
+  phase3-validation:
+    needs: phase2-execution
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        kombee_index: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
+    steps:
+      - name: Checkout Worker Repo
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install Dependencies
+        run: npm install @octokit/rest dotenv chalk
+
+      - name: Download Context Artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: swarm-context
+
+      - name: Download Coder Output
+        uses: actions/download-artifact@v4
+        with:
+          name: coder-output-${{ matrix.kombee_index }}
+
+      - name: Run Validator Kōmbee Node ${{ matrix.kombee_index }}
+        env:
+          GITHUB_TOKEN: ${{ github.event.client_payload.token }}
+          TARGET_REPO: ${{ github.event.client_payload.target_repo }}
+          TARGET_BRANCH: ${{ github.event.client_payload.target_branch }}
+          INSTRUCTION: ${{ github.event.client_payload.instruction }}
+          KOMBEE_INDEX: ${{ matrix.kombee_index }}
+          STATUS_COMMENT_ID: ${{ github.event.client_payload.status_comment_id }}
+        run: node swarm_runner.js --phase validation --index ${{ matrix.kombee_index }}
+
+      - name: Upload Validation Output
+        uses: actions/upload-artifact@v4
+        with:
+          name: validation-output-${{ matrix.kombee_index }}
+          path: validation_output_${{ matrix.kombee_index }}.json
+
+  # ==========================================================
+  # FASE 4: CONSOLIDATION (Committer & Uplink Kōmbees)
+  # ==========================================================
+  phase4-consolidation:
+    needs: phase3-validation
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Worker Repo
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install Dependencies
+        run: npm install @octokit/rest dotenv chalk
+
+      - name: Download Context Artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: swarm-context
+
+      - name: Download All Coder Outputs
+        uses: actions/download-artifact@v4
+        with:
+          pattern: coder-output-*
+          merge-multiple: true
+
+      - name: Download All Validation Outputs
+        uses: actions/download-artifact@v4
+        with:
+          pattern: validation-output-*
+          merge-multiple: true
+
+      - name: Run Consolidation Kōmbees
+        env:
+          GITHUB_TOKEN: ${{ github.event.client_payload.token }}
+          TARGET_REPO: ${{ github.event.client_payload.target_repo }}
+          TARGET_BRANCH: ${{ github.event.client_payload.target_branch }}
+          INSTRUCTION: ${{ github.event.client_payload.instruction }}
+          PR_NUMBER: ${{ github.event.client_payload.pr_number }}
+          ISSUE_NUMBER: ${{ github.event.client_payload.issue_number }}
+          STATUS_COMMENT_ID: ${{ github.event.client_payload.status_comment_id }}
+          DRONE_UPLINK_URL: ${{ github.event.client_payload.drone_uplink }}
+          WORKER_ID: ${{ github.event.client_payload.worker_id }}
+        run: node swarm_runner.js --phase consolidation

package/templates/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "hiven-komb-worker-cell",
+  "version": "1.0.0",
+  "description": "Compute execution cell for Hiven Kōmb swarm",
+  "main": "swarm_runner.js",
+  "type": "module",
+  "dependencies": {
+    "@octokit/rest": "^21.0.0",
+    "chalk": "^5.3.0",
+    "dotenv": "^16.4.5"
+  },
+  "license": "MIT"
+}